@timber-js/app 0.2.0-alpha.165 → 0.2.0-alpha.167

package/dist/adapters/cloudflare.d.ts

@@ -95,6 +95,11 @@ export interface CloudflareBindings {
 }
 /** Options for the Cloudflare Workers adapter. */
 export interface CloudflareAdapterOptions {
+    /**
+     * Worker name used in the generated wrangler.jsonc.
+     * @default 'timber-app'
+     */
+    name?: string;
     /**
      * Cloudflare compatibility date.
      * @default Current date in YYYY-MM-DD format at build time.
@@ -231,8 +236,14 @@ export interface WranglerBindingsConfig {
  * @internal Exported for testing.
  */
 export declare function generateBindingsConfig(bindings: CloudflareBindings | undefined): WranglerBindingsConfig;
+/**
+ * Read the user's wrangler config from the project root, if one exists.
+ * Checks wrangler.jsonc first, then wrangler.json.
+ * @internal Exported for testing.
+ */
+export declare function readUserWranglerConfig(root: string): Promise<Record<string, unknown> | null>;
 /** @internal Exported for testing. */
-export declare function generateWranglerConfig(config: TimberConfig, options: CloudflareAdapterOptions): Record<string, unknown>;
+export declare function generateWranglerConfig(config: TimberConfig, options: CloudflareAdapterOptions, userConfig?: Record<string, unknown> | null): Record<string, unknown>;
 /** Command descriptor for preview — testable without spawning a process. */
 export interface PreviewCommand {
     command: string;

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,461 +1,2 @@
-import { t as runSharedBuildSteps } from "../_chunks/build-output-helper-DF5uScqS.js";
-import { join, relative } from "node:path";
-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
-var BINDINGS_ALS_KEY = Symbol.for("timber:cf-bindings-als");
-function getBindingsAls() {
-	let als = globalThis[BINDINGS_ALS_KEY];
-	if (!als) {
-		als = new AsyncLocalStorage();
-		globalThis[BINDINGS_ALS_KEY] = als;
-	}
-	return als;
-}
-/**
-* Get Cloudflare Worker bindings for the current request.
-*
-* Returns the `env` object passed to the Worker's `fetch` handler,
-* giving direct access to KV, D1, Durable Objects, R2, Queues, and
-* any other bindings configured in `wrangler.jsonc`.
-*
-* Must be called within a request context (server component, middleware,
-* server action). Throws outside a request.
-*
-* @example
-* ```ts
-* import { getCloudflareBindings } from '@timber-js/app/adapters/cloudflare'
-*
-* export default async function Page() {
-*   const { MY_KV, MY_DB } = getCloudflareBindings()
-*   const data = await MY_KV.get('key')
-*   return <div>{data}</div>
-* }
-* ```
-*/
-function getCloudflareBindings() {
-	const env = getBindingsAls().getStore();
-	if (!env) throw new Error("getCloudflareBindings() called outside a Cloudflare Workers request context. It can only be called from server components, middleware, or server actions when running on the Cloudflare adapter.");
-	return env;
-}
-/**
-* Run a function with Cloudflare bindings available via getCloudflareBindings().
-* @internal Used by cloudflareDevBindings() to wrap dev-server requests.
-*/
-function runWithBindings(env, fn) {
-	return getBindingsAls().run(env, fn);
-}
-/**
-* Create a Cloudflare Workers adapter.
-*
-* @example
-* ```ts
-* import { cloudflare } from '@timber-js/app/adapters/cloudflare'
-*
-* export default {
-*   output: 'server',
-*   adapter: cloudflare(),
-* }
-* ```
-*/
-function cloudflare(options = {}) {
-	return {
-		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,
-				outDir,
-				publicDirName: "static"
-			});
-			let hasWorkerHandlers = false;
-			if (options.workerHandlers) {
-				const handlersEntry = join(process.cwd(), options.workerHandlers);
-				const { build: viteBuild } = await import("vite");
-				await viteBuild({
-					configFile: false,
-					logLevel: "info",
-					build: {
-						lib: {
-							entry: handlersEntry,
-							formats: ["es"],
-							fileName: () => "_worker-handlers.js"
-						},
-						outDir,
-						emptyOutDir: false,
-						minify: false,
-						rollupOptions: { external: [/^node:/, /^cloudflare:/] }
-					}
-				});
-				hasWorkerHandlers = true;
-			}
-			const prebuiltData = await readPrebuiltData(buildDir);
-			await writeFile(join(outDir, "_timber-prebuilt-source.js"), generatePrebuiltSourceModule(prebuiltData));
-			await rm(join(outDir, "prebuilt"), {
-				recursive: true,
-				force: true
-			}).catch(() => {});
-			await writeFile(join(outDir, "_timber-runtime-init.js"), generateRuntimeInitModule());
-			const workerEntry = generateWorkerEntry(outDir, outDir, !!config.manifestInit, hasWorkerHandlers);
-			await writeFile(join(outDir, "_worker.js"), workerEntry);
-			const wranglerConfig = generateWranglerConfig(config, options);
-			await writeFile(join(outDir, "wrangler.jsonc"), JSON.stringify(wranglerConfig, null, 2));
-		},
-		async preview(_config, buildDir) {
-			const cmd = generatePreviewCommand(buildDir);
-			await spawnPreviewProcess(cmd.command, cmd.args, cmd.cwd);
-		}
-	};
-}
-/** @internal Exported for testing. */
-function generateWorkerEntry(buildDir, outDir, hasManifestInit = false, hasWorkerHandlers = false) {
-	let rscEntryRelative = relative(outDir, join(buildDir, "rsc", "index.js"));
-	if (!rscEntryRelative.startsWith(".")) rscEntryRelative = "./" + rscEntryRelative;
-	return `// Generated by @timber-js/app/adapters/cloudflare
-// Do not edit — this file is regenerated on each build.
-
-import { AsyncLocalStorage } from 'node:async_hooks'
-// Side-effect imports: evaluated IN ORDER before the _worker.js body runs.
-// _timber-runtime-init.js sets TIMBER_RUNTIME before createRequestHandler()
-// runs (during the RSC entry's top-level await) so the auto-wire for
-// WorkersCachePurge can detect the Cloudflare runtime (TIM-1170).
-// _timber-prebuilt-source.js sets globalThis.__TIMBER_PREBUILT_SOURCE__
-// for cache.component payloads.
-import './_timber-runtime-init.js'
-import './_timber-prebuilt-source.js'
-${hasManifestInit ? "import './_timber-manifest-init.js'\n" : ""}import handler, { runWithWaitUntil, runWithWorkersCachePurge } from '${rscEntryRelative}'
-${hasWorkerHandlers ? "import * as workerHandlers from './_worker-handlers.js'\n" : ""}
-
-// Bind Cloudflare env to ALS so getCloudflareBindings() works at runtime.
-// Uses the same Symbol.for key as getCloudflareBindings() reads from.
-const ALS_KEY = Symbol.for('timber:cf-bindings-als')
-let bindingsAls = globalThis[ALS_KEY]
-if (!bindingsAls) {
-  bindingsAls = new AsyncLocalStorage()
-  globalThis[ALS_KEY] = bindingsAls
-}
-
-// 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.
-    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
-    }
-
-    // Bridge ctx.cache into the per-request ALS so WorkersCachePurge can
-    // call ctx.cache.purge({ tags }) during cache.invalidate/revalidateTag.
-    // Workers Cache is available on all Cloudflare plans — no API token needed.
-    const workersCacheCtx = ctx.cache && typeof ctx.cache.purge === 'function' ? ctx.cache : null
-    const runHandler = () =>
-      runWithWaitUntil((promise) => ctx.waitUntil(promise), () => handler(request))
-    const response = await bindingsAls.run(env, () =>
-      workersCacheCtx
-        ? runWithWorkersCachePurge(workersCacheCtx, runHandler)
-        : runHandler()
-    )
-
-    // 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
-  }
-}
-`;
-}
-/**
-* Discover and read 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");
-	let manifestJson;
-	try {
-		manifestJson = await readFile(join(prebuiltDir, "manifest.json"), "utf-8");
-	} catch {
-		return null;
-	}
-	const payloads = [];
-	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")) {
-				const filePath = `${dir.name}/${file}`;
-				const bytes = await readFile(join(prebuiltDir, filePath));
-				payloads.push({
-					file: filePath,
-					bytes
-				});
-			}
-		}
-	} catch {}
-	return {
-		manifestJson,
-		payloads
-	};
-}
-/**
-* Generate the prebuilt payload source module for Cloudflare Workers.
-*
-* Inlines manifest JSON and flight payload bytes directly into the module
-* so they're part of the worker's JS bundle — no external Text/Data module
-* imports needed. This avoids depending on wrangler's find_additional_modules
-* to discover non-JS files, which doesn't reliably resolve Text/Data imports.
-*
-* @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 entries = [];
-	for (const { file, bytes } of data.payloads) {
-		const b64 = bytes.toString("base64");
-		entries.push(`  ${JSON.stringify(file)}: ${JSON.stringify(b64)}`);
-	}
-	return `// Generated by @timber-js/app/adapters/cloudflare
-// Prebuilt payload source — inlines cache.component flight payloads
-// directly into the worker bundle (TIM-1162).
-const _manifest = ${data.manifestJson.trim()}
-
-function _decode(b64) {
-  const bin = atob(b64)
-  const buf = new Uint8Array(bin.length)
-  for (let i = 0; i < bin.length; i++) buf[i] = bin.charCodeAt(i)
-  return buf
-}
-
-const _payloads = {
-${entries.join(",\n")}
-}
-
-globalThis.__TIMBER_PREBUILT_SOURCE__ = {
-  async loadManifest() { return _manifest },
-  async readPayload(file) {
-    const b64 = _payloads[file]
-    return b64 ? _decode(b64) : null
-  },
-}
-`;
-}
-/**
-* Generate the runtime init module that sets TIMBER_RUNTIME before the
-* RSC entry evaluates. Imported as a side-effect module in _worker.js.
-*
-* @internal Exported for testing.
-*/
-function generateRuntimeInitModule() {
-	return `// Generated by @timber-js/app/adapters/cloudflare
-// Sets TIMBER_RUNTIME before the RSC handler evaluates (TIM-1170).
-// Must be a separate module imported before rsc/index.js so that ESM
-// evaluation order guarantees the env var is set when
-// createRequestHandler() runs its auto-wire logic.
-globalThis.process ??= { env: {} }
-process.env.TIMBER_RUNTIME = 'cloudflare'
-`;
-}
-/**
-* Convert declarative `CloudflareBindings` into wrangler.jsonc binding sections.
-*
-* Maps:
-* - `kv`             → `kv_namespaces`
-* - `d1`             → `d1_databases`
-* - `r2`             → `r2_buckets`
-* - `queues`         → `queues` (producers + consumers)
-* - `durableObjects` → `durable_objects`
-*
-* Empty arrays are omitted from the output.
-*
-* @internal Exported for testing.
-*/
-function generateBindingsConfig(bindings) {
-	if (!bindings) return {};
-	const result = {};
-	if (bindings.kv && bindings.kv.length > 0) result.kv_namespaces = bindings.kv.map((kv) => ({
-		binding: kv.name,
-		id: kv.id ?? ""
-	}));
-	if (bindings.d1 && bindings.d1.length > 0) result.d1_databases = bindings.d1.map((d1) => ({
-		binding: d1.name,
-		database_id: d1.database_id
-	}));
-	if (bindings.r2 && bindings.r2.length > 0) result.r2_buckets = bindings.r2.map((r2) => ({
-		binding: r2.name,
-		bucket_name: r2.bucket_name
-	}));
-	if (bindings.queues) {
-		const queues = {};
-		if (bindings.queues.producers && bindings.queues.producers.length > 0) queues.producers = bindings.queues.producers.map((p) => ({
-			binding: p.name,
-			queue: p.queue
-		}));
-		if (bindings.queues.consumers && bindings.queues.consumers.length > 0) queues.consumers = bindings.queues.consumers.map((c) => {
-			const consumer = { queue: c.queue };
-			if (c.max_batch_size !== void 0) consumer.max_batch_size = c.max_batch_size;
-			if (c.max_retries !== void 0) consumer.max_retries = c.max_retries;
-			if (c.dead_letter_queue !== void 0) consumer.dead_letter_queue = c.dead_letter_queue;
-			return consumer;
-		});
-		if (Object.keys(queues).length > 0) result.queues = queues;
-	}
-	if (bindings.durableObjects && bindings.durableObjects.length > 0) result.durable_objects = { bindings: bindings.durableObjects.map((dobj) => {
-		const entry = {
-			name: dobj.name,
-			class_name: dobj.class_name
-		};
-		if (dobj.script_name) entry.script_name = dobj.script_name;
-		return entry;
-	}) };
-	return result;
-}
-/**
-* One-level deep merge: for each key in `override`, if both the base and
-* override values are plain objects (not arrays, not null), merge their
-* keys with override winning on conflicts. Everything else (primitives,
-* arrays, null) is replaced outright — matching the intuitive behavior
-* where `kv_namespaces: [...]` replaces fully but
-* `durable_objects: { migrations }` merges with generated `bindings`.
-*/
-function shallowDeepMerge(base, override) {
-	const result = { ...base };
-	for (const key of Object.keys(override)) {
-		const baseVal = result[key];
-		const overVal = override[key];
-		if (isPlainObject(baseVal) && isPlainObject(overVal)) result[key] = {
-			...baseVal,
-			...overVal
-		};
-		else result[key] = overVal;
-	}
-	return result;
-}
-/** True for `{}` literals — false for arrays, null, Date, etc. */
-function isPlainObject(val) {
-	return val !== null && typeof val === "object" && !Array.isArray(val);
-}
-/** @internal Exported for testing. */
-function generateWranglerConfig(config, options) {
-	const base = {
-		name: "timber-app",
-		main: "_worker.js",
-		compatibility_date: options.compatibilityDate ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
-		compatibility_flags: options.compatibilityFlags ?? ["nodejs_compat"],
-		no_bundle: true,
-		find_additional_modules: true,
-		rules: [{
-			type: "ESModule",
-			globs: ["**/*.js"]
-		}],
-		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);
-	return merged;
-}
-/** @internal Exported for testing. */
-function generatePreviewCommand(buildDir) {
-	const cfDir = join(buildDir, "cloudflare");
-	return {
-		command: "wrangler",
-		args: [
-			"dev",
-			"--local",
-			"--config",
-			join(cfDir, "wrangler.jsonc")
-		],
-		cwd: cfDir
-	};
-}
-/**
-* Spawn a long-running preview process and pipe stdio to the parent.
-* Resolves when the process exits.
-*/
-function spawnPreviewProcess(command, args, cwd) {
-	return new Promise((resolve, reject) => {
-		const child = execFile(command, args, { cwd }, (err) => {
-			if (err) reject(err);
-			else resolve();
-		});
-		child.stdout?.pipe(process.stdout);
-		child.stderr?.pipe(process.stderr);
-	});
-}
-//#endregion
-export { cloudflare, generateBindingsConfig, generatePrebuiltSourceModule, generatePreviewCommand, generateRuntimeInitModule, generateWorkerEntry, generateWranglerConfig, getCloudflareBindings, readPrebuiltData, runWithBindings };
-
-//# sourceMappingURL=cloudflare.js.map
+import { a as generateRuntimeInitModule, c as getCloudflareBindings, d as runWithBindings, i as generatePreviewCommand, l as readPrebuiltData, n as generateBindingsConfig, o as generateWorkerEntry, r as generatePrebuiltSourceModule, s as generateWranglerConfig, t as cloudflare, u as readUserWranglerConfig } from "../_chunks/cloudflare-AHoWYTYr.js";
+export { cloudflare, generateBindingsConfig, generatePrebuiltSourceModule, generatePreviewCommand, generateRuntimeInitModule, generateWorkerEntry, generateWranglerConfig, getCloudflareBindings, readPrebuiltData, readUserWranglerConfig, runWithBindings };

