feat(@astro/cloudflare): improve DX for runtime typing

.changeset/thin-pigs-mate.md

@@ -0,0 +1,44 @@
+---
+'@astrojs/cloudflare': patch
+---
+
+add option to type environment variables using a generic
+
+```ts
+// src/env.d.ts
+/// <reference types="astro/client" />
+import type { AdvancedRuntime } from '@astrojs/cloudflare';
+
+type ENV = {
+  SERVER_URL: string;
+}
+
+declare namespace App {
+  interface Locals extends AdvancedRuntime<ENV> {
+    user: {
+      name: string;
+      surname: string;
+    };
+  }
+}
+```
+
+
+```ts
+// src/env.d.ts
+/// <reference types="astro/client" />
+import type { DirectoryRuntime } from '@astrojs/cloudflare';
+
+type ENV = {
+  SERVER_URL: string;
+}
+
+declare namespace App {
+  interface Locals extends DirectoryRuntime<ENV> {
+    user: {
+      name: string;
+      surname: string;
+    };
+  }
+}
+```

packages/integrations/cloudflare/README.md

@@ -115,8 +115,12 @@ If you're using the `advanced` runtime, you can type the `runtime` object as fol
 /// <reference types="astro/client" />
 import type { AdvancedRuntime } from '@astrojs/cloudflare';
 
+type ENV = {
+  SERVER_URL: string;
+}
+
 declare namespace App {
-  interface Locals extends AdvancedRuntime {
+  interface Locals extends AdvancedRuntime<ENV> {
     user: {
       name: string;
       surname: string;
@@ -132,8 +136,12 @@ If you're using the `directory` runtime, you can type the `runtime` object as fo
 /// <reference types="astro/client" />
 import type { DirectoryRuntime } from '@astrojs/cloudflare';
 
+type ENV = {
+  SERVER_URL: string;
+}
+
 declare namespace App {
-  interface Locals extends DirectoryRuntime {
+  interface Locals extends DirectoryRuntime<ENV> {
     user: {
       name: string;
       surname: string;

packages/integrations/cloudflare/src/server.advanced.ts

@@ -12,10 +12,10 @@ type Env = {
 	name: string;
 };
 
-export interface AdvancedRuntime {
+export interface AdvancedRuntime<T extends object = object> {
 	runtime: {
 		waitUntil: (promise: Promise<any>) => void;
-		env: Env;
+		env: Env & T;
 		cf: CFRequest['cf'];
 		caches: typeof caches;
 	};

packages/integrations/cloudflare/src/server.directory.ts

@@ -7,10 +7,10 @@ if (!isNode) {
 	process.env = getProcessEnvProxy();
 }
 
-export interface DirectoryRuntime {
+export interface DirectoryRuntime<T extends object = object> {
 	runtime: {
 		waitUntil: (promise: Promise<any>) => void;
-		env: EventContext<unknown, string, unknown>['env'];
+		env: EventContext<unknown, string, unknown>['env'] & T;
 		cf: CFRequest['cf'];
 		caches: typeof caches;
 	};