@timber-js/app 0.2.0-alpha.7 → 0.2.0-alpha.71

package/dist/adapters/cloudflare.d.ts

@@ -20,12 +20,79 @@ import type { TimberPlatformAdapter, TimberConfig } from './types';
  * }
  * ```
  */
-export declare function getCloudflareBindings<T extends Record<string, unknown> = Record<string, unknown>>(): T;
+export declare function getCloudflareBindings<T = Record<string, unknown>>(): T;
 /**
  * Run a function with Cloudflare bindings available via getCloudflareBindings().
  * @internal Used by wrapWithExecutionContext.
  */
 export declare function runWithBindings<T>(env: Record<string, unknown>, fn: () => T): T;
+/** KV namespace binding. `id` defaults to `''` (filled in by wrangler or dashboard). */
+export interface CloudflareKVBinding {
+    name: string;
+    id?: string;
+}
+/** D1 database binding. `database_id` is required (from Cloudflare dashboard). */
+export interface CloudflareD1Binding {
+    name: string;
+    database_id: string;
+}
+/** R2 bucket binding. `bucket_name` must match the bucket created in Cloudflare. */
+export interface CloudflareR2Binding {
+    name: string;
+    bucket_name: string;
+}
+/** Queue producer binding. `queue` is the queue name in Cloudflare. */
+export interface CloudflareQueueProducer {
+    name: string;
+    queue: string;
+}
+/** Queue consumer declaration. Attached to the worker, not a binding name. */
+export interface CloudflareQueueConsumer {
+    queue: string;
+    max_batch_size?: number;
+    max_retries?: number;
+    dead_letter_queue?: string;
+}
+/** Durable Object binding. `script_name` is for external DO references. */
+export interface CloudflareDurableObjectBinding {
+    name: string;
+    class_name: string;
+    script_name?: string;
+}
+/**
+ * Declarative Cloudflare bindings configuration.
+ *
+ * These are converted to the appropriate wrangler.jsonc sections
+ * (`kv_namespaces`, `d1_databases`, `r2_buckets`, `queues`, `durable_objects`).
+ * The `wrangler` escape hatch overrides any generated binding sections
+ * if there's a conflict.
+ *
+ * @example
+ * ```ts
+ * cloudflare({
+ *   bindings: {
+ *     kv: [{ name: 'TIMBER_CACHE' }],
+ *     d1: [{ name: 'MY_DB', database_id: 'xxxx' }],
+ *     r2: [{ name: 'MY_BUCKET', bucket_name: 'my-bucket' }],
+ *     queues: {
+ *       producers: [{ name: 'EMAIL_QUEUE', queue: 'email-queue' }],
+ *       consumers: [{ queue: 'email-queue', max_batch_size: 10 }],
+ *     },
+ *     durableObjects: [{ name: 'MY_DO', class_name: 'MyDurableObject' }],
+ *   },
+ * })
+ * ```
+ */
+export interface CloudflareBindings {
+    kv?: CloudflareKVBinding[];
+    d1?: CloudflareD1Binding[];
+    r2?: CloudflareR2Binding[];
+    queues?: {
+        producers?: CloudflareQueueProducer[];
+        consumers?: CloudflareQueueConsumer[];
+    };
+    durableObjects?: CloudflareDurableObjectBinding[];
+}
 /** Options for the Cloudflare Workers adapter. */
 export interface CloudflareAdapterOptions {
     /**
@@ -38,11 +105,40 @@ export interface CloudflareAdapterOptions {
      * @default ['nodejs_compat']
      */
     compatibilityFlags?: string[];
+    /**
+     * Declarative Cloudflare bindings. Generates the appropriate
+     * `kv_namespaces`, `d1_databases`, `r2_buckets`, `queues`, and
+     * `durable_objects` sections in wrangler.jsonc.
+     *
+     * If both `bindings` and `wrangler` specify the same section,
+     * `wrangler` wins (it's the escape hatch).
+     */
+    bindings?: CloudflareBindings;
     /**
      * Custom wrangler.jsonc fields to merge.
-     * Overrides generated values.
+     * Overrides generated values (including bindings-generated sections).
      */
     wrangler?: Record<string, unknown>;
+    /**
+     * Path to a module that exports additional Worker handlers (queue, scheduled, email, etc.).
+     * The module is imported in the generated `_worker.js` and its named exports are
+     * spread into the default export alongside `fetch`.
+     *
+     * The module receives `(batch/event, env, ctx)` — standard Cloudflare handler signatures.
+     * It does NOT have access to timber's request pipeline (no ALS, no getCloudflareBindings).
+     * Use `env` directly for bindings.
+     *
+     * @example
+     * ```ts
+     * // timber.config.ts
+     * adapter: cloudflare({ workerHandlers: './src/worker-handlers.ts' })
+     *
+     * // src/worker-handlers.ts
+     * export async function queue(batch, env) { ... }
+     * export async function scheduled(controller, env, ctx) { ... }
+     * ```
+     */
+    workerHandlers?: string;
 }
 /**
  * Create a Cloudflare Workers adapter.
@@ -67,9 +163,49 @@ export declare function cloudflare(options?: CloudflareAdapterOptions): TimberPl
  * 1. Binds `adapter.waitUntil()` to `ctx.waitUntil()` per-request
  * 2. Makes `env` accessible via `getCloudflareBindings()` per-request via ALS
  */
-export declare function wrapWithExecutionContext(adapter: TimberPlatformAdapter, handler: (req: Request) => Promise<Response>): ExportedHandler<Record<string, unknown>>;
+export declare function wrapWithExecutionContext(adapter: TimberPlatformAdapter, handler: (req: Request) => Promise<Response>): CfExportedHandler<Record<string, unknown>>;
 /** @internal Exported for testing. */
-export declare function generateWorkerEntry(buildDir: string, outDir: string, hasManifestInit?: boolean): string;
+export declare function generateWorkerEntry(buildDir: string, outDir: string, hasManifestInit?: boolean, hasWorkerHandlers?: boolean): string;
+/** Wrangler binding sections generated from `CloudflareBindings`. */
+export interface WranglerBindingsConfig {
+    kv_namespaces?: Array<{
+        binding: string;
+        id: string;
+    }>;
+    d1_databases?: Array<{
+        binding: string;
+        database_id: string;
+    }>;
+    r2_buckets?: Array<{
+        binding: string;
+        bucket_name: string;
+    }>;
+    queues?: {
+        producers?: Array<{
+            binding: string;
+            queue: string;
+        }>;
+        consumers?: Array<Record<string, unknown>>;
+    };
+    durable_objects?: {
+        bindings: Array<Record<string, string>>;
+    };
+}
+/**
+ * Convert declarative `CloudflareBindings` into wrangler.jsonc binding sections.
+ *
+ * Maps:
+ * - `kv`             → `kv_namespaces`
+ * - `d1`             → `d1_databases`
+ * - `r2`             → `r2_buckets`
+ * - `queues`         → `queues` (producers + consumers)
+ * - `durableObjects` → `durable_objects`
+ *
+ * Empty arrays are omitted from the output.
+ *
+ * @internal Exported for testing.
+ */
+export declare function generateBindingsConfig(bindings: CloudflareBindings | undefined): WranglerBindingsConfig;
 /** @internal Exported for testing. */
 export declare function generateWranglerConfig(config: TimberConfig, options: CloudflareAdapterOptions): Record<string, unknown>;
 /** Command descriptor for preview — testable without spawning a process. */
@@ -80,13 +216,13 @@ export interface PreviewCommand {
 }
 /** @internal Exported for testing. */
 export declare function generatePreviewCommand(buildDir: string): PreviewCommand;
-declare global {
-    interface ExecutionContext {
-        waitUntil(promise: Promise<unknown>): void;
-        passThroughOnException(): void;
-    }
-    interface ExportedHandler<Env = Record<string, unknown>> {
-        fetch?(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> | Response;
-    }
+/** @internal Minimal stub — use @cloudflare/workers-types for full types. */
+export interface CfExecutionContext {
+    waitUntil(promise: Promise<unknown>): void;
+    passThroughOnException(): void;
+}
+/** @internal Minimal stub — use @cloudflare/workers-types for full types. */
+export interface CfExportedHandler<Env = Record<string, unknown>> {
+    fetch?(request: Request, env: Env, ctx: CfExecutionContext): Promise<Response> | Response;
 }
 //# sourceMappingURL=cloudflare.d.ts.map

package/dist/adapters/cloudflare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../src/adapters/cloudflare.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA2BnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACxD,CAAC,CAUL;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE/E;AAED,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,wBAA6B,GAAG,qBAAqB,CA2DxF;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,GAC3C,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsB1C;AAID,sCAAsC;AACtC,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,eAAe,UAAQ,GACtB,MAAM,CA0BR;AAED,sCAAsC;AACtC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,wBAAwB,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzB;AAID,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,sCAAsC;AACtC,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAOvE;AAqBD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,gBAAgB;QACxB,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;QAC3C,sBAAsB,IAAI,IAAI,CAAC;KAChC;IAED,UAAU,eAAe,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;QACrD,KAAK,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;KACzF;CACF"}
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../src/adapters/cloudflare.ts"],"names":[],"mappings":"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"}

package/dist/adapters/cloudflare.js

@@ -16,7 +16,15 @@ function generateHeadersFile() {
   Cache-Control: ${STATIC_CACHE}
 `;
 }
-var bindingsAls = new AsyncLocalStorage();
+var BINDINGS_ALS_KEY = Symbol.for("timber:cf-bindings-als");
+function getBindingsAls() {
+	let als = globalThis[BINDINGS_ALS_KEY];
+	if (!als) {
+		als = new AsyncLocalStorage();
+		globalThis[BINDINGS_ALS_KEY] = als;
+	}
+	return als;
+}
 /**
 * Get Cloudflare Worker bindings for the current request.
 *
@@ -39,7 +47,7 @@ var bindingsAls = new AsyncLocalStorage();
 * ```
 */
 function getCloudflareBindings() {
-	const env = bindingsAls.getStore();
+	const env = getBindingsAls().getStore();
 	if (!env) throw new Error("getCloudflareBindings() called outside a Cloudflare Workers request context. It can only be called from server components, middleware, or server actions when running on the Cloudflare adapter.");
 	return env;
 }
@@ -48,7 +56,7 @@ function getCloudflareBindings() {
 * @internal Used by wrapWithExecutionContext.
 */
 function runWithBindings(env, fn) {
-	return bindingsAls.run(env, fn);
+	return getBindingsAls().run(env, fn);
 }
 /**
 * Create a Cloudflare Workers adapter.
@@ -82,7 +90,28 @@ function cloudflare(options = {}) {
 			await cp(rscDir, join(outDir, "rsc"), { recursive: true });
 			await cp(ssrDir, join(outDir, "ssr"), { recursive: true });
 			if (config.manifestInit) await writeFile(join(outDir, "_timber-manifest-init.js"), config.manifestInit);
-			const workerEntry = generateWorkerEntry(outDir, outDir, !!config.manifestInit);
+			let hasWorkerHandlers = false;
+			if (options.workerHandlers) {
+				const handlersEntry = join(process.cwd(), options.workerHandlers);
+				const { build: viteBuild } = await import("vite");
+				await viteBuild({
+					configFile: false,
+					logLevel: "info",
+					build: {
+						lib: {
+							entry: handlersEntry,
+							formats: ["es"],
+							fileName: () => "_worker-handlers.js"
+						},
+						outDir,
+						emptyOutDir: false,
+						minify: false,
+						rollupOptions: { external: [/^node:/] }
+					}
+				});
+				hasWorkerHandlers = true;
+			}
+			const workerEntry = generateWorkerEntry(outDir, outDir, !!config.manifestInit, hasWorkerHandlers);
 			await writeFile(join(outDir, "_worker.js"), workerEntry);
 			const wranglerConfig = generateWranglerConfig(config, options);
 			await writeFile(join(outDir, "wrangler.jsonc"), JSON.stringify(wranglerConfig, null, 2));
@@ -117,22 +146,115 @@ function wrapWithExecutionContext(adapter, handler) {
 	} };
 }
 /** @internal Exported for testing. */
-function generateWorkerEntry(buildDir, outDir, hasManifestInit = false) {
+function generateWorkerEntry(buildDir, outDir, hasManifestInit = false, hasWorkerHandlers = false) {
 	let rscEntryRelative = relative(outDir, join(buildDir, "rsc", "index.js"));
 	if (!rscEntryRelative.startsWith(".")) rscEntryRelative = "./" + rscEntryRelative;
 	return `// Generated by @timber-js/app/adapters/cloudflare
 // Do not edit — this file is regenerated on each build.
 
+import { AsyncLocalStorage } from 'node:async_hooks'
 ${hasManifestInit ? "import './_timber-manifest-init.js'\n" : ""}import handler from '${rscEntryRelative}'
-
+${hasWorkerHandlers ? "import * as workerHandlers from './_worker-handlers.js'\n" : ""}
 // Set TIMBER_RUNTIME for instrumentation.ts conditional SDK initialization.
 // See design/25-production-deployments.md §"TIMBER_RUNTIME".
 globalThis.process ??= { env: {} }
 process.env.TIMBER_RUNTIME = 'cloudflare'
 
-export default { fetch: handler }
+// Bind Cloudflare env to ALS so getCloudflareBindings() works at runtime.
+// Uses the same Symbol.for key as getCloudflareBindings() reads from.
+const ALS_KEY = Symbol.for('timber:cf-bindings-als')
+let bindingsAls = globalThis[ALS_KEY]
+if (!bindingsAls) {
+  bindingsAls = new AsyncLocalStorage()
+  globalThis[ALS_KEY] = bindingsAls
+}
+
+export default {
+${hasWorkerHandlers ? "  ...workerHandlers,\n" : ""}  async fetch(request, env, ctx) {
+    return bindingsAls.run(env, () => handler(request))
+  }
+}
 `;
 }
+/**
+* Convert declarative `CloudflareBindings` into wrangler.jsonc binding sections.
+*
+* Maps:
+* - `kv`             → `kv_namespaces`
+* - `d1`             → `d1_databases`
+* - `r2`             → `r2_buckets`
+* - `queues`         → `queues` (producers + consumers)
+* - `durableObjects` → `durable_objects`
+*
+* Empty arrays are omitted from the output.
+*
+* @internal Exported for testing.
+*/
+function generateBindingsConfig(bindings) {
+	if (!bindings) return {};
+	const result = {};
+	if (bindings.kv && bindings.kv.length > 0) result.kv_namespaces = bindings.kv.map((kv) => ({
+		binding: kv.name,
+		id: kv.id ?? ""
+	}));
+	if (bindings.d1 && bindings.d1.length > 0) result.d1_databases = bindings.d1.map((d1) => ({
+		binding: d1.name,
+		database_id: d1.database_id
+	}));
+	if (bindings.r2 && bindings.r2.length > 0) result.r2_buckets = bindings.r2.map((r2) => ({
+		binding: r2.name,
+		bucket_name: r2.bucket_name
+	}));
+	if (bindings.queues) {
+		const queues = {};
+		if (bindings.queues.producers && bindings.queues.producers.length > 0) queues.producers = bindings.queues.producers.map((p) => ({
+			binding: p.name,
+			queue: p.queue
+		}));
+		if (bindings.queues.consumers && bindings.queues.consumers.length > 0) queues.consumers = bindings.queues.consumers.map((c) => {
+			const consumer = { queue: c.queue };
+			if (c.max_batch_size !== void 0) consumer.max_batch_size = c.max_batch_size;
+			if (c.max_retries !== void 0) consumer.max_retries = c.max_retries;
+			if (c.dead_letter_queue !== void 0) consumer.dead_letter_queue = c.dead_letter_queue;
+			return consumer;
+		});
+		if (Object.keys(queues).length > 0) result.queues = queues;
+	}
+	if (bindings.durableObjects && bindings.durableObjects.length > 0) result.durable_objects = { bindings: bindings.durableObjects.map((dobj) => {
+		const entry = {
+			name: dobj.name,
+			class_name: dobj.class_name
+		};
+		if (dobj.script_name) entry.script_name = dobj.script_name;
+		return entry;
+	}) };
+	return result;
+}
+/**
+* One-level deep merge: for each key in `override`, if both the base and
+* override values are plain objects (not arrays, not null), merge their
+* keys with override winning on conflicts. Everything else (primitives,
+* arrays, null) is replaced outright — matching the intuitive behavior
+* where `kv_namespaces: [...]` replaces fully but
+* `durable_objects: { migrations }` merges with generated `bindings`.
+*/
+function shallowDeepMerge(base, override) {
+	const result = { ...base };
+	for (const key of Object.keys(override)) {
+		const baseVal = result[key];
+		const overVal = override[key];
+		if (isPlainObject(baseVal) && isPlainObject(overVal)) result[key] = {
+			...baseVal,
+			...overVal
+		};
+		else result[key] = overVal;
+	}
+	return result;
+}
+/** True for `{}` literals — false for arrays, null, Date, etc. */
+function isPlainObject(val) {
+	return val !== null && typeof val === "object" && !Array.isArray(val);
+}
 /** @internal Exported for testing. */
 function generateWranglerConfig(config, options) {
 	const base = {
@@ -148,11 +270,13 @@ function generateWranglerConfig(config, options) {
 		}],
 		assets: { directory: "./static" }
 	};
-	if (options.wrangler) return {
+	const bindingsConfig = generateBindingsConfig(options.bindings);
+	const merged = {
 		...base,
-		...options.wrangler
+		...bindingsConfig
 	};
-	return base;
+	if (options.wrangler) return shallowDeepMerge(merged, options.wrangler);
+	return merged;
 }
 /** @internal Exported for testing. */
 function generatePreviewCommand(buildDir) {
@@ -183,6 +307,6 @@ function spawnPreviewProcess(command, args, cwd) {
 	});
 }
 //#endregion
-export { cloudflare, generatePreviewCommand, generateWorkerEntry, generateWranglerConfig, getCloudflareBindings, runWithBindings, wrapWithExecutionContext };
+export { cloudflare, generateBindingsConfig, generatePreviewCommand, generateWorkerEntry, generateWranglerConfig, getCloudflareBindings, runWithBindings, wrapWithExecutionContext };
 
 //# sourceMappingURL=cloudflare.js.map

package/dist/adapters/cloudflare.js.map

@@ -1 +1 @@
-{"version":3,"file":"cloudflare.js","names":[],"sources":["../../src/adapters/cloudflare.ts"],"sourcesContent":["// Cloudflare Workers adapter\n//\n// Primary deployment target. Generates a Workers-compatible entry point\n// and wrangler.jsonc configuration. See design/11-platform.md §\"Cloudflare Workers\".\n\nimport { writeFile, mkdir, cp } from 'node:fs/promises';\nimport { execFile } from 'node:child_process';\nimport { join, relative } from 'node:path';\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport type { TimberPlatformAdapter, TimberConfig } from './types';\n// Inlined from server/asset-headers.ts — adapters are loaded by Node at\n// Vite startup time, before Vite's module resolver is available, so cross-\n// directory .ts imports don't resolve.\nconst IMMUTABLE_CACHE = 'public, max-age=31536000, immutable';\nconst STATIC_CACHE = 'public, max-age=3600, must-revalidate';\n\nfunction generateHeadersFile(): string {\n  return `# Auto-generated by @timber-js/app — static asset cache headers.\n# See design/25-production-deployments.md §\"CDN / Edge Cache\"\n\n/assets/*\n  Cache-Control: ${IMMUTABLE_CACHE}\n\n/*\n  Cache-Control: ${STATIC_CACHE}\n`;\n}\n\n// ─── Bindings passthrough ─────────────────────────────────────────────────\n// ALS stores the env object per-request so server components and middleware\n// can access KV, D1, DO, R2, Queues, etc. via getCloudflareBindings().\n// No global fallback — if called outside a request, it throws.\n// See design/11-platform.md §\"Platform Target\" and design/25-production-deployments.md.\n\nconst bindingsAls = new AsyncLocalStorage<Record<string, unknown>>();\n\n/**\n * Get Cloudflare Worker bindings for the current request.\n *\n * Returns the `env` object passed to the Worker's `fetch` handler,\n * giving direct access to KV, D1, Durable Objects, R2, Queues, and\n * any other bindings configured in `wrangler.jsonc`.\n *\n * Must be called within a request context (server component, middleware,\n * server action). Throws outside a request.\n *\n * @example\n * ```ts\n * import { getCloudflareBindings } from '@timber-js/app/adapters/cloudflare'\n *\n * export default async function Page() {\n *   const { MY_KV, MY_DB } = getCloudflareBindings()\n *   const data = await MY_KV.get('key')\n *   return <div>{data}</div>\n * }\n * ```\n */\nexport function getCloudflareBindings<\n  T extends Record<string, unknown> = Record<string, unknown>,\n>(): T {\n  const env = bindingsAls.getStore();\n  if (!env) {\n    throw new Error(\n      'getCloudflareBindings() called outside a Cloudflare Workers request context. ' +\n        'It can only be called from server components, middleware, or server actions ' +\n        'when running on the Cloudflare adapter.'\n    );\n  }\n  return env as T;\n}\n\n/**\n * Run a function with Cloudflare bindings available via getCloudflareBindings().\n * @internal Used by wrapWithExecutionContext.\n */\nexport function runWithBindings<T>(env: Record<string, unknown>, fn: () => T): T {\n  return bindingsAls.run(env, fn);\n}\n\n/** Options for the Cloudflare Workers adapter. */\nexport interface CloudflareAdapterOptions {\n  /**\n   * Cloudflare compatibility date.\n   * @default Current date in YYYY-MM-DD format at build time.\n   */\n  compatibilityDate?: string;\n\n  /**\n   * Additional compatibility flags.\n   * @default ['nodejs_compat']\n   */\n  compatibilityFlags?: string[];\n\n  /**\n   * Custom wrangler.jsonc fields to merge.\n   * Overrides generated values.\n   */\n  wrangler?: Record<string, unknown>;\n}\n\n/**\n * Create a Cloudflare Workers adapter.\n *\n * @example\n * ```ts\n * import { cloudflare } from '@timber-js/app/adapters/cloudflare'\n *\n * export default {\n *   output: 'server',\n *   adapter: cloudflare(),\n * }\n * ```\n */\nexport function cloudflare(options: CloudflareAdapterOptions = {}): TimberPlatformAdapter {\n  return {\n    name: 'cloudflare',\n\n    async buildOutput(config: TimberConfig, buildDir: string) {\n      const outDir = join(buildDir, 'cloudflare');\n      await mkdir(outDir, { recursive: true });\n\n      // Copy client assets to static output.\n      // When client JavaScript is disabled, skip .js files — only CSS,\n      // fonts, images, and other static assets are needed.\n      const clientDir = join(buildDir, 'client');\n      const staticDir = join(outDir, 'static');\n      await mkdir(staticDir, { recursive: true });\n      await cp(clientDir, staticDir, {\n        recursive: true,\n        filter: config.clientJavascriptDisabled ? (src: string) => !src.endsWith('.js') : undefined,\n      }).catch(() => {\n        // Client dir may not exist when client JavaScript is disabled\n      });\n\n      // Write _headers file for static asset cache control.\n      // Cloudflare Workers Static Assets reads this to set Cache-Control\n      // headers on responses. Hashed assets get immutable; others get 1h.\n      await writeFile(join(staticDir, '_headers'), generateHeadersFile());\n\n      // Copy server bundles (rsc + ssr) into the output directory.\n      // These are already fully bundled by Vite with resolve.noExternal: true.\n      const rscDir = join(buildDir, 'rsc');\n      const ssrDir = join(buildDir, 'ssr');\n      await cp(rscDir, join(outDir, 'rsc'), { recursive: true });\n      await cp(ssrDir, join(outDir, 'ssr'), { recursive: true });\n\n      // Write the build manifest init module (if manifest data was produced).\n      // This must be imported before the RSC handler so the global is set\n      // when virtual:timber-build-manifest evaluates.\n      if (config.manifestInit) {\n        await writeFile(join(outDir, '_timber-manifest-init.js'), config.manifestInit);\n      }\n\n      // Generate the Workers entry point\n      const hasManifestInit = !!config.manifestInit;\n      const workerEntry = generateWorkerEntry(outDir, outDir, hasManifestInit);\n      await writeFile(join(outDir, '_worker.js'), workerEntry);\n\n      // Generate wrangler.jsonc\n      const wranglerConfig = generateWranglerConfig(config, options);\n      await writeFile(join(outDir, 'wrangler.jsonc'), JSON.stringify(wranglerConfig, null, 2));\n    },\n\n    async preview(_config: TimberConfig, buildDir: string) {\n      const cmd = generatePreviewCommand(buildDir);\n      await spawnPreviewProcess(cmd.command, cmd.args, cmd.cwd);\n    },\n\n    // Default no-op. wrapWithExecutionContext() replaces this per-request\n    // with a function that routes to ctx.waitUntil().\n    waitUntil(_promise: Promise<unknown>) {},\n  };\n}\n\n/**\n * Wrap a timber request handler to bind the Cloudflare execution context\n * for `waitUntil()` support and env bindings passthrough.\n * Called from the generated worker entry.\n *\n * This function:\n * 1. Binds `adapter.waitUntil()` to `ctx.waitUntil()` per-request\n * 2. Makes `env` accessible via `getCloudflareBindings()` per-request via ALS\n */\nexport function wrapWithExecutionContext(\n  adapter: TimberPlatformAdapter,\n  handler: (req: Request) => Promise<Response>\n): ExportedHandler<Record<string, unknown>> {\n  return {\n    async fetch(\n      request: Request,\n      env: Record<string, unknown>,\n      ctx: ExecutionContext\n    ): Promise<Response> {\n      // Bind the adapter's waitUntil to the Workers execution context\n      const originalWaitUntil = adapter.waitUntil;\n      adapter.waitUntil = (promise: Promise<unknown>) => {\n        ctx.waitUntil(promise);\n      };\n\n      try {\n        // Run the handler within ALS so getCloudflareBindings() works\n        return await runWithBindings(env, () => handler(request));\n      } finally {\n        // Restore (in case adapter is reused across isolate resets)\n        adapter.waitUntil = originalWaitUntil;\n      }\n    },\n  };\n}\n\n// ─── Exported helpers (used by tests and build) ─────────────────────────────\n\n/** @internal Exported for testing. */\nexport function generateWorkerEntry(\n  buildDir: string,\n  outDir: string,\n  hasManifestInit = false\n): string {\n  // The RSC entry is the main request handler — it exports the fetch handler as default.\n  // The Vite RSC plugin outputs it to rsc/index.js.\n  let rscEntryRelative = relative(outDir, join(buildDir, 'rsc', 'index.js'));\n  // Ensure the import path starts with ./ for ESM compatibility\n  if (!rscEntryRelative.startsWith('.')) {\n    rscEntryRelative = './' + rscEntryRelative;\n  }\n\n  // Build manifest init must be imported before the RSC handler so that\n  // globalThis.__TIMBER_BUILD_MANIFEST__ is set when the virtual module evaluates.\n  // ESM guarantees imports are evaluated in order.\n  const manifestImport = hasManifestInit ? \"import './_timber-manifest-init.js'\\n\" : '';\n\n  return `// Generated by @timber-js/app/adapters/cloudflare\n// Do not edit — this file is regenerated on each build.\n\n${manifestImport}import handler from '${rscEntryRelative}'\n\n// Set TIMBER_RUNTIME for instrumentation.ts conditional SDK initialization.\n// See design/25-production-deployments.md §\"TIMBER_RUNTIME\".\nglobalThis.process ??= { env: {} }\nprocess.env.TIMBER_RUNTIME = 'cloudflare'\n\nexport default { fetch: handler }\n`;\n}\n\n/** @internal Exported for testing. */\nexport function generateWranglerConfig(\n  config: TimberConfig,\n  options: CloudflareAdapterOptions\n): Record<string, unknown> {\n  const compatDate = options.compatibilityDate ?? new Date().toISOString().slice(0, 10);\n\n  const flags = options.compatibilityFlags ?? ['nodejs_compat'];\n\n  const base: Record<string, unknown> = {\n    name: 'timber-app',\n    main: '_worker.js',\n    compatibility_date: compatDate,\n    compatibility_flags: flags,\n    // The build output is already fully bundled by Vite — skip wrangler's\n    // esbuild pass to avoid issues with top-level await and module format.\n    no_bundle: true,\n    find_additional_modules: true,\n    rules: [{ type: 'ESModule', globs: ['**/*.js'] }],\n    assets: {\n      directory: './static',\n    },\n  };\n\n  // Merge user overrides\n  if (options.wrangler) {\n    return { ...base, ...options.wrangler };\n  }\n\n  return base;\n}\n\n// ─── Preview ─────────────────────────────────────────────────────────────────\n\n/** Command descriptor for preview — testable without spawning a process. */\nexport interface PreviewCommand {\n  command: string;\n  args: string[];\n  cwd: string;\n}\n\n/** @internal Exported for testing. */\nexport function generatePreviewCommand(buildDir: string): PreviewCommand {\n  const cfDir = join(buildDir, 'cloudflare');\n  return {\n    command: 'wrangler',\n    args: ['dev', '--local', '--config', join(cfDir, 'wrangler.jsonc')],\n    cwd: cfDir,\n  };\n}\n\n/**\n * Spawn a long-running preview process and pipe stdio to the parent.\n * Resolves when the process exits.\n */\nfunction spawnPreviewProcess(command: string, args: string[], cwd: string): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    const child = execFile(command, args, { cwd }, (err) => {\n      if (err) reject(err);\n      else resolve();\n    });\n    child.stdout?.pipe(process.stdout);\n    child.stderr?.pipe(process.stderr);\n  });\n}\n\n// ─── Cloudflare Workers type stubs ───────────────────────────────────────────\n// Minimal type declarations so this file compiles without @cloudflare/workers-types.\n// In production builds, users install @cloudflare/workers-types themselves.\n\ndeclare global {\n  interface ExecutionContext {\n    waitUntil(promise: Promise<unknown>): void;\n    passThroughOnException(): void;\n  }\n\n  interface ExportedHandler<Env = Record<string, unknown>> {\n    fetch?(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> | Response;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"cloudflare.js","names":[],"sources":["../../src/adapters/cloudflare.ts"],"sourcesContent":["// Cloudflare Workers adapter\n//\n// Primary deployment target. Generates a Workers-compatible entry point\n// and wrangler.jsonc configuration. See design/11-platform.md §\"Cloudflare Workers\".\n\nimport { writeFile, mkdir, cp } from 'node:fs/promises';\nimport { execFile } from 'node:child_process';\nimport { join, relative } from 'node:path';\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport type { TimberPlatformAdapter, TimberConfig } from './types';\n// Inlined from server/asset-headers.ts — adapters are loaded by Node at\n// Vite startup time, before Vite's module resolver is available, so cross-\n// directory .ts imports don't resolve.\nconst IMMUTABLE_CACHE = 'public, max-age=31536000, immutable';\nconst STATIC_CACHE = 'public, max-age=3600, must-revalidate';\n\nfunction generateHeadersFile(): string {\n  return `# Auto-generated by @timber-js/app — static asset cache headers.\n# See design/25-production-deployments.md §\"CDN / Edge Cache\"\n\n/assets/*\n  Cache-Control: ${IMMUTABLE_CACHE}\n\n/*\n  Cache-Control: ${STATIC_CACHE}\n`;\n}\n\n// ─── Bindings passthrough ─────────────────────────────────────────────────\n// ALS stores the env object per-request so server components and middleware\n// can access KV, D1, DO, R2, Queues, etc. via getCloudflareBindings().\n// No global fallback — if called outside a request, it throws.\n// See design/11-platform.md §\"Platform Target\" and design/25-production-deployments.md.\n//\n// The ALS is stored on globalThis via Symbol.for so it survives Vite's\n// module instance split in dev mode. The Vite host process (where\n// cloudflareDevBindings → runWithBindings runs) and the RSC module runner\n// (where getCloudflareBindings runs) load separate instances of this file,\n// each with their own module-level variables. globalThis + Symbol.for\n// ensures both share the same ALS — same pattern React uses for\n// Symbol.for('react.element').\n\nconst BINDINGS_ALS_KEY = Symbol.for('timber:cf-bindings-als');\n\nfunction getBindingsAls(): AsyncLocalStorage<Record<string, unknown>> {\n  let als = (globalThis as any)[BINDINGS_ALS_KEY] as\n    | AsyncLocalStorage<Record<string, unknown>>\n    | undefined;\n  if (!als) {\n    als = new AsyncLocalStorage<Record<string, unknown>>();\n    (globalThis as any)[BINDINGS_ALS_KEY] = als;\n  }\n  return als;\n}\n\n/**\n * Get Cloudflare Worker bindings for the current request.\n *\n * Returns the `env` object passed to the Worker's `fetch` handler,\n * giving direct access to KV, D1, Durable Objects, R2, Queues, and\n * any other bindings configured in `wrangler.jsonc`.\n *\n * Must be called within a request context (server component, middleware,\n * server action). Throws outside a request.\n *\n * @example\n * ```ts\n * import { getCloudflareBindings } from '@timber-js/app/adapters/cloudflare'\n *\n * export default async function Page() {\n *   const { MY_KV, MY_DB } = getCloudflareBindings()\n *   const data = await MY_KV.get('key')\n *   return <div>{data}</div>\n * }\n * ```\n */\nexport function getCloudflareBindings<T = Record<string, unknown>>(): T {\n  const env = getBindingsAls().getStore();\n  if (!env) {\n    throw new Error(\n      'getCloudflareBindings() called outside a Cloudflare Workers request context. ' +\n        'It can only be called from server components, middleware, or server actions ' +\n        'when running on the Cloudflare adapter.'\n    );\n  }\n  return env as T;\n}\n\n/**\n * Run a function with Cloudflare bindings available via getCloudflareBindings().\n * @internal Used by wrapWithExecutionContext.\n */\nexport function runWithBindings<T>(env: Record<string, unknown>, fn: () => T): T {\n  return getBindingsAls().run(env, fn);\n}\n\n// ─── Binding configuration types ──────────────────────────────────────────────\n// Declarative binding config that maps to wrangler.jsonc binding sections.\n// See design/35-cloudflare-primitives.md §\"Binding Declarations in Adapter Config\".\n\n/** KV namespace binding. `id` defaults to `''` (filled in by wrangler or dashboard). */\nexport interface CloudflareKVBinding {\n  name: string;\n  id?: string;\n}\n\n/** D1 database binding. `database_id` is required (from Cloudflare dashboard). */\nexport interface CloudflareD1Binding {\n  name: string;\n  database_id: string;\n}\n\n/** R2 bucket binding. `bucket_name` must match the bucket created in Cloudflare. */\nexport interface CloudflareR2Binding {\n  name: string;\n  bucket_name: string;\n}\n\n/** Queue producer binding. `queue` is the queue name in Cloudflare. */\nexport interface CloudflareQueueProducer {\n  name: string;\n  queue: string;\n}\n\n/** Queue consumer declaration. Attached to the worker, not a binding name. */\nexport interface CloudflareQueueConsumer {\n  queue: string;\n  max_batch_size?: number;\n  max_retries?: number;\n  dead_letter_queue?: string;\n}\n\n/** Durable Object binding. `script_name` is for external DO references. */\nexport interface CloudflareDurableObjectBinding {\n  name: string;\n  class_name: string;\n  script_name?: string;\n}\n\n/**\n * Declarative Cloudflare bindings configuration.\n *\n * These are converted to the appropriate wrangler.jsonc sections\n * (`kv_namespaces`, `d1_databases`, `r2_buckets`, `queues`, `durable_objects`).\n * The `wrangler` escape hatch overrides any generated binding sections\n * if there's a conflict.\n *\n * @example\n * ```ts\n * cloudflare({\n *   bindings: {\n *     kv: [{ name: 'TIMBER_CACHE' }],\n *     d1: [{ name: 'MY_DB', database_id: 'xxxx' }],\n *     r2: [{ name: 'MY_BUCKET', bucket_name: 'my-bucket' }],\n *     queues: {\n *       producers: [{ name: 'EMAIL_QUEUE', queue: 'email-queue' }],\n *       consumers: [{ queue: 'email-queue', max_batch_size: 10 }],\n *     },\n *     durableObjects: [{ name: 'MY_DO', class_name: 'MyDurableObject' }],\n *   },\n * })\n * ```\n */\nexport interface CloudflareBindings {\n  kv?: CloudflareKVBinding[];\n  d1?: CloudflareD1Binding[];\n  r2?: CloudflareR2Binding[];\n  queues?: {\n    producers?: CloudflareQueueProducer[];\n    consumers?: CloudflareQueueConsumer[];\n  };\n  durableObjects?: CloudflareDurableObjectBinding[];\n}\n\n/** Options for the Cloudflare Workers adapter. */\nexport interface CloudflareAdapterOptions {\n  /**\n   * Cloudflare compatibility date.\n   * @default Current date in YYYY-MM-DD format at build time.\n   */\n  compatibilityDate?: string;\n\n  /**\n   * Additional compatibility flags.\n   * @default ['nodejs_compat']\n   */\n  compatibilityFlags?: string[];\n\n  /**\n   * Declarative Cloudflare bindings. Generates the appropriate\n   * `kv_namespaces`, `d1_databases`, `r2_buckets`, `queues`, and\n   * `durable_objects` sections in wrangler.jsonc.\n   *\n   * If both `bindings` and `wrangler` specify the same section,\n   * `wrangler` wins (it's the escape hatch).\n   */\n  bindings?: CloudflareBindings;\n\n  /**\n   * Custom wrangler.jsonc fields to merge.\n   * Overrides generated values (including bindings-generated sections).\n   */\n  wrangler?: Record<string, unknown>;\n\n  /**\n   * Path to a module that exports additional Worker handlers (queue, scheduled, email, etc.).\n   * The module is imported in the generated `_worker.js` and its named exports are\n   * spread into the default export alongside `fetch`.\n   *\n   * The module receives `(batch/event, env, ctx)` — standard Cloudflare handler signatures.\n   * It does NOT have access to timber's request pipeline (no ALS, no getCloudflareBindings).\n   * Use `env` directly for bindings.\n   *\n   * @example\n   * ```ts\n   * // timber.config.ts\n   * adapter: cloudflare({ workerHandlers: './src/worker-handlers.ts' })\n   *\n   * // src/worker-handlers.ts\n   * export async function queue(batch, env) { ... }\n   * export async function scheduled(controller, env, ctx) { ... }\n   * ```\n   */\n  workerHandlers?: string;\n}\n\n/**\n * Create a Cloudflare Workers adapter.\n *\n * @example\n * ```ts\n * import { cloudflare } from '@timber-js/app/adapters/cloudflare'\n *\n * export default {\n *   output: 'server',\n *   adapter: cloudflare(),\n * }\n * ```\n */\nexport function cloudflare(options: CloudflareAdapterOptions = {}): TimberPlatformAdapter {\n  return {\n    name: 'cloudflare',\n\n    async buildOutput(config: TimberConfig, buildDir: string) {\n      const outDir = join(buildDir, 'cloudflare');\n      await mkdir(outDir, { recursive: true });\n\n      // Copy client assets to static output.\n      // When client JavaScript is disabled, skip .js files — only CSS,\n      // fonts, images, and other static assets are needed.\n      const clientDir = join(buildDir, 'client');\n      const staticDir = join(outDir, 'static');\n      await mkdir(staticDir, { recursive: true });\n      await cp(clientDir, staticDir, {\n        recursive: true,\n        filter: config.clientJavascriptDisabled ? (src: string) => !src.endsWith('.js') : undefined,\n      }).catch(() => {\n        // Client dir may not exist when client JavaScript is disabled\n      });\n\n      // Write _headers file for static asset cache control.\n      // Cloudflare Workers Static Assets reads this to set Cache-Control\n      // headers on responses. Hashed assets get immutable; others get 1h.\n      await writeFile(join(staticDir, '_headers'), generateHeadersFile());\n\n      // Copy server bundles (rsc + ssr) into the output directory.\n      // These are already fully bundled by Vite with resolve.noExternal: true.\n      const rscDir = join(buildDir, 'rsc');\n      const ssrDir = join(buildDir, 'ssr');\n      await cp(rscDir, join(outDir, 'rsc'), { recursive: true });\n      await cp(ssrDir, join(outDir, 'ssr'), { recursive: true });\n\n      // Write the build manifest init module (if manifest data was produced).\n      // This must be imported before the RSC handler so the global is set\n      // when virtual:timber-build-manifest evaluates.\n      if (config.manifestInit) {\n        await writeFile(join(outDir, '_timber-manifest-init.js'), config.manifestInit);\n      }\n\n      // Compile optional worker handlers (queue, scheduled, etc.)\n      // Uses Vite's build API to bundle the TypeScript source into ESM.\n      let hasWorkerHandlers = false;\n      if (options.workerHandlers) {\n        const handlersEntry = join(process.cwd(), options.workerHandlers);\n        const { build: viteBuild } = await import('vite');\n        await viteBuild({\n          configFile: false,\n          logLevel: 'info',\n          build: {\n            lib: {\n              entry: handlersEntry,\n              formats: ['es'],\n              fileName: () => '_worker-handlers.js',\n            },\n            outDir,\n            emptyOutDir: false,\n            minify: false,\n            rollupOptions: {\n              external: [/^node:/],\n            },\n          },\n        });\n        hasWorkerHandlers = true;\n      }\n\n      // Generate the Workers entry point\n      const hasManifestInit = !!config.manifestInit;\n      const workerEntry = generateWorkerEntry(outDir, outDir, hasManifestInit, hasWorkerHandlers);\n      await writeFile(join(outDir, '_worker.js'), workerEntry);\n\n      // Generate wrangler.jsonc\n      const wranglerConfig = generateWranglerConfig(config, options);\n      await writeFile(join(outDir, 'wrangler.jsonc'), JSON.stringify(wranglerConfig, null, 2));\n    },\n\n    async preview(_config: TimberConfig, buildDir: string) {\n      const cmd = generatePreviewCommand(buildDir);\n      await spawnPreviewProcess(cmd.command, cmd.args, cmd.cwd);\n    },\n\n    // Default no-op. wrapWithExecutionContext() replaces this per-request\n    // with a function that routes to ctx.waitUntil().\n    waitUntil(_promise: Promise<unknown>) {},\n  };\n}\n\n/**\n * Wrap a timber request handler to bind the Cloudflare execution context\n * for `waitUntil()` support and env bindings passthrough.\n * Called from the generated worker entry.\n *\n * This function:\n * 1. Binds `adapter.waitUntil()` to `ctx.waitUntil()` per-request\n * 2. Makes `env` accessible via `getCloudflareBindings()` per-request via ALS\n */\nexport function wrapWithExecutionContext(\n  adapter: TimberPlatformAdapter,\n  handler: (req: Request) => Promise<Response>\n): CfExportedHandler<Record<string, unknown>> {\n  return {\n    async fetch(\n      request: Request,\n      env: Record<string, unknown>,\n      ctx: CfExecutionContext\n    ): Promise<Response> {\n      // Bind the adapter's waitUntil to the Workers execution context\n      const originalWaitUntil = adapter.waitUntil;\n      adapter.waitUntil = (promise: Promise<unknown>) => {\n        ctx.waitUntil(promise);\n      };\n\n      try {\n        // Run the handler within ALS so getCloudflareBindings() works\n        return await runWithBindings(env, () => handler(request));\n      } finally {\n        // Restore (in case adapter is reused across isolate resets)\n        adapter.waitUntil = originalWaitUntil;\n      }\n    },\n  };\n}\n\n// ─── Exported helpers (used by tests and build) ─────────────────────────────\n\n/** @internal Exported for testing. */\nexport function generateWorkerEntry(\n  buildDir: string,\n  outDir: string,\n  hasManifestInit = false,\n  hasWorkerHandlers = false\n): string {\n  // The RSC entry is the main request handler — it exports the fetch handler as default.\n  // The Vite RSC plugin outputs it to rsc/index.js.\n  let rscEntryRelative = relative(outDir, join(buildDir, 'rsc', 'index.js'));\n  // Ensure the import path starts with ./ for ESM compatibility\n  if (!rscEntryRelative.startsWith('.')) {\n    rscEntryRelative = './' + rscEntryRelative;\n  }\n\n  // Build manifest init must be imported before the RSC handler so that\n  // globalThis.__TIMBER_BUILD_MANIFEST__ is set when the virtual module evaluates.\n  // ESM guarantees imports are evaluated in order.\n  const manifestImport = hasManifestInit ? \"import './_timber-manifest-init.js'\\n\" : '';\n\n  // Optional additional Worker handlers (queue, scheduled, email, etc.)\n  // Compiled by buildOutput via Vite's build API into _worker-handlers.js.\n  // The module's named exports are spread into the default export alongside fetch.\n  const handlersImport = hasWorkerHandlers\n    ? \"import * as workerHandlers from './_worker-handlers.js'\\n\"\n    : '';\n  const handlersSpread = hasWorkerHandlers ? '  ...workerHandlers,\\n' : '';\n\n  return `// Generated by @timber-js/app/adapters/cloudflare\n// Do not edit — this file is regenerated on each build.\n\nimport { AsyncLocalStorage } from 'node:async_hooks'\n${manifestImport}import handler from '${rscEntryRelative}'\n${handlersImport}\n// Set TIMBER_RUNTIME for instrumentation.ts conditional SDK initialization.\n// See design/25-production-deployments.md §\"TIMBER_RUNTIME\".\nglobalThis.process ??= { env: {} }\nprocess.env.TIMBER_RUNTIME = 'cloudflare'\n\n// Bind Cloudflare env to ALS so getCloudflareBindings() works at runtime.\n// Uses the same Symbol.for key as getCloudflareBindings() reads from.\nconst ALS_KEY = Symbol.for('timber:cf-bindings-als')\nlet bindingsAls = globalThis[ALS_KEY]\nif (!bindingsAls) {\n  bindingsAls = new AsyncLocalStorage()\n  globalThis[ALS_KEY] = bindingsAls\n}\n\nexport default {\n${handlersSpread}  async fetch(request, env, ctx) {\n    return bindingsAls.run(env, () => handler(request))\n  }\n}\n`;\n}\n\n/** Wrangler binding sections generated from `CloudflareBindings`. */\nexport interface WranglerBindingsConfig {\n  kv_namespaces?: Array<{ binding: string; id: string }>;\n  d1_databases?: Array<{ binding: string; database_id: string }>;\n  r2_buckets?: Array<{ binding: string; bucket_name: string }>;\n  queues?: {\n    producers?: Array<{ binding: string; queue: string }>;\n    consumers?: Array<Record<string, unknown>>;\n  };\n  durable_objects?: {\n    bindings: Array<Record<string, string>>;\n  };\n}\n\n/**\n * Convert declarative `CloudflareBindings` into wrangler.jsonc binding sections.\n *\n * Maps:\n * - `kv`             → `kv_namespaces`\n * - `d1`             → `d1_databases`\n * - `r2`             → `r2_buckets`\n * - `queues`         → `queues` (producers + consumers)\n * - `durableObjects` → `durable_objects`\n *\n * Empty arrays are omitted from the output.\n *\n * @internal Exported for testing.\n */\nexport function generateBindingsConfig(\n  bindings: CloudflareBindings | undefined\n): WranglerBindingsConfig {\n  if (!bindings) return {};\n\n  const result: WranglerBindingsConfig = {};\n\n  // KV namespaces\n  if (bindings.kv && bindings.kv.length > 0) {\n    result.kv_namespaces = bindings.kv.map((kv) => ({\n      binding: kv.name,\n      id: kv.id ?? '',\n    }));\n  }\n\n  // D1 databases\n  if (bindings.d1 && bindings.d1.length > 0) {\n    result.d1_databases = bindings.d1.map((d1) => ({\n      binding: d1.name,\n      database_id: d1.database_id,\n    }));\n  }\n\n  // R2 buckets\n  if (bindings.r2 && bindings.r2.length > 0) {\n    result.r2_buckets = bindings.r2.map((r2) => ({\n      binding: r2.name,\n      bucket_name: r2.bucket_name,\n    }));\n  }\n\n  // Queues (producers and/or consumers)\n  if (bindings.queues) {\n    const queues: Record<string, unknown> = {};\n    if (bindings.queues.producers && bindings.queues.producers.length > 0) {\n      queues.producers = bindings.queues.producers.map((p) => ({\n        binding: p.name,\n        queue: p.queue,\n      }));\n    }\n    if (bindings.queues.consumers && bindings.queues.consumers.length > 0) {\n      queues.consumers = bindings.queues.consumers.map((c) => {\n        const consumer: Record<string, unknown> = { queue: c.queue };\n        if (c.max_batch_size !== undefined) consumer.max_batch_size = c.max_batch_size;\n        if (c.max_retries !== undefined) consumer.max_retries = c.max_retries;\n        if (c.dead_letter_queue !== undefined) consumer.dead_letter_queue = c.dead_letter_queue;\n        return consumer;\n      });\n    }\n    if (Object.keys(queues).length > 0) {\n      result.queues = queues;\n    }\n  }\n\n  // Durable Objects\n  if (bindings.durableObjects && bindings.durableObjects.length > 0) {\n    result.durable_objects = {\n      bindings: bindings.durableObjects.map((dobj) => {\n        const entry: Record<string, string> = {\n          name: dobj.name,\n          class_name: dobj.class_name,\n        };\n        if (dobj.script_name) entry.script_name = dobj.script_name;\n        return entry;\n      }),\n    };\n  }\n\n  return result;\n}\n\n/**\n * One-level deep merge: for each key in `override`, if both the base and\n * override values are plain objects (not arrays, not null), merge their\n * keys with override winning on conflicts. Everything else (primitives,\n * arrays, null) is replaced outright — matching the intuitive behavior\n * where `kv_namespaces: [...]` replaces fully but\n * `durable_objects: { migrations }` merges with generated `bindings`.\n */\nfunction shallowDeepMerge(\n  base: Record<string, unknown>,\n  override: Record<string, unknown>\n): Record<string, unknown> {\n  const result = { ...base };\n  for (const key of Object.keys(override)) {\n    const baseVal = result[key];\n    const overVal = override[key];\n    if (isPlainObject(baseVal) && isPlainObject(overVal)) {\n      result[key] = { ...baseVal, ...overVal };\n    } else {\n      result[key] = overVal;\n    }\n  }\n  return result;\n}\n\n/** True for `{}` literals — false for arrays, null, Date, etc. */\nfunction isPlainObject(val: unknown): val is Record<string, unknown> {\n  return val !== null && typeof val === 'object' && !Array.isArray(val);\n}\n\n/** @internal Exported for testing. */\nexport function generateWranglerConfig(\n  config: TimberConfig,\n  options: CloudflareAdapterOptions\n): Record<string, unknown> {\n  const compatDate = options.compatibilityDate ?? new Date().toISOString().slice(0, 10);\n\n  const flags = options.compatibilityFlags ?? ['nodejs_compat'];\n\n  const base: Record<string, unknown> = {\n    name: 'timber-app',\n    main: '_worker.js',\n    compatibility_date: compatDate,\n    compatibility_flags: flags,\n    // The build output is already fully bundled by Vite — skip wrangler's\n    // esbuild pass to avoid issues with top-level await and module format.\n    no_bundle: true,\n    find_additional_modules: true,\n    rules: [{ type: 'ESModule', globs: ['**/*.js'] }],\n    assets: {\n      directory: './static',\n    },\n  };\n\n  // Layer 1: merge bindings-generated sections into base\n  const bindingsConfig = generateBindingsConfig(options.bindings);\n  const merged = { ...base, ...bindingsConfig };\n\n  // Layer 2: wrangler escape hatch with deep merge for nested plain objects.\n  // A shallow spread would replace entire sections like durable_objects and\n  // queues — e.g. adding migrations via wrangler would drop the generated\n  // durable_objects.bindings. Deep merge preserves generated keys while\n  // letting wrangler override on actual key-level conflicts.\n  if (options.wrangler) {\n    return shallowDeepMerge(merged, options.wrangler);\n  }\n\n  return merged;\n}\n\n// ─── Preview ─────────────────────────────────────────────────────────────────\n\n/** Command descriptor for preview — testable without spawning a process. */\nexport interface PreviewCommand {\n  command: string;\n  args: string[];\n  cwd: string;\n}\n\n/** @internal Exported for testing. */\nexport function generatePreviewCommand(buildDir: string): PreviewCommand {\n  const cfDir = join(buildDir, 'cloudflare');\n  return {\n    command: 'wrangler',\n    args: ['dev', '--local', '--config', join(cfDir, 'wrangler.jsonc')],\n    cwd: cfDir,\n  };\n}\n\n/**\n * Spawn a long-running preview process and pipe stdio to the parent.\n * Resolves when the process exits.\n */\nfunction spawnPreviewProcess(command: string, args: string[], cwd: string): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    const child = execFile(command, args, { cwd }, (err) => {\n      if (err) reject(err);\n      else resolve();\n    });\n    child.stdout?.pipe(process.stdout);\n    child.stderr?.pipe(process.stderr);\n  });\n}\n\n// ─── Cloudflare Workers type stubs ───────────────────────────────────────────\n// Local type declarations so this file compiles without @cloudflare/workers-types.\n// These are NOT declared globally — that would clash with @cloudflare/workers-types\n// when users install it. Instead, they're module-scoped and used only within\n// this file's function signatures.\n\n/** @internal Minimal stub — use @cloudflare/workers-types for full types. */\nexport interface CfExecutionContext {\n  waitUntil(promise: Promise<unknown>): void;\n  passThroughOnException(): void;\n}\n\n/** @internal Minimal stub — use @cloudflare/workers-types for full types. */\nexport interface CfExportedHandler<Env = Record<string, unknown>> {\n  fetch?(request: Request, env: Env, ctx: CfExecutionContext): Promise<Response> | Response;\n}\n"],"mappings":"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"}

package/dist/adapters/compress-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compress-module.d.ts","sourceRoot":"","sources":["../../src/adapters/compress-module.ts"],"names":[],"mappings":"AAaA;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CA+E/C"}
+{"version":3,"file":"compress-module.d.ts","sourceRoot":"","sources":["../../src/adapters/compress-module.ts"],"names":[],"mappings":"AAaA;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAmG/C"}

package/dist/adapters/nitro.d.ts

@@ -28,6 +28,22 @@ export interface NitroAdapterOptions {
      * @default 'node-server'
      */
     preset?: NitroPreset;
+    /**
+     * Enable application-level gzip compression for HTML and RSC responses.
+     *
+     * When `true` (default), the origin compresses responses using the Web
+     * `CompressionStream` API. This is useful for self-hosted deployments
+     * where no reverse proxy or CDN handles compression.
+     *
+     * Set to `false` when deploying behind a reverse proxy (nginx, caddy)
+     * or CDN (Cloudflare, Fastly, Vercel) that compresses at the edge.
+     * Disabling origin compression saves CPU on the Node.js event loop —
+     * compressing 1MB+ streaming HTML responses takes 10-15ms of main
+     * thread time per request, directly reducing throughput under load.
+     *
+     * @default true
+     */
+    compress?: boolean;
     /**
      * Additional Nitro configuration to merge into the generated config.
      * Overrides default values for the selected preset.
@@ -52,7 +68,7 @@ export interface NitroAdapterOptions {
  */
 export declare function nitro(options?: NitroAdapterOptions): TimberPlatformAdapter;
 /** @internal Exported for testing. */
-export declare function generateNitroEntry(buildDir: string, outDir: string, preset: NitroPreset, hasManifestInit?: boolean): string;
+export declare function generateNitroEntry(buildDir: string, outDir: string, preset: NitroPreset, compress?: boolean, hasManifestInit?: boolean): string;
 /** @internal Exported for testing. */
 export declare function generateNitroConfig(preset: NitroPreset, userConfig?: Record<string, unknown>): string;
 /**

package/dist/adapters/nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nitro.d.ts","sourceRoot":"","sources":["../../src/adapters/nitro.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,qBAAqB,EAAgB,MAAM,SAAS,CAAC;AAsBnE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,aAAa,GACb,SAAS,GACT,cAAc,GACd,YAAY,GACZ,aAAa,GACb,iBAAiB,GACjB,aAAa,GACb,KAAK,CAAC;AAEV,2CAA2C;AAC3C,UAAU,YAAY;IACpB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sEAAsE;IACtE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAgFD,qCAAqC;AACrC,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,mBAAwB,GAAG,qBAAqB,CA0F9E;AAID,sCAAsC;AACtC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,eAAe,UAAQ,GACtB,MAAM,CAsFR;AAED,sCAAsC;AACtC,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,CAyBR;AAOD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAsKnF;AAED,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,sCAAsC;AACtC,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAClB,mBAAmB,GAAG,IAAI,CAY5B;AAyDD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAEjE"}
+{"version":3,"file":"nitro.d.ts","sourceRoot":"","sources":["../../src/adapters/nitro.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,qBAAqB,EAAgB,MAAM,SAAS,CAAC;AAsBnE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,aAAa,GACb,SAAS,GACT,cAAc,GACd,YAAY,GACZ,aAAa,GACb,iBAAiB,GACjB,aAAa,GACb,KAAK,CAAC;AAEV,2CAA2C;AAC3C,UAAU,YAAY;IACpB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sEAAsE;IACtE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAgFD,qCAAqC;AACrC,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,mBAAwB,GAAG,qBAAqB,CA2F9E;AAID,sCAAsC;AACtC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,QAAQ,UAAO,EACf,eAAe,UAAQ,GACtB,MAAM,CAwFR;AAED,sCAAsC;AACtC,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,CAyBR;AAOD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CA6LnF;AAED,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,sCAAsC;AACtC,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAClB,mBAAmB,GAAG,IAAI,CAY5B;AA8DD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAEjE"}