package/dist/adapters/nitro.js

@@ -1,7 +1,7 @@
 import { n as IMMUTABLE_CACHE, t as runSharedBuildSteps } from "../_chunks/build-output-helper-DF5uScqS.js";
+import { transformWithOxc } from "vite";
 import { basename, dirname, join, relative } from "node:path";
 import { cp, glob, readFile, writeFile } from "node:fs/promises";
-import { transformWithOxc } from "vite";
 import { execFile } from "node:child_process";
 //#region src/server/compress.ts?raw
 var compress_default = "// Response compression for self-hosted deployments (dev server, Nitro preview).\n//\n// Uses CompressionStream (Web Platform API) for gzip. Brotli is intentionally\n// left to CDNs and reverse proxies — at streaming-friendly quality levels its\n// ratio advantage is marginal, and node:zlib's brotli transform buffers output\n// internally, breaking streaming. Cloudflare Workers auto-compress at the edge —\n// this module is only used on Node.js/Bun.\n//\n// See design/25-production-deployments.md.\n\n// ─── Constants ────────────────────────────────────────────────────────────\n\n/**\n * MIME types that benefit from compression.\n * text/* is handled via prefix matching; these are the specific\n * application/* and image/* types that are compressible.\n */\nexport const COMPRESSIBLE_TYPES = new Set([\n  'text/html',\n  'text/css',\n  'text/plain',\n  'text/xml',\n  'text/javascript',\n  'text/x-component',\n  'application/json',\n  'application/javascript',\n  'application/xml',\n  'application/xhtml+xml',\n  'application/rss+xml',\n  'application/atom+xml',\n  'image/svg+xml',\n]);\n\n/**\n * Status codes that should never be compressed (no body or special semantics).\n */\nconst NO_COMPRESS_STATUSES = new Set([204, 304]);\n\n// ─── Encoding Negotiation ─────────────────────────────────────────────────\n\n/**\n * Parse Accept-Encoding and return the best supported encoding.\n * Returns 'gzip' if the client accepts it, null otherwise.\n *\n * Brotli (br) is intentionally not handled at the application level.\n * At the streaming-friendly quality levels (0–4), brotli's compression\n * ratio advantage over gzip is marginal, and node:zlib's brotli transform\n * buffers output internally — turning smooth streaming responses into\n * large infrequent bursts. Brotli's real wins come from offline/static\n * compression at higher quality levels (5–11), which CDNs and reverse\n * proxies (Cloudflare, nginx, Caddy) apply on cached responses.\n *\n * See design/25-production-deployments.md.\n */\nexport function negotiateEncoding(acceptEncoding: string): 'gzip' | null {\n  if (!acceptEncoding) return null;\n\n  // Parse tokens with quality values from the Accept-Encoding header.\n  // Per RFC 9110 §12.5.3, q=0 means \"not acceptable\" — the client explicitly\n  // rejects that encoding. Tokens without a q-value default to q=1.\n  // e.g. \"gzip;q=1.0, br;q=0\" → gzip is acceptable, br is rejected.\n  const parts = acceptEncoding.split(',');\n  for (const part of parts) {\n    const [token, ...params] = part.split(';');\n    const name = token.trim().toLowerCase();\n    if (name !== 'gzip') continue;\n\n    // Check for q=0 (explicitly disabled)\n    let qValue = 1; // default quality is 1\n    for (const param of params) {\n      const trimmed = param.trim().toLowerCase();\n      if (trimmed.startsWith('q=')) {\n        qValue = parseFloat(trimmed.slice(2));\n        if (Number.isNaN(qValue)) qValue = 1;\n        break;\n      }\n    }\n\n    if (qValue > 0) return 'gzip';\n  }\n\n  return null;\n}\n\n// ─── Compressibility Check ────────────────────────────────────────────────\n\n/**\n * Determine if a response should be compressed.\n *\n * Returns false for:\n * - Responses without a body (204, 304, null body)\n * - Already-encoded responses (Content-Encoding set)\n * - Non-compressible content types (images, binary)\n * - SSE streams (text/event-stream — must not be buffered)\n */\nexport function shouldCompress(response: Response): boolean {\n  // No body to compress\n  if (!response.body) return false;\n  if (NO_COMPRESS_STATUSES.has(response.status)) return false;\n\n  // Already compressed\n  if (response.headers.has('Content-Encoding')) return false;\n\n  // Check content type\n  const contentType = response.headers.get('Content-Type');\n  if (!contentType) return false;\n\n  // Extract the MIME type (strip charset and other parameters)\n  const mimeType = contentType.split(';')[0].trim().toLowerCase();\n\n  // SSE must not be compressed — it relies on chunk-by-chunk delivery\n  if (mimeType === 'text/event-stream') return false;\n\n  return COMPRESSIBLE_TYPES.has(mimeType);\n}\n\n// ─── Compression ──────────────────────────────────────────────────────────\n\n/**\n * Compress a Web Response if the client supports it and the content is compressible.\n *\n * Returns the original response unchanged if compression is not applicable.\n * Returns a new Response with the compressed body, Content-Encoding, and Vary headers.\n *\n * The body is piped through a compression stream — no buffering of the full response.\n * This preserves streaming behavior for HTML shell + deferred Suspense chunks.\n */\nexport function compressResponse(request: Request, response: Response): Response {\n  // Check if response is compressible\n  if (!shouldCompress(response)) return response;\n\n  // Negotiate encoding with the client\n  const acceptEncoding = request.headers.get('Accept-Encoding') ?? '';\n  const encoding = negotiateEncoding(acceptEncoding);\n  if (!encoding) return response;\n\n  // Compress the body stream with gzip via the Web Platform CompressionStream API.\n  const compressedBody = compressWithGzip(response.body!);\n\n  // Build new headers: copy originals, add compression headers, remove Content-Length\n  // (compressed size is unknown until streaming completes).\n  const headers = new Headers(response.headers);\n  headers.set('Content-Encoding', encoding);\n  headers.delete('Content-Length');\n\n  // Append to Vary header (preserve existing Vary values)\n  const existingVary = headers.get('Vary');\n  if (existingVary) {\n    if (!existingVary.toLowerCase().includes('accept-encoding')) {\n      headers.set('Vary', `${existingVary}, Accept-Encoding`);\n    }\n  } else {\n    headers.set('Vary', 'Accept-Encoding');\n  }\n\n  return new Response(compressedBody, {\n    status: response.status,\n    statusText: response.statusText,\n    headers,\n  });\n}\n\n// ─── Gzip (node:zlib with Z_SYNC_FLUSH) ──────────────────────────────────\n//\n// Uses node:zlib's createGzip with Z_SYNC_FLUSH so each chunk is flushed\n// to the output immediately. The Web Platform CompressionStream API buffers\n// internally and does NOT flush per-chunk — this kills streaming because\n// the browser doesn't receive the HTML shell until the gzip stream closes\n// (i.e. after all Suspense boundaries resolve).\n//\n// Z_SYNC_FLUSH adds ~2–5% size overhead vs Z_NO_FLUSH but preserves\n// correct streaming behavior: the shell renders instantly, Suspense\n// fallbacks are visible immediately, and streamed content appears\n// progressively.\n\nimport { createGzip, constants } from 'node:zlib';\nimport { Readable, pipeline } from 'node:stream';\n\n/**\n * Compress a ReadableStream with gzip, flushing each chunk immediately.\n *\n * Uses node:zlib's createGzip with Z_SYNC_FLUSH to ensure each HTML chunk\n * (shell, Suspense resolution, RSC payload) is delivered to the browser\n * as soon as it's available — preserving streaming semantics.\n */\nfunction compressWithGzip(body: ReadableStream<Uint8Array>): ReadableStream<Uint8Array> {\n  const gzip = createGzip({ flush: constants.Z_SYNC_FLUSH });\n  const nodeInput = Readable.fromWeb(body as import('stream/web').ReadableStream);\n\n  // pipeline() instead of bare pipe(): pipe() does not forward source errors,\n  // so an erroring body (streaming route handler, dropped upstream fetch)\n  // would emit an unhandled 'error' event and crash the process. pipeline()\n  // destroys gzip on source error — the returned web stream rejects — and\n  // tears down nodeInput when the consumer cancels the web stream, which\n  // cancels the source body via fromWeb. The error reaches the consumer\n  // through the web stream; the callback only marks it handled at the Node\n  // layer.\n  pipeline(nodeInput, gzip, () => {});\n\n  return Readable.toWeb(gzip) as ReadableStream<Uint8Array>;\n}\n";

