feat(@astrojs/cloudflare): add runtime support to astro dev

[alexanderniebuhr]

Changes

• clean up: there were still some references to old getRuntime
• workaround: until wrangler exposes for of their API for programatically usage, I just copied over the important logic
• add: req.cf or Astro.locals.runtime.cf support for astro dev, without the need to run wrangler
• add: Astro.locals.runtime.env support for enviromental vars defined according to CF docs in either wrangler.toml or .dev.vars

Known issues (for another PR)

• missing: CF bindings mocking (R2, D1, KV, Durable Objects)
• missing: support for env vars defined in other files than wrangler.toml, .dev.vars
• missing: wrangler.json support

Testing

• manually

Docs

- would love to add them with a later PR, just want to stealth release it first

/cc @withastro/maintainers-docs for feedback!

[changeset-bot]

🦋 Changeset detected

Latest commit: 671bb24

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[lilnasy]

Love this! Setting the standard for adapters yet again.

As important as documentation is for this feature, it could be deferred. But there should at least be basic tests. If for nothing else, then ensuring that things don't wildly change.

[alexanderniebuhr]

@lilnasy, thank you for your insightful comments! You're correct that I included code comments intended for a later stage. I agree with your suggestion to remove them for the time being; they can always be reintroduced later.

[ematipico]

Code-wise, it looks good. I agree with every comment @lilnasy made

We should add some documentation once we settle the business logic

[alexanderniebuhr]

Fixed most of the comments. I actually implemented local caches support, using miniflare. Will add some tests & docs later today.

[sarah11918]

Thanks @alexanderniebuhr! Just some docs tightening up to do, and I've given you a structure that you can adjust as necessary! 🙌

The tests look great! I'm going to try the dev changes live later.

[matthewp]

Love this

[ematipico]

Great work!

[sarah11918]

It's been a pleasure doing doc'ing with you! 🫡

[lilnasy]

This is great! Thanks for all the hardwork you put in here.