@timber-js/app 0.2.0-alpha.155 → 0.2.0-alpha.156

package/dist/_chunks/{build-output-helper-B20ZuTSA.js → build-output-helper-Rp9r7gSA.js}

@@ -1,4 +1,4 @@
-import { basename, join } from "node:path";
+import { basename, join, relative } from "node:path";
 import { cp, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
 //#region src/adapters/shared.ts
 /** Cache-Control value for hashed (immutable) assets. */
@@ -12,19 +12,34 @@ var STATIC_CACHE = "public, max-age=3600, must-revalidate";
 * Static Assets, Cloudflare Pages, and Netlify. It maps URL patterns to
 * HTTP response headers.
 *
-* Vite places all hashed chunks under `/assets/` — these get immutable caching.
-* Everything else (favicon.ico, robots.txt, etc.) gets a shorter cache.
+* Only hashed (immutable) asset paths are listed here by default. When
+* `unhashedPaths` is provided, per-file rules are appended for unhashed
+* static assets (favicon.ico, robots.txt, etc.) so they get Cache-Control
+* on platforms like Cloudflare Workers Static Assets where the server
+* handler never sees static file requests.
+*
+* A `/*` catch-all is NOT used — it would be additive on Cloudflare,
+* producing duplicate Cache-Control directives on hashed assets
+* (invalid per RFC 9111).
 */
-function generateHeadersFile() {
-	return `# Auto-generated by @timber-js/app — static asset cache headers.
+var MAX_UNHASHED_RULES = 98;
+function generateHeadersFile(unhashedPaths) {
+	let content = `# Auto-generated by @timber-js/app — static asset cache headers.
 # See design/25-production-deployments.md §"CDN / Edge Cache"
 
 /assets/*
   Cache-Control: ${IMMUTABLE_CACHE}
 
-/*
-  Cache-Control: ${STATIC_CACHE}
+/_timber/fonts/*
+  Cache-Control: ${IMMUTABLE_CACHE}
 `;
+	if (unhashedPaths && unhashedPaths.length > 0) {
+		const capped = unhashedPaths.slice(0, MAX_UNHASHED_RULES);
+		if (unhashedPaths.length > MAX_UNHASHED_RULES) console.warn(`[timber] _headers: ${unhashedPaths.length} unhashed static files found, but Cloudflare limits _headers to 100 rules. Only the first ${MAX_UNHASHED_RULES} unhashed files will get Cache-Control headers.`);
+		content += `\n# Unhashed static assets — short-lived cache with revalidation\n`;
+		for (const p of capped) content += `\n${p}\n  Cache-Control: ${STATIC_CACHE}\n`;
+	}
+	return content;
 }
 //#endregion
 //#region src/adapters/build-output-helper.ts
@@ -56,7 +71,8 @@ async function runSharedBuildSteps(opts) {
 	}).catch((e) => {
 		if (e.code !== "ENOENT") throw e;
 	});
-	await writeFile(join(publicDir, "_headers"), generateHeadersFile());
+	const unhashedPaths = await findUnhashedStaticFiles(publicDir);
+	await writeFile(join(publicDir, "_headers"), generateHeadersFile(unhashedPaths));
 	await cp(join(buildDir, "rsc"), join(outDir, "rsc"), { recursive: true });
 	await cp(join(buildDir, "ssr"), join(outDir, "ssr"), { recursive: true }).catch((e) => {
 		if (e.code !== "ENOENT") throw e;
@@ -65,6 +81,43 @@ async function runSharedBuildSteps(opts) {
 	return publicDir;
 }
 /**
+* Find unhashed static files in the public directory that need per-file
+* Cache-Control rules in the `_headers` file.
+*
+* Excludes:
+* - Files under `assets/` and `_timber/` (covered by wildcard rules)
+* - Underscore-prefixed files (`_headers`, `_worker.js`, etc.)
+*
+* @internal Exported for testing.
+*/
+var PRIORITY_FILES = new Set([
+	"/favicon.ico",
+	"/robots.txt",
+	"/sitemap.xml",
+	"/manifest.json",
+	"/manifest.webmanifest",
+	"/apple-touch-icon.png"
+]);
+async function findUnhashedStaticFiles(publicDir) {
+	let files;
+	try {
+		files = await collectFiles(publicDir);
+	} catch {
+		return [];
+	}
+	const priority = [];
+	const rest = [];
+	for (const file of files) {
+		const rel = relative(publicDir, file).replace(/\\/g, "/");
+		if (rel.startsWith("assets/") || rel.startsWith("_timber/")) continue;
+		if (basename(rel).startsWith("_")) continue;
+		const urlPath = "/" + rel;
+		if (PRIORITY_FILES.has(urlPath)) priority.push(urlPath);
+		else rest.push(urlPath);
+	}
+	return [...priority.sort(), ...rest.sort()];
+}
+/**
 * Scan client JS files for references to .wasm filenames.
 * Returns the set of WASM basenames that are actually imported/referenced
 * by client code and must be preserved in the static output.
@@ -99,4 +152,4 @@ async function collectFiles(dir) {
 //#endregion
 export { IMMUTABLE_CACHE as n, runSharedBuildSteps as t };
 
-//# sourceMappingURL=build-output-helper-B20ZuTSA.js.map
+//# sourceMappingURL=build-output-helper-Rp9r7gSA.js.map

package/dist/_chunks/build-output-helper-Rp9r7gSA.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-output-helper-Rp9r7gSA.js","names":[],"sources":["../../src/adapters/shared.ts","../../src/adapters/build-output-helper.ts"],"sourcesContent":["// Shared adapter utilities — leaf module with zero deps on server/, client/,\n// or any Vite-dependent code.\n//\n// Adapters are loaded by Node at Vite startup time, before Vite's module\n// resolver is available. This module uses only Node built-ins and can be\n// imported by both adapters via a relative path.\n//\n// IMPORTANT: Do NOT add imports from ../server/, ../client/, ../plugins/,\n// or any module that transitively depends on Vite. A test in\n// tests/adapters/shared-no-forbidden-imports.test.ts enforces this.\n\n// ─── Static asset cache headers ──────────────────────────────────────────\n\n/** Cache-Control value for hashed (immutable) assets. */\nexport const IMMUTABLE_CACHE = 'public, max-age=31536000, immutable';\n\n/** Cache-Control value for unhashed static assets. */\nexport const STATIC_CACHE = 'public, max-age=3600, must-revalidate';\n\n/**\n * Generate a `_headers` file for static asset cache control.\n *\n * The `_headers` file is a platform convention supported by Cloudflare Workers\n * Static Assets, Cloudflare Pages, and Netlify. It maps URL patterns to\n * HTTP response headers.\n *\n * Only hashed (immutable) asset paths are listed here by default. When\n * `unhashedPaths` is provided, per-file rules are appended for unhashed\n * static assets (favicon.ico, robots.txt, etc.) so they get Cache-Control\n * on platforms like Cloudflare Workers Static Assets where the server\n * handler never sees static file requests.\n *\n * A `/*` catch-all is NOT used — it would be additive on Cloudflare,\n * producing duplicate Cache-Control directives on hashed assets\n * (invalid per RFC 9111).\n */\n// Cloudflare Workers Static Assets caps _headers at 100 rules.\n// Reserve 2 for the wildcard hashed-asset rules.\nconst MAX_UNHASHED_RULES = 98;\n\nexport function generateHeadersFile(unhashedPaths?: string[]): string {\n  let content = `# 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/_timber/fonts/*\n  Cache-Control: ${IMMUTABLE_CACHE}\n`;\n\n  if (unhashedPaths && unhashedPaths.length > 0) {\n    const capped = unhashedPaths.slice(0, MAX_UNHASHED_RULES);\n    if (unhashedPaths.length > MAX_UNHASHED_RULES) {\n      console.warn(\n        `[timber] _headers: ${unhashedPaths.length} unhashed static files found, ` +\n          `but Cloudflare limits _headers to 100 rules. Only the first ${MAX_UNHASHED_RULES} ` +\n          `unhashed files will get Cache-Control headers.`\n      );\n    }\n    content += `\\n# Unhashed static assets — short-lived cache with revalidation\\n`;\n    for (const p of capped) {\n      content += `\\n${p}\\n  Cache-Control: ${STATIC_CACHE}\\n`;\n    }\n  }\n\n  return content;\n}\n","// Shared build-output helper for adapter buildOutput() methods.\n//\n// Steps 1–5 of every adapter's buildOutput are platform-agnostic:\n//   1. Copy client assets to the public/static directory\n//   2. Write _headers file for static asset cache control\n//   3. Copy RSC + SSR server bundles\n//   4. Write manifest-init module (if present)\n//\n// Only the final steps (entry codegen, platform config) vary per adapter.\n//\n// IMPORTANT: This module must remain a leaf — no imports from ../server/,\n// ../client/, or Vite-dependent code. See adapters/shared.ts header.\n\nimport { writeFile, mkdir, cp, readdir, readFile } from 'node:fs/promises';\nimport { join, basename, relative } from 'node:path';\nimport { generateHeadersFile } from './shared.js';\nimport type { TimberConfig } from './types';\n\n/** Options for the shared build output steps. */\nexport interface BuildOutputBaseOptions {\n  /** Resolved timber config. */\n  config: TimberConfig;\n  /** Root build directory (e.g. `.timber/build`). */\n  buildDir: string;\n  /** Adapter-specific output directory (e.g. `.timber/build/nitro`). */\n  outDir: string;\n  /**\n   * Name of the public/static directory within outDir.\n   * Nitro uses 'public', Cloudflare uses 'static'.\n   */\n  publicDirName: string;\n}\n\n/**\n * Run the platform-agnostic build output steps shared by all adapters:\n *\n * 1. Create the output directory\n * 2. Copy client assets to the public/static directory\n * 3. Write the `_headers` file for static asset cache control\n * 4. Copy RSC and SSR server bundles into the output directory\n * 5. Write the manifest-init module if present\n *\n * Returns the resolved public directory path for further adapter-specific use.\n */\nexport async function runSharedBuildSteps(opts: BuildOutputBaseOptions): Promise<string> {\n  const { config, buildDir, outDir, publicDirName } = opts;\n\n  // 1. Create the output directory.\n  await mkdir(outDir, { recursive: true });\n\n  // 2. Copy client assets to public/static directory.\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 publicDir = join(outDir, publicDirName);\n  await mkdir(publicDir, { recursive: true });\n  // Find WASM files that are referenced by client JS (legitimate client WASM)\n  // vs orphaned server-only WASM (e.g. @takumi-rs for OG image generation).\n  // Only strip orphaned WASM to avoid breaking client-side WASM usage.\n  const referencedWasm = await findReferencedWasm(clientDir);\n\n  await cp(clientDir, publicDir, {\n    recursive: true,\n    filter: (src: string) => {\n      if (src.endsWith('.wasm') && !referencedWasm.has(basename(src))) {\n        return false;\n      }\n      if (config.clientJavascriptDisabled && src.endsWith('.js')) return false;\n      return true;\n    },\n  }).catch((e: NodeJS.ErrnoException) => {\n    // Client dir may not exist when client JavaScript is disabled\n    if (e.code !== 'ENOENT') throw e;\n  });\n\n  // 3. Write _headers file for static asset cache control.\n  // Scan for unhashed files so they get per-file Cache-Control rules in the\n  // _headers file. On platforms like Cloudflare Workers Static Assets, the\n  // worker never sees static file requests — _headers is the only mechanism.\n  const unhashedPaths = await findUnhashedStaticFiles(publicDir);\n  await writeFile(join(publicDir, '_headers'), generateHeadersFile(unhashedPaths));\n\n  // 4. Copy RSC + SSR server bundles into the output directory.\n  await cp(join(buildDir, 'rsc'), join(outDir, 'rsc'), { recursive: true });\n  await cp(join(buildDir, 'ssr'), join(outDir, 'ssr'), { recursive: true }).catch(\n    (e: NodeJS.ErrnoException) => {\n      // SSR dir may not exist for static-only builds\n      if (e.code !== 'ENOENT') throw e;\n    }\n  );\n\n  // 5. Write manifest-init module if present.\n  if (config.manifestInit) {\n    await writeFile(join(outDir, '_timber-manifest-init.js'), config.manifestInit);\n  }\n\n  return publicDir;\n}\n\n/**\n * Find unhashed static files in the public directory that need per-file\n * Cache-Control rules in the `_headers` file.\n *\n * Excludes:\n * - Files under `assets/` and `_timber/` (covered by wildcard rules)\n * - Underscore-prefixed files (`_headers`, `_worker.js`, etc.)\n *\n * @internal Exported for testing.\n */\n// Well-known metadata files that should be prioritized when capping\n// _headers rules, so they're never dropped in favor of less important files.\nconst PRIORITY_FILES = new Set([\n  '/favicon.ico',\n  '/robots.txt',\n  '/sitemap.xml',\n  '/manifest.json',\n  '/manifest.webmanifest',\n  '/apple-touch-icon.png',\n]);\n\nexport async function findUnhashedStaticFiles(publicDir: string): Promise<string[]> {\n  let files: string[];\n  try {\n    files = await collectFiles(publicDir);\n  } catch {\n    return [];\n  }\n\n  const priority: string[] = [];\n  const rest: string[] = [];\n  for (const file of files) {\n    const rel = relative(publicDir, file).replace(/\\\\/g, '/');\n    if (rel.startsWith('assets/') || rel.startsWith('_timber/')) continue;\n    if (basename(rel).startsWith('_')) continue;\n    const urlPath = '/' + rel;\n    if (PRIORITY_FILES.has(urlPath)) {\n      priority.push(urlPath);\n    } else {\n      rest.push(urlPath);\n    }\n  }\n\n  return [...priority.sort(), ...rest.sort()];\n}\n\n/**\n * Scan client JS files for references to .wasm filenames.\n * Returns the set of WASM basenames that are actually imported/referenced\n * by client code and must be preserved in the static output.\n */\nasync function findReferencedWasm(clientDir: string): Promise<Set<string>> {\n  const referenced = new Set<string>();\n\n  let files: string[];\n  try {\n    files = await collectFiles(clientDir);\n  } catch {\n    return referenced;\n  }\n\n  const jsFiles = files.filter((f) => f.endsWith('.js'));\n  const wasmFiles = files.filter((f) => f.endsWith('.wasm')).map((f) => basename(f));\n  if (wasmFiles.length === 0) return referenced;\n\n  for (const jsFile of jsFiles) {\n    const content = await readFile(jsFile, 'utf-8');\n    for (const wasmName of wasmFiles) {\n      if (content.includes(wasmName)) {\n        referenced.add(wasmName);\n      }\n    }\n  }\n\n  return referenced;\n}\n\nasync function collectFiles(dir: string): Promise<string[]> {\n  const result: string[] = [];\n  const entries = await readdir(dir, { withFileTypes: true });\n  for (const entry of entries) {\n    const fullPath = join(dir, entry.name);\n    if (entry.isDirectory()) {\n      result.push(...(await collectFiles(fullPath)));\n    } else {\n      result.push(fullPath);\n    }\n  }\n  return result;\n}\n"],"mappings":"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"}

package/dist/adapters/build-output-helper.d.ts

@@ -25,4 +25,5 @@ export interface BuildOutputBaseOptions {
  * Returns the resolved public directory path for further adapter-specific use.
  */
 export declare function runSharedBuildSteps(opts: BuildOutputBaseOptions): Promise<string>;
+export declare function findUnhashedStaticFiles(publicDir: string): Promise<string[]>;
 //# sourceMappingURL=build-output-helper.d.ts.map

package/dist/adapters/build-output-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-output-helper.d.ts","sourceRoot":"","sources":["../../src/adapters/build-output-helper.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiDvF"}
+{"version":3,"file":"build-output-helper.d.ts","sourceRoot":"","sources":["../../src/adapters/build-output-helper.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDvF;AAuBD,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBlF"}

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

@@ -1 +1 @@
-{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../src/adapters/cloudflare.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../src/adapters/cloudflare.ts"],"names":[],"mappings":"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"}

package/dist/adapters/cloudflare.js

@@ -1,4 +1,4 @@
-import { t as runSharedBuildSteps } from "../_chunks/build-output-helper-B20ZuTSA.js";
+import { t as runSharedBuildSteps } from "../_chunks/build-output-helper-Rp9r7gSA.js";
 import { join, relative } from "node:path";
 import { writeFile } from "node:fs/promises";
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -128,12 +128,42 @@ if (!bindingsAls) {
 
 export default {
 ${hasWorkerHandlers ? "  ...workerHandlers,\n" : ""}  async fetch(request, env, ctx) {
-    // Bridge ctx.waitUntil into the per-request ALS so waitUntil() calls in
-    // user code keep the isolate alive after the response is sent.
-    // See design/11-platform.md §"waitUntil()".
-    return bindingsAls.run(env, () =>
+    // 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.
+    const isRsc = request.headers.get('Accept')?.includes('text/x-component')
+    const reqCc = request.headers.get('Cache-Control') || ''
+    const bypassCache = reqCc.includes('no-cache') || reqCc.includes('max-age=0')
+        || request.headers.has('Pragma')
+    const cacheable = !isRsc && !bypassCache
+        && (request.method === 'GET' || request.method === 'HEAD')
+    const cache = cacheable && typeof caches !== 'undefined' ? caches.default : null
+    if (cache) {
+      const cached = await cache.match(request)
+      if (cached) return cached
+    }
+
+    const response = await bindingsAls.run(env, () =>
       runWithWaitUntil((promise) => ctx.waitUntil(promise), () => handler(request))
     )
+
+    // Cache public responses at the edge. A response is edge-cacheable if
+    // it has 'public' or 's-maxage' (a shared-cache TTL directive) and no
+    // 'no-store' or 'private'. Cloudflare's cache.put() only accepts GET
+    // requests and rejects 206, so only store GET 200s. HEAD requests
+    // benefit from cache.match() which handles HEAD→GET matching automatically.
+    // See design/25-production-deployments.md §"CDN / Edge Cache".
+    if (cache && request.method === 'GET' && response.status === 200) {
+      const cc = response.headers.get('Cache-Control')
+      const vary = response.headers.get('Vary')
+      if (cc && !cc.includes('no-store') && !cc.includes('private')
+          && (cc.includes('public') || cc.includes('s-maxage'))
+          && vary !== '*' && !response.headers.has('Set-Cookie')) {
+        ctx.waitUntil(cache.put(request, response.clone()))
+      }
+    }
+
+    return response
   }
 }
 `;

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    // Bridge ctx.waitUntil into the per-request ALS so waitUntil() calls in\n    // user code keep the isolate alive after the response is sent.\n    // See design/11-platform.md §\"waitUntil()\".\n    return bindingsAls.run(env, () =>\n      runWithWaitUntil((promise) => ctx.waitUntil(promise), () => handler(request))\n    )\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":"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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 } 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":"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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-B20ZuTSA.js";
+import { n as IMMUTABLE_CACHE, t as runSharedBuildSteps } from "../_chunks/build-output-helper-Rp9r7gSA.js";
 import { join, relative } from "node:path";
 import { readFile, writeFile } from "node:fs/promises";
 import { transformWithOxc } from "vite";

package/dist/adapters/shared.d.ts

@@ -2,15 +2,5 @@
 export declare const IMMUTABLE_CACHE = "public, max-age=31536000, immutable";
 /** Cache-Control value for unhashed static assets. */
 export declare const STATIC_CACHE = "public, max-age=3600, must-revalidate";
-/**
- * Generate a `_headers` file for static asset cache control.
- *
- * The `_headers` file is a platform convention supported by Cloudflare Workers
- * Static Assets, Cloudflare Pages, and Netlify. It maps URL patterns to
- * HTTP response headers.
- *
- * Vite places all hashed chunks under `/assets/` — these get immutable caching.
- * Everything else (favicon.ico, robots.txt, etc.) gets a shorter cache.
- */
-export declare function generateHeadersFile(): string;
+export declare function generateHeadersFile(unhashedPaths?: string[]): string;
 //# sourceMappingURL=shared.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"AAaA,yDAAyD;AACzD,eAAO,MAAM,eAAe,wCAAwC,CAAC;AAErE,sDAAsD;AACtD,eAAO,MAAM,YAAY,0CAA0C,CAAC;AAEpE;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAU5C"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"AAaA,yDAAyD;AACzD,eAAO,MAAM,eAAe,wCAAwC,CAAC;AAErE,sDAAsD;AACtD,eAAO,MAAM,YAAY,0CAA0C,CAAC;AAuBpE,wBAAgB,mBAAmB,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CA2BpE"}

package/dist/fonts/google.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/fonts/google.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAgBpE,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,IAAI,EAAE,cAAc,CAAC;IACrB,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAiC/D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAahF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CA8BjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAI5F;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI7E;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMnE;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,aAAa,EAAE,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,EAAE,CAAC,CAwCvB;AAeD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,UAAU,EAAE,EACzB,OAAO,EAAE,MAAM,EACf,SAAS,SAAkB,GAC1B,kBAAkB,EAAE,CAStB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE,MAAM,GACd,kBAAkB,EAAE,CAStB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAK5F"}
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/fonts/google.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAsCpE,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,IAAI,EAAE,cAAc,CAAC;IACrB,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAiC/D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAwBhF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CA8BjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAI5F;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI7E;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBnE;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,aAAa,EAAE,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,EAAE,CAAC,CA+CvB;AAeD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,UAAU,EAAE,EACzB,OAAO,EAAE,MAAM,EACf,SAAS,SAAkB,GAC1B,kBAAkB,EAAE,CAStB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE,MAAM,GACd,kBAAkB,EAAE,CAStB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAK5F"}

package/dist/index.js

@@ -3161,6 +3161,22 @@ function hashedFontBasename(srcPath, hash) {
 *
 * Design doc: 24-fonts.md §"Step 2: Font Download & Subsetting"
 */
+/**
+* Extract a recognizable error code (ETIMEDOUT, ENOTFOUND, etc.) from a
+* network error's cause chain. Node's undici-based `fetch` wraps the
+* system error inside `cause` (sometimes as an AggregateError).
+*/
+function extractNetworkErrorCode(err) {
+	if (!(err instanceof Error)) return void 0;
+	const code = err.code;
+	if (code) return code;
+	const cause = err.cause;
+	if (cause instanceof AggregateError) for (const inner of cause.errors) {
+		const innerCode = inner.code;
+		if (innerCode) return innerCode;
+	}
+	if (cause instanceof Error) return cause.code;
+}
 /** Google Fonts CSS API v2 base URL. */
 var GOOGLE_FONTS_API = "https://fonts.googleapis.com/css2";
 /**
@@ -3207,7 +3223,13 @@ function buildGoogleFontsUrl(font) {
 * We parse each block to extract the font URL, unicode-range, and subset label.
 */
 async function fetchGoogleFontsCss(url) {
-	const response = await fetch(url, { headers: { "User-Agent": WOFF2_USER_AGENT } });
+	let response;
+	try {
+		response = await fetch(url, { headers: { "User-Agent": WOFF2_USER_AGENT } });
+	} catch (err) {
+		const code = extractNetworkErrorCode(err);
+		throw new Error(`[timber] Failed to fetch Google Fonts CSS from ${url}` + (code ? ` (${code})` : "") + ". Build requires internet access for font optimization. If building offline, set TIMBER_SKIP_FONTS=1 to skip font downloading.");
+	}
 	if (!response.ok) throw new Error(`Google Fonts API returned ${response.status}: ${response.statusText} for ${url}`);
 	return parseGoogleFontsCss(await response.text());
 }
@@ -3276,7 +3298,13 @@ function cacheKey(face) {
 * Download a single font file from its URL.
 */
 async function downloadFontFile(url) {
-	const response = await fetch(url);
+	let response;
+	try {
+		response = await fetch(url);
+	} catch (err) {
+		const code = extractNetworkErrorCode(err);
+		throw new Error(`[timber] Failed to download font file from ${url}` + (code ? ` (${code})` : "") + ". Build requires internet access for font optimization. If building offline, set TIMBER_SKIP_FONTS=1 to skip font downloading.");
+	}
 	if (!response.ok) throw new Error(`Failed to download font from ${url}: ${response.status}`);
 	return Buffer.from(await response.arrayBuffer());
 }
@@ -3294,7 +3322,14 @@ async function downloadAndCacheFonts(fonts, projectRoot) {
 	const googleFonts = fonts.filter((f) => f.provider === "google");
 	const cached = [];
 	for (const font of googleFonts) {
-		const filtered = filterBySubsets(await fetchGoogleFontsCss(buildGoogleFontsUrl(font)), font.subsets);
+		const apiUrl = buildGoogleFontsUrl(font);
+		let faces;
+		try {
+			faces = await fetchGoogleFontsCss(apiUrl);
+		} catch (err) {
+			throw new Error(`[timber] Failed to download font '${font.family}': ${err instanceof Error ? err.message : String(err)}`);
+		}
+		const filtered = filterBySubsets(faces, font.subsets);
 		for (const face of filtered) {
 			const key = cacheKey(face);
 			const metaPath = join(cacheDir, `${key}.meta.json`);
@@ -5994,9 +6029,14 @@ function timberFonts(ctx) {
 			if (pipeline.cssIdMap.matches(id)) {
 				const importer = pipeline.cssIdMap.importerFor(id);
 				if (!importer) return "";
+				const skipFonts = process.env.TIMBER_SKIP_FONTS === "1";
 				for (const font of pipeline.googleFonts()) {
 					if (font.importer !== importer) continue;
 					if (pipeline.hasFaces(font.id)) continue;
+					if (skipFonts && !ctx.dev) {
+						console.warn(`[timber-fonts] Skipping font "${font.family}" (TIMBER_SKIP_FONTS=1)`);
+						continue;
+					}
 					try {
 						if (ctx.dev) {
 							const faces = await resolveDevFontFaces(font);