package/dist/adapters/types.d.ts

@@ -3,6 +3,8 @@
  * A subset of the resolved timber.config.ts relevant to adapters.
  */
 export interface TimberConfig {
+    /** Absolute path to the project root (Vite root). */
+    root?: string;
     output: 'server' | 'static';
     clientJavascriptDisabled?: boolean;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE;;;OAGG;IACH,OAAO,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;;;;;;;OASG;IACH,cAAc,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACxC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE;;;OAGG;IACH,OAAO,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;;;;;;;OASG;IACH,cAAc,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACxC"}

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

@@ -1,26 +1,48 @@
 import type { CacheOptions } from './index';
 import type { PrebuiltComponentOptions } from '../server/prebuilt-runtime';
 /**
- * Public caching API: `cache(fn, opts)`.
- *
- * Wraps an async function with cross-request caching. Uses the configured
- * cache handler (defaults to MemoryCacheHandler, overridable via timber.config.ts).
+ * Cache namespace — `cache.data`, `cache.component`, `cache.invalidate`.
  *
  * ```ts
  * import { cache } from '@timber-js/app/cache';
  *
- * const getUser = cache(
+ * const getUser = cache.data(
  *   async (id: string) => db.users.findUnique({ where: { id } }),
  *   { ttl: 60, tags: (id) => [`user:${id}`] }
  * );
  * ```
  */
-export declare function cache<Fn extends (...args: any[]) => Promise<any>>(fn: Fn, opts: CacheOptions<Fn>, stableId?: string): Fn;
-export declare namespace cache {
-    var invalidate: (opts: {
+export declare const cache: {
+    /**
+     * Wrap an async function with cross-request caching.
+     *
+     * The configured cache handler (defaults to MemoryCacheHandler, overridable
+     * via timber.config.ts) is re-resolved on every call, so module-scope
+     * wrappers created before `setCacheHandler()` still pick up the configured
+     * handler (TIM-1029).
+     */
+    data<Fn extends (...args: any[]) => Promise<any>>(fn: Fn, opts: CacheOptions<Fn>, stableId?: string): Fn;
+    /**
+     * Invalidate cache entries by tag or key.
+     *
+     * ```ts
+     * cache.invalidate({ tag: 'products' });
+     * cache.invalidate({ key: 'user:abc' });
+     * ```
+     */
+    invalidate(opts: {
         key?: string;
         tag?: string;
-    }) => Promise<void>;
-    var component: <C extends (props: any) => unknown>(componentFn: C, _options?: PrebuiltComponentOptions) => C;
-}
+    }): Promise<void>;
+    /**
+     * Runtime fallback for `cache.component(...)` callsites the timber-prebuilt
+     * transform does not rewrite — nested/computed/argument-position forms (see
+     * plugins/prebuilt.ts). Only module-scope `const X = cache.component(...)`
+     * declarations are transformed and eligible for prebuilding; everything else
+     * lands here, warns once per component, and renders dynamically. Same
+     * safety-net pattern as the data cache's runtime fnId fallback (TIM-1054):
+     * an untraceable callsite degrades in performance, never in correctness.
+     */
+    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;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"}
+{"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;AAS3E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,KAAK;IAChB;;;;;;;OAOG;SAEE,EAAE,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,MAC1C,EAAE,QACA,YAAY,CAAC,EAAE,CAAC,aACX,MAAM,GAChB,EAAE;IAIL;;;;;;;OAOG;qBACoB;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCrE;;;;;;;;OAQG;cAEO,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,eAC5B,CAAC,aACH,wBAAwB,GAClC,CAAC;CAYL,CAAC"}

package/dist/cache/index.js

@@ -1,3 +1,3 @@
-import { _ as setDefaultSingleflightTimeout, f as MemoryCacheHandler, g as setCacheHandler, h as getCacheHandler, m as RedisCacheHandler, p as TagAwareCacheHandler, t as cache } from "../_chunks/cache-api-eb1gydM7.js";
+import { _ as setDefaultSingleflightTimeout, f as MemoryCacheHandler, g as setCacheHandler, h as getCacheHandler, m as RedisCacheHandler, p as TagAwareCacheHandler, t as cache } from "../_chunks/cache-api-DzpQQOEx.js";
 import { t as estimateByteSize } from "../_chunks/sizeof-lXffQ1Vr.js";
 export { MemoryCacheHandler, RedisCacheHandler, TagAwareCacheHandler, cache, estimateByteSize, getCacheHandler, setCacheHandler, setDefaultSingleflightTimeout };

package/dist/cli.js

@@ -79,7 +79,7 @@ function resolvePreviewStrategy(adapter) {
 * Vite preview. See TIM-1066.
 */
 async function runPreview(options, _deps) {
-	const { loadTimberConfigFile, resolveBuildDir } = await import("./_chunks/plugin-context-BnaiU_cF.js").then((n) => n.i);
+	const { loadTimberConfigFile, resolveBuildDir } = await import("./_chunks/plugin-context---kTF5v8.js").then((n) => n.i);
 	const root = process.cwd();
 	const config = loadTimberConfigFile(root);
 	const adapter = config?.adapter;
@@ -115,7 +115,7 @@ async function runCheck(options) {
 async function runSchema(args) {
 	const subcommand = args[0];
 	if (subcommand !== "sync") throw new Error(`Unknown schema subcommand: ${subcommand ?? "(none)"}. Usage: timber schema sync`);
-	const { runSchemaSync, defaultCodecForSegment } = await import("./_chunks/cli-schema-sync-mGfRbjh2.js").then((n) => n.t);
+	const { runSchemaSync, defaultCodecForSegment } = await import("./_chunks/cli-schema-sync-wX-i90Og.js").then((n) => n.t);
 	const result = runSchemaSync(process.cwd());
 	if (result.filesystemSegments.length === 0) {
 		console.log("[timber] No dynamic segments found in app/.");

package/dist/client/browser-entry/post-hydration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"post-hydration.d.ts","sourceRoot":"","sources":["../../../src/client/browser-entry/post-hydration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAGpE,UAAU,oBAAoB;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,gBAAgB,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACjD,oEAAoE;IACpE,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,gBAAgB,EAChB,cAAc,GACf,EAAE,oBAAoB,GAAG,IAAI,CAsE7B"}
+{"version":3,"file":"post-hydration.d.ts","sourceRoot":"","sources":["../../../src/client/browser-entry/post-hydration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAGpE,UAAU,oBAAoB;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,gBAAgB,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACjD,oEAAoE;IACpE,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,gBAAgB,EAChB,cAAc,GACf,EAAE,oBAAoB,GAAG,IAAI,CA6E7B"}