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

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/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-DygSeKCB.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

@@ -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-EXGYPhI2.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"}

package/dist/client/history.d.ts

@@ -1,3 +1,4 @@
+import type { SegmentInfo } from './segment-cache';
 export interface HistoryEntry {
     /** The complete segment tree payload at the time of navigation */
     payload: unknown;
@@ -8,6 +9,15 @@ export interface HistoryEntry {
      * and revalidation overwrites preserve the current state (TIM-1037).
      */
     params?: Record<string, string | string[]> | null;
+    /**
+     * Segment metadata for this page's route. Restored into the segment cache
+     * on popstate cached replay so the next forward navigation computes a
+     * correct state tree. Without this, the segment cache retains the
+     * *previous* page's segments after back-button, causing the server to
+     * skip segments that aren't mounted — and the partial payload targets
+     * a non-existent outlet.
+     */
+    segmentInfo?: SegmentInfo[] | null;
 }
 /**
  * Session-lived history stack keyed by URL. Enables instant back/forward

package/dist/client/history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/client/history.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;CACnD;AAID;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAmC;IAElD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAI5C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI1C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAG1B"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/client/history.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IAClD;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;CACpC;AAID;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAmC;IAElD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAI5C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI1C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAG1B"}