@timber-js/app 0.2.0-alpha.208 → 0.2.0-alpha.209

package/dist/_chunks/{build-output-helper-9dqCv1pZ.js → build-output-helper-RV_BRcF1.js}

@@ -1,5 +1,5 @@
 import { i as withBasePath } from "./base-path-DaQrzbez.js";
-import { c as USER_PLATFORM_DIR, i as HEADERS_FILE, n as detectFsIdentity, r as fsKey, s as USER_MERGED_PLATFORM_FILES } from "./fs-identity-D7vb6GdI.js";
+import { c as USER_PLATFORM_DIR, i as HEADERS_FILE, n as detectFsIdentity, r as fsKey, s as USER_MERGED_PLATFORM_FILES } from "./fs-identity-BRKuL215.js";
 import { basename, join, relative } from "node:path";
 import { cp, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
 //#region src/adapters/shared.ts
@@ -10,7 +10,7 @@ import { cp, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
 * by callers that predate it (a hand-written adapter, a test harness). Falling
 * back to `'/'` reproduces the pre-TIM-1274 output exactly, which is correct
 * for the only deployments those callers can have: a build under a non-root
-* base always goes through `plugins/adapter-build.ts`, which populates it.
+* base always goes through `plugins/post-build.ts`, which populates it.
 *
 * Typed structurally rather than as `TimberConfig` so this module keeps no
 * import of `./types.js` at runtime.
@@ -29,7 +29,9 @@ var STATIC_CACHE = "public, max-age=3600, must-revalidate";
 * Static Assets, Cloudflare Pages, and Netlify. It maps URL patterns to
 * HTTP response headers.
 *
-* Only hashed (immutable) asset paths are listed here by default. When
+* The build's content-hashed directories (`immutableDirs`, recorded on
+* `BuildArtifacts` by the phases that hashed them) get one wildcard rule
+* each. 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
@@ -48,11 +50,11 @@ var STATIC_CACHE = "public, max-age=3600, must-revalidate";
 * Cloudflare Workers Static Assets without one.
 *
 * The prefix is applied at exactly one point, `rulePath()`, which every rule
-* in this function goes through. Prefixing the three wildcards and
+* in this function goes through. Prefixing the wildcards and
 * hand-checking that the per-file rules agree is how the next rule gets
 * missed.
 */
-var MAX_PER_FILE_RULES = 97;
+var MAX_RULES = 100;
 /**
 * Count the rules in a `_headers` file — a rule is a path line, which is any
 * line that is neither blank, a comment, nor an indented header.
@@ -105,7 +107,7 @@ function patternsOverlap(a, b) {
 	if (pb !== null && (a.startsWith(pb) || pb === "")) return true;
 	return false;
 }
-function generateHeadersFile({ base, unhashedPaths, contentTypes, userRules }) {
+function generateHeadersFile({ base, immutableDirs, unhashedPaths, contentTypes, userRules }) {
 	/** Route-space rule path → deployed-URL rule path. */
 	const rulePath = (path) => withBasePath(base, path);
 	const userRuleList = userRules ? parseHeaderRules(userRules) : [];
@@ -130,15 +132,12 @@ function generateHeadersFile({ base, unhashedPaths, contentTypes, userRules }) {
 	let content = `# Auto-generated by @timber-js/app — static asset cache headers.
 # See design/25-production-deployments.md §"CDN / Edge Cache"
 `;
-	for (const path of [
-		"/assets/*",
-		"/_timber/fonts/*",
-		"/_rsc/*"
-	]) content += emit(rulePath(path), "Cache-Control", IMMUTABLE_CACHE);
+	for (const dir of immutableDirs) content += emit(rulePath(`/${dir}/*`), "Cache-Control", IMMUTABLE_CACHE);
+	const maxPerFileRules = MAX_RULES - immutableDirs.length;
 	const allCtEntries = contentTypes ? Object.entries(contentTypes).sort(([a], [b]) => a.localeCompare(b)) : [];
-	const ctEntries = allCtEntries.slice(0, MAX_PER_FILE_RULES);
-	if (allCtEntries.length > MAX_PER_FILE_RULES) console.warn(`[timber] _headers: ${allCtEntries.length} content-type rules exceed Cloudflare's 100-rule limit. Only the first ${MAX_PER_FILE_RULES} extensionless API routes will get Content-Type headers.`);
-	const remainingBudget = MAX_PER_FILE_RULES - ctEntries.length;
+	const ctEntries = allCtEntries.slice(0, maxPerFileRules);
+	if (allCtEntries.length > maxPerFileRules) console.warn(`[timber] _headers: ${allCtEntries.length} content-type rules exceed Cloudflare's 100-rule limit. Only the first ${maxPerFileRules} extensionless API routes will get Content-Type headers.`);
+	const remainingBudget = maxPerFileRules - ctEntries.length;
 	if (unhashedPaths && unhashedPaths.length > 0) {
 		const capped = unhashedPaths.slice(0, Math.max(0, remainingBudget));
 		if (unhashedPaths.length > remainingBudget) console.warn(`[timber] _headers: ${unhashedPaths.length} unhashed static files + ${ctEntries.length} content-type rules found, but Cloudflare limits _headers to 100 rules. Only the first ${capped.length} unhashed files will get Cache-Control headers.`);
@@ -150,7 +149,7 @@ function generateHeadersFile({ base, unhashedPaths, contentTypes, userRules }) {
 	if (userRules && userRules.trim() !== "") {
 		content += `\n# User-authored rules from public/_headers\n\n${userRules.trim()}\n`;
 		const total = countHeaderRules(content);
-		if (total > 100) console.warn(`[timber] _headers: ${total} rules after merging public/_headers, over Cloudflare's 100-rule limit. Rules past the limit are dropped by the platform — remove some, or move static assets under a directory the wildcard rules already cover.`);
+		if (total > MAX_RULES) console.warn(`[timber] _headers: ${total} rules after merging public/_headers, over Cloudflare's ${MAX_RULES}-rule limit. Rules past the limit are dropped by the platform — remove some, or move static assets under a directory the wildcard rules already cover.`);
 	}
 	return content;
 }
@@ -168,11 +167,11 @@ function generateHeadersFile({ base, unhashedPaths, contentTypes, userRules }) {
 * Returns the resolved public directory path for further adapter-specific use.
 */
 async function runSharedBuildSteps(opts) {
-	const { config, buildDir, outDir, publicDirName } = opts;
+	const { config, artifacts, outDir, publicDirName } = opts;
 	await mkdir(outDir, { recursive: true });
-	const clientDir = join(buildDir, "client");
 	const publicDir = join(outDir, publicDirName);
 	await mkdir(publicDir, { recursive: true });
+	const clientDir = artifacts.client.path;
 	const referencedWasm = await findReferencedWasm(clientDir);
 	await cp(clientDir, publicDir, {
 		recursive: true,
@@ -181,18 +180,12 @@ async function runSharedBuildSteps(opts) {
 			if (config.clientJavascriptDisabled && src.endsWith(".js")) return false;
 			return true;
 		}
-	}).catch((e) => {
-		if (e.code !== "ENOENT") throw e;
 	});
-	await writeHeadersFile(publicDir, config, await findUnhashedStaticFiles(publicDir));
-	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;
-	});
-	await cp(join(buildDir, "prebuilt"), join(outDir, "prebuilt"), { recursive: true }).catch((e) => {
-		if (e.code !== "ENOENT") throw e;
-	});
-	if (config.manifestInit) await writeFile(join(outDir, "_timber-manifest-init.js"), config.manifestInit);
+	await writeHeadersFile(publicDir, config, artifacts);
+	await cp(artifacts.rsc.path, join(outDir, "rsc"), { recursive: true });
+	await cp(artifacts.ssr.path, join(outDir, "ssr"), { recursive: true });
+	if (artifacts.prebuilt) await cp(artifacts.prebuilt.path, join(outDir, "prebuilt"), { recursive: true });
+	if (artifacts.manifestInit) await writeFile(join(outDir, "_timber-manifest-init.js"), artifacts.manifestInit);
 	return publicDir;
 }
 /**
@@ -200,9 +193,16 @@ async function runSharedBuildSteps(opts) {
 * Cache-Control rules in the `_headers` file.
 *
 * Excludes:
-* - Files under `assets/` and `_timber/` (covered by wildcard rules)
+* - Files under the build's `immutableDirs` (covered by wildcard rules)
+* - Files under `rsc/` and `ssr/` (server bundles, never served)
 * - Underscore-prefixed files (`_headers`, `_worker.js`, etc.)
 *
+* Ordered for the rule cap: well-known metadata files, then everything
+* else, then files under an underscore-prefixed directory — the
+* framework's own output (unhashed RSC payloads in a static build with
+* client JavaScript disabled, which nothing fetches). Those can number one
+* per route, and must not take the budget from the app's real files.
+*
 * @internal Exported for testing.
 */
 var PRIORITY_FILES = /* @__PURE__ */ new Set([
@@ -213,7 +213,7 @@ var PRIORITY_FILES = /* @__PURE__ */ new Set([
 	"/manifest.webmanifest",
 	"/apple-touch-icon.png"
 ]);
-async function findUnhashedStaticFiles(publicDir) {
+async function findUnhashedStaticFiles(publicDir, immutableDirs) {
 	let files;
 	try {
 		files = await collectFiles(publicDir);
@@ -222,16 +222,22 @@ async function findUnhashedStaticFiles(publicDir) {
 	}
 	const priority = [];
 	const rest = [];
+	const framework = [];
 	for (const file of files) {
 		const rel = relative(publicDir, file).replace(/\\/g, "/");
-		if (rel.startsWith("assets/") || rel.startsWith("_timber/")) continue;
-		if (rel.startsWith("rsc/") || rel.startsWith("ssr/") || rel.startsWith("_rsc/")) continue;
+		if (immutableDirs.some((dir) => rel.startsWith(`${dir}/`))) continue;
+		if (rel.startsWith("rsc/") || rel.startsWith("ssr/")) continue;
 		if (basename(rel).startsWith("_")) continue;
 		const urlPath = "/" + rel;
 		if (PRIORITY_FILES.has(urlPath)) priority.push(urlPath);
+		else if (rel.startsWith("_")) framework.push(urlPath);
 		else rest.push(urlPath);
 	}
-	return [...priority.sort(), ...rest.sort()];
+	return [
+		...priority.sort(),
+		...rest.sort(),
+		...framework.sort()
+	];
 }
 /**
 * Scan client JS files for references to .wasm filenames.
@@ -240,12 +246,7 @@ async function findUnhashedStaticFiles(publicDir) {
 */
 async function findReferencedWasm(clientDir) {
 	const referenced = /* @__PURE__ */ new Set();
-	let files;
-	try {
-		files = await collectFiles(clientDir);
-	} catch {
-		return referenced;
-	}
+	const files = await collectFiles(clientDir);
 	const jsFiles = files.filter((f) => f.endsWith(".js"));
 	const wasmFiles = files.filter((f) => f.endsWith(".wasm")).map((f) => basename(f));
 	if (wasmFiles.length === 0) return referenced;
@@ -260,7 +261,7 @@ async function findReferencedWasm(clientDir) {
 * assets and pre-rendered HTML/RSC/API files into `outDir/publicDirName`.
 * Used by both Cloudflare and Nitro adapters in `output: 'static'` mode.
 */
-async function buildStaticDirectoryOutput(config, buildDir, outDir, publicDirName) {
+async function buildStaticDirectoryOutput(config, artifacts, outDir, publicDirName) {
 	await rm(outDir, {
 		recursive: true,
 		force: true
@@ -268,20 +269,15 @@ async function buildStaticDirectoryOutput(config, buildDir, outDir, publicDirNam
 	await mkdir(outDir, { recursive: true });
 	const publicDir = join(outDir, publicDirName);
 	await mkdir(publicDir, { recursive: true });
-	const clientDir = join(buildDir, "client");
-	await cp(clientDir, publicDir, {
+	await cp(artifacts.client.path, publicDir, {
 		recursive: true,
 		filter: (src) => {
 			if (config.clientJavascriptDisabled && src.endsWith(".js")) return false;
 			return true;
 		}
-	}).catch((e) => {
-		if (e.code !== "ENOENT") throw e;
 	});
-	if (config.staticPagesDir) {
-		await assertNoTreeCollision(config.staticPagesDir, publicDir);
-		await cp(config.staticPagesDir, publicDir, { recursive: true });
-	}
+	await assertNoTreeCollision(artifacts.pages.path, publicDir);
+	await cp(artifacts.pages.path, publicDir, { recursive: true });
 }
 /**
 * Write the `_headers` file, folding in the user's `public/_headers`.
@@ -308,12 +304,13 @@ async function buildStaticDirectoryOutput(config, buildDir, outDir, publicDirNam
 *
 * @internal Exported for testing.
 */
-async function writeHeadersFile(dir, config, unhashedPaths) {
+async function writeHeadersFile(dir, config, artifacts) {
 	const userRules = await readUserPlatformFile(config.root, HEADERS_FILE);
 	await writeFile(join(dir, HEADERS_FILE), generateHeadersFile({
 		base: adapterBase(config),
-		unhashedPaths,
-		contentTypes: config.staticContentTypes,
+		immutableDirs: artifacts.immutableDirs,
+		unhashedPaths: await findUnhashedStaticFiles(dir, artifacts.immutableDirs),
+		contentTypes: artifacts.output === "static" ? artifacts.contentTypes : void 0,
 		userRules: userRules ?? void 0
 	}));
 }
@@ -365,6 +362,6 @@ async function collectFiles(dir) {
 	return result;
 }
 //#endregion
-export { IMMUTABLE_CACHE as a, writeHeadersFile as i, findUnhashedStaticFiles as n, runSharedBuildSteps as r, buildStaticDirectoryOutput as t };
+export { STATIC_CACHE as a, IMMUTABLE_CACHE as i, runSharedBuildSteps as n, adapterBase as o, writeHeadersFile as r, buildStaticDirectoryOutput as t };
 
-//# sourceMappingURL=build-output-helper-9dqCv1pZ.js.map
+//# sourceMappingURL=build-output-helper-RV_BRcF1.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-output-helper-RV_BRcF1.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// ../shared/ is exempt: it is dependency-free by the same rule.\n\nimport { withBasePath } from '../shared/base-path.ts';\n\n/**\n * The deployment base an adapter should write platform rules against.\n *\n * `config.base` is optional on `TimberConfig` because adapters can be invoked\n * by callers that predate it (a hand-written adapter, a test harness). Falling\n * back to `'/'` reproduces the pre-TIM-1274 output exactly, which is correct\n * for the only deployments those callers can have: a build under a non-root\n * base always goes through `plugins/post-build.ts`, which populates it.\n *\n * Typed structurally rather than as `TimberConfig` so this module keeps no\n * import of `./types.js` at runtime.\n */\nexport function adapterBase(config: { base?: string }): string {\n  return config.base ?? '/';\n}\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 * The build's content-hashed directories (`immutableDirs`, recorded on\n * `BuildArtifacts` by the phases that hashed them) get one wildcard rule\n * each. 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 * **Every rule path is written in deployed-URL space** (TIM-1274). The\n * platform matches these patterns against the request path, which under a\n * non-root `base` sits below the prefix: with `base: '/repo/'` the assets are\n * at `/repo/assets/*`, so a rule saying `/assets/*` matches nothing. Silent\n * for the cache rules (slower, still correct) and not silent for the\n * Content-Type rules — an extensionless API route output is unreadable on\n * Cloudflare Workers Static Assets without one.\n *\n * The prefix is applied at exactly one point, `rulePath()`, which every rule\n * in this function goes through. Prefixing the wildcards and\n * hand-checking that the per-file rules agree is how the next rule gets\n * missed.\n */\n// Cloudflare Workers Static Assets caps _headers at 100 rules. The wildcard\n// rules for the immutable directories come out of the same budget.\nconst MAX_RULES = 100;\n\nexport interface HeadersFileOptions {\n  /**\n   * The deployment base, already normalized by `normalizeBasePath()` —\n   * leading and trailing slash, `'/'` at the domain root.\n   *\n   * Required rather than defaulted: a caller that forgets it would emit\n   * root-relative rules that match nothing, which is the bug this closes.\n   */\n  base: string;\n  /**\n   * Content-hashed directories, from `BuildArtifacts.immutableDirs`. Each\n   * gets an immutable `Cache-Control` wildcard rule.\n   */\n  immutableDirs: readonly string[];\n  /** Unhashed static files (route-space paths) needing per-file cache rules. */\n  unhashedPaths?: string[];\n  /** Route-space path → Content-Type, for extensionless API route outputs. */\n  contentTypes?: Record<string, string>;\n  /**\n   * Verbatim contents of the user's `public/_headers`, appended after the\n   * generated rules. See `mergeUserHeaders` for why it goes last.\n   */\n  userRules?: string;\n}\n\n/**\n * Count the rules in a `_headers` file — a rule is a path line, which is any\n * line that is neither blank, a comment, nor an indented header.\n *\n * @internal Exported for testing.\n */\nexport function countHeaderRules(content: string): number {\n  return content\n    .split('\\n')\n    .filter((line) => line.trim() !== '' && !line.startsWith('#') && !/^\\s/.test(line)).length;\n}\n\n/** One `_headers` block: a path pattern and the headers it sets. */\nexport interface HeaderRule {\n  pattern: string;\n  headers: Array<{ name: string; value: string }>;\n}\n\n/**\n * Parse a `_headers` file. A non-indented, non-comment line opens a rule; the\n * indented `Name: value` lines beneath it belong to that rule.\n *\n * @internal Exported for testing.\n */\nexport function parseHeaderRules(content: string): HeaderRule[] {\n  const rules: HeaderRule[] = [];\n  for (const raw of content.split('\\n')) {\n    const line = raw.replace(/\\r$/, '');\n    if (line.trim() === '' || line.trimStart().startsWith('#')) continue;\n    if (/^\\s/.test(line)) {\n      const current = rules[rules.length - 1];\n      if (!current) continue; // header with no rule above it — not ours to fix\n      const colon = line.indexOf(':');\n      if (colon === -1) continue;\n      current.headers.push({\n        name: line.slice(0, colon).trim(),\n        value: line.slice(colon + 1).trim(),\n      });\n    } else {\n      rules.push({ pattern: line.trim(), headers: [] });\n    }\n  }\n  return rules;\n}\n\n/**\n * Whether a user pattern can match paths a generated pattern also matches.\n *\n * Deliberately narrow: equality, or a prefix-glob (`/x/*`, `/*`) whose literal\n * prefix contains the other's. Anything cleverer risks claiming an overlap\n * that is not there, and the only thing this drives is a warning — a false\n * positive is noise a developer cannot act on.\n */\nfunction patternsOverlap(a: string, b: string): boolean {\n  if (a === b) return true;\n  const prefixOf = (p: string) => (p.endsWith('*') ? p.slice(0, -1) : null);\n  const [pa, pb] = [prefixOf(a), prefixOf(b)];\n  if (pa !== null && (b.startsWith(pa) || pa === '')) return true;\n  if (pb !== null && (a.startsWith(pb) || pb === '')) return true;\n  return false;\n}\n\nexport function generateHeadersFile({\n  base,\n  immutableDirs,\n  unhashedPaths,\n  contentTypes,\n  userRules,\n}: HeadersFileOptions): string {\n  /** Route-space rule path → deployed-URL rule path. */\n  const rulePath = (path: string) => withBasePath(base, path);\n\n  // Cloudflare and Netlify apply *every* matching rule, so emitting a header\n  // the user also sets on the same path yields two definitions of it — a\n  // comma-joined `Cache-Control` that is invalid per RFC 9111, and neither\n  // side's intent. This module already refuses to emit a `/*` catch-all for\n  // that reason; appending the user's file verbatim reintroduced it through\n  // the back door (TIM-1326).\n  //\n  // An explicit app rule beats a framework default, so where the user names\n  // the same pattern and the same header, ours is dropped. Only exact pattern\n  // matches are resolved this way: silently dropping asset immutability\n  // because a `/*` rule *might* subsume it would be a worse surprise than the\n  // duplicate, so overlapping-but-different patterns warn instead.\n  const userRuleList = userRules ? parseHeaderRules(userRules) : [];\n  const overriddenExactly = new Set(\n    userRuleList.flatMap((rule) =>\n      rule.headers.map((h) => `${rule.pattern}\\0${h.name.toLowerCase()}`)\n    )\n  );\n  const overridden = (pattern: string, header: string) =>\n    overriddenExactly.has(`${pattern}\\0${header.toLowerCase()}`);\n\n  const warnedOverlaps = new Set<string>();\n  const emit = (pattern: string, header: string, value: string): string => {\n    if (overridden(pattern, header)) return '';\n    for (const rule of userRuleList) {\n      if (rule.pattern === pattern) continue;\n      if (!patternsOverlap(rule.pattern, pattern)) continue;\n      for (const h of rule.headers) {\n        if (h.name.toLowerCase() !== header.toLowerCase()) continue;\n        const key = `${rule.pattern}\\0${pattern}\\0${header.toLowerCase()}`;\n        if (warnedOverlaps.has(key)) continue;\n        warnedOverlaps.add(key);\n        console.warn(\n          `[timber] _headers: your rule \"${rule.pattern}\" sets ${header}, which ` +\n            `timber also sets on \"${pattern}\". Cloudflare and Netlify apply both, ` +\n            `so the response gets two ${header} values. Use the exact pattern ` +\n            `\"${pattern}\" to replace timber's rule, or narrow yours so they do ` +\n            `not overlap.`\n        );\n      }\n    }\n    return `\\n${pattern}\\n  ${header}: ${value}\\n`;\n  };\n\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  for (const dir of immutableDirs) {\n    content += emit(rulePath(`/${dir}/*`), 'Cache-Control', IMMUTABLE_CACHE);\n  }\n  const maxPerFileRules = MAX_RULES - immutableDirs.length;\n\n  // Content-Type rules are higher priority than cache headers for\n  // extensionless files — without them the file is unreadable.\n  const allCtEntries = contentTypes\n    ? Object.entries(contentTypes).sort(([a], [b]) => a.localeCompare(b))\n    : [];\n  const ctEntries = allCtEntries.slice(0, maxPerFileRules);\n  if (allCtEntries.length > maxPerFileRules) {\n    console.warn(\n      `[timber] _headers: ${allCtEntries.length} content-type rules exceed ` +\n        `Cloudflare's 100-rule limit. Only the first ${maxPerFileRules} ` +\n        `extensionless API routes will get Content-Type headers.`\n    );\n  }\n  const remainingBudget = maxPerFileRules - ctEntries.length;\n\n  if (unhashedPaths && unhashedPaths.length > 0) {\n    const capped = unhashedPaths.slice(0, Math.max(0, remainingBudget));\n    if (unhashedPaths.length > remainingBudget) {\n      console.warn(\n        `[timber] _headers: ${unhashedPaths.length} unhashed static files + ` +\n          `${ctEntries.length} content-type rules found, but Cloudflare limits ` +\n          `_headers to 100 rules. Only the first ${capped.length} unhashed ` +\n          `files will get Cache-Control headers.`\n      );\n    }\n    // Section bodies are built before their comment header so a section the\n    // user has overridden entirely does not leave a heading over nothing.\n    const body = capped.map((p) => emit(rulePath(p), 'Cache-Control', STATIC_CACHE)).join('');\n    if (body !== '') {\n      content += `\\n# Unhashed static assets — short-lived cache with revalidation\\n${body}`;\n    }\n  }\n\n  const ctBody = ctEntries\n    .map(([urlPath, ct]) => emit(rulePath(urlPath), 'Content-Type', ct))\n    .join('');\n  if (ctBody !== '') {\n    content += `\\n# Content-Type for extensionless API routes\\n${ctBody}`;\n  }\n\n  // User rules last, matching the `_redirects` merge. Their paths are left\n  // verbatim: `_redirects` prefixes the rules it generates because it wrote\n  // them in route space, but these are the user's own text, already authored\n  // against the URLs the site is deployed at.\n  if (userRules && userRules.trim() !== '') {\n    content += `\\n# User-authored rules from public/_headers\\n\\n${userRules.trim()}\\n`;\n\n    const total = countHeaderRules(content);\n    if (total > MAX_RULES) {\n      console.warn(\n        `[timber] _headers: ${total} rules after merging public/_headers, over ` +\n          `Cloudflare's ${MAX_RULES}-rule limit. Rules past the ` +\n          `limit are dropped by the platform — remove some, or move static ` +\n          `assets under a directory the wildcard rules already cover.`\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, rm, readdir, readFile } from 'node:fs/promises';\nimport { join, basename, relative } from 'node:path';\nimport { adapterBase, generateHeadersFile } from './shared.ts';\n// Isomorphic, zero-import module — safe to load from an adapter, which Node's\n// native ESM loader evaluates before Vite's resolver exists. Same precedent as\n// `adapters/shared.ts` importing `../shared/base-path.js`.\nimport {\n  HEADERS_FILE,\n  USER_MERGED_PLATFORM_FILES,\n  USER_PLATFORM_DIR,\n} from '../shared/static-platform-files.ts';\nimport { detectFsIdentity, fsKey } from './fs-identity.ts';\nimport type {\n  BuildArtifacts,\n  ServerBuildArtifacts,\n  StaticBuildArtifacts,\n  TimberConfig,\n} from './types.ts';\n\n/** Options for the shared build output steps. */\nexport interface BuildOutputBaseOptions {\n  /** Resolved timber config. */\n  config: TimberConfig;\n  /** What the build produced. */\n  artifacts: ServerBuildArtifacts;\n  /** Adapter-specific output directory (e.g. `.timber/dist/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, artifacts, 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 publicDir = join(outDir, publicDirName);\n  await mkdir(publicDir, { recursive: true });\n  const clientDir = artifacts.client.path;\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  });\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  await writeHeadersFile(publicDir, config, artifacts);\n\n  // 4. Copy RSC + SSR server bundles into the output directory. The RSC\n  // bundle imports the SSR one by a path the RSC plugin computed between the\n  // two *build* directories, which the build names `rsc/` and `ssr/` as\n  // siblings (index.ts); deploying them under the same names keeps it valid.\n  await cp(artifacts.rsc.path, join(outDir, 'rsc'), { recursive: true });\n  await cp(artifacts.ssr.path, join(outDir, 'ssr'), { recursive: true });\n\n  // 4b. Copy prebuilt/ flight payloads (cache.component artifacts). These\n  // are produced by the post-build capture pass (design/44) and read at\n  // request time via the adapter's PrebuiltPayloadSource.\n  if (artifacts.prebuilt) {\n    await cp(artifacts.prebuilt.path, join(outDir, 'prebuilt'), { recursive: true });\n  }\n\n  // 5. Write manifest-init module if present.\n  if (artifacts.manifestInit) {\n    await writeFile(join(outDir, '_timber-manifest-init.js'), artifacts.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 the build's `immutableDirs` (covered by wildcard rules)\n * - Files under `rsc/` and `ssr/` (server bundles, never served)\n * - Underscore-prefixed files (`_headers`, `_worker.js`, etc.)\n *\n * Ordered for the rule cap: well-known metadata files, then everything\n * else, then files under an underscore-prefixed directory — the\n * framework's own output (unhashed RSC payloads in a static build with\n * client JavaScript disabled, which nothing fetches). Those can number one\n * per route, and must not take the budget from the app's real files.\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(\n  publicDir: string,\n  immutableDirs: readonly string[]\n): 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  const framework: string[] = [];\n  for (const file of files) {\n    const rel = relative(publicDir, file).replace(/\\\\/g, '/');\n    if (immutableDirs.some((dir) => rel.startsWith(`${dir}/`))) continue;\n    if (rel.startsWith('rsc/') || rel.startsWith('ssr/')) continue;\n    if (basename(rel).startsWith('_')) continue;\n    const urlPath = '/' + rel;\n    if (PRIORITY_FILES.has(urlPath)) {\n      priority.push(urlPath);\n    } else if (rel.startsWith('_')) {\n      framework.push(urlPath);\n    } else {\n      rest.push(urlPath);\n    }\n  }\n\n  return [...priority.sort(), ...rest.sort(), ...framework.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  const files = await collectFiles(clientDir);\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\n/**\n * Build a static-only output directory (no server entry). Copies client\n * assets and pre-rendered HTML/RSC/API files into `outDir/publicDirName`.\n * Used by both Cloudflare and Nitro adapters in `output: 'static'` mode.\n */\nexport async function buildStaticDirectoryOutput(\n  config: TimberConfig,\n  artifacts: StaticBuildArtifacts,\n  outDir: string,\n  publicDirName: string\n): Promise<void> {\n  // Clean stale artifacts from prior builds (e.g. server-mode builds that\n  // left rsc/, ssr/, _worker.js in the outDir). Without this, a static\n  // build after a server build inherits 140+ unused server chunks.\n  await rm(outDir, { recursive: true, force: true }).catch(() => {});\n  await mkdir(outDir, { recursive: true });\n\n  const publicDir = join(outDir, publicDirName);\n  await mkdir(publicDir, { recursive: true });\n\n  // Copy client assets (JS, CSS, fonts, images).\n  await cp(artifacts.client.path, publicDir, {\n    recursive: true,\n    filter: (src: string) => {\n      if (config.clientJavascriptDisabled && src.endsWith('.js')) return false;\n      return true;\n    },\n  });\n\n  // Copy pre-rendered static pages (HTML + RSC flight + API routes).\n  //\n  // This is the one place the build merges two independently-produced trees\n  // into a single directory, and `cp` resolves an overlap by overwriting with\n  // no diagnostic — the deployment then contains one of the two artifacts and\n  // nothing recorded which. Refuse instead (TIM-1266).\n  await assertNoTreeCollision(artifacts.pages.path, publicDir);\n  await cp(artifacts.pages.path, publicDir, { recursive: true });\n}\n\n/**\n * Write the `_headers` file, folding in the user's `public/_headers`.\n *\n * Every adapter used to `writeFile` a generated `_headers` over whatever\n * Vite had copied out of `public/`, so an app shipping its own CSP, CORS, or\n * cache rules deployed without them and without a word (TIM-1326). The\n * generated rules and the user's are not competitors — they address different\n * paths — so this merges rather than refusing, the way `_redirects` has since\n * TIM-1249.\n *\n * **Read from the project, not the output.** The generated file lands under\n * the same name in the output directory, and `runSharedBuildSteps` does not\n * clean `outDir`; a reader aimed there would fold the previous build's\n * generated rules back in and compound them on every rebuild — the defect\n * this pass fixed for `_redirects`.\n *\n * User rules go last. On Cloudflare and Netlify a `_headers` file applies\n * every matching rule, so appending means the user's rules take effect; where\n * a platform resolves a conflict in favour of the earlier rule instead, the\n * framework keeps the paths it owns and the user keeps the rest. Under either\n * reading this is no worse than the previous behaviour, which was to drop the\n * user's rules entirely.\n *\n * @internal Exported for testing.\n */\nexport async function writeHeadersFile(\n  dir: string,\n  config: TimberConfig,\n  artifacts: BuildArtifacts\n): Promise<void> {\n  const userRules = await readUserPlatformFile(config.root, HEADERS_FILE);\n  await writeFile(\n    join(dir, HEADERS_FILE),\n    generateHeadersFile({\n      base: adapterBase(config),\n      immutableDirs: artifacts.immutableDirs,\n      // Scanned from the directory being deployed, which holds everything\n      // the platform will serve from it.\n      unhashedPaths: await findUnhashedStaticFiles(dir, artifacts.immutableDirs),\n      contentTypes: artifacts.output === 'static' ? artifacts.contentTypes : undefined,\n      userRules: userRules ?? undefined,\n    })\n  );\n}\n\n/**\n * Read a user-authored platform file from the project's `public/` directory.\n * Returns null when the project has none, or when no root is configured —\n * a caller without a root cannot locate the project at all, and inventing\n * one from `process.cwd()` would read a different project's file.\n */\nasync function readUserPlatformFile(\n  root: string | undefined,\n  name: string\n): Promise<string | null> {\n  if (!root) return null;\n  try {\n    return await readFile(join(root, USER_PLATFORM_DIR, name), 'utf-8');\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Throw if copying `srcDir` over `destDir` would overwrite an existing file.\n *\n * Compared against the destination **as it stands**, not against the other\n * source tree: the first copy is filtered (client JS is dropped when client\n * JavaScript is disabled), so the files that are actually there are the only\n * ones a second copy can clobber.\n *\n * @internal Exported for testing.\n */\nexport async function assertNoTreeCollision(srcDir: string, destDir: string): Promise<void> {\n  const [srcFiles, destFiles, identity] = await Promise.all([\n    collectFiles(srcDir).catch(() => [] as string[]),\n    collectFiles(destDir).catch(() => [] as string[]),\n    // `cp` will resolve these paths the way the destination filesystem does,\n    // so the comparison predicting it has to as well: on macOS a hand-written\n    // `public/About/index.html` and a generated `about/index.html` are one\n    // file, and an exact-string set waves the overwrite through (TIM-1266).\n    detectFsIdentity(destDir),\n  ]);\n\n  const key = (p: string) => fsKey(p, identity);\n  const existing = new Set(destFiles.map((f) => key(relative(destDir, f).replace(/\\\\/g, '/'))));\n  const exempt = new Set(USER_MERGED_PLATFORM_FILES.map(key));\n  const collisions = srcFiles\n    .map((f) => relative(srcDir, f).replace(/\\\\/g, '/'))\n    .filter((rel) => existing.has(key(rel)) && !exempt.has(key(rel)))\n    .sort();\n\n  if (collisions.length === 0) return;\n\n  throw new Error(\n    `[timber] Build output: ${collisions.length} file(s) in the pre-rendered site ` +\n      `collide with files already in the output directory. Copying would silently ` +\n      `overwrite them — a generated page and a file in public/ cannot share a path:\\n` +\n      collisions.map((c) => `  - ${c}`).join('\\n')\n  );\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/_chunks/{cache-api-CUD9Ezaq.js → cache-api-CR23J_NC.js}

@@ -1,10 +1,33 @@
-import { D as getWaitUntil } from "./primitives-DLAnvsrk.js";
-import { _ as addSpanEventSync, d as logSwrRefetchFailed, h as swallow } from "./logger-k2DQ4EUf.js";
+import { l as waitUntilAls } from "./als-registry-DaxkVjt5.js";
+import { E as addSpanEventSync, _ as swallow, p as logSwrRefetchFailed } from "./logger-DiDt5ppH.js";
 import { t as fnv1aHash } from "./fast-hash-C-tVYrLb.js";
-import { n as createSingleflight } from "./singleflight-2lUWfcAk.js";
-import { t as estimateByteSize } from "./sizeof-lXffQ1Vr.js";
-import { t as warnLossyJsonValue } from "./json-lossy-check-ClNvBM_3.js";
+import { n as createSingleflight } from "./singleflight-BeVMMKi0.js";
+import { t as estimateByteSize } from "./sizeof-UwzwB1uM.js";
+import { t as warnLossyJsonValue } from "./json-lossy-check-ip0Qi0MT.js";
 import { t as getCdnPurgeHandler } from "./purge-store-Byr8XOjU.js";
+//#region src/server/waituntil-bridge.ts
+/**
+* Per-request waitUntil bridge — ALS bridge for platform adapters.
+*
+* The generated entry point (Nitro, Cloudflare) wraps the handler with
+* `runWithWaitUntil`, binding the platform's lifecycle extension function
+* (e.g., h3's `event.waitUntil()` or CF's `ctx.waitUntil()`) for the
+* request duration. The `waitUntil()` primitive reads from this ALS to
+* dispatch background work to the correct platform API.
+*
+* Design doc: design/11-platform.md §"waitUntil()"
+*/
+/**
+* Get the current request's waitUntil function, if available.
+*
+* Returns undefined when no platform adapter has installed a waitUntil
+* handler for the current request (e.g., on platforms that don't support
+* lifecycle extension, or outside a request context).
+*/
+function getWaitUntil() {
+	return waitUntilAls.getStore();
+}
+//#endregion
 //#region src/cache/stable-stringify.ts
 /**
 * Deterministic JSON serialization with sorted object keys.
@@ -479,10 +502,22 @@ var RedisCacheHandler = class {
 var DATA_PREFIX = "d:";
 var TAG_SET_PREFIX = "ts:";
 var TAG_VERSION_PREFIX = "tv:";
+function isNativeStore(store) {
+	return !!(store.setWithTags && store.invalidateTag);
+}
+function isEagerStore(store) {
+	return !!(store.sadd && store.smembers && store.srem && store.sdel);
+}
 function detectStrategy(store) {
-	if (store.setWithTags && store.invalidateTag) return "native";
-	if (store.sadd && store.smembers && store.srem && store.sdel) return "eager";
-	return "lazy";
+	if (isNativeStore(store)) return {
+		kind: "native",
+		store
+	};
+	if (isEagerStore(store)) return {
+		kind: "eager",
+		store
+	};
+	return { kind: "lazy" };
 }
 var TagAwareCacheHandler = class {
 	store;
@@ -512,7 +547,7 @@ var TagAwareCacheHandler = class {
 	async get(key) {
 		const raw = await this.store.get(this.dataKey(key));
 		if (raw === null) return null;
-		if (this.strategy === "native" || this.strategy === "eager") {
+		if (this.strategy.kind !== "lazy") {
 			const entry = JSON.parse(raw);
 			const stale = Date.now() > entry.expiresAt;
 			return {
@@ -536,25 +571,26 @@ var TagAwareCacheHandler = class {
 	}
 	async set(key, value, opts) {
 		const physicalTtl = Math.max(opts.ttl * 2 + 60, 120);
-		if (this.strategy === "native") {
+		const strategy = this.strategy;
+		if (strategy.kind === "native") {
 			const entry = {
 				value,
 				expiresAt: Date.now() + opts.ttl * 1e3,
 				tags: opts.tags
 			};
 			const payload = JSON.stringify(entry);
-			if (opts.tags.length > 0) await this.store.setWithTags(this.dataKey(key), payload, physicalTtl, this.prefixTags(opts.tags));
+			if (opts.tags.length > 0) await strategy.store.setWithTags(this.dataKey(key), payload, physicalTtl, this.prefixTags(opts.tags));
 			else await this.store.set(this.dataKey(key), payload, physicalTtl);
 			return;
 		}
-		if (this.strategy === "eager") {
+		if (strategy.kind === "eager") {
 			const entry = {
 				value,
 				expiresAt: Date.now() + opts.ttl * 1e3,
 				tags: opts.tags
 			};
 			await this.store.set(this.dataKey(key), JSON.stringify(entry), physicalTtl);
-			if (opts.tags.length > 0) await Promise.all(opts.tags.map((tag) => this.store.sadd(this.tagSetKey(tag), [key], physicalTtl)));
+			if (opts.tags.length > 0) await Promise.all(opts.tags.map((tag) => strategy.store.sadd(this.tagSetKey(tag), [key], physicalTtl)));
 			return;
 		}
 		const tagVersions = opts.tags.length > 0 ? await this.getTagVersions(opts.tags) : {};
@@ -567,31 +603,27 @@ var TagAwareCacheHandler = class {
 		await this.store.set(this.dataKey(key), JSON.stringify(entry), physicalTtl);
 	}
 	async invalidate(opts) {
+		const strategy = this.strategy;
 		if (opts.key) {
-			if (this.strategy === "eager") {
-				const raw = await this.store.get(this.dataKey(opts.key));
+			const key = opts.key;
+			if (strategy.kind === "eager") {
+				const raw = await this.store.get(this.dataKey(key));
 				if (raw !== null) {
 					const entry = JSON.parse(raw);
-					if (entry.tags.length > 0) await Promise.all(entry.tags.map((tag) => this.store.srem(this.tagSetKey(tag), [opts.key])));
+					if (entry.tags.length > 0) await Promise.all(entry.tags.map((tag) => strategy.store.srem(this.tagSetKey(tag), [key])));
 				}
 			}
-			await this.store.del(this.dataKey(opts.key));
+			await this.store.del(this.dataKey(key));
 		}
 		if (opts.tag) {
 			const tag = opts.tag;
-			if (this.strategy === "native") await this.store.invalidateTag(`${this.prefix}${tag}`);
-			else if (this.strategy === "eager") {
-				const members = await this.store.smembers(this.tagSetKey(tag));
+			if (strategy.kind === "native") await strategy.store.invalidateTag(`${this.prefix}${tag}`);
+			else if (strategy.kind === "eager") {
+				const members = await strategy.store.smembers(this.tagSetKey(tag));
 				await Promise.all(members.map(async (k) => {
 					const raw = await this.store.get(this.dataKey(k));
-					if (raw === null) {
-						await this.store.srem(this.tagSetKey(tag), [k]);
-						return;
-					}
-					if (JSON.parse(raw).tags.includes(tag)) {
-						await this.store.del(this.dataKey(k));
-						await this.store.srem(this.tagSetKey(tag), [k]);
-					} else await this.store.srem(this.tagSetKey(tag), [k]);
+					if (raw !== null && JSON.parse(raw).tags.includes(tag)) await this.store.del(this.dataKey(k));
+					await strategy.store.srem(this.tagSetKey(tag), [k]);
 				}));
 			} else await this.bumpTagVersion(opts.tag);
 		}
@@ -729,8 +761,8 @@ var DEPLOYMENT_ID_HEADER = "X-Timber-Deployment-Id";
 /** Response header that signals the client to do a full page reload. */
 var RELOAD_HEADER = "X-Timber-Reload";
 /**
-* The current build's deployment ID. Set at startup from the manifest init
-* module (globalThis.__TIMBER_DEPLOYMENT_ID__). Null in dev mode.
+* The current build's deployment ID. Set at startup from the runtime config
+* (`virtual:timber-config`'s `deploymentId`). Null in dev mode.
 */
 var currentDeploymentId = null;
 /**
@@ -1145,6 +1177,6 @@ var cache = {
 	}
 };
 //#endregion
-export { setDefaultSingleflightTimeout as _, getManifestEntry as a, wasInvalidatedSince as b, lookupPrebuiltPayload as c, checkVersionSkew as d, MemoryCacheHandler as f, setCacheHandler as g, getCacheHandler as h, storeOverlayEntry as i, setPrebuiltPayloadSource as l, RedisCacheHandler as m, lookupOverlay as n, hasPrebuiltPayloadSource as o, TagAwareCacheHandler as p, overlayKey as r, isParamIndependent as s, cache as t, applyReloadHeaders as u, currentInvalidationEpoch as v, lastInvalidationEpochFor as y };
+export { setDefaultSingleflightTimeout as _, getManifestEntry as a, wasInvalidatedSince as b, lookupPrebuiltPayload as c, checkVersionSkew as d, MemoryCacheHandler as f, setCacheHandler as g, getCacheHandler as h, storeOverlayEntry as i, setPrebuiltPayloadSource as l, RedisCacheHandler as m, lookupOverlay as n, hasPrebuiltPayloadSource as o, TagAwareCacheHandler as p, overlayKey as r, isParamIndependent as s, cache as t, applyReloadHeaders as u, currentInvalidationEpoch as v, getWaitUntil as x, lastInvalidationEpochFor as y };
 
-//# sourceMappingURL=cache-api-CUD9Ezaq.js.map
+//# sourceMappingURL=cache-api-CR23J_NC.js.map