vinext 0.0.49 → 0.0.51

package/dist/server/app-ssr-entry.d.ts

@@ -1,4 +1,5 @@
 import { NavigationContext } from "../shims/navigation.js";
+import { ReactFormState } from "react-dom/client";
 
 //#region src/server/app-ssr-entry.d.ts
 type FontPreload = {
@@ -19,6 +20,12 @@ declare function handleSsr(rscStream: ReadableStream<Uint8Array>, navContext: Na
   capturedRscDataRef?: {
     value: Promise<ArrayBuffer> | null;
   };
+  formState?: ReactFormState | null;
+  basePath?: string;
+  /** When true, wait for the full React tree (including Suspense boundaries)
+   *  to resolve before returning the HTML stream. Used for static prerender
+   *  and ISR cache writes to avoid caching fallback content. */
+  waitForAllReady?: boolean;
 }): Promise<ReadableStream<Uint8Array>>;
 declare const _default: {
   fetch(request: Request): Promise<Response>;

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

@@ -1,15 +1,19 @@
+import "./server-globals.js";
 import { notFoundResponse } from "./http-error-responses.js";
 import { isOpenRedirectShaped } from "./request-pipeline.js";
 import { AppElementsWire } from "./app-elements-wire.js";
 import "./app-elements.js";
-import { ServerInsertedHTMLContext, clearServerInsertedHTML, renderServerInsertedHTML, setNavigationContext, useServerInsertedHTML } from "../shims/navigation.js";
+import { AppRouterContext } from "../shims/internal/app-router-context.js";
+import { ServerInsertedHTMLContext, appRouterInstance, 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 { RSC_FORM_STATE_GLOBAL } from "./app-browser-hydration.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 { createSsrErrorMetaRenderer } from "./app-ssr-error-meta.js";
 import { Fragment, createElement, use } from "react";
 import { renderToReadableStream, renderToStaticMarkup } from "react-dom/server.edge";
 import { createFromReadableStream } from "@vitejs/plugin-rsc/ssr";
@@ -52,17 +56,37 @@ function renderFontHtml(fontData, nonce) {
 	if (fontData.styles && fontData.styles.length > 0) fontHTML += `<style data-vinext-fonts${nonceAttr}>${fontData.styles.join("\n")}</style>\n`;
 	return fontHTML;
 }
-function extractModulePreloadHtml(bootstrapScriptContent, nonce) {
-	if (!bootstrapScriptContent) return "";
-	const match = bootstrapScriptContent.match(/import\("([^"]+)"\)/);
-	if (!match?.[1]) return "";
-	return `<link rel="modulepreload"${createNonceAttribute(nonce)} href="${escapeHtmlAttr(match[1])}" />\n`;
+/**
+* Extract the bootstrap module URL from the `import("...")` string that
+* `import.meta.viteRsc.loadBootstrapScriptContent("index")` returns.
+*
+* The plugin-rsc helper returns the bootstrap as an inline call so we can
+* inject it via `bootstrapScriptContent`. We instead pass the URL to
+* React's `bootstrapModules` option so a real
+* `<script type="module" src="…">` tag ends up in the streamed HTML —
+* this exposes the URL to anything that reads `script.attribs.src` (e.g.
+* the Next.js asset-prefix fixture test). The same URL also feeds the
+* `<link rel="modulepreload">` we emit ahead of the bootstrap.
+*
+* Returns `undefined` when the helper produced no URL (older plugin-rsc
+* versions, or a custom client entry that disables bootstrap content).
+*/
+function extractBootstrapModuleUrl(bootstrapScriptContent) {
+	if (!bootstrapScriptContent) return void 0;
+	return bootstrapScriptContent.match(/import\(["']([^"']+)["']\)/)?.[1] ?? void 0;
 }
-function buildHeadInjectionHtml(navContext, bootstrapScriptContent, insertedHTML, fontHTML, scriptNonce) {
-	return createInlineScriptTag("self.__VINEXT_RSC_PARAMS__=" + safeJsonStringify(navContext?.params ?? {}), scriptNonce) + createInlineScriptTag("self.__VINEXT_RSC_NAV__=" + safeJsonStringify({
+function buildModulePreloadHtml(bootstrapModuleUrl, nonce) {
+	if (!bootstrapModuleUrl) return "";
+	return `<link rel="modulepreload"${createNonceAttribute(nonce)} href="${escapeHtmlAttr(bootstrapModuleUrl)}" />\n`;
+}
+function buildHeadInjectionHtml(navContext, bootstrapModuleUrl, formState, insertedHTML, fontHTML, scriptNonce) {
+	const paramsScript = createInlineScriptTag("self.__VINEXT_RSC_PARAMS__=" + safeJsonStringify(navContext?.params ?? {}), scriptNonce);
+	const navScript = createInlineScriptTag("self.__VINEXT_RSC_NAV__=" + safeJsonStringify({
 		pathname: navContext?.pathname ?? "/",
 		searchParams: navContext?.searchParams ? [...navContext.searchParams.entries()] : []
-	}), scriptNonce) + extractModulePreloadHtml(bootstrapScriptContent, scriptNonce) + insertedHTML + fontHTML;
+	}), scriptNonce);
+	const formStateScript = formState === null ? "" : createInlineScriptTag("self[" + safeJsonStringify(RSC_FORM_STATE_GLOBAL) + "]=" + safeJsonStringify(formState), scriptNonce);
+	return paramsScript + navScript + formStateScript + buildModulePreloadHtml(bootstrapModuleUrl, scriptNonce) + insertedHTML + fontHTML;
 }
 async function handleSsr(rscStream, navContext, fontData, options) {
 	return runWithNavigationContext(async () => {
@@ -93,24 +117,30 @@ async function handleSsr(rscStream, navContext, fontData, options) {
 				const metadata = AppElementsWire.readMetadata(elements);
 				return createElement(ElementsContext.Provider, { value: elements }, createElement(Slot, { id: metadata.routeId }));
 			}
-			const root = createElement(VinextFlightRoot);
+			const flightRootElement = createElement(VinextFlightRoot);
+			const root = AppRouterContext ? createElement(AppRouterContext.Provider, { value: appRouterInstance }, flightRootElement) : flightRootElement;
 			const ssrRoot = withScriptNonce(ServerInsertedHTMLContext ? createElement(ServerInsertedHTMLContext.Provider, { value: useServerInsertedHTML }, root) : root, options?.scriptNonce);
-			const bootstrapScriptContent = await import.meta.viteRsc.loadBootstrapScriptContent("index");
+			const bootstrapModuleUrl = extractBootstrapModuleUrl(await import.meta.viteRsc.loadBootstrapScriptContent("index"));
+			const errorMetaRenderer = createSsrErrorMetaRenderer({ basePath: options?.basePath });
 			const htmlStream = await renderToReadableStream(ssrRoot, {
-				bootstrapScriptContent,
+				bootstrapModules: bootstrapModuleUrl ? [bootstrapModuleUrl] : void 0,
+				formState: options?.formState ?? null,
 				nonce: options?.scriptNonce,
 				onError(error) {
+					errorMetaRenderer.capture(error);
 					if (error && typeof error === "object" && "digest" in error) return String(error.digest);
 					if (process.env.NODE_ENV === "production" && error) return ssrErrorDigest(getErrorMessage(error) + (error instanceof Error ? error.stack ?? "" : ""));
 				}
 			});
+			if (options?.waitForAllReady === true) await htmlStream.allReady;
 			const fontHTML = renderFontHtml(fontData, options?.scriptNonce);
 			let didInjectHeadHTML = false;
 			const getInsertedHTML = () => {
 				const insertedHTML = renderInsertedHtml(renderServerInsertedHTML());
-				if (didInjectHeadHTML) return insertedHTML;
+				const errorMetaHTML = errorMetaRenderer.flush();
+				if (didInjectHeadHTML) return insertedHTML + errorMetaHTML;
 				didInjectHeadHTML = true;
-				return buildHeadInjectionHtml(navContext, bootstrapScriptContent, insertedHTML, fontHTML, options?.scriptNonce);
+				return buildHeadInjectionHtml(navContext, bootstrapModuleUrl, options?.formState ?? null, insertedHTML + errorMetaHTML, fontHTML, options?.scriptNonce);
 			};
 			return deferUntilStreamConsumed(htmlStream.pipeThrough(createTickBufferedTransform(rscEmbed, getInsertedHTML)), cleanup);
 		} catch (error) {

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 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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"}
+{"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 \"./server-globals.js\";\nimport type { ReactNode } from \"react\";\nimport type { ReactFormState } from \"react-dom/client\";\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  appRouterInstance,\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 { createSsrErrorMetaRenderer } from \"./app-ssr-error-meta.js\";\nimport { AppElementsWire, type AppWireElements } from \"./app-elements.js\";\nimport { ElementsContext, Slot } from \"vinext/shims/slot\";\nimport { AppRouterContext } from \"vinext/shims/internal/app-router-context\";\nimport { createClientReferencePreloader } from \"./app-client-reference-preloader.js\";\nimport { RSC_FORM_STATE_GLOBAL } from \"./app-browser-hydration.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\n/**\n * Extract the bootstrap module URL from the `import(\"...\")` string that\n * `import.meta.viteRsc.loadBootstrapScriptContent(\"index\")` returns.\n *\n * The plugin-rsc helper returns the bootstrap as an inline call so we can\n * inject it via `bootstrapScriptContent`. We instead pass the URL to\n * React's `bootstrapModules` option so a real\n * `<script type=\"module\" src=\"…\">` tag ends up in the streamed HTML —\n * this exposes the URL to anything that reads `script.attribs.src` (e.g.\n * the Next.js asset-prefix fixture test). The same URL also feeds the\n * `<link rel=\"modulepreload\">` we emit ahead of the bootstrap.\n *\n * Returns `undefined` when the helper produced no URL (older plugin-rsc\n * versions, or a custom client entry that disables bootstrap content).\n */\nfunction extractBootstrapModuleUrl(bootstrapScriptContent?: string): string | undefined {\n  if (!bootstrapScriptContent) return undefined;\n  // Accept either quote style — plugin-rsc currently emits double quotes\n  // (`import(\"…\")`) but a future version could switch to single quotes,\n  // and there's no public contract documenting which is used.\n  const match = bootstrapScriptContent.match(/import\\([\"']([^\"']+)[\"']\\)/);\n  return match?.[1] ?? undefined;\n}\n\nfunction buildModulePreloadHtml(bootstrapModuleUrl?: string, nonce?: string): string {\n  if (!bootstrapModuleUrl) return \"\";\n  return `<link rel=\"modulepreload\"${createNonceAttribute(nonce)} href=\"${escapeHtmlAttr(bootstrapModuleUrl)}\" />\\n`;\n}\n\nfunction buildHeadInjectionHtml(\n  navContext: NavigationContext | null,\n  bootstrapModuleUrl: string | undefined,\n  formState: ReactFormState | null,\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  const formStateScript =\n    formState === null\n      ? \"\"\n      : createInlineScriptTag(\n          \"self[\" + safeJsonStringify(RSC_FORM_STATE_GLOBAL) + \"]=\" + safeJsonStringify(formState),\n          scriptNonce,\n        );\n\n  return (\n    paramsScript +\n    navScript +\n    formStateScript +\n    buildModulePreloadHtml(bootstrapModuleUrl, 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    formState?: ReactFormState | null;\n    basePath?: string;\n    /** When true, wait for the full React tree (including Suspense boundaries)\n     *  to resolve before returning the HTML stream. Used for static prerender\n     *  and ISR cache writes to avoid caching fallback content. */\n    waitForAllReady?: boolean;\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 flightRootElement = createReactElement(VinextFlightRoot);\n      const root = AppRouterContext\n        ? createReactElement(\n            AppRouterContext.Provider,\n            { value: appRouterInstance },\n            flightRootElement,\n          )\n        : flightRootElement;\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      // plugin-rsc returns the bootstrap as `import(\"<url>\")` so callers can\n      // inject it via `bootstrapScriptContent`. We hand the URL to React's\n      // `bootstrapModules` option instead so the streamed HTML contains a\n      // real `<script type=\"module\" src=\"<url>\">` tag — exposing the URL\n      // to anything that inspects `script.attribs.src` (e.g. the Next.js\n      // asset-prefix fixture test \"bundles should return 200 on served\n      // assetPrefix\"). Mirrors Next.js's app-render path which passes\n      // `bootstrapScripts: [{ src }]` for the same reason; we use\n      // `bootstrapModules` because vinext's chunks are native ES modules\n      // (Vite output) so a `type=\"module\"` tag is the correct loader.\n      //\n      // In dev, `<url>` is a Vite dev URL like\n      // `/@id/__x00__virtual:vinext-app-browser-entry`; the browser fetches\n      // it as a module from the dev server. In prod it's the hashed bundle\n      // URL (e.g. `/_next/static/index-abc123.js`, optionally prefixed by\n      // `assetPrefix`). Both are valid `<script type=\"module\" src=…>` targets.\n      const bootstrapScriptContent = await import.meta.viteRsc.loadBootstrapScriptContent(\"index\");\n      const bootstrapModuleUrl = extractBootstrapModuleUrl(bootstrapScriptContent);\n      const errorMetaRenderer = createSsrErrorMetaRenderer({\n        basePath: options?.basePath,\n      });\n\n      const htmlStream = await renderToReadableStream(ssrRoot, {\n        // `bootstrapScriptContent` was previously how vinext injected the\n        // dynamic-import call. `bootstrapModules` performs the same work\n        // natively (and exposes the URL in the DOM), so passing both would\n        // load the bootstrap module twice.\n        //\n        // CSP implications of using `bootstrapModules` instead of inline\n        // `bootstrapScriptContent`:\n        //  - Apps no longer need `script-src 'unsafe-inline'` to load the\n        //    bootstrap (improvement — inline imports required `'unsafe-inline'`).\n        //  - Apps that restrict script sources need `'self'` for the\n        //    common case, or the CDN origin when `assetPrefix` is an\n        //    absolute URL like `https://cdn.example.com`.\n        //  - React still applies `nonce` to the emitted\n        //    `<script type=\"module\" src=…>` tag, so nonce-based CSP\n        //    (`script-src 'nonce-…' 'strict-dynamic'`) keeps working.\n        bootstrapModules: bootstrapModuleUrl ? [bootstrapModuleUrl] : undefined,\n        formState: options?.formState ?? null,\n        nonce: options?.scriptNonce,\n        onError(error) {\n          errorMetaRenderer.capture(error);\n\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      // When producing static output (prerender / ISR cache writes), wait for\n      // the full React tree to resolve before emitting bytes. This prevents\n      // Suspense fallback content from being serialized to the cache.\n      // Matches Next.js waitForAllReady forkpoint in renderToNodeFizzStream.\n      if (options?.waitForAllReady === true) {\n        await htmlStream.allReady;\n      }\n\n      const fontHTML = renderFontHtml(fontData, options?.scriptNonce);\n      let didInjectHeadHTML = false;\n      const getInsertedHTML = (): string => {\n        const insertedHTML = renderInsertedHtml(renderServerInsertedHTML());\n        const errorMetaHTML = errorMetaRenderer.flush();\n        if (didInjectHeadHTML) return insertedHTML + errorMetaHTML;\n\n        didInjectHeadHTML = true;\n        return buildHeadInjectionHtml(\n          navContext,\n          bootstrapModuleUrl,\n          options?.formState ?? null,\n          insertedHTML + errorMetaHTML,\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/app-ssr-error-meta.d.ts

@@ -0,0 +1,14 @@
+//#region src/server/app-ssr-error-meta.d.ts
+type SsrErrorMetaRenderOptions = {
+  basePath?: string;
+  nodeEnv?: string;
+};
+type SsrErrorMetaRenderer = {
+  capture: (error: unknown) => void;
+  flush: () => string;
+};
+declare function renderSsrErrorMetaTags(errors: readonly unknown[], options?: SsrErrorMetaRenderOptions): string;
+declare function createSsrErrorMetaRenderer(options?: SsrErrorMetaRenderOptions): SsrErrorMetaRenderer;
+//#endregion
+export { createSsrErrorMetaRenderer, renderSsrErrorMetaTags };
+//# sourceMappingURL=app-ssr-error-meta.d.ts.map

package/dist/server/app-ssr-error-meta.js

@@ -0,0 +1,50 @@
+import { addBasePathToPathname } from "../utils/base-path.js";
+import { escapeHtmlAttr } from "./html.js";
+import { getNextErrorDigest, parseNextHttpErrorDigest, parseNextRedirectDigest } from "./next-error-digest.js";
+//#region src/server/app-ssr-error-meta.ts
+const PERMANENT_REDIRECT_STATUS = 308;
+function prefixRedirectLocation(location, basePath) {
+	if (!basePath || !location.startsWith("/")) return location;
+	const hashIndex = location.indexOf("#");
+	const queryIndex = location.indexOf("?");
+	const pathnameEnd = queryIndex === -1 ? hashIndex === -1 ? location.length : hashIndex : hashIndex === -1 ? queryIndex : Math.min(queryIndex, hashIndex);
+	return addBasePathToPathname(location.slice(0, pathnameEnd), basePath) + location.slice(pathnameEnd);
+}
+function renderSsrErrorMetaTag(error, options) {
+	const digest = getNextErrorDigest(error);
+	if (!digest) return "";
+	if (parseNextHttpErrorDigest(digest)) {
+		let html = "<meta name=\"robots\" content=\"noindex\" />";
+		if ((options.nodeEnv ?? process.env.NODE_ENV) === "development") html += "<meta name=\"next-error\" content=\"not-found\" />";
+		return html;
+	}
+	const redirect = parseNextRedirectDigest(digest);
+	if (!redirect) return "";
+	const delay = redirect.status === PERMANENT_REDIRECT_STATUS ? 0 : 1;
+	const location = prefixRedirectLocation(redirect.url, options.basePath);
+	return "<meta id=\"__next-page-redirect\" http-equiv=\"refresh\" content=\"" + delay + ";url=" + escapeHtmlAttr(location) + "\" />";
+}
+function renderSsrErrorMetaTags(errors, options = {}) {
+	let html = "";
+	for (const error of errors) html += renderSsrErrorMetaTag(error, options);
+	return html;
+}
+function createSsrErrorMetaRenderer(options = {}) {
+	const capturedErrors = [];
+	let flushedUntil = 0;
+	return {
+		capture(error) {
+			capturedErrors.push(error);
+		},
+		flush() {
+			if (flushedUntil >= capturedErrors.length) return "";
+			const html = renderSsrErrorMetaTags(capturedErrors.slice(flushedUntil), options);
+			flushedUntil = capturedErrors.length;
+			return html;
+		}
+	};
+}
+//#endregion
+export { createSsrErrorMetaRenderer, renderSsrErrorMetaTags };
+
+//# sourceMappingURL=app-ssr-error-meta.js.map

package/dist/server/app-ssr-error-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-ssr-error-meta.js","names":[],"sources":["../../src/server/app-ssr-error-meta.ts"],"sourcesContent":["import { addBasePathToPathname } from \"../utils/base-path.js\";\nimport { escapeHtmlAttr } from \"./html.js\";\nimport {\n  getNextErrorDigest,\n  parseNextHttpErrorDigest,\n  parseNextRedirectDigest,\n} from \"./next-error-digest.js\";\n\ntype SsrErrorMetaRenderOptions = {\n  basePath?: string;\n  nodeEnv?: string;\n};\n\ntype SsrErrorMetaRenderer = {\n  capture: (error: unknown) => void;\n  flush: () => string;\n};\n\nconst PERMANENT_REDIRECT_STATUS = 308;\n\nfunction prefixRedirectLocation(location: string, basePath?: string): string {\n  if (!basePath || !location.startsWith(\"/\")) {\n    return location;\n  }\n\n  const hashIndex = location.indexOf(\"#\");\n  const queryIndex = location.indexOf(\"?\");\n  const pathnameEnd =\n    queryIndex === -1\n      ? hashIndex === -1\n        ? location.length\n        : hashIndex\n      : hashIndex === -1\n        ? queryIndex\n        : Math.min(queryIndex, hashIndex);\n  const pathname = location.slice(0, pathnameEnd);\n\n  return addBasePathToPathname(pathname, basePath) + location.slice(pathnameEnd);\n}\n\nfunction renderSsrErrorMetaTag(error: unknown, options: SsrErrorMetaRenderOptions): string {\n  const digest = getNextErrorDigest(error);\n  if (!digest) return \"\";\n\n  const httpError = parseNextHttpErrorDigest(digest);\n  if (httpError) {\n    let html = '<meta name=\"robots\" content=\"noindex\" />';\n    if ((options.nodeEnv ?? process.env.NODE_ENV) === \"development\") {\n      html += '<meta name=\"next-error\" content=\"not-found\" />';\n    }\n    return html;\n  }\n\n  const redirect = parseNextRedirectDigest(digest);\n  if (!redirect) return \"\";\n\n  const delay = redirect.status === PERMANENT_REDIRECT_STATUS ? 0 : 1;\n  const location = prefixRedirectLocation(redirect.url, options.basePath);\n  return (\n    '<meta id=\"__next-page-redirect\" http-equiv=\"refresh\" content=\"' +\n    delay +\n    \";url=\" +\n    escapeHtmlAttr(location) +\n    '\" />'\n  );\n}\n\nexport function renderSsrErrorMetaTags(\n  errors: readonly unknown[],\n  options: SsrErrorMetaRenderOptions = {},\n): string {\n  let html = \"\";\n\n  for (const error of errors) {\n    html += renderSsrErrorMetaTag(error, options);\n  }\n\n  return html;\n}\n\nexport function createSsrErrorMetaRenderer(\n  options: SsrErrorMetaRenderOptions = {},\n): SsrErrorMetaRenderer {\n  const capturedErrors: unknown[] = [];\n  let flushedUntil = 0;\n\n  return {\n    capture(error) {\n      capturedErrors.push(error);\n    },\n    flush() {\n      if (flushedUntil >= capturedErrors.length) return \"\";\n\n      const html = renderSsrErrorMetaTags(capturedErrors.slice(flushedUntil), options);\n      flushedUntil = capturedErrors.length;\n      return html;\n    },\n  };\n}\n"],"mappings":";;;;AAkBA,MAAM,4BAA4B;AAElC,SAAS,uBAAuB,UAAkB,UAA2B;CAC3E,IAAI,CAAC,YAAY,CAAC,SAAS,WAAW,IAAI,EACxC,OAAO;CAGT,MAAM,YAAY,SAAS,QAAQ,IAAI;CACvC,MAAM,aAAa,SAAS,QAAQ,IAAI;CACxC,MAAM,cACJ,eAAe,KACX,cAAc,KACZ,SAAS,SACT,YACF,cAAc,KACZ,aACA,KAAK,IAAI,YAAY,UAAU;CAGvC,OAAO,sBAFU,SAAS,MAAM,GAAG,YAEE,EAAE,SAAS,GAAG,SAAS,MAAM,YAAY;;AAGhF,SAAS,sBAAsB,OAAgB,SAA4C;CACzF,MAAM,SAAS,mBAAmB,MAAM;CACxC,IAAI,CAAC,QAAQ,OAAO;CAGpB,IADkB,yBAAyB,OAC9B,EAAE;EACb,IAAI,OAAO;EACX,KAAK,QAAQ,WAAW,QAAQ,IAAI,cAAc,eAChD,QAAQ;EAEV,OAAO;;CAGT,MAAM,WAAW,wBAAwB,OAAO;CAChD,IAAI,CAAC,UAAU,OAAO;CAEtB,MAAM,QAAQ,SAAS,WAAW,4BAA4B,IAAI;CAClE,MAAM,WAAW,uBAAuB,SAAS,KAAK,QAAQ,SAAS;CACvE,OACE,wEACA,QACA,UACA,eAAe,SAAS,GACxB;;AAIJ,SAAgB,uBACd,QACA,UAAqC,EAAE,EAC/B;CACR,IAAI,OAAO;CAEX,KAAK,MAAM,SAAS,QAClB,QAAQ,sBAAsB,OAAO,QAAQ;CAG/C,OAAO;;AAGT,SAAgB,2BACd,UAAqC,EAAE,EACjB;CACtB,MAAM,iBAA4B,EAAE;CACpC,IAAI,eAAe;CAEnB,OAAO;EACL,QAAQ,OAAO;GACb,eAAe,KAAK,MAAM;;EAE5B,QAAQ;GACN,IAAI,gBAAgB,eAAe,QAAQ,OAAO;GAElD,MAAM,OAAO,uBAAuB,eAAe,MAAM,aAAa,EAAE,QAAQ;GAChF,eAAe,eAAe;GAC9B,OAAO;;EAEV"}

package/dist/server/app-ssr-stream.d.ts

@@ -13,7 +13,7 @@ type HtmlInsertion = string | (() => string);
 declare function fixFlightHints(text: string): string;
 /**
  * Create a helper that progressively embeds RSC chunks as inline <script> tags.
- * The browser entry turns the embedded text chunks back into Uint8Array data.
+ * The browser entry turns the embedded chunks back into Uint8Array data.
  */
 declare function createRscEmbedTransform(embedStream: ReadableStream<Uint8Array>, scriptNonce?: string): RscEmbedTransform;
 /**

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

@@ -1,4 +1,5 @@
 import { createInlineScriptTag, safeJsonStringify } from "./html.js";
+import { bytesToBase64, concatUint8Arrays } from "./app-rsc-embedded-chunks.js";
 //#region src/server/app-ssr-stream.ts
 /**
 * Fix invalid preload "as" values in RSC Flight hint lines before they reach
@@ -10,11 +11,10 @@ function fixFlightHints(text) {
 }
 /**
 * Create a helper that progressively embeds RSC chunks as inline <script> tags.
-* The browser entry turns the embedded text chunks back into Uint8Array data.
+* The browser entry turns the embedded chunks back into Uint8Array data.
 */
 function createRscEmbedTransform(embedStream, scriptNonce) {
 	const reader = embedStream.getReader();
-	const decoder = new TextDecoder();
 	let pendingChunks = [];
 	const rawChunks = [];
 	let reading = false;
@@ -26,8 +26,12 @@ function createRscEmbedTransform(embedStream, scriptNonce) {
 				const result = await reader.read();
 				if (result.done) break;
 				rawChunks.push(result.value);
-				const text = decoder.decode(result.value, { stream: true });
-				pendingChunks.push(fixFlightHints(text));
+				try {
+					const text = new TextDecoder("utf-8", { fatal: true }).decode(result.value);
+					pendingChunks.push(fixFlightHints(text));
+				} catch {
+					pendingChunks.push([3, bytesToBase64(result.value)]);
+				}
 			}
 		} catch (error) {
 			if (process.env.NODE_ENV !== "production") console.warn("[vinext] RSC embed stream read error:", error);
@@ -54,14 +58,7 @@ function createRscEmbedTransform(embedStream, scriptNonce) {
 		},
 		async getRawBuffer() {
 			await pumpPromise;
-			let totalLength = 0;
-			for (const chunk of rawChunks) totalLength += chunk.byteLength;
-			const buffer = new Uint8Array(totalLength);
-			let offset = 0;
-			for (const chunk of rawChunks) {
-				buffer.set(chunk, offset);
-				offset += chunk.byteLength;
-			}
+			const buffer = concatUint8Arrays(rawChunks);
 			rawChunks.length = 0;
 			return buffer.buffer;
 		}

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

@@ -1 +1 @@
-{"version":3,"file":"app-ssr-stream.js","names":[],"sources":["../../src/server/app-ssr-stream.ts"],"sourcesContent":["import { createInlineScriptTag, safeJsonStringify } from \"./html.js\";\n\ntype RscEmbedTransform = {\n  flush(): string;\n  finalize(): Promise<string>;\n  /** Resolves when all raw bytes from the embed stream have been read. */\n  getRawBuffer(): Promise<ArrayBuffer>;\n};\n\ntype HtmlInsertion = string | (() => string);\n\n/**\n * Fix invalid preload \"as\" values in RSC Flight hint lines before they reach\n * the client. React Flight emits HL hints with as=\"stylesheet\" for CSS, but\n * the HTML spec requires as=\"style\" for <link rel=\"preload\">.\n */\nexport function fixFlightHints(text: string): string {\n  return text.replace(/(\\d*:HL\\[.*?),\"stylesheet\"(\\]|,)/g, '$1,\"style\"$2');\n}\n\n/**\n * Create a helper that progressively embeds RSC chunks as inline <script> tags.\n * The browser entry turns the embedded text chunks back into Uint8Array data.\n */\nexport function createRscEmbedTransform(\n  embedStream: ReadableStream<Uint8Array>,\n  scriptNonce?: string,\n): RscEmbedTransform {\n  const reader = embedStream.getReader();\n  const decoder = new TextDecoder();\n  let pendingChunks: string[] = [];\n  const rawChunks: Uint8Array[] = [];\n  let reading = false;\n\n  async function pumpReader(): Promise<void> {\n    if (reading) return;\n    reading = true;\n    try {\n      while (true) {\n        const result = await reader.read();\n        if (result.done) break;\n        // Accumulate raw bytes BEFORE fixFlightHints so the cache stores\n        // unmodified RSC data. The embed script path below applies fixes.\n        rawChunks.push(result.value);\n        const text = decoder.decode(result.value, { stream: true });\n        // The RSC entry already fixes HL hints at the source. Keep this second\n        // pass as defense in depth for any embed stream that bypasses that\n        // wrapper; the rewrite is idempotent, so double-application is safe.\n        pendingChunks.push(fixFlightHints(text));\n      }\n    } catch (error) {\n      if (process.env.NODE_ENV !== \"production\") {\n        console.warn(\"[vinext] RSC embed stream read error:\", error);\n      }\n      throw error;\n    } finally {\n      reading = false;\n    }\n  }\n\n  const pumpPromise = pumpReader();\n\n  return {\n    flush(): string {\n      if (pendingChunks.length === 0) return \"\";\n\n      const chunks = pendingChunks;\n      pendingChunks = [];\n\n      let scripts = \"\";\n      for (const chunk of chunks) {\n        scripts += createInlineScriptTag(\n          \"self.__VINEXT_RSC_CHUNKS__=self.__VINEXT_RSC_CHUNKS__||[];self.__VINEXT_RSC_CHUNKS__.push(\" +\n            safeJsonStringify(chunk) +\n            \")\",\n          scriptNonce,\n        );\n      }\n      return scripts;\n    },\n\n    async finalize(): Promise<string> {\n      await pumpPromise;\n      let scripts = this.flush();\n      scripts += createInlineScriptTag(\"self.__VINEXT_RSC_DONE__=true\", scriptNonce);\n      return scripts;\n    },\n\n    async getRawBuffer(): Promise<ArrayBuffer> {\n      await pumpPromise;\n      let totalLength = 0;\n      for (const chunk of rawChunks) {\n        totalLength += chunk.byteLength;\n      }\n      const buffer = new Uint8Array(totalLength);\n      let offset = 0;\n      for (const chunk of rawChunks) {\n        buffer.set(chunk, offset);\n        offset += chunk.byteLength;\n      }\n      rawChunks.length = 0;\n      return buffer.buffer;\n    },\n  };\n}\n\n/**\n * Fix invalid preload \"as\" values in server-rendered HTML.\n * React Fizz emits <link rel=\"preload\" as=\"stylesheet\"> for CSS, but the\n * HTML spec requires as=\"style\" for <link rel=\"preload\">.\n */\nexport function fixPreloadAs(html: string): string {\n  return html.replace(/<link(?=[^>]*\\srel=\"preload\")[^>]*>/g, (tag) =>\n    tag.replace(' as=\"stylesheet\"', ' as=\"style\"'),\n  );\n}\n\n/**\n * Create the tick-buffered HTML transform that injects RSC scripts between\n * React Fizz flush cycles without corrupting split HTML chunks.\n */\nexport function createTickBufferedTransform(\n  rscEmbed: RscEmbedTransform,\n  injectHTML: HtmlInsertion = \"\",\n): TransformStream<Uint8Array, Uint8Array> {\n  const decoder = new TextDecoder();\n  const encoder = new TextEncoder();\n  const insertsPerFlush = typeof injectHTML === \"function\";\n  let injected = false;\n  let buffered: string[] = [];\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n  const readInsertion = (): string =>\n    typeof injectHTML === \"function\" ? injectHTML() : injectHTML;\n  const emitInsertion = (controller: TransformStreamDefaultController<Uint8Array>): void => {\n    const insertion = readInsertion();\n    if (insertion) {\n      controller.enqueue(encoder.encode(insertion));\n    }\n  };\n\n  const flushBuffered = (controller: TransformStreamDefaultController<Uint8Array>): void => {\n    if (buffered.length === 0) return;\n\n    if (injected && insertsPerFlush) {\n      // Emit newly collected server-inserted HTML before the next Fizz HTML\n      // batch so CSS-in-JS styles precede the elements they style.\n      emitInsertion(controller);\n    }\n\n    for (const chunk of buffered) {\n      if (!injected) {\n        const headEnd = chunk.indexOf(\"</head>\");\n        if (headEnd !== -1) {\n          const before = chunk.slice(0, headEnd);\n          const after = chunk.slice(headEnd);\n          controller.enqueue(encoder.encode(before + readInsertion() + after));\n          injected = true;\n          continue;\n        }\n      }\n      controller.enqueue(encoder.encode(chunk));\n    }\n    buffered = [];\n  };\n\n  return new TransformStream<Uint8Array, Uint8Array>({\n    transform(chunk, controller) {\n      buffered.push(fixPreloadAs(decoder.decode(chunk, { stream: true })));\n\n      if (timeoutId !== null) return;\n\n      timeoutId = setTimeout(() => {\n        try {\n          flushBuffered(controller);\n\n          const rscScripts = rscEmbed.flush();\n          if (rscScripts) {\n            controller.enqueue(encoder.encode(rscScripts));\n          }\n        } catch {\n          // Stream was cancelled between when the timeout was registered and\n          // when it fired (e.g. client disconnected, health-check cancelled\n          // the response body). Ignore — the stream is already closed.\n        }\n\n        timeoutId = null;\n      }, 0);\n    },\n\n    async flush(controller) {\n      if (timeoutId !== null) {\n        clearTimeout(timeoutId);\n        timeoutId = null;\n      }\n\n      flushBuffered(controller);\n\n      if (!injected) {\n        emitInsertion(controller);\n        injected = true;\n      } else if (insertsPerFlush) {\n        emitInsertion(controller);\n      }\n\n      const finalScripts = await rscEmbed.finalize();\n      if (finalScripts) {\n        controller.enqueue(encoder.encode(finalScripts));\n      }\n    },\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"app-ssr-stream.js","names":[],"sources":["../../src/server/app-ssr-stream.ts"],"sourcesContent":["import { createInlineScriptTag, safeJsonStringify } from \"./html.js\";\nimport {\n  bytesToBase64,\n  concatUint8Arrays,\n  RSC_EMBEDDED_BINARY_CHUNK,\n  type RscEmbeddedChunk,\n} from \"./app-rsc-embedded-chunks.js\";\n\ntype RscEmbedTransform = {\n  flush(): string;\n  finalize(): Promise<string>;\n  /** Resolves when all raw bytes from the embed stream have been read. */\n  getRawBuffer(): Promise<ArrayBuffer>;\n};\n\ntype HtmlInsertion = string | (() => string);\n\n/**\n * Fix invalid preload \"as\" values in RSC Flight hint lines before they reach\n * the client. React Flight emits HL hints with as=\"stylesheet\" for CSS, but\n * the HTML spec requires as=\"style\" for <link rel=\"preload\">.\n */\nexport function fixFlightHints(text: string): string {\n  return text.replace(/(\\d*:HL\\[.*?),\"stylesheet\"(\\]|,)/g, '$1,\"style\"$2');\n}\n\n/**\n * Create a helper that progressively embeds RSC chunks as inline <script> tags.\n * The browser entry turns the embedded chunks back into Uint8Array data.\n */\nexport function createRscEmbedTransform(\n  embedStream: ReadableStream<Uint8Array>,\n  scriptNonce?: string,\n): RscEmbedTransform {\n  const reader = embedStream.getReader();\n  let pendingChunks: RscEmbeddedChunk[] = [];\n  const rawChunks: Uint8Array[] = [];\n  let reading = false;\n\n  async function pumpReader(): Promise<void> {\n    if (reading) return;\n    reading = true;\n    try {\n      while (true) {\n        const result = await reader.read();\n        if (result.done) break;\n        // Accumulate raw bytes BEFORE fixFlightHints so the cache stores\n        // unmodified RSC data. The embed script path below applies fixes.\n        rawChunks.push(result.value);\n        try {\n          const decoder = new TextDecoder(\"utf-8\", { fatal: true });\n          const text = decoder.decode(result.value);\n          // The RSC entry already fixes HL hints at the source. Keep this second\n          // pass as defense in depth for any embed stream that bypasses that\n          // wrapper; the rewrite is idempotent, so double-application is safe.\n          pendingChunks.push(fixFlightHints(text));\n        } catch {\n          pendingChunks.push([RSC_EMBEDDED_BINARY_CHUNK, bytesToBase64(result.value)]);\n        }\n      }\n    } catch (error) {\n      if (process.env.NODE_ENV !== \"production\") {\n        console.warn(\"[vinext] RSC embed stream read error:\", error);\n      }\n      throw error;\n    } finally {\n      reading = false;\n    }\n  }\n\n  const pumpPromise = pumpReader();\n\n  return {\n    flush(): string {\n      if (pendingChunks.length === 0) return \"\";\n\n      const chunks = pendingChunks;\n      pendingChunks = [];\n\n      let scripts = \"\";\n      for (const chunk of chunks) {\n        scripts += createInlineScriptTag(\n          \"self.__VINEXT_RSC_CHUNKS__=self.__VINEXT_RSC_CHUNKS__||[];self.__VINEXT_RSC_CHUNKS__.push(\" +\n            safeJsonStringify(chunk) +\n            \")\",\n          scriptNonce,\n        );\n      }\n      return scripts;\n    },\n\n    async finalize(): Promise<string> {\n      await pumpPromise;\n      let scripts = this.flush();\n      scripts += createInlineScriptTag(\"self.__VINEXT_RSC_DONE__=true\", scriptNonce);\n      return scripts;\n    },\n\n    async getRawBuffer(): Promise<ArrayBuffer> {\n      await pumpPromise;\n      const buffer = concatUint8Arrays(rawChunks);\n      rawChunks.length = 0;\n      return buffer.buffer;\n    },\n  };\n}\n\n/**\n * Fix invalid preload \"as\" values in server-rendered HTML.\n * React Fizz emits <link rel=\"preload\" as=\"stylesheet\"> for CSS, but the\n * HTML spec requires as=\"style\" for <link rel=\"preload\">.\n */\nexport function fixPreloadAs(html: string): string {\n  return html.replace(/<link(?=[^>]*\\srel=\"preload\")[^>]*>/g, (tag) =>\n    tag.replace(' as=\"stylesheet\"', ' as=\"style\"'),\n  );\n}\n\n/**\n * Create the tick-buffered HTML transform that injects RSC scripts between\n * React Fizz flush cycles without corrupting split HTML chunks.\n */\nexport function createTickBufferedTransform(\n  rscEmbed: RscEmbedTransform,\n  injectHTML: HtmlInsertion = \"\",\n): TransformStream<Uint8Array, Uint8Array> {\n  const decoder = new TextDecoder();\n  const encoder = new TextEncoder();\n  const insertsPerFlush = typeof injectHTML === \"function\";\n  let injected = false;\n  let buffered: string[] = [];\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n  const readInsertion = (): string =>\n    typeof injectHTML === \"function\" ? injectHTML() : injectHTML;\n  const emitInsertion = (controller: TransformStreamDefaultController<Uint8Array>): void => {\n    const insertion = readInsertion();\n    if (insertion) {\n      controller.enqueue(encoder.encode(insertion));\n    }\n  };\n\n  const flushBuffered = (controller: TransformStreamDefaultController<Uint8Array>): void => {\n    if (buffered.length === 0) return;\n\n    if (injected && insertsPerFlush) {\n      // Emit newly collected server-inserted HTML before the next Fizz HTML\n      // batch so CSS-in-JS styles precede the elements they style.\n      emitInsertion(controller);\n    }\n\n    for (const chunk of buffered) {\n      if (!injected) {\n        const headEnd = chunk.indexOf(\"</head>\");\n        if (headEnd !== -1) {\n          const before = chunk.slice(0, headEnd);\n          const after = chunk.slice(headEnd);\n          controller.enqueue(encoder.encode(before + readInsertion() + after));\n          injected = true;\n          continue;\n        }\n      }\n      controller.enqueue(encoder.encode(chunk));\n    }\n    buffered = [];\n  };\n\n  return new TransformStream<Uint8Array, Uint8Array>({\n    transform(chunk, controller) {\n      buffered.push(fixPreloadAs(decoder.decode(chunk, { stream: true })));\n\n      if (timeoutId !== null) return;\n\n      timeoutId = setTimeout(() => {\n        try {\n          flushBuffered(controller);\n\n          const rscScripts = rscEmbed.flush();\n          if (rscScripts) {\n            controller.enqueue(encoder.encode(rscScripts));\n          }\n        } catch {\n          // Stream was cancelled between when the timeout was registered and\n          // when it fired (e.g. client disconnected, health-check cancelled\n          // the response body). Ignore — the stream is already closed.\n        }\n\n        timeoutId = null;\n      }, 0);\n    },\n\n    async flush(controller) {\n      if (timeoutId !== null) {\n        clearTimeout(timeoutId);\n        timeoutId = null;\n      }\n\n      flushBuffered(controller);\n\n      if (!injected) {\n        emitInsertion(controller);\n        injected = true;\n      } else if (insertsPerFlush) {\n        emitInsertion(controller);\n      }\n\n      const finalScripts = await rscEmbed.finalize();\n      if (finalScripts) {\n        controller.enqueue(encoder.encode(finalScripts));\n      }\n    },\n  });\n}\n"],"mappings":";;;;;;;;AAsBA,SAAgB,eAAe,MAAsB;CACnD,OAAO,KAAK,QAAQ,qCAAqC,iBAAe;;;;;;AAO1E,SAAgB,wBACd,aACA,aACmB;CACnB,MAAM,SAAS,YAAY,WAAW;CACtC,IAAI,gBAAoC,EAAE;CAC1C,MAAM,YAA0B,EAAE;CAClC,IAAI,UAAU;CAEd,eAAe,aAA4B;EACzC,IAAI,SAAS;EACb,UAAU;EACV,IAAI;GACF,OAAO,MAAM;IACX,MAAM,SAAS,MAAM,OAAO,MAAM;IAClC,IAAI,OAAO,MAAM;IAGjB,UAAU,KAAK,OAAO,MAAM;IAC5B,IAAI;KAEF,MAAM,OAAO,IADO,YAAY,SAAS,EAAE,OAAO,MAAM,CACpC,CAAC,OAAO,OAAO,MAAM;KAIzC,cAAc,KAAK,eAAe,KAAK,CAAC;YAClC;KACN,cAAc,KAAK,CAAA,GAA4B,cAAc,OAAO,MAAM,CAAC,CAAC;;;WAGzE,OAAO;GACd,IAAI,QAAQ,IAAI,aAAa,cAC3B,QAAQ,KAAK,yCAAyC,MAAM;GAE9D,MAAM;YACE;GACR,UAAU;;;CAId,MAAM,cAAc,YAAY;CAEhC,OAAO;EACL,QAAgB;GACd,IAAI,cAAc,WAAW,GAAG,OAAO;GAEvC,MAAM,SAAS;GACf,gBAAgB,EAAE;GAElB,IAAI,UAAU;GACd,KAAK,MAAM,SAAS,QAClB,WAAW,sBACT,+FACE,kBAAkB,MAAM,GACxB,KACF,YACD;GAEH,OAAO;;EAGT,MAAM,WAA4B;GAChC,MAAM;GACN,IAAI,UAAU,KAAK,OAAO;GAC1B,WAAW,sBAAsB,iCAAiC,YAAY;GAC9E,OAAO;;EAGT,MAAM,eAAqC;GACzC,MAAM;GACN,MAAM,SAAS,kBAAkB,UAAU;GAC3C,UAAU,SAAS;GACnB,OAAO,OAAO;;EAEjB;;;;;;;AAQH,SAAgB,aAAa,MAAsB;CACjD,OAAO,KAAK,QAAQ,yCAAyC,QAC3D,IAAI,QAAQ,sBAAoB,gBAAc,CAC/C;;;;;;AAOH,SAAgB,4BACd,UACA,aAA4B,IACa;CACzC,MAAM,UAAU,IAAI,aAAa;CACjC,MAAM,UAAU,IAAI,aAAa;CACjC,MAAM,kBAAkB,OAAO,eAAe;CAC9C,IAAI,WAAW;CACf,IAAI,WAAqB,EAAE;CAC3B,IAAI,YAAkD;CACtD,MAAM,sBACJ,OAAO,eAAe,aAAa,YAAY,GAAG;CACpD,MAAM,iBAAiB,eAAmE;EACxF,MAAM,YAAY,eAAe;EACjC,IAAI,WACF,WAAW,QAAQ,QAAQ,OAAO,UAAU,CAAC;;CAIjD,MAAM,iBAAiB,eAAmE;EACxF,IAAI,SAAS,WAAW,GAAG;EAE3B,IAAI,YAAY,iBAGd,cAAc,WAAW;EAG3B,KAAK,MAAM,SAAS,UAAU;GAC5B,IAAI,CAAC,UAAU;IACb,MAAM,UAAU,MAAM,QAAQ,UAAU;IACxC,IAAI,YAAY,IAAI;KAClB,MAAM,SAAS,MAAM,MAAM,GAAG,QAAQ;KACtC,MAAM,QAAQ,MAAM,MAAM,QAAQ;KAClC,WAAW,QAAQ,QAAQ,OAAO,SAAS,eAAe,GAAG,MAAM,CAAC;KACpE,WAAW;KACX;;;GAGJ,WAAW,QAAQ,QAAQ,OAAO,MAAM,CAAC;;EAE3C,WAAW,EAAE;;CAGf,OAAO,IAAI,gBAAwC;EACjD,UAAU,OAAO,YAAY;GAC3B,SAAS,KAAK,aAAa,QAAQ,OAAO,OAAO,EAAE,QAAQ,MAAM,CAAC,CAAC,CAAC;GAEpE,IAAI,cAAc,MAAM;GAExB,YAAY,iBAAiB;IAC3B,IAAI;KACF,cAAc,WAAW;KAEzB,MAAM,aAAa,SAAS,OAAO;KACnC,IAAI,YACF,WAAW,QAAQ,QAAQ,OAAO,WAAW,CAAC;YAE1C;IAMR,YAAY;MACX,EAAE;;EAGP,MAAM,MAAM,YAAY;GACtB,IAAI,cAAc,MAAM;IACtB,aAAa,UAAU;IACvB,YAAY;;GAGd,cAAc,WAAW;GAEzB,IAAI,CAAC,UAAU;IACb,cAAc,WAAW;IACzB,WAAW;UACN,IAAI,iBACT,cAAc,WAAW;GAG3B,MAAM,eAAe,MAAM,SAAS,UAAU;GAC9C,IAAI,cACF,WAAW,QAAQ,QAAQ,OAAO,aAAa,CAAC;;EAGrD,CAAC"}

package/dist/server/app-static-generation.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-static-generation.js","names":[],"sources":["../../src/server/app-static-generation.ts"],"sourcesContent":["import type { HeadersContext } from \"vinext/shims/headers\";\n\ntype AppStaticGenerationRouteKind = \"page\" | \"route\";\n\ntype CreateStaticGenerationHeadersContextOptions = {\n  dynamicConfig?: string;\n  routeKind: AppStaticGenerationRouteKind;\n  routePattern?: string;\n};\n\nexport function getAppPageStaticGenerationErrorMessage(): string {\n  return (\n    'Page with `dynamic = \"error\"` used a dynamic API. ' +\n    \"This page was expected to be fully static, but headers(), cookies(), \" +\n    \"or searchParams was accessed. Remove the dynamic API usage or change \" +\n    'the dynamic config to \"auto\" or \"force-dynamic\".'\n  );\n}\n\nexport function getAppRouteStaticGenerationErrorMessage(\n  routePattern?: string,\n  expression?: string,\n): string {\n  const route = routePattern ?? \"unknown route\";\n  const dynamicExpression = expression ?? \"a dynamic request API\";\n  return (\n    `Route ${route} with \\`dynamic = \"error\"\\` couldn't be rendered statically ` +\n    `because it used ${dynamicExpression}. ` +\n    \"See more info here: https://nextjs.org/docs/app/building-your-application/rendering/static-and-dynamic#dynamic-rendering\"\n  );\n}\n\nexport function createStaticGenerationHeadersContext(\n  options: CreateStaticGenerationHeadersContextOptions,\n): HeadersContext {\n  const context: HeadersContext = {\n    headers: new Headers(),\n    cookies: new Map(),\n  };\n\n  if (options.dynamicConfig === \"force-static\") {\n    context.forceStatic = true;\n  }\n\n  if (options.dynamicConfig === \"error\") {\n    context.accessError = new Error(\n      options.routeKind === \"route\"\n        ? getAppRouteStaticGenerationErrorMessage(options.routePattern)\n        : getAppPageStaticGenerationErrorMessage(),\n    );\n  }\n\n  return context;\n}\n"],"mappings":";AAUA,SAAgB,yCAAiD;AAC/D,QACE;;AAOJ,SAAgB,wCACd,cACA,YACQ;AAGR,QACE,SAHY,gBAAgB,gBAGb,8EAFS,cAAc,wBAGD;;AAKzC,SAAgB,qCACd,SACgB;CAChB,MAAM,UAA0B;EAC9B,SAAS,IAAI,SAAS;EACtB,yBAAS,IAAI,KAAK;EACnB;AAED,KAAI,QAAQ,kBAAkB,eAC5B,SAAQ,cAAc;AAGxB,KAAI,QAAQ,kBAAkB,QAC5B,SAAQ,cAAc,IAAI,MACxB,QAAQ,cAAc,UAClB,wCAAwC,QAAQ,aAAa,GAC7D,wCAAwC,CAC7C;AAGH,QAAO"}
+{"version":3,"file":"app-static-generation.js","names":[],"sources":["../../src/server/app-static-generation.ts"],"sourcesContent":["import type { HeadersContext } from \"vinext/shims/headers\";\n\ntype AppStaticGenerationRouteKind = \"page\" | \"route\";\n\ntype CreateStaticGenerationHeadersContextOptions = {\n  dynamicConfig?: string;\n  routeKind: AppStaticGenerationRouteKind;\n  routePattern?: string;\n};\n\nexport function getAppPageStaticGenerationErrorMessage(): string {\n  return (\n    'Page with `dynamic = \"error\"` used a dynamic API. ' +\n    \"This page was expected to be fully static, but headers(), cookies(), \" +\n    \"or searchParams was accessed. Remove the dynamic API usage or change \" +\n    'the dynamic config to \"auto\" or \"force-dynamic\".'\n  );\n}\n\nexport function getAppRouteStaticGenerationErrorMessage(\n  routePattern?: string,\n  expression?: string,\n): string {\n  const route = routePattern ?? \"unknown route\";\n  const dynamicExpression = expression ?? \"a dynamic request API\";\n  return (\n    `Route ${route} with \\`dynamic = \"error\"\\` couldn't be rendered statically ` +\n    `because it used ${dynamicExpression}. ` +\n    \"See more info here: https://nextjs.org/docs/app/building-your-application/rendering/static-and-dynamic#dynamic-rendering\"\n  );\n}\n\nexport function createStaticGenerationHeadersContext(\n  options: CreateStaticGenerationHeadersContextOptions,\n): HeadersContext {\n  const context: HeadersContext = {\n    headers: new Headers(),\n    cookies: new Map(),\n  };\n\n  if (options.dynamicConfig === \"force-static\") {\n    context.forceStatic = true;\n  }\n\n  if (options.dynamicConfig === \"error\") {\n    context.accessError = new Error(\n      options.routeKind === \"route\"\n        ? getAppRouteStaticGenerationErrorMessage(options.routePattern)\n        : getAppPageStaticGenerationErrorMessage(),\n    );\n  }\n\n  return context;\n}\n"],"mappings":";AAUA,SAAgB,yCAAiD;CAC/D,OACE;;AAOJ,SAAgB,wCACd,cACA,YACQ;CAGR,OACE,SAHY,gBAAgB,gBAGb,8EAFS,cAAc,wBAGD;;AAKzC,SAAgB,qCACd,SACgB;CAChB,MAAM,UAA0B;EAC9B,SAAS,IAAI,SAAS;EACtB,yBAAS,IAAI,KAAK;EACnB;CAED,IAAI,QAAQ,kBAAkB,gBAC5B,QAAQ,cAAc;CAGxB,IAAI,QAAQ,kBAAkB,SAC5B,QAAQ,cAAc,IAAI,MACxB,QAAQ,cAAc,UAClB,wCAAwC,QAAQ,aAAa,GAC7D,wCAAwC,CAC7C;CAGH,OAAO"}

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

@@ -17,9 +17,19 @@ type ArtifactCompatibilityEnvelopeInput = Readonly<{
   rootBoundaryId?: string | null;
   renderEpoch?: string | null;
 }>;
+type ArtifactCompatibilitySet = readonly [string, string, ...string[]];
+type ArtifactCompatibilityMap = Readonly<{
+  graphVersions?: readonly ArtifactCompatibilitySet[];
+  deploymentVersions?: readonly ArtifactCompatibilitySet[];
+  rootBoundaryIds?: readonly ArtifactCompatibilitySet[];
+  renderEpochs?: readonly ArtifactCompatibilitySet[];
+}>;
+type ArtifactCompatibilityEvaluationOptions = Readonly<{
+  compatibilityMap?: ArtifactCompatibilityMap;
+}>;
 type ArtifactCompatibilityFallback = "renderFresh";
 type ArtifactCompatibilityUnknownReason = "graphVersionUnknown" | "deploymentVersionUnknown" | "rootBoundaryIdUnknown" | "renderEpochUnknown";
-type ArtifactCompatibilityIncompatibleReason = "appElementsSchemaVersionMismatch" | "deploymentVersionMismatch" | "graphVersionMismatch" | "renderEpochMismatch" | "rootBoundaryIdMismatch" | "rscPayloadSchemaVersionMismatch" | "schemaVersionMismatch";
+type ArtifactCompatibilityIncompatibleReason = "appElementsSchemaVersionMismatch" | "deploymentVersionNotDeclaredCompatible" | "deploymentVersionMismatch" | "graphVersionNotDeclaredCompatible" | "graphVersionMismatch" | "renderEpochNotDeclaredCompatible" | "renderEpochMismatch" | "rootBoundaryIdNotDeclaredCompatible" | "rootBoundaryIdMismatch" | "rscPayloadSchemaVersionMismatch" | "schemaVersionMismatch";
 type ArtifactCompatibilityDecision = Readonly<{
   kind: "compatible";
 } | {
@@ -38,7 +48,7 @@ type ArtifactCompatibilityGraphVersionInput = Readonly<{
 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;
+declare function evaluateArtifactCompatibility(current: ArtifactCompatibilityEnvelope, candidate: ArtifactCompatibilityEnvelope, options?: ArtifactCompatibilityEvaluationOptions): 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

@@ -57,22 +57,26 @@ function unknown(reason) {
 		reason
 	};
 }
-function compareKnownField(currentValue, candidateValue, unknownReason, mismatchReason) {
+function compareKnownField(currentValue, candidateValue, unknownReason, mismatchReason, notDeclaredCompatibleReason, compatibilitySets) {
 	if (currentValue === null || candidateValue === null) return unknown(unknownReason);
-	if (currentValue !== candidateValue) return incompatible(mismatchReason);
-	return null;
+	if (currentValue === candidateValue) return null;
+	if (compatibilitySets === void 0) return incompatible(mismatchReason);
+	return isDeclaredCompatible(currentValue, candidateValue, compatibilitySets) ? null : incompatible(notDeclaredCompatibleReason);
 }
-function evaluateArtifactCompatibility(current, candidate) {
+function isDeclaredCompatible(currentValue, candidateValue, compatibilitySets) {
+	return compatibilitySets.some((compatibilitySet) => compatibilitySet.includes(currentValue) && compatibilitySet.includes(candidateValue));
+}
+function evaluateArtifactCompatibility(current, candidate, options = {}) {
 	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");
+	const graphDecision = compareKnownField(current.graphVersion, candidate.graphVersion, "graphVersionUnknown", "graphVersionMismatch", "graphVersionNotDeclaredCompatible", options.compatibilityMap?.graphVersions);
 	if (graphDecision) return graphDecision;
-	const deploymentDecision = compareKnownField(current.deploymentVersion, candidate.deploymentVersion, "deploymentVersionUnknown", "deploymentVersionMismatch");
+	const deploymentDecision = compareKnownField(current.deploymentVersion, candidate.deploymentVersion, "deploymentVersionUnknown", "deploymentVersionMismatch", "deploymentVersionNotDeclaredCompatible", options.compatibilityMap?.deploymentVersions);
 	if (deploymentDecision) return deploymentDecision;
-	const rootBoundaryDecision = compareKnownField(current.rootBoundaryId, candidate.rootBoundaryId, "rootBoundaryIdUnknown", "rootBoundaryIdMismatch");
+	const rootBoundaryDecision = compareKnownField(current.rootBoundaryId, candidate.rootBoundaryId, "rootBoundaryIdUnknown", "rootBoundaryIdMismatch", "rootBoundaryIdNotDeclaredCompatible", options.compatibilityMap?.rootBoundaryIds);
 	if (rootBoundaryDecision) return rootBoundaryDecision;
-	const renderEpochDecision = compareKnownField(current.renderEpoch, candidate.renderEpoch, "renderEpochUnknown", "renderEpochMismatch");
+	const renderEpochDecision = compareKnownField(current.renderEpoch, candidate.renderEpoch, "renderEpochUnknown", "renderEpochMismatch", "renderEpochNotDeclaredCompatible", options.compatibilityMap?.renderEpochs);
 	if (renderEpochDecision) return renderEpochDecision;
 	return { kind: "compatible" };
 }

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

@@ -1 +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"}
+{"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 ArtifactCompatibilitySet = readonly [string, string, ...string[]];\n\ntype ArtifactCompatibilityMap = Readonly<{\n  graphVersions?: readonly ArtifactCompatibilitySet[];\n  deploymentVersions?: readonly ArtifactCompatibilitySet[];\n  rootBoundaryIds?: readonly ArtifactCompatibilitySet[];\n  renderEpochs?: readonly ArtifactCompatibilitySet[];\n}>;\n\ntype ArtifactCompatibilityEvaluationOptions = Readonly<{\n  compatibilityMap?: ArtifactCompatibilityMap;\n}>;\n\ntype ArtifactCompatibilityFallback = \"renderFresh\";\n\ntype ArtifactCompatibilityUnknownReason =\n  | \"graphVersionUnknown\"\n  | \"deploymentVersionUnknown\"\n  | \"rootBoundaryIdUnknown\"\n  | \"renderEpochUnknown\";\n\ntype ArtifactCompatibilityIncompatibleReason =\n  | \"appElementsSchemaVersionMismatch\"\n  | \"deploymentVersionNotDeclaredCompatible\"\n  | \"deploymentVersionMismatch\"\n  | \"graphVersionNotDeclaredCompatible\"\n  | \"graphVersionMismatch\"\n  | \"renderEpochNotDeclaredCompatible\"\n  | \"renderEpochMismatch\"\n  | \"rootBoundaryIdNotDeclaredCompatible\"\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  notDeclaredCompatibleReason: ArtifactCompatibilityIncompatibleReason,\n  compatibilitySets: readonly ArtifactCompatibilitySet[] | undefined,\n): ArtifactCompatibilityDecision | null {\n  if (currentValue === null || candidateValue === null) {\n    return unknown(unknownReason);\n  }\n  if (currentValue === candidateValue) {\n    return null;\n  }\n  if (compatibilitySets === undefined) {\n    return incompatible(mismatchReason);\n  }\n  return isDeclaredCompatible(currentValue, candidateValue, compatibilitySets)\n    ? null\n    : incompatible(notDeclaredCompatibleReason);\n}\n\nfunction isDeclaredCompatible(\n  currentValue: string,\n  candidateValue: string,\n  compatibilitySets: readonly ArtifactCompatibilitySet[],\n): boolean {\n  // Compatibility is intentionally scoped to one declared set. Overlapping\n  // pair sets like [a,b] and [b,c] must not silently make a compatible with c.\n  return compatibilitySets.some(\n    (compatibilitySet) =>\n      compatibilitySet.includes(currentValue) && compatibilitySet.includes(candidateValue),\n  );\n}\n\nexport function evaluateArtifactCompatibility(\n  current: ArtifactCompatibilityEnvelope,\n  candidate: ArtifactCompatibilityEnvelope,\n  options: ArtifactCompatibilityEvaluationOptions = {},\n): ArtifactCompatibilityDecision {\n  // This remains a proof evaluator: mismatched fields are compatible only when\n  // the current build's compatibility map explicitly declares that relationship.\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    \"graphVersionNotDeclaredCompatible\",\n    options.compatibilityMap?.graphVersions,\n  );\n  if (graphDecision) return graphDecision;\n\n  const deploymentDecision = compareKnownField(\n    current.deploymentVersion,\n    candidate.deploymentVersion,\n    \"deploymentVersionUnknown\",\n    \"deploymentVersionMismatch\",\n    \"deploymentVersionNotDeclaredCompatible\",\n    options.compatibilityMap?.deploymentVersions,\n  );\n  if (deploymentDecision) return deploymentDecision;\n\n  const rootBoundaryDecision = compareKnownField(\n    current.rootBoundaryId,\n    candidate.rootBoundaryId,\n    \"rootBoundaryIdUnknown\",\n    \"rootBoundaryIdMismatch\",\n    \"rootBoundaryIdNotDeclaredCompatible\",\n    options.compatibilityMap?.rootBoundaryIds,\n  );\n  if (rootBoundaryDecision) return rootBoundaryDecision;\n\n  const renderEpochDecision = compareKnownField(\n    current.renderEpoch,\n    candidate.renderEpoch,\n    \"renderEpochUnknown\",\n    \"renderEpochMismatch\",\n    \"renderEpochNotDeclaredCompatible\",\n    options.compatibilityMap?.renderEpochs,\n  );\n  if (renderEpochDecision) return renderEpochDecision;\n\n  return { kind: \"compatible\" };\n}\n"],"mappings":"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"}

package/dist/server/cache-control.js

@@ -24,6 +24,7 @@ function buildRevalidateCacheControl(revalidateSeconds, expireSeconds) {
 * fallback so older cache entries are not treated as newly fresh downstream.
 */
 function buildCachedRevalidateCacheControl(cacheState, revalidateSeconds, expireSeconds) {
+	if (revalidateSeconds === Infinity) return STATIC_CACHE_CONTROL;
 	if (cacheState === "STALE" && expireSeconds === void 0) return STALE_REVALIDATE_CACHE_CONTROL;
 	return buildRevalidateCacheControl(revalidateSeconds, expireSeconds);
 }

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

@@ -1 +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"}
+{"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  if (revalidateSeconds === Infinity) {\n    return STATIC_CACHE_CONTROL;\n  }\n\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;CACR,IAAI,kBAAkB,KAAA,GACpB,OAAO,YAAY,kBAAkB;CAKvC,IAAI,qBAAqB,eACvB,OAAO,YAAY;CAGrB,OAAO,YAAY,kBAAkB,2BACnC,gBAAgB;;;;;;;;;AAWpB,SAAgB,kCACd,YACA,mBACA,eACQ;CACR,IAAI,sBAAsB,UACxB,OAAO;CAOT,IAAI,eAAe,WAAW,kBAAkB,KAAA,GAC9C,OAAO;CAGT,OAAO,4BAA4B,mBAAmB,cAAc"}