[Cloudflare integration] Expose cf metadata and Cloudflare caches API

[beynar]

Changes

This pull request expose the Cloudflare caches API and cf object (request metadata provided by Cloudflare's edge) to the runtime object.

Example

Cloudflare add some usefull informations about the request such as geolocation properties see the docs

const runtime = getRuntime(Astro.request);
const visitor_country  = runtime.cf?.country;

The Cloudflare cache API can now be used.

const runtime = getRuntime(Astro.request);
const cachedObject = await runtime.caches?.default.match(Astro.request);

[changeset-bot]

🦋 Changeset detected

Latest commit: 1204818

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

[matthewp]

I think this sounds good. When #7385 lands do you think it would make sense to deprecate getRuntime and instead put this stuff on Astro.locals?

[beynar]

Yes, it will be very beneficial and makes more sense imo. I'm actually doing it in a middleware.

Also getRuntime is wrongly typed and returns undefined in dev mode. I would have suggest to return a default ( Reflect.get(request, Symbol.for("runtime")) || { name: "cloudflare", env: {}, waitUntil: (cb) => Promise.resolve(cb) }) or to type its return as potentially undefined.