vinext 0.0.53 → 0.0.55

package/dist/server/server-action-not-found.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-action-not-found.js","names":["SERVER_ACTION_NOT_FOUND_HEADER"],"sources":["../../src/server/server-action-not-found.ts"],"sourcesContent":["import { NEXTJS_ACTION_NOT_FOUND_HEADER as SERVER_ACTION_NOT_FOUND_HEADER } from \"./headers.js\";\nimport { UnrecognizedActionError } from \"vinext/shims/unrecognized-action-error\";\n\nconst SERVER_ACTION_NOT_FOUND_DOCS =\n  \"https://nextjs.org/docs/messages/failed-to-find-server-action\";\nconst SERVER_ACTION_NOT_FOUND_BODY = \"Server action not found.\";\n\nfunction getServerActionNotFoundPrefix(actionId: string | null): string {\n  return `Failed to find Server Action${actionId ? ` \"${actionId}\"` : \"\"}.`;\n}\n\nexport function getServerActionNotFoundMessage(actionId: string | null): string {\n  return `${getServerActionNotFoundPrefix(\n    actionId,\n  )} This request might be from an older or newer deployment.\\nRead more: ${SERVER_ACTION_NOT_FOUND_DOCS}`;\n}\n\nfunction getServerActionNotFoundClientMessage(actionId: string): string {\n  return `Server Action \"${actionId}\" was not found on the server. \\nRead more: ${SERVER_ACTION_NOT_FOUND_DOCS}`;\n}\n\nfunction getUnknownMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  return typeof error === \"string\" ? error : \"\";\n}\n\nexport function isServerActionNotFoundError(error: unknown, actionId: string | null): boolean {\n  const message = getUnknownMessage(error);\n  if (!message) {\n    return false;\n  }\n\n  if (actionId && message.startsWith(getServerActionNotFoundPrefix(actionId))) {\n    return true;\n  }\n\n  if (!actionId && message.startsWith(\"Failed to find Server Action\")) {\n    return true;\n  }\n\n  // `@vitejs/plugin-rsc` raises two different \"no such server reference\"\n  // errors depending on the build mode. Both mean the same thing — the\n  // referenced server action id isn't in the runtime manifest — and must\n  // surface as Next.js' 404 + action-not-found header rather than a generic\n  // 500. The progressive (no-JS) path also hits this in `decodeAction(body)`\n  // before it has any actionId in hand, so match these patterns whether or\n  // not the caller has resolved an action id from request headers.\n  //\n  //  - dev:  `[vite-rsc] invalid server reference '<id>'` (from the reference\n  //          validation virtual module loaded ahead of dynamic import)\n  //  - prod: `server reference not found '<id>'`         (from the built\n  //          `virtual:vite-rsc/server-references` lookup, including the case\n  //          where the build has no server actions at all)\n  //\n  // See: @vitejs/plugin-rsc dist/rsc.js (`server reference not found`) and\n  // dist/plugin-*.js (`[vite-rsc] invalid <type> reference`).\n  if (actionId) {\n    if (message.includes(`[vite-rsc] invalid server reference '${actionId}'`)) {\n      return true;\n    }\n    if (message.includes(`server reference not found '${actionId}'`)) {\n      return true;\n    }\n    return false;\n  }\n\n  return (\n    /\\[vite-rsc] invalid server reference '/.test(message) ||\n    /server reference not found '/.test(message)\n  );\n}\n\nexport function createServerActionNotFoundResponse(): Response {\n  return new Response(SERVER_ACTION_NOT_FOUND_BODY, {\n    status: 404,\n    headers: {\n      [SERVER_ACTION_NOT_FOUND_HEADER]: \"1\",\n      \"content-type\": \"text/plain\",\n    },\n  });\n}\n\nfunction isServerActionNotFoundResponse(response: Pick<Response, \"headers\">): boolean {\n  return response.headers.get(SERVER_ACTION_NOT_FOUND_HEADER) === \"1\";\n}\n\n/**\n * Throw an `UnrecognizedActionError` when the server reported the requested\n * server action id as unknown (the `x-nextjs-action-not-found` response\n * header); otherwise return so the caller can keep processing the response.\n *\n * The client-side counterpart of `createServerActionNotFoundResponse`. The\n * typed error lets client `catch` blocks call the public\n * `unstable_isUnrecognizedActionError` predicate to detect client/server\n * deployment skew and recover (typically by reloading the page).\n *\n * Mirrors Next.js, whose server-action reducer throws `UnrecognizedActionError`\n * on this same response header:\n * https://github.com/vercel/next.js/blob/canary/packages/next/src/client/components/router-reducer/reducers/server-action-reducer.ts\n */\nexport function throwOnServerActionNotFound(\n  response: Pick<Response, \"headers\">,\n  actionId: string,\n): void {\n  if (isServerActionNotFoundResponse(response)) {\n    throw new UnrecognizedActionError(getServerActionNotFoundClientMessage(actionId));\n  }\n}\n"],"mappings":";;;AAGA,MAAM,+BACJ;AACF,MAAM,+BAA+B;AAErC,SAAS,8BAA8B,UAAiC;CACtE,OAAO,+BAA+B,WAAW,KAAK,SAAS,KAAK,GAAG;;AAGzE,SAAgB,+BAA+B,UAAiC;CAC9E,OAAO,GAAG,8BACR,SACD,CAAC,wEAAwE;;AAG5E,SAAS,qCAAqC,UAA0B;CACtE,OAAO,kBAAkB,SAAS,8CAA8C;;AAGlF,SAAS,kBAAkB,OAAwB;CACjD,IAAI,iBAAiB,OACnB,OAAO,MAAM;CAGf,OAAO,OAAO,UAAU,WAAW,QAAQ;;AAG7C,SAAgB,4BAA4B,OAAgB,UAAkC;CAC5F,MAAM,UAAU,kBAAkB,MAAM;CACxC,IAAI,CAAC,SACH,OAAO;CAGT,IAAI,YAAY,QAAQ,WAAW,8BAA8B,SAAS,CAAC,EACzE,OAAO;CAGT,IAAI,CAAC,YAAY,QAAQ,WAAW,+BAA+B,EACjE,OAAO;CAmBT,IAAI,UAAU;EACZ,IAAI,QAAQ,SAAS,wCAAwC,SAAS,GAAG,EACvE,OAAO;EAET,IAAI,QAAQ,SAAS,+BAA+B,SAAS,GAAG,EAC9D,OAAO;EAET,OAAO;;CAGT,OACE,yCAAyC,KAAK,QAAQ,IACtD,+BAA+B,KAAK,QAAQ;;AAIhD,SAAgB,qCAA+C;CAC7D,OAAO,IAAI,SAAS,8BAA8B;EAChD,QAAQ;EACR,SAAS;IACNA,iCAAiC;GAClC,gBAAgB;GACjB;EACF,CAAC;;AAGJ,SAAS,+BAA+B,UAA8C;CACpF,OAAO,SAAS,QAAQ,IAAIA,+BAA+B,KAAK;;;;;;;;;;;;;;;;AAiBlE,SAAgB,4BACd,UACA,UACM;CACN,IAAI,+BAA+B,SAAS,EAC1C,MAAM,IAAI,wBAAwB,qCAAqC,SAAS,CAAC"}
+{"version":3,"file":"server-action-not-found.js","names":["SERVER_ACTION_NOT_FOUND_HEADER"],"sources":["../../src/server/server-action-not-found.ts"],"sourcesContent":["import { NEXTJS_ACTION_NOT_FOUND_HEADER as SERVER_ACTION_NOT_FOUND_HEADER } from \"./headers.js\";\nimport { UnrecognizedActionError } from \"vinext/shims/unrecognized-action-error\";\n\nconst SERVER_ACTION_NOT_FOUND_DOCS =\n  \"https://nextjs.org/docs/messages/failed-to-find-server-action\";\nconst SERVER_ACTION_NOT_FOUND_BODY = \"Server action not found.\";\n\nfunction getServerActionNotFoundPrefix(actionId: string | null): string {\n  return `Failed to find Server Action${actionId ? ` \"${actionId}\"` : \"\"}.`;\n}\n\nexport function getServerActionNotFoundMessage(actionId: string | null): string {\n  return `${getServerActionNotFoundPrefix(\n    actionId,\n  )} This request might be from an older or newer deployment.\\nRead more: ${SERVER_ACTION_NOT_FOUND_DOCS}`;\n}\n\nfunction getServerActionNotFoundClientMessage(actionId: string): string {\n  return `Server Action \"${actionId}\" was not found on the server. \\nRead more: ${SERVER_ACTION_NOT_FOUND_DOCS}`;\n}\n\nfunction getUnknownMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  return typeof error === \"string\" ? error : \"\";\n}\n\nexport function isServerActionNotFoundError(error: unknown, actionId: string | null): boolean {\n  const message = getUnknownMessage(error);\n  if (!message) {\n    return false;\n  }\n\n  if (actionId && message.startsWith(getServerActionNotFoundPrefix(actionId))) {\n    return true;\n  }\n\n  if (!actionId && message.startsWith(\"Failed to find Server Action\")) {\n    return true;\n  }\n\n  // `@vitejs/plugin-rsc` raises two different \"no such server reference\"\n  // errors depending on the build mode. Both mean the same thing — the\n  // referenced server action id isn't in the runtime manifest — and must\n  // surface as Next.js' 404 + action-not-found header rather than a generic\n  // 500. The progressive (no-JS) path also hits this in `decodeAction(body)`\n  // before it has any actionId in hand, so match these patterns whether or\n  // not the caller has resolved an action id from request headers.\n  //\n  //  - dev:  `[vite-rsc] invalid server reference '<id>'` (from the reference\n  //          validation virtual module loaded ahead of dynamic import)\n  //  - prod: `server reference not found '<id>'`         (from the built\n  //          `virtual:vite-rsc/server-references` lookup, including the case\n  //          where the build has no server actions at all)\n  //\n  // See: @vitejs/plugin-rsc dist/rsc.js (`server reference not found`) and\n  // dist/plugin-*.js (`[vite-rsc] invalid <type> reference`).\n  //\n  // Action ids resolved from request headers carry the `#<exportName>` suffix\n  // (e.g. `/app/foo.ts#bar`), but `loadServerAction(id)` strips that suffix\n  // before calling `requireModule(file)`. The dev-mode validator therefore\n  // emits the module path WITHOUT the `#<exportName>` — so we also check the\n  // pre-`#` portion to match either shape (#1340).\n  if (actionId) {\n    const moduleId = actionId.split(\"#\")[0];\n    if (\n      message.includes(`[vite-rsc] invalid server reference '${actionId}'`) ||\n      (moduleId &&\n        moduleId !== actionId &&\n        message.includes(`[vite-rsc] invalid server reference '${moduleId}'`))\n    ) {\n      return true;\n    }\n    if (\n      message.includes(`server reference not found '${actionId}'`) ||\n      (moduleId &&\n        moduleId !== actionId &&\n        message.includes(`server reference not found '${moduleId}'`))\n    ) {\n      return true;\n    }\n    return false;\n  }\n\n  return (\n    /\\[vite-rsc] invalid server reference '/.test(message) ||\n    /server reference not found '/.test(message)\n  );\n}\n\nexport function createServerActionNotFoundResponse(): Response {\n  return new Response(SERVER_ACTION_NOT_FOUND_BODY, {\n    status: 404,\n    headers: {\n      [SERVER_ACTION_NOT_FOUND_HEADER]: \"1\",\n      \"content-type\": \"text/plain\",\n    },\n  });\n}\n\nfunction isServerActionNotFoundResponse(response: Pick<Response, \"headers\">): boolean {\n  return response.headers.get(SERVER_ACTION_NOT_FOUND_HEADER) === \"1\";\n}\n\n/**\n * Throw an `UnrecognizedActionError` when the server reported the requested\n * server action id as unknown (the `x-nextjs-action-not-found` response\n * header); otherwise return so the caller can keep processing the response.\n *\n * The client-side counterpart of `createServerActionNotFoundResponse`. The\n * typed error lets client `catch` blocks call the public\n * `unstable_isUnrecognizedActionError` predicate to detect client/server\n * deployment skew and recover (typically by reloading the page).\n *\n * Mirrors Next.js, whose server-action reducer throws `UnrecognizedActionError`\n * on this same response header:\n * https://github.com/vercel/next.js/blob/canary/packages/next/src/client/components/router-reducer/reducers/server-action-reducer.ts\n */\nexport function throwOnServerActionNotFound(\n  response: Pick<Response, \"headers\">,\n  actionId: string,\n): void {\n  if (isServerActionNotFoundResponse(response)) {\n    throw new UnrecognizedActionError(getServerActionNotFoundClientMessage(actionId));\n  }\n}\n"],"mappings":";;;AAGA,MAAM,+BACJ;AACF,MAAM,+BAA+B;AAErC,SAAS,8BAA8B,UAAiC;CACtE,OAAO,+BAA+B,WAAW,KAAK,SAAS,KAAK,GAAG;;AAGzE,SAAgB,+BAA+B,UAAiC;CAC9E,OAAO,GAAG,8BACR,SACD,CAAC,wEAAwE;;AAG5E,SAAS,qCAAqC,UAA0B;CACtE,OAAO,kBAAkB,SAAS,8CAA8C;;AAGlF,SAAS,kBAAkB,OAAwB;CACjD,IAAI,iBAAiB,OACnB,OAAO,MAAM;CAGf,OAAO,OAAO,UAAU,WAAW,QAAQ;;AAG7C,SAAgB,4BAA4B,OAAgB,UAAkC;CAC5F,MAAM,UAAU,kBAAkB,MAAM;CACxC,IAAI,CAAC,SACH,OAAO;CAGT,IAAI,YAAY,QAAQ,WAAW,8BAA8B,SAAS,CAAC,EACzE,OAAO;CAGT,IAAI,CAAC,YAAY,QAAQ,WAAW,+BAA+B,EACjE,OAAO;CAyBT,IAAI,UAAU;EACZ,MAAM,WAAW,SAAS,MAAM,IAAI,CAAC;EACrC,IACE,QAAQ,SAAS,wCAAwC,SAAS,GAAG,IACpE,YACC,aAAa,YACb,QAAQ,SAAS,wCAAwC,SAAS,GAAG,EAEvE,OAAO;EAET,IACE,QAAQ,SAAS,+BAA+B,SAAS,GAAG,IAC3D,YACC,aAAa,YACb,QAAQ,SAAS,+BAA+B,SAAS,GAAG,EAE9D,OAAO;EAET,OAAO;;CAGT,OACE,yCAAyC,KAAK,QAAQ,IACtD,+BAA+B,KAAK,QAAQ;;AAIhD,SAAgB,qCAA+C;CAC7D,OAAO,IAAI,SAAS,8BAA8B;EAChD,QAAQ;EACR,SAAS;IACNA,iCAAiC;GAClC,gBAAgB;GACjB;EACF,CAAC;;AAGJ,SAAS,+BAA+B,UAA8C;CACpF,OAAO,SAAS,QAAQ,IAAIA,+BAA+B,KAAK;;;;;;;;;;;;;;;;AAiBlE,SAAgB,4BACd,UACA,UACM;CACN,IAAI,+BAA+B,SAAS,EAC1C,MAAM,IAAI,wBAAwB,qCAAqC,SAAS,CAAC"}

