vinext 0.0.46 → 0.0.48

package/dist/server/app-ssr-entry.js

@@ -1,31 +1,31 @@
+import { notFoundResponse } from "./http-error-responses.js";
 import { isOpenRedirectShaped } from "./request-pipeline.js";
-import { normalizeAppElements, readAppElementsMetadata } from "./app-elements.js";
+import { AppElementsWire } from "./app-elements-wire.js";
+import "./app-elements.js";
 import { ServerInsertedHTMLContext, clearServerInsertedHTML, renderServerInsertedHTML, setNavigationContext, useServerInsertedHTML } from "../shims/navigation.js";
 import { runWithNavigationContext } from "../shims/navigation-state.js";
 import { withScriptNonce } from "../shims/script-nonce-context.js";
 import { createInlineScriptTag, createNonceAttribute, escapeHtmlAttr, safeJsonStringify } from "./html.js";
 import { ElementsContext, Slot } from "../shims/slot.js";
+import { createClientReferencePreloader } from "./app-client-reference-preloader.js";
 import { deferUntilStreamConsumed } from "./app-page-stream.js";
 import { createRscEmbedTransform, createTickBufferedTransform } from "./app-ssr-stream.js";
 import { Fragment, createElement, use } from "react";
 import { renderToReadableStream, renderToStaticMarkup } from "react-dom/server.edge";
 import { createFromReadableStream } from "@vitejs/plugin-rsc/ssr";
-import * as clientReferences from "virtual:vite-rsc/client-references";
+import clientReferences from "virtual:vite-rsc/client-references";
 //#region src/server/app-ssr-entry.ts
-let clientRefsPreloaded = false;
-function getClientReferenceRequire() {
-	return globalThis.__vite_rsc_client_require__;
-}
-async function preloadClientReferences() {
-	if (clientRefsPreloaded) return;
-	const refs = clientReferences.default;
-	const clientRequire = getClientReferenceRequire();
-	if (!refs || !clientRequire) return;
-	await Promise.all(Object.keys(refs).map((id) => clientRequire(id).catch((error) => {
+const clientReferencePreloader = createClientReferencePreloader({
+	getReferences() {
+		return clientReferences;
+	},
+	getClientRequire() {
+		return globalThis.__vite_rsc_client_require__;
+	},
+	onPreloadError(id, error) {
 		if (process.env.NODE_ENV !== "production") console.warn("[vinext] failed to preload client ref:", id, error);
-	})));
-	clientRefsPreloaded = true;
-}
+	}
+});
 function ssrErrorDigest(input) {
 	let hash = 5381;
 	for (let i = input.length - 1; i >= 0; i--) hash = hash * 33 ^ input.charCodeAt(i);
@@ -66,7 +66,7 @@ function buildHeadInjectionHtml(navContext, bootstrapScriptContent, insertedHTML
 }
 async function handleSsr(rscStream, navContext, fontData, options) {
 	return runWithNavigationContext(async () => {
-		await preloadClientReferences();
+		await clientReferencePreloader.preload();
 		if (navContext) setNavigationContext(navContext);
 		clearServerInsertedHTML();
 		const cleanup = () => {
@@ -88,8 +88,9 @@ async function handleSsr(rscStream, navContext, fontData, options) {
 			let flightRoot = null;
 			function VinextFlightRoot() {
 				if (!flightRoot) flightRoot = createFromReadableStream(ssrStream);
-				const elements = normalizeAppElements(use(flightRoot));
-				const metadata = readAppElementsMetadata(elements);
+				const wireElements = use(flightRoot);
+				const elements = AppElementsWire.decode(wireElements);
+				const metadata = AppElementsWire.readMetadata(elements);
 				return createElement(ElementsContext.Provider, { value: elements }, createElement(Slot, { id: metadata.routeId }));
 			}
 			const root = createElement(VinextFlightRoot);
@@ -119,10 +120,10 @@ async function handleSsr(rscStream, navContext, fontData, options) {
 	});
 }
 var app_ssr_entry_default = { async fetch(request) {
-	if (isOpenRedirectShaped(new URL(request.url).pathname)) return new Response("404 Not Found", { status: 404 });
+	if (isOpenRedirectShaped(new URL(request.url).pathname)) return notFoundResponse();
 	const result = await (await import.meta.viteRsc.loadModule("rsc", "index")).default(request);
 	if (result instanceof Response) return result;
-	if (result == null) return new Response("Not Found", { status: 404 });
+	if (result == null) return notFoundResponse();
 	return new Response(String(result), { status: 200 });
 } };
 //#endregion

package/dist/server/app-ssr-entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-ssr-entry.js","names":["createReactElement"],"sources":["../../src/server/app-ssr-entry.ts"],"sourcesContent":["/// <reference types=\"@vitejs/plugin-rsc/types\" />\n\nimport type { ReactNode } from \"react\";\nimport { Fragment, createElement as createReactElement, use } from \"react\";\nimport { createFromReadableStream } from \"@vitejs/plugin-rsc/ssr\";\nimport { renderToReadableStream, renderToStaticMarkup } from \"react-dom/server.edge\";\nimport * as clientReferences from \"virtual:vite-rsc/client-references\";\nimport type { NavigationContext } from \"vinext/shims/navigation\";\nimport {\n  ServerInsertedHTMLContext,\n  clearServerInsertedHTML,\n  renderServerInsertedHTML,\n  setNavigationContext,\n  useServerInsertedHTML,\n} from \"vinext/shims/navigation\";\nimport { runWithNavigationContext } from \"vinext/shims/navigation-state\";\nimport { isOpenRedirectShaped } from \"./request-pipeline.js\";\nimport { withScriptNonce } from \"vinext/shims/script-nonce-context\";\nimport {\n  createInlineScriptTag,\n  createNonceAttribute,\n  escapeHtmlAttr,\n  safeJsonStringify,\n} from \"./html.js\";\nimport { createRscEmbedTransform, createTickBufferedTransform } from \"./app-ssr-stream.js\";\nimport { deferUntilStreamConsumed } from \"./app-page-stream.js\";\nimport {\n  normalizeAppElements,\n  readAppElementsMetadata,\n  type AppWireElements,\n} from \"./app-elements.js\";\nimport { ElementsContext, Slot } from \"vinext/shims/slot\";\n\nexport type FontPreload = {\n  href: string;\n  type: string;\n};\n\nexport type FontData = {\n  links?: string[];\n  styles?: string[];\n  preloads?: FontPreload[];\n};\n\ntype ClientRequire = (id: string) => Promise<unknown>;\n\nlet clientRefsPreloaded = false;\n\nfunction getClientReferenceRequire(): ClientRequire | undefined {\n  return (\n    globalThis as typeof globalThis & {\n      __vite_rsc_client_require__?: ClientRequire;\n    }\n  ).__vite_rsc_client_require__;\n}\n\nasync function preloadClientReferences(): Promise<void> {\n  if (clientRefsPreloaded) return;\n\n  const refs = (clientReferences as { default?: Record<string, unknown> }).default;\n  const clientRequire = getClientReferenceRequire();\n  if (!refs || !clientRequire) return;\n\n  await Promise.all(\n    Object.keys(refs).map((id) =>\n      clientRequire(id).catch((error) => {\n        if (process.env.NODE_ENV !== \"production\") {\n          console.warn(\"[vinext] failed to preload client ref:\", id, error);\n        }\n      }),\n    ),\n  );\n\n  clientRefsPreloaded = true;\n}\n\nfunction ssrErrorDigest(input: string): string {\n  let hash = 5381;\n  for (let i = input.length - 1; i >= 0; i--) {\n    hash = (hash * 33) ^ input.charCodeAt(i);\n  }\n  return (hash >>> 0).toString();\n}\n\nfunction getErrorMessage(error: unknown): string {\n  if (error instanceof Error) return error.message;\n  if (typeof error === \"string\") return error;\n  return Object.prototype.toString.call(error);\n}\n\nfunction renderInsertedHtml(insertedElements: readonly unknown[]): string {\n  let insertedHTML = \"\";\n\n  for (const element of insertedElements) {\n    try {\n      insertedHTML += renderToStaticMarkup(\n        createReactElement(Fragment, null, element as ReactNode),\n      );\n    } catch {\n      // Ignore individual callback failures so the rest of the page can render.\n    }\n  }\n\n  return insertedHTML;\n}\n\nfunction renderFontHtml(fontData?: FontData, nonce?: string): string {\n  if (!fontData) return \"\";\n\n  let fontHTML = \"\";\n  const nonceAttr = createNonceAttribute(nonce);\n\n  for (const url of fontData.links ?? []) {\n    fontHTML += `<link rel=\"stylesheet\"${nonceAttr} href=\"${escapeHtmlAttr(url)}\" />\\n`;\n  }\n\n  for (const preload of fontData.preloads ?? []) {\n    fontHTML += `<link rel=\"preload\"${nonceAttr} href=\"${escapeHtmlAttr(preload.href)}\" as=\"font\" type=\"${escapeHtmlAttr(preload.type)}\" crossorigin />\\n`;\n  }\n\n  if (fontData.styles && fontData.styles.length > 0) {\n    fontHTML += `<style data-vinext-fonts${nonceAttr}>${fontData.styles.join(\"\\n\")}</style>\\n`;\n  }\n\n  return fontHTML;\n}\n\nfunction extractModulePreloadHtml(bootstrapScriptContent?: string, nonce?: string): string {\n  if (!bootstrapScriptContent) return \"\";\n\n  const match = bootstrapScriptContent.match(/import\\(\"([^\"]+)\"\\)/);\n  if (!match?.[1]) return \"\";\n\n  return `<link rel=\"modulepreload\"${createNonceAttribute(nonce)} href=\"${escapeHtmlAttr(match[1])}\" />\\n`;\n}\n\nfunction buildHeadInjectionHtml(\n  navContext: NavigationContext | null,\n  bootstrapScriptContent: string | undefined,\n  insertedHTML: string,\n  fontHTML: string,\n  scriptNonce?: string,\n): string {\n  const paramsScript = createInlineScriptTag(\n    \"self.__VINEXT_RSC_PARAMS__=\" + safeJsonStringify(navContext?.params ?? {}),\n    scriptNonce,\n  );\n  const navPayload = {\n    pathname: navContext?.pathname ?? \"/\",\n    searchParams: navContext?.searchParams ? [...navContext.searchParams.entries()] : [],\n  };\n  const navScript = createInlineScriptTag(\n    \"self.__VINEXT_RSC_NAV__=\" + safeJsonStringify(navPayload),\n    scriptNonce,\n  );\n\n  return (\n    paramsScript +\n    navScript +\n    extractModulePreloadHtml(bootstrapScriptContent, scriptNonce) +\n    insertedHTML +\n    fontHTML\n  );\n}\n\nexport async function handleSsr(\n  rscStream: ReadableStream<Uint8Array>,\n  navContext: NavigationContext | null,\n  fontData?: FontData,\n  options?: {\n    scriptNonce?: string;\n    /** Pre-split side stream for embed+capture fusion. When provided,\n     *  rscStream is fed directly to createFromReadableStream (no internal tee).\n     *  The embed transform accumulates raw bytes. */\n    sideStream?: ReadableStream<Uint8Array>;\n    /** Out-parameter: filled with accumulated raw RSC bytes when sideStream is consumed. */\n    capturedRscDataRef?: { value: Promise<ArrayBuffer> | null };\n  },\n): Promise<ReadableStream<Uint8Array>> {\n  return runWithNavigationContext(async () => {\n    await preloadClientReferences();\n\n    if (navContext) {\n      setNavigationContext(navContext);\n    }\n\n    clearServerInsertedHTML();\n\n    const cleanup = (): void => {\n      setNavigationContext(null);\n      clearServerInsertedHTML();\n    };\n\n    try {\n      // Fused tee path (#981): caller pre-split the stream. No internal tee needed.\n      // sideStream carries both the embed transform and raw byte accumulation.\n      // rscStream is used directly for createFromReadableStream (SSR).\n      let ssrStream: ReadableStream<Uint8Array>;\n      let rscEmbed;\n\n      if (options?.sideStream) {\n        ssrStream = rscStream;\n        rscEmbed = createRscEmbedTransform(options.sideStream, options?.scriptNonce);\n        if (options.capturedRscDataRef) {\n          options.capturedRscDataRef.value = rscEmbed.getRawBuffer();\n        }\n      } else {\n        const [s1, s2] = rscStream.tee();\n        ssrStream = s1;\n        rscEmbed = createRscEmbedTransform(s2, options?.scriptNonce);\n      }\n\n      let flightRoot: PromiseLike<AppWireElements> | null = null;\n\n      function VinextFlightRoot(): ReactNode {\n        if (!flightRoot) {\n          flightRoot = createFromReadableStream<AppWireElements>(ssrStream);\n        }\n        const wireElements = use(flightRoot);\n        const elements = normalizeAppElements(wireElements);\n        const metadata = readAppElementsMetadata(elements);\n        return createReactElement(\n          ElementsContext.Provider,\n          { value: elements },\n          createReactElement(Slot, { id: metadata.routeId }),\n        );\n      }\n\n      const root = createReactElement(VinextFlightRoot);\n      const ssrTree = ServerInsertedHTMLContext\n        ? createReactElement(\n            ServerInsertedHTMLContext.Provider,\n            { value: useServerInsertedHTML },\n            root,\n          )\n        : root;\n      const ssrRoot = withScriptNonce(ssrTree, options?.scriptNonce);\n\n      const bootstrapScriptContent = await import.meta.viteRsc.loadBootstrapScriptContent(\"index\");\n\n      const htmlStream = await renderToReadableStream(ssrRoot, {\n        bootstrapScriptContent,\n        nonce: options?.scriptNonce,\n        onError(error) {\n          if (error && typeof error === \"object\" && \"digest\" in error) {\n            return String(error.digest);\n          }\n\n          if (process.env.NODE_ENV === \"production\" && error) {\n            const message = getErrorMessage(error);\n            const stack = error instanceof Error ? (error.stack ?? \"\") : \"\";\n            return ssrErrorDigest(message + stack);\n          }\n\n          return undefined;\n        },\n      });\n\n      const fontHTML = renderFontHtml(fontData, options?.scriptNonce);\n      let didInjectHeadHTML = false;\n      const getInsertedHTML = (): string => {\n        const insertedHTML = renderInsertedHtml(renderServerInsertedHTML());\n        if (didInjectHeadHTML) return insertedHTML;\n\n        didInjectHeadHTML = true;\n        return buildHeadInjectionHtml(\n          navContext,\n          bootstrapScriptContent,\n          insertedHTML,\n          fontHTML,\n          options?.scriptNonce,\n        );\n      };\n\n      return deferUntilStreamConsumed(\n        htmlStream.pipeThrough(createTickBufferedTransform(rscEmbed, getInsertedHTML)),\n        cleanup,\n      );\n    } catch (error) {\n      cleanup();\n      throw error;\n    }\n  }) as Promise<ReadableStream<Uint8Array>>;\n}\n\nexport default {\n  async fetch(request: Request): Promise<Response> {\n    const url = new URL(request.url);\n    // Block protocol-relative URL open redirects (including percent-encoded\n    // variants like /%5Cevil.com/). See request-pipeline.ts for details.\n    if (isOpenRedirectShaped(url.pathname)) {\n      return new Response(\"404 Not Found\", { status: 404 });\n    }\n\n    const rscModule = await import.meta.viteRsc.loadModule<{\n      default(request: Request): Promise<Response | string | null | undefined>;\n    }>(\"rsc\", \"index\");\n    const result = await rscModule.default(request);\n\n    if (result instanceof Response) {\n      return result;\n    }\n\n    if (result == null) {\n      return new Response(\"Not Found\", { status: 404 });\n    }\n\n    return new Response(String(result), { status: 200 });\n  },\n};\n"],"mappings":"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"}
+{"version":3,"file":"app-ssr-entry.js","names":["createReactElement"],"sources":["../../src/server/app-ssr-entry.ts"],"sourcesContent":["/// <reference types=\"@vitejs/plugin-rsc/types\" />\n\nimport type { ReactNode } from \"react\";\nimport { Fragment, createElement as createReactElement, use } from \"react\";\nimport { createFromReadableStream } from \"@vitejs/plugin-rsc/ssr\";\nimport { renderToReadableStream, renderToStaticMarkup } from \"react-dom/server.edge\";\nimport clientReferences from \"virtual:vite-rsc/client-references\";\nimport type { NavigationContext } from \"vinext/shims/navigation\";\nimport {\n  ServerInsertedHTMLContext,\n  clearServerInsertedHTML,\n  renderServerInsertedHTML,\n  setNavigationContext,\n  useServerInsertedHTML,\n} from \"vinext/shims/navigation\";\nimport { runWithNavigationContext } from \"vinext/shims/navigation-state\";\nimport { isOpenRedirectShaped } from \"./request-pipeline.js\";\nimport { notFoundResponse } from \"./http-error-responses.js\";\nimport { withScriptNonce } from \"vinext/shims/script-nonce-context\";\nimport {\n  createInlineScriptTag,\n  createNonceAttribute,\n  escapeHtmlAttr,\n  safeJsonStringify,\n} from \"./html.js\";\nimport { createRscEmbedTransform, createTickBufferedTransform } from \"./app-ssr-stream.js\";\nimport { deferUntilStreamConsumed } from \"./app-page-stream.js\";\nimport { AppElementsWire, type AppWireElements } from \"./app-elements.js\";\nimport { ElementsContext, Slot } from \"vinext/shims/slot\";\nimport { createClientReferencePreloader } from \"./app-client-reference-preloader.js\";\n\nexport type FontPreload = {\n  href: string;\n  type: string;\n};\n\nexport type FontData = {\n  links?: string[];\n  styles?: string[];\n  preloads?: FontPreload[];\n};\n\nconst clientReferencePreloader = createClientReferencePreloader({\n  getReferences() {\n    return clientReferences;\n  },\n  getClientRequire() {\n    return globalThis.__vite_rsc_client_require__;\n  },\n  onPreloadError(id, error) {\n    if (process.env.NODE_ENV !== \"production\") {\n      console.warn(\"[vinext] failed to preload client ref:\", id, error);\n    }\n  },\n});\n\nfunction ssrErrorDigest(input: string): string {\n  let hash = 5381;\n  for (let i = input.length - 1; i >= 0; i--) {\n    hash = (hash * 33) ^ input.charCodeAt(i);\n  }\n  return (hash >>> 0).toString();\n}\n\nfunction getErrorMessage(error: unknown): string {\n  if (error instanceof Error) return error.message;\n  if (typeof error === \"string\") return error;\n  return Object.prototype.toString.call(error);\n}\n\nfunction renderInsertedHtml(insertedElements: readonly unknown[]): string {\n  let insertedHTML = \"\";\n\n  for (const element of insertedElements) {\n    try {\n      insertedHTML += renderToStaticMarkup(\n        createReactElement(Fragment, null, element as ReactNode),\n      );\n    } catch {\n      // Ignore individual callback failures so the rest of the page can render.\n    }\n  }\n\n  return insertedHTML;\n}\n\nfunction renderFontHtml(fontData?: FontData, nonce?: string): string {\n  if (!fontData) return \"\";\n\n  let fontHTML = \"\";\n  const nonceAttr = createNonceAttribute(nonce);\n\n  for (const url of fontData.links ?? []) {\n    fontHTML += `<link rel=\"stylesheet\"${nonceAttr} href=\"${escapeHtmlAttr(url)}\" />\\n`;\n  }\n\n  for (const preload of fontData.preloads ?? []) {\n    fontHTML += `<link rel=\"preload\"${nonceAttr} href=\"${escapeHtmlAttr(preload.href)}\" as=\"font\" type=\"${escapeHtmlAttr(preload.type)}\" crossorigin />\\n`;\n  }\n\n  if (fontData.styles && fontData.styles.length > 0) {\n    fontHTML += `<style data-vinext-fonts${nonceAttr}>${fontData.styles.join(\"\\n\")}</style>\\n`;\n  }\n\n  return fontHTML;\n}\n\nfunction extractModulePreloadHtml(bootstrapScriptContent?: string, nonce?: string): string {\n  if (!bootstrapScriptContent) return \"\";\n\n  const match = bootstrapScriptContent.match(/import\\(\"([^\"]+)\"\\)/);\n  if (!match?.[1]) return \"\";\n\n  return `<link rel=\"modulepreload\"${createNonceAttribute(nonce)} href=\"${escapeHtmlAttr(match[1])}\" />\\n`;\n}\n\nfunction buildHeadInjectionHtml(\n  navContext: NavigationContext | null,\n  bootstrapScriptContent: string | undefined,\n  insertedHTML: string,\n  fontHTML: string,\n  scriptNonce?: string,\n): string {\n  const paramsScript = createInlineScriptTag(\n    \"self.__VINEXT_RSC_PARAMS__=\" + safeJsonStringify(navContext?.params ?? {}),\n    scriptNonce,\n  );\n  const navPayload = {\n    pathname: navContext?.pathname ?? \"/\",\n    searchParams: navContext?.searchParams ? [...navContext.searchParams.entries()] : [],\n  };\n  const navScript = createInlineScriptTag(\n    \"self.__VINEXT_RSC_NAV__=\" + safeJsonStringify(navPayload),\n    scriptNonce,\n  );\n\n  return (\n    paramsScript +\n    navScript +\n    extractModulePreloadHtml(bootstrapScriptContent, scriptNonce) +\n    insertedHTML +\n    fontHTML\n  );\n}\n\nexport async function handleSsr(\n  rscStream: ReadableStream<Uint8Array>,\n  navContext: NavigationContext | null,\n  fontData?: FontData,\n  options?: {\n    scriptNonce?: string;\n    /** Pre-split side stream for embed+capture fusion. When provided,\n     *  rscStream is fed directly to createFromReadableStream (no internal tee).\n     *  The embed transform accumulates raw bytes. */\n    sideStream?: ReadableStream<Uint8Array>;\n    /** Out-parameter: filled with accumulated raw RSC bytes when sideStream is consumed. */\n    capturedRscDataRef?: { value: Promise<ArrayBuffer> | null };\n  },\n): Promise<ReadableStream<Uint8Array>> {\n  return runWithNavigationContext(async () => {\n    await clientReferencePreloader.preload();\n\n    if (navContext) {\n      setNavigationContext(navContext);\n    }\n\n    clearServerInsertedHTML();\n\n    const cleanup = (): void => {\n      setNavigationContext(null);\n      clearServerInsertedHTML();\n    };\n\n    try {\n      // Fused tee path (#981): caller pre-split the stream. No internal tee needed.\n      // sideStream carries both the embed transform and raw byte accumulation.\n      // rscStream is used directly for createFromReadableStream (SSR).\n      let ssrStream: ReadableStream<Uint8Array>;\n      let rscEmbed;\n\n      if (options?.sideStream) {\n        ssrStream = rscStream;\n        rscEmbed = createRscEmbedTransform(options.sideStream, options?.scriptNonce);\n        if (options.capturedRscDataRef) {\n          options.capturedRscDataRef.value = rscEmbed.getRawBuffer();\n        }\n      } else {\n        const [s1, s2] = rscStream.tee();\n        ssrStream = s1;\n        rscEmbed = createRscEmbedTransform(s2, options?.scriptNonce);\n      }\n\n      let flightRoot: PromiseLike<AppWireElements> | null = null;\n\n      function VinextFlightRoot(): ReactNode {\n        if (!flightRoot) {\n          flightRoot = createFromReadableStream<AppWireElements>(ssrStream);\n        }\n        const wireElements = use(flightRoot);\n        const elements = AppElementsWire.decode(wireElements);\n        const metadata = AppElementsWire.readMetadata(elements);\n        return createReactElement(\n          ElementsContext.Provider,\n          { value: elements },\n          createReactElement(Slot, { id: metadata.routeId }),\n        );\n      }\n\n      const root = createReactElement(VinextFlightRoot);\n      const ssrTree = ServerInsertedHTMLContext\n        ? createReactElement(\n            ServerInsertedHTMLContext.Provider,\n            { value: useServerInsertedHTML },\n            root,\n          )\n        : root;\n      const ssrRoot = withScriptNonce(ssrTree, options?.scriptNonce);\n\n      const bootstrapScriptContent = await import.meta.viteRsc.loadBootstrapScriptContent(\"index\");\n\n      const htmlStream = await renderToReadableStream(ssrRoot, {\n        bootstrapScriptContent,\n        nonce: options?.scriptNonce,\n        onError(error) {\n          if (error && typeof error === \"object\" && \"digest\" in error) {\n            return String(error.digest);\n          }\n\n          if (process.env.NODE_ENV === \"production\" && error) {\n            const message = getErrorMessage(error);\n            const stack = error instanceof Error ? (error.stack ?? \"\") : \"\";\n            return ssrErrorDigest(message + stack);\n          }\n\n          return undefined;\n        },\n      });\n\n      const fontHTML = renderFontHtml(fontData, options?.scriptNonce);\n      let didInjectHeadHTML = false;\n      const getInsertedHTML = (): string => {\n        const insertedHTML = renderInsertedHtml(renderServerInsertedHTML());\n        if (didInjectHeadHTML) return insertedHTML;\n\n        didInjectHeadHTML = true;\n        return buildHeadInjectionHtml(\n          navContext,\n          bootstrapScriptContent,\n          insertedHTML,\n          fontHTML,\n          options?.scriptNonce,\n        );\n      };\n\n      return deferUntilStreamConsumed(\n        htmlStream.pipeThrough(createTickBufferedTransform(rscEmbed, getInsertedHTML)),\n        cleanup,\n      );\n    } catch (error) {\n      cleanup();\n      throw error;\n    }\n  }) as Promise<ReadableStream<Uint8Array>>;\n}\n\nexport default {\n  async fetch(request: Request): Promise<Response> {\n    const url = new URL(request.url);\n    // Block protocol-relative URL open redirects (including percent-encoded\n    // variants like /%5Cevil.com/). See request-pipeline.ts for details.\n    if (isOpenRedirectShaped(url.pathname)) {\n      return notFoundResponse();\n    }\n\n    const rscModule = await import.meta.viteRsc.loadModule<{\n      default(request: Request): Promise<Response | string | null | undefined>;\n    }>(\"rsc\", \"index\");\n    const result = await rscModule.default(request);\n\n    if (result instanceof Response) {\n      return result;\n    }\n\n    if (result == null) {\n      return notFoundResponse();\n    }\n\n    return new Response(String(result), { status: 200 });\n  },\n};\n"],"mappings":"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"}

package/dist/server/artifact-compatibility.d.ts

@@ -0,0 +1,44 @@
+//#region src/server/artifact-compatibility.d.ts
+declare const ARTIFACT_COMPATIBILITY_SCHEMA_VERSION = 1;
+declare const APP_ELEMENTS_SCHEMA_VERSION = 1;
+declare const RSC_PAYLOAD_SCHEMA_VERSION = 1;
+type ArtifactCompatibilityEnvelope = Readonly<{
+  schemaVersion: typeof ARTIFACT_COMPATIBILITY_SCHEMA_VERSION;
+  graphVersion: string | null;
+  deploymentVersion: string | null;
+  appElementsSchemaVersion: typeof APP_ELEMENTS_SCHEMA_VERSION;
+  rscPayloadSchemaVersion: typeof RSC_PAYLOAD_SCHEMA_VERSION;
+  rootBoundaryId: string | null;
+  renderEpoch: string | null;
+}>;
+type ArtifactCompatibilityEnvelopeInput = Readonly<{
+  graphVersion?: string | null;
+  deploymentVersion?: string | null;
+  rootBoundaryId?: string | null;
+  renderEpoch?: string | null;
+}>;
+type ArtifactCompatibilityFallback = "renderFresh";
+type ArtifactCompatibilityUnknownReason = "graphVersionUnknown" | "deploymentVersionUnknown" | "rootBoundaryIdUnknown" | "renderEpochUnknown";
+type ArtifactCompatibilityIncompatibleReason = "appElementsSchemaVersionMismatch" | "deploymentVersionMismatch" | "graphVersionMismatch" | "renderEpochMismatch" | "rootBoundaryIdMismatch" | "rscPayloadSchemaVersionMismatch" | "schemaVersionMismatch";
+type ArtifactCompatibilityDecision = Readonly<{
+  kind: "compatible";
+} | {
+  kind: "unknown";
+  fallback: ArtifactCompatibilityFallback;
+  reason: ArtifactCompatibilityUnknownReason;
+} | {
+  kind: "incompatible";
+  fallback: ArtifactCompatibilityFallback;
+  reason: ArtifactCompatibilityIncompatibleReason;
+}>;
+type ArtifactCompatibilityGraphVersionInput = Readonly<{
+  routePattern: string;
+  rootBoundaryId: string | null;
+}>;
+declare function createArtifactCompatibilityEnvelope(input?: ArtifactCompatibilityEnvelopeInput): ArtifactCompatibilityEnvelope;
+declare function createArtifactCompatibilityGraphVersion(input: ArtifactCompatibilityGraphVersionInput): string;
+declare function parseArtifactCompatibilityEnvelope(value: unknown): ArtifactCompatibilityEnvelope | null;
+declare function evaluateArtifactCompatibility(current: ArtifactCompatibilityEnvelope, candidate: ArtifactCompatibilityEnvelope): ArtifactCompatibilityDecision;
+//#endregion
+export { APP_ELEMENTS_SCHEMA_VERSION, ARTIFACT_COMPATIBILITY_SCHEMA_VERSION, ArtifactCompatibilityEnvelope, RSC_PAYLOAD_SCHEMA_VERSION, createArtifactCompatibilityEnvelope, createArtifactCompatibilityGraphVersion, evaluateArtifactCompatibility, parseArtifactCompatibilityEnvelope };
+//# sourceMappingURL=artifact-compatibility.d.ts.map

package/dist/server/artifact-compatibility.js

@@ -0,0 +1,82 @@
+import { fnv1a64 } from "../utils/hash.js";
+//#region src/server/artifact-compatibility.ts
+const ARTIFACT_COMPATIBILITY_SCHEMA_VERSION = 1;
+const APP_ELEMENTS_SCHEMA_VERSION = 1;
+const RSC_PAYLOAD_SCHEMA_VERSION = 1;
+function createArtifactCompatibilityEnvelope(input = {}) {
+	return {
+		schemaVersion: 1,
+		graphVersion: input.graphVersion ?? null,
+		deploymentVersion: input.deploymentVersion ?? null,
+		appElementsSchemaVersion: 1,
+		rscPayloadSchemaVersion: 1,
+		rootBoundaryId: input.rootBoundaryId ?? null,
+		renderEpoch: input.renderEpoch ?? null
+	};
+}
+function createArtifactCompatibilityGraphVersion(input) {
+	return `app-route-graph:${fnv1a64(JSON.stringify([input.routePattern, input.rootBoundaryId]))}`;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isStringOrNull(value) {
+	return typeof value === "string" || value === null;
+}
+function hasCurrentSchemaVersions(record) {
+	return record.schemaVersion === 1 && record.appElementsSchemaVersion === 1 && record.rscPayloadSchemaVersion === 1;
+}
+function parseArtifactCompatibilityEnvelope(value) {
+	if (!isRecord(value)) return null;
+	if (!hasCurrentSchemaVersions(value)) return null;
+	if (!isStringOrNull(value.graphVersion)) return null;
+	if (!isStringOrNull(value.deploymentVersion)) return null;
+	if (!isStringOrNull(value.rootBoundaryId)) return null;
+	if (!isStringOrNull(value.renderEpoch)) return null;
+	return {
+		schemaVersion: 1,
+		graphVersion: value.graphVersion,
+		deploymentVersion: value.deploymentVersion,
+		appElementsSchemaVersion: 1,
+		rscPayloadSchemaVersion: 1,
+		rootBoundaryId: value.rootBoundaryId,
+		renderEpoch: value.renderEpoch
+	};
+}
+function incompatible(reason) {
+	return {
+		kind: "incompatible",
+		fallback: "renderFresh",
+		reason
+	};
+}
+function unknown(reason) {
+	return {
+		kind: "unknown",
+		fallback: "renderFresh",
+		reason
+	};
+}
+function compareKnownField(currentValue, candidateValue, unknownReason, mismatchReason) {
+	if (currentValue === null || candidateValue === null) return unknown(unknownReason);
+	if (currentValue !== candidateValue) return incompatible(mismatchReason);
+	return null;
+}
+function evaluateArtifactCompatibility(current, candidate) {
+	if (current.schemaVersion !== candidate.schemaVersion) return incompatible("schemaVersionMismatch");
+	if (current.appElementsSchemaVersion !== candidate.appElementsSchemaVersion) return incompatible("appElementsSchemaVersionMismatch");
+	if (current.rscPayloadSchemaVersion !== candidate.rscPayloadSchemaVersion) return incompatible("rscPayloadSchemaVersionMismatch");
+	const graphDecision = compareKnownField(current.graphVersion, candidate.graphVersion, "graphVersionUnknown", "graphVersionMismatch");
+	if (graphDecision) return graphDecision;
+	const deploymentDecision = compareKnownField(current.deploymentVersion, candidate.deploymentVersion, "deploymentVersionUnknown", "deploymentVersionMismatch");
+	if (deploymentDecision) return deploymentDecision;
+	const rootBoundaryDecision = compareKnownField(current.rootBoundaryId, candidate.rootBoundaryId, "rootBoundaryIdUnknown", "rootBoundaryIdMismatch");
+	if (rootBoundaryDecision) return rootBoundaryDecision;
+	const renderEpochDecision = compareKnownField(current.renderEpoch, candidate.renderEpoch, "renderEpochUnknown", "renderEpochMismatch");
+	if (renderEpochDecision) return renderEpochDecision;
+	return { kind: "compatible" };
+}
+//#endregion
+export { APP_ELEMENTS_SCHEMA_VERSION, ARTIFACT_COMPATIBILITY_SCHEMA_VERSION, RSC_PAYLOAD_SCHEMA_VERSION, createArtifactCompatibilityEnvelope, createArtifactCompatibilityGraphVersion, evaluateArtifactCompatibility, parseArtifactCompatibilityEnvelope };
+
+//# sourceMappingURL=artifact-compatibility.js.map

package/dist/server/artifact-compatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-compatibility.js","names":[],"sources":["../../src/server/artifact-compatibility.ts"],"sourcesContent":["import { fnv1a64 } from \"../utils/hash.js\";\n\nexport const ARTIFACT_COMPATIBILITY_SCHEMA_VERSION = 1;\n\n// These versions describe separate protocol layers. For example, a future\n// rolling deploy can bump the flat AppElements row shape while keeping the\n// envelope object and serialized RSC transport version stable.\nexport const APP_ELEMENTS_SCHEMA_VERSION = 1;\nexport const RSC_PAYLOAD_SCHEMA_VERSION = 1;\n\nexport type ArtifactCompatibilityEnvelope = Readonly<{\n  schemaVersion: typeof ARTIFACT_COMPATIBILITY_SCHEMA_VERSION;\n  graphVersion: string | null;\n  deploymentVersion: string | null;\n  appElementsSchemaVersion: typeof APP_ELEMENTS_SCHEMA_VERSION;\n  rscPayloadSchemaVersion: typeof RSC_PAYLOAD_SCHEMA_VERSION;\n  rootBoundaryId: string | null;\n  renderEpoch: string | null;\n}>;\n\ntype ArtifactCompatibilityEnvelopeInput = Readonly<{\n  graphVersion?: string | null;\n  deploymentVersion?: string | null;\n  rootBoundaryId?: string | null;\n  renderEpoch?: string | null;\n}>;\n\ntype ArtifactCompatibilityFallback = \"renderFresh\";\n\ntype ArtifactCompatibilityUnknownReason =\n  | \"graphVersionUnknown\"\n  | \"deploymentVersionUnknown\"\n  | \"rootBoundaryIdUnknown\"\n  | \"renderEpochUnknown\";\n\ntype ArtifactCompatibilityIncompatibleReason =\n  | \"appElementsSchemaVersionMismatch\"\n  | \"deploymentVersionMismatch\"\n  | \"graphVersionMismatch\"\n  | \"renderEpochMismatch\"\n  | \"rootBoundaryIdMismatch\"\n  | \"rscPayloadSchemaVersionMismatch\"\n  | \"schemaVersionMismatch\";\n\ntype ArtifactCompatibilityDecision = Readonly<\n  | { kind: \"compatible\" }\n  | {\n      kind: \"unknown\";\n      fallback: ArtifactCompatibilityFallback;\n      reason: ArtifactCompatibilityUnknownReason;\n    }\n  | {\n      kind: \"incompatible\";\n      fallback: ArtifactCompatibilityFallback;\n      reason: ArtifactCompatibilityIncompatibleReason;\n    }\n>;\n\ntype ArtifactCompatibilityGraphVersionInput = Readonly<{\n  routePattern: string;\n  rootBoundaryId: string | null;\n}>;\n\nexport function createArtifactCompatibilityEnvelope(\n  input: ArtifactCompatibilityEnvelopeInput = {},\n): ArtifactCompatibilityEnvelope {\n  return {\n    schemaVersion: ARTIFACT_COMPATIBILITY_SCHEMA_VERSION,\n    graphVersion: input.graphVersion ?? null,\n    deploymentVersion: input.deploymentVersion ?? null,\n    appElementsSchemaVersion: APP_ELEMENTS_SCHEMA_VERSION,\n    rscPayloadSchemaVersion: RSC_PAYLOAD_SCHEMA_VERSION,\n    rootBoundaryId: input.rootBoundaryId ?? null,\n    renderEpoch: input.renderEpoch ?? null,\n  };\n}\n\nexport function createArtifactCompatibilityGraphVersion(\n  input: ArtifactCompatibilityGraphVersionInput,\n): string {\n  const fingerprint = fnv1a64(JSON.stringify([input.routePattern, input.rootBoundaryId]));\n  return `app-route-graph:${fingerprint}`;\n}\n\nfunction isRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isStringOrNull(value: unknown): value is string | null {\n  return typeof value === \"string\" || value === null;\n}\n\nfunction hasCurrentSchemaVersions(record: Readonly<Record<string, unknown>>): boolean {\n  return (\n    record.schemaVersion === ARTIFACT_COMPATIBILITY_SCHEMA_VERSION &&\n    record.appElementsSchemaVersion === APP_ELEMENTS_SCHEMA_VERSION &&\n    record.rscPayloadSchemaVersion === RSC_PAYLOAD_SCHEMA_VERSION\n  );\n}\n\nexport function parseArtifactCompatibilityEnvelope(\n  value: unknown,\n): ArtifactCompatibilityEnvelope | null {\n  if (!isRecord(value)) return null;\n  // The Wave01 skeleton intentionally collapses version mismatch and malformed\n  // metadata into \"not current\". Cache/skip callers must split those cases\n  // before treating unknown compatibility as anything other than a miss/reject.\n  if (!hasCurrentSchemaVersions(value)) return null;\n  if (!isStringOrNull(value.graphVersion)) return null;\n  if (!isStringOrNull(value.deploymentVersion)) return null;\n  if (!isStringOrNull(value.rootBoundaryId)) return null;\n  if (!isStringOrNull(value.renderEpoch)) return null;\n\n  // This parser intentionally returns a normalized current-version proof. A\n  // future-compatible reader should introduce a separate parsed type instead of\n  // widening this Wave01 envelope after the current-version checks above.\n  return {\n    schemaVersion: ARTIFACT_COMPATIBILITY_SCHEMA_VERSION,\n    graphVersion: value.graphVersion,\n    deploymentVersion: value.deploymentVersion,\n    appElementsSchemaVersion: APP_ELEMENTS_SCHEMA_VERSION,\n    rscPayloadSchemaVersion: RSC_PAYLOAD_SCHEMA_VERSION,\n    rootBoundaryId: value.rootBoundaryId,\n    renderEpoch: value.renderEpoch,\n  };\n}\n\nfunction incompatible(\n  reason: ArtifactCompatibilityIncompatibleReason,\n): ArtifactCompatibilityDecision {\n  return { kind: \"incompatible\", fallback: \"renderFresh\", reason };\n}\n\nfunction unknown(reason: ArtifactCompatibilityUnknownReason): ArtifactCompatibilityDecision {\n  return { kind: \"unknown\", fallback: \"renderFresh\", reason };\n}\n\nfunction compareKnownField(\n  currentValue: string | null,\n  candidateValue: string | null,\n  unknownReason: ArtifactCompatibilityUnknownReason,\n  mismatchReason: ArtifactCompatibilityIncompatibleReason,\n): ArtifactCompatibilityDecision | null {\n  if (currentValue === null || candidateValue === null) {\n    return unknown(unknownReason);\n  }\n  if (currentValue !== candidateValue) {\n    return incompatible(mismatchReason);\n  }\n  return null;\n}\n\nexport function evaluateArtifactCompatibility(\n  current: ArtifactCompatibilityEnvelope,\n  candidate: ArtifactCompatibilityEnvelope,\n): ArtifactCompatibilityDecision {\n  // Pre-positioned for #726-COMPAT-04/05, where cache and visited-response\n  // reuse paths will compare the current render proof with a candidate payload.\n  if (current.schemaVersion !== candidate.schemaVersion) {\n    return incompatible(\"schemaVersionMismatch\");\n  }\n  if (current.appElementsSchemaVersion !== candidate.appElementsSchemaVersion) {\n    return incompatible(\"appElementsSchemaVersionMismatch\");\n  }\n  if (current.rscPayloadSchemaVersion !== candidate.rscPayloadSchemaVersion) {\n    return incompatible(\"rscPayloadSchemaVersionMismatch\");\n  }\n\n  const graphDecision = compareKnownField(\n    current.graphVersion,\n    candidate.graphVersion,\n    \"graphVersionUnknown\",\n    \"graphVersionMismatch\",\n  );\n  if (graphDecision) return graphDecision;\n\n  const deploymentDecision = compareKnownField(\n    current.deploymentVersion,\n    candidate.deploymentVersion,\n    \"deploymentVersionUnknown\",\n    \"deploymentVersionMismatch\",\n  );\n  if (deploymentDecision) return deploymentDecision;\n\n  const rootBoundaryDecision = compareKnownField(\n    current.rootBoundaryId,\n    candidate.rootBoundaryId,\n    \"rootBoundaryIdUnknown\",\n    \"rootBoundaryIdMismatch\",\n  );\n  if (rootBoundaryDecision) return rootBoundaryDecision;\n\n  const renderEpochDecision = compareKnownField(\n    current.renderEpoch,\n    candidate.renderEpoch,\n    \"renderEpochUnknown\",\n    \"renderEpochMismatch\",\n  );\n  if (renderEpochDecision) return renderEpochDecision;\n\n  return { kind: \"compatible\" };\n}\n"],"mappings":";;AAEA,MAAa,wCAAwC;AAKrD,MAAa,8BAA8B;AAC3C,MAAa,6BAA6B;AAuD1C,SAAgB,oCACd,QAA4C,EAAE,EACf;AAC/B,QAAO;EACL,eAAA;EACA,cAAc,MAAM,gBAAgB;EACpC,mBAAmB,MAAM,qBAAqB;EAC9C,0BAAA;EACA,yBAAA;EACA,gBAAgB,MAAM,kBAAkB;EACxC,aAAa,MAAM,eAAe;EACnC;;AAGH,SAAgB,wCACd,OACQ;AAER,QAAO,mBADa,QAAQ,KAAK,UAAU,CAAC,MAAM,cAAc,MAAM,eAAe,CAAC,CAAC;;AAIzF,SAAS,SAAS,OAA4D;AAC5E,QAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM;;AAG7E,SAAS,eAAe,OAAwC;AAC9D,QAAO,OAAO,UAAU,YAAY,UAAU;;AAGhD,SAAS,yBAAyB,QAAoD;AACpF,QACE,OAAO,kBAAA,KACP,OAAO,6BAAA,KACP,OAAO,4BAAA;;AAIX,SAAgB,mCACd,OACsC;AACtC,KAAI,CAAC,SAAS,MAAM,CAAE,QAAO;AAI7B,KAAI,CAAC,yBAAyB,MAAM,CAAE,QAAO;AAC7C,KAAI,CAAC,eAAe,MAAM,aAAa,CAAE,QAAO;AAChD,KAAI,CAAC,eAAe,MAAM,kBAAkB,CAAE,QAAO;AACrD,KAAI,CAAC,eAAe,MAAM,eAAe,CAAE,QAAO;AAClD,KAAI,CAAC,eAAe,MAAM,YAAY,CAAE,QAAO;AAK/C,QAAO;EACL,eAAA;EACA,cAAc,MAAM;EACpB,mBAAmB,MAAM;EACzB,0BAAA;EACA,yBAAA;EACA,gBAAgB,MAAM;EACtB,aAAa,MAAM;EACpB;;AAGH,SAAS,aACP,QAC+B;AAC/B,QAAO;EAAE,MAAM;EAAgB,UAAU;EAAe;EAAQ;;AAGlE,SAAS,QAAQ,QAA2E;AAC1F,QAAO;EAAE,MAAM;EAAW,UAAU;EAAe;EAAQ;;AAG7D,SAAS,kBACP,cACA,gBACA,eACA,gBACsC;AACtC,KAAI,iBAAiB,QAAQ,mBAAmB,KAC9C,QAAO,QAAQ,cAAc;AAE/B,KAAI,iBAAiB,eACnB,QAAO,aAAa,eAAe;AAErC,QAAO;;AAGT,SAAgB,8BACd,SACA,WAC+B;AAG/B,KAAI,QAAQ,kBAAkB,UAAU,cACtC,QAAO,aAAa,wBAAwB;AAE9C,KAAI,QAAQ,6BAA6B,UAAU,yBACjD,QAAO,aAAa,mCAAmC;AAEzD,KAAI,QAAQ,4BAA4B,UAAU,wBAChD,QAAO,aAAa,kCAAkC;CAGxD,MAAM,gBAAgB,kBACpB,QAAQ,cACR,UAAU,cACV,uBACA,uBACD;AACD,KAAI,cAAe,QAAO;CAE1B,MAAM,qBAAqB,kBACzB,QAAQ,mBACR,UAAU,mBACV,4BACA,4BACD;AACD,KAAI,mBAAoB,QAAO;CAE/B,MAAM,uBAAuB,kBAC3B,QAAQ,gBACR,UAAU,gBACV,yBACA,yBACD;AACD,KAAI,qBAAsB,QAAO;CAEjC,MAAM,sBAAsB,kBAC1B,QAAQ,aACR,UAAU,aACV,sBACA,sBACD;AACD,KAAI,oBAAqB,QAAO;AAEhC,QAAO,EAAE,MAAM,cAAc"}

package/dist/server/cache-control.d.ts

@@ -0,0 +1,24 @@
+//#region src/server/cache-control.d.ts
+declare const NEVER_CACHE_CONTROL = "private, no-cache, no-store, max-age=0, must-revalidate";
+declare const STATIC_CACHE_CONTROL = "s-maxage=31536000, stale-while-revalidate";
+declare const NO_STORE_CACHE_CONTROL = "no-store, must-revalidate";
+/**
+ * Matches Next.js's `getCacheControlHeader` stale window semantics while
+ * preserving vinext's legacy unbounded SWR header when no expire ceiling is
+ * available yet.
+ *
+ * Next.js source:
+ * https://github.com/vercel/next.js/blob/canary/packages/next/src/server/lib/cache-control.ts
+ */
+declare function buildRevalidateCacheControl(revalidateSeconds: number, expireSeconds?: number): string;
+/**
+ * Builds Cache-Control for ISR cache reads. HIT responses and STALE responses
+ * with stored expire metadata use the same route policy because Next.js derives
+ * this header from cache-control metadata, not from the cache hit/stale state.
+ * STALE entries without expire metadata keep vinext's legacy `s-maxage=0`
+ * fallback so older cache entries are not treated as newly fresh downstream.
+ */
+declare function buildCachedRevalidateCacheControl(cacheState: "HIT" | "STALE", revalidateSeconds: number, expireSeconds?: number): string;
+//#endregion
+export { NEVER_CACHE_CONTROL, NO_STORE_CACHE_CONTROL, STATIC_CACHE_CONTROL, buildCachedRevalidateCacheControl, buildRevalidateCacheControl };
+//# sourceMappingURL=cache-control.d.ts.map

package/dist/server/cache-control.js

@@ -0,0 +1,33 @@
+//#region src/server/cache-control.ts
+const NEVER_CACHE_CONTROL = "private, no-cache, no-store, max-age=0, must-revalidate";
+const STATIC_CACHE_CONTROL = "s-maxage=31536000, stale-while-revalidate";
+const STALE_REVALIDATE_CACHE_CONTROL = "s-maxage=0, stale-while-revalidate";
+const NO_STORE_CACHE_CONTROL = "no-store, must-revalidate";
+/**
+* Matches Next.js's `getCacheControlHeader` stale window semantics while
+* preserving vinext's legacy unbounded SWR header when no expire ceiling is
+* available yet.
+*
+* Next.js source:
+* https://github.com/vercel/next.js/blob/canary/packages/next/src/server/lib/cache-control.ts
+*/
+function buildRevalidateCacheControl(revalidateSeconds, expireSeconds) {
+	if (expireSeconds === void 0) return `s-maxage=${revalidateSeconds}, stale-while-revalidate`;
+	if (revalidateSeconds >= expireSeconds) return `s-maxage=${revalidateSeconds}`;
+	return `s-maxage=${revalidateSeconds}, stale-while-revalidate=${expireSeconds - revalidateSeconds}`;
+}
+/**
+* Builds Cache-Control for ISR cache reads. HIT responses and STALE responses
+* with stored expire metadata use the same route policy because Next.js derives
+* this header from cache-control metadata, not from the cache hit/stale state.
+* STALE entries without expire metadata keep vinext's legacy `s-maxage=0`
+* fallback so older cache entries are not treated as newly fresh downstream.
+*/
+function buildCachedRevalidateCacheControl(cacheState, revalidateSeconds, expireSeconds) {
+	if (cacheState === "STALE" && expireSeconds === void 0) return STALE_REVALIDATE_CACHE_CONTROL;
+	return buildRevalidateCacheControl(revalidateSeconds, expireSeconds);
+}
+//#endregion
+export { NEVER_CACHE_CONTROL, NO_STORE_CACHE_CONTROL, STATIC_CACHE_CONTROL, buildCachedRevalidateCacheControl, buildRevalidateCacheControl };
+
+//# sourceMappingURL=cache-control.js.map

package/dist/server/cache-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-control.js","names":[],"sources":["../../src/server/cache-control.ts"],"sourcesContent":["export const NEVER_CACHE_CONTROL = \"private, no-cache, no-store, max-age=0, must-revalidate\";\n\nexport const STATIC_CACHE_CONTROL = \"s-maxage=31536000, stale-while-revalidate\";\n\nconst STALE_REVALIDATE_CACHE_CONTROL = \"s-maxage=0, stale-while-revalidate\";\n\nexport const NO_STORE_CACHE_CONTROL = \"no-store, must-revalidate\";\n\n/**\n * Matches Next.js's `getCacheControlHeader` stale window semantics while\n * preserving vinext's legacy unbounded SWR header when no expire ceiling is\n * available yet.\n *\n * Next.js source:\n * https://github.com/vercel/next.js/blob/canary/packages/next/src/server/lib/cache-control.ts\n */\nexport function buildRevalidateCacheControl(\n  revalidateSeconds: number,\n  expireSeconds?: number,\n): string {\n  if (expireSeconds === undefined) {\n    return `s-maxage=${revalidateSeconds}, stale-while-revalidate`;\n  }\n\n  // `expire <= revalidate` is a zero-width stale window: downstream caches\n  // should refetch after s-maxage instead of serving stale.\n  if (revalidateSeconds >= expireSeconds) {\n    return `s-maxage=${revalidateSeconds}`;\n  }\n\n  return `s-maxage=${revalidateSeconds}, stale-while-revalidate=${\n    expireSeconds - revalidateSeconds\n  }`;\n}\n\n/**\n * Builds Cache-Control for ISR cache reads. HIT responses and STALE responses\n * with stored expire metadata use the same route policy because Next.js derives\n * this header from cache-control metadata, not from the cache hit/stale state.\n * STALE entries without expire metadata keep vinext's legacy `s-maxage=0`\n * fallback so older cache entries are not treated as newly fresh downstream.\n */\nexport function buildCachedRevalidateCacheControl(\n  cacheState: \"HIT\" | \"STALE\",\n  revalidateSeconds: number,\n  expireSeconds?: number,\n): string {\n  // When expire is known, match Next.js and emit the route policy even for\n  // vinext-served STALE entries. The hard-expire gate has already decided the\n  // stale payload is still usable, and downstream caches should see the same\n  // finite SWR window Next.js would emit from cacheControl metadata.\n  if (cacheState === \"STALE\" && expireSeconds === undefined) {\n    return STALE_REVALIDATE_CACHE_CONTROL;\n  }\n\n  return buildRevalidateCacheControl(revalidateSeconds, expireSeconds);\n}\n"],"mappings":";AAAA,MAAa,sBAAsB;AAEnC,MAAa,uBAAuB;AAEpC,MAAM,iCAAiC;AAEvC,MAAa,yBAAyB;;;;;;;;;AAUtC,SAAgB,4BACd,mBACA,eACQ;AACR,KAAI,kBAAkB,KAAA,EACpB,QAAO,YAAY,kBAAkB;AAKvC,KAAI,qBAAqB,cACvB,QAAO,YAAY;AAGrB,QAAO,YAAY,kBAAkB,2BACnC,gBAAgB;;;;;;;;;AAWpB,SAAgB,kCACd,YACA,mBACA,eACQ;AAKR,KAAI,eAAe,WAAW,kBAAkB,KAAA,EAC9C,QAAO;AAGT,QAAO,4BAA4B,mBAAmB,cAAc"}

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

@@ -0,0 +1,200 @@
+import { AppRouteSemanticIds } from "../routing/app-route-graph.js";
+
+//#region src/server/cache-proof.d.ts
+declare const CACHE_PROOF_MODEL_SCHEMA_VERSION = 0;
+type CacheProofModelSchemaVersion = 0;
+type CacheProofRejectionCode = "CP_MODEL_DISABLED" | "CP_DIMENSION_COUNT_EXCEEDED" | "CP_DIMENSION_NAME_MISSING" | "CP_DIMENSION_NAME_TOO_LONG" | "CP_DIMENSION_VALUE_COUNT_EXCEEDED" | "CP_DIMENSION_VALUE_TOO_LONG" | "CP_DIMENSION_VALUES_MISSING" | "CP_ENCODED_VARIANT_TOO_LONG" | "CP_INVALID_VARIANT_BUDGET" | "CP_ROUTE_VARIANT_CEILING_EXCEEDED" | "CP_UNSAFE_PUBLIC_DIMENSION" | "CP_BOUNDARY_OUTCOME_MISMATCH" | "CP_BOUNDARY_OUTCOME_UNKNOWN";
+type CacheProofTraceFieldValue = string | number | boolean | null | readonly string[];
+type CacheProofTraceFields = Readonly<Record<string, CacheProofTraceFieldValue>>;
+type CacheProofBreakerFallbackMode = "renderFresh" | "privateUncacheable";
+type CacheProofFallbackScope = "affectedOutput" | "route";
+type CacheProofBreakerFallback = Readonly<{
+  kind: "breakerFallback";
+  code: CacheProofRejectionCode;
+  mode: CacheProofBreakerFallbackMode;
+  scope: CacheProofFallbackScope;
+  fields: CacheProofTraceFields;
+}>;
+type CacheVariantBudget = Readonly<{
+  maxDimensionCount: number;
+  maxDimensionNameLength: number;
+  maxDimensionValueLength: number;
+  maxEncodedLength: number;
+  maxValuesPerDimension: number;
+  maxVariantsPerRoute: number;
+}>;
+declare const DEFAULT_CACHE_VARIANT_BUDGET: {
+  maxDimensionCount: number;
+  maxDimensionNameLength: number;
+  maxDimensionValueLength: number;
+  maxEncodedLength: number;
+  maxValuesPerDimension: number;
+  maxVariantsPerRoute: number;
+};
+type CacheVariantDimensionSource = "auth" | "cookie" | "custom" | "draft-mode" | "header" | "interception" | "mounted-slots" | "params" | "route" | "search" | "session";
+type CacheVariantDimensionPrivacy = "internal" | "private" | "public";
+type CacheVariantDimensionInput = Readonly<{
+  name: string;
+  privacy: CacheVariantDimensionPrivacy;
+  source: CacheVariantDimensionSource;
+  values: readonly string[];
+}>;
+type CacheVariantDimension = Readonly<{
+  encoded: string;
+  name: string;
+  privacy: CacheVariantDimensionPrivacy;
+  source: CacheVariantDimensionSource;
+  valueCount: number;
+  valueHashes: readonly string[];
+}>;
+type CacheProofOutputScope = Readonly<{
+  kind: "app-html";
+  renderEpoch: string | null;
+  rootBoundaryId: string | null;
+  routeId: string;
+}> | Readonly<{
+  kind: "app-rsc";
+  mountedSlotsFingerprint: string | null;
+  renderEpoch: string | null;
+  rootBoundaryId: string | null;
+  routeId: string;
+}> | Readonly<{
+  kind: "layout";
+  layoutId: string;
+  rootBoundaryId: string | null;
+  routeId: string;
+}> | Readonly<{
+  kind: "page";
+  pageId: string;
+  rootBoundaryId: string | null;
+  routeId: string;
+}> | Readonly<{
+  kind: "route-handler";
+  routeHandlerId: string;
+  routeId: string;
+}> | Readonly<{
+  kind: "slot";
+  rootBoundaryId: string | null;
+  routeId: string;
+  slotId: string;
+}> | Readonly<{
+  kind: "template";
+  rootBoundaryId: string | null;
+  routeId: string;
+  templateId: string;
+}>;
+type CacheVariant = Readonly<{
+  budget: CacheVariantBudget;
+  cacheKey: string;
+  dimensions: readonly CacheVariantDimension[];
+  encodedLength: number;
+  output: CacheProofOutputScope;
+  schemaVersion: CacheProofModelSchemaVersion;
+}>;
+type BuildCacheVariantInput = Readonly<{
+  budget: CacheVariantBudget;
+  dimensions: readonly CacheVariantDimensionInput[];
+  existingVariantCount: number;
+  output: CacheProofOutputScope;
+}>;
+type BuildCacheVariantResult = Readonly<{
+  kind: "variant";
+  variant: CacheVariant;
+}> | Readonly<{
+  kind: "breakerFallback";
+  fallback: CacheProofBreakerFallback;
+}>;
+type AppRouteCacheProofGraphScopeInput = Readonly<{
+  ids: AppRouteSemanticIds;
+}>;
+type AppRouteCacheProofGraphScope = Readonly<{
+  layoutIds: readonly string[];
+  pageId: string | null;
+  routeHandlerId: string | null;
+  routeId: string;
+  slotIds: readonly string[];
+  templateIds: readonly string[];
+}>;
+type BoundaryOutcome = Readonly<{
+  kind: "error";
+  digest?: string;
+}> | Readonly<{
+  kind: "forbidden";
+}> | Readonly<{
+  kind: "globalError";
+  digest?: string;
+}> | Readonly<{
+  kind: "notFound";
+}> | Readonly<{
+  kind: "redirect";
+  location: string;
+  status: number;
+}> | Readonly<{
+  kind: "success";
+}> | Readonly<{
+  kind: "unauthorized";
+}> | Readonly<{
+  kind: "unknown";
+}>;
+type BoundaryOutcomeCompatibility = Readonly<{
+  kind: "compatible";
+  outcome: BoundaryOutcome;
+  reason: "CP_BOUNDARY_OUTCOME_MATCH";
+}> | Readonly<{
+  candidate: BoundaryOutcome;
+  expected: BoundaryOutcome;
+  fallback: CacheProofBreakerFallback;
+  kind: "incompatible";
+}>;
+type RenderObservationCompleteness = "complete" | "partial" | "unknown";
+type RenderCacheability = "private" | "public" | "uncacheable" | "unknown";
+type RenderRequestApiKind = "connection" | "cookies" | "draftMode" | "headers" | "params" | "searchParams";
+type RenderRequestApiStatus = "notObserved" | "observed" | "unknown";
+type RenderRequestApiObservation = Readonly<{
+  kind: RenderRequestApiKind;
+  status: RenderRequestApiStatus;
+}>;
+type RenderObservation = Readonly<{
+  boundaryOutcome: BoundaryOutcome;
+  cacheTags: readonly string[];
+  cacheability: RenderCacheability;
+  completeness: RenderObservationCompleteness;
+  dynamicFetches: readonly string[];
+  output: CacheProofOutputScope;
+  pathTags: readonly string[];
+  requestApis: readonly RenderRequestApiObservation[];
+  schemaVersion: CacheProofModelSchemaVersion;
+}>;
+type BuildRenderObservationInput = Readonly<{
+  boundaryOutcome: BoundaryOutcome;
+  cacheTags: readonly string[];
+  cacheability: RenderCacheability;
+  completeness: RenderObservationCompleteness;
+  dynamicFetches: readonly string[];
+  output: CacheProofOutputScope;
+  pathTags: readonly string[];
+  requestApis: readonly RenderRequestApiObservation[];
+}>;
+type DisabledCacheProofDecision = Readonly<{
+  canReuse: false;
+  fallback: CacheProofBreakerFallback;
+  kind: "disabled";
+  observation: RenderObservation;
+  variant: CacheVariant;
+}>;
+type CreateDisabledCacheProofDecisionInput = Readonly<{
+  observation: RenderObservation;
+  variant: CacheVariant;
+}>;
+declare function createAppRouteCacheProofGraphScope(route: AppRouteCacheProofGraphScopeInput): AppRouteCacheProofGraphScope;
+declare function buildCacheVariant(input: BuildCacheVariantInput): BuildCacheVariantResult;
+declare function buildBoundaryOutcomeCompatibility(input: {
+  candidate: BoundaryOutcome;
+  expected: BoundaryOutcome;
+}): BoundaryOutcomeCompatibility;
+declare function buildRenderObservation(input: BuildRenderObservationInput): RenderObservation;
+declare function hasCompleteNegativeRequestApiProof(observation: RenderObservation, requiredApis: readonly RenderRequestApiKind[]): boolean;
+declare function createDisabledCacheProofDecision(input: CreateDisabledCacheProofDecisionInput): DisabledCacheProofDecision;
+//#endregion
+export { AppRouteCacheProofGraphScope, AppRouteCacheProofGraphScopeInput, BoundaryOutcome, BoundaryOutcomeCompatibility, BuildCacheVariantInput, BuildCacheVariantResult, BuildRenderObservationInput, CACHE_PROOF_MODEL_SCHEMA_VERSION, CacheProofBreakerFallback, CacheProofBreakerFallbackMode, CacheProofFallbackScope, CacheProofModelSchemaVersion, CacheProofOutputScope, CacheProofRejectionCode, CacheProofTraceFieldValue, CacheProofTraceFields, CacheVariant, CacheVariantBudget, CacheVariantDimension, CacheVariantDimensionInput, CacheVariantDimensionPrivacy, CacheVariantDimensionSource, CreateDisabledCacheProofDecisionInput, DEFAULT_CACHE_VARIANT_BUDGET, DisabledCacheProofDecision, RenderCacheability, RenderObservation, RenderObservationCompleteness, RenderRequestApiKind, RenderRequestApiObservation, RenderRequestApiStatus, buildBoundaryOutcomeCompatibility, buildCacheVariant, buildRenderObservation, createAppRouteCacheProofGraphScope, createDisabledCacheProofDecision, hasCompleteNegativeRequestApiProof };
+//# sourceMappingURL=cache-proof.d.ts.map