vinext 1.0.0-beta.9 → 1.0.0

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

@@ -12,7 +12,7 @@ type RscEmbedTransformOptions = {
 };
 type HtmlInsertion = string | (() => string);
 type InlineCssManifest = Record<string, string>;
-type InitialNavigationCacheMetadata = {
+export type InitialNavigationCacheMetadata = {
   kind: "dynamic" | "static";
   dynamicStaleTimeSeconds?: number;
   /**
@@ -21,23 +21,28 @@ type InitialNavigationCacheMetadata = {
    */
   staleTimeSeconds?: number;
 };
-declare function waitAtLeastOneReactRenderTask(): Promise<void>;
-declare function navigationRuntimeRscBootstrapExpression(): string;
-declare function createNavigationRuntimeRscMetadataScript(params: Record<string, string | string[]>, nav: {
+export declare function waitAtLeastOneReactRenderTask(): Promise<void>;
+export declare function navigationRuntimeRscBootstrapExpression(): string;
+export declare function createNavigationRuntimeRscMetadataScript(params: Record<string, string | string[]>, nav: {
   pathname: string;
   searchParams: [string, string][];
 }, dynamicStaleTimeSeconds?: number, searchParamsFromBrowser?: boolean): string;
+/**
+ * The query a client page read during SSR, for a render that turned dynamic
+ * after its head told the browser to read the query from its own URL.
+ */
+export declare function createNavigationRuntimeRenderedSearchScript(search: string): string;
 /**
  * Create a helper that progressively embeds RSC chunks as inline <script> tags.
  * The browser entry turns the embedded chunks back into Uint8Array data.
  */
-declare function createRscEmbedTransform(embedStream: ReadableStream<Uint8Array>, optionsOrNonce?: RscEmbedTransformOptions | string): RscEmbedTransform;
+export declare function createRscEmbedTransform(embedStream: ReadableStream<Uint8Array>, optionsOrNonce?: RscEmbedTransformOptions | string): RscEmbedTransform;
 /**
  * Fix invalid preload "as" values in server-rendered HTML.
  * React Fizz emits <link rel="preload" as="stylesheet"> for CSS, but the
  * HTML spec requires as="style" for <link rel="preload">.
  */
-declare function fixPreloadAs(html: string): string;
+export declare function fixPreloadAs(html: string): string;
 /**
  * Create the tick-buffered HTML transform that injects RSC scripts between
  * React Fizz flush cycles without corrupting split HTML chunks.
@@ -65,6 +70,5 @@ declare function fixPreloadAs(html: string): string;
  *    to no-op and let the user-rendered Script (in its source-order
  *    position) ship as-is.
  */
-declare function createTickBufferedTransform(rscEmbed: RscEmbedTransform, injectHTML?: HtmlInsertion, injectAfterHeadOpenHTML?: HtmlInsertion, inlineCssManifest?: InlineCssManifest, inlineCssPrependCss?: string, inlineCssPrependFallbackHTML?: string, inlineCssScriptNonce?: string): TransformStream<Uint8Array, Uint8Array>;
-//#endregion
-export { InitialNavigationCacheMetadata, createNavigationRuntimeRscMetadataScript, createRscEmbedTransform, createTickBufferedTransform, fixPreloadAs, navigationRuntimeRscBootstrapExpression, waitAtLeastOneReactRenderTask };
+export declare function createTickBufferedTransform(rscEmbed: RscEmbedTransform, injectHTML?: HtmlInsertion, injectAfterHeadOpenHTML?: HtmlInsertion, inlineCssManifest?: InlineCssManifest, inlineCssPrependCss?: string, inlineCssPrependFallbackHTML?: string, inlineCssScriptNonce?: string): TransformStream<Uint8Array, Uint8Array>;
+//#endregion

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

@@ -2,6 +2,7 @@ import { createInlineScriptTag, escapeHtmlAttr, htmlTokenListContains, safeJsonS
 import { bytesToBase64, concatUint8Arrays } from "./app-rsc-embedded-chunks.js";
 import { NAVIGATION_RUNTIME_SYMBOL_DESCRIPTION } from "../client/navigation-runtime.js";
 //#region src/server/app-ssr-stream.ts
+const RSC_EMBED_TEXT_BATCH_MAX_LENGTH = 65536;
 function waitAtLeastOneReactRenderTask() {
 	return new Promise((resolve) => setTimeout(resolve, 0));
 }
@@ -12,6 +13,13 @@ function navigationRuntimeRscBootstrapExpression() {
 function createNavigationRuntimeRscMetadataScript(params, nav, dynamicStaleTimeSeconds, searchParamsFromBrowser) {
 	return "Object.assign(" + navigationRuntimeRscBootstrapExpression() + ",{params:" + safeJsonStringify(params) + ",nav:" + safeJsonStringify(nav) + (searchParamsFromBrowser === void 0 ? "" : ",searchParamsFromBrowser:" + safeJsonStringify(searchParamsFromBrowser)) + (dynamicStaleTimeSeconds === void 0 ? "" : ",dynamicStaleTimeSeconds:" + safeJsonStringify(dynamicStaleTimeSeconds)) + "})";
 }
+/**
+* The query a client page read during SSR, for a render that turned dynamic
+* after its head told the browser to read the query from its own URL.
+*/
+function createNavigationRuntimeRenderedSearchScript(search) {
+	return "Object.assign(" + navigationRuntimeRscBootstrapExpression() + ",{renderedSearch:" + safeJsonStringify(search) + "})";
+}
 function createNavigationRuntimeRscChunkScript(chunk) {
 	return navigationRuntimeRscBootstrapExpression() + ".rsc.push(" + safeJsonStringify(chunk) + ")";
 }
@@ -43,6 +51,10 @@ function createRscEmbedTransform(embedStream, optionsOrNonce = {}) {
 	const rawChunks = [];
 	let reading = false;
 	let mirroredNextFlightBootstrap = false;
+	const textDecoder = new TextDecoder("utf-8", {
+		fatal: true,
+		ignoreBOM: true
+	});
 	async function pumpReader() {
 		if (reading) return;
 		reading = true;
@@ -52,11 +64,7 @@ function createRscEmbedTransform(embedStream, optionsOrNonce = {}) {
 				if (result.done) break;
 				rawChunks.push(result.value);
 				try {
-					const text = new TextDecoder("utf-8", {
-						fatal: true,
-						ignoreBOM: true
-					}).decode(result.value);
-					pendingChunks.push(text);
+					pendingChunks.push(textDecoder.decode(result.value));
 				} catch {
 					pendingChunks.push([3, bytesToBase64(result.value)]);
 				}
@@ -74,8 +82,26 @@ function createRscEmbedTransform(embedStream, optionsOrNonce = {}) {
 			if (pendingChunks.length === 0) return "";
 			const chunks = pendingChunks;
 			pendingChunks = [];
+			const embeddedChunks = [];
+			let textChunks = [];
+			let textLength = 0;
+			const flushTextChunks = () => {
+				if (textChunks.length === 0) return;
+				embeddedChunks.push(textChunks.join(""));
+				textChunks = [];
+				textLength = 0;
+			};
+			for (const chunk of chunks) if (typeof chunk === "string") {
+				if (textLength > 0 && textLength + chunk.length > RSC_EMBED_TEXT_BATCH_MAX_LENGTH) flushTextChunks();
+				textChunks.push(chunk);
+				textLength += chunk.length;
+			} else {
+				flushTextChunks();
+				embeddedChunks.push(chunk);
+			}
+			flushTextChunks();
 			let scripts = "";
-			for (const chunk of chunks) {
+			for (const chunk of embeddedChunks) {
 				scripts += createInlineScriptTag(createNavigationRuntimeRscChunkScript(chunk), options.scriptNonce);
 				if (options.mirrorNextFlight) {
 					if (!mirroredNextFlightBootstrap) {
@@ -429,4 +455,4 @@ function createTickBufferedTransform(rscEmbed, injectHTML = "", injectAfterHeadO
 	});
 }
 //#endregion
-export { createNavigationRuntimeRscMetadataScript, createRscEmbedTransform, createTickBufferedTransform, fixPreloadAs, navigationRuntimeRscBootstrapExpression, waitAtLeastOneReactRenderTask };
+export { createNavigationRuntimeRenderedSearchScript, createNavigationRuntimeRscMetadataScript, createRscEmbedTransform, createTickBufferedTransform, fixPreloadAs, navigationRuntimeRscBootstrapExpression, waitAtLeastOneReactRenderTask };

package/dist/server/app-static-generation.d.ts

@@ -8,8 +8,7 @@ type CreateStaticGenerationHeadersContextOptions = {
   routeKind: AppStaticGenerationRouteKind;
   routePattern?: string;
 };
-declare function getAppPageStaticGenerationErrorMessage(): string;
-declare function getAppRouteStaticGenerationErrorMessage(routePattern?: string, expression?: string): string;
-declare function createStaticGenerationHeadersContext(options: CreateStaticGenerationHeadersContextOptions): HeadersContext;
-//#endregion
-export { createStaticGenerationHeadersContext, getAppPageStaticGenerationErrorMessage, getAppRouteStaticGenerationErrorMessage };
+export declare function getAppPageStaticGenerationErrorMessage(): string;
+export declare function getAppRouteStaticGenerationErrorMessage(routePattern?: string, expression?: string): string;
+export declare function createStaticGenerationHeadersContext(options: CreateStaticGenerationHeadersContextOptions): HeadersContext;
+//#endregion

package/dist/server/app-visited-response-cache.d.ts

@@ -3,7 +3,7 @@ import "./app-elements.js";
 import { CachedRscResponse } from "../shims/navigation.js";
 //#region src/server/app-visited-response-cache.d.ts
 type VisitedResponseCacheNavigationKind = "navigate" | "refresh" | "traverse";
-type VisitedResponseCacheEntry = {
+export type VisitedResponseCacheEntry = {
   createdAt: number;
   elements?: AppElements;
   expiresAt: number;
@@ -12,10 +12,10 @@ type VisitedResponseCacheEntry = {
   response: CachedRscResponse;
   reuseAfterHistoryRestore: boolean;
 };
-declare const VISITED_RESPONSE_CACHE_TTL: number;
-declare const MAX_TRAVERSAL_CACHE_TTL: number;
-declare function hasNavigationResponseHistoryLifetime(snapshot: CachedRscResponse): boolean;
-declare function createVisitedResponseCacheEntry(options: {
+export declare const VISITED_RESPONSE_CACHE_TTL: number;
+export declare const MAX_TRAVERSAL_CACHE_TTL: number;
+export declare function hasNavigationResponseHistoryLifetime(snapshot: CachedRscResponse): boolean;
+export declare function createVisitedResponseCacheEntry(options: {
   elements?: AppElements;
   fallbackTtlMs?: number;
   now: number;
@@ -24,16 +24,15 @@ declare function createVisitedResponseCacheEntry(options: {
   response: CachedRscResponse;
   reuseAfterHistoryRestore?: boolean;
 }): VisitedResponseCacheEntry;
-declare function isVisitedResponseCacheEntryFresh(entry: VisitedResponseCacheEntry, options: {
+export declare function isVisitedResponseCacheEntryFresh(entry: VisitedResponseCacheEntry, options: {
   navigationKind: VisitedResponseCacheNavigationKind;
   now: number;
 }): boolean;
-declare function findVisitedResponseCacheEntry(cache: Map<string, VisitedResponseCacheEntry>, rscUrl: string, interceptionContext: string | null): {
+export declare function findVisitedResponseCacheEntry(cache: Map<string, VisitedResponseCacheEntry>, rscUrl: string, interceptionContext: string | null): {
   cacheKey: string;
   entry: VisitedResponseCacheEntry;
 } | null;
-declare function deleteVisitedResponseCacheEntry(cache: Map<string, VisitedResponseCacheEntry>, rscUrl: string, interceptionContext: string | null): boolean;
-declare function deleteAllVisitedResponseCacheEntries(cache: Map<string, VisitedResponseCacheEntry>, rscUrl: string, interceptionContext: string | null): number;
-declare function deleteInvalidatedHistoryRestoreEntries(cache: Map<string, VisitedResponseCacheEntry>): void;
-//#endregion
-export { MAX_TRAVERSAL_CACHE_TTL, VISITED_RESPONSE_CACHE_TTL, VisitedResponseCacheEntry, createVisitedResponseCacheEntry, deleteAllVisitedResponseCacheEntries, deleteInvalidatedHistoryRestoreEntries, deleteVisitedResponseCacheEntry, findVisitedResponseCacheEntry, hasNavigationResponseHistoryLifetime, isVisitedResponseCacheEntryFresh };
+export declare function deleteVisitedResponseCacheEntry(cache: Map<string, VisitedResponseCacheEntry>, rscUrl: string, interceptionContext: string | null): boolean;
+export declare function deleteAllVisitedResponseCacheEntries(cache: Map<string, VisitedResponseCacheEntry>, rscUrl: string, interceptionContext: string | null): number;
+export declare function deleteInvalidatedHistoryRestoreEntries(cache: Map<string, VisitedResponseCacheEntry>): void;
+//#endregion

package/dist/server/app-visited-response-cache.js

@@ -3,8 +3,8 @@ import "./app-elements.js";
 import { stripRscCacheBustingSearchParam } from "./app-rsc-cache-busting.js";
 import { resolveCachedRscResponseExpiresAt } from "../shims/navigation.js";
 //#region src/server/app-visited-response-cache.ts
-const VISITED_RESPONSE_CACHE_TTL = 5 * 6e4;
-const MAX_TRAVERSAL_CACHE_TTL = 30 * 6e4;
+const VISITED_RESPONSE_CACHE_TTL = 3e5;
+const MAX_TRAVERSAL_CACHE_TTL = 18e5;
 function hasNavigationResponseHistoryLifetime(snapshot) {
 	const dynamicStaleTime = snapshot.completedDynamicStaleTimeSeconds ?? snapshot.dynamicStaleTimeSeconds;
 	return dynamicStaleTime !== void 0 ? dynamicStaleTime > 0 : snapshot.serverStaleTime !== void 0;

package/dist/server/app-worker-stages.d.ts

@@ -0,0 +1,112 @@
+import { CacheabilityManifest } from "./cacheability-manifest.js";
+import { VinextResponseStageCacheability, VinextResponseStageDispatchOptions, VinextResponseStageTransport } from "./multi-stage.js";
+import { AppRscRenderMode } from "./app-rsc-render-mode.js";
+import { TrustedPrerenderState } from "./prerender-route-params.js";
+//#region src/server/app-worker-stages.d.ts
+export declare const APP_WORKER_RESPONSE_STAGE_PROTOCOL_VERSION = 10;
+export declare const APP_METADATA_RESPONSE_STAGE_NO_MATCH_HEADER = "x-vinext-app-metadata-stage-no-match";
+type AppPageParams = Record<string, string | string[]>;
+type AppWorkerResponseStageEnvelope = {
+  buildId: string | null;
+  cacheability: VinextResponseStageCacheability;
+  draftModeCookie: string | null;
+  middlewareCookieOverlay: string | null;
+  protocolVersion: typeof APP_WORKER_RESPONSE_STAGE_PROTOCOL_VERSION;
+  /** Canonical public request origin used to partition and validate shared renders. */
+  requestOrigin: string;
+  scriptNonce: string | null;
+};
+type AppFullRequestWorkerResponseStageProps = AppWorkerResponseStageEnvelope & {
+  kind: "app-full-request";
+  prerenderDiscovery: boolean;
+  staticFileSignalToken: string;
+  trustedPrerenderState: TrustedPrerenderState | null;
+};
+export type AppMatchedWorkerResponseStageProps = AppWorkerResponseStageEnvelope & {
+  kind: "app-page" | "app-route-handler";
+  bypassInterceptionContextCache: boolean;
+  /** Origin-cache pathname; differs from cleanPathname after an internal rewrite. */
+  cachePathname: string;
+  canUseCanonicalLoadingShell: boolean;
+  canonicalPathname: string;
+  cleanPathname: string;
+  forceDynamic?: boolean;
+  interceptionContext: string | null;
+  interceptionId: string | null;
+  isRscRequest: boolean;
+  matchKind: "interception" | "request" | "resolved";
+  mountedSlotsHeader: string | null;
+  params: AppPageParams;
+  resolvedUrl: string;
+  routePattern: string;
+  routePathname: string;
+  renderMode: AppRscRenderMode;
+};
+type AppNotFoundWorkerResponseStageProps = AppWorkerResponseStageEnvelope & {
+  kind: "app-not-found";
+  canonicalPathname: string;
+  cleanPathname: string;
+  isRscRequest: boolean;
+  mountedSlotsHeader: string | null;
+  renderMode: AppRscRenderMode;
+  resolvedUrl: string;
+};
+type AppMetadataWorkerResponseStageProps = AppWorkerResponseStageEnvelope & {
+  kind: "app-metadata";
+  canonicalPathname: string;
+  cleanPathname: string;
+  isRscRequest: boolean;
+  mountedSlotsHeader: string | null;
+  renderMode: AppRscRenderMode;
+  resolvedUrl: string;
+  routePathname: string;
+};
+type HybridPagesWorkerResponseStageProps = AppWorkerResponseStageEnvelope & {
+  kind: "hybrid-pages";
+  allowRscDocumentFallback: boolean;
+  appRouteMatch: {
+    isDynamic: boolean;
+    pattern: string;
+  } | null;
+  canonicalPathname: string;
+  cleanPathname: string;
+  isDataRequest: boolean;
+  isRscRequest: boolean;
+  matchKind: "dynamic" | "static";
+  /** Complete response-header snapshot installed before request-time Pages user code runs. */
+  preHandlerHeaders: Array<[string, string]> | null;
+  resourceKind: "api" | "page";
+  requestUrl: string;
+  resolvedUrl: string;
+};
+export type AppWorkerResponseStageProps = AppFullRequestWorkerResponseStageProps | AppMatchedWorkerResponseStageProps | AppMetadataWorkerResponseStageProps | AppNotFoundWorkerResponseStageProps | HybridPagesWorkerResponseStageProps;
+export type DispatchAppWorkerResponseStage = VinextResponseStageTransport<AppWorkerResponseStageProps>;
+export type RenderAppWorkerResponseStageLocally = (request: Request, props: AppWorkerResponseStageProps) => Promise<Response>;
+/** Normalize a shared App page HEAD request onto its method-invariant GET representation. */
+export declare function prepareSharedAppPageDispatch(request: Request, cache: VinextResponseStageDispatchOptions["cache"]): Request;
+/**
+ * Build the query-free cache identity of a shared App page dispatch. The user
+ * query leaves both the URL and `resolvedUrl`; the `.rsc` suffix, an RSC
+ * request's validated `_rsc`, and the render mode stay because they select the
+ * representation. HTML identities also drop the RSC selector headers.
+ */
+export declare function createSharedAppPageCacheIdentity(request: Request, props: AppMatchedWorkerResponseStageProps): NonNullable<VinextResponseStageDispatchOptions["cacheIdentity"]>;
+/**
+ * Drop the user query from an App page dispatch URL and its `resolvedUrl`,
+ * keeping an RSC request's validated `_rsc`, the rule the query-free cache
+ * identity uses.
+ */
+export declare function withoutAppPageDispatchQuery(requestUrl: string, props: AppMatchedWorkerResponseStageProps): {
+  props: AppMatchedWorkerResponseStageProps;
+  url: string;
+};
+/**
+ * Whether the Workers Cache request-stage projection gives a shared App page
+ * dispatch the `static-candidate` state, so its dispatch drops the user query.
+ * It is decided from the inputs completed-response admission uses: the
+ * header-canonicalized request's representation, the pathname after rewrites
+ * and the matched route pattern.
+ */
+export declare function isStaticCandidateAppPageDispatch(projection: CacheabilityManifest, request: Request, props: AppMatchedWorkerResponseStageProps): boolean;
+export declare function isAppWorkerResponseStageProps(value: unknown): value is AppWorkerResponseStageProps;
+//#endregion

package/dist/server/app-worker-stages.js

@@ -0,0 +1,105 @@
+import { VINEXT_RSC_VARY_HEADER } from "./app-rsc-vary.js";
+import { cacheabilityManifestPageState, cacheabilityRequestIdentity, cacheabilityRoutePathname } from "./cacheability-manifest.js";
+import { keepOnlyValidatedRscCacheBustingSearchParam } from "./app-rsc-cache-busting.js";
+import { isTrustedPrerenderState } from "./prerender-route-params.js";
+//#region src/server/app-worker-stages.ts
+const APP_WORKER_RESPONSE_STAGE_PROTOCOL_VERSION = 10;
+const APP_METADATA_RESPONSE_STAGE_NO_MATCH_HEADER = "x-vinext-app-metadata-stage-no-match";
+const STATIC_FILE_SIGNAL_TOKEN_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+/** Normalize a shared App page HEAD request onto its method-invariant GET representation. */
+function prepareSharedAppPageDispatch(request, cache) {
+	return cache !== "bypass" && request.method.toUpperCase() === "HEAD" ? new Request(request, { method: "GET" }) : request;
+}
+/**
+* Build the query-free cache identity of a shared App page dispatch. The user
+* query leaves both the URL and `resolvedUrl`; the `.rsc` suffix, an RSC
+* request's validated `_rsc`, and the render mode stay because they select the
+* representation. HTML identities also drop the RSC selector headers.
+*/
+function createSharedAppPageCacheIdentity(request, props) {
+	const queryFree = withoutAppPageDispatchQuery(request.url, props);
+	const headers = new Headers(request.headers);
+	if (!props.isRscRequest) for (const name of VINEXT_RSC_VARY_HEADER.split(",")) headers.delete(name.trim());
+	return {
+		props: queryFree.props,
+		request: new Request(queryFree.url, {
+			headers,
+			method: request.method
+		})
+	};
+}
+/**
+* Drop the user query from an App page dispatch URL and its `resolvedUrl`,
+* keeping an RSC request's validated `_rsc`, the rule the query-free cache
+* identity uses.
+*/
+function withoutAppPageDispatchQuery(requestUrl, props) {
+	const url = new URL(requestUrl);
+	keepOnlyValidatedRscCacheBustingSearchParam(url, props.isRscRequest);
+	const searchIndex = props.resolvedUrl.indexOf("?");
+	return {
+		props: {
+			...props,
+			resolvedUrl: searchIndex === -1 ? props.resolvedUrl : props.resolvedUrl.slice(0, searchIndex)
+		},
+		url: url.toString()
+	};
+}
+/**
+* Whether the Workers Cache request-stage projection gives a shared App page
+* dispatch the `static-candidate` state, so its dispatch drops the user query.
+* It is decided from the inputs completed-response admission uses: the
+* header-canonicalized request's representation, the pathname after rewrites
+* and the matched route pattern.
+*/
+function isStaticCandidateAppPageDispatch(projection, request, props) {
+	const identity = cacheabilityRequestIdentity(request, props.cacheability.representation);
+	if (!identity) return false;
+	return cacheabilityManifestPageState(projection, {
+		kind: "app-page",
+		pattern: props.routePattern
+	}, identity.representation, cacheabilityRoutePathname(props.cacheability.resolvedRoutePathname, identity.representation)) === "static-candidate";
+}
+function isAppPageParams(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	for (const param of Object.values(value)) {
+		if (typeof param === "string") continue;
+		if (!Array.isArray(param) || param.some((item) => typeof item !== "string")) return false;
+	}
+	return true;
+}
+function isCanonicalHttpOrigin(value) {
+	if (typeof value !== "string") return false;
+	try {
+		const url = new URL(value);
+		return (url.protocol === "http:" || url.protocol === "https:") && url.origin === value;
+	} catch {
+		return false;
+	}
+}
+function isAppWorkerResponseStageProps(value) {
+	if (!value || typeof value !== "object") return false;
+	const props = value;
+	if (props.protocolVersion !== 10 || props.buildId !== null && typeof props.buildId !== "string" || !isResponseStageCacheability(props.cacheability) || props.draftModeCookie !== null && typeof props.draftModeCookie !== "string" || props.middlewareCookieOverlay !== null && typeof props.middlewareCookieOverlay !== "string" || !isCanonicalHttpOrigin(props.requestOrigin) || props.scriptNonce !== null && typeof props.scriptNonce !== "string") return false;
+	if (props.kind === "app-full-request") return typeof props.prerenderDiscovery === "boolean" && typeof props.staticFileSignalToken === "string" && STATIC_FILE_SIGNAL_TOKEN_RE.test(props.staticFileSignalToken) && (props.trustedPrerenderState === null || isTrustedPrerenderState(props.trustedPrerenderState));
+	if (props.kind === "hybrid-pages") {
+		const hybrid = props;
+		const appRouteMatch = hybrid.appRouteMatch;
+		return typeof hybrid.allowRscDocumentFallback === "boolean" && (appRouteMatch === null || typeof appRouteMatch === "object" && typeof appRouteMatch.isDynamic === "boolean" && typeof appRouteMatch.pattern === "string" && appRouteMatch.pattern.startsWith("/")) && typeof hybrid.canonicalPathname === "string" && hybrid.canonicalPathname.startsWith("/") && typeof hybrid.cleanPathname === "string" && hybrid.cleanPathname.startsWith("/") && typeof hybrid.isDataRequest === "boolean" && typeof hybrid.isRscRequest === "boolean" && (hybrid.matchKind === "dynamic" || hybrid.matchKind === "static") && (hybrid.preHandlerHeaders === null || isSerializedHeaders(hybrid.preHandlerHeaders)) && (hybrid.resourceKind === "api" || hybrid.resourceKind === "page") && typeof hybrid.requestUrl === "string" && typeof hybrid.resolvedUrl === "string" && hybrid.resolvedUrl.startsWith("/");
+	}
+	if (props.kind === "app-metadata" || props.kind === "app-not-found") {
+		const special = props;
+		return typeof special.canonicalPathname === "string" && special.canonicalPathname.startsWith("/") && typeof special.cleanPathname === "string" && special.cleanPathname.startsWith("/") && typeof special.isRscRequest === "boolean" && (special.mountedSlotsHeader === null || typeof special.mountedSlotsHeader === "string") && typeof special.resolvedUrl === "string" && special.resolvedUrl.startsWith("/") && (props.kind !== "app-metadata" || typeof props.routePathname === "string" && props.routePathname.startsWith("/")) && (special.renderMode === "navigation" || special.renderMode === "prefetch-empty" || special.renderMode === "prefetch-dynamic-shell" || special.renderMode === "prefetch-loading-shell");
+	}
+	return (props.kind === "app-page" || props.kind === "app-route-handler") && typeof props.bypassInterceptionContextCache === "boolean" && typeof props.cachePathname === "string" && props.cachePathname.startsWith("/") && typeof props.canUseCanonicalLoadingShell === "boolean" && typeof props.canonicalPathname === "string" && props.canonicalPathname.startsWith("/") && typeof props.cleanPathname === "string" && props.cleanPathname.startsWith("/") && (props.forceDynamic === void 0 || typeof props.forceDynamic === "boolean") && (props.interceptionContext === null || typeof props.interceptionContext === "string") && (props.interceptionId === null || typeof props.interceptionId === "string") && typeof props.isRscRequest === "boolean" && (props.matchKind === "interception" || props.matchKind === "request" || props.matchKind === "resolved") && (props.mountedSlotsHeader === null || typeof props.mountedSlotsHeader === "string") && isAppPageParams(props.params) && typeof props.resolvedUrl === "string" && props.resolvedUrl.startsWith("/") && typeof props.routePattern === "string" && props.routePattern.startsWith("/") && typeof props.routePathname === "string" && props.routePathname.startsWith("/") && (props.renderMode === "navigation" || props.renderMode === "prefetch-empty" || props.renderMode === "prefetch-dynamic-shell" || props.renderMode === "prefetch-loading-shell");
+}
+function isSerializedHeaders(value) {
+	return Array.isArray(value) && value.every((entry) => Array.isArray(entry) && entry.length === 2 && typeof entry[0] === "string" && typeof entry[1] === "string");
+}
+function isResponseStageCacheability(value) {
+	if (!value || typeof value !== "object") return false;
+	const cacheability = value;
+	return (cacheability.probeMode === null || cacheability.probeMode === "probe" || cacheability.probeMode === "identity") && (cacheability.policyHeaders === null || Array.isArray(cacheability.policyHeaders) && cacheability.policyHeaders.every((entry) => Array.isArray(entry) && entry.length === 2 && typeof entry[0] === "string" && typeof entry[1] === "string")) && (cacheability.representation === void 0 || cacheability.representation === "app-route" || cacheability.representation === "html" || cacheability.representation === "pages-data" || cacheability.representation === "rsc-full" || cacheability.representation === "rsc-loading-shell") && typeof cacheability.resolvedRoutePathname === "string" && cacheability.resolvedRoutePathname.startsWith("/");
+}
+//#endregion
+export { APP_METADATA_RESPONSE_STAGE_NO_MATCH_HEADER, APP_WORKER_RESPONSE_STAGE_PROTOCOL_VERSION, createSharedAppPageCacheIdentity, isAppWorkerResponseStageProps, isStaticCandidateAppPageDispatch, prepareSharedAppPageDispatch, withoutAppPageDispatchQuery };

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

@@ -1,8 +1,8 @@
 //#region src/server/artifact-compatibility.d.ts
-declare const ARTIFACT_COMPATIBILITY_SCHEMA_VERSION = 1;
-declare const APP_ELEMENTS_SCHEMA_VERSION = 1;
-declare const RSC_PAYLOAD_SCHEMA_VERSION = 1;
-type ArtifactCompatibilityEnvelope = Readonly<{
+export declare const ARTIFACT_COMPATIBILITY_SCHEMA_VERSION = 1;
+export declare const APP_ELEMENTS_SCHEMA_VERSION = 1;
+export declare const RSC_PAYLOAD_SCHEMA_VERSION = 1;
+export type ArtifactCompatibilityEnvelope = Readonly<{
   schemaVersion: typeof ARTIFACT_COMPATIBILITY_SCHEMA_VERSION;
   graphVersion: string | null;
   deploymentVersion: string | null;
@@ -11,7 +11,7 @@ type ArtifactCompatibilityEnvelope = Readonly<{
   rootBoundaryId: string | null;
   renderEpoch: string | null;
 }>;
-declare const ARTIFACT_COMPATIBILITY_PROOF_FIELDS: readonly (keyof ArtifactCompatibilityEnvelope)[];
+export declare const ARTIFACT_COMPATIBILITY_PROOF_FIELDS: readonly (keyof ArtifactCompatibilityEnvelope)[];
 type ArtifactCompatibilityEnvelopeInput = Readonly<{
   graphVersion?: string | null;
   deploymentVersion?: string | null;
@@ -25,7 +25,7 @@ type ArtifactCompatibilityMap = Readonly<{
   rootBoundaryIds?: readonly ArtifactCompatibilitySet[];
   renderEpochs?: readonly ArtifactCompatibilitySet[];
 }>;
-type ArtifactCompatibilityEvaluationOptions = Readonly<{
+export type ArtifactCompatibilityEvaluationOptions = Readonly<{
   compatibilityMap?: ArtifactCompatibilityMap;
 }>;
 type ArtifactCompatibilityFallback = "renderFresh";
@@ -46,9 +46,8 @@ type ArtifactCompatibilityGraphVersionInput = Readonly<{
   routePattern: string;
   rootBoundaryId: string | null;
 }>;
-declare function createArtifactCompatibilityEnvelope(input?: ArtifactCompatibilityEnvelopeInput): ArtifactCompatibilityEnvelope;
-declare function createArtifactCompatibilityGraphVersion(input: ArtifactCompatibilityGraphVersionInput): string;
-declare function parseArtifactCompatibilityEnvelope(value: unknown): ArtifactCompatibilityEnvelope | null;
-declare function evaluateArtifactCompatibility(current: ArtifactCompatibilityEnvelope, candidate: ArtifactCompatibilityEnvelope, options?: ArtifactCompatibilityEvaluationOptions): ArtifactCompatibilityDecision;
-//#endregion
-export { APP_ELEMENTS_SCHEMA_VERSION, ARTIFACT_COMPATIBILITY_PROOF_FIELDS, ARTIFACT_COMPATIBILITY_SCHEMA_VERSION, ArtifactCompatibilityEnvelope, ArtifactCompatibilityEvaluationOptions, RSC_PAYLOAD_SCHEMA_VERSION, createArtifactCompatibilityEnvelope, createArtifactCompatibilityGraphVersion, evaluateArtifactCompatibility, parseArtifactCompatibilityEnvelope };
+export declare function createArtifactCompatibilityEnvelope(input?: ArtifactCompatibilityEnvelopeInput): ArtifactCompatibilityEnvelope;
+export declare function createArtifactCompatibilityGraphVersion(input: ArtifactCompatibilityGraphVersionInput): string;
+export declare function parseArtifactCompatibilityEnvelope(value: unknown): ArtifactCompatibilityEnvelope | null;
+export declare function evaluateArtifactCompatibility(current: ArtifactCompatibilityEnvelope, candidate: ArtifactCompatibilityEnvelope, options?: ArtifactCompatibilityEvaluationOptions): ArtifactCompatibilityDecision;
+//#endregion

package/dist/server/before-interactive-head.d.ts

@@ -11,6 +11,5 @@ import { BeforeInteractiveInlineScript } from "../shims/before-interactive-conte
  * passed through here is being concatenated directly into HTML; treat the
  * inputs accordingly.
  */
-declare function renderBeforeInteractiveInlineScripts(scripts: readonly BeforeInteractiveInlineScript[]): string;
-//#endregion
-export { renderBeforeInteractiveInlineScripts };
+export declare function renderBeforeInteractiveInlineScripts(scripts: readonly BeforeInteractiveInlineScript[]): string;
+//#endregion

package/dist/server/bfcache-identity.d.ts

@@ -1,10 +1,10 @@
 //#region src/server/bfcache-identity.d.ts
 type ParallelSlotBindingState = "active" | "default" | "unmatched";
-declare function createNestedBfcacheSlotSegmentId(parentSlotId: string, level: number): string;
-declare function isNestedBfcacheSlotSegmentId(id: string): boolean;
-declare function isNestedBfcacheSlotSegmentIdFor(id: string, parentSlotId: string): boolean;
-type BfcacheSegmentIdentity = string;
-type BfcacheSegmentDescriptor = {
+export declare function createNestedBfcacheSlotSegmentId(parentSlotId: string, level: number): string;
+export declare function isNestedBfcacheSlotSegmentId(id: string): boolean;
+export declare function isNestedBfcacheSlotSegmentIdFor(id: string, parentSlotId: string): boolean;
+export type BfcacheSegmentIdentity = string;
+export type BfcacheSegmentDescriptor = {
   kind: "page";
   graphId: string;
   rootBoundaryId: string | null;
@@ -40,6 +40,5 @@ type BfcacheSegmentDescriptor = {
   boundSegmentKey: string;
   sourceBoundSegmentKey: string;
 };
-declare function deriveBfcacheSegmentIdentity(descriptor: BfcacheSegmentDescriptor): string;
-//#endregion
-export { BfcacheSegmentDescriptor, BfcacheSegmentIdentity, createNestedBfcacheSlotSegmentId, deriveBfcacheSegmentIdentity, isNestedBfcacheSlotSegmentId, isNestedBfcacheSlotSegmentIdFor };
+export declare function deriveBfcacheSegmentIdentity(descriptor: BfcacheSegmentDescriptor): string;
+//#endregion

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

@@ -1,18 +1,32 @@
 import { CdnCacheableHeaderInput, isNonCacheableCacheControl } from "../shims/cdn-cache.js";
 //#region src/server/cache-control.d.ts
-declare const NEVER_CACHE_CONTROL = "private, no-cache, no-store, max-age=0, must-revalidate";
-declare const BROWSER_REVALIDATE_CACHE_CONTROL = "public, max-age=0, must-revalidate";
-declare const STATIC_CACHE_CONTROL = "s-maxage=31536000, stale-while-revalidate";
-declare const NO_STORE_CACHE_CONTROL = "no-store, must-revalidate";
-declare function shouldUseNextDeployCacheControl(): boolean;
+export declare const NEVER_CACHE_CONTROL = "private, no-cache, no-store, max-age=0, must-revalidate";
+export declare const BROWSER_REVALIDATE_CACHE_CONTROL = "public, max-age=0, must-revalidate";
+export declare const STATIC_CACHE_CONTROL = "s-maxage=31536000, stale-while-revalidate";
+export declare const NO_STORE_CACHE_CONTROL = "no-store, must-revalidate";
+export declare function shouldUseNextDeployCacheControl(): boolean;
 /**
  * Whether an existing response explicitly opted out of storage. Adapters may
  * inspect the provider-specific policy headers they own; the generic fallback
  * only understands the framework-owned `Cache-Control` header.
  */
-declare function hasExplicitNonCacheableResponsePolicy(headers: Headers): boolean;
+export declare function hasExplicitNonCacheableResponsePolicy(headers: Headers, baseline?: Headers): boolean;
+/** Whether a response header controls core or the active CDN adapter. */
+export declare function isCdnResponsePolicyHeader(name: string): boolean;
+/** Whether a response declares any core- or adapter-owned cache policy. */
+export declare function hasCdnResponsePolicy(headers: Headers): boolean;
+/** Read the effective shared-cache policy without interpreting provider headers in core. */
+export declare function readCdnResponseCacheControl(headers: Headers | undefined): string | null;
+/** Name the lowercased policy header whose value `readCdnResponseCacheControl` read. */
+export declare function readCdnResponsePolicyHeaderName(headers: Headers): string | null;
+/** Ask the active adapter whether one policy header explicitly disables storage. */
+export declare function isNonCacheableCdnResponsePolicy(name: string, value: string): boolean;
+/** Capture only cache-policy provenance from an outer composition stage. */
+export declare function captureCdnResponsePolicyHeaders(headers: Headers): Headers;
+/** Capture policy values that were added above an already-transported baseline. */
+export declare function captureCdnResponsePolicyOverrides(headers: Headers, baseline: Headers): Headers;
 /** Delegate provider-specific request routing validation to the CDN adapter. */
-declare function validateCdnRequest(request: Request): Promise<Response | null>;
+export declare function validateCdnRequest(request: Request): Promise<Response | null>;
 /**
  * Route a cacheable response's headers through the active CDN cache adapter and
  * apply the result to `headers`. The default adapter yields a single
@@ -23,11 +37,19 @@ declare function validateCdnRequest(request: Request): Promise<Response | null>;
  * while returning `null` removes it. Core only clears the generic header it
  * owns before applying that map.
  */
-declare function applyCdnResponseHeaders(headers: Headers, input: CdnCacheableHeaderInput): void;
+export declare function applyCdnResponseHeaders(headers: Headers, input: CdnCacheableHeaderInput): void;
+/**
+ * Reconcile request-stage policy composed above a reusable response artifact.
+ * A newly applied private policy must clear any cacheable provider headers that
+ * belonged to the inner artifact before the final response leaves the gateway.
+ * `outerPolicyHeaders` contains only policy set by the uncached request stage,
+ * so an identical inner value cannot hide explicit outer provenance.
+ */
+export declare function reconcileCdnResponseHeadersAfterOuterPolicy(headers: Headers, outerPolicyHeaders: Headers): void;
 /** Apply adapter-owned build identity to an HTML or RSC page response. */
-declare function applyCdnResponseIdentityHeaders(response: Response, request: Request): Response;
+export declare function applyCdnResponseIdentityHeaders(response: Response, request: Request): Response;
 /** Apply adapter-owned build identity to an already-classified response. */
-declare function applyCdnResponseBuildIdentityHeaders(response: Response): Response;
+export declare function applyCdnResponseBuildIdentityHeaders(response: Response): Response;
 /**
  * Matches Next.js's `getCacheControlHeader` stale window semantics while
  * preserving vinext's legacy unbounded SWR header when no expire ceiling is
@@ -36,7 +58,7 @@ declare function applyCdnResponseBuildIdentityHeaders(response: Response): Respo
  * Next.js source:
  * https://github.com/vercel/next.js/blob/canary/packages/next/src/server/lib/cache-control.ts
  */
-declare function buildRevalidateCacheControl(revalidateSeconds: number | false, expireSeconds?: number): string;
+export declare function buildRevalidateCacheControl(revalidateSeconds: number | false, expireSeconds?: number): string;
 /**
  * Builds Cache-Control for ISR cache reads. HIT responses and STALE responses
  * with stored expire metadata use the same route policy because Next.js derives
@@ -44,6 +66,6 @@ declare function buildRevalidateCacheControl(revalidateSeconds: number | false,
  * STALE entries without expire metadata keep vinext's legacy `s-maxage=0`
  * fallback so older cache entries are not treated as newly fresh downstream.
  */
-declare function buildCachedRevalidateCacheControl(cacheState: "HIT" | "STALE", revalidateSeconds: number | false, expireSeconds?: number): string;
+export declare function buildCachedRevalidateCacheControl(cacheState: "HIT" | "STALE", revalidateSeconds: number | false, expireSeconds?: number): string;
 //#endregion
-export { BROWSER_REVALIDATE_CACHE_CONTROL, NEVER_CACHE_CONTROL, NO_STORE_CACHE_CONTROL, STATIC_CACHE_CONTROL, applyCdnResponseBuildIdentityHeaders, applyCdnResponseHeaders, applyCdnResponseIdentityHeaders, buildCachedRevalidateCacheControl, buildRevalidateCacheControl, hasExplicitNonCacheableResponsePolicy, isNonCacheableCacheControl, shouldUseNextDeployCacheControl, validateCdnRequest };
+export { isNonCacheableCacheControl };