package/dist/server/skip-cache-proof.d.ts

@@ -1,6 +1,7 @@
 import { ArtifactCompatibilityEnvelope, ArtifactCompatibilityEvaluationOptions } from "./artifact-compatibility.js";
 import { StaticLayoutArtifactReuseDecision } from "./cache-proof.js";
-import { ClientReuseManifestEntry, ClientReuseManifestEntryRejection, ClientReuseManifestSkipDisposition, ClientReuseManifestTraceFields } from "./client-reuse-manifest.js";
+import { ClientReuseManifestEntry, ClientReuseManifestEntryRejection, ClientReuseManifestParseResult, ClientReuseManifestRejection, ClientReuseManifestSkipDisposition, ClientReuseManifestTraceFields } from "./client-reuse-manifest.js";
+import { createStaticLayoutClientReuseArtifactCompatibility, createStaticLayoutClientReusePayloadHash, createStaticLayoutClientReuseRouteId } from "./static-layout-client-reuse-proof.js";
 
 //#region src/server/skip-cache-proof.d.ts
 type SkipCacheInvalidationProof = Readonly<{
@@ -35,7 +36,27 @@ type CrossCheckClientReuseManifestEntryWithCacheInput = Readonly<{
   cacheDecision: StaticLayoutArtifactReuseDecision | null;
   entry: ClientReuseManifestEntry;
 }> & ArtifactCompatibilityEvaluationOptions;
+type ClientReuseSkipTransportPlan = Readonly<{
+  entryRejections: readonly ClientReuseManifestEntryRejection[];
+  kind: "renderAndSend";
+  manifestRejection?: ClientReuseManifestRejection;
+  skipDisposition: ClientReuseManifestSkipDisposition;
+  skipIneligibleEntryIds: readonly string[];
+  skippedEntryIds: readonly string[];
+}> | Readonly<{
+  entryRejections: readonly ClientReuseManifestEntryRejection[];
+  kind: "skip";
+  skipDisposition: ClientReuseManifestSkipDisposition;
+  skipIneligibleEntryIds: readonly string[];
+  skippedEntryIds: readonly string[];
+}>;
+type CreateClientReuseSkipTransportPlanInput = Readonly<{
+  manifest: ClientReuseManifestParseResult;
+  maxWireEntriesToVerify?: number;
+  verifyEntry: (entry: ClientReuseManifestEntry) => SkipCacheCrossCheckResult;
+}>;
 declare function crossCheckClientReuseManifestEntryWithCache(input: CrossCheckClientReuseManifestEntryWithCacheInput): SkipCacheCrossCheckResult;
+declare function createClientReuseSkipTransportPlan(input: CreateClientReuseSkipTransportPlanInput): ClientReuseSkipTransportPlan;
 //#endregion
-export { SkipCacheInvalidationProof, crossCheckClientReuseManifestEntryWithCache };
+export { SkipCacheInvalidationProof, createClientReuseSkipTransportPlan, createStaticLayoutClientReuseArtifactCompatibility, createStaticLayoutClientReusePayloadHash, createStaticLayoutClientReuseRouteId, crossCheckClientReuseManifestEntryWithCache };
 //# sourceMappingURL=skip-cache-proof.d.ts.map

package/dist/server/skip-cache-proof.js

@@ -1,15 +1,7 @@
-import { evaluateArtifactCompatibility } from "./artifact-compatibility.js";
+import { ARTIFACT_COMPATIBILITY_PROOF_FIELDS, evaluateArtifactCompatibility } from "./artifact-compatibility.js";
 import { createClientReusePayloadHash } from "./client-reuse-manifest.js";
+import { createStaticLayoutClientReuseArtifactCompatibility, createStaticLayoutClientReusePayloadHash, createStaticLayoutClientReuseRouteId } from "./static-layout-client-reuse-proof.js";
 //#region src/server/skip-cache-proof.ts
-const ARTIFACT_COMPATIBILITY_PROOF_FIELDS = [
-	"schemaVersion",
-	"graphVersion",
-	"deploymentVersion",
-	"appElementsSchemaVersion",
-	"rscPayloadSchemaVersion",
-	"rootBoundaryId",
-	"renderEpoch"
-];
 function createDisabledSkipDisposition() {
 	return {
 		code: "SKIP_MODEL_DISABLED",
@@ -17,6 +9,14 @@ function createDisabledSkipDisposition() {
 		mode: "renderAndSend"
 	};
 }
+function createStaticLayoutSkipDisposition(skippedEntryIds) {
+	return {
+		code: "SKIP_STATIC_LAYOUT_VERIFIED",
+		enabled: true,
+		mode: "skipStaticLayout",
+		skippedEntryIds: [...skippedEntryIds]
+	};
+}
 function rejectSkipCacheCrossCheck(entry, code, fields = {}) {
 	return {
 		kind: "rejected",
@@ -33,9 +33,31 @@ function collectArtifactCompatibilityProofMismatches(artifactCompatibility, proo
 	for (const field of ARTIFACT_COMPATIBILITY_PROOF_FIELDS) if (artifactCompatibility[field] !== proofCompatibility[field]) mismatchedFields.push(field);
 	return mismatchedFields;
 }
+function isExactArtifactCompatibility(artifactCompatibility, entryCompatibility) {
+	return collectArtifactCompatibilityProofMismatches(artifactCompatibility, entryCompatibility).length === 0;
+}
 function assertNever(value) {
 	throw new Error(`Unhandled skip/cache proof state: ${String(value)}`);
 }
+function createRenderAndSendPlan(options) {
+	return {
+		kind: "renderAndSend",
+		entryRejections: options.entryRejections ?? [],
+		...options.manifestRejection ? { manifestRejection: options.manifestRejection } : {},
+		skipDisposition: createDisabledSkipDisposition(),
+		skipIneligibleEntryIds: options.skipIneligibleEntryIds ?? [],
+		skippedEntryIds: []
+	};
+}
+function createVerificationBudgetExceededRejection(totalWireEntries, maxWireEntriesToVerify) {
+	return {
+		code: "SKIP_VERIFICATION_BUDGET_EXCEEDED",
+		fields: {
+			totalWireEntries,
+			maxWireEntriesToVerify
+		}
+	};
+}
 function crossCheckInvalidationProof(entry, invalidation) {
 	switch (invalidation.kind) {
 		case "valid": return null;
@@ -83,6 +105,7 @@ function crossCheckClientReuseManifestEntryWithCache(input) {
 	});
 	const invalidationRejection = crossCheckInvalidationProof(entry, input.artifact.invalidation);
 	if (invalidationRejection) return invalidationRejection;
+	const skipDisposition = isExactArtifactCompatibility(input.artifact.compatibility, entry.artifactCompatibility) ? createStaticLayoutSkipDisposition([entry.id]) : createDisabledSkipDisposition();
 	return {
 		kind: "verified",
 		code: "SKIP_CACHE_CROSS_CHECK_PASSED",
@@ -92,10 +115,56 @@ function crossCheckClientReuseManifestEntryWithCache(input) {
 			reuseClass: proof.reuseClass,
 			variantCacheKeyHash: createClientReusePayloadHash(proof.variant.cacheKey)
 		},
-		skipDisposition: createDisabledSkipDisposition()
+		skipDisposition
+	};
+}
+function createClientReuseSkipTransportPlan(input) {
+	const { manifest } = input;
+	if (manifest.kind === "absent") return createRenderAndSendPlan({});
+	if (manifest.kind === "rejected") return createRenderAndSendPlan({ manifestRejection: manifest.rejection });
+	const maxWireEntriesToVerify = input.maxWireEntriesToVerify ?? 8;
+	if (!Number.isSafeInteger(maxWireEntriesToVerify) || maxWireEntriesToVerify < 0) throw new RangeError("maxWireEntriesToVerify must be a non-negative safe integer");
+	const totalWireEntries = manifest.manifest.entries.length + manifest.entryRejections.length;
+	if (totalWireEntries > maxWireEntriesToVerify) return createRenderAndSendPlan({
+		entryRejections: manifest.entryRejections,
+		manifestRejection: createVerificationBudgetExceededRejection(totalWireEntries, maxWireEntriesToVerify)
+	});
+	const skippedEntryIds = [];
+	const skipIneligibleEntryIds = [];
+	const entryRejections = [...manifest.entryRejections];
+	for (const entry of manifest.manifest.entries) {
+		const verification = input.verifyEntry(entry);
+		if (verification.kind === "rejected") {
+			entryRejections.push(verification.rejection);
+			continue;
+		}
+		if (verification.entryId !== entry.id) {
+			entryRejections.push({
+				code: "SKIP_CACHE_ENTRY_ID_MISMATCH",
+				entryId: entry.id,
+				fields: {
+					verifierEntryId: verification.entryId,
+					manifestEntryId: entry.id
+				}
+			});
+			continue;
+		}
+		if (verification.skipDisposition.enabled) skippedEntryIds.push(entry.id);
+		else skipIneligibleEntryIds.push(entry.id);
+	}
+	if (skippedEntryIds.length === 0) return createRenderAndSendPlan({
+		entryRejections,
+		skipIneligibleEntryIds
+	});
+	return {
+		kind: "skip",
+		entryRejections,
+		skipDisposition: createStaticLayoutSkipDisposition(skippedEntryIds),
+		skipIneligibleEntryIds,
+		skippedEntryIds
 	};
 }
 //#endregion
-export { crossCheckClientReuseManifestEntryWithCache };
+export { createClientReuseSkipTransportPlan, createStaticLayoutClientReuseArtifactCompatibility, createStaticLayoutClientReusePayloadHash, createStaticLayoutClientReuseRouteId, crossCheckClientReuseManifestEntryWithCache };
 
 //# sourceMappingURL=skip-cache-proof.js.map

package/dist/server/skip-cache-proof.js.map

@@ -1 +1 @@
-{"version":3,"file":"skip-cache-proof.js","names":[],"sources":["../../src/server/skip-cache-proof.ts"],"sourcesContent":["import {\n  evaluateArtifactCompatibility,\n  type ArtifactCompatibilityEnvelope,\n  type ArtifactCompatibilityEvaluationOptions,\n} from \"./artifact-compatibility.js\";\nimport type { StaticLayoutArtifactReuseDecision } from \"./cache-proof.js\";\nimport {\n  createClientReusePayloadHash,\n  type ClientReuseManifestEntry,\n  type ClientReuseManifestEntryRejection,\n  type ClientReuseManifestSkipDisposition,\n  type ClientReuseManifestTraceFields,\n} from \"./client-reuse-manifest.js\";\n\nexport type SkipCacheInvalidationProof =\n  | Readonly<{ kind: \"invalidated\"; invalidationEpoch: string | null }>\n  | Readonly<{ kind: \"unknown\" }>\n  | Readonly<{ kind: \"valid\" }>;\n\ntype SkipCacheArtifactProof = Readonly<{\n  compatibility: ArtifactCompatibilityEnvelope;\n  invalidation: SkipCacheInvalidationProof;\n  payloadHash: string | null;\n}>;\n\ntype SkipCacheCrossCheckAcceptanceCode = \"SKIP_CACHE_CROSS_CHECK_PASSED\";\n\ntype SkipCacheCrossCheckVerified = Readonly<{\n  code: SkipCacheCrossCheckAcceptanceCode;\n  entryId: string;\n  fields: ClientReuseManifestTraceFields;\n  kind: \"verified\";\n  skipDisposition: ClientReuseManifestSkipDisposition;\n}>;\n\ntype SkipCacheCrossCheckRejected = Readonly<{\n  kind: \"rejected\";\n  rejection: ClientReuseManifestEntryRejection;\n  skipDisposition: ClientReuseManifestSkipDisposition;\n}>;\n\ntype SkipCacheCrossCheckResult = SkipCacheCrossCheckRejected | SkipCacheCrossCheckVerified;\n\ntype CrossCheckClientReuseManifestEntryWithCacheInput = Readonly<{\n  artifact: SkipCacheArtifactProof;\n  cacheDecision: StaticLayoutArtifactReuseDecision | null;\n  entry: ClientReuseManifestEntry;\n}> &\n  ArtifactCompatibilityEvaluationOptions;\n\nconst ARTIFACT_COMPATIBILITY_PROOF_FIELDS: readonly (keyof ArtifactCompatibilityEnvelope)[] = [\n  \"schemaVersion\",\n  \"graphVersion\",\n  \"deploymentVersion\",\n  \"appElementsSchemaVersion\",\n  \"rscPayloadSchemaVersion\",\n  \"rootBoundaryId\",\n  \"renderEpoch\",\n];\n\nfunction createDisabledSkipDisposition(): ClientReuseManifestSkipDisposition {\n  return {\n    code: \"SKIP_MODEL_DISABLED\",\n    enabled: false,\n    mode: \"renderAndSend\",\n  };\n}\n\nfunction rejectSkipCacheCrossCheck(\n  entry: ClientReuseManifestEntry,\n  code: ClientReuseManifestEntryRejection[\"code\"],\n  fields: ClientReuseManifestTraceFields = {},\n): SkipCacheCrossCheckRejected {\n  return {\n    kind: \"rejected\",\n    rejection: {\n      code,\n      entryId: entry.id,\n      fields,\n    },\n    skipDisposition: createDisabledSkipDisposition(),\n  };\n}\n\nfunction collectArtifactCompatibilityProofMismatches(\n  artifactCompatibility: ArtifactCompatibilityEnvelope,\n  proofCompatibility: ArtifactCompatibilityEnvelope,\n): readonly string[] {\n  const mismatchedFields: string[] = [];\n  for (const field of ARTIFACT_COMPATIBILITY_PROOF_FIELDS) {\n    if (artifactCompatibility[field] !== proofCompatibility[field]) {\n      mismatchedFields.push(field);\n    }\n  }\n  return mismatchedFields;\n}\n\nfunction assertNever(value: never): never {\n  throw new Error(`Unhandled skip/cache proof state: ${String(value)}`);\n}\n\nfunction crossCheckInvalidationProof(\n  entry: ClientReuseManifestEntry,\n  invalidation: SkipCacheInvalidationProof,\n): SkipCacheCrossCheckRejected | null {\n  switch (invalidation.kind) {\n    case \"valid\":\n      return null;\n    case \"unknown\":\n      return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_INVALIDATION_UNKNOWN\");\n    case \"invalidated\":\n      return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_INVALIDATED\", {\n        invalidationEpoch: invalidation.invalidationEpoch,\n      });\n    default:\n      return assertNever(invalidation);\n  }\n}\n\nexport function crossCheckClientReuseManifestEntryWithCache(\n  input: CrossCheckClientReuseManifestEntryWithCacheInput,\n): SkipCacheCrossCheckResult {\n  const { cacheDecision, entry } = input;\n  if (cacheDecision === null) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_PROOF_MISSING\");\n  }\n  if (cacheDecision.kind === \"fallback\") {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_PROOF_REJECTED\", {\n      cacheProofCode: cacheDecision.fallback.code,\n      cacheProofMode: cacheDecision.fallback.mode,\n      cacheProofScope: cacheDecision.fallback.scope,\n    });\n  }\n\n  const { proof } = cacheDecision;\n  if (entry.kind !== \"layout\" || proof.reuseClass !== \"static-layout\") {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_REUSE_CLASS_UNSUPPORTED\", {\n      entryKind: entry.kind,\n      reuseClass: proof.reuseClass,\n    });\n  }\n\n  if (entry.id !== proof.candidateOutput.layoutId) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_ENTRY_ID_MISMATCH\", {\n      cacheEntryId: proof.candidateOutput.layoutId,\n      manifestEntryId: entry.id,\n    });\n  }\n\n  const artifactProofMismatches = collectArtifactCompatibilityProofMismatches(\n    input.artifact.compatibility,\n    proof.candidateArtifactCompatibility,\n  );\n  if (artifactProofMismatches.length > 0) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_ARTIFACT_PROOF_MISMATCH\", {\n      mismatchedFields: artifactProofMismatches,\n    });\n  }\n\n  const artifactCompatibility = evaluateArtifactCompatibility(\n    input.artifact.compatibility,\n    entry.artifactCompatibility,\n    { compatibilityMap: input.compatibilityMap },\n  );\n  if (artifactCompatibility.kind === \"unknown\") {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_ARTIFACT_COMPATIBILITY_UNKNOWN\", {\n      compatibilityFallback: artifactCompatibility.fallback,\n      reason: artifactCompatibility.reason,\n    });\n  }\n  if (artifactCompatibility.kind === \"incompatible\") {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_ARTIFACT_COMPATIBILITY_INCOMPATIBLE\", {\n      compatibilityFallback: artifactCompatibility.fallback,\n      reason: artifactCompatibility.reason,\n    });\n  }\n\n  if (entry.variantCacheKey !== proof.variant.cacheKey) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_VARIANT_MISMATCH\", {\n      cacheVariantCacheKeyHash: createClientReusePayloadHash(proof.variant.cacheKey),\n      entryVariantCacheKeyHash: createClientReusePayloadHash(entry.variantCacheKey),\n    });\n  }\n\n  if (input.artifact.payloadHash === null) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_PAYLOAD_HASH_MISSING\");\n  }\n\n  if (entry.payloadHash !== input.artifact.payloadHash) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_PAYLOAD_HASH_MISMATCH\", {\n      cachePayloadHash: input.artifact.payloadHash,\n      entryPayloadHash: entry.payloadHash,\n    });\n  }\n\n  const invalidationRejection = crossCheckInvalidationProof(entry, input.artifact.invalidation);\n  if (invalidationRejection) return invalidationRejection;\n\n  return {\n    kind: \"verified\",\n    code: \"SKIP_CACHE_CROSS_CHECK_PASSED\",\n    entryId: entry.id,\n    fields: {\n      entryKind: entry.kind,\n      reuseClass: proof.reuseClass,\n      variantCacheKeyHash: createClientReusePayloadHash(proof.variant.cacheKey),\n    },\n    skipDisposition: createDisabledSkipDisposition(),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"skip-cache-proof.js","names":[],"sources":["../../src/server/skip-cache-proof.ts"],"sourcesContent":["import {\n  evaluateArtifactCompatibility,\n  ARTIFACT_COMPATIBILITY_PROOF_FIELDS,\n  type ArtifactCompatibilityEnvelope,\n  type ArtifactCompatibilityEvaluationOptions,\n} from \"./artifact-compatibility.js\";\nimport type { StaticLayoutArtifactReuseDecision } from \"./cache-proof.js\";\nimport {\n  CLIENT_REUSE_MANIFEST_SKIP_VERIFICATION_ENTRY_BUDGET,\n  createClientReusePayloadHash,\n  type ClientReuseManifestEntry,\n  type ClientReuseManifestEntryRejection,\n  type ClientReuseManifestParseResult,\n  type ClientReuseManifestRejection,\n  type ClientReuseManifestSkipDisposition,\n  type ClientReuseManifestTraceFields,\n} from \"./client-reuse-manifest.js\";\nexport {\n  createStaticLayoutClientReuseArtifactCompatibility,\n  createStaticLayoutClientReusePayloadHash,\n  createStaticLayoutClientReuseRouteId,\n} from \"./static-layout-client-reuse-proof.js\";\n\nexport type SkipCacheInvalidationProof =\n  | Readonly<{ kind: \"invalidated\"; invalidationEpoch: string | null }>\n  | Readonly<{ kind: \"unknown\" }>\n  | Readonly<{ kind: \"valid\" }>;\n\ntype SkipCacheArtifactProof = Readonly<{\n  compatibility: ArtifactCompatibilityEnvelope;\n  invalidation: SkipCacheInvalidationProof;\n  payloadHash: string | null;\n}>;\n\ntype SkipCacheCrossCheckAcceptanceCode = \"SKIP_CACHE_CROSS_CHECK_PASSED\";\n\ntype SkipCacheCrossCheckVerified = Readonly<{\n  code: SkipCacheCrossCheckAcceptanceCode;\n  entryId: string;\n  fields: ClientReuseManifestTraceFields;\n  kind: \"verified\";\n  skipDisposition: ClientReuseManifestSkipDisposition;\n}>;\n\ntype SkipCacheCrossCheckRejected = Readonly<{\n  kind: \"rejected\";\n  rejection: ClientReuseManifestEntryRejection;\n  skipDisposition: ClientReuseManifestSkipDisposition;\n}>;\n\ntype SkipCacheCrossCheckResult = SkipCacheCrossCheckRejected | SkipCacheCrossCheckVerified;\n\ntype CrossCheckClientReuseManifestEntryWithCacheInput = Readonly<{\n  artifact: SkipCacheArtifactProof;\n  cacheDecision: StaticLayoutArtifactReuseDecision | null;\n  entry: ClientReuseManifestEntry;\n}> &\n  ArtifactCompatibilityEvaluationOptions;\n\ntype ClientReuseSkipTransportPlan =\n  | Readonly<{\n      entryRejections: readonly ClientReuseManifestEntryRejection[];\n      kind: \"renderAndSend\";\n      manifestRejection?: ClientReuseManifestRejection;\n      skipDisposition: ClientReuseManifestSkipDisposition;\n      skipIneligibleEntryIds: readonly string[];\n      skippedEntryIds: readonly string[];\n    }>\n  | Readonly<{\n      entryRejections: readonly ClientReuseManifestEntryRejection[];\n      kind: \"skip\";\n      skipDisposition: ClientReuseManifestSkipDisposition;\n      skipIneligibleEntryIds: readonly string[];\n      skippedEntryIds: readonly string[];\n    }>;\n\ntype CreateClientReuseSkipTransportPlanInput = Readonly<{\n  manifest: ClientReuseManifestParseResult;\n  maxWireEntriesToVerify?: number;\n  verifyEntry: (entry: ClientReuseManifestEntry) => SkipCacheCrossCheckResult;\n}>;\n\nfunction createDisabledSkipDisposition(): ClientReuseManifestSkipDisposition {\n  return {\n    code: \"SKIP_MODEL_DISABLED\",\n    enabled: false,\n    mode: \"renderAndSend\",\n  };\n}\n\nfunction createStaticLayoutSkipDisposition(\n  skippedEntryIds: readonly string[],\n): ClientReuseManifestSkipDisposition {\n  return {\n    code: \"SKIP_STATIC_LAYOUT_VERIFIED\",\n    enabled: true,\n    mode: \"skipStaticLayout\",\n    skippedEntryIds: [...skippedEntryIds],\n  };\n}\n\nfunction rejectSkipCacheCrossCheck(\n  entry: ClientReuseManifestEntry,\n  code: ClientReuseManifestEntryRejection[\"code\"],\n  fields: ClientReuseManifestTraceFields = {},\n): SkipCacheCrossCheckRejected {\n  return {\n    kind: \"rejected\",\n    rejection: {\n      code,\n      entryId: entry.id,\n      fields,\n    },\n    skipDisposition: createDisabledSkipDisposition(),\n  };\n}\n\nfunction collectArtifactCompatibilityProofMismatches(\n  artifactCompatibility: ArtifactCompatibilityEnvelope,\n  proofCompatibility: ArtifactCompatibilityEnvelope,\n): readonly string[] {\n  const mismatchedFields: string[] = [];\n  for (const field of ARTIFACT_COMPATIBILITY_PROOF_FIELDS) {\n    if (artifactCompatibility[field] !== proofCompatibility[field]) {\n      mismatchedFields.push(field);\n    }\n  }\n  return mismatchedFields;\n}\n\nfunction isExactArtifactCompatibility(\n  artifactCompatibility: ArtifactCompatibilityEnvelope,\n  entryCompatibility: ArtifactCompatibilityEnvelope,\n): boolean {\n  return (\n    collectArtifactCompatibilityProofMismatches(artifactCompatibility, entryCompatibility)\n      .length === 0\n  );\n}\n\nfunction assertNever(value: never): never {\n  throw new Error(`Unhandled skip/cache proof state: ${String(value)}`);\n}\n\nfunction createRenderAndSendPlan(options: {\n  entryRejections?: readonly ClientReuseManifestEntryRejection[];\n  manifestRejection?: ClientReuseManifestRejection;\n  skipIneligibleEntryIds?: readonly string[];\n}): ClientReuseSkipTransportPlan {\n  return {\n    kind: \"renderAndSend\",\n    entryRejections: options.entryRejections ?? [],\n    ...(options.manifestRejection ? { manifestRejection: options.manifestRejection } : {}),\n    skipDisposition: createDisabledSkipDisposition(),\n    skipIneligibleEntryIds: options.skipIneligibleEntryIds ?? [],\n    skippedEntryIds: [],\n  };\n}\n\nfunction createVerificationBudgetExceededRejection(\n  totalWireEntries: number,\n  maxWireEntriesToVerify: number,\n): ClientReuseManifestRejection {\n  return {\n    code: \"SKIP_VERIFICATION_BUDGET_EXCEEDED\",\n    fields: { totalWireEntries, maxWireEntriesToVerify },\n  };\n}\n\nfunction crossCheckInvalidationProof(\n  entry: ClientReuseManifestEntry,\n  invalidation: SkipCacheInvalidationProof,\n): SkipCacheCrossCheckRejected | null {\n  switch (invalidation.kind) {\n    case \"valid\":\n      return null;\n    case \"unknown\":\n      return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_INVALIDATION_UNKNOWN\");\n    case \"invalidated\":\n      return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_INVALIDATED\", {\n        invalidationEpoch: invalidation.invalidationEpoch,\n      });\n    default:\n      return assertNever(invalidation);\n  }\n}\n\nexport function crossCheckClientReuseManifestEntryWithCache(\n  input: CrossCheckClientReuseManifestEntryWithCacheInput,\n): SkipCacheCrossCheckResult {\n  const { cacheDecision, entry } = input;\n  if (cacheDecision === null) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_PROOF_MISSING\");\n  }\n  if (cacheDecision.kind === \"fallback\") {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_PROOF_REJECTED\", {\n      cacheProofCode: cacheDecision.fallback.code,\n      cacheProofMode: cacheDecision.fallback.mode,\n      cacheProofScope: cacheDecision.fallback.scope,\n    });\n  }\n\n  const { proof } = cacheDecision;\n  if (entry.kind !== \"layout\" || proof.reuseClass !== \"static-layout\") {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_REUSE_CLASS_UNSUPPORTED\", {\n      entryKind: entry.kind,\n      reuseClass: proof.reuseClass,\n    });\n  }\n\n  if (entry.id !== proof.candidateOutput.layoutId) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_ENTRY_ID_MISMATCH\", {\n      cacheEntryId: proof.candidateOutput.layoutId,\n      manifestEntryId: entry.id,\n    });\n  }\n\n  const artifactProofMismatches = collectArtifactCompatibilityProofMismatches(\n    input.artifact.compatibility,\n    proof.candidateArtifactCompatibility,\n  );\n  if (artifactProofMismatches.length > 0) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_ARTIFACT_PROOF_MISMATCH\", {\n      mismatchedFields: artifactProofMismatches,\n    });\n  }\n\n  const artifactCompatibility = evaluateArtifactCompatibility(\n    input.artifact.compatibility,\n    entry.artifactCompatibility,\n    { compatibilityMap: input.compatibilityMap },\n  );\n  if (artifactCompatibility.kind === \"unknown\") {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_ARTIFACT_COMPATIBILITY_UNKNOWN\", {\n      compatibilityFallback: artifactCompatibility.fallback,\n      reason: artifactCompatibility.reason,\n    });\n  }\n  if (artifactCompatibility.kind === \"incompatible\") {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_ARTIFACT_COMPATIBILITY_INCOMPATIBLE\", {\n      compatibilityFallback: artifactCompatibility.fallback,\n      reason: artifactCompatibility.reason,\n    });\n  }\n\n  if (entry.variantCacheKey !== proof.variant.cacheKey) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_VARIANT_MISMATCH\", {\n      cacheVariantCacheKeyHash: createClientReusePayloadHash(proof.variant.cacheKey),\n      entryVariantCacheKeyHash: createClientReusePayloadHash(entry.variantCacheKey),\n    });\n  }\n\n  if (input.artifact.payloadHash === null) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_PAYLOAD_HASH_MISSING\");\n  }\n\n  if (entry.payloadHash !== input.artifact.payloadHash) {\n    return rejectSkipCacheCrossCheck(entry, \"SKIP_CACHE_PAYLOAD_HASH_MISMATCH\", {\n      cachePayloadHash: input.artifact.payloadHash,\n      entryPayloadHash: entry.payloadHash,\n    });\n  }\n\n  const invalidationRejection = crossCheckInvalidationProof(entry, input.artifact.invalidation);\n  if (invalidationRejection) return invalidationRejection;\n\n  // Skip transport requires exact artifact field equality — not just\n  // compatibility-map-based equivalence.  evaluateArtifactCompatibility (above)\n  // returns \"compatible\" when a declared set bridges differing fields (canary →\n  // rollback), but the skip planner must not elide a fresh render when the two\n  // payloads were built from observably different artifact environments.\n  // isExactArtifactCompatibility performs a distinct field-level walk that\n  // ignores the compatibility map, guaranteeing only bit-identical artifact\n  // envelopes are eligible for transport skip.\n  const skipDisposition = isExactArtifactCompatibility(\n    input.artifact.compatibility,\n    entry.artifactCompatibility,\n  )\n    ? createStaticLayoutSkipDisposition([entry.id])\n    : createDisabledSkipDisposition();\n\n  return {\n    kind: \"verified\",\n    code: \"SKIP_CACHE_CROSS_CHECK_PASSED\",\n    entryId: entry.id,\n    fields: {\n      entryKind: entry.kind,\n      reuseClass: proof.reuseClass,\n      variantCacheKeyHash: createClientReusePayloadHash(proof.variant.cacheKey),\n    },\n    skipDisposition,\n  };\n}\n\nexport function createClientReuseSkipTransportPlan(\n  input: CreateClientReuseSkipTransportPlanInput,\n): ClientReuseSkipTransportPlan {\n  const { manifest } = input;\n  if (manifest.kind === \"absent\") {\n    return createRenderAndSendPlan({});\n  }\n  if (manifest.kind === \"rejected\") {\n    return createRenderAndSendPlan({ manifestRejection: manifest.rejection });\n  }\n\n  const maxWireEntriesToVerify =\n    input.maxWireEntriesToVerify ?? CLIENT_REUSE_MANIFEST_SKIP_VERIFICATION_ENTRY_BUDGET;\n  if (!Number.isSafeInteger(maxWireEntriesToVerify) || maxWireEntriesToVerify < 0) {\n    throw new RangeError(\"maxWireEntriesToVerify must be a non-negative safe integer\");\n  }\n\n  const totalWireEntries = manifest.manifest.entries.length + manifest.entryRejections.length;\n  if (totalWireEntries > maxWireEntriesToVerify) {\n    return createRenderAndSendPlan({\n      entryRejections: manifest.entryRejections,\n      manifestRejection: createVerificationBudgetExceededRejection(\n        totalWireEntries,\n        maxWireEntriesToVerify,\n      ),\n    });\n  }\n\n  const skippedEntryIds: string[] = [];\n  const skipIneligibleEntryIds: string[] = [];\n  const entryRejections: ClientReuseManifestEntryRejection[] = [...manifest.entryRejections];\n  for (const entry of manifest.manifest.entries) {\n    const verification = input.verifyEntry(entry);\n    if (verification.kind === \"rejected\") {\n      entryRejections.push(verification.rejection);\n      continue;\n    }\n\n    // The planner must not trust a verifier that returns a verified result\n    // for a different entry than the one it was given.  This is an internal\n    // invariant, not a hostile-client defence.\n    if (verification.entryId !== entry.id) {\n      entryRejections.push({\n        code: \"SKIP_CACHE_ENTRY_ID_MISMATCH\",\n        entryId: entry.id,\n        fields: {\n          verifierEntryId: verification.entryId,\n          manifestEntryId: entry.id,\n        },\n      });\n      continue;\n    }\n\n    if (verification.skipDisposition.enabled) {\n      skippedEntryIds.push(entry.id);\n    } else {\n      skipIneligibleEntryIds.push(entry.id);\n    }\n  }\n\n  if (skippedEntryIds.length === 0) {\n    return createRenderAndSendPlan({ entryRejections, skipIneligibleEntryIds });\n  }\n\n  return {\n    kind: \"skip\",\n    entryRejections,\n    skipDisposition: createStaticLayoutSkipDisposition(skippedEntryIds),\n    skipIneligibleEntryIds,\n    skippedEntryIds,\n  };\n}\n"],"mappings":"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"}

package/dist/server/static-file-cache.js

@@ -1,3 +1,4 @@
+import { normalizePathSeparators } from "../utils/path.js";
 import "../utils/asset-prefix.js";
 import path from "node:path";
 import fs from "node:fs/promises";
@@ -205,7 +206,7 @@ async function* walkFilesWithStats(dir, base = dir) {
 		const batch = files.slice(i, i + STAT_BATCH_SIZE);
 		const stats = await Promise.all(batch.map((f) => fs.stat(f)));
 		for (let j = 0; j < batch.length; j++) yield {
-			relativePath: path.relative(base, batch[j]).replaceAll(path.sep, "/"),
+			relativePath: normalizePathSeparators(path.relative(base, batch[j])),
 			fullPath: batch[j],
 			stat: {
 				size: stats[j].size,

package/dist/server/static-file-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"static-file-cache.js","names":["fsp"],"sources":["../../src/server/static-file-cache.ts"],"sourcesContent":["/**\n * Startup metadata cache for static file serving.\n *\n * Walks dist/client/ once at server boot, pre-computes response headers for\n * every file variant (original, brotli, gzip, zstd), and caches everything\n * in memory. The per-request hot path is just: Map.get() → string compare\n * (ETag) → writeHead(precomputed) → pipe.\n *\n * Modeled after sirv's production mode. Key insight from sirv: pre-compute\n * ALL response headers at startup — Content-Type, Content-Length, ETag,\n * Cache-Control, Content-Encoding, Vary — as reusable objects. The common\n * per-request path (no extraHeaders) does zero object allocation for headers.\n */\nimport fsp from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { ASSET_PREFIX_URL_DIR } from \"../utils/asset-prefix.js\";\n\n/** Content-type lookup for static assets. Shared with prod-server.ts. */\nexport const CONTENT_TYPES: Record<string, string> = {\n  \".js\": \"application/javascript\",\n  \".mjs\": \"application/javascript\",\n  \".css\": \"text/css\",\n  \".html\": \"text/html\",\n  \".json\": \"application/json\",\n  \".png\": \"image/png\",\n  \".jpg\": \"image/jpeg\",\n  \".jpeg\": \"image/jpeg\",\n  \".gif\": \"image/gif\",\n  \".svg\": \"image/svg+xml\",\n  \".ico\": \"image/x-icon\",\n  \".woff\": \"font/woff\",\n  \".woff2\": \"font/woff2\",\n  \".ttf\": \"font/ttf\",\n  \".eot\": \"application/vnd.ms-fontobject\",\n  \".webp\": \"image/webp\",\n  \".avif\": \"image/avif\",\n  \".map\": \"application/json\",\n  \".rsc\": \"text/x-component\",\n};\n\n/**\n * Files below this size are buffered in memory at startup for zero-syscall\n * serving via res.end(buffer). Above this, files stream via createReadStream.\n * 64KB covers virtually all precompressed assets (a 200KB JS bundle compresses\n * to ~50KB with brotli q5).\n */\nconst BUFFER_THRESHOLD = 64 * 1024;\n\n/** A servable file variant with pre-computed response headers. */\ntype FileVariant = {\n  /** Absolute file path (used for streaming large files). */\n  path: string;\n  /** Uncompressed or encoded byte size for buffer-threshold decisions. */\n  size: number;\n  /** Pre-computed response headers. */\n  headers: Record<string, string>;\n  /** In-memory buffer for small files (below BUFFER_THRESHOLD). */\n  buffer?: Buffer;\n};\n\ntype StaticFileEntry = {\n  /** Weak ETag for conditional request matching. */\n  etag: string;\n  /** Pre-computed headers for 304 Not Modified response. */\n  notModifiedHeaders: Record<string, string>;\n  /** Original file variant (uncompressed). */\n  original: FileVariant;\n  /** Brotli precompressed variant, if .br file exists. */\n  br?: FileVariant;\n  /** Gzip precompressed variant, if .gz file exists. */\n  gz?: FileVariant;\n  /** Zstandard precompressed variant, if .zst file exists. */\n  zst?: FileVariant;\n};\n\n/**\n * In-memory cache of static file metadata, populated once at server startup.\n *\n * Usage:\n *   const cache = await StaticFileCache.create(clientDir);\n *   const entry = cache.lookup(\"/_next/static/app-abc123.js\");\n *   // entry.br?.headers, entry.original.headers, etc.\n */\nexport class StaticFileCache {\n  private readonly entries: Map<string, StaticFileEntry>;\n\n  private constructor(entries: Map<string, StaticFileEntry>) {\n    this.entries = entries;\n  }\n\n  /**\n   * Scan the client directory and build the cache.\n   *\n   * Gracefully handles non-existent directories (returns an empty cache).\n   */\n  static async create(clientDir: string): Promise<StaticFileCache> {\n    const entries = new Map<string, StaticFileEntry>();\n\n    // First pass: collect all regular files with their metadata\n    const allFiles = new Map<string, { fullPath: string; size: number; mtimeMs: number }>();\n\n    for await (const { relativePath, fullPath, stat } of walkFilesWithStats(clientDir)) {\n      allFiles.set(relativePath, { fullPath, size: stat.size, mtimeMs: stat.mtimeMs });\n    }\n\n    // Second pass: build cache entries with pre-computed headers per variant\n    for (const [relativePath, fileInfo] of allFiles) {\n      // Skip precompressed variants — they're linked to their originals\n      if (\n        relativePath.endsWith(\".br\") ||\n        relativePath.endsWith(\".gz\") ||\n        relativePath.endsWith(\".zst\")\n      )\n        continue;\n\n      // Skip .vite/ internal directory\n      if (relativePath.startsWith(\".vite/\") || relativePath === \".vite\") continue;\n\n      const ext = path.extname(relativePath);\n      const contentType = CONTENT_TYPES[ext] ?? \"application/octet-stream\";\n      // Files under Vite's `assetsDir` are content-hashed. The default\n      // layout writes to `<ASSET_PREFIX_URL_DIR>/` (Next.js's canonical\n      // convention); when `assetPrefix` is a path prefix the layout\n      // becomes `<prefix>/<ASSET_PREFIX_URL_DIR>/...`. Both forms get\n      // long-lived `immutable` cache headers — the hash in the filename\n      // invalidates safely.\n      //\n      // `relativePath` is the path relative to `clientDir`, with no\n      // leading slash. Because of that, `startsWith(\"<dir>/\")` and\n      // `includes(\"/<dir>/\")` are NOT equivalent — the former covers the\n      // default and absolute-URL prefix layouts (no parent directory),\n      // the latter covers the path-prefix layout (under an arbitrary\n      // parent like `cdn/`).\n      const isHashed =\n        relativePath.startsWith(`${ASSET_PREFIX_URL_DIR}/`) ||\n        relativePath.includes(`/${ASSET_PREFIX_URL_DIR}/`);\n      const cacheControl = isHashed\n        ? \"public, max-age=31536000, immutable\"\n        : \"public, max-age=3600\";\n      const etag =\n        (isHashed && etagFromFilenameHash(relativePath, ext)) ||\n        `W/\"${fileInfo.size}-${Math.floor(fileInfo.mtimeMs / 1000)}\"`;\n\n      // Base headers shared by all variants (Content-Type, Cache-Control, ETag)\n      const baseHeaders = {\n        \"Content-Type\": contentType,\n        \"Cache-Control\": cacheControl,\n        ETag: etag,\n      };\n\n      // Pre-compute original variant headers\n      const original: FileVariant = {\n        path: fileInfo.fullPath,\n        size: fileInfo.size,\n        headers: { ...baseHeaders, \"Content-Length\": String(fileInfo.size) },\n      };\n\n      const entry: StaticFileEntry = {\n        etag,\n        notModifiedHeaders: { ETag: etag, \"Cache-Control\": cacheControl },\n        original,\n      };\n\n      // Pre-compute compressed variant headers (with Content-Encoding, Vary, correct Content-Length)\n      const brInfo = allFiles.get(relativePath + \".br\");\n      if (brInfo) {\n        entry.br = buildVariant(brInfo, baseHeaders, \"br\");\n      }\n\n      const gzInfo = allFiles.get(relativePath + \".gz\");\n      if (gzInfo) {\n        entry.gz = buildVariant(gzInfo, baseHeaders, \"gzip\");\n      }\n\n      const zstInfo = allFiles.get(relativePath + \".zst\");\n      if (zstInfo) {\n        entry.zst = buildVariant(zstInfo, baseHeaders, \"zstd\");\n      }\n\n      // When compressed variants exist, the original needs Vary too so\n      // shared caches don't serve uncompressed to compression-capable clients.\n      if (entry.br || entry.gz || entry.zst) {\n        original.headers[\"Vary\"] = \"Accept-Encoding\";\n        entry.notModifiedHeaders[\"Vary\"] = \"Accept-Encoding\";\n      }\n\n      // Register under the URL pathname (leading /)\n      // NOTE: aliases below share the same entry by reference, so all header\n      // mutations (e.g. Vary above) must happen before registration.\n      const pathname = \"/\" + relativePath;\n      entries.set(pathname, entry);\n\n      // Register HTML fallback aliases (same entry object — no duplication)\n      if (ext === \".html\") {\n        if (relativePath.endsWith(\"/index.html\")) {\n          const dirPath = \"/\" + relativePath.slice(0, -\"/index.html\".length);\n          if (dirPath !== \"/\") {\n            entries.set(dirPath, entry);\n          }\n        } else {\n          const withoutExt = \"/\" + relativePath.slice(0, -ext.length);\n          entries.set(withoutExt, entry);\n        }\n      }\n    }\n\n    // Third pass: buffer small files in memory for zero-syscall serving.\n    // For small compressed variants (e.g. a 50KB JS bundle → ~15KB brotli),\n    // res.end(buffer) is ~2x faster than createReadStream().pipe() because\n    // it skips fd open/close and stream plumbing overhead.\n    // Reads are chunked at 64 concurrent to avoid fd exhaustion on large projects.\n    // Deduplicate at the entry level first: HTML aliases share the same\n    // StaticFileEntry by reference, so entries.values() yields duplicates for\n    // paths like /about and /about.html. Deduping entries avoids iterating\n    // their variants multiple times on sites with many HTML pages.\n    const toBuffer: FileVariant[] = [];\n    const seenEntries = new Set<StaticFileEntry>();\n    for (const entry of entries.values()) {\n      if (seenEntries.has(entry)) continue;\n      seenEntries.add(entry);\n      for (const variant of [entry.original, entry.br, entry.gz, entry.zst]) {\n        if (!variant || variant.size > BUFFER_THRESHOLD) continue;\n        toBuffer.push(variant);\n      }\n    }\n    for (let i = 0; i < toBuffer.length; i += 64) {\n      await Promise.all(\n        toBuffer.slice(i, i + 64).map(async (v) => {\n          v.buffer = await fsp.readFile(v.path);\n        }),\n      );\n    }\n\n    return new StaticFileCache(entries);\n  }\n\n  /**\n   * Look up cached metadata for a URL pathname.\n   *\n   * Returns undefined if the file is not in the cache. The root path \"/\"\n   * always returns undefined — index.html is served by SSR/RSC.\n   */\n  lookup(pathname: string): StaticFileEntry | undefined {\n    if (pathname === \"/\") return undefined;\n\n    // Block .vite/ access (including encoded variants that were decoded before lookup)\n    if (pathname.startsWith(\"/.vite/\") || pathname === \"/.vite\") return undefined;\n\n    return this.entries.get(pathname);\n  }\n}\n\n/**\n * Extract a stable weak ETag from a Vite hashed filename (e.g. `app-DqZc3R4n.js`).\n * The hash is a content hash computed by the bundler — deterministic across\n * identical builds regardless of filesystem timestamps.\n *\n * Must be a weak validator (W/) because the same tag is shared across\n * content-encoded variants (original, .br, .gz, .zst) which are byte-different.\n * Returns null if the filename doesn't contain a recognizable hash suffix,\n * so the caller can fall back to mtime-based ETags.\n */\nexport function etagFromFilenameHash(relativePath: string, ext: string): string | null {\n  const basename = path.basename(relativePath, ext);\n  const lastDash = basename.lastIndexOf(\"-\");\n  if (lastDash === -1 || lastDash === basename.length - 1) return null;\n  const suffix = basename.slice(lastDash + 1);\n  // Vite emits 8-char base64url hashes; allow 6-12 for other bundlers.\n  // If Rolldown changes its hash length, update this range.\n  return suffix.length >= 6 && suffix.length <= 12 && /^[A-Za-z0-9_-]+$/.test(suffix)\n    ? `W/\"${suffix}\"`\n    : null;\n}\n\nfunction buildVariant(\n  info: { fullPath: string; size: number },\n  baseHeaders: Record<string, string>,\n  encoding: string,\n): FileVariant {\n  return {\n    path: info.fullPath,\n    size: info.size,\n    headers: {\n      ...baseHeaders,\n      \"Content-Encoding\": encoding,\n      \"Content-Length\": String(info.size),\n      Vary: \"Accept-Encoding\",\n    },\n  };\n}\n\n/** Batch size for concurrent stat() calls during directory walk. */\nconst STAT_BATCH_SIZE = 64;\n\n/**\n * Walk a directory recursively, yielding file paths and stats.\n *\n * Batches stat() calls per directory to avoid sequential syscall overhead\n * for large dist/client/ directories.\n */\nasync function* walkFilesWithStats(\n  dir: string,\n  base: string = dir,\n): AsyncGenerator<{\n  relativePath: string;\n  fullPath: string;\n  stat: { size: number; mtimeMs: number };\n}> {\n  let entries;\n  try {\n    entries = await fsp.readdir(dir, { withFileTypes: true });\n  } catch {\n    return; // directory doesn't exist or unreadable\n  }\n\n  // Recurse into subdirectories first (they yield their own batched stats)\n  const files: string[] = [];\n  for (const entry of entries) {\n    const fullPath = path.join(dir, entry.name);\n    if (entry.isDirectory()) {\n      yield* walkFilesWithStats(fullPath, base);\n    } else if (entry.isFile()) {\n      files.push(fullPath);\n    }\n  }\n\n  // Batch stat() calls for files in this directory\n  for (let i = 0; i < files.length; i += STAT_BATCH_SIZE) {\n    const batch = files.slice(i, i + STAT_BATCH_SIZE);\n    const stats = await Promise.all(batch.map((f) => fsp.stat(f)));\n    for (let j = 0; j < batch.length; j++) {\n      yield {\n        relativePath: path.relative(base, batch[j]).replaceAll(path.sep, \"/\"),\n        fullPath: batch[j],\n        stat: { size: stats[j].size, mtimeMs: stats[j].mtimeMs },\n      };\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"static-file-cache.js","names":["fsp"],"sources":["../../src/server/static-file-cache.ts"],"sourcesContent":["/**\n * Startup metadata cache for static file serving.\n *\n * Walks dist/client/ once at server boot, pre-computes response headers for\n * every file variant (original, brotli, gzip, zstd), and caches everything\n * in memory. The per-request hot path is just: Map.get() → string compare\n * (ETag) → writeHead(precomputed) → pipe.\n *\n * Modeled after sirv's production mode. Key insight from sirv: pre-compute\n * ALL response headers at startup — Content-Type, Content-Length, ETag,\n * Cache-Control, Content-Encoding, Vary — as reusable objects. The common\n * per-request path (no extraHeaders) does zero object allocation for headers.\n */\nimport fsp from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { ASSET_PREFIX_URL_DIR } from \"../utils/asset-prefix.js\";\nimport { normalizePathSeparators } from \"../utils/path.js\";\n\n/** Content-type lookup for static assets. Shared with prod-server.ts. */\nexport const CONTENT_TYPES: Record<string, string> = {\n  \".js\": \"application/javascript\",\n  \".mjs\": \"application/javascript\",\n  \".css\": \"text/css\",\n  \".html\": \"text/html\",\n  \".json\": \"application/json\",\n  \".png\": \"image/png\",\n  \".jpg\": \"image/jpeg\",\n  \".jpeg\": \"image/jpeg\",\n  \".gif\": \"image/gif\",\n  \".svg\": \"image/svg+xml\",\n  \".ico\": \"image/x-icon\",\n  \".woff\": \"font/woff\",\n  \".woff2\": \"font/woff2\",\n  \".ttf\": \"font/ttf\",\n  \".eot\": \"application/vnd.ms-fontobject\",\n  \".webp\": \"image/webp\",\n  \".avif\": \"image/avif\",\n  \".map\": \"application/json\",\n  \".rsc\": \"text/x-component\",\n};\n\n/**\n * Files below this size are buffered in memory at startup for zero-syscall\n * serving via res.end(buffer). Above this, files stream via createReadStream.\n * 64KB covers virtually all precompressed assets (a 200KB JS bundle compresses\n * to ~50KB with brotli q5).\n */\nconst BUFFER_THRESHOLD = 64 * 1024;\n\n/** A servable file variant with pre-computed response headers. */\ntype FileVariant = {\n  /** Absolute file path (used for streaming large files). */\n  path: string;\n  /** Uncompressed or encoded byte size for buffer-threshold decisions. */\n  size: number;\n  /** Pre-computed response headers. */\n  headers: Record<string, string>;\n  /** In-memory buffer for small files (below BUFFER_THRESHOLD). */\n  buffer?: Buffer;\n};\n\ntype StaticFileEntry = {\n  /** Weak ETag for conditional request matching. */\n  etag: string;\n  /** Pre-computed headers for 304 Not Modified response. */\n  notModifiedHeaders: Record<string, string>;\n  /** Original file variant (uncompressed). */\n  original: FileVariant;\n  /** Brotli precompressed variant, if .br file exists. */\n  br?: FileVariant;\n  /** Gzip precompressed variant, if .gz file exists. */\n  gz?: FileVariant;\n  /** Zstandard precompressed variant, if .zst file exists. */\n  zst?: FileVariant;\n};\n\n/**\n * In-memory cache of static file metadata, populated once at server startup.\n *\n * Usage:\n *   const cache = await StaticFileCache.create(clientDir);\n *   const entry = cache.lookup(\"/_next/static/app-abc123.js\");\n *   // entry.br?.headers, entry.original.headers, etc.\n */\nexport class StaticFileCache {\n  private readonly entries: Map<string, StaticFileEntry>;\n\n  private constructor(entries: Map<string, StaticFileEntry>) {\n    this.entries = entries;\n  }\n\n  /**\n   * Scan the client directory and build the cache.\n   *\n   * Gracefully handles non-existent directories (returns an empty cache).\n   */\n  static async create(clientDir: string): Promise<StaticFileCache> {\n    const entries = new Map<string, StaticFileEntry>();\n\n    // First pass: collect all regular files with their metadata\n    const allFiles = new Map<string, { fullPath: string; size: number; mtimeMs: number }>();\n\n    for await (const { relativePath, fullPath, stat } of walkFilesWithStats(clientDir)) {\n      allFiles.set(relativePath, { fullPath, size: stat.size, mtimeMs: stat.mtimeMs });\n    }\n\n    // Second pass: build cache entries with pre-computed headers per variant\n    for (const [relativePath, fileInfo] of allFiles) {\n      // Skip precompressed variants — they're linked to their originals\n      if (\n        relativePath.endsWith(\".br\") ||\n        relativePath.endsWith(\".gz\") ||\n        relativePath.endsWith(\".zst\")\n      )\n        continue;\n\n      // Skip .vite/ internal directory\n      if (relativePath.startsWith(\".vite/\") || relativePath === \".vite\") continue;\n\n      const ext = path.extname(relativePath);\n      const contentType = CONTENT_TYPES[ext] ?? \"application/octet-stream\";\n      // Files under Vite's `assetsDir` are content-hashed. The default\n      // layout writes to `<ASSET_PREFIX_URL_DIR>/` (Next.js's canonical\n      // convention); when `assetPrefix` is a path prefix the layout\n      // becomes `<prefix>/<ASSET_PREFIX_URL_DIR>/...`. Both forms get\n      // long-lived `immutable` cache headers — the hash in the filename\n      // invalidates safely.\n      //\n      // `relativePath` is the path relative to `clientDir`, with no\n      // leading slash. Because of that, `startsWith(\"<dir>/\")` and\n      // `includes(\"/<dir>/\")` are NOT equivalent — the former covers the\n      // default and absolute-URL prefix layouts (no parent directory),\n      // the latter covers the path-prefix layout (under an arbitrary\n      // parent like `cdn/`).\n      const isHashed =\n        relativePath.startsWith(`${ASSET_PREFIX_URL_DIR}/`) ||\n        relativePath.includes(`/${ASSET_PREFIX_URL_DIR}/`);\n      const cacheControl = isHashed\n        ? \"public, max-age=31536000, immutable\"\n        : \"public, max-age=3600\";\n      const etag =\n        (isHashed && etagFromFilenameHash(relativePath, ext)) ||\n        `W/\"${fileInfo.size}-${Math.floor(fileInfo.mtimeMs / 1000)}\"`;\n\n      // Base headers shared by all variants (Content-Type, Cache-Control, ETag)\n      const baseHeaders = {\n        \"Content-Type\": contentType,\n        \"Cache-Control\": cacheControl,\n        ETag: etag,\n      };\n\n      // Pre-compute original variant headers\n      const original: FileVariant = {\n        path: fileInfo.fullPath,\n        size: fileInfo.size,\n        headers: { ...baseHeaders, \"Content-Length\": String(fileInfo.size) },\n      };\n\n      const entry: StaticFileEntry = {\n        etag,\n        notModifiedHeaders: { ETag: etag, \"Cache-Control\": cacheControl },\n        original,\n      };\n\n      // Pre-compute compressed variant headers (with Content-Encoding, Vary, correct Content-Length)\n      const brInfo = allFiles.get(relativePath + \".br\");\n      if (brInfo) {\n        entry.br = buildVariant(brInfo, baseHeaders, \"br\");\n      }\n\n      const gzInfo = allFiles.get(relativePath + \".gz\");\n      if (gzInfo) {\n        entry.gz = buildVariant(gzInfo, baseHeaders, \"gzip\");\n      }\n\n      const zstInfo = allFiles.get(relativePath + \".zst\");\n      if (zstInfo) {\n        entry.zst = buildVariant(zstInfo, baseHeaders, \"zstd\");\n      }\n\n      // When compressed variants exist, the original needs Vary too so\n      // shared caches don't serve uncompressed to compression-capable clients.\n      if (entry.br || entry.gz || entry.zst) {\n        original.headers[\"Vary\"] = \"Accept-Encoding\";\n        entry.notModifiedHeaders[\"Vary\"] = \"Accept-Encoding\";\n      }\n\n      // Register under the URL pathname (leading /)\n      // NOTE: aliases below share the same entry by reference, so all header\n      // mutations (e.g. Vary above) must happen before registration.\n      const pathname = \"/\" + relativePath;\n      entries.set(pathname, entry);\n\n      // Register HTML fallback aliases (same entry object — no duplication)\n      if (ext === \".html\") {\n        if (relativePath.endsWith(\"/index.html\")) {\n          const dirPath = \"/\" + relativePath.slice(0, -\"/index.html\".length);\n          if (dirPath !== \"/\") {\n            entries.set(dirPath, entry);\n          }\n        } else {\n          const withoutExt = \"/\" + relativePath.slice(0, -ext.length);\n          entries.set(withoutExt, entry);\n        }\n      }\n    }\n\n    // Third pass: buffer small files in memory for zero-syscall serving.\n    // For small compressed variants (e.g. a 50KB JS bundle → ~15KB brotli),\n    // res.end(buffer) is ~2x faster than createReadStream().pipe() because\n    // it skips fd open/close and stream plumbing overhead.\n    // Reads are chunked at 64 concurrent to avoid fd exhaustion on large projects.\n    // Deduplicate at the entry level first: HTML aliases share the same\n    // StaticFileEntry by reference, so entries.values() yields duplicates for\n    // paths like /about and /about.html. Deduping entries avoids iterating\n    // their variants multiple times on sites with many HTML pages.\n    const toBuffer: FileVariant[] = [];\n    const seenEntries = new Set<StaticFileEntry>();\n    for (const entry of entries.values()) {\n      if (seenEntries.has(entry)) continue;\n      seenEntries.add(entry);\n      for (const variant of [entry.original, entry.br, entry.gz, entry.zst]) {\n        if (!variant || variant.size > BUFFER_THRESHOLD) continue;\n        toBuffer.push(variant);\n      }\n    }\n    for (let i = 0; i < toBuffer.length; i += 64) {\n      await Promise.all(\n        toBuffer.slice(i, i + 64).map(async (v) => {\n          v.buffer = await fsp.readFile(v.path);\n        }),\n      );\n    }\n\n    return new StaticFileCache(entries);\n  }\n\n  /**\n   * Look up cached metadata for a URL pathname.\n   *\n   * Returns undefined if the file is not in the cache. The root path \"/\"\n   * always returns undefined — index.html is served by SSR/RSC.\n   */\n  lookup(pathname: string): StaticFileEntry | undefined {\n    if (pathname === \"/\") return undefined;\n\n    // Block .vite/ access (including encoded variants that were decoded before lookup)\n    if (pathname.startsWith(\"/.vite/\") || pathname === \"/.vite\") return undefined;\n\n    return this.entries.get(pathname);\n  }\n}\n\n/**\n * Extract a stable weak ETag from a Vite hashed filename (e.g. `app-DqZc3R4n.js`).\n * The hash is a content hash computed by the bundler — deterministic across\n * identical builds regardless of filesystem timestamps.\n *\n * Must be a weak validator (W/) because the same tag is shared across\n * content-encoded variants (original, .br, .gz, .zst) which are byte-different.\n * Returns null if the filename doesn't contain a recognizable hash suffix,\n * so the caller can fall back to mtime-based ETags.\n */\nexport function etagFromFilenameHash(relativePath: string, ext: string): string | null {\n  const basename = path.basename(relativePath, ext);\n  const lastDash = basename.lastIndexOf(\"-\");\n  if (lastDash === -1 || lastDash === basename.length - 1) return null;\n  const suffix = basename.slice(lastDash + 1);\n  // Vite emits 8-char base64url hashes; allow 6-12 for other bundlers.\n  // If Rolldown changes its hash length, update this range.\n  return suffix.length >= 6 && suffix.length <= 12 && /^[A-Za-z0-9_-]+$/.test(suffix)\n    ? `W/\"${suffix}\"`\n    : null;\n}\n\nfunction buildVariant(\n  info: { fullPath: string; size: number },\n  baseHeaders: Record<string, string>,\n  encoding: string,\n): FileVariant {\n  return {\n    path: info.fullPath,\n    size: info.size,\n    headers: {\n      ...baseHeaders,\n      \"Content-Encoding\": encoding,\n      \"Content-Length\": String(info.size),\n      Vary: \"Accept-Encoding\",\n    },\n  };\n}\n\n/** Batch size for concurrent stat() calls during directory walk. */\nconst STAT_BATCH_SIZE = 64;\n\n/**\n * Walk a directory recursively, yielding file paths and stats.\n *\n * Batches stat() calls per directory to avoid sequential syscall overhead\n * for large dist/client/ directories.\n */\nasync function* walkFilesWithStats(\n  dir: string,\n  base: string = dir,\n): AsyncGenerator<{\n  relativePath: string;\n  fullPath: string;\n  stat: { size: number; mtimeMs: number };\n}> {\n  let entries;\n  try {\n    entries = await fsp.readdir(dir, { withFileTypes: true });\n  } catch {\n    return; // directory doesn't exist or unreadable\n  }\n\n  // Recurse into subdirectories first (they yield their own batched stats)\n  const files: string[] = [];\n  for (const entry of entries) {\n    const fullPath = path.join(dir, entry.name);\n    if (entry.isDirectory()) {\n      yield* walkFilesWithStats(fullPath, base);\n    } else if (entry.isFile()) {\n      files.push(fullPath);\n    }\n  }\n\n  // Batch stat() calls for files in this directory\n  for (let i = 0; i < files.length; i += STAT_BATCH_SIZE) {\n    const batch = files.slice(i, i + STAT_BATCH_SIZE);\n    const stats = await Promise.all(batch.map((f) => fsp.stat(f)));\n    for (let j = 0; j < batch.length; j++) {\n      yield {\n        relativePath: normalizePathSeparators(path.relative(base, batch[j])),\n        fullPath: batch[j],\n        stat: { size: stats[j].size, mtimeMs: stats[j].mtimeMs },\n      };\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/server/static-layout-client-reuse-proof.d.ts

@@ -0,0 +1,16 @@
+import { ArtifactCompatibilityEnvelope } from "./artifact-compatibility.js";
+
+//#region src/server/static-layout-client-reuse-proof.d.ts
+type StaticLayoutClientReuseProofInput = Readonly<{
+  artifactCompatibility: ArtifactCompatibilityEnvelope;
+  layoutId: string;
+  rootBoundaryId: string | null;
+  routeId: string;
+  variantCacheKey: string;
+}>;
+declare function createStaticLayoutClientReuseRouteId(layoutId: string): string;
+declare function createStaticLayoutClientReusePayloadHash(input: StaticLayoutClientReuseProofInput): string;
+declare function createStaticLayoutClientReuseArtifactCompatibility(input: StaticLayoutClientReuseProofInput): ArtifactCompatibilityEnvelope;
+//#endregion
+export { createStaticLayoutClientReuseArtifactCompatibility, createStaticLayoutClientReusePayloadHash, createStaticLayoutClientReuseRouteId };
+//# sourceMappingURL=static-layout-client-reuse-proof.d.ts.map

package/dist/server/static-layout-client-reuse-proof.js

@@ -0,0 +1,35 @@
+import { ARTIFACT_COMPATIBILITY_PROOF_FIELDS } from "./artifact-compatibility.js";
+import { createClientReusePayloadHash } from "./client-reuse-manifest.js";
+//#region src/server/static-layout-client-reuse-proof.ts
+function createStaticLayoutClientReuseRouteId(layoutId) {
+	return `static-layout:${createClientReusePayloadHash(layoutId)}`;
+}
+function createCanonicalProofPairs(input) {
+	return ARTIFACT_COMPATIBILITY_PROOF_FIELDS.map((field) => [field, input.artifactCompatibility[field]]);
+}
+function createStaticLayoutClientReusePayloadHash(input) {
+	return createClientReusePayloadHash(JSON.stringify({
+		artifactCompatibilityPairs: createCanonicalProofPairs(input),
+		layoutId: input.layoutId,
+		rootBoundaryId: input.rootBoundaryId,
+		variantCacheKey: input.variantCacheKey
+	}));
+}
+function createStaticLayoutClientReuseArtifactCompatibility(input) {
+	return {
+		...input.artifactCompatibility,
+		graphVersion: `static-layout-graph:${createClientReusePayloadHash(JSON.stringify({
+			layoutId: input.layoutId,
+			rootBoundaryId: input.rootBoundaryId
+		}))}`,
+		renderEpoch: `static-layout:${createClientReusePayloadHash(JSON.stringify({
+			layoutId: input.layoutId,
+			rootBoundaryId: input.rootBoundaryId,
+			variantCacheKey: input.variantCacheKey
+		}))}`
+	};
+}
+//#endregion
+export { createStaticLayoutClientReuseArtifactCompatibility, createStaticLayoutClientReusePayloadHash, createStaticLayoutClientReuseRouteId };
+
+//# sourceMappingURL=static-layout-client-reuse-proof.js.map

package/dist/server/static-layout-client-reuse-proof.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-layout-client-reuse-proof.js","names":[],"sources":["../../src/server/static-layout-client-reuse-proof.ts"],"sourcesContent":["import {\n  type ArtifactCompatibilityEnvelope,\n  ARTIFACT_COMPATIBILITY_PROOF_FIELDS,\n} from \"./artifact-compatibility.js\";\nimport { createClientReusePayloadHash } from \"./client-reuse-manifest.js\";\n\ntype StaticLayoutClientReuseProofInput = Readonly<{\n  artifactCompatibility: ArtifactCompatibilityEnvelope;\n  layoutId: string;\n  rootBoundaryId: string | null;\n  routeId: string;\n  variantCacheKey: string;\n}>;\n\ntype ProofFieldPair = readonly [string, string | number | null];\n\nexport function createStaticLayoutClientReuseRouteId(layoutId: string): string {\n  return `static-layout:${createClientReusePayloadHash(layoutId)}`;\n}\n\nfunction createCanonicalProofPairs(\n  input: StaticLayoutClientReuseProofInput,\n): readonly ProofFieldPair[] {\n  return ARTIFACT_COMPATIBILITY_PROOF_FIELDS.map((field) => [\n    field,\n    input.artifactCompatibility[field],\n  ]);\n}\n\nexport function createStaticLayoutClientReusePayloadHash(\n  input: StaticLayoutClientReuseProofInput,\n): string {\n  // ARTIFACT_COMPATIBILITY_PROOF_FIELDS order is load-bearing for hash\n  // determinism.  The artifact compatibility section is serialized as an\n  // array of [field, value] pairs in declaration order — no object key-order\n  // dependency — so the hash is invariant across runtimes.  Reordering the\n  // field list silently changes every hash.\n  //\n  // routeId is intentionally excluded.  This is a layout-scoped hash —\n  // sibling routes under the same layout must produce identical payload\n  // hashes, otherwise the cross-check rejects on payload hash mismatch\n  // before reaching the exact-equality gate.\n  // If the field list must change, bump the hash algorithm or namespace to\n  // avoid silent cross-deployment hash drift.\n  return createClientReusePayloadHash(\n    JSON.stringify({\n      artifactCompatibilityPairs: createCanonicalProofPairs(input),\n      layoutId: input.layoutId,\n      rootBoundaryId: input.rootBoundaryId,\n      variantCacheKey: input.variantCacheKey,\n    }),\n  );\n}\n\n// The app-route payload envelope is route-scoped and may not carry a render epoch\n// during this wave. Static-layout skip needs layout-scoped compatibility so\n// sibling-route navigation can reuse a retained static layout without treating\n// the source route id as part of the retained artifact identity.\n//\n// renderEpoch is scoped to layout identity (layoutId, rootBoundaryId) and the\n// rendering variant (variantCacheKey).  The leaf routeId is intentionally\n// excluded — sibling routes under the same layout must produce the same\n// renderEpoch, otherwise exact-equality skip gating would silently disable\n// skip transport for the primary use case (navigating between sibling pages).\nexport function createStaticLayoutClientReuseArtifactCompatibility(\n  input: StaticLayoutClientReuseProofInput,\n): ArtifactCompatibilityEnvelope {\n  return {\n    ...input.artifactCompatibility,\n    graphVersion: `static-layout-graph:${createClientReusePayloadHash(\n      JSON.stringify({\n        layoutId: input.layoutId,\n        rootBoundaryId: input.rootBoundaryId,\n      }),\n    )}`,\n    renderEpoch: `static-layout:${createClientReusePayloadHash(\n      JSON.stringify({\n        layoutId: input.layoutId,\n        rootBoundaryId: input.rootBoundaryId,\n        variantCacheKey: input.variantCacheKey,\n      }),\n    )}`,\n  };\n}\n"],"mappings":";;;AAgBA,SAAgB,qCAAqC,UAA0B;CAC7E,OAAO,iBAAiB,6BAA6B,SAAS;;AAGhE,SAAS,0BACP,OAC2B;CAC3B,OAAO,oCAAoC,KAAK,UAAU,CACxD,OACA,MAAM,sBAAsB,OAC7B,CAAC;;AAGJ,SAAgB,yCACd,OACQ;CAaR,OAAO,6BACL,KAAK,UAAU;EACb,4BAA4B,0BAA0B,MAAM;EAC5D,UAAU,MAAM;EAChB,gBAAgB,MAAM;EACtB,iBAAiB,MAAM;EACxB,CAAC,CACH;;AAaH,SAAgB,mDACd,OAC+B;CAC/B,OAAO;EACL,GAAG,MAAM;EACT,cAAc,uBAAuB,6BACnC,KAAK,UAAU;GACb,UAAU,MAAM;GAChB,gBAAgB,MAAM;GACvB,CAAC,CACH;EACD,aAAa,iBAAiB,6BAC5B,KAAK,UAAU;GACb,UAAU,MAAM;GAChB,gBAAgB,MAAM;GACtB,iBAAiB,MAAM;GACxB,CAAC,CACH;EACF"}

package/dist/shims/app-router-scroll-state.d.ts

@@ -1,12 +1,14 @@
 //#region src/shims/app-router-scroll-state.d.ts
 type AppRouterScrollIntent = Readonly<{
+  commitId: number | null;
   hash: string | null;
   id: number;
 }>;
 declare function beginAppRouterScrollIntent(hash: string | null): AppRouterScrollIntent;
 declare function clearAppRouterScrollIntent(): void;
 declare function getPendingAppRouterScrollIntent(): AppRouterScrollIntent | null;
-declare function consumeAppRouterScrollIntent(expected?: AppRouterScrollIntent): AppRouterScrollIntent | null;
+declare function claimAppRouterScrollIntentForCommit(expected: AppRouterScrollIntent | null | undefined, commitId: number): void;
+declare function consumeAppRouterScrollIntent(expected: AppRouterScrollIntent | null | undefined, commitId?: number): AppRouterScrollIntent | null;
 //#endregion
-export { AppRouterScrollIntent, beginAppRouterScrollIntent, clearAppRouterScrollIntent, consumeAppRouterScrollIntent, getPendingAppRouterScrollIntent };
+export { AppRouterScrollIntent, beginAppRouterScrollIntent, claimAppRouterScrollIntentForCommit, clearAppRouterScrollIntent, consumeAppRouterScrollIntent, getPendingAppRouterScrollIntent };
 //# sourceMappingURL=app-router-scroll-state.d.ts.map

package/dist/shims/app-router-scroll-state.js

@@ -12,6 +12,7 @@ function beginAppRouterScrollIntent(hash) {
 	const store = getScrollIntentStore();
 	store.nextId += 1;
 	const intent = {
+		commitId: null,
 		hash,
 		id: store.nextId
 	};
@@ -24,15 +25,27 @@ function clearAppRouterScrollIntent() {
 function getPendingAppRouterScrollIntent() {
 	return getScrollIntentStore().pending;
 }
-function consumeAppRouterScrollIntent(expected) {
+function claimAppRouterScrollIntentForCommit(expected, commitId) {
+	const store = getScrollIntentStore();
+	const intent = store.pending;
+	if (expected === null || expected === void 0 || intent === null) return;
+	if (intent.id !== expected.id) return;
+	store.pending = {
+		...intent,
+		commitId
+	};
+}
+function consumeAppRouterScrollIntent(expected, commitId) {
+	if (expected === null || expected === void 0) return null;
 	const store = getScrollIntentStore();
 	const intent = store.pending;
 	if (intent === null) return null;
-	if (expected && intent.id !== expected.id) return null;
+	if (intent.id !== expected.id) return null;
+	if (commitId !== void 0 && intent.commitId !== commitId) return null;
 	store.pending = null;
 	return intent;
 }
 //#endregion
-export { beginAppRouterScrollIntent, clearAppRouterScrollIntent, consumeAppRouterScrollIntent, getPendingAppRouterScrollIntent };
+export { beginAppRouterScrollIntent, claimAppRouterScrollIntentForCommit, clearAppRouterScrollIntent, consumeAppRouterScrollIntent, getPendingAppRouterScrollIntent };
 
 //# sourceMappingURL=app-router-scroll-state.js.map

package/dist/shims/app-router-scroll-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-router-scroll-state.js","names":[],"sources":["../../src/shims/app-router-scroll-state.ts"],"sourcesContent":["export type AppRouterScrollIntent = Readonly<{\n  hash: string | null;\n  id: number;\n}>;\n\n// A scroll intent is staged by `navigateClientSide` (next/navigation) before an\n// RSC navigation and consumed by the committed `AppRouterScrollTarget`. Both run\n// in the browser, but next/navigation and this module can be loaded through\n// separate Vite module instances (see the Symbol.for navigation state in\n// navigation.ts and AGENTS.md \"RSC and SSR Are Separate Vite Environments\"). If\n// the writer and consumer held different module-level copies, the staged intent\n// would be invisible to the consumer and scroll/focus would silently no-op.\n// Store the single pending intent and the id counter on a Symbol.for global so\n// every instance shares one slot, matching the rest of the navigation state.\nconst _SCROLL_INTENT_KEY = Symbol.for(\"vinext.appRouterScrollIntent\");\n\ntype ScrollIntentStore = {\n  nextId: number;\n  pending: AppRouterScrollIntent | null;\n};\n\ntype ScrollIntentGlobal = typeof globalThis & {\n  [_SCROLL_INTENT_KEY]?: ScrollIntentStore;\n};\n\nfunction getScrollIntentStore(): ScrollIntentStore {\n  const globalState = globalThis as ScrollIntentGlobal;\n  globalState[_SCROLL_INTENT_KEY] ??= { nextId: 0, pending: null };\n  return globalState[_SCROLL_INTENT_KEY]!;\n}\n\nexport function beginAppRouterScrollIntent(hash: string | null): AppRouterScrollIntent {\n  const store = getScrollIntentStore();\n  store.nextId += 1;\n  const intent = {\n    hash,\n    id: store.nextId,\n  };\n  store.pending = intent;\n  return intent;\n}\n\nexport function clearAppRouterScrollIntent(): void {\n  getScrollIntentStore().pending = null;\n}\n\nexport function getPendingAppRouterScrollIntent(): AppRouterScrollIntent | null {\n  return getScrollIntentStore().pending;\n}\n\nexport function consumeAppRouterScrollIntent(\n  expected?: AppRouterScrollIntent,\n): AppRouterScrollIntent | null {\n  const store = getScrollIntentStore();\n  const intent = store.pending;\n  if (intent === null) return null;\n  if (expected && intent.id !== expected.id) return null;\n\n  store.pending = null;\n  return intent;\n}\n"],"mappings":";AAcA,MAAM,qBAAqB,OAAO,IAAI,+BAA+B;AAWrE,SAAS,uBAA0C;CACjD,MAAM,cAAc;CACpB,YAAY,wBAAwB;EAAE,QAAQ;EAAG,SAAS;EAAM;CAChE,OAAO,YAAY;;AAGrB,SAAgB,2BAA2B,MAA4C;CACrF,MAAM,QAAQ,sBAAsB;CACpC,MAAM,UAAU;CAChB,MAAM,SAAS;EACb;EACA,IAAI,MAAM;EACX;CACD,MAAM,UAAU;CAChB,OAAO;;AAGT,SAAgB,6BAAmC;CACjD,sBAAsB,CAAC,UAAU;;AAGnC,SAAgB,kCAAgE;CAC9E,OAAO,sBAAsB,CAAC;;AAGhC,SAAgB,6BACd,UAC8B;CAC9B,MAAM,QAAQ,sBAAsB;CACpC,MAAM,SAAS,MAAM;CACrB,IAAI,WAAW,MAAM,OAAO;CAC5B,IAAI,YAAY,OAAO,OAAO,SAAS,IAAI,OAAO;CAElD,MAAM,UAAU;CAChB,OAAO"}
+{"version":3,"file":"app-router-scroll-state.js","names":[],"sources":["../../src/shims/app-router-scroll-state.ts"],"sourcesContent":["export type AppRouterScrollIntent = Readonly<{\n  commitId: number | null;\n  hash: string | null;\n  id: number;\n}>;\n\n// A scroll intent is staged by `navigateClientSide` (next/navigation) before an\n// RSC navigation and consumed by the committed `AppRouterScrollTarget`. Both run\n// in the browser, but next/navigation and this module can be loaded through\n// separate Vite module instances (see the Symbol.for navigation state in\n// navigation.ts and AGENTS.md \"RSC and SSR Are Separate Vite Environments\"). If\n// the writer and consumer held different module-level copies, the staged intent\n// would be invisible to the consumer and scroll/focus would silently no-op.\n// Store the single pending intent and the id counter on a Symbol.for global so\n// every instance shares one slot, matching the rest of the navigation state.\nconst _SCROLL_INTENT_KEY = Symbol.for(\"vinext.appRouterScrollIntent\");\n\ntype ScrollIntentStore = {\n  nextId: number;\n  pending: AppRouterScrollIntent | null;\n};\n\ntype ScrollIntentGlobal = typeof globalThis & {\n  [_SCROLL_INTENT_KEY]?: ScrollIntentStore;\n};\n\nfunction getScrollIntentStore(): ScrollIntentStore {\n  const globalState = globalThis as ScrollIntentGlobal;\n  globalState[_SCROLL_INTENT_KEY] ??= { nextId: 0, pending: null };\n  return globalState[_SCROLL_INTENT_KEY]!;\n}\n\nexport function beginAppRouterScrollIntent(hash: string | null): AppRouterScrollIntent {\n  const store = getScrollIntentStore();\n  store.nextId += 1;\n  const intent = {\n    commitId: null,\n    hash,\n    id: store.nextId,\n  };\n  store.pending = intent;\n  return intent;\n}\n\nexport function clearAppRouterScrollIntent(): void {\n  getScrollIntentStore().pending = null;\n}\n\nexport function getPendingAppRouterScrollIntent(): AppRouterScrollIntent | null {\n  return getScrollIntentStore().pending;\n}\n\nexport function claimAppRouterScrollIntentForCommit(\n  expected: AppRouterScrollIntent | null | undefined,\n  commitId: number,\n): void {\n  const store = getScrollIntentStore();\n  const intent = store.pending;\n  if (expected === null || expected === undefined || intent === null) return;\n  if (intent.id !== expected.id) return;\n\n  store.pending = {\n    ...intent,\n    commitId,\n  };\n}\n\nexport function consumeAppRouterScrollIntent(\n  expected: AppRouterScrollIntent | null | undefined,\n  commitId?: number,\n): AppRouterScrollIntent | null {\n  if (expected === null || expected === undefined) return null;\n  const store = getScrollIntentStore();\n  const intent = store.pending;\n  if (intent === null) return null;\n  if (intent.id !== expected.id) return null;\n  if (commitId !== undefined && intent.commitId !== commitId) return null;\n\n  store.pending = null;\n  return intent;\n}\n"],"mappings":";AAeA,MAAM,qBAAqB,OAAO,IAAI,+BAA+B;AAWrE,SAAS,uBAA0C;CACjD,MAAM,cAAc;CACpB,YAAY,wBAAwB;EAAE,QAAQ;EAAG,SAAS;EAAM;CAChE,OAAO,YAAY;;AAGrB,SAAgB,2BAA2B,MAA4C;CACrF,MAAM,QAAQ,sBAAsB;CACpC,MAAM,UAAU;CAChB,MAAM,SAAS;EACb,UAAU;EACV;EACA,IAAI,MAAM;EACX;CACD,MAAM,UAAU;CAChB,OAAO;;AAGT,SAAgB,6BAAmC;CACjD,sBAAsB,CAAC,UAAU;;AAGnC,SAAgB,kCAAgE;CAC9E,OAAO,sBAAsB,CAAC;;AAGhC,SAAgB,oCACd,UACA,UACM;CACN,MAAM,QAAQ,sBAAsB;CACpC,MAAM,SAAS,MAAM;CACrB,IAAI,aAAa,QAAQ,aAAa,KAAA,KAAa,WAAW,MAAM;CACpE,IAAI,OAAO,OAAO,SAAS,IAAI;CAE/B,MAAM,UAAU;EACd,GAAG;EACH;EACD;;AAGH,SAAgB,6BACd,UACA,UAC8B;CAC9B,IAAI,aAAa,QAAQ,aAAa,KAAA,GAAW,OAAO;CACxD,MAAM,QAAQ,sBAAsB;CACpC,MAAM,SAAS,MAAM;CACrB,IAAI,WAAW,MAAM,OAAO;CAC5B,IAAI,OAAO,OAAO,SAAS,IAAI,OAAO;CACtC,IAAI,aAAa,KAAA,KAAa,OAAO,aAAa,UAAU,OAAO;CAEnE,MAAM,UAAU;CAChB,OAAO"}

package/dist/shims/app-router-scroll.d.ts

@@ -1,14 +1,28 @@
 import * as React$1 from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/shims/app-router-scroll.d.ts
-declare class AppRouterScrollTarget extends React$1.Component<{
+declare class AppRouterScrollTargetInner extends React$1.Component<{
   children: React$1.ReactNode;
+  commitId: number | null;
 }> {
   handlePotentialScroll: () => void;
   componentDidMount(): void;
   componentDidUpdate(): void;
   render(): React$1.ReactNode;
 }
+declare function AppRouterScrollCommitProvider({
+  children,
+  commitId
+}: {
+  children?: React$1.ReactNode;
+  commitId: number | null;
+}): _$react_jsx_runtime0.JSX.Element;
+declare function AppRouterScrollTarget({
+  children
+}: {
+  children: React$1.ReactNode;
+}): _$react_jsx_runtime0.JSX.Element;
 //#endregion
-export { AppRouterScrollTarget };
+export { AppRouterScrollCommitProvider, AppRouterScrollTarget, AppRouterScrollTargetInner };
 //# sourceMappingURL=app-router-scroll.d.ts.map

package/dist/shims/app-router-scroll.js

@@ -2,8 +2,10 @@
 import { decodeHashFragment } from "./hash-scroll.js";
 import { consumeAppRouterScrollIntent, getPendingAppRouterScrollIntent } from "./app-router-scroll-state.js";
 import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
 import * as ReactDOM from "react-dom";
 //#region src/shims/app-router-scroll.tsx
+const AppRouterScrollCommitContext = React$1.createContext(null);
 const reactDomInternalsKey = "__DOM_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE";
 const rectProperties = [
 	"bottom",
@@ -71,15 +73,16 @@ function scrollToElement(target, hash) {
 		inline: "nearest"
 	});
 }
-var AppRouterScrollTarget = class extends React$1.Component {
+var AppRouterScrollTargetInner = class extends React$1.Component {
 	handlePotentialScroll = () => {
 		const intent = getPendingAppRouterScrollIntent();
 		if (intent === null) return;
+		if (this.props.commitId === null || intent.commitId !== this.props.commitId) return;
 		let target;
 		if (intent.hash !== null) target = getHashFragmentDomNode(intent.hash);
 		else target = findNextScrollTarget(findDOMNode(this));
 		if (target === null) return;
-		const consumed = consumeAppRouterScrollIntent(intent);
+		const consumed = consumeAppRouterScrollIntent(intent, this.props.commitId);
 		if (consumed === null) return;
 		scrollToElement(target, consumed.hash);
 		target.focus({ preventScroll: true });
@@ -94,7 +97,19 @@ var AppRouterScrollTarget = class extends React$1.Component {
 		return this.props.children;
 	}
 };
+function AppRouterScrollCommitProvider({ children, commitId }) {
+	return /* @__PURE__ */ jsx(AppRouterScrollCommitContext.Provider, {
+		value: commitId,
+		children
+	});
+}
+function AppRouterScrollTarget({ children }) {
+	return /* @__PURE__ */ jsx(AppRouterScrollTargetInner, {
+		commitId: React$1.useContext(AppRouterScrollCommitContext),
+		children
+	});
+}
 //#endregion
-export { AppRouterScrollTarget };
+export { AppRouterScrollCommitProvider, AppRouterScrollTarget, AppRouterScrollTargetInner };
 
 //# sourceMappingURL=app-router-scroll.js.map