@timber-js/app 0.2.0-alpha.158 → 0.2.0-alpha.159

package/dist/adapters/cloudflare.js

@@ -1,6 +1,6 @@
-import { t as runSharedBuildSteps } from "../_chunks/build-output-helper-C8q4Zpf5.js";
+import { t as runSharedBuildSteps } from "../_chunks/build-output-helper-DF5uScqS.js";
 import { join, relative } from "node:path";
-import { writeFile } from "node:fs/promises";
+import { readFile, readdir, rm, writeFile } from "node:fs/promises";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { execFile } from "node:child_process";
 //#region src/adapters/cloudflare.ts
@@ -64,6 +64,14 @@ function cloudflare(options = {}) {
 		name: "cloudflare",
 		async buildOutput(config, buildDir) {
 			const outDir = join(buildDir, "cloudflare");
+			await rm(join(outDir, "prebuilt"), {
+				recursive: true,
+				force: true
+			}).catch(() => {});
+			await rm(join(outDir, "static", "prebuilt"), {
+				recursive: true,
+				force: true
+			}).catch(() => {});
 			await runSharedBuildSteps({
 				config,
 				buildDir,
@@ -86,11 +94,13 @@ function cloudflare(options = {}) {
 						outDir,
 						emptyOutDir: false,
 						minify: false,
-						rollupOptions: { external: [/^node:/] }
+						rollupOptions: { external: [/^node:/, /^cloudflare:/] }
 					}
 				});
 				hasWorkerHandlers = true;
 			}
+			const prebuiltData = await readPrebuiltData(buildDir);
+			await writeFile(join(outDir, "_timber-prebuilt-source.js"), generatePrebuiltSourceModule(prebuiltData));
 			const workerEntry = generateWorkerEntry(outDir, outDir, !!config.manifestInit, hasWorkerHandlers);
 			await writeFile(join(outDir, "_worker.js"), workerEntry);
 			const wranglerConfig = generateWranglerConfig(config, options);
@@ -110,6 +120,10 @@ function generateWorkerEntry(buildDir, outDir, hasManifestInit = false, hasWorke
 // Do not edit — this file is regenerated on each build.
 
 import { AsyncLocalStorage } from 'node:async_hooks'
+// Side-effect import: sets globalThis.__TIMBER_PREBUILT_SOURCE__ before the
+// RSC handler evaluates. Must be a static import (not body code) so ESM
+// evaluation order guarantees it runs before ./rsc/index.js.
+import './_timber-prebuilt-source.js'
 ${hasManifestInit ? "import './_timber-manifest-init.js'\n" : ""}import handler, { runWithWaitUntil } from '${rscEntryRelative}'
 ${hasWorkerHandlers ? "import * as workerHandlers from './_worker-handlers.js'\n" : ""}
 // Set TIMBER_RUNTIME for instrumentation.ts conditional SDK initialization.
@@ -126,8 +140,35 @@ if (!bindingsAls) {
   globalThis[ALS_KEY] = bindingsAls
 }
 
+// Register timber's platform tracer so pipeline phase spans (timber.proxy,
+// timber.middleware, timber.render, timber.access, timber.action, …) appear
+// as native Cloudflare spans in the Observability dashboard, nested under
+// the auto-instrumented fetch/KV/D1 spans. Requires observability.traces
+// enabled in wrangler.jsonc (generated by default).
+//
+// Lazily imported and guarded: runtimes without the custom spans API
+// (older compatibility dates, older local workerd) fall back to OTEL-only
+// emission. withSpan() in the framework composes both channels.
+const TRACER_KEY = Symbol.for('timber:platform-tracer')
+let tracerInit
+function initPlatformTracer() {
+  tracerInit ??= import('cloudflare:workers')
+    .then(({ tracing }) => {
+      if (tracing && typeof tracing.enterSpan === 'function') {
+        globalThis[TRACER_KEY] ??= {
+          enterSpan: (name, fn) => tracing.enterSpan(name, fn),
+        }
+      }
+    })
+    .catch(() => {})
+  return tracerInit
+}
+
 export default {
 ${hasWorkerHandlers ? "  ...workerHandlers,\n" : ""}  async fetch(request, env, ctx) {
+    // One-time on first request; resolved-promise await thereafter.
+    await initPlatformTracer()
+
     // Edge-cache GET/HEAD responses via the Cache API. RSC navigation
     // requests (Accept: text/x-component) are excluded — they vary by
     // X-Timber-State-Tree which the cache key doesn't capture.
@@ -169,6 +210,79 @@ ${hasWorkerHandlers ? "  ...workerHandlers,\n" : ""}  async fetch(request, env,
 `;
 }
 /**
+* Discover prebuilt flight payload files from the build directory.
+* Returns null when no prebuilt artifacts exist (no cache.component usage).
+*
+* @internal Exported for testing.
+*/
+async function readPrebuiltData(buildDir) {
+	const prebuiltDir = join(buildDir, "prebuilt");
+	try {
+		await readFile(join(prebuiltDir, "manifest.json"));
+	} catch {
+		return null;
+	}
+	const payloadFiles = [];
+	try {
+		const componentDirs = await readdir(prebuiltDir, { withFileTypes: true });
+		for (const dir of componentDirs) {
+			if (!dir.isDirectory()) continue;
+			const files = await readdir(join(prebuiltDir, dir.name));
+			for (const file of files) if (file.endsWith(".flight")) payloadFiles.push(`${dir.name}/${file}`);
+		}
+	} catch {}
+	return { payloadFiles };
+}
+/**
+* Generate the prebuilt payload source module for Cloudflare Workers.
+*
+* Imports prebuilt flight payloads as native wrangler Data/Text modules
+* from the worker's module graph (NOT from static assets — TIM-1162).
+* Files live at `outDir/prebuilt/` which is outside `static/` and thus
+* not publicly fetchable. Wrangler discovers them via
+* `find_additional_modules: true` with Data/Text rules.
+*
+* This is a separate ESM module so it evaluates before the RSC handler —
+* static imports are hoisted, guaranteeing `globalThis.__TIMBER_PREBUILT_SOURCE__`
+* is set before `createRequestHandler()` reads it.
+*
+* @internal Exported for testing.
+*/
+function generatePrebuiltSourceModule(data) {
+	if (!data) return `// Generated by @timber-js/app/adapters/cloudflare
+// No prebuilt artifacts — all cache.component wrappers render dynamically.
+globalThis.__TIMBER_PREBUILT_SOURCE__ = {
+  async loadManifest() { return null },
+  async readPayload() { return null },
+}
+`;
+	const imports = [];
+	const entries = [];
+	imports.push(`import _manifestText from './prebuilt/manifest.json'`);
+	for (let i = 0; i < data.payloadFiles.length; i++) {
+		const file = data.payloadFiles[i];
+		imports.push(`import _p${i} from './prebuilt/${file}'`);
+		entries.push(`  ${JSON.stringify(file)}: new Uint8Array(_p${i})`);
+	}
+	return `// Generated by @timber-js/app/adapters/cloudflare
+// Prebuilt payload source — imports cache.component flight payloads as
+// native wrangler modules from the worker bundle (TIM-1162). Files live
+// at outDir/prebuilt/, outside static/, so they are not publicly fetchable.
+${imports.join("\n")}
+
+const _manifest = JSON.parse(_manifestText)
+
+const _payloads = {
+${entries.join(",\n")}
+}
+
+globalThis.__TIMBER_PREBUILT_SOURCE__ = {
+  async loadManifest() { return _manifest },
+  async readPayload(file) { return _payloads[file] ?? null },
+}
+`;
+}
+/**
 * Convert declarative `CloudflareBindings` into wrangler.jsonc binding sections.
 *
 * Maps:
@@ -249,25 +363,45 @@ function isPlainObject(val) {
 }
 /** @internal Exported for testing. */
 function generateWranglerConfig(config, options) {
+	const compatDate = options.compatibilityDate ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+	const flags = options.compatibilityFlags ?? ["nodejs_compat"];
+	const PREBUILT_MODULE_RULES = [{
+		type: "Text",
+		globs: ["prebuilt/**/*.json"]
+	}, {
+		type: "Data",
+		globs: ["prebuilt/**/*.flight"]
+	}];
 	const base = {
 		name: "timber-app",
 		main: "_worker.js",
-		compatibility_date: options.compatibilityDate ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
-		compatibility_flags: options.compatibilityFlags ?? ["nodejs_compat"],
+		compatibility_date: compatDate,
+		compatibility_flags: flags,
 		no_bundle: true,
 		find_additional_modules: true,
 		rules: [{
 			type: "ESModule",
 			globs: ["**/*.js"]
-		}],
-		assets: { directory: "./static" }
+		}, ...PREBUILT_MODULE_RULES],
+		assets: {
+			directory: "./static",
+			binding: "ASSETS"
+		},
+		observability: { traces: { enabled: true } }
 	};
 	const bindingsConfig = generateBindingsConfig(options.bindings);
 	const merged = {
 		...base,
 		...bindingsConfig
 	};
-	if (options.wrangler) return shallowDeepMerge(merged, options.wrangler);
+	if (options.wrangler) {
+		const result = shallowDeepMerge(merged, options.wrangler);
+		if (options.wrangler.rules) {
+			const userRules = result.rules;
+			for (const required of PREBUILT_MODULE_RULES) if (!userRules.some((r) => r.type === required.type && JSON.stringify(r.globs) === JSON.stringify(required.globs))) userRules.push(required);
+		}
+		return result;
+	}
 	return merged;
 }
 /** @internal Exported for testing. */
@@ -299,6 +433,6 @@ function spawnPreviewProcess(command, args, cwd) {
 	});
 }
 //#endregion
-export { cloudflare, generateBindingsConfig, generatePreviewCommand, generateWorkerEntry, generateWranglerConfig, getCloudflareBindings, runWithBindings };
+export { cloudflare, generateBindingsConfig, generatePrebuiltSourceModule, generatePreviewCommand, generateWorkerEntry, generateWranglerConfig, getCloudflareBindings, readPrebuiltData, runWithBindings };
 
 //# 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 } 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';\nimport { runSharedBuildSteps } from './build-output-helper.js';\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 cloudflareDevBindings() to wrap dev-server requests.\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\n      // Steps 1–5: shared across all adapters (mkdir, copy client/rsc/ssr,\n      // write _headers, write manifest-init).\n      await runSharedBuildSteps({\n        config,\n        buildDir,\n        outDir,\n        publicDirName: 'static',\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    // No adapter-level waitUntil: on Workers there is no ambient\n    // ExecutionContext outside a request, so support is provided\n    // per-request by the generated _worker.js, which bridges\n    // ctx.waitUntil() into the ALS via runWithWaitUntil().\n    // See design/11-platform.md §\"waitUntil()\".\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, { runWithWaitUntil } 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    // Edge-cache GET/HEAD responses via the Cache API. RSC navigation\n    // requests (Accept: text/x-component) are excluded — they vary by\n    // X-Timber-State-Tree which the cache key doesn't capture.\n    const isRsc = request.headers.get('Accept')?.includes('text/x-component')\n    const reqCc = request.headers.get('Cache-Control') || ''\n    const bypassCache = reqCc.includes('no-cache') || reqCc.includes('max-age=0')\n        || request.headers.has('Pragma')\n    const cacheable = !isRsc && !bypassCache\n        && (request.method === 'GET' || request.method === 'HEAD')\n    const cache = cacheable && typeof caches !== 'undefined' ? caches.default : null\n    if (cache) {\n      const cached = await cache.match(request)\n      if (cached) return cached\n    }\n\n    const response = await bindingsAls.run(env, () =>\n      runWithWaitUntil((promise) => ctx.waitUntil(promise), () => handler(request))\n    )\n\n    // Cache public responses at the edge. A response is edge-cacheable if\n    // it has 'public' or 's-maxage' (a shared-cache TTL directive) and no\n    // 'no-store' or 'private'. Cloudflare's cache.put() only accepts GET\n    // requests and rejects 206, so only store GET 200s. HEAD requests\n    // benefit from cache.match() which handles HEAD→GET matching automatically.\n    // See design/25-production-deployments.md §\"CDN / Edge Cache\".\n    if (cache && request.method === 'GET' && response.status === 200) {\n      const cc = response.headers.get('Cache-Control')\n      const vary = response.headers.get('Vary')\n      if (cc && !cc.includes('no-store') && !cc.includes('private')\n          && (cc.includes('public') || cc.includes('s-maxage'))\n          && vary !== '*' && !response.headers.has('Set-Cookie')) {\n        ctx.waitUntil(cache.put(request, response.clone()))\n      }\n    }\n\n    return response\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"],"mappings":";;;;;;AA0BA,IAAM,mBAAmB,OAAO,IAAI,wBAAwB;AAE5D,SAAS,iBAA6D;CACpE,IAAI,MAAO,WAAmB;CAG9B,IAAI,CAAC,KAAK;EACR,MAAM,IAAI,kBAA2C;EACrD,WAAoB,oBAAoB;CAC1C;CACA,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,wBAAwD;CACtE,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS;CACtC,IAAI,CAAC,KACH,MAAM,IAAI,MACR,kMAGF;CAEF,OAAO;AACT;;;;;AAMA,SAAgB,gBAAmB,KAA8B,IAAgB;CAC/E,OAAO,eAAe,CAAC,CAAC,IAAI,KAAK,EAAE;AACrC;;;;;;;;;;;;;;AAiJA,SAAgB,WAAW,UAAoC,CAAC,GAA0B;CACxF,OAAO;EACL,MAAM;EAEN,MAAM,YAAY,QAAsB,UAAkB;GACxD,MAAM,SAAS,KAAK,UAAU,YAAY;GAI1C,MAAM,oBAAoB;IACxB;IACA;IACA;IACA,eAAe;GACjB,CAAC;GAID,IAAI,oBAAoB;GACxB,IAAI,QAAQ,gBAAgB;IAC1B,MAAM,gBAAgB,KAAK,QAAQ,IAAI,GAAG,QAAQ,cAAc;IAChE,MAAM,EAAE,OAAO,cAAc,MAAM,OAAO;IAC1C,MAAM,UAAU;KACd,YAAY;KACZ,UAAU;KACV,OAAO;MACL,KAAK;OACH,OAAO;OACP,SAAS,CAAC,IAAI;OACd,gBAAgB;MAClB;MACA;MACA,aAAa;MACb,QAAQ;MACR,eAAe,EACb,UAAU,CAAC,QAAQ,EACrB;KACF;IACF,CAAC;IACD,oBAAoB;GACtB;GAIA,MAAM,cAAc,oBAAoB,QAAQ,QAAQ,CAD/B,CAAC,OAAO,cACwC,iBAAiB;GAC1F,MAAM,UAAU,KAAK,QAAQ,YAAY,GAAG,WAAW;GAGvD,MAAM,iBAAiB,uBAAuB,QAAQ,OAAO;GAC7D,MAAM,UAAU,KAAK,QAAQ,gBAAgB,GAAG,KAAK,UAAU,gBAAgB,MAAM,CAAC,CAAC;EACzF;EAEA,MAAM,QAAQ,SAAuB,UAAkB;GACrD,MAAM,MAAM,uBAAuB,QAAQ;GAC3C,MAAM,oBAAoB,IAAI,SAAS,IAAI,MAAM,IAAI,GAAG;EAC1D;CAOF;AACF;;AAKA,SAAgB,oBACd,UACA,QACA,kBAAkB,OAClB,oBAAoB,OACZ;CAGR,IAAI,mBAAmB,SAAS,QAAQ,KAAK,UAAU,OAAO,UAAU,CAAC;CAEzE,IAAI,CAAC,iBAAiB,WAAW,GAAG,GAClC,mBAAmB,OAAO;CAgB5B,OAAO;;;;EAVgB,kBAAkB,0CAA0C,GAcpE,6CAA6C,iBAAiB;EATtD,oBACnB,8DACA,GAQW;;;;;;;;;;;;;;;;EAPQ,oBAAoB,2BAA2B,GAuBvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCjB;;;;;;;;;;;;;;;AA8BA,SAAgB,uBACd,UACwB;CACxB,IAAI,CAAC,UAAU,OAAO,CAAC;CAEvB,MAAM,SAAiC,CAAC;CAGxC,IAAI,SAAS,MAAM,SAAS,GAAG,SAAS,GACtC,OAAO,gBAAgB,SAAS,GAAG,KAAK,QAAQ;EAC9C,SAAS,GAAG;EACZ,IAAI,GAAG,MAAM;CACf,EAAE;CAIJ,IAAI,SAAS,MAAM,SAAS,GAAG,SAAS,GACtC,OAAO,eAAe,SAAS,GAAG,KAAK,QAAQ;EAC7C,SAAS,GAAG;EACZ,aAAa,GAAG;CAClB,EAAE;CAIJ,IAAI,SAAS,MAAM,SAAS,GAAG,SAAS,GACtC,OAAO,aAAa,SAAS,GAAG,KAAK,QAAQ;EAC3C,SAAS,GAAG;EACZ,aAAa,GAAG;CAClB,EAAE;CAIJ,IAAI,SAAS,QAAQ;EACnB,MAAM,SAAkC,CAAC;EACzC,IAAI,SAAS,OAAO,aAAa,SAAS,OAAO,UAAU,SAAS,GAClE,OAAO,YAAY,SAAS,OAAO,UAAU,KAAK,OAAO;GACvD,SAAS,EAAE;GACX,OAAO,EAAE;EACX,EAAE;EAEJ,IAAI,SAAS,OAAO,aAAa,SAAS,OAAO,UAAU,SAAS,GAClE,OAAO,YAAY,SAAS,OAAO,UAAU,KAAK,MAAM;GACtD,MAAM,WAAoC,EAAE,OAAO,EAAE,MAAM;GAC3D,IAAI,EAAE,mBAAmB,KAAA,GAAW,SAAS,iBAAiB,EAAE;GAChE,IAAI,EAAE,gBAAgB,KAAA,GAAW,SAAS,cAAc,EAAE;GAC1D,IAAI,EAAE,sBAAsB,KAAA,GAAW,SAAS,oBAAoB,EAAE;GACtE,OAAO;EACT,CAAC;EAEH,IAAI,OAAO,KAAK,MAAM,CAAC,CAAC,SAAS,GAC/B,OAAO,SAAS;CAEpB;CAGA,IAAI,SAAS,kBAAkB,SAAS,eAAe,SAAS,GAC9D,OAAO,kBAAkB,EACvB,UAAU,SAAS,eAAe,KAAK,SAAS;EAC9C,MAAM,QAAgC;GACpC,MAAM,KAAK;GACX,YAAY,KAAK;EACnB;EACA,IAAI,KAAK,aAAa,MAAM,cAAc,KAAK;EAC/C,OAAO;CACT,CAAC,EACH;CAGF,OAAO;AACT;;;;;;;;;AAUA,SAAS,iBACP,MACA,UACyB;CACzB,MAAM,SAAS,EAAE,GAAG,KAAK;CACzB,KAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,GAAG;EACvC,MAAM,UAAU,OAAO;EACvB,MAAM,UAAU,SAAS;EACzB,IAAI,cAAc,OAAO,KAAK,cAAc,OAAO,GACjD,OAAO,OAAO;GAAE,GAAG;GAAS,GAAG;EAAQ;OAEvC,OAAO,OAAO;CAElB;CACA,OAAO;AACT;;AAGA,SAAS,cAAc,KAA8C;CACnE,OAAO,QAAQ,QAAQ,OAAO,QAAQ,YAAY,CAAC,MAAM,QAAQ,GAAG;AACtE;;AAGA,SAAgB,uBACd,QACA,SACyB;CAKzB,MAAM,OAAgC;EACpC,MAAM;EACN,MAAM;EACN,oBAPiB,QAAQ,sCAAqB,IAAI,KAAK,EAAA,CAAE,YAAY,CAAC,CAAC,MAAM,GAAG,EAAE;EAQlF,qBANY,QAAQ,sBAAsB,CAAC,eAAe;EAS1D,WAAW;EACX,yBAAyB;EACzB,OAAO,CAAC;GAAE,MAAM;GAAY,OAAO,CAAC,SAAS;EAAE,CAAC;EAChD,QAAQ,EACN,WAAW,WACb;CACF;CAGA,MAAM,iBAAiB,uBAAuB,QAAQ,QAAQ;CAC9D,MAAM,SAAS;EAAE,GAAG;EAAM,GAAG;CAAe;CAO5C,IAAI,QAAQ,UACV,OAAO,iBAAiB,QAAQ,QAAQ,QAAQ;CAGlD,OAAO;AACT;;AAYA,SAAgB,uBAAuB,UAAkC;CACvE,MAAM,QAAQ,KAAK,UAAU,YAAY;CACzC,OAAO;EACL,SAAS;EACT,MAAM;GAAC;GAAO;GAAW;GAAY,KAAK,OAAO,gBAAgB;EAAC;EAClE,KAAK;CACP;AACF;;;;;AAMA,SAAS,oBAAoB,SAAiB,MAAgB,KAA4B;CACxF,OAAO,IAAI,SAAe,SAAS,WAAW;EAC5C,MAAM,QAAQ,SAAS,SAAS,MAAM,EAAE,IAAI,IAAI,QAAQ;GACtD,IAAI,KAAK,OAAO,GAAG;QACd,QAAQ;EACf,CAAC;EACD,MAAM,QAAQ,KAAK,QAAQ,MAAM;EACjC,MAAM,QAAQ,KAAK,QAAQ,MAAM;CACnC,CAAC;AACH"}
+{"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, readFile, cp, rm, readdir } 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';\nimport { runSharedBuildSteps } from './build-output-helper.js';\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 cloudflareDevBindings() to wrap dev-server requests.\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\n      // Clean stale prebuilt artifacts BEFORE the shared copy step.\n      // The shared step uses cp (merge, not replace), so old .flight files\n      // from removed/renamed components would persist and get picked up by\n      // find_additional_modules. Also clean static/prebuilt/ from pre-TIM-1162\n      // builds where prebuilt was copied into static assets.\n      await rm(join(outDir, 'prebuilt'), { recursive: true, force: true }).catch(() => {});\n      await rm(join(outDir, 'static', 'prebuilt'), { recursive: true, force: true }).catch(\n        () => {}\n      );\n\n      // Steps 1–5: shared across all adapters (mkdir, copy client/rsc/ssr,\n      // write _headers, write manifest-init).\n      await runSharedBuildSteps({\n        config,\n        buildDir,\n        outDir,\n        publicDirName: 'static',\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:/, /^cloudflare:/],\n            },\n          },\n        });\n        hasWorkerHandlers = true;\n      }\n\n      // Embed prebuilt flight payloads directly into the worker module\n      // (TIM-1162). Previously, prebuilt/ was copied into static assets and\n      // read via env.ASSETS.fetch() — but that made .flight files and\n      // manifest.json publicly fetchable, bypassing middleware and access\n      // gates. Now payloads are imported as native wrangler Data/Text modules\n      // from outDir/prebuilt/ (outside static/), keeping them server-side only.\n      const prebuiltData = await readPrebuiltData(buildDir);\n      await writeFile(\n        join(outDir, '_timber-prebuilt-source.js'),\n        generatePrebuiltSourceModule(prebuiltData)\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    // No adapter-level waitUntil: on Workers there is no ambient\n    // ExecutionContext outside a request, so support is provided\n    // per-request by the generated _worker.js, which bridges\n    // ctx.waitUntil() into the ALS via runWithWaitUntil().\n    // See design/11-platform.md §\"waitUntil()\".\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// Side-effect import: sets globalThis.__TIMBER_PREBUILT_SOURCE__ before the\n// RSC handler evaluates. Must be a static import (not body code) so ESM\n// evaluation order guarantees it runs before ./rsc/index.js.\nimport './_timber-prebuilt-source.js'\n${manifestImport}import handler, { runWithWaitUntil } 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\n// Register timber's platform tracer so pipeline phase spans (timber.proxy,\n// timber.middleware, timber.render, timber.access, timber.action, …) appear\n// as native Cloudflare spans in the Observability dashboard, nested under\n// the auto-instrumented fetch/KV/D1 spans. Requires observability.traces\n// enabled in wrangler.jsonc (generated by default).\n//\n// Lazily imported and guarded: runtimes without the custom spans API\n// (older compatibility dates, older local workerd) fall back to OTEL-only\n// emission. withSpan() in the framework composes both channels.\nconst TRACER_KEY = Symbol.for('timber:platform-tracer')\nlet tracerInit\nfunction initPlatformTracer() {\n  tracerInit ??= import('cloudflare:workers')\n    .then(({ tracing }) => {\n      if (tracing && typeof tracing.enterSpan === 'function') {\n        globalThis[TRACER_KEY] ??= {\n          enterSpan: (name, fn) => tracing.enterSpan(name, fn),\n        }\n      }\n    })\n    .catch(() => {})\n  return tracerInit\n}\n\nexport default {\n${handlersSpread}  async fetch(request, env, ctx) {\n    // One-time on first request; resolved-promise await thereafter.\n    await initPlatformTracer()\n\n    // Edge-cache GET/HEAD responses via the Cache API. RSC navigation\n    // requests (Accept: text/x-component) are excluded — they vary by\n    // X-Timber-State-Tree which the cache key doesn't capture.\n    const isRsc = request.headers.get('Accept')?.includes('text/x-component')\n    const reqCc = request.headers.get('Cache-Control') || ''\n    const bypassCache = reqCc.includes('no-cache') || reqCc.includes('max-age=0')\n        || request.headers.has('Pragma')\n    const cacheable = !isRsc && !bypassCache\n        && (request.method === 'GET' || request.method === 'HEAD')\n    const cache = cacheable && typeof caches !== 'undefined' ? caches.default : null\n    if (cache) {\n      const cached = await cache.match(request)\n      if (cached) return cached\n    }\n\n    const response = await bindingsAls.run(env, () =>\n      runWithWaitUntil((promise) => ctx.waitUntil(promise), () => handler(request))\n    )\n\n    // Cache public responses at the edge. A response is edge-cacheable if\n    // it has 'public' or 's-maxage' (a shared-cache TTL directive) and no\n    // 'no-store' or 'private'. Cloudflare's cache.put() only accepts GET\n    // requests and rejects 206, so only store GET 200s. HEAD requests\n    // benefit from cache.match() which handles HEAD→GET matching automatically.\n    // See design/25-production-deployments.md §\"CDN / Edge Cache\".\n    if (cache && request.method === 'GET' && response.status === 200) {\n      const cc = response.headers.get('Cache-Control')\n      const vary = response.headers.get('Vary')\n      if (cc && !cc.includes('no-store') && !cc.includes('private')\n          && (cc.includes('public') || cc.includes('s-maxage'))\n          && vary !== '*' && !response.headers.has('Set-Cookie')) {\n        ctx.waitUntil(cache.put(request, response.clone()))\n      }\n    }\n\n    return response\n  }\n}\n`;\n}\n\n/** Build-time prebuilt file list read from `.timber/dist/prebuilt/`. */\nexport interface PrebuiltModuleData {\n  /** Payload file paths relative to prebuilt/ (e.g. \"comp_abc/deadbeef.flight\"). */\n  payloadFiles: string[];\n}\n\n/**\n * Discover prebuilt flight payload files from the build directory.\n * Returns null when no prebuilt artifacts exist (no cache.component usage).\n *\n * @internal Exported for testing.\n */\nexport async function readPrebuiltData(buildDir: string): Promise<PrebuiltModuleData | null> {\n  const prebuiltDir = join(buildDir, 'prebuilt');\n  try {\n    await readFile(join(prebuiltDir, 'manifest.json'));\n  } catch {\n    return null;\n  }\n  const payloadFiles: string[] = [];\n  try {\n    const componentDirs = await readdir(prebuiltDir, { withFileTypes: true });\n    for (const dir of componentDirs) {\n      if (!dir.isDirectory()) continue;\n      const files = await readdir(join(prebuiltDir, dir.name));\n      for (const file of files) {\n        if (file.endsWith('.flight')) {\n          payloadFiles.push(`${dir.name}/${file}`);\n        }\n      }\n    }\n  } catch {\n    // No subdirectories — manifest exists but no payloads\n  }\n  return { payloadFiles };\n}\n\n/**\n * Generate the prebuilt payload source module for Cloudflare Workers.\n *\n * Imports prebuilt flight payloads as native wrangler Data/Text modules\n * from the worker's module graph (NOT from static assets — TIM-1162).\n * Files live at `outDir/prebuilt/` which is outside `static/` and thus\n * not publicly fetchable. Wrangler discovers them via\n * `find_additional_modules: true` with Data/Text rules.\n *\n * This is a separate ESM module so it evaluates before the RSC handler —\n * static imports are hoisted, guaranteeing `globalThis.__TIMBER_PREBUILT_SOURCE__`\n * is set before `createRequestHandler()` reads it.\n *\n * @internal Exported for testing.\n */\nexport function generatePrebuiltSourceModule(data: PrebuiltModuleData | null): string {\n  if (!data) {\n    return `// Generated by @timber-js/app/adapters/cloudflare\n// No prebuilt artifacts — all cache.component wrappers render dynamically.\nglobalThis.__TIMBER_PREBUILT_SOURCE__ = {\n  async loadManifest() { return null },\n  async readPayload() { return null },\n}\n`;\n  }\n\n  const imports: string[] = [];\n  const entries: string[] = [];\n\n  imports.push(`import _manifestText from './prebuilt/manifest.json'`);\n\n  for (let i = 0; i < data.payloadFiles.length; i++) {\n    const file = data.payloadFiles[i];\n    imports.push(`import _p${i} from './prebuilt/${file}'`);\n    entries.push(`  ${JSON.stringify(file)}: new Uint8Array(_p${i})`);\n  }\n\n  return `// Generated by @timber-js/app/adapters/cloudflare\n// Prebuilt payload source — imports cache.component flight payloads as\n// native wrangler modules from the worker bundle (TIM-1162). Files live\n// at outDir/prebuilt/, outside static/, so they are not publicly fetchable.\n${imports.join('\\n')}\n\nconst _manifest = JSON.parse(_manifestText)\n\nconst _payloads = {\n${entries.join(',\\n')}\n}\n\nglobalThis.__TIMBER_PREBUILT_SOURCE__ = {\n  async loadManifest() { return _manifest },\n  async readPayload(file) { return _payloads[file] ?? null },\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 PREBUILT_MODULE_RULES = [\n    { type: 'Text' as const, globs: ['prebuilt/**/*.json'] },\n    { type: 'Data' as const, globs: ['prebuilt/**/*.flight'] },\n  ];\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'] }, ...PREBUILT_MODULE_RULES],\n    assets: {\n      directory: './static',\n      binding: 'ASSETS',\n    },\n    // Native trace destination — required for timber's pipeline spans\n    // (emitted via tracing.enterSpan in the generated _worker.js) to appear\n    // in the Cloudflare Observability dashboard. Gates traces only; does\n    // not enable Workers Logs. Override via the `wrangler` escape hatch:\n    // wrangler: { observability: { traces: { enabled: false } } }.\n    observability: {\n      traces: { enabled: true },\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    const result = shallowDeepMerge(merged, options.wrangler);\n    // Ensure required prebuilt module rules survive a user `rules` override.\n    // Without this, `wrangler: { rules: [...] }` replaces the entire array\n    // and drops the Text/Data rules that _timber-prebuilt-source.js needs.\n    if (options.wrangler.rules) {\n      const userRules = result.rules as Array<Record<string, unknown>>;\n      for (const required of PREBUILT_MODULE_RULES) {\n        const exists = userRules.some(\n          (r) =>\n            r.type === required.type && JSON.stringify(r.globs) === JSON.stringify(required.globs)\n        );\n        if (!exists) userRules.push(required);\n      }\n    }\n    return result;\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"],"mappings":"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"}

package/dist/adapters/nitro.js

@@ -1,4 +1,4 @@
-import { n as IMMUTABLE_CACHE, t as runSharedBuildSteps } from "../_chunks/build-output-helper-C8q4Zpf5.js";
+import { n as IMMUTABLE_CACHE, t as runSharedBuildSteps } from "../_chunks/build-output-helper-DF5uScqS.js";
 import { join, relative } from "node:path";
 import { readFile, writeFile } from "node:fs/promises";
 import { transformWithOxc } from "vite";

package/dist/cache/cache-api.d.ts

@@ -1,4 +1,5 @@
 import type { CacheOptions } from './index';
+import type { PrebuiltComponentOptions } from '../server/prebuilt-runtime';
 /**
  * Public caching API: `cache(fn, opts)`.
  *
@@ -20,5 +21,6 @@ export declare namespace cache {
         key?: string;
         tag?: string;
     }) => Promise<void>;
+    var component: <C extends (props: any) => unknown>(componentFn: C, _options?: PrebuiltComponentOptions) => C;
 }
 //# sourceMappingURL=cache-api.d.ts.map

package/dist/cache/cache-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-api.d.ts","sourceRoot":"","sources":["../../src/cache/cache-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAK5C;;;;;;;;;;;;;;GAcG;AAEH,wBAAgB,KAAK,CAAC,EAAE,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EAC/D,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,EAAE,CAMJ;yBAVe,KAAK;2BAoB8B;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,IAAI,CAAC"}
+{"version":3,"file":"cache-api.d.ts","sourceRoot":"","sources":["../../src/cache/cache-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAO3E;;;;;;;;;;;;;;GAcG;AAEH,wBAAgB,KAAK,CAAC,EAAE,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EAC/D,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,EAAE,CAMJ;yBAVe,KAAK;2BAoB8B;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,IAAI,CAAC;oBAgD5D,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,eACvD,CAAC,aACH,wBAAwB,KAClC,CAAC"}

package/dist/cache/handler-store.d.ts

@@ -22,6 +22,8 @@ interface CacheHandlerLike {
 }
 /** Replace the active cache handler. Called by the framework at boot. */
 export declare function setCacheHandler(h: CacheHandlerLike): void;
+/** Whether the handler was explicitly configured (vs the default in-memory fallback). */
+export declare function isCacheHandlerConfigured(): boolean;
 /**
  * Get the active cache handler. Creates a default MemoryCacheHandler on
  * first access if none has been set via setCacheHandler().

package/dist/cache/handler-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler-store.d.ts","sourceRoot":"","sources":["../../src/cache/handler-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,UAAU,gBAAgB;IACxB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACrE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,UAAU,CAAC,IAAI,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAID,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAEzD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,gBAAgB,CAOlD"}
+{"version":3,"file":"handler-store.d.ts","sourceRoot":"","sources":["../../src/cache/handler-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,UAAU,gBAAgB;IACxB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACrE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,UAAU,CAAC,IAAI,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAMD,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAGzD;AAED,yFAAyF;AACzF,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,gBAAgB,CAOlD"}

package/dist/cache/index.d.ts

@@ -67,4 +67,6 @@ export { cache } from './cache-api';
 export { setCacheHandler, getCacheHandler } from './handler-store';
 export { setDefaultSingleflightTimeout } from './timber-cache';
 export { estimateByteSize } from './sizeof';
+export { TagAwareCacheHandler } from './tag-aware-handler';
+export type { CacheStore } from './store';
 //# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACrE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,UAAU,CAAC,IAAI,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAGD,MAAM,WAAW,YAAY,CAAC,EAAE,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC;IAC1C,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;IAC1D;uFACmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,2FAA2F;IAC3F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oHAAoH;IACpH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kHAAkH;IAClH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,KAAK,CAGT;IACJ,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;gBAE1B,IAAI,CAAC,EAAE,yBAAyB;IAQtC,GAAG,CAAC,GAAG,EAAE,MAAM;;;;IAYf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;IAwCtE,UAAU,CAAC,IAAI,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE;IAkBrD,gDAAgD;IAChD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,sIAAsI;IACtI,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,6CAA6C;IAC7C,OAAO,CAAC,WAAW;CAQpB;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAG/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACrE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,UAAU,CAAC,IAAI,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAGD,MAAM,WAAW,YAAY,CAAC,EAAE,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC;IAC1C,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;IAC1D;uFACmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,2FAA2F;IAC3F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oHAAoH;IACpH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kHAAkH;IAClH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,KAAK,CAGT;IACJ,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;gBAE1B,IAAI,CAAC,EAAE,yBAAyB;IAQtC,GAAG,CAAC,GAAG,EAAE,MAAM;;;;IAYf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;IAwCtE,UAAU,CAAC,IAAI,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE;IAkBrD,gDAAgD;IAChD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,sIAAsI;IACtI,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,6CAA6C;IAC7C,OAAO,CAAC,WAAW;CAQpB;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAG/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/cache/index.js

@@ -1,186 +1,3 @@
-import { i as setDefaultSingleflightTimeout, n as getCacheHandler, r as setCacheHandler, t as cache } from "../_chunks/cache-api-Cbyh3RW4.js";
-//#region src/cache/sizeof.ts
-/**
-* Lightweight byte-size estimation for cache entries.
-*
-* Estimates the in-memory byte cost of a JavaScript value using
-* JSON.stringify().length * 2 (UTF-16 char width). This is a rough
-* approximation — it doesn't account for V8 object overhead, Map
-* metadata, or non-serializable values — but it's fast and good
-* enough for cache budget enforcement.
-*
-* Values that fail JSON serialization (circular references, BigInt,
-* etc.) return 0, allowing the entry to be cached without counting
-* toward the byte budget. This is a conservative choice: it's better
-* to cache and undercount than to reject the entry.
-*/
-/**
-* Estimate the byte size of a value.
-*
-* Uses `JSON.stringify(value).length * 2` to approximate UTF-16
-* in-memory size. Returns 0 if the value is not serializable.
-*/
-function estimateByteSize(value) {
-	try {
-		const json = JSON.stringify(value);
-		if (json === void 0) return 0;
-		return json.length * 2;
-	} catch (e) {
-		console.debug("[timber] sizeof estimation failed:", e instanceof Error ? e.message : e);
-		return 0;
-	}
-}
-//#endregion
-//#region src/cache/redis-handler.ts
-var KEY_PREFIX = "timber:cache:";
-var TAG_PREFIX = "timber:tag:";
-/**
-* Redis-backed CacheHandler for distributed caching.
-*
-* All instances sharing the same Redis see each other's cache entries and
-* invalidations. Tag-based invalidation uses Redis Sets to track which keys
-* belong to which tags.
-*
-* Bring your own Redis client wrapped to the {@link RedisClient} contract —
-* see the adapter examples on the interface for ioredis, node-redis v4, and
-* @upstash/redis.
-*/
-var RedisCacheHandler = class {
-	client;
-	prefix;
-	constructor(client, opts) {
-		this.client = client;
-		this.prefix = opts?.prefix ?? "";
-	}
-	cacheKey(key) {
-		return `${this.prefix}${KEY_PREFIX}${key}`;
-	}
-	tagKey(tag) {
-		return `${this.prefix}${TAG_PREFIX}${tag}`;
-	}
-	async get(key) {
-		const raw = await this.client.get(this.cacheKey(key));
-		if (raw === null) return null;
-		const entry = JSON.parse(raw);
-		const stale = Date.now() > entry.expiresAt;
-		return {
-			value: entry.value,
-			stale
-		};
-	}
-	async set(key, value, opts) {
-		const ck = this.cacheKey(key);
-		const expiresAt = Date.now() + opts.ttl * 1e3;
-		const payload = JSON.stringify({
-			value,
-			expiresAt,
-			tags: opts.tags
-		});
-		const redisTtlSeconds = Math.max(opts.ttl * 2 + 60, 120);
-		await this.client.set(ck, payload, redisTtlSeconds);
-		for (const tag of opts.tags) {
-			await this.client.sadd(this.tagKey(tag), key);
-			if (await this.client.ttl(this.tagKey(tag)) < redisTtlSeconds) await this.client.expire(this.tagKey(tag), redisTtlSeconds);
-		}
-	}
-	async invalidate(opts) {
-		if (opts.key) {
-			const raw = await this.client.get(this.cacheKey(opts.key));
-			if (raw !== null) {
-				const entry = JSON.parse(raw);
-				if (entry.tags) await Promise.all(entry.tags.map((tag) => this.client.srem(this.tagKey(tag), opts.key)));
-			}
-			await this.client.del(this.cacheKey(opts.key));
-		}
-		if (opts.tag) {
-			const tk = this.tagKey(opts.tag);
-			const keys = await this.client.smembers(tk);
-			await Promise.all(keys.map((k) => this.client.del(this.cacheKey(k))));
-			await this.client.del(tk);
-		}
-	}
-};
-//#endregion
-//#region src/cache/index.ts
-var MemoryCacheHandler = class {
-	store = /* @__PURE__ */ new Map();
-	maxEntries;
-	maxBytes;
-	maxEntryBytes;
-	currentBytes = 0;
-	_trackBytes;
-	constructor(opts) {
-		this.maxEntries = opts?.maxEntries ?? opts?.maxSize ?? 1e3;
-		this.maxBytes = opts?.maxBytes;
-		this.maxEntryBytes = opts?.maxEntryBytes;
-		this._trackBytes = this.maxBytes !== void 0 || this.maxEntryBytes !== void 0;
-	}
-	async get(key) {
-		const entry = this.store.get(key);
-		if (!entry) return null;
-		this.store.delete(key);
-		this.store.set(key, entry);
-		const stale = Date.now() > entry.expiresAt;
-		return {
-			value: entry.value,
-			stale
-		};
-	}
-	async set(key, value, opts) {
-		const byteSize = this._trackBytes ? estimateByteSize(value) : 0;
-		if (this.maxEntryBytes !== void 0 && byteSize > this.maxEntryBytes) return;
-		if (this.store.has(key)) {
-			const existing = this.store.get(key);
-			this.currentBytes -= existing.byteSize;
-			this.store.delete(key);
-		}
-		while (this.store.size >= this.maxEntries) this.evictOldest();
-		if (this.maxBytes !== void 0) {
-			while (this.currentBytes + byteSize > this.maxBytes && this.store.size > 0) this.evictOldest();
-			if (this.currentBytes + byteSize > this.maxBytes) return;
-		}
-		this.store.set(key, {
-			value,
-			expiresAt: Date.now() + opts.ttl * 1e3,
-			tags: opts.tags,
-			byteSize
-		});
-		this.currentBytes += byteSize;
-	}
-	async invalidate(opts) {
-		if (opts.key) {
-			const entry = this.store.get(opts.key);
-			if (entry) {
-				this.currentBytes -= entry.byteSize;
-				this.store.delete(opts.key);
-			}
-		}
-		if (opts.tag) {
-			for (const [key, entry] of this.store) if (entry.tags.includes(opts.tag)) {
-				this.currentBytes -= entry.byteSize;
-				this.store.delete(key);
-			}
-		}
-	}
-	/** Number of entries currently in the cache. */
-	get size() {
-		return this.store.size;
-	}
-	/** Estimated total byte size of all cached values. Only tracked when maxBytes or maxEntryBytes is configured; returns 0 otherwise. */
-	get bytes() {
-		return this.currentBytes;
-	}
-	/** Evict the oldest entry (front of Map). */
-	evictOldest() {
-		const oldest = this.store.keys().next().value;
-		if (oldest !== void 0) {
-			const entry = this.store.get(oldest);
-			this.currentBytes -= entry.byteSize;
-			this.store.delete(oldest);
-		}
-	}
-};
-//#endregion
-export { MemoryCacheHandler, RedisCacheHandler, cache, estimateByteSize, getCacheHandler, setCacheHandler, setDefaultSingleflightTimeout };
-
-//# sourceMappingURL=index.js.map
+import { d as MemoryCacheHandler, f as TagAwareCacheHandler, g as setDefaultSingleflightTimeout, h as setCacheHandler, m as getCacheHandler, p as RedisCacheHandler, t as cache } from "../_chunks/cache-api-DsWEYwVZ.js";
+import { t as estimateByteSize } from "../_chunks/sizeof-lXffQ1Vr.js";
+export { MemoryCacheHandler, RedisCacheHandler, TagAwareCacheHandler, cache, estimateByteSize, getCacheHandler, setCacheHandler, setDefaultSingleflightTimeout };