vinext 0.0.50 → 0.0.52

package/dist/server/app-optimistic-routing.js

@@ -0,0 +1,200 @@
+import { decodeMatchedParams, splitPathnameForRouteMatch } from "../routing/utils.js";
+import { stripBasePath } from "../utils/base-path.js";
+import { isUnknownRecord } from "../utils/record.js";
+import { AppElementsWire } from "./app-elements-wire.js";
+import "./app-elements.js";
+import { stripRscCacheBustingSearchParam, stripRscSuffix } from "./app-rsc-cache-busting.js";
+import { Suspense, createElement, isValidElement } from "react";
+//#region src/server/app-optimistic-routing.ts
+const routeTrieCache = /* @__PURE__ */ new WeakMap();
+const OPTIMISTIC_ROUTE_SEGMENT_SUSPENSE_TRIGGER = new Promise(() => {});
+function getOptimisticRouteTemplateKey(options) {
+	return `${options.routeId}\0${options.interceptionContext ?? ""}\0${options.mountedSlotsHeader ?? ""}`;
+}
+function getOptimisticPrefetchSourceKey(options) {
+	return `${options.cacheKey}\0${options.interceptionContext ?? ""}\0${options.mountedSlotsHeader ?? ""}`;
+}
+function createNode() {
+	return {
+		catchAllChild: null,
+		dynamicChild: null,
+		optionalCatchAllChild: null,
+		route: null,
+		staticChildren: /* @__PURE__ */ new Map()
+	};
+}
+function buildRouteTrie(routeManifest) {
+	const root = createNode();
+	for (const route of routeManifest.segmentGraph.routes.values()) {
+		let node = root;
+		const parts = route.patternParts;
+		if (parts.length === 0) {
+			node.route ??= route;
+			continue;
+		}
+		for (const [index, part] of parts.entries()) {
+			const isTerminal = index === parts.length - 1;
+			if (part.startsWith(":") && part.endsWith("+")) {
+				if (isTerminal && node.catchAllChild === null) node.catchAllChild = {
+					paramName: part.slice(1, -1),
+					route
+				};
+				break;
+			}
+			if (part.startsWith(":") && part.endsWith("*")) {
+				if (isTerminal && node.optionalCatchAllChild === null) node.optionalCatchAllChild = {
+					paramName: part.slice(1, -1),
+					route
+				};
+				break;
+			}
+			if (part.startsWith(":")) {
+				const paramName = part.slice(1);
+				if (node.dynamicChild === null) node.dynamicChild = {
+					node: createNode(),
+					paramName
+				};
+				else if (node.dynamicChild.paramName !== paramName && import.meta.env.DEV) console.warn(`[vinext] Optimistic route trie found conflicting dynamic segments at the same level: :${node.dynamicChild.paramName} vs ${part}`);
+				node = node.dynamicChild.node;
+				if (isTerminal) node.route ??= route;
+				continue;
+			}
+			let staticChild = node.staticChildren.get(part);
+			if (staticChild === void 0) {
+				staticChild = createNode();
+				node.staticChildren.set(part, staticChild);
+			}
+			node = staticChild;
+			if (isTerminal) node.route ??= route;
+		}
+	}
+	return root;
+}
+function getRouteTrie(routeManifest) {
+	const existing = routeTrieCache.get(routeManifest);
+	if (existing) return existing;
+	const trie = buildRouteTrie(routeManifest);
+	routeTrieCache.set(routeManifest, trie);
+	return trie;
+}
+function matchNode(node, urlParts, index) {
+	if (index === urlParts.length) {
+		if (node.route !== null) return {
+			route: node.route,
+			params: Object.create(null)
+		};
+		if (node.optionalCatchAllChild !== null) return {
+			route: node.optionalCatchAllChild.route,
+			params: Object.create(null)
+		};
+		return null;
+	}
+	const segment = urlParts[index];
+	const staticChild = node.staticChildren.get(segment);
+	if (staticChild !== void 0) return matchNode(staticChild, urlParts, index + 1);
+	if (node.dynamicChild !== null) {
+		const match = matchNode(node.dynamicChild.node, urlParts, index + 1);
+		if (match === null) return null;
+		match.params[node.dynamicChild.paramName] = segment;
+		return match;
+	}
+	if (node.catchAllChild !== null) return {
+		route: node.catchAllChild.route,
+		params: { [node.catchAllChild.paramName]: urlParts.slice(index) }
+	};
+	if (node.optionalCatchAllChild !== null) return {
+		route: node.optionalCatchAllChild.route,
+		params: { [node.optionalCatchAllChild.paramName]: urlParts.slice(index) }
+	};
+	return null;
+}
+function hrefToRouteParts(href, basePath) {
+	let url;
+	try {
+		url = new URL(href, "https://vinext.local");
+	} catch {
+		return null;
+	}
+	stripRscCacheBustingSearchParam(url);
+	const appPathname = stripBasePath(stripRscSuffix(url.pathname), basePath);
+	return splitPathnameForRouteMatch(appPathname === "" ? "/" : appPathname);
+}
+function matchOptimisticRouteManifestRoute(options) {
+	const urlParts = hrefToRouteParts(options.href, options.basePath);
+	if (urlParts === null) return null;
+	const match = matchNode(getRouteTrie(options.routeManifest), urlParts, 0);
+	if (match === null) return null;
+	decodeMatchedParams(match.params);
+	return match;
+}
+function elementHasSuspenseFallback(value, depth = 0) {
+	if (depth > 100) return false;
+	if (Array.isArray(value)) return value.some((entry) => elementHasSuspenseFallback(entry, depth + 1));
+	if (!isValidElement(value)) return false;
+	const props = Reflect.get(value, "props");
+	if (value.type === Suspense && isUnknownRecord(props)) {
+		const fallback = Reflect.get(props, "fallback");
+		if (fallback !== null && fallback !== void 0) return true;
+	}
+	if (!isUnknownRecord(props)) return false;
+	return elementHasSuspenseFallback(Reflect.get(props, "children"), depth + 1);
+}
+function getPageElementIds(elements) {
+	return Object.keys(elements).filter((key) => AppElementsWire.parseElementKey(key)?.kind === "page").sort();
+}
+function OptimisticRouteSegment() {
+	throw OPTIMISTIC_ROUTE_SEGMENT_SUSPENSE_TRIGGER;
+}
+function createOptimisticRouteTemplate(options) {
+	const match = matchOptimisticRouteManifestRoute({
+		basePath: options.basePath,
+		href: options.href,
+		routeManifest: options.routeManifest
+	});
+	if (match === null || !match.route.isDynamic) return null;
+	if (options.interceptionContext !== null) return null;
+	const metadata = AppElementsWire.readMetadata(options.elements);
+	if (metadata.interception !== null || metadata.interceptionContext !== null) return null;
+	const routeElement = options.elements[metadata.routeId];
+	if (!options.allowLoadingShell && !elementHasSuspenseFallback(routeElement)) return null;
+	if (options.allowLoadingShell && options.elements["__prefetchLoadingShell"] !== "LoadingBoundary") return null;
+	if (options.allowLoadingShell && (routeElement === void 0 || routeElement === null)) return null;
+	const pageElementIds = getPageElementIds(options.elements);
+	if (pageElementIds.length === 0) return null;
+	return {
+		elements: options.elements,
+		mountedSlotsHeader: options.mountedSlotsHeader,
+		pageElementIds,
+		routeId: match.route.id
+	};
+}
+function createOptimisticRouteElements(template) {
+	const elements = { ...template.elements };
+	for (const pageElementId of template.pageElementIds) elements[pageElementId] = createElement(OptimisticRouteSegment);
+	return elements;
+}
+function resolveOptimisticNavigationPayload(options) {
+	if (options.interceptionContext !== null) return null;
+	const match = matchOptimisticRouteManifestRoute({
+		basePath: options.basePath,
+		href: options.href,
+		routeManifest: options.routeManifest
+	});
+	if (match === null || !match.route.isDynamic) return null;
+	const template = options.templates.get(getOptimisticRouteTemplateKey({
+		interceptionContext: options.interceptionContext,
+		mountedSlotsHeader: options.mountedSlotsHeader,
+		routeId: match.route.id
+	}));
+	if (template === void 0) return null;
+	if (template.mountedSlotsHeader !== options.mountedSlotsHeader) return null;
+	return {
+		elements: createOptimisticRouteElements(template),
+		params: match.params,
+		template
+	};
+}
+//#endregion
+export { createOptimisticRouteElements, createOptimisticRouteTemplate, getOptimisticPrefetchSourceKey, getOptimisticRouteTemplateKey, matchOptimisticRouteManifestRoute, resolveOptimisticNavigationPayload };
+
+//# sourceMappingURL=app-optimistic-routing.js.map

package/dist/server/app-optimistic-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-optimistic-routing.js","names":[],"sources":["../../src/server/app-optimistic-routing.ts"],"sourcesContent":["import { createElement, isValidElement, Suspense } from \"react\";\nimport { isUnknownRecord } from \"../utils/record.js\";\nimport { stripBasePath } from \"../utils/base-path.js\";\nimport { decodeMatchedParams, splitPathnameForRouteMatch } from \"../routing/utils.js\";\nimport type { RouteManifest, RouteManifestRoute } from \"../routing/app-route-graph.js\";\nimport { stripRscCacheBustingSearchParam, stripRscSuffix } from \"./app-rsc-cache-busting.js\";\nimport {\n  AppElementsWire,\n  APP_PREFETCH_LOADING_SHELL_MARKER_KEY,\n  type AppElementValue,\n  type AppElements,\n} from \"./app-elements.js\";\n\ntype OptimisticRouteTrieNode = {\n  catchAllChild: { paramName: string; route: RouteManifestRoute } | null;\n  dynamicChild: { node: OptimisticRouteTrieNode; paramName: string } | null;\n  optionalCatchAllChild: { paramName: string; route: RouteManifestRoute } | null;\n  route: RouteManifestRoute | null;\n  staticChildren: Map<string, OptimisticRouteTrieNode>;\n};\n\ntype OptimisticRouteMatch = {\n  params: Record<string, string | string[]>;\n  route: RouteManifestRoute;\n};\n\nexport type OptimisticRouteTemplate = {\n  elements: AppElements;\n  mountedSlotsHeader: string | null;\n  pageElementIds: readonly string[];\n  routeId: string;\n};\n\ntype OptimisticNavigationPayload = {\n  elements: AppElements;\n  params: Record<string, string | string[]>;\n  template: OptimisticRouteTemplate;\n};\n\nconst routeTrieCache = new WeakMap<RouteManifest, OptimisticRouteTrieNode>();\n// Shared never-settling thenable used to suspend optimistic page segments until\n// the real RSC payload replaces them.\nconst OPTIMISTIC_ROUTE_SEGMENT_SUSPENSE_TRIGGER = new Promise<never>(() => {});\n\nexport function getOptimisticRouteTemplateKey(options: {\n  interceptionContext: string | null;\n  mountedSlotsHeader: string | null;\n  routeId: string;\n}): string {\n  return `${options.routeId}\\0${options.interceptionContext ?? \"\"}\\0${options.mountedSlotsHeader ?? \"\"}`;\n}\n\nexport function getOptimisticPrefetchSourceKey(options: {\n  cacheKey: string;\n  interceptionContext: string | null;\n  mountedSlotsHeader: string | null;\n}): string {\n  return `${options.cacheKey}\\0${options.interceptionContext ?? \"\"}\\0${options.mountedSlotsHeader ?? \"\"}`;\n}\n\nfunction createNode(): OptimisticRouteTrieNode {\n  return {\n    catchAllChild: null,\n    dynamicChild: null,\n    optionalCatchAllChild: null,\n    route: null,\n    staticChildren: new Map(),\n  };\n}\n\nfunction buildRouteTrie(routeManifest: RouteManifest): OptimisticRouteTrieNode {\n  const root = createNode();\n\n  for (const route of routeManifest.segmentGraph.routes.values()) {\n    let node = root;\n    const parts = route.patternParts;\n\n    if (parts.length === 0) {\n      node.route ??= route;\n      continue;\n    }\n\n    for (const [index, part] of parts.entries()) {\n      const isTerminal = index === parts.length - 1;\n      if (part.startsWith(\":\") && part.endsWith(\"+\")) {\n        if (isTerminal && node.catchAllChild === null) {\n          node.catchAllChild = { paramName: part.slice(1, -1), route };\n        }\n        break;\n      }\n\n      if (part.startsWith(\":\") && part.endsWith(\"*\")) {\n        if (isTerminal && node.optionalCatchAllChild === null) {\n          node.optionalCatchAllChild = { paramName: part.slice(1, -1), route };\n        }\n        break;\n      }\n\n      if (part.startsWith(\":\")) {\n        const paramName = part.slice(1);\n        if (node.dynamicChild === null) {\n          node.dynamicChild = { node: createNode(), paramName };\n        } else if (node.dynamicChild.paramName !== paramName && import.meta.env.DEV) {\n          console.warn(\n            `[vinext] Optimistic route trie found conflicting dynamic segments at the same level: :${node.dynamicChild.paramName} vs ${part}`,\n          );\n        }\n        node = node.dynamicChild.node;\n        if (isTerminal) node.route ??= route;\n        continue;\n      }\n\n      let staticChild = node.staticChildren.get(part);\n      if (staticChild === undefined) {\n        staticChild = createNode();\n        node.staticChildren.set(part, staticChild);\n      }\n      node = staticChild;\n      if (isTerminal) node.route ??= route;\n    }\n  }\n\n  return root;\n}\n\nfunction getRouteTrie(routeManifest: RouteManifest): OptimisticRouteTrieNode {\n  const existing = routeTrieCache.get(routeManifest);\n  if (existing) return existing;\n\n  const trie = buildRouteTrie(routeManifest);\n  routeTrieCache.set(routeManifest, trie);\n  return trie;\n}\n\nfunction matchNode(\n  node: OptimisticRouteTrieNode,\n  urlParts: readonly string[],\n  index: number,\n): OptimisticRouteMatch | null {\n  if (index === urlParts.length) {\n    if (node.route !== null) {\n      return { route: node.route, params: Object.create(null) };\n    }\n    if (node.optionalCatchAllChild !== null) {\n      return {\n        route: node.optionalCatchAllChild.route,\n        params: Object.create(null),\n      };\n    }\n    return null;\n  }\n\n  const segment = urlParts[index];\n  const staticChild = node.staticChildren.get(segment);\n  if (staticChild !== undefined) {\n    // Static children are authoritative for optimistic routing. If a known\n    // static subtree does not contain the remaining URL, do not fall through to\n    // a catch-all sibling and render the wrong loading boundary.\n    return matchNode(staticChild, urlParts, index + 1);\n  }\n\n  if (node.dynamicChild !== null) {\n    const match = matchNode(node.dynamicChild.node, urlParts, index + 1);\n    if (match === null) return null;\n    match.params[node.dynamicChild.paramName] = segment;\n    return match;\n  }\n\n  if (node.catchAllChild !== null) {\n    return {\n      route: node.catchAllChild.route,\n      params: {\n        [node.catchAllChild.paramName]: urlParts.slice(index),\n      },\n    };\n  }\n\n  if (node.optionalCatchAllChild !== null) {\n    return {\n      route: node.optionalCatchAllChild.route,\n      params: {\n        [node.optionalCatchAllChild.paramName]: urlParts.slice(index),\n      },\n    };\n  }\n\n  return null;\n}\n\nfunction hrefToRouteParts(href: string, basePath: string): string[] | null {\n  let url: URL;\n  try {\n    url = new URL(href, \"https://vinext.local\");\n  } catch {\n    return null;\n  }\n\n  stripRscCacheBustingSearchParam(url);\n  const withoutRscSuffix = stripRscSuffix(url.pathname);\n  const appPathname = stripBasePath(withoutRscSuffix, basePath);\n  return splitPathnameForRouteMatch(appPathname === \"\" ? \"/\" : appPathname);\n}\n\nexport function matchOptimisticRouteManifestRoute(options: {\n  basePath: string;\n  href: string;\n  routeManifest: RouteManifest;\n}): OptimisticRouteMatch | null {\n  const urlParts = hrefToRouteParts(options.href, options.basePath);\n  if (urlParts === null) return null;\n\n  const match = matchNode(getRouteTrie(options.routeManifest), urlParts, 0);\n  if (match === null) return null;\n\n  decodeMatchedParams(match.params);\n  return match;\n}\n\nfunction elementHasSuspenseFallback(value: unknown, depth = 0): boolean {\n  if (depth > 100) return false;\n  if (Array.isArray(value)) {\n    return value.some((entry) => elementHasSuspenseFallback(entry, depth + 1));\n  }\n  if (!isValidElement(value)) return false;\n\n  const props = Reflect.get(value, \"props\");\n  if (value.type === Suspense && isUnknownRecord(props)) {\n    const fallback = Reflect.get(props, \"fallback\");\n    if (fallback !== null && fallback !== undefined) return true;\n  }\n\n  if (!isUnknownRecord(props)) return false;\n  return elementHasSuspenseFallback(Reflect.get(props, \"children\"), depth + 1);\n}\n\nfunction getPageElementIds(elements: AppElements): string[] {\n  return Object.keys(elements)\n    .filter((key) => AppElementsWire.parseElementKey(key)?.kind === \"page\")\n    .sort();\n}\n\nfunction OptimisticRouteSegment(): null {\n  throw OPTIMISTIC_ROUTE_SEGMENT_SUSPENSE_TRIGGER;\n}\n\nexport function createOptimisticRouteTemplate(options: {\n  allowLoadingShell?: boolean;\n  basePath: string;\n  elements: AppElements;\n  href: string;\n  interceptionContext: string | null;\n  mountedSlotsHeader: string | null;\n  routeManifest: RouteManifest;\n}): OptimisticRouteTemplate | null {\n  const match = matchOptimisticRouteManifestRoute({\n    basePath: options.basePath,\n    href: options.href,\n    routeManifest: options.routeManifest,\n  });\n  if (match === null || !match.route.isDynamic) return null;\n  if (options.interceptionContext !== null) return null;\n\n  const metadata = AppElementsWire.readMetadata(options.elements);\n  if (metadata.interception !== null || metadata.interceptionContext !== null) return null;\n\n  const routeElement = options.elements[metadata.routeId];\n  // Full-prefetch learning is intentionally heuristic: legacy full prefetches\n  // are accepted only when the serialized route subtree still contains a\n  // Suspense fallback. Authoritative loading-shell prefetches use the marker\n  // check below instead.\n  if (!options.allowLoadingShell && !elementHasSuspenseFallback(routeElement)) return null;\n  if (\n    options.allowLoadingShell &&\n    options.elements[APP_PREFETCH_LOADING_SHELL_MARKER_KEY] !== \"LoadingBoundary\"\n  ) {\n    return null;\n  }\n  // Shell prefetches must include the eagerly-rendered loading component. A\n  // null route element means the server had no route loading boundary.\n  if (options.allowLoadingShell && (routeElement === undefined || routeElement === null))\n    return null;\n\n  const pageElementIds = getPageElementIds(options.elements);\n  if (pageElementIds.length === 0) return null;\n\n  return {\n    elements: options.elements,\n    mountedSlotsHeader: options.mountedSlotsHeader,\n    pageElementIds,\n    routeId: match.route.id,\n  };\n}\n\nexport function createOptimisticRouteElements(template: OptimisticRouteTemplate): AppElements {\n  const elements: Record<string, AppElementValue> = { ...template.elements };\n  for (const pageElementId of template.pageElementIds) {\n    elements[pageElementId] = createElement(OptimisticRouteSegment);\n  }\n  return elements;\n}\n\nexport function resolveOptimisticNavigationPayload(options: {\n  basePath: string;\n  href: string;\n  interceptionContext: string | null;\n  mountedSlotsHeader: string | null;\n  routeManifest: RouteManifest;\n  templates: ReadonlyMap<string, OptimisticRouteTemplate>;\n}): OptimisticNavigationPayload | null {\n  if (options.interceptionContext !== null) return null;\n\n  const match = matchOptimisticRouteManifestRoute({\n    basePath: options.basePath,\n    href: options.href,\n    routeManifest: options.routeManifest,\n  });\n  if (match === null || !match.route.isDynamic) return null;\n\n  const template = options.templates.get(\n    getOptimisticRouteTemplateKey({\n      interceptionContext: options.interceptionContext,\n      mountedSlotsHeader: options.mountedSlotsHeader,\n      routeId: match.route.id,\n    }),\n  );\n  if (template === undefined) return null;\n  if (template.mountedSlotsHeader !== options.mountedSlotsHeader) return null;\n\n  return {\n    elements: createOptimisticRouteElements(template),\n    params: match.params,\n    template,\n  };\n}\n"],"mappings":"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"}

package/dist/server/app-page-boundary-render.d.ts

@@ -38,7 +38,8 @@ type AppPageBoundaryRenderCommonOptions<TModule extends AppPageModule = AppPageM
   loadSsrHandler: () => Promise<AppPageSsrHandler>;
   makeThenableParams: (params: AppPageParams) => unknown;
   middlewareContext: AppPageMiddlewareContext;
-  metadataRoutes: MetadataFileRoute[];
+  metadataRoutes: MetadataFileRoute[]; /** Configured next.config `basePath`, threaded into file-based metadata href emission. */
+  basePath?: string;
   renderToReadableStream: (element: ReactNode | AppElements, options: {
     onError: AppPageBoundaryOnError;
   }) => ReadableStream<Uint8Array>;
@@ -55,6 +56,14 @@ type RenderAppPageHttpAccessFallbackOptions<TModule extends AppPageModule = AppP
   rootNotFoundModule?: TModule | null;
   rootUnauthorizedModule?: TModule | null;
   route?: AppPageBoundaryRoute<TModule> | null;
+  /**
+   * When true, the resolved boundary is rendered without wrapping it in the
+   * route's layouts. Used by `global-not-found.tsx`, which provides its own
+   * `<html>`/`<body>` and intentionally replaces the root layout.
+   * Mirrors Next.js's `createNotFoundLoaderTree` behavior for `hasGlobalNotFound`.
+   * @see https://github.com/vercel/next.js/blob/canary/packages/next/src/server/app-render/app-render.tsx#L495-L520
+   */
+  skipLayoutWrapping?: boolean;
   statusCode: number;
 } & AppPageBoundaryRenderCommonOptions<TModule>;
 type RenderAppPageErrorBoundaryOptions<TModule extends AppPageModule = AppPageModule> = {

package/dist/server/app-page-boundary-render.js

@@ -129,13 +129,15 @@ async function renderAppPageHttpAccessFallback(options) {
 	});
 	if (!boundaryComponent) return null;
 	const layoutModules = options.layoutModules ?? options.route?.layouts ?? options.rootLayouts;
+	const pathname = new URL(options.requestUrl).pathname;
 	const routeSegments = resolveHttpAccessFallbackHeadRouteSegments(options.route, layoutModules);
 	const { metadata, viewport } = await resolveAppPageHead({
+		basePath: options.basePath ?? "",
 		layoutModules,
 		layoutTreePositions: resolveHttpAccessFallbackHeadLayoutTreePositions(options.route, layoutModules),
 		metadataRoutes: options.metadataRoutes,
 		params: options.matchedParams,
-		routePath: options.route?.pattern ?? new URL(options.requestUrl).pathname,
+		routePath: options.route?.pattern ?? pathname,
 		routeSegments
 	});
 	const headElements = [createElement("meta", {
@@ -148,12 +150,14 @@ async function renderAppPageHttpAccessFallback(options) {
 	})];
 	if (metadata) headElements.push(createElement(MetadataHead, {
 		key: "metadata",
-		metadata
+		metadata,
+		pathname
 	}));
 	headElements.push(createElement(ViewportHead, {
 		key: "viewport",
 		viewport
 	}));
+	const skipLayoutWrapping = options.skipLayoutWrapping ?? false;
 	const element = wrapRenderedBoundaryElement({
 		element: createElement(Fragment, null, ...headElements, createElement(boundaryComponent)),
 		globalErrorModule: options.globalErrorModule,
@@ -164,13 +168,14 @@ async function renderAppPageHttpAccessFallback(options) {
 		makeThenableParams: options.makeThenableParams,
 		matchedParams: options.matchedParams,
 		resolveChildSegments: options.resolveChildSegments,
-		routeSegments: options.route?.routeSegments
+		routeSegments: options.route?.routeSegments,
+		skipLayoutWrapping
 	});
 	return renderAppPageBoundaryElementResponse({
 		...options,
 		element,
-		layoutModules,
-		route: options.route,
+		layoutModules: skipLayoutWrapping ? [] : layoutModules,
+		route: skipLayoutWrapping ? null : options.route,
 		routePattern: options.route?.pattern,
 		status: options.statusCode
 	});
@@ -196,6 +201,7 @@ async function renderAppPageErrorBoundary(options) {
 	})];
 	if (!errorBoundary.isGlobalError) try {
 		const { metadata, viewport } = await resolveAppPageHead({
+			basePath: options.basePath ?? "",
 			fallbackOnFileMetadataError: true,
 			layoutModules,
 			layoutTreePositions: options.route?.layoutTreePositions,
@@ -206,7 +212,8 @@ async function renderAppPageErrorBoundary(options) {
 		});
 		if (metadata) headElements.push(createElement(MetadataHead, {
 			key: "metadata",
-			metadata
+			metadata,
+			pathname
 		}));
 		headElements.push(createElement(ViewportHead, {
 			key: "viewport",

package/dist/server/app-page-boundary-render.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-page-boundary-render.js","names":[],"sources":["../../src/server/app-page-boundary-render.ts"],"sourcesContent":["import { Fragment, createElement, type ComponentType, type ReactNode } from \"react\";\nimport { buildClientHookErrorMessage } from \"vinext/shims/client-hook-error\";\nimport { ErrorBoundary } from \"vinext/shims/error-boundary\";\nimport { LayoutSegmentProvider } from \"vinext/shims/layout-segment-context\";\nimport { MetadataHead, ViewportHead } from \"vinext/shims/metadata\";\nimport type { AppPageFontPreload } from \"./app-page-execution.js\";\nimport type { AppPageMiddlewareContext } from \"./app-page-response.js\";\nimport type { MetadataFileRoute } from \"./metadata-routes.js\";\nimport { resolveAppPageHead } from \"./app-page-head.js\";\nimport {\n  renderAppPageBoundaryResponse,\n  resolveAppPageErrorBoundary,\n  resolveAppPageHttpAccessBoundaryComponent,\n  wrapAppPageBoundaryElement,\n  type AppPageParams,\n} from \"./app-page-boundary.js\";\nimport {\n  createAppPageFontData,\n  renderAppPageHtmlResponse,\n  type AppPageSsrHandler,\n} from \"./app-page-stream.js\";\nimport { AppElementsWire, type AppElements } from \"./app-elements.js\";\nimport { createAppPageLayoutEntries } from \"./app-page-route-wiring.js\";\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\ntype AppPageComponent = ComponentType<any>;\ntype AppPageModule = Record<string, unknown> & {\n  default?: AppPageComponent | null | undefined;\n};\ntype AppPageBoundaryOnError = (\n  error: unknown,\n  requestInfo: unknown,\n  errorContext: unknown,\n) => unknown;\n\ntype AppPageBoundaryRscPayloadOptions<TModule extends AppPageModule = AppPageModule> = {\n  element: ReactNode;\n  layoutModules: readonly (TModule | null | undefined)[];\n  pathname: string;\n  route?: AppPageBoundaryRoute<TModule> | null;\n};\n\ntype AppPageBoundaryLayoutEntry = {\n  id: string;\n  treePath: string;\n};\n\nexport type AppPageBoundaryRoute<TModule extends AppPageModule = AppPageModule> = {\n  error?: TModule | null;\n  errorPaths?: readonly TModule[] | null;\n  errors?: readonly (TModule | null | undefined)[] | null;\n  forbidden?: TModule | null;\n  layoutTreePositions?: readonly number[] | null;\n  layouts?: readonly (TModule | null | undefined)[];\n  notFound?: TModule | null;\n  params?: AppPageParams;\n  pattern?: string;\n  routeSegments?: readonly string[];\n  unauthorized?: TModule | null;\n};\n\ntype AppPageBoundaryRenderCommonOptions<TModule extends AppPageModule = AppPageModule> = {\n  buildFontLinkHeader: (preloads: readonly AppPageFontPreload[] | null | undefined) => string;\n  clearRequestContext: () => void;\n  createRscOnErrorHandler: (pathname: string, routePath: string) => AppPageBoundaryOnError;\n  getFontLinks: () => string[];\n  getFontPreloads: () => AppPageFontPreload[];\n  getFontStyles: () => string[];\n  getNavigationContext: () => unknown;\n  globalErrorModule?: TModule | null;\n  isRscRequest: boolean;\n  loadSsrHandler: () => Promise<AppPageSsrHandler>;\n  makeThenableParams: (params: AppPageParams) => unknown;\n  middlewareContext: AppPageMiddlewareContext;\n  metadataRoutes: MetadataFileRoute[];\n  renderToReadableStream: (\n    element: ReactNode | AppElements,\n    options: { onError: AppPageBoundaryOnError },\n  ) => ReadableStream<Uint8Array>;\n  requestUrl: string;\n  resolveChildSegments: (\n    routeSegments: readonly string[],\n    treePosition: number,\n    params: AppPageParams,\n  ) => string[];\n  rootLayouts: readonly (TModule | null | undefined)[];\n  scriptNonce?: string;\n};\n\ntype RenderAppPageHttpAccessFallbackOptions<TModule extends AppPageModule = AppPageModule> = {\n  boundaryComponent?: AppPageComponent | null;\n  layoutModules?: readonly (TModule | null | undefined)[] | null;\n  matchedParams: AppPageParams;\n  rootForbiddenModule?: TModule | null;\n  rootNotFoundModule?: TModule | null;\n  rootUnauthorizedModule?: TModule | null;\n  route?: AppPageBoundaryRoute<TModule> | null;\n  statusCode: number;\n} & AppPageBoundaryRenderCommonOptions<TModule>;\n\ntype RenderAppPageErrorBoundaryOptions<TModule extends AppPageModule = AppPageModule> = {\n  error: unknown;\n  matchedParams?: AppPageParams | null;\n  route?: AppPageBoundaryRoute<TModule> | null;\n  sanitizeErrorForClient: (error: Error) => Error;\n} & AppPageBoundaryRenderCommonOptions<TModule>;\n\nfunction getDefaultExport<TModule extends AppPageModule>(\n  module: TModule | null | undefined,\n): AppPageComponent | null {\n  return module?.default ?? null;\n}\n\nfunction wrapRenderedBoundaryElement<TModule extends AppPageModule>(\n  options: Pick<\n    AppPageBoundaryRenderCommonOptions<TModule>,\n    \"globalErrorModule\" | \"isRscRequest\" | \"makeThenableParams\" | \"resolveChildSegments\"\n  > & {\n    element: ReactNode;\n    includeGlobalErrorBoundary: boolean;\n    layoutModules: readonly (TModule | null | undefined)[];\n    layoutTreePositions?: readonly number[] | null;\n    matchedParams: AppPageParams;\n    routeSegments?: readonly string[];\n    skipLayoutWrapping?: boolean;\n  },\n): ReactNode {\n  return wrapAppPageBoundaryElement({\n    element: options.element,\n    getDefaultExport,\n    globalErrorComponent: getDefaultExport(options.globalErrorModule),\n    includeGlobalErrorBoundary: options.includeGlobalErrorBoundary,\n    isRscRequest: options.isRscRequest,\n    layoutModules: options.layoutModules,\n    layoutTreePositions: options.layoutTreePositions,\n    makeThenableParams: options.makeThenableParams,\n    matchedParams: options.matchedParams,\n    renderErrorBoundary(GlobalErrorComponent, children) {\n      return createElement(ErrorBoundary, {\n        fallback: GlobalErrorComponent,\n        // oxlint-disable-next-line react/no-children-prop\n        children,\n      });\n    },\n    renderLayout(LayoutComponent, children, asyncParams) {\n      return createElement(LayoutComponent as AppPageComponent, {\n        // oxlint-disable-next-line react/no-children-prop\n        children,\n        params: asyncParams,\n      });\n    },\n    renderLayoutSegmentProvider(segmentMap, children) {\n      return createElement(\n        // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n        LayoutSegmentProvider as ComponentType<any>,\n        { segmentMap },\n        children,\n      );\n    },\n    resolveChildSegments: options.resolveChildSegments,\n    routeSegments: options.routeSegments ?? [],\n    skipLayoutWrapping: options.skipLayoutWrapping,\n  });\n}\n\nfunction createAppPageBoundaryLayoutEntries<TModule extends AppPageModule>(\n  route: AppPageBoundaryRoute<TModule> | null | undefined,\n  layoutModules: readonly (TModule | null | undefined)[],\n): readonly AppPageBoundaryLayoutEntry[] {\n  if (!route || layoutModules.length === 0) return [];\n\n  return createAppPageLayoutEntries({\n    errors: route.errors,\n    layoutTreePositions: route.layoutTreePositions,\n    layouts: layoutModules,\n    notFounds: null,\n    routeSegments: route.routeSegments,\n  });\n}\n\nfunction resolveHttpAccessFallbackHeadRouteSegments<TModule extends AppPageModule>(\n  route: AppPageBoundaryRoute<TModule> | null | undefined,\n  layoutModules: readonly (TModule | null | undefined)[],\n): readonly string[] | undefined {\n  if (!route?.routeSegments) {\n    return undefined;\n  }\n\n  if (!route.layouts || layoutModules.length >= route.layouts.length) {\n    return route.routeSegments;\n  }\n\n  const lastIncludedLayoutIndex = layoutModules.length - 1;\n  if (lastIncludedLayoutIndex < 0) {\n    return [];\n  }\n\n  const segmentCount = route.layoutTreePositions?.[lastIncludedLayoutIndex] ?? 0;\n  return route.routeSegments.slice(0, segmentCount);\n}\n\nfunction resolveHttpAccessFallbackHeadLayoutTreePositions<TModule extends AppPageModule>(\n  route: AppPageBoundaryRoute<TModule> | null | undefined,\n  layoutModules: readonly (TModule | null | undefined)[],\n): readonly number[] | null | undefined {\n  if (!route?.layouts || layoutModules.length >= route.layouts.length) {\n    return route?.layoutTreePositions;\n  }\n\n  return route.layoutTreePositions?.slice(0, layoutModules.length);\n}\n\nfunction createAppPageBoundaryRscPayload<TModule extends AppPageModule>(\n  options: AppPageBoundaryRscPayloadOptions<TModule>,\n): AppElements {\n  const routeId = AppElementsWire.encodeRouteId(options.pathname, null);\n  const layoutEntries = createAppPageBoundaryLayoutEntries(options.route, options.layoutModules);\n\n  return {\n    ...AppElementsWire.createMetadataEntries({\n      interceptionContext: null,\n      layoutIds: layoutEntries.map((entry) => entry.id),\n      rootLayoutTreePath: layoutEntries[0]?.treePath ?? null,\n      routeId,\n    }),\n    [routeId]: options.element,\n  };\n}\n\nasync function renderAppPageBoundaryElementResponse<TModule extends AppPageModule>(\n  options: AppPageBoundaryRenderCommonOptions<TModule> & {\n    element: ReactNode;\n    layoutModules: readonly (TModule | null | undefined)[];\n    route?: AppPageBoundaryRoute<TModule> | null;\n    routePattern?: string;\n    status: number;\n  },\n): Promise<Response> {\n  const pathname = new URL(options.requestUrl).pathname;\n  const payload = createAppPageBoundaryRscPayload({\n    element: options.element,\n    layoutModules: options.layoutModules,\n    pathname,\n    route: options.route,\n  });\n\n  return renderAppPageBoundaryResponse({\n    async createHtmlResponse(rscStream, responseStatus) {\n      const fontData = createAppPageFontData({\n        getLinks: options.getFontLinks,\n        getPreloads: options.getFontPreloads,\n        getStyles: options.getFontStyles,\n      });\n      const ssrHandler = await options.loadSsrHandler();\n      return renderAppPageHtmlResponse({\n        clearRequestContext: options.clearRequestContext,\n        fontData,\n        fontLinkHeader: options.buildFontLinkHeader(fontData.preloads),\n        middlewareHeaders: options.middlewareContext.headers,\n        navigationContext: options.getNavigationContext(),\n        rscStream,\n        scriptNonce: options.scriptNonce,\n        ssrHandler,\n        status: responseStatus,\n      });\n    },\n    createRscOnErrorHandler() {\n      return options.createRscOnErrorHandler(pathname, options.routePattern ?? pathname);\n    },\n    element: payload,\n    isRscRequest: options.isRscRequest,\n    middlewareHeaders: options.middlewareContext.headers,\n    renderToReadableStream: options.renderToReadableStream,\n    status: options.status,\n  });\n}\n\nexport async function renderAppPageHttpAccessFallback<TModule extends AppPageModule>(\n  options: RenderAppPageHttpAccessFallbackOptions<TModule>,\n): Promise<Response | null> {\n  const boundaryComponent =\n    options.boundaryComponent ??\n    resolveAppPageHttpAccessBoundaryComponent({\n      getDefaultExport,\n      rootForbiddenModule: options.rootForbiddenModule,\n      rootNotFoundModule: options.rootNotFoundModule,\n      rootUnauthorizedModule: options.rootUnauthorizedModule,\n      routeForbiddenModule: options.route?.forbidden,\n      routeNotFoundModule: options.route?.notFound,\n      routeUnauthorizedModule: options.route?.unauthorized,\n      statusCode: options.statusCode,\n    });\n  if (!boundaryComponent) {\n    return null;\n  }\n\n  const layoutModules = options.layoutModules ?? options.route?.layouts ?? options.rootLayouts;\n  const routeSegments = resolveHttpAccessFallbackHeadRouteSegments(options.route, layoutModules);\n  const { metadata, viewport } = await resolveAppPageHead({\n    layoutModules,\n    layoutTreePositions: resolveHttpAccessFallbackHeadLayoutTreePositions(\n      options.route,\n      layoutModules,\n    ),\n    metadataRoutes: options.metadataRoutes,\n    params: options.matchedParams,\n    routePath: options.route?.pattern ?? new URL(options.requestUrl).pathname,\n    routeSegments,\n  });\n\n  const headElements: ReactNode[] = [\n    createElement(\"meta\", { charSet: \"utf-8\", key: \"charset\" }),\n    createElement(\"meta\", { content: \"noindex\", key: \"robots\", name: \"robots\" }),\n  ];\n  if (metadata) {\n    headElements.push(createElement(MetadataHead, { key: \"metadata\", metadata }));\n  }\n  headElements.push(createElement(ViewportHead, { key: \"viewport\", viewport }));\n\n  const element = wrapRenderedBoundaryElement({\n    element: createElement(Fragment, null, ...headElements, createElement(boundaryComponent)),\n    globalErrorModule: options.globalErrorModule,\n    includeGlobalErrorBoundary: true,\n    isRscRequest: options.isRscRequest,\n    layoutModules,\n    layoutTreePositions: options.route?.layoutTreePositions,\n    makeThenableParams: options.makeThenableParams,\n    matchedParams: options.matchedParams,\n    resolveChildSegments: options.resolveChildSegments,\n    routeSegments: options.route?.routeSegments,\n  });\n\n  return renderAppPageBoundaryElementResponse({\n    ...options,\n    element,\n    layoutModules,\n    route: options.route,\n    routePattern: options.route?.pattern,\n    status: options.statusCode,\n  });\n}\n\nexport async function renderAppPageErrorBoundary<TModule extends AppPageModule>(\n  options: RenderAppPageErrorBoundaryOptions<TModule>,\n): Promise<Response | null> {\n  const errorBoundary = resolveAppPageErrorBoundary({\n    getDefaultExport,\n    errorModules: options.route?.errorPaths,\n    globalErrorModule: options.globalErrorModule,\n    layoutErrorModules: options.route?.errors,\n    pageErrorModule: options.route?.error,\n  });\n  if (!errorBoundary.component) {\n    return null;\n  }\n\n  const rawError =\n    options.error instanceof Error ? options.error : new Error(String(options.error));\n  rewriteClientHookError(rawError);\n  const errorObject = options.sanitizeErrorForClient(rawError);\n  const matchedParams = options.matchedParams ?? options.route?.params ?? {};\n  const layoutModules = options.route?.layouts ?? options.rootLayouts;\n  const pathname = new URL(options.requestUrl).pathname;\n\n  const headElements: ReactNode[] = [createElement(\"meta\", { charSet: \"utf-8\", key: \"charset\" })];\n  if (!errorBoundary.isGlobalError) {\n    try {\n      const { metadata, viewport } = await resolveAppPageHead({\n        fallbackOnFileMetadataError: true,\n        layoutModules,\n        layoutTreePositions: options.route?.layoutTreePositions,\n        metadataRoutes: options.metadataRoutes,\n        params: matchedParams,\n        routePath: options.route?.pattern ?? pathname,\n        routeSegments: options.route?.routeSegments,\n      });\n      if (metadata) {\n        headElements.push(createElement(MetadataHead, { key: \"metadata\", metadata }));\n      }\n      headElements.push(createElement(ViewportHead, { key: \"viewport\", viewport }));\n    } catch (error) {\n      console.error(\n        `[vinext] App page error boundary head resolution failed for ${options.route?.pattern ?? pathname}:`,\n        error,\n      );\n    }\n  }\n\n  const element = wrapRenderedBoundaryElement({\n    element: createElement(\n      Fragment,\n      null,\n      ...headElements,\n      createElement(errorBoundary.component, {\n        error: errorObject,\n      }),\n    ),\n    globalErrorModule: options.globalErrorModule,\n    includeGlobalErrorBoundary: !errorBoundary.isGlobalError,\n    isRscRequest: options.isRscRequest,\n    layoutModules,\n    layoutTreePositions: options.route?.layoutTreePositions,\n    makeThenableParams: options.makeThenableParams,\n    matchedParams,\n    resolveChildSegments: options.resolveChildSegments,\n    routeSegments: options.route?.routeSegments,\n    skipLayoutWrapping: errorBoundary.isGlobalError,\n  });\n\n  return renderAppPageBoundaryElementResponse({\n    ...options,\n    element,\n    layoutModules,\n    route: options.route,\n    routePattern: options.route?.pattern,\n    status: 200,\n  });\n}\n\n// React client-only hooks that are absent from the `react-server` export\n// condition. When called in a Server Component they produce a TypeError like\n// \"useState is not a function\". Rewrite into an actionable message matching\n// the format used by the next/navigation shims (see client-hook-error.ts).\nconst _clientHookPattern =\n  /\\b(useState|useEffect|useReducer|useRef|useContext|useLayoutEffect|useInsertionEffect|useSyncExternalStore|useTransition|useImperativeHandle|useDeferredValue|useActionState|useOptimistic|useEffectEvent)\\b.*is not a function/;\n\nfunction rewriteClientHookError(error: Error): void {\n  const match = error.message.match(_clientHookPattern);\n  if (match) {\n    error.message = buildClientHookErrorMessage(`${match[1]}()`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;AA2GA,SAAS,iBACP,QACyB;CACzB,OAAO,QAAQ,WAAW;;AAG5B,SAAS,4BACP,SAYW;CACX,OAAO,2BAA2B;EAChC,SAAS,QAAQ;EACjB;EACA,sBAAsB,iBAAiB,QAAQ,kBAAkB;EACjE,4BAA4B,QAAQ;EACpC,cAAc,QAAQ;EACtB,eAAe,QAAQ;EACvB,qBAAqB,QAAQ;EAC7B,oBAAoB,QAAQ;EAC5B,eAAe,QAAQ;EACvB,oBAAoB,sBAAsB,UAAU;GAClD,OAAO,cAAc,eAAe;IAClC,UAAU;IAEV;IACD,CAAC;;EAEJ,aAAa,iBAAiB,UAAU,aAAa;GACnD,OAAO,cAAc,iBAAqC;IAExD;IACA,QAAQ;IACT,CAAC;;EAEJ,4BAA4B,YAAY,UAAU;GAChD,OAAO,cAEL,uBACA,EAAE,YAAY,EACd,SACD;;EAEH,sBAAsB,QAAQ;EAC9B,eAAe,QAAQ,iBAAiB,EAAE;EAC1C,oBAAoB,QAAQ;EAC7B,CAAC;;AAGJ,SAAS,mCACP,OACA,eACuC;CACvC,IAAI,CAAC,SAAS,cAAc,WAAW,GAAG,OAAO,EAAE;CAEnD,OAAO,2BAA2B;EAChC,QAAQ,MAAM;EACd,qBAAqB,MAAM;EAC3B,SAAS;EACT,WAAW;EACX,eAAe,MAAM;EACtB,CAAC;;AAGJ,SAAS,2CACP,OACA,eAC+B;CAC/B,IAAI,CAAC,OAAO,eACV;CAGF,IAAI,CAAC,MAAM,WAAW,cAAc,UAAU,MAAM,QAAQ,QAC1D,OAAO,MAAM;CAGf,MAAM,0BAA0B,cAAc,SAAS;CACvD,IAAI,0BAA0B,GAC5B,OAAO,EAAE;CAGX,MAAM,eAAe,MAAM,sBAAsB,4BAA4B;CAC7E,OAAO,MAAM,cAAc,MAAM,GAAG,aAAa;;AAGnD,SAAS,iDACP,OACA,eACsC;CACtC,IAAI,CAAC,OAAO,WAAW,cAAc,UAAU,MAAM,QAAQ,QAC3D,OAAO,OAAO;CAGhB,OAAO,MAAM,qBAAqB,MAAM,GAAG,cAAc,OAAO;;AAGlE,SAAS,gCACP,SACa;CACb,MAAM,UAAU,gBAAgB,cAAc,QAAQ,UAAU,KAAK;CACrE,MAAM,gBAAgB,mCAAmC,QAAQ,OAAO,QAAQ,cAAc;CAE9F,OAAO;EACL,GAAG,gBAAgB,sBAAsB;GACvC,qBAAqB;GACrB,WAAW,cAAc,KAAK,UAAU,MAAM,GAAG;GACjD,oBAAoB,cAAc,IAAI,YAAY;GAClD;GACD,CAAC;GACD,UAAU,QAAQ;EACpB;;AAGH,eAAe,qCACb,SAOmB;CACnB,MAAM,WAAW,IAAI,IAAI,QAAQ,WAAW,CAAC;CAQ7C,OAAO,8BAA8B;EACnC,MAAM,mBAAmB,WAAW,gBAAgB;GAClD,MAAM,WAAW,sBAAsB;IACrC,UAAU,QAAQ;IAClB,aAAa,QAAQ;IACrB,WAAW,QAAQ;IACpB,CAAC;GACF,MAAM,aAAa,MAAM,QAAQ,gBAAgB;GACjD,OAAO,0BAA0B;IAC/B,qBAAqB,QAAQ;IAC7B;IACA,gBAAgB,QAAQ,oBAAoB,SAAS,SAAS;IAC9D,mBAAmB,QAAQ,kBAAkB;IAC7C,mBAAmB,QAAQ,sBAAsB;IACjD;IACA,aAAa,QAAQ;IACrB;IACA,QAAQ;IACT,CAAC;;EAEJ,0BAA0B;GACxB,OAAO,QAAQ,wBAAwB,UAAU,QAAQ,gBAAgB,SAAS;;EAEpF,SA9Bc,gCAAgC;GAC9C,SAAS,QAAQ;GACjB,eAAe,QAAQ;GACvB;GACA,OAAO,QAAQ;GAChB,CAyBiB;EAChB,cAAc,QAAQ;EACtB,mBAAmB,QAAQ,kBAAkB;EAC7C,wBAAwB,QAAQ;EAChC,QAAQ,QAAQ;EACjB,CAAC;;AAGJ,eAAsB,gCACpB,SAC0B;CAC1B,MAAM,oBACJ,QAAQ,qBACR,0CAA0C;EACxC;EACA,qBAAqB,QAAQ;EAC7B,oBAAoB,QAAQ;EAC5B,wBAAwB,QAAQ;EAChC,sBAAsB,QAAQ,OAAO;EACrC,qBAAqB,QAAQ,OAAO;EACpC,yBAAyB,QAAQ,OAAO;EACxC,YAAY,QAAQ;EACrB,CAAC;CACJ,IAAI,CAAC,mBACH,OAAO;CAGT,MAAM,gBAAgB,QAAQ,iBAAiB,QAAQ,OAAO,WAAW,QAAQ;CACjF,MAAM,gBAAgB,2CAA2C,QAAQ,OAAO,cAAc;CAC9F,MAAM,EAAE,UAAU,aAAa,MAAM,mBAAmB;EACtD;EACA,qBAAqB,iDACnB,QAAQ,OACR,cACD;EACD,gBAAgB,QAAQ;EACxB,QAAQ,QAAQ;EAChB,WAAW,QAAQ,OAAO,WAAW,IAAI,IAAI,QAAQ,WAAW,CAAC;EACjE;EACD,CAAC;CAEF,MAAM,eAA4B,CAChC,cAAc,QAAQ;EAAE,SAAS;EAAS,KAAK;EAAW,CAAC,EAC3D,cAAc,QAAQ;EAAE,SAAS;EAAW,KAAK;EAAU,MAAM;EAAU,CAAC,CAC7E;CACD,IAAI,UACF,aAAa,KAAK,cAAc,cAAc;EAAE,KAAK;EAAY;EAAU,CAAC,CAAC;CAE/E,aAAa,KAAK,cAAc,cAAc;EAAE,KAAK;EAAY;EAAU,CAAC,CAAC;CAE7E,MAAM,UAAU,4BAA4B;EAC1C,SAAS,cAAc,UAAU,MAAM,GAAG,cAAc,cAAc,kBAAkB,CAAC;EACzF,mBAAmB,QAAQ;EAC3B,4BAA4B;EAC5B,cAAc,QAAQ;EACtB;EACA,qBAAqB,QAAQ,OAAO;EACpC,oBAAoB,QAAQ;EAC5B,eAAe,QAAQ;EACvB,sBAAsB,QAAQ;EAC9B,eAAe,QAAQ,OAAO;EAC/B,CAAC;CAEF,OAAO,qCAAqC;EAC1C,GAAG;EACH;EACA;EACA,OAAO,QAAQ;EACf,cAAc,QAAQ,OAAO;EAC7B,QAAQ,QAAQ;EACjB,CAAC;;AAGJ,eAAsB,2BACpB,SAC0B;CAC1B,MAAM,gBAAgB,4BAA4B;EAChD;EACA,cAAc,QAAQ,OAAO;EAC7B,mBAAmB,QAAQ;EAC3B,oBAAoB,QAAQ,OAAO;EACnC,iBAAiB,QAAQ,OAAO;EACjC,CAAC;CACF,IAAI,CAAC,cAAc,WACjB,OAAO;CAGT,MAAM,WACJ,QAAQ,iBAAiB,QAAQ,QAAQ,QAAQ,IAAI,MAAM,OAAO,QAAQ,MAAM,CAAC;CACnF,uBAAuB,SAAS;CAChC,MAAM,cAAc,QAAQ,uBAAuB,SAAS;CAC5D,MAAM,gBAAgB,QAAQ,iBAAiB,QAAQ,OAAO,UAAU,EAAE;CAC1E,MAAM,gBAAgB,QAAQ,OAAO,WAAW,QAAQ;CACxD,MAAM,WAAW,IAAI,IAAI,QAAQ,WAAW,CAAC;CAE7C,MAAM,eAA4B,CAAC,cAAc,QAAQ;EAAE,SAAS;EAAS,KAAK;EAAW,CAAC,CAAC;CAC/F,IAAI,CAAC,cAAc,eACjB,IAAI;EACF,MAAM,EAAE,UAAU,aAAa,MAAM,mBAAmB;GACtD,6BAA6B;GAC7B;GACA,qBAAqB,QAAQ,OAAO;GACpC,gBAAgB,QAAQ;GACxB,QAAQ;GACR,WAAW,QAAQ,OAAO,WAAW;GACrC,eAAe,QAAQ,OAAO;GAC/B,CAAC;EACF,IAAI,UACF,aAAa,KAAK,cAAc,cAAc;GAAE,KAAK;GAAY;GAAU,CAAC,CAAC;EAE/E,aAAa,KAAK,cAAc,cAAc;GAAE,KAAK;GAAY;GAAU,CAAC,CAAC;UACtE,OAAO;EACd,QAAQ,MACN,+DAA+D,QAAQ,OAAO,WAAW,SAAS,IAClG,MACD;;CAIL,MAAM,UAAU,4BAA4B;EAC1C,SAAS,cACP,UACA,MACA,GAAG,cACH,cAAc,cAAc,WAAW,EACrC,OAAO,aACR,CAAC,CACH;EACD,mBAAmB,QAAQ;EAC3B,4BAA4B,CAAC,cAAc;EAC3C,cAAc,QAAQ;EACtB;EACA,qBAAqB,QAAQ,OAAO;EACpC,oBAAoB,QAAQ;EAC5B;EACA,sBAAsB,QAAQ;EAC9B,eAAe,QAAQ,OAAO;EAC9B,oBAAoB,cAAc;EACnC,CAAC;CAEF,OAAO,qCAAqC;EAC1C,GAAG;EACH;EACA;EACA,OAAO,QAAQ;EACf,cAAc,QAAQ,OAAO;EAC7B,QAAQ;EACT,CAAC;;AAOJ,MAAM,qBACJ;AAEF,SAAS,uBAAuB,OAAoB;CAClD,MAAM,QAAQ,MAAM,QAAQ,MAAM,mBAAmB;CACrD,IAAI,OACF,MAAM,UAAU,4BAA4B,GAAG,MAAM,GAAG,IAAI"}
+{"version":3,"file":"app-page-boundary-render.js","names":[],"sources":["../../src/server/app-page-boundary-render.ts"],"sourcesContent":["import { Fragment, createElement, type ComponentType, type ReactNode } from \"react\";\nimport { buildClientHookErrorMessage } from \"vinext/shims/client-hook-error\";\nimport { ErrorBoundary } from \"vinext/shims/error-boundary\";\nimport { LayoutSegmentProvider } from \"vinext/shims/layout-segment-context\";\nimport { MetadataHead, ViewportHead } from \"vinext/shims/metadata\";\nimport type { AppPageFontPreload } from \"./app-page-execution.js\";\nimport type { AppPageMiddlewareContext } from \"./app-page-response.js\";\nimport type { MetadataFileRoute } from \"./metadata-routes.js\";\nimport { resolveAppPageHead } from \"./app-page-head.js\";\nimport {\n  renderAppPageBoundaryResponse,\n  resolveAppPageErrorBoundary,\n  resolveAppPageHttpAccessBoundaryComponent,\n  wrapAppPageBoundaryElement,\n  type AppPageParams,\n} from \"./app-page-boundary.js\";\nimport {\n  createAppPageFontData,\n  renderAppPageHtmlResponse,\n  type AppPageSsrHandler,\n} from \"./app-page-stream.js\";\nimport { AppElementsWire, type AppElements } from \"./app-elements.js\";\nimport { createAppPageLayoutEntries } from \"./app-page-route-wiring.js\";\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\ntype AppPageComponent = ComponentType<any>;\ntype AppPageModule = Record<string, unknown> & {\n  default?: AppPageComponent | null | undefined;\n};\ntype AppPageBoundaryOnError = (\n  error: unknown,\n  requestInfo: unknown,\n  errorContext: unknown,\n) => unknown;\n\ntype AppPageBoundaryRscPayloadOptions<TModule extends AppPageModule = AppPageModule> = {\n  element: ReactNode;\n  layoutModules: readonly (TModule | null | undefined)[];\n  pathname: string;\n  route?: AppPageBoundaryRoute<TModule> | null;\n};\n\ntype AppPageBoundaryLayoutEntry = {\n  id: string;\n  treePath: string;\n};\n\nexport type AppPageBoundaryRoute<TModule extends AppPageModule = AppPageModule> = {\n  error?: TModule | null;\n  errorPaths?: readonly TModule[] | null;\n  errors?: readonly (TModule | null | undefined)[] | null;\n  forbidden?: TModule | null;\n  layoutTreePositions?: readonly number[] | null;\n  layouts?: readonly (TModule | null | undefined)[];\n  notFound?: TModule | null;\n  params?: AppPageParams;\n  pattern?: string;\n  routeSegments?: readonly string[];\n  unauthorized?: TModule | null;\n};\n\ntype AppPageBoundaryRenderCommonOptions<TModule extends AppPageModule = AppPageModule> = {\n  buildFontLinkHeader: (preloads: readonly AppPageFontPreload[] | null | undefined) => string;\n  clearRequestContext: () => void;\n  createRscOnErrorHandler: (pathname: string, routePath: string) => AppPageBoundaryOnError;\n  getFontLinks: () => string[];\n  getFontPreloads: () => AppPageFontPreload[];\n  getFontStyles: () => string[];\n  getNavigationContext: () => unknown;\n  globalErrorModule?: TModule | null;\n  isRscRequest: boolean;\n  loadSsrHandler: () => Promise<AppPageSsrHandler>;\n  makeThenableParams: (params: AppPageParams) => unknown;\n  middlewareContext: AppPageMiddlewareContext;\n  metadataRoutes: MetadataFileRoute[];\n  /** Configured next.config `basePath`, threaded into file-based metadata href emission. */\n  basePath?: string;\n  renderToReadableStream: (\n    element: ReactNode | AppElements,\n    options: { onError: AppPageBoundaryOnError },\n  ) => ReadableStream<Uint8Array>;\n  requestUrl: string;\n  resolveChildSegments: (\n    routeSegments: readonly string[],\n    treePosition: number,\n    params: AppPageParams,\n  ) => string[];\n  rootLayouts: readonly (TModule | null | undefined)[];\n  scriptNonce?: string;\n};\n\ntype RenderAppPageHttpAccessFallbackOptions<TModule extends AppPageModule = AppPageModule> = {\n  boundaryComponent?: AppPageComponent | null;\n  layoutModules?: readonly (TModule | null | undefined)[] | null;\n  matchedParams: AppPageParams;\n  rootForbiddenModule?: TModule | null;\n  rootNotFoundModule?: TModule | null;\n  rootUnauthorizedModule?: TModule | null;\n  route?: AppPageBoundaryRoute<TModule> | null;\n  /**\n   * When true, the resolved boundary is rendered without wrapping it in the\n   * route's layouts. Used by `global-not-found.tsx`, which provides its own\n   * `<html>`/`<body>` and intentionally replaces the root layout.\n   * Mirrors Next.js's `createNotFoundLoaderTree` behavior for `hasGlobalNotFound`.\n   * @see https://github.com/vercel/next.js/blob/canary/packages/next/src/server/app-render/app-render.tsx#L495-L520\n   */\n  skipLayoutWrapping?: boolean;\n  statusCode: number;\n} & AppPageBoundaryRenderCommonOptions<TModule>;\n\ntype RenderAppPageErrorBoundaryOptions<TModule extends AppPageModule = AppPageModule> = {\n  error: unknown;\n  matchedParams?: AppPageParams | null;\n  route?: AppPageBoundaryRoute<TModule> | null;\n  sanitizeErrorForClient: (error: Error) => Error;\n} & AppPageBoundaryRenderCommonOptions<TModule>;\n\nfunction getDefaultExport<TModule extends AppPageModule>(\n  module: TModule | null | undefined,\n): AppPageComponent | null {\n  return module?.default ?? null;\n}\n\nfunction wrapRenderedBoundaryElement<TModule extends AppPageModule>(\n  options: Pick<\n    AppPageBoundaryRenderCommonOptions<TModule>,\n    \"globalErrorModule\" | \"isRscRequest\" | \"makeThenableParams\" | \"resolveChildSegments\"\n  > & {\n    element: ReactNode;\n    includeGlobalErrorBoundary: boolean;\n    layoutModules: readonly (TModule | null | undefined)[];\n    layoutTreePositions?: readonly number[] | null;\n    matchedParams: AppPageParams;\n    routeSegments?: readonly string[];\n    skipLayoutWrapping?: boolean;\n  },\n): ReactNode {\n  return wrapAppPageBoundaryElement({\n    element: options.element,\n    getDefaultExport,\n    globalErrorComponent: getDefaultExport(options.globalErrorModule),\n    includeGlobalErrorBoundary: options.includeGlobalErrorBoundary,\n    isRscRequest: options.isRscRequest,\n    layoutModules: options.layoutModules,\n    layoutTreePositions: options.layoutTreePositions,\n    makeThenableParams: options.makeThenableParams,\n    matchedParams: options.matchedParams,\n    renderErrorBoundary(GlobalErrorComponent, children) {\n      return createElement(ErrorBoundary, {\n        fallback: GlobalErrorComponent,\n        // oxlint-disable-next-line react/no-children-prop\n        children,\n      });\n    },\n    renderLayout(LayoutComponent, children, asyncParams) {\n      return createElement(LayoutComponent as AppPageComponent, {\n        // oxlint-disable-next-line react/no-children-prop\n        children,\n        params: asyncParams,\n      });\n    },\n    renderLayoutSegmentProvider(segmentMap, children) {\n      return createElement(\n        // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n        LayoutSegmentProvider as ComponentType<any>,\n        { segmentMap },\n        children,\n      );\n    },\n    resolveChildSegments: options.resolveChildSegments,\n    routeSegments: options.routeSegments ?? [],\n    skipLayoutWrapping: options.skipLayoutWrapping,\n  });\n}\n\nfunction createAppPageBoundaryLayoutEntries<TModule extends AppPageModule>(\n  route: AppPageBoundaryRoute<TModule> | null | undefined,\n  layoutModules: readonly (TModule | null | undefined)[],\n): readonly AppPageBoundaryLayoutEntry[] {\n  if (!route || layoutModules.length === 0) return [];\n\n  return createAppPageLayoutEntries({\n    errors: route.errors,\n    layoutTreePositions: route.layoutTreePositions,\n    layouts: layoutModules,\n    notFounds: null,\n    routeSegments: route.routeSegments,\n  });\n}\n\nfunction resolveHttpAccessFallbackHeadRouteSegments<TModule extends AppPageModule>(\n  route: AppPageBoundaryRoute<TModule> | null | undefined,\n  layoutModules: readonly (TModule | null | undefined)[],\n): readonly string[] | undefined {\n  if (!route?.routeSegments) {\n    return undefined;\n  }\n\n  if (!route.layouts || layoutModules.length >= route.layouts.length) {\n    return route.routeSegments;\n  }\n\n  const lastIncludedLayoutIndex = layoutModules.length - 1;\n  if (lastIncludedLayoutIndex < 0) {\n    return [];\n  }\n\n  const segmentCount = route.layoutTreePositions?.[lastIncludedLayoutIndex] ?? 0;\n  return route.routeSegments.slice(0, segmentCount);\n}\n\nfunction resolveHttpAccessFallbackHeadLayoutTreePositions<TModule extends AppPageModule>(\n  route: AppPageBoundaryRoute<TModule> | null | undefined,\n  layoutModules: readonly (TModule | null | undefined)[],\n): readonly number[] | null | undefined {\n  if (!route?.layouts || layoutModules.length >= route.layouts.length) {\n    return route?.layoutTreePositions;\n  }\n\n  return route.layoutTreePositions?.slice(0, layoutModules.length);\n}\n\nfunction createAppPageBoundaryRscPayload<TModule extends AppPageModule>(\n  options: AppPageBoundaryRscPayloadOptions<TModule>,\n): AppElements {\n  const routeId = AppElementsWire.encodeRouteId(options.pathname, null);\n  const layoutEntries = createAppPageBoundaryLayoutEntries(options.route, options.layoutModules);\n\n  return {\n    ...AppElementsWire.createMetadataEntries({\n      interceptionContext: null,\n      layoutIds: layoutEntries.map((entry) => entry.id),\n      rootLayoutTreePath: layoutEntries[0]?.treePath ?? null,\n      routeId,\n    }),\n    [routeId]: options.element,\n  };\n}\n\nasync function renderAppPageBoundaryElementResponse<TModule extends AppPageModule>(\n  options: AppPageBoundaryRenderCommonOptions<TModule> & {\n    element: ReactNode;\n    layoutModules: readonly (TModule | null | undefined)[];\n    route?: AppPageBoundaryRoute<TModule> | null;\n    routePattern?: string;\n    status: number;\n  },\n): Promise<Response> {\n  const pathname = new URL(options.requestUrl).pathname;\n  const payload = createAppPageBoundaryRscPayload({\n    element: options.element,\n    layoutModules: options.layoutModules,\n    pathname,\n    route: options.route,\n  });\n\n  return renderAppPageBoundaryResponse({\n    async createHtmlResponse(rscStream, responseStatus) {\n      const fontData = createAppPageFontData({\n        getLinks: options.getFontLinks,\n        getPreloads: options.getFontPreloads,\n        getStyles: options.getFontStyles,\n      });\n      const ssrHandler = await options.loadSsrHandler();\n      return renderAppPageHtmlResponse({\n        clearRequestContext: options.clearRequestContext,\n        fontData,\n        fontLinkHeader: options.buildFontLinkHeader(fontData.preloads),\n        middlewareHeaders: options.middlewareContext.headers,\n        navigationContext: options.getNavigationContext(),\n        rscStream,\n        scriptNonce: options.scriptNonce,\n        ssrHandler,\n        status: responseStatus,\n      });\n    },\n    createRscOnErrorHandler() {\n      return options.createRscOnErrorHandler(pathname, options.routePattern ?? pathname);\n    },\n    element: payload,\n    isRscRequest: options.isRscRequest,\n    middlewareHeaders: options.middlewareContext.headers,\n    renderToReadableStream: options.renderToReadableStream,\n    status: options.status,\n  });\n}\n\nexport async function renderAppPageHttpAccessFallback<TModule extends AppPageModule>(\n  options: RenderAppPageHttpAccessFallbackOptions<TModule>,\n): Promise<Response | null> {\n  const boundaryComponent =\n    options.boundaryComponent ??\n    resolveAppPageHttpAccessBoundaryComponent({\n      getDefaultExport,\n      rootForbiddenModule: options.rootForbiddenModule,\n      rootNotFoundModule: options.rootNotFoundModule,\n      rootUnauthorizedModule: options.rootUnauthorizedModule,\n      routeForbiddenModule: options.route?.forbidden,\n      routeNotFoundModule: options.route?.notFound,\n      routeUnauthorizedModule: options.route?.unauthorized,\n      statusCode: options.statusCode,\n    });\n  if (!boundaryComponent) {\n    return null;\n  }\n\n  const layoutModules = options.layoutModules ?? options.route?.layouts ?? options.rootLayouts;\n  const pathname = new URL(options.requestUrl).pathname;\n  const routeSegments = resolveHttpAccessFallbackHeadRouteSegments(options.route, layoutModules);\n  const { metadata, viewport } = await resolveAppPageHead({\n    basePath: options.basePath ?? \"\",\n    layoutModules,\n    layoutTreePositions: resolveHttpAccessFallbackHeadLayoutTreePositions(\n      options.route,\n      layoutModules,\n    ),\n    metadataRoutes: options.metadataRoutes,\n    params: options.matchedParams,\n    routePath: options.route?.pattern ?? pathname,\n    routeSegments,\n  });\n\n  const headElements: ReactNode[] = [\n    createElement(\"meta\", { charSet: \"utf-8\", key: \"charset\" }),\n    createElement(\"meta\", { content: \"noindex\", key: \"robots\", name: \"robots\" }),\n  ];\n  if (metadata) {\n    headElements.push(createElement(MetadataHead, { key: \"metadata\", metadata, pathname }));\n  }\n  headElements.push(createElement(ViewportHead, { key: \"viewport\", viewport }));\n\n  const skipLayoutWrapping = options.skipLayoutWrapping ?? false;\n  const element = wrapRenderedBoundaryElement({\n    element: createElement(Fragment, null, ...headElements, createElement(boundaryComponent)),\n    globalErrorModule: options.globalErrorModule,\n    includeGlobalErrorBoundary: true,\n    isRscRequest: options.isRscRequest,\n    layoutModules,\n    layoutTreePositions: options.route?.layoutTreePositions,\n    makeThenableParams: options.makeThenableParams,\n    matchedParams: options.matchedParams,\n    resolveChildSegments: options.resolveChildSegments,\n    routeSegments: options.route?.routeSegments,\n    skipLayoutWrapping,\n  });\n\n  return renderAppPageBoundaryElementResponse({\n    ...options,\n    // When global-not-found owns the document, no layouts should contribute to\n    // the RSC payload's layout entries either — otherwise the SSR pipeline\n    // would expect a root-layout tree path that doesn't exist in the markup.\n    element,\n    layoutModules: skipLayoutWrapping ? [] : layoutModules,\n    route: skipLayoutWrapping ? null : options.route,\n    routePattern: options.route?.pattern,\n    status: options.statusCode,\n  });\n}\n\nexport async function renderAppPageErrorBoundary<TModule extends AppPageModule>(\n  options: RenderAppPageErrorBoundaryOptions<TModule>,\n): Promise<Response | null> {\n  const errorBoundary = resolveAppPageErrorBoundary({\n    getDefaultExport,\n    errorModules: options.route?.errorPaths,\n    globalErrorModule: options.globalErrorModule,\n    layoutErrorModules: options.route?.errors,\n    pageErrorModule: options.route?.error,\n  });\n  if (!errorBoundary.component) {\n    return null;\n  }\n\n  const rawError =\n    options.error instanceof Error ? options.error : new Error(String(options.error));\n  rewriteClientHookError(rawError);\n  const errorObject = options.sanitizeErrorForClient(rawError);\n  const matchedParams = options.matchedParams ?? options.route?.params ?? {};\n  const layoutModules = options.route?.layouts ?? options.rootLayouts;\n  const pathname = new URL(options.requestUrl).pathname;\n\n  const headElements: ReactNode[] = [createElement(\"meta\", { charSet: \"utf-8\", key: \"charset\" })];\n  if (!errorBoundary.isGlobalError) {\n    try {\n      const { metadata, viewport } = await resolveAppPageHead({\n        basePath: options.basePath ?? \"\",\n        fallbackOnFileMetadataError: true,\n        layoutModules,\n        layoutTreePositions: options.route?.layoutTreePositions,\n        metadataRoutes: options.metadataRoutes,\n        params: matchedParams,\n        routePath: options.route?.pattern ?? pathname,\n        routeSegments: options.route?.routeSegments,\n      });\n      if (metadata) {\n        headElements.push(createElement(MetadataHead, { key: \"metadata\", metadata, pathname }));\n      }\n      headElements.push(createElement(ViewportHead, { key: \"viewport\", viewport }));\n    } catch (error) {\n      console.error(\n        `[vinext] App page error boundary head resolution failed for ${options.route?.pattern ?? pathname}:`,\n        error,\n      );\n    }\n  }\n\n  const element = wrapRenderedBoundaryElement({\n    element: createElement(\n      Fragment,\n      null,\n      ...headElements,\n      createElement(errorBoundary.component, {\n        error: errorObject,\n      }),\n    ),\n    globalErrorModule: options.globalErrorModule,\n    includeGlobalErrorBoundary: !errorBoundary.isGlobalError,\n    isRscRequest: options.isRscRequest,\n    layoutModules,\n    layoutTreePositions: options.route?.layoutTreePositions,\n    makeThenableParams: options.makeThenableParams,\n    matchedParams,\n    resolveChildSegments: options.resolveChildSegments,\n    routeSegments: options.route?.routeSegments,\n    skipLayoutWrapping: errorBoundary.isGlobalError,\n  });\n\n  return renderAppPageBoundaryElementResponse({\n    ...options,\n    element,\n    layoutModules,\n    route: options.route,\n    routePattern: options.route?.pattern,\n    status: 200,\n  });\n}\n\n// React client-only hooks that are absent from the `react-server` export\n// condition. When called in a Server Component they produce a TypeError like\n// \"useState is not a function\". Rewrite into an actionable message matching\n// the format used by the next/navigation shims (see client-hook-error.ts).\nconst _clientHookPattern =\n  /\\b(useState|useEffect|useReducer|useRef|useContext|useLayoutEffect|useInsertionEffect|useSyncExternalStore|useTransition|useImperativeHandle|useDeferredValue|useActionState|useOptimistic|useEffectEvent)\\b.*is not a function/;\n\nfunction rewriteClientHookError(error: Error): void {\n  const match = error.message.match(_clientHookPattern);\n  if (match) {\n    error.message = buildClientHookErrorMessage(`${match[1]}()`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAqHA,SAAS,iBACP,QACyB;CACzB,OAAO,QAAQ,WAAW;;AAG5B,SAAS,4BACP,SAYW;CACX,OAAO,2BAA2B;EAChC,SAAS,QAAQ;EACjB;EACA,sBAAsB,iBAAiB,QAAQ,kBAAkB;EACjE,4BAA4B,QAAQ;EACpC,cAAc,QAAQ;EACtB,eAAe,QAAQ;EACvB,qBAAqB,QAAQ;EAC7B,oBAAoB,QAAQ;EAC5B,eAAe,QAAQ;EACvB,oBAAoB,sBAAsB,UAAU;GAClD,OAAO,cAAc,eAAe;IAClC,UAAU;IAEV;IACD,CAAC;;EAEJ,aAAa,iBAAiB,UAAU,aAAa;GACnD,OAAO,cAAc,iBAAqC;IAExD;IACA,QAAQ;IACT,CAAC;;EAEJ,4BAA4B,YAAY,UAAU;GAChD,OAAO,cAEL,uBACA,EAAE,YAAY,EACd,SACD;;EAEH,sBAAsB,QAAQ;EAC9B,eAAe,QAAQ,iBAAiB,EAAE;EAC1C,oBAAoB,QAAQ;EAC7B,CAAC;;AAGJ,SAAS,mCACP,OACA,eACuC;CACvC,IAAI,CAAC,SAAS,cAAc,WAAW,GAAG,OAAO,EAAE;CAEnD,OAAO,2BAA2B;EAChC,QAAQ,MAAM;EACd,qBAAqB,MAAM;EAC3B,SAAS;EACT,WAAW;EACX,eAAe,MAAM;EACtB,CAAC;;AAGJ,SAAS,2CACP,OACA,eAC+B;CAC/B,IAAI,CAAC,OAAO,eACV;CAGF,IAAI,CAAC,MAAM,WAAW,cAAc,UAAU,MAAM,QAAQ,QAC1D,OAAO,MAAM;CAGf,MAAM,0BAA0B,cAAc,SAAS;CACvD,IAAI,0BAA0B,GAC5B,OAAO,EAAE;CAGX,MAAM,eAAe,MAAM,sBAAsB,4BAA4B;CAC7E,OAAO,MAAM,cAAc,MAAM,GAAG,aAAa;;AAGnD,SAAS,iDACP,OACA,eACsC;CACtC,IAAI,CAAC,OAAO,WAAW,cAAc,UAAU,MAAM,QAAQ,QAC3D,OAAO,OAAO;CAGhB,OAAO,MAAM,qBAAqB,MAAM,GAAG,cAAc,OAAO;;AAGlE,SAAS,gCACP,SACa;CACb,MAAM,UAAU,gBAAgB,cAAc,QAAQ,UAAU,KAAK;CACrE,MAAM,gBAAgB,mCAAmC,QAAQ,OAAO,QAAQ,cAAc;CAE9F,OAAO;EACL,GAAG,gBAAgB,sBAAsB;GACvC,qBAAqB;GACrB,WAAW,cAAc,KAAK,UAAU,MAAM,GAAG;GACjD,oBAAoB,cAAc,IAAI,YAAY;GAClD;GACD,CAAC;GACD,UAAU,QAAQ;EACpB;;AAGH,eAAe,qCACb,SAOmB;CACnB,MAAM,WAAW,IAAI,IAAI,QAAQ,WAAW,CAAC;CAQ7C,OAAO,8BAA8B;EACnC,MAAM,mBAAmB,WAAW,gBAAgB;GAClD,MAAM,WAAW,sBAAsB;IACrC,UAAU,QAAQ;IAClB,aAAa,QAAQ;IACrB,WAAW,QAAQ;IACpB,CAAC;GACF,MAAM,aAAa,MAAM,QAAQ,gBAAgB;GACjD,OAAO,0BAA0B;IAC/B,qBAAqB,QAAQ;IAC7B;IACA,gBAAgB,QAAQ,oBAAoB,SAAS,SAAS;IAC9D,mBAAmB,QAAQ,kBAAkB;IAC7C,mBAAmB,QAAQ,sBAAsB;IACjD;IACA,aAAa,QAAQ;IACrB;IACA,QAAQ;IACT,CAAC;;EAEJ,0BAA0B;GACxB,OAAO,QAAQ,wBAAwB,UAAU,QAAQ,gBAAgB,SAAS;;EAEpF,SA9Bc,gCAAgC;GAC9C,SAAS,QAAQ;GACjB,eAAe,QAAQ;GACvB;GACA,OAAO,QAAQ;GAChB,CAyBiB;EAChB,cAAc,QAAQ;EACtB,mBAAmB,QAAQ,kBAAkB;EAC7C,wBAAwB,QAAQ;EAChC,QAAQ,QAAQ;EACjB,CAAC;;AAGJ,eAAsB,gCACpB,SAC0B;CAC1B,MAAM,oBACJ,QAAQ,qBACR,0CAA0C;EACxC;EACA,qBAAqB,QAAQ;EAC7B,oBAAoB,QAAQ;EAC5B,wBAAwB,QAAQ;EAChC,sBAAsB,QAAQ,OAAO;EACrC,qBAAqB,QAAQ,OAAO;EACpC,yBAAyB,QAAQ,OAAO;EACxC,YAAY,QAAQ;EACrB,CAAC;CACJ,IAAI,CAAC,mBACH,OAAO;CAGT,MAAM,gBAAgB,QAAQ,iBAAiB,QAAQ,OAAO,WAAW,QAAQ;CACjF,MAAM,WAAW,IAAI,IAAI,QAAQ,WAAW,CAAC;CAC7C,MAAM,gBAAgB,2CAA2C,QAAQ,OAAO,cAAc;CAC9F,MAAM,EAAE,UAAU,aAAa,MAAM,mBAAmB;EACtD,UAAU,QAAQ,YAAY;EAC9B;EACA,qBAAqB,iDACnB,QAAQ,OACR,cACD;EACD,gBAAgB,QAAQ;EACxB,QAAQ,QAAQ;EAChB,WAAW,QAAQ,OAAO,WAAW;EACrC;EACD,CAAC;CAEF,MAAM,eAA4B,CAChC,cAAc,QAAQ;EAAE,SAAS;EAAS,KAAK;EAAW,CAAC,EAC3D,cAAc,QAAQ;EAAE,SAAS;EAAW,KAAK;EAAU,MAAM;EAAU,CAAC,CAC7E;CACD,IAAI,UACF,aAAa,KAAK,cAAc,cAAc;EAAE,KAAK;EAAY;EAAU;EAAU,CAAC,CAAC;CAEzF,aAAa,KAAK,cAAc,cAAc;EAAE,KAAK;EAAY;EAAU,CAAC,CAAC;CAE7E,MAAM,qBAAqB,QAAQ,sBAAsB;CACzD,MAAM,UAAU,4BAA4B;EAC1C,SAAS,cAAc,UAAU,MAAM,GAAG,cAAc,cAAc,kBAAkB,CAAC;EACzF,mBAAmB,QAAQ;EAC3B,4BAA4B;EAC5B,cAAc,QAAQ;EACtB;EACA,qBAAqB,QAAQ,OAAO;EACpC,oBAAoB,QAAQ;EAC5B,eAAe,QAAQ;EACvB,sBAAsB,QAAQ;EAC9B,eAAe,QAAQ,OAAO;EAC9B;EACD,CAAC;CAEF,OAAO,qCAAqC;EAC1C,GAAG;EAIH;EACA,eAAe,qBAAqB,EAAE,GAAG;EACzC,OAAO,qBAAqB,OAAO,QAAQ;EAC3C,cAAc,QAAQ,OAAO;EAC7B,QAAQ,QAAQ;EACjB,CAAC;;AAGJ,eAAsB,2BACpB,SAC0B;CAC1B,MAAM,gBAAgB,4BAA4B;EAChD;EACA,cAAc,QAAQ,OAAO;EAC7B,mBAAmB,QAAQ;EAC3B,oBAAoB,QAAQ,OAAO;EACnC,iBAAiB,QAAQ,OAAO;EACjC,CAAC;CACF,IAAI,CAAC,cAAc,WACjB,OAAO;CAGT,MAAM,WACJ,QAAQ,iBAAiB,QAAQ,QAAQ,QAAQ,IAAI,MAAM,OAAO,QAAQ,MAAM,CAAC;CACnF,uBAAuB,SAAS;CAChC,MAAM,cAAc,QAAQ,uBAAuB,SAAS;CAC5D,MAAM,gBAAgB,QAAQ,iBAAiB,QAAQ,OAAO,UAAU,EAAE;CAC1E,MAAM,gBAAgB,QAAQ,OAAO,WAAW,QAAQ;CACxD,MAAM,WAAW,IAAI,IAAI,QAAQ,WAAW,CAAC;CAE7C,MAAM,eAA4B,CAAC,cAAc,QAAQ;EAAE,SAAS;EAAS,KAAK;EAAW,CAAC,CAAC;CAC/F,IAAI,CAAC,cAAc,eACjB,IAAI;EACF,MAAM,EAAE,UAAU,aAAa,MAAM,mBAAmB;GACtD,UAAU,QAAQ,YAAY;GAC9B,6BAA6B;GAC7B;GACA,qBAAqB,QAAQ,OAAO;GACpC,gBAAgB,QAAQ;GACxB,QAAQ;GACR,WAAW,QAAQ,OAAO,WAAW;GACrC,eAAe,QAAQ,OAAO;GAC/B,CAAC;EACF,IAAI,UACF,aAAa,KAAK,cAAc,cAAc;GAAE,KAAK;GAAY;GAAU;GAAU,CAAC,CAAC;EAEzF,aAAa,KAAK,cAAc,cAAc;GAAE,KAAK;GAAY;GAAU,CAAC,CAAC;UACtE,OAAO;EACd,QAAQ,MACN,+DAA+D,QAAQ,OAAO,WAAW,SAAS,IAClG,MACD;;CAIL,MAAM,UAAU,4BAA4B;EAC1C,SAAS,cACP,UACA,MACA,GAAG,cACH,cAAc,cAAc,WAAW,EACrC,OAAO,aACR,CAAC,CACH;EACD,mBAAmB,QAAQ;EAC3B,4BAA4B,CAAC,cAAc;EAC3C,cAAc,QAAQ;EACtB;EACA,qBAAqB,QAAQ,OAAO;EACpC,oBAAoB,QAAQ;EAC5B;EACA,sBAAsB,QAAQ;EAC9B,eAAe,QAAQ,OAAO;EAC9B,oBAAoB,cAAc;EACnC,CAAC;CAEF,OAAO,qCAAqC;EAC1C,GAAG;EACH;EACA;EACA,OAAO,QAAQ;EACf,cAAc,QAAQ,OAAO;EAC7B,QAAQ;EACT,CAAC;;AAOJ,MAAM,qBACJ;AAEF,SAAS,uBAAuB,OAAoB;CAClD,MAAM,QAAQ,MAAM,QAAQ,MAAM,mBAAmB;CACrD,IAAI,OACF,MAAM,UAAU,4BAA4B,GAAG,MAAM,GAAG,IAAI"}

package/dist/server/app-page-boundary.js

@@ -1,5 +1,5 @@
 import { runWithFetchDedupe } from "../shims/fetch-cache.js";
-import { VINEXT_RSC_VARY_HEADER } from "./app-rsc-cache-busting.js";
+import { VINEXT_RSC_CONTENT_TYPE, VINEXT_RSC_VARY_HEADER, applyRscCompatibilityIdHeader } from "./app-rsc-cache-busting.js";
 import { resolveAppPageSegmentParams } from "./app-page-params.js";
 import { mergeMiddlewareResponseHeaders } from "./middleware-response-headers.js";
 //#region src/server/app-page-boundary.ts
@@ -66,10 +66,11 @@ async function renderAppPageBoundaryResponse(options) {
 	const rscStream = runWithFetchDedupe(() => options.renderToReadableStream(options.element, { onError: options.createRscOnErrorHandler() }));
 	if (options.isRscRequest) {
 		const headers = new Headers({
-			"Content-Type": "text/x-component; charset=utf-8",
+			"Content-Type": VINEXT_RSC_CONTENT_TYPE,
 			Vary: VINEXT_RSC_VARY_HEADER
 		});
 		mergeMiddlewareResponseHeaders(headers, options.middlewareHeaders ?? null);
+		applyRscCompatibilityIdHeader(headers);
 		return new Response(rscStream, {
 			status: options.status,
 			headers

package/dist/server/app-page-boundary.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-page-boundary.js","names":[],"sources":["../../src/server/app-page-boundary.ts"],"sourcesContent":["import { runWithFetchDedupe } from \"vinext/shims/fetch-cache\";\nimport { mergeMiddlewareResponseHeaders } from \"./middleware-response-headers.js\";\nimport { VINEXT_RSC_VARY_HEADER } from \"./app-rsc-cache-busting.js\";\nimport { resolveAppPageSegmentParams } from \"./app-page-params.js\";\n\nexport type AppPageParams = Record<string, string | string[]>;\n\ntype ResolveAppPageHttpAccessBoundaryComponentOptions<TModule, TComponent> = {\n  getDefaultExport: (module: TModule | null | undefined) => TComponent | null | undefined;\n  rootForbiddenModule?: TModule | null;\n  rootNotFoundModule?: TModule | null;\n  rootUnauthorizedModule?: TModule | null;\n  routeForbiddenModule?: TModule | null;\n  routeNotFoundModule?: TModule | null;\n  routeUnauthorizedModule?: TModule | null;\n  statusCode: number;\n};\n\ntype ResolveAppPageParentHttpAccessBoundaryModuleOptions<TModule> = {\n  layoutIndex: number;\n  rootForbiddenModule?: TModule | null;\n  rootNotFoundModule?: TModule | null;\n  rootUnauthorizedModule?: TModule | null;\n  routeForbiddenModules?: readonly (TModule | null | undefined)[] | null;\n  routeNotFoundModules?: readonly (TModule | null | undefined)[] | null;\n  routeUnauthorizedModules?: readonly (TModule | null | undefined)[] | null;\n  statusCode: number;\n};\n\ntype ResolveAppPageErrorBoundaryOptions<TModule, TComponent> = {\n  getDefaultExport: (module: TModule | null | undefined) => TComponent | null | undefined;\n  globalErrorModule?: TModule | null;\n  errorModules?: readonly (TModule | null | undefined)[] | null;\n  layoutErrorModules?: readonly (TModule | null | undefined)[] | null;\n  pageErrorModule?: TModule | null;\n};\n\ntype ResolveAppPageErrorBoundaryResult<TComponent> = {\n  component: TComponent | null;\n  isGlobalError: boolean;\n};\n\ntype WrapAppPageBoundaryElementOptions<\n  TElement,\n  TLayoutModule,\n  TLayoutComponent,\n  TChildSegments,\n  TGlobalErrorComponent,\n> = {\n  element: TElement;\n  getDefaultExport: (\n    module: TLayoutModule | null | undefined,\n  ) => TLayoutComponent | null | undefined;\n  globalErrorComponent?: TGlobalErrorComponent | null;\n  includeGlobalErrorBoundary: boolean;\n  isRscRequest: boolean;\n  layoutModules: readonly (TLayoutModule | null | undefined)[];\n  layoutTreePositions?: readonly number[] | null;\n  makeThenableParams: (params: AppPageParams) => unknown;\n  matchedParams: AppPageParams;\n  renderErrorBoundary: (component: TGlobalErrorComponent, children: TElement) => TElement;\n  renderLayout: (component: TLayoutComponent, children: TElement, params: unknown) => TElement;\n  renderLayoutSegmentProvider?: (\n    segmentMap: { children: TChildSegments },\n    children: TElement,\n  ) => TElement;\n  resolveChildSegments?: (\n    routeSegments: readonly string[],\n    treePosition: number,\n    params: AppPageParams,\n  ) => TChildSegments;\n  routeSegments?: readonly string[];\n  skipLayoutWrapping?: boolean;\n};\n\ntype AppPageBoundaryOnError = (\n  error: unknown,\n  requestInfo: unknown,\n  errorContext: unknown,\n) => unknown;\n\ntype RenderAppPageBoundaryResponseOptions<TElement> = {\n  createHtmlResponse: (rscStream: ReadableStream<Uint8Array>, status: number) => Promise<Response>;\n  createRscOnErrorHandler: () => AppPageBoundaryOnError;\n  element: TElement;\n  isRscRequest: boolean;\n  middlewareHeaders?: Headers | null;\n  renderToReadableStream: (\n    element: TElement,\n    options: { onError: AppPageBoundaryOnError },\n  ) => ReadableStream<Uint8Array>;\n  status: number;\n};\n\nexport function resolveAppPageHttpAccessBoundaryComponent<TModule, TComponent>(\n  options: ResolveAppPageHttpAccessBoundaryComponentOptions<TModule, TComponent>,\n): TComponent | null {\n  let boundaryModule: TModule | null | undefined;\n\n  if (options.statusCode === 403) {\n    boundaryModule = options.routeForbiddenModule ?? options.rootForbiddenModule;\n  } else if (options.statusCode === 401) {\n    boundaryModule = options.routeUnauthorizedModule ?? options.rootUnauthorizedModule;\n  } else {\n    boundaryModule = options.routeNotFoundModule ?? options.rootNotFoundModule;\n  }\n\n  return options.getDefaultExport(boundaryModule) ?? null;\n}\n\nexport function resolveAppPageParentHttpAccessBoundaryModule<TModule>(\n  options: ResolveAppPageParentHttpAccessBoundaryModuleOptions<TModule>,\n): TModule | null {\n  let routeModules = options.routeNotFoundModules;\n  let rootModule = options.rootNotFoundModule;\n\n  if (options.statusCode === 403) {\n    routeModules = options.routeForbiddenModules;\n    rootModule = options.rootForbiddenModule;\n  } else if (options.statusCode === 401) {\n    routeModules = options.routeUnauthorizedModules;\n    rootModule = options.rootUnauthorizedModule;\n  }\n\n  if (routeModules) {\n    for (let index = options.layoutIndex - 1; index >= 0; index--) {\n      const module = routeModules[index];\n      if (module) {\n        return module;\n      }\n    }\n  }\n\n  return rootModule ?? null;\n}\n\nexport function resolveAppPageErrorBoundary<TModule, TComponent>(\n  options: ResolveAppPageErrorBoundaryOptions<TModule, TComponent>,\n): ResolveAppPageErrorBoundaryResult<TComponent> {\n  const pageErrorComponent = options.getDefaultExport(options.pageErrorModule);\n  if (pageErrorComponent) {\n    return {\n      component: pageErrorComponent,\n      isGlobalError: false,\n    };\n  }\n\n  const segmentErrorModules = options.errorModules ?? options.layoutErrorModules;\n  if (segmentErrorModules) {\n    for (let index = segmentErrorModules.length - 1; index >= 0; index--) {\n      const segmentErrorComponent = options.getDefaultExport(segmentErrorModules[index]);\n      if (segmentErrorComponent) {\n        return {\n          component: segmentErrorComponent,\n          isGlobalError: false,\n        };\n      }\n    }\n  }\n\n  const globalErrorComponent = options.getDefaultExport(options.globalErrorModule);\n  return {\n    component: globalErrorComponent ?? null,\n    isGlobalError: Boolean(globalErrorComponent),\n  };\n}\n\nexport function wrapAppPageBoundaryElement<\n  TElement,\n  TLayoutModule,\n  TLayoutComponent,\n  TChildSegments,\n  TGlobalErrorComponent,\n>(\n  options: WrapAppPageBoundaryElementOptions<\n    TElement,\n    TLayoutModule,\n    TLayoutComponent,\n    TChildSegments,\n    TGlobalErrorComponent\n  >,\n): TElement {\n  let element = options.element;\n\n  if (!options.skipLayoutWrapping) {\n    for (let index = options.layoutModules.length - 1; index >= 0; index--) {\n      const layoutComponent = options.getDefaultExport(options.layoutModules[index]);\n      if (!layoutComponent) {\n        continue;\n      }\n\n      const treePosition = options.layoutTreePositions ? options.layoutTreePositions[index] : 0;\n      const asyncParams = options.makeThenableParams(\n        resolveAppPageSegmentParams(options.routeSegments, treePosition, options.matchedParams),\n      );\n      element = options.renderLayout(layoutComponent, element, asyncParams);\n\n      if (\n        options.isRscRequest &&\n        options.renderLayoutSegmentProvider &&\n        options.resolveChildSegments\n      ) {\n        const childSegments = options.resolveChildSegments(\n          options.routeSegments ?? [],\n          treePosition,\n          options.matchedParams,\n        );\n        element = options.renderLayoutSegmentProvider({ children: childSegments }, element);\n      }\n    }\n  }\n\n  if (options.isRscRequest && options.includeGlobalErrorBoundary && options.globalErrorComponent) {\n    element = options.renderErrorBoundary(options.globalErrorComponent, element);\n  }\n\n  return element;\n}\n\nexport async function renderAppPageBoundaryResponse<TElement>(\n  options: RenderAppPageBoundaryResponseOptions<TElement>,\n): Promise<Response> {\n  // Defensive wrap for standalone callers; idempotent under dispatchAppPage.\n  // The async stream consumption that follows relies on the surrounding\n  // runWithRequestContext to keep ALS state alive after this synchronous call\n  // returns. See app-page-render.ts for the same pattern.\n  const rscStream = runWithFetchDedupe(() =>\n    options.renderToReadableStream(options.element, {\n      onError: options.createRscOnErrorHandler(),\n    }),\n  );\n\n  if (options.isRscRequest) {\n    // Do NOT clear request-scoped context here. RSC responses are consumed lazily\n    // by the client, so headers()/cookies() and async server components still need\n    // their ALS-backed state while the stream is being read.\n    const headers = new Headers({\n      \"Content-Type\": \"text/x-component; charset=utf-8\",\n      Vary: VINEXT_RSC_VARY_HEADER,\n    });\n    mergeMiddlewareResponseHeaders(headers, options.middlewareHeaders ?? null);\n\n    return new Response(rscStream, {\n      status: options.status,\n      headers,\n    });\n  }\n\n  return options.createHtmlResponse(rscStream, options.status);\n}\n"],"mappings":";;;;;AA8FA,SAAgB,0CACd,SACmB;CACnB,IAAI;CAEJ,IAAI,QAAQ,eAAe,KACzB,iBAAiB,QAAQ,wBAAwB,QAAQ;MACpD,IAAI,QAAQ,eAAe,KAChC,iBAAiB,QAAQ,2BAA2B,QAAQ;MAE5D,iBAAiB,QAAQ,uBAAuB,QAAQ;CAG1D,OAAO,QAAQ,iBAAiB,eAAe,IAAI;;AAGrD,SAAgB,6CACd,SACgB;CAChB,IAAI,eAAe,QAAQ;CAC3B,IAAI,aAAa,QAAQ;CAEzB,IAAI,QAAQ,eAAe,KAAK;EAC9B,eAAe,QAAQ;EACvB,aAAa,QAAQ;QAChB,IAAI,QAAQ,eAAe,KAAK;EACrC,eAAe,QAAQ;EACvB,aAAa,QAAQ;;CAGvB,IAAI,cACF,KAAK,IAAI,QAAQ,QAAQ,cAAc,GAAG,SAAS,GAAG,SAAS;EAC7D,MAAM,SAAS,aAAa;EAC5B,IAAI,QACF,OAAO;;CAKb,OAAO,cAAc;;AAGvB,SAAgB,4BACd,SAC+C;CAC/C,MAAM,qBAAqB,QAAQ,iBAAiB,QAAQ,gBAAgB;CAC5E,IAAI,oBACF,OAAO;EACL,WAAW;EACX,eAAe;EAChB;CAGH,MAAM,sBAAsB,QAAQ,gBAAgB,QAAQ;CAC5D,IAAI,qBACF,KAAK,IAAI,QAAQ,oBAAoB,SAAS,GAAG,SAAS,GAAG,SAAS;EACpE,MAAM,wBAAwB,QAAQ,iBAAiB,oBAAoB,OAAO;EAClF,IAAI,uBACF,OAAO;GACL,WAAW;GACX,eAAe;GAChB;;CAKP,MAAM,uBAAuB,QAAQ,iBAAiB,QAAQ,kBAAkB;CAChF,OAAO;EACL,WAAW,wBAAwB;EACnC,eAAe,QAAQ,qBAAqB;EAC7C;;AAGH,SAAgB,2BAOd,SAOU;CACV,IAAI,UAAU,QAAQ;CAEtB,IAAI,CAAC,QAAQ,oBACX,KAAK,IAAI,QAAQ,QAAQ,cAAc,SAAS,GAAG,SAAS,GAAG,SAAS;EACtE,MAAM,kBAAkB,QAAQ,iBAAiB,QAAQ,cAAc,OAAO;EAC9E,IAAI,CAAC,iBACH;EAGF,MAAM,eAAe,QAAQ,sBAAsB,QAAQ,oBAAoB,SAAS;EACxF,MAAM,cAAc,QAAQ,mBAC1B,4BAA4B,QAAQ,eAAe,cAAc,QAAQ,cAAc,CACxF;EACD,UAAU,QAAQ,aAAa,iBAAiB,SAAS,YAAY;EAErE,IACE,QAAQ,gBACR,QAAQ,+BACR,QAAQ,sBACR;GACA,MAAM,gBAAgB,QAAQ,qBAC5B,QAAQ,iBAAiB,EAAE,EAC3B,cACA,QAAQ,cACT;GACD,UAAU,QAAQ,4BAA4B,EAAE,UAAU,eAAe,EAAE,QAAQ;;;CAKzF,IAAI,QAAQ,gBAAgB,QAAQ,8BAA8B,QAAQ,sBACxE,UAAU,QAAQ,oBAAoB,QAAQ,sBAAsB,QAAQ;CAG9E,OAAO;;AAGT,eAAsB,8BACpB,SACmB;CAKnB,MAAM,YAAY,yBAChB,QAAQ,uBAAuB,QAAQ,SAAS,EAC9C,SAAS,QAAQ,yBAAyB,EAC3C,CAAC,CACH;CAED,IAAI,QAAQ,cAAc;EAIxB,MAAM,UAAU,IAAI,QAAQ;GAC1B,gBAAgB;GAChB,MAAM;GACP,CAAC;EACF,+BAA+B,SAAS,QAAQ,qBAAqB,KAAK;EAE1E,OAAO,IAAI,SAAS,WAAW;GAC7B,QAAQ,QAAQ;GAChB;GACD,CAAC;;CAGJ,OAAO,QAAQ,mBAAmB,WAAW,QAAQ,OAAO"}
+{"version":3,"file":"app-page-boundary.js","names":[],"sources":["../../src/server/app-page-boundary.ts"],"sourcesContent":["import { runWithFetchDedupe } from \"vinext/shims/fetch-cache\";\nimport { mergeMiddlewareResponseHeaders } from \"./middleware-response-headers.js\";\nimport {\n  VINEXT_RSC_CONTENT_TYPE,\n  VINEXT_RSC_VARY_HEADER,\n  applyRscCompatibilityIdHeader,\n} from \"./app-rsc-cache-busting.js\";\nimport { resolveAppPageSegmentParams } from \"./app-page-params.js\";\n\nexport type AppPageParams = Record<string, string | string[]>;\n\ntype ResolveAppPageHttpAccessBoundaryComponentOptions<TModule, TComponent> = {\n  getDefaultExport: (module: TModule | null | undefined) => TComponent | null | undefined;\n  rootForbiddenModule?: TModule | null;\n  rootNotFoundModule?: TModule | null;\n  rootUnauthorizedModule?: TModule | null;\n  routeForbiddenModule?: TModule | null;\n  routeNotFoundModule?: TModule | null;\n  routeUnauthorizedModule?: TModule | null;\n  statusCode: number;\n};\n\ntype ResolveAppPageParentHttpAccessBoundaryModuleOptions<TModule> = {\n  layoutIndex: number;\n  rootForbiddenModule?: TModule | null;\n  rootNotFoundModule?: TModule | null;\n  rootUnauthorizedModule?: TModule | null;\n  routeForbiddenModules?: readonly (TModule | null | undefined)[] | null;\n  routeNotFoundModules?: readonly (TModule | null | undefined)[] | null;\n  routeUnauthorizedModules?: readonly (TModule | null | undefined)[] | null;\n  statusCode: number;\n};\n\ntype ResolveAppPageErrorBoundaryOptions<TModule, TComponent> = {\n  getDefaultExport: (module: TModule | null | undefined) => TComponent | null | undefined;\n  globalErrorModule?: TModule | null;\n  errorModules?: readonly (TModule | null | undefined)[] | null;\n  layoutErrorModules?: readonly (TModule | null | undefined)[] | null;\n  pageErrorModule?: TModule | null;\n};\n\ntype ResolveAppPageErrorBoundaryResult<TComponent> = {\n  component: TComponent | null;\n  isGlobalError: boolean;\n};\n\ntype WrapAppPageBoundaryElementOptions<\n  TElement,\n  TLayoutModule,\n  TLayoutComponent,\n  TChildSegments,\n  TGlobalErrorComponent,\n> = {\n  element: TElement;\n  getDefaultExport: (\n    module: TLayoutModule | null | undefined,\n  ) => TLayoutComponent | null | undefined;\n  globalErrorComponent?: TGlobalErrorComponent | null;\n  includeGlobalErrorBoundary: boolean;\n  isRscRequest: boolean;\n  layoutModules: readonly (TLayoutModule | null | undefined)[];\n  layoutTreePositions?: readonly number[] | null;\n  makeThenableParams: (params: AppPageParams) => unknown;\n  matchedParams: AppPageParams;\n  renderErrorBoundary: (component: TGlobalErrorComponent, children: TElement) => TElement;\n  renderLayout: (component: TLayoutComponent, children: TElement, params: unknown) => TElement;\n  renderLayoutSegmentProvider?: (\n    segmentMap: { children: TChildSegments },\n    children: TElement,\n  ) => TElement;\n  resolveChildSegments?: (\n    routeSegments: readonly string[],\n    treePosition: number,\n    params: AppPageParams,\n  ) => TChildSegments;\n  routeSegments?: readonly string[];\n  skipLayoutWrapping?: boolean;\n};\n\ntype AppPageBoundaryOnError = (\n  error: unknown,\n  requestInfo: unknown,\n  errorContext: unknown,\n) => unknown;\n\ntype RenderAppPageBoundaryResponseOptions<TElement> = {\n  createHtmlResponse: (rscStream: ReadableStream<Uint8Array>, status: number) => Promise<Response>;\n  createRscOnErrorHandler: () => AppPageBoundaryOnError;\n  element: TElement;\n  isRscRequest: boolean;\n  middlewareHeaders?: Headers | null;\n  renderToReadableStream: (\n    element: TElement,\n    options: { onError: AppPageBoundaryOnError },\n  ) => ReadableStream<Uint8Array>;\n  status: number;\n};\n\nexport function resolveAppPageHttpAccessBoundaryComponent<TModule, TComponent>(\n  options: ResolveAppPageHttpAccessBoundaryComponentOptions<TModule, TComponent>,\n): TComponent | null {\n  let boundaryModule: TModule | null | undefined;\n\n  if (options.statusCode === 403) {\n    boundaryModule = options.routeForbiddenModule ?? options.rootForbiddenModule;\n  } else if (options.statusCode === 401) {\n    boundaryModule = options.routeUnauthorizedModule ?? options.rootUnauthorizedModule;\n  } else {\n    boundaryModule = options.routeNotFoundModule ?? options.rootNotFoundModule;\n  }\n\n  return options.getDefaultExport(boundaryModule) ?? null;\n}\n\nexport function resolveAppPageParentHttpAccessBoundaryModule<TModule>(\n  options: ResolveAppPageParentHttpAccessBoundaryModuleOptions<TModule>,\n): TModule | null {\n  let routeModules = options.routeNotFoundModules;\n  let rootModule = options.rootNotFoundModule;\n\n  if (options.statusCode === 403) {\n    routeModules = options.routeForbiddenModules;\n    rootModule = options.rootForbiddenModule;\n  } else if (options.statusCode === 401) {\n    routeModules = options.routeUnauthorizedModules;\n    rootModule = options.rootUnauthorizedModule;\n  }\n\n  if (routeModules) {\n    for (let index = options.layoutIndex - 1; index >= 0; index--) {\n      const module = routeModules[index];\n      if (module) {\n        return module;\n      }\n    }\n  }\n\n  return rootModule ?? null;\n}\n\nexport function resolveAppPageErrorBoundary<TModule, TComponent>(\n  options: ResolveAppPageErrorBoundaryOptions<TModule, TComponent>,\n): ResolveAppPageErrorBoundaryResult<TComponent> {\n  const pageErrorComponent = options.getDefaultExport(options.pageErrorModule);\n  if (pageErrorComponent) {\n    return {\n      component: pageErrorComponent,\n      isGlobalError: false,\n    };\n  }\n\n  const segmentErrorModules = options.errorModules ?? options.layoutErrorModules;\n  if (segmentErrorModules) {\n    for (let index = segmentErrorModules.length - 1; index >= 0; index--) {\n      const segmentErrorComponent = options.getDefaultExport(segmentErrorModules[index]);\n      if (segmentErrorComponent) {\n        return {\n          component: segmentErrorComponent,\n          isGlobalError: false,\n        };\n      }\n    }\n  }\n\n  const globalErrorComponent = options.getDefaultExport(options.globalErrorModule);\n  return {\n    component: globalErrorComponent ?? null,\n    isGlobalError: Boolean(globalErrorComponent),\n  };\n}\n\nexport function wrapAppPageBoundaryElement<\n  TElement,\n  TLayoutModule,\n  TLayoutComponent,\n  TChildSegments,\n  TGlobalErrorComponent,\n>(\n  options: WrapAppPageBoundaryElementOptions<\n    TElement,\n    TLayoutModule,\n    TLayoutComponent,\n    TChildSegments,\n    TGlobalErrorComponent\n  >,\n): TElement {\n  let element = options.element;\n\n  if (!options.skipLayoutWrapping) {\n    for (let index = options.layoutModules.length - 1; index >= 0; index--) {\n      const layoutComponent = options.getDefaultExport(options.layoutModules[index]);\n      if (!layoutComponent) {\n        continue;\n      }\n\n      const treePosition = options.layoutTreePositions ? options.layoutTreePositions[index] : 0;\n      const asyncParams = options.makeThenableParams(\n        resolveAppPageSegmentParams(options.routeSegments, treePosition, options.matchedParams),\n      );\n      element = options.renderLayout(layoutComponent, element, asyncParams);\n\n      if (\n        options.isRscRequest &&\n        options.renderLayoutSegmentProvider &&\n        options.resolveChildSegments\n      ) {\n        const childSegments = options.resolveChildSegments(\n          options.routeSegments ?? [],\n          treePosition,\n          options.matchedParams,\n        );\n        element = options.renderLayoutSegmentProvider({ children: childSegments }, element);\n      }\n    }\n  }\n\n  if (options.isRscRequest && options.includeGlobalErrorBoundary && options.globalErrorComponent) {\n    element = options.renderErrorBoundary(options.globalErrorComponent, element);\n  }\n\n  return element;\n}\n\nexport async function renderAppPageBoundaryResponse<TElement>(\n  options: RenderAppPageBoundaryResponseOptions<TElement>,\n): Promise<Response> {\n  // Defensive wrap for standalone callers; idempotent under dispatchAppPage.\n  // The async stream consumption that follows relies on the surrounding\n  // runWithRequestContext to keep ALS state alive after this synchronous call\n  // returns. See app-page-render.ts for the same pattern.\n  const rscStream = runWithFetchDedupe(() =>\n    options.renderToReadableStream(options.element, {\n      onError: options.createRscOnErrorHandler(),\n    }),\n  );\n\n  if (options.isRscRequest) {\n    // Do NOT clear request-scoped context here. RSC responses are consumed lazily\n    // by the client, so headers()/cookies() and async server components still need\n    // their ALS-backed state while the stream is being read.\n    const headers = new Headers({\n      \"Content-Type\": VINEXT_RSC_CONTENT_TYPE,\n      Vary: VINEXT_RSC_VARY_HEADER,\n    });\n    mergeMiddlewareResponseHeaders(headers, options.middlewareHeaders ?? null);\n    applyRscCompatibilityIdHeader(headers);\n\n    return new Response(rscStream, {\n      status: options.status,\n      headers,\n    });\n  }\n\n  return options.createHtmlResponse(rscStream, options.status);\n}\n"],"mappings":";;;;;AAkGA,SAAgB,0CACd,SACmB;CACnB,IAAI;CAEJ,IAAI,QAAQ,eAAe,KACzB,iBAAiB,QAAQ,wBAAwB,QAAQ;MACpD,IAAI,QAAQ,eAAe,KAChC,iBAAiB,QAAQ,2BAA2B,QAAQ;MAE5D,iBAAiB,QAAQ,uBAAuB,QAAQ;CAG1D,OAAO,QAAQ,iBAAiB,eAAe,IAAI;;AAGrD,SAAgB,6CACd,SACgB;CAChB,IAAI,eAAe,QAAQ;CAC3B,IAAI,aAAa,QAAQ;CAEzB,IAAI,QAAQ,eAAe,KAAK;EAC9B,eAAe,QAAQ;EACvB,aAAa,QAAQ;QAChB,IAAI,QAAQ,eAAe,KAAK;EACrC,eAAe,QAAQ;EACvB,aAAa,QAAQ;;CAGvB,IAAI,cACF,KAAK,IAAI,QAAQ,QAAQ,cAAc,GAAG,SAAS,GAAG,SAAS;EAC7D,MAAM,SAAS,aAAa;EAC5B,IAAI,QACF,OAAO;;CAKb,OAAO,cAAc;;AAGvB,SAAgB,4BACd,SAC+C;CAC/C,MAAM,qBAAqB,QAAQ,iBAAiB,QAAQ,gBAAgB;CAC5E,IAAI,oBACF,OAAO;EACL,WAAW;EACX,eAAe;EAChB;CAGH,MAAM,sBAAsB,QAAQ,gBAAgB,QAAQ;CAC5D,IAAI,qBACF,KAAK,IAAI,QAAQ,oBAAoB,SAAS,GAAG,SAAS,GAAG,SAAS;EACpE,MAAM,wBAAwB,QAAQ,iBAAiB,oBAAoB,OAAO;EAClF,IAAI,uBACF,OAAO;GACL,WAAW;GACX,eAAe;GAChB;;CAKP,MAAM,uBAAuB,QAAQ,iBAAiB,QAAQ,kBAAkB;CAChF,OAAO;EACL,WAAW,wBAAwB;EACnC,eAAe,QAAQ,qBAAqB;EAC7C;;AAGH,SAAgB,2BAOd,SAOU;CACV,IAAI,UAAU,QAAQ;CAEtB,IAAI,CAAC,QAAQ,oBACX,KAAK,IAAI,QAAQ,QAAQ,cAAc,SAAS,GAAG,SAAS,GAAG,SAAS;EACtE,MAAM,kBAAkB,QAAQ,iBAAiB,QAAQ,cAAc,OAAO;EAC9E,IAAI,CAAC,iBACH;EAGF,MAAM,eAAe,QAAQ,sBAAsB,QAAQ,oBAAoB,SAAS;EACxF,MAAM,cAAc,QAAQ,mBAC1B,4BAA4B,QAAQ,eAAe,cAAc,QAAQ,cAAc,CACxF;EACD,UAAU,QAAQ,aAAa,iBAAiB,SAAS,YAAY;EAErE,IACE,QAAQ,gBACR,QAAQ,+BACR,QAAQ,sBACR;GACA,MAAM,gBAAgB,QAAQ,qBAC5B,QAAQ,iBAAiB,EAAE,EAC3B,cACA,QAAQ,cACT;GACD,UAAU,QAAQ,4BAA4B,EAAE,UAAU,eAAe,EAAE,QAAQ;;;CAKzF,IAAI,QAAQ,gBAAgB,QAAQ,8BAA8B,QAAQ,sBACxE,UAAU,QAAQ,oBAAoB,QAAQ,sBAAsB,QAAQ;CAG9E,OAAO;;AAGT,eAAsB,8BACpB,SACmB;CAKnB,MAAM,YAAY,yBAChB,QAAQ,uBAAuB,QAAQ,SAAS,EAC9C,SAAS,QAAQ,yBAAyB,EAC3C,CAAC,CACH;CAED,IAAI,QAAQ,cAAc;EAIxB,MAAM,UAAU,IAAI,QAAQ;GAC1B,gBAAgB;GAChB,MAAM;GACP,CAAC;EACF,+BAA+B,SAAS,QAAQ,qBAAqB,KAAK;EAC1E,8BAA8B,QAAQ;EAEtC,OAAO,IAAI,SAAS,WAAW;GAC7B,QAAQ,QAAQ;GAChB;GACD,CAAC;;CAGJ,OAAO,QAAQ,mBAAmB,WAAW,QAAQ,OAAO"}

package/dist/server/app-page-cache.d.ts

@@ -1,6 +1,8 @@
+import { RenderObservation } from "./cache-proof.js";
 import { CacheControlMetadata, CachedAppPageValue } from "../shims/cache.js";
 import { AppRscRenderMode } from "./app-rsc-render-mode.js";
 import { ISRCacheEntry } from "./isr-cache.js";
+import { AppPageRenderObservationState } from "./app-page-render-observation.js";
 
 //#region src/server/app-page-cache.d.ts
 type AppPageDebugLogger = (event: string, detail: string) => void;
@@ -11,10 +13,27 @@ type AppPageRequestCacheLife = {
   revalidate?: number;
   expire?: number;
 };
+type AppPageCacheOutcomeMetric = Readonly<{
+  artifact: "html" | "rsc";
+  /**
+   * Internal cache lookup key for debugging and tests. Runtime telemetry sinks should hash or
+   * redact this value before export to avoid high-cardinality or user-derived labels.
+   */
+  cacheKey: string;
+  outcome: "hit" | "miss" | "stale";
+  reason: "empty-entry" | "no-entry" | "non-app-page-entry" | "read-error" | "served" | "stale-empty-entry";
+}>;
+type AppPageCacheOutcomeRecorder = (metric: AppPageCacheOutcomeMetric) => void;
+type BuildAppPageCacheRenderObservation = (input: {
+  cacheTags: readonly string[];
+  state: AppPageRenderObservationState;
+}) => RenderObservation;
 type AppPageCacheRenderResult = {
   cacheControl?: CacheControlMetadata;
   html: string;
+  htmlRenderObservation?: RenderObservation;
   rscData: ArrayBuffer;
+  rscRenderObservation?: RenderObservation;
   tags: string[];
 };
 type BuildAppPageCachedResponseOptions = {
@@ -39,6 +58,7 @@ type ReadAppPageCacheResponseOptions = {
   middlewareHeaders?: Headers | null;
   middlewareStatus?: number | null;
   mountedSlotsHeader?: string | null;
+  recordCacheOutcome?: AppPageCacheOutcomeRecorder;
   renderMode?: AppRscRenderMode;
   expireSeconds?: number;
   revalidateSeconds: number;
@@ -50,6 +70,9 @@ type FinalizeAppPageHtmlCacheResponseOptions = {
   capturedRscDataPromise: Promise<ArrayBuffer> | null;
   cleanPathname: string;
   consumeDynamicUsage: () => boolean;
+  consumeRenderObservationState?: () => AppPageRenderObservationState;
+  createHtmlRenderObservation?: BuildAppPageCacheRenderObservation;
+  createRscRenderObservation?: BuildAppPageCacheRenderObservation;
   getPageTags: () => string[];
   getRequestCacheLife?: () => AppPageRequestCacheLife | null;
   isrDebug?: AppPageDebugLogger;
@@ -65,6 +88,8 @@ type ScheduleAppPageRscCacheWriteOptions = {
   capturedRscDataPromise: Promise<ArrayBuffer> | null;
   cleanPathname: string;
   consumeDynamicUsage: () => boolean;
+  consumeRenderObservationState?: () => AppPageRenderObservationState;
+  createRscRenderObservation?: BuildAppPageCacheRenderObservation;
   dynamicUsedDuringBuild: boolean;
   getPageTags: () => string[];
   getRequestCacheLife?: () => AppPageRequestCacheLife | null;
@@ -85,5 +110,5 @@ declare function finalizeAppPageHtmlCacheResponse(response: Response, options: F
 declare function finalizeAppPageRscCacheResponse(response: Response, options: ScheduleAppPageRscCacheWriteOptions): Response;
 declare function scheduleAppPageRscCacheWrite(options: ScheduleAppPageRscCacheWriteOptions): boolean;
 //#endregion
-export { buildAppPageCacheTags, buildAppPageCachedResponse, finalizeAppPageHtmlCacheResponse, finalizeAppPageRscCacheResponse, readAppPageCacheResponse, scheduleAppPageRscCacheWrite };
+export { AppPageCacheOutcomeMetric, buildAppPageCacheTags, buildAppPageCachedResponse, finalizeAppPageHtmlCacheResponse, finalizeAppPageRscCacheResponse, readAppPageCacheResponse, scheduleAppPageRscCacheWrite };
 //# sourceMappingURL=app-page-cache.d.ts.map