vinext 0.0.55 → 0.1.1

package/dist/server/app-server-action-execution.js

@@ -1,3 +1,4 @@
+import { splitPathSegments } from "../routing/utils.js";
 import { addBasePathToPathname, hasBasePath, stripBasePath } from "../utils/base-path.js";
 import { ACTION_FORWARDED_HEADER, ACTION_REDIRECT_HEADER, ACTION_REDIRECT_STATUS_HEADER, ACTION_REDIRECT_TYPE_HEADER, ACTION_REVALIDATED_HEADER } from "./headers.js";
 import { isExternalUrl } from "../config/config-matchers.js";
@@ -9,10 +10,10 @@ import { APP_RSC_RENDER_MODE_ACTION_RERENDER_PRESERVE_UI } from "./app-rsc-rende
 import { setCurrentFetchCacheMode, setCurrentFetchSoftTags } from "../shims/fetch-cache.js";
 import { VINEXT_RSC_CONTENT_TYPE, VINEXT_RSC_VARY_HEADER, applyRscCompatibilityIdHeader } from "./app-rsc-cache-busting.js";
 import { readStreamAsTextWithLimit } from "../utils/text-stream.js";
-import { createServerActionNotFoundResponse, getServerActionNotFoundMessage, isServerActionNotFoundError } from "./server-action-not-found.js";
 import { mergeMiddlewareResponseHeaders } from "./middleware-response-headers.js";
 import { applyEdgeRuntimeHeader } from "./app-page-response.js";
 import { getNextErrorDigest, parseNextHttpErrorDigest, parseNextRedirectDigest } from "./next-error-digest.js";
+import { createServerActionNotFoundResponse, getServerActionNotFoundMessage, isServerActionNotFoundError } from "./server-action-not-found.js";
 import { deferUntilStreamConsumed } from "./app-page-stream.js";
 import { resolveAppPageActionRerenderTarget } from "./app-page-request.js";
 import { buildPageCacheTags } from "./implicit-tags.js";
@@ -109,6 +110,15 @@ function isRequestBodyTooLarge(error) {
 	return error instanceof Error && error.message === "Request body too large";
 }
 /**
+* Build the error thrown when a server-action request body exceeds the
+* configured size limit. Matches Next.js' `Body exceeded {limit} limit.`
+* message + docs link (action-handler.ts) verbatim — including the original
+* config string (e.g. "2mb") — so it reads identically in logs.
+*/
+function createBodyExceededError(limitLabel) {
+	return /* @__PURE__ */ new Error(`Body exceeded ${limitLabel} limit.\nTo configure the body size limit for Server Actions, see: https://nextjs.org/docs/app/api-reference/next-config-js/serverActions#bodysizelimit`);
+}
+/**
 * Collapse repeated `cookies().set(name, ...)` / `cookies().delete(name)`
 * calls down to the last value per name, matching Next.js'
 * `MutableRequestCookiesAdapter` semantics. Next.js stores response cookies in
@@ -244,12 +254,9 @@ function resolveInternalActionRedirectTarget(redirectUrl, requestUrl, basePath)
 function isAncestorRouteRedirect(targetPathname, currentPathname) {
 	return targetPathname !== "/" && currentPathname.startsWith(`${targetPathname}/`);
 }
-function splitActionRedirectPathname(pathname) {
-	return pathname.split("/").filter(Boolean);
-}
 function isStaleChildSiblingRouteRedirect(targetPathname, currentPathname) {
-	const targetSegments = splitActionRedirectPathname(targetPathname);
-	const currentSegments = splitActionRedirectPathname(currentPathname);
+	const targetSegments = splitPathSegments(targetPathname);
+	const currentSegments = splitPathSegments(currentPathname);
 	if (targetSegments.length === 0 || currentSegments.length <= targetSegments.length) return false;
 	let commonPrefixLength = 0;
 	const maxPrefixLength = Math.min(targetSegments.length, currentSegments.length);
@@ -327,7 +334,13 @@ async function handleProgressiveServerActionRequest(options) {
 			return payloadResponse;
 		}
 		const action = await options.decodeAction(body);
-		if (!isAppServerActionFunction(action)) return null;
+		if (!isAppServerActionFunction(action)) {
+			if (options.hasPageRoute) return createActionNotFoundResponse(null, {
+				clearRequestContext: options.clearRequestContext,
+				getAndClearPendingCookies: options.getAndClearPendingCookies
+			});
+			return null;
+		}
 		let actionRedirect = null;
 		let actionError = void 0;
 		let actionFailed = false;
@@ -413,23 +426,66 @@ async function handleProgressiveServerActionRequest(options) {
 		return internalServerErrorResponse(process.env.NODE_ENV === "production" ? void 0 : "Server action parsing failed: " + getServerActionFailureMessage(error));
 	}
 }
+/**
+* Render the response for a fetch (client-invoked) server action whose request
+* body exceeds the configured `serverActions.bodySizeLimit`.
+*
+* Next.js does not return a bare 413 here: it throws the body-exceeded error
+* before the action runs, then — for fetch actions — emits a Flight response
+* with status 500 carrying the rejected action result, so the nearest client
+* error boundary catches it (see action-handler.ts, the `isFetchAction` branch
+* of the generic error path). vinext mirrors that by rendering a Flight stream
+* with `returnValue: { ok: false }` and no page root (the action never ran, so
+* nothing was revalidated and the page render is skipped). A bare 413 plain
+* response would bypass the boundary and surface the wrong status/content-type.
+*/
+async function renderFetchActionBodyExceededResponse(options) {
+	const error = createBodyExceededError(options.maxActionBodySizeLabel);
+	console.error("[vinext] Server action error:", error);
+	options.reportRequestError(normalizeError(error), {
+		path: options.cleanPathname,
+		method: options.request.method,
+		headers: Object.fromEntries(options.request.headers.entries())
+	}, {
+		routerKind: "App Router",
+		routePath: options.cleanPathname,
+		routeType: "action"
+	});
+	getAndClearActionRevalidationKind();
+	options.getAndClearPendingCookies();
+	const returnValue = {
+		ok: false,
+		data: options.sanitizeErrorForClient(error)
+	};
+	const temporaryReferences = options.createTemporaryReferenceSet();
+	const onRenderError = options.createRscOnErrorHandler(options.request, options.cleanPathname, options.cleanPathname);
+	const rscStream = await options.renderToReadableStream({ returnValue }, {
+		temporaryReferences,
+		onError: onRenderError
+	});
+	const headers = new Headers({
+		"Content-Type": VINEXT_RSC_CONTENT_TYPE,
+		Vary: VINEXT_RSC_VARY_HEADER
+	});
+	applyEdgeRuntimeHeader(headers, options.isEdgeRuntime);
+	mergeMiddlewareResponseHeaders(headers, options.middlewareHeaders);
+	applyRscCompatibilityIdHeader(headers);
+	return createServerActionRscResponse(rscStream, {
+		status: 500,
+		headers
+	}, options.clearRequestContext);
+}
 async function handleServerActionRscRequest(options) {
 	if (options.request.method.toUpperCase() !== "POST" || !options.actionId) return null;
 	const csrfResponse = validateCsrfOrigin(options.request, options.allowedOrigins);
 	if (csrfResponse) return csrfResponse;
-	if (parseInt(options.request.headers.get("content-length") || "0", 10) > options.maxActionBodySize) {
-		options.clearRequestContext();
-		return payloadTooLargeResponse();
-	}
+	if (parseInt(options.request.headers.get("content-length") || "0", 10) > options.maxActionBodySize) return renderFetchActionBodyExceededResponse(options);
 	try {
 		let body;
 		try {
 			body = options.contentType.startsWith("multipart/form-data") ? await options.readFormDataWithLimit(options.request, options.maxActionBodySize) : await options.readBodyWithLimit(options.request, options.maxActionBodySize);
 		} catch (error) {
-			if (isRequestBodyTooLarge(error)) {
-				options.clearRequestContext();
-				return payloadTooLargeResponse();
-			}
+			if (isRequestBodyTooLarge(error)) return renderFetchActionBodyExceededResponse(options);
 			throw error;
 		}
 		const payloadResponse = await validateServerActionPayload(body);
@@ -519,6 +575,7 @@ async function handleServerActionRscRequest(options) {
 			}
 			const targetPathname = stripBasePath(redirectTarget.pathname, options.basePath ?? "");
 			const targetMatch = options.matchRoute(targetPathname);
+			if (targetMatch) await options.ensureRouteLoaded?.(targetMatch.route);
 			if (!targetMatch || !canRenderActionRedirectTarget(targetMatch.route)) {
 				options.clearRequestContext();
 				return new Response(null, {
@@ -527,6 +584,7 @@ async function handleServerActionRscRequest(options) {
 				});
 			}
 			const currentMatch = options.matchRoute(options.cleanPathname);
+			if (currentMatch) await options.ensureRouteLoaded?.(currentMatch.route);
 			const redirectRenderRequest = createActionRedirectRenderRequest({
 				pendingCookies: [...actionPendingCookies, ...actionDraftCookie ? [actionDraftCookie] : []],
 				request: options.request,
@@ -599,7 +657,7 @@ async function handleServerActionRscRequest(options) {
 		let errorPattern = match ? match.route.pattern : options.cleanPathname;
 		if (match) {
 			const { route: actionRoute, params: actionParams } = match;
-			const actionRerenderTarget = resolveAppPageActionRerenderTarget({
+			const actionRerenderTarget = await resolveAppPageActionRerenderTarget({
 				cleanPathname: options.cleanPathname,
 				currentParams: actionParams,
 				currentRoute: actionRoute,
@@ -614,6 +672,7 @@ async function handleServerActionRscRequest(options) {
 				searchParams: options.searchParams,
 				params: actionRerenderTarget.navigationParams
 			});
+			await options.ensureRouteLoaded?.(actionRerenderTarget.route);
 			setCurrentFetchCacheMode(options.resolveRouteFetchCacheMode?.(actionRerenderTarget.route) ?? null);
 			setCurrentFetchSoftTags(buildServerActionPageTags(actionRerenderTarget.route, options.cleanPathname));
 			element = options.buildPageElement({
@@ -670,5 +729,3 @@ async function handleServerActionRscRequest(options) {
 }
 //#endregion
 export { applyActionRedirectBasePath, handleProgressiveServerActionRequest, handleServerActionRscRequest, isProgressiveServerActionRequest, readActionBodyWithLimit, readActionFormDataWithLimit };
-
-//# sourceMappingURL=app-server-action-execution.js.map

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

@@ -1,5 +1,6 @@
 import { NavigationContext } from "../shims/navigation.js";
 import { RootParams } from "../shims/root-params.js";
+import { AppSsrRenderResult } from "./app-page-stream.js";
 import { ReactFormState } from "react-dom/client";
 
 //#region src/server/app-ssr-entry.d.ts
@@ -29,15 +30,21 @@ declare function handleSsr(rscStream: ReadableStream<Uint8Array>, navContext: Na
    * SSR head. Undefined or empty disables emission entirely.
    */
   clientTraceMetadata?: readonly string[];
-  rootParams?: RootParams;
+  /**
+   * Maximum total length (in characters) of the preload `Link` header React
+   * emits during SSR. `0` disables emission. From `reactMaxHeadersLength` in
+   * `next.config`. Undefined falls back to React's own default.
+   */
+  reactMaxHeadersLength?: number;
+  rootParams?: RootParams; /** Dev-only: original server error to surface in the browser overlay. */
+  initialDevServerError?: unknown;
   /** When true, wait for the full React tree (including Suspense boundaries)
    *  to resolve before returning the HTML stream. Used for static prerender
    *  and ISR cache writes to avoid caching fallback content. */
   waitForAllReady?: boolean;
-}): Promise<ReadableStream<Uint8Array>>;
+}): Promise<AppSsrRenderResult>;
 declare const _default: {
   fetch(request: Request): Promise<Response>;
 };
 //#endregion
-export { FontData, FontPreload, _default as default, handleSsr };
-//# sourceMappingURL=app-ssr-entry.d.ts.map
+export { FontData, FontPreload, _default as default, handleSsr };

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

@@ -4,24 +4,33 @@ import { isOpenRedirectShaped } from "./request-pipeline.js";
 import { AppElementsWire } from "./app-elements-wire.js";
 import "./app-elements.js";
 import { AppRouterContext } from "../shims/internal/app-router-context.js";
-import { ServerInsertedHTMLContext, appRouterInstance, clearServerInsertedHTML, renderServerInsertedHTML, setNavigationContext, useServerInsertedHTML } from "../shims/navigation.js";
+import { ServerInsertedHTMLContext, appRouterInstance, clearServerInsertedHTML, getBfcacheIdMapContext, renderServerInsertedHTML, setNavigationContext, useServerInsertedHTML } from "../shims/navigation.js";
 import { runWithNavigationContext } from "../shims/navigation-state.js";
 import { withScriptNonce } from "../shims/script-nonce-context.js";
 import { createInlineScriptTag, createNonceAttribute, escapeHtmlAttr, safeJsonStringify } from "./html.js";
 import { getClientTraceMetadataHTML } from "./client-trace-metadata.js";
-import { ElementsContext, Slot } from "../shims/slot.js";
+import { BfcacheStateKeyMapContext, ElementsContext, Slot } from "../shims/slot.js";
+import { createSsrErrorMetaRenderer } from "./app-ssr-error-meta.js";
 import { createNavigationRuntimeRscMetadataScript, createRscEmbedTransform, createTickBufferedTransform } from "./app-ssr-stream.js";
+import { BeforeInteractiveContext } from "../shims/before-interactive-context.js";
+import { runWithRootParamsScope } from "../shims/root-params.js";
+import { createBfcacheSegmentStateKeyMap, createInitialBfcacheIdMap } from "./app-browser-state.js";
 import { RSC_FORM_STATE_GLOBAL } from "./app-browser-hydration.js";
 import { createClientReferencePreloader } from "./app-client-reference-preloader.js";
 import { deferUntilStreamConsumed } from "./app-page-stream.js";
-import { runWithRootParamsScope } from "../shims/root-params.js";
-import { BeforeInteractiveContext } from "../shims/before-interactive-context.js";
-import { createSsrErrorMetaRenderer } from "./app-ssr-error-meta.js";
+import { createInitialDevServerErrorScript } from "./dev-initial-server-error.js";
 import { Fragment, createElement, use } from "react";
 import { renderToReadableStream, renderToStaticMarkup } from "react-dom/server.edge";
 import { createFromReadableStream } from "@vitejs/plugin-rsc/ssr";
 import clientReferences from "virtual:vite-rsc/client-references";
 //#region src/server/app-ssr-entry.ts
+/**
+* Default cap for the preload `Link` header, matching Next.js's
+* `defaultConfig.reactMaxHeadersLength`. Used when no config value threads
+* through (e.g. error-boundary renders) so React's internal cap agrees with
+* the response-layer combine cap.
+*/
+const DEFAULT_REACT_MAX_HEADERS_LENGTH = 6e3;
 const clientReferencePreloader = createClientReferencePreloader({
 	getReferences() {
 		return clientReferences;
@@ -33,6 +42,7 @@ const clientReferencePreloader = createClientReferencePreloader({
 		if (process.env.NODE_ENV !== "production") console.warn("[vinext] failed to preload client ref:", id, error);
 	}
 });
+const BfcacheIdMapContext = getBfcacheIdMapContext();
 function ssrErrorDigest(input) {
 	let hash = 5381;
 	for (let i = input.length - 1; i >= 0; i--) hash = hash * 33 ^ input.charCodeAt(i);
@@ -117,15 +127,20 @@ function buildModulePreloadHtml(bootstrapModuleUrl, nonce) {
 }
 function buildHeadInjectionHtml(navContext, bootstrapModuleUrl, formState, insertedHTML, fontHTML, scriptNonce) {
 	const navPayload = {
-		pathname: navContext?.pathname ?? "/",
-		searchParams: navContext?.searchParams ? [...navContext.searchParams.entries()] : []
+		pathname: navContext.pathname,
+		searchParams: [...navContext.searchParams.entries()]
 	};
-	return createInlineScriptTag(createNavigationRuntimeRscMetadataScript(navContext?.params ?? {}, navPayload), scriptNonce) + (formState === null ? "" : createInlineScriptTag("self[" + safeJsonStringify(RSC_FORM_STATE_GLOBAL) + "]=" + safeJsonStringify(formState), scriptNonce)) + buildModulePreloadHtml(bootstrapModuleUrl, scriptNonce) + insertedHTML + fontHTML;
+	return createInlineScriptTag(createNavigationRuntimeRscMetadataScript(navContext.params, navPayload), scriptNonce) + (formState === null ? "" : createInlineScriptTag("self[" + safeJsonStringify(RSC_FORM_STATE_GLOBAL) + "]=" + safeJsonStringify(formState), scriptNonce)) + buildModulePreloadHtml(bootstrapModuleUrl, scriptNonce) + insertedHTML + fontHTML;
+}
+function requireNavigationContext(navContext) {
+	if (!navContext) throw new Error("App SSR requires navigation context for BFCache state keys");
+	return navContext;
 }
 async function handleSsr(rscStream, navContext, fontData, options) {
 	return runWithNavigationContext(async () => {
+		const ssrNavigationContext = requireNavigationContext(navContext);
 		await clientReferencePreloader.preload();
-		if (navContext) setNavigationContext(navContext);
+		setNavigationContext(ssrNavigationContext);
 		clearServerInsertedHTML();
 		const cleanup = () => {
 			setNavigationContext(null);
@@ -150,7 +165,12 @@ async function handleSsr(rscStream, navContext, fontData, options) {
 					const wireElements = use(flightRoot);
 					const elements = AppElementsWire.decode(wireElements);
 					const metadata = AppElementsWire.readMetadata(elements);
-					return createElement(ElementsContext.Provider, { value: elements }, createElement(Slot, { id: metadata.routeId }));
+					const routeTree = createElement(ElementsContext.Provider, { value: elements }, createElement(Slot, { id: metadata.routeId }));
+					const stateKeyTree = createElement(BfcacheStateKeyMapContext.Provider, { value: createBfcacheSegmentStateKeyMap({
+						elements,
+						pathname: ssrNavigationContext.pathname
+					}) }, routeTree);
+					return BfcacheIdMapContext ? createElement(BfcacheIdMapContext.Provider, { value: createInitialBfcacheIdMap(elements) }, stateKeyTree) : stateKeyTree;
 				}
 				const flightRootElement = createElement(VinextFlightRoot);
 				const root = AppRouterContext ? createElement(AppRouterContext.Provider, { value: appRouterInstance }, flightRootElement) : flightRootElement;
@@ -162,7 +182,15 @@ async function handleSsr(rscStream, navContext, fontData, options) {
 				const ssrRoot = withScriptNonce(createElement(BeforeInteractiveContext.Provider, { value: registerBeforeInteractiveInlineScript }, ssrTree), options?.scriptNonce);
 				const bootstrapModuleUrl = extractBootstrapModuleUrl(await import.meta.viteRsc.loadBootstrapScriptContent("index"));
 				const errorMetaRenderer = createSsrErrorMetaRenderer({ basePath: options?.basePath });
+				let reactLinkHeader = "";
+				const maxHeadersLength = options?.reactMaxHeadersLength ?? DEFAULT_REACT_MAX_HEADERS_LENGTH;
+				const captureHeaders = maxHeadersLength > 0;
 				const htmlStream = await renderToReadableStream(ssrRoot, {
+					onHeaders: captureHeaders ? (headers) => {
+						const link = headers.get("Link");
+						if (link) reactLinkHeader = link;
+					} : void 0,
+					maxHeadersLength: captureHeaders ? maxHeadersLength : void 0,
 					bootstrapModules: bootstrapModuleUrl ? [bootstrapModuleUrl] : void 0,
 					formState: options?.formState ?? null,
 					nonce: options?.scriptNonce,
@@ -172,7 +200,6 @@ async function handleSsr(rscStream, navContext, fontData, options) {
 						if (process.env.NODE_ENV === "production" && error) return ssrErrorDigest(getErrorMessage(error) + (error instanceof Error ? error.stack ?? "" : ""));
 					}
 				});
-				if (options?.waitForAllReady === true) await htmlStream.allReady;
 				const inlineCssManifest = globalThis.__VINEXT_INLINE_CSS__;
 				const fontStyles = fontData?.styles ?? [];
 				const mergeFontStylesIntoInlineCss = fontStyles.length > 0 && hasInlineCssManifest(inlineCssManifest);
@@ -188,12 +215,19 @@ async function handleSsr(rscStream, navContext, fontData, options) {
 				const getInsertedHTML = () => {
 					const insertedHTML = renderInsertedHtml(renderServerInsertedHTML());
 					const errorMetaHTML = errorMetaRenderer.flush();
+					const initialDevServerErrorHTML = createInitialDevServerErrorScript(options?.initialDevServerError, options?.scriptNonce);
 					if (didInjectHeadHTML) return insertedHTML + errorMetaHTML;
 					didInjectHeadHTML = true;
-					return buildHeadInjectionHtml(navContext, bootstrapModuleUrl, options?.formState ?? null, insertedHTML + errorMetaHTML + getTraceMetaHTML(), fontHTML, options?.scriptNonce);
+					return buildHeadInjectionHtml(ssrNavigationContext, bootstrapModuleUrl, options?.formState ?? null, insertedHTML + errorMetaHTML + getTraceMetaHTML() + initialDevServerErrorHTML, fontHTML, options?.scriptNonce);
 				};
 				const getBeforeInteractiveHeadHTML = () => renderBeforeInteractiveInlineScripts(beforeInteractiveInlineScripts);
-				return deferUntilStreamConsumed(htmlStream.pipeThrough(createTickBufferedTransform(rscEmbed, getInsertedHTML, getBeforeInteractiveHeadHTML, inlineCssManifest, inlineCssFontStyles, inlineCssFontStyleFallbackHTML, options?.scriptNonce)), cleanup);
+				if (options?.waitForAllReady === true) await htmlStream.allReady;
+				return {
+					htmlStream: deferUntilStreamConsumed(htmlStream.pipeThrough(createTickBufferedTransform(rscEmbed, getInsertedHTML, getBeforeInteractiveHeadHTML, inlineCssManifest, inlineCssFontStyles, inlineCssFontStyleFallbackHTML, options?.scriptNonce)), cleanup),
+					metadataReady: Promise.resolve(),
+					capturedRscData: options?.capturedRscDataRef?.value ?? null,
+					linkHeader: reactLinkHeader
+				};
 			} catch (error) {
 				cleanup();
 				throw error;
@@ -210,5 +244,3 @@ var app_ssr_entry_default = { async fetch(request) {
 } };
 //#endregion
 export { app_ssr_entry_default as default, handleSsr };
-
-//# sourceMappingURL=app-ssr-entry.js.map

package/dist/server/app-ssr-error-meta.d.ts

@@ -10,5 +10,4 @@ type SsrErrorMetaRenderer = {
 declare function renderSsrErrorMetaTags(errors: readonly unknown[], options?: SsrErrorMetaRenderOptions): string;
 declare function createSsrErrorMetaRenderer(options?: SsrErrorMetaRenderOptions): SsrErrorMetaRenderer;
 //#endregion
-export { createSsrErrorMetaRenderer, renderSsrErrorMetaTags };
-//# sourceMappingURL=app-ssr-error-meta.d.ts.map
+export { createSsrErrorMetaRenderer, renderSsrErrorMetaTags };

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

@@ -46,5 +46,3 @@ function createSsrErrorMetaRenderer(options = {}) {
 }
 //#endregion
 export { createSsrErrorMetaRenderer, renderSsrErrorMetaTags };
-
-//# sourceMappingURL=app-ssr-error-meta.js.map

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

@@ -57,5 +57,4 @@ declare function fixPreloadAs(html: string): string;
  */
 declare function createTickBufferedTransform(rscEmbed: RscEmbedTransform, injectHTML?: HtmlInsertion, injectAfterHeadOpenHTML?: HtmlInsertion, inlineCssManifest?: InlineCssManifest, inlineCssPrependCss?: string, inlineCssPrependFallbackHTML?: string, inlineCssScriptNonce?: string): TransformStream<Uint8Array, Uint8Array>;
 //#endregion
-export { createNavigationRuntimeRscMetadataScript, createRscEmbedTransform, createTickBufferedTransform, fixFlightHints, fixPreloadAs, navigationRuntimeRscBootstrapExpression };
-//# sourceMappingURL=app-ssr-stream.d.ts.map
+export { createNavigationRuntimeRscMetadataScript, createRscEmbedTransform, createTickBufferedTransform, fixFlightHints, fixPreloadAs, navigationRuntimeRscBootstrapExpression };

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

@@ -218,6 +218,18 @@ function rewriteInlineCssStylesheetLinks(html, inlineCssManifest, prependCss, ss
 */
 const HEAD_OPEN_RE = /<head\b[^>]*>/;
 /**
+* Final closing tags of the streamed HTML document. We track this suffix
+* separately so we can move it to the very end of the stream — trailing flight
+* chunks and preinit scripts emitted by `rscEmbed.finalize()` are appended in
+* `flush()`, which would otherwise land them after `</body></html>` and break
+* any consumer that asserts the document terminates with a well-formed close.
+*
+* Ported from Next.js: packages/next/src/server/stream-utils/node-web-streams-helper.ts
+* https://github.com/vercel/next.js/blob/canary/packages/next/src/server/stream-utils/node-web-streams-helper.ts
+* (see `createMoveSuffixStream` and `CLOSE_TAG`)
+*/
+const DOCUMENT_CLOSE_SUFFIX = "</body></html>";
+/**
 * Create the tick-buffered HTML transform that injects RSC scripts between
 * React Fizz flush cycles without corrupting split HTML chunks.
 *
@@ -250,10 +262,26 @@ function createTickBufferedTransform(rscEmbed, injectHTML = "", injectAfterHeadO
 	const insertsPerFlush = typeof injectHTML === "function";
 	let injected = false;
 	let preHeadInjected = false;
+	let suffixStripped = false;
 	let buffered = [];
 	let pendingHtml = "";
 	let timeoutId = null;
 	const hasInlineCssManifest = inlineCssManifest !== void 0 && Object.keys(inlineCssManifest).length > 0;
+	/**
+	* Strip the first occurrence of `</body></html>` from `chunk` so it can be
+	* re-emitted at the very end of the stream. Returns the rewritten chunk and
+	* a flag indicating whether a suffix was found. If `suffixStripped` is
+	* already true (i.e. an earlier chunk contained the suffix), this is a
+	* no-op — additional matches in later chunks shouldn't happen in practice,
+	* but we leave them alone to avoid corrupting unexpected output.
+	*/
+	const stripDocumentCloseSuffix = (chunk) => {
+		if (suffixStripped) return chunk;
+		const index = chunk.indexOf(DOCUMENT_CLOSE_SUFFIX);
+		if (index === -1) return chunk;
+		suffixStripped = true;
+		return chunk.slice(0, index) + chunk.slice(index + 14);
+	};
 	const readInsertion = () => typeof injectHTML === "function" ? injectHTML() : injectHTML;
 	const readPreHeadInsertion = () => typeof injectAfterHeadOpenHTML === "function" ? injectAfterHeadOpenHTML() : injectAfterHeadOpenHTML;
 	const readInlineCssPrependFallback = () => {
@@ -328,12 +356,13 @@ function createTickBufferedTransform(rscEmbed, injectHTML = "", injectAfterHeadO
 			const headEnd = working.indexOf("</head>");
 			if (headEnd !== -1) {
 				const before = working.slice(0, headEnd);
-				const after = working.slice(headEnd);
+				const after = stripDocumentCloseSuffix(working.slice(headEnd));
 				controller.enqueue(encoder.encode(before + readInlineCssPrependFallback() + readInsertion() + after));
 				injected = true;
 				return;
 			}
 		}
+		working = stripDocumentCloseSuffix(working);
 		controller.enqueue(encoder.encode(working));
 	};
 	return new TransformStream({
@@ -363,10 +392,9 @@ function createTickBufferedTransform(rscEmbed, injectHTML = "", injectAfterHeadO
 			} else if (insertsPerFlush) emitInsertion(controller);
 			const finalScripts = await rscEmbed.finalize();
 			if (finalScripts) controller.enqueue(encoder.encode(finalScripts));
+			controller.enqueue(encoder.encode(DOCUMENT_CLOSE_SUFFIX));
 		}
 	});
 }
 //#endregion
 export { createNavigationRuntimeRscMetadataScript, createRscEmbedTransform, createTickBufferedTransform, fixFlightHints, fixPreloadAs, navigationRuntimeRscBootstrapExpression };
-
-//# sourceMappingURL=app-ssr-stream.js.map

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

@@ -12,5 +12,4 @@ declare function getAppPageStaticGenerationErrorMessage(): string;
 declare function getAppRouteStaticGenerationErrorMessage(routePattern?: string, expression?: string): string;
 declare function createStaticGenerationHeadersContext(options: CreateStaticGenerationHeadersContextOptions): HeadersContext;
 //#endregion
-export { createStaticGenerationHeadersContext, getAppPageStaticGenerationErrorMessage, getAppRouteStaticGenerationErrorMessage };
-//# sourceMappingURL=app-static-generation.d.ts.map
+export { createStaticGenerationHeadersContext, getAppPageStaticGenerationErrorMessage, getAppRouteStaticGenerationErrorMessage };

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

@@ -17,5 +17,3 @@ function createStaticGenerationHeadersContext(options) {
 }
 //#endregion
 export { createStaticGenerationHeadersContext, getAppPageStaticGenerationErrorMessage, getAppRouteStaticGenerationErrorMessage };
-
-//# sourceMappingURL=app-static-generation.js.map

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

@@ -0,0 +1,23 @@
+import { CachedRscResponse } from "../shims/navigation.js";
+
+//#region src/server/app-visited-response-cache.d.ts
+type VisitedResponseCacheNavigationKind = "navigate" | "refresh" | "traverse";
+type VisitedResponseCacheEntry = {
+  createdAt: number;
+  expiresAt: number;
+  params: Record<string, string | string[]>;
+  response: CachedRscResponse;
+};
+declare const VISITED_RESPONSE_CACHE_TTL: number;
+declare const MAX_TRAVERSAL_CACHE_TTL: number;
+declare function createVisitedResponseCacheEntry(options: {
+  now: number;
+  params: Record<string, string | string[]>;
+  response: CachedRscResponse;
+}): VisitedResponseCacheEntry;
+declare function isVisitedResponseCacheEntryFresh(entry: VisitedResponseCacheEntry, options: {
+  navigationKind: VisitedResponseCacheNavigationKind;
+  now: number;
+}): boolean;
+//#endregion
+export { MAX_TRAVERSAL_CACHE_TTL, VISITED_RESPONSE_CACHE_TTL, VisitedResponseCacheEntry, createVisitedResponseCacheEntry, isVisitedResponseCacheEntryFresh };

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

@@ -0,0 +1,19 @@
+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;
+function createVisitedResponseCacheEntry(options) {
+	return {
+		createdAt: options.now,
+		expiresAt: resolveCachedRscResponseExpiresAt(options.now, options.response, VISITED_RESPONSE_CACHE_TTL),
+		params: options.params,
+		response: options.response
+	};
+}
+function isVisitedResponseCacheEntryFresh(entry, options) {
+	if (options.navigationKind === "refresh") return false;
+	if (options.navigationKind === "traverse") return options.now - entry.createdAt < MAX_TRAVERSAL_CACHE_TTL;
+	return entry.expiresAt > options.now;
+}
+//#endregion
+export { MAX_TRAVERSAL_CACHE_TTL, VISITED_RESPONSE_CACHE_TTL, createVisitedResponseCacheEntry, isVisitedResponseCacheEntryFresh };

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

@@ -51,5 +51,4 @@ declare function createArtifactCompatibilityGraphVersion(input: ArtifactCompatib
 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, ArtifactCompatibilityMap, ArtifactCompatibilitySet, RSC_PAYLOAD_SCHEMA_VERSION, createArtifactCompatibilityEnvelope, createArtifactCompatibilityGraphVersion, evaluateArtifactCompatibility, parseArtifactCompatibilityEnvelope };
-//# sourceMappingURL=artifact-compatibility.d.ts.map
+export { APP_ELEMENTS_SCHEMA_VERSION, ARTIFACT_COMPATIBILITY_PROOF_FIELDS, ARTIFACT_COMPATIBILITY_SCHEMA_VERSION, ArtifactCompatibilityEnvelope, ArtifactCompatibilityEvaluationOptions, RSC_PAYLOAD_SCHEMA_VERSION, createArtifactCompatibilityEnvelope, createArtifactCompatibilityGraphVersion, evaluateArtifactCompatibility, parseArtifactCompatibilityEnvelope };

package/dist/server/artifact-compatibility.js

@@ -1,4 +1,5 @@
 import { fnv1a64 } from "../utils/hash.js";
+import { isUnknownRecord } from "../utils/record.js";
 //#region src/server/artifact-compatibility.ts
 const ARTIFACT_COMPATIBILITY_SCHEMA_VERSION = 1;
 const APP_ELEMENTS_SCHEMA_VERSION = 1;
@@ -26,9 +27,6 @@ function createArtifactCompatibilityEnvelope(input = {}) {
 function createArtifactCompatibilityGraphVersion(input) {
 	return `app-route-graph:${fnv1a64(JSON.stringify([input.routePattern, input.rootBoundaryId]))}`;
 }
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 function isStringOrNull(value) {
 	return typeof value === "string" || value === null;
 }
@@ -36,7 +34,7 @@ function hasCurrentSchemaVersions(record) {
 	return record.schemaVersion === 1 && record.appElementsSchemaVersion === 1 && record.rscPayloadSchemaVersion === 1;
 }
 function parseArtifactCompatibilityEnvelope(value) {
-	if (!isRecord(value)) return null;
+	if (!isUnknownRecord(value)) return null;
 	if (!hasCurrentSchemaVersions(value)) return null;
 	if (!isStringOrNull(value.graphVersion)) return null;
 	if (!isStringOrNull(value.deploymentVersion)) return null;
@@ -91,5 +89,3 @@ function evaluateArtifactCompatibility(current, candidate, options = {}) {
 }
 //#endregion
 export { APP_ELEMENTS_SCHEMA_VERSION, ARTIFACT_COMPATIBILITY_PROOF_FIELDS, ARTIFACT_COMPATIBILITY_SCHEMA_VERSION, RSC_PAYLOAD_SCHEMA_VERSION, createArtifactCompatibilityEnvelope, createArtifactCompatibilityGraphVersion, evaluateArtifactCompatibility, parseArtifactCompatibilityEnvelope };
-
-//# sourceMappingURL=artifact-compatibility.js.map

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

@@ -1,7 +1,21 @@
+import { CdnCacheableHeaderInput } 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 STATIC_CACHE_CONTROL = "s-maxage=31536000, stale-while-revalidate";
 declare const NO_STORE_CACHE_CONTROL = "no-store, must-revalidate";
+/**
+ * Route a cacheable response's headers through the active CDN cache adapter and
+ * apply the result to `headers`. The default adapter yields a single
+ * `Cache-Control` identical to `input.cacheControl` (no behavior change); edge
+ * adapters may instead emit `CDN-Cache-Control` / `Cache-Tag`.
+ *
+ * We only clear `Cache-Control` — the one header vinext stamps internally — so
+ * a stale vinext value never lingers if an adapter chooses not to emit one. The
+ * adapter's own headers are applied via `set()`, which overrides any prior value
+ * for the same name, so there's no need to pre-clear adapter-specific headers.
+ */
+declare function applyCdnResponseHeaders(headers: Headers, input: CdnCacheableHeaderInput): void;
 /**
  * Matches Next.js's `getCacheControlHeader` stale window semantics while
  * preserving vinext's legacy unbounded SWR header when no expire ceiling is
@@ -20,5 +34,4 @@ declare function buildRevalidateCacheControl(revalidateSeconds: number, expireSe
  */
 declare function buildCachedRevalidateCacheControl(cacheState: "HIT" | "STALE", revalidateSeconds: number, expireSeconds?: number): string;
 //#endregion
-export { NEVER_CACHE_CONTROL, NO_STORE_CACHE_CONTROL, STATIC_CACHE_CONTROL, buildCachedRevalidateCacheControl, buildRevalidateCacheControl };
-//# sourceMappingURL=cache-control.d.ts.map
+export { NEVER_CACHE_CONTROL, NO_STORE_CACHE_CONTROL, STATIC_CACHE_CONTROL, applyCdnResponseHeaders, buildCachedRevalidateCacheControl, buildRevalidateCacheControl };

package/dist/server/cache-control.js

@@ -1,9 +1,29 @@
+import { getCdnCacheAdapter } from "../shims/cdn-cache.js";
 //#region src/server/cache-control.ts
 const NEVER_CACHE_CONTROL = "private, no-cache, no-store, max-age=0, must-revalidate";
 const STATIC_CACHE_CONTROL = "s-maxage=31536000, stale-while-revalidate";
 const STALE_REVALIDATE_CACHE_CONTROL = "s-maxage=0, stale-while-revalidate";
 const NO_STORE_CACHE_CONTROL = "no-store, must-revalidate";
 /**
+* Route a cacheable response's headers through the active CDN cache adapter and
+* apply the result to `headers`. The default adapter yields a single
+* `Cache-Control` identical to `input.cacheControl` (no behavior change); edge
+* adapters may instead emit `CDN-Cache-Control` / `Cache-Tag`.
+*
+* We only clear `Cache-Control` — the one header vinext stamps internally — so
+* a stale vinext value never lingers if an adapter chooses not to emit one. The
+* adapter's own headers are applied via `set()`, which overrides any prior value
+* for the same name, so there's no need to pre-clear adapter-specific headers.
+*/
+function applyCdnResponseHeaders(headers, input) {
+	headers.delete("Cache-Control");
+	const map = getCdnCacheAdapter().buildResponseHeaders(input);
+	for (const [name, value] of Object.entries(map)) {
+		if (value === "") continue;
+		headers.set(name, value);
+	}
+}
+/**
 * Matches Next.js's `getCacheControlHeader` stale window semantics while
 * preserving vinext's legacy unbounded SWR header when no expire ceiling is
 * available yet.
@@ -29,6 +49,4 @@ function buildCachedRevalidateCacheControl(cacheState, revalidateSeconds, expire
 	return buildRevalidateCacheControl(revalidateSeconds, expireSeconds);
 }
 //#endregion
-export { NEVER_CACHE_CONTROL, NO_STORE_CACHE_CONTROL, STATIC_CACHE_CONTROL, buildCachedRevalidateCacheControl, buildRevalidateCacheControl };
-
-//# sourceMappingURL=cache-control.js.map
+export { NEVER_CACHE_CONTROL, NO_STORE_CACHE_CONTROL, STATIC_CACHE_CONTROL, applyCdnResponseHeaders, buildCachedRevalidateCacheControl, buildRevalidateCacheControl };

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

@@ -3,5 +3,4 @@ type VinextCacheState = "HIT" | "MISS" | "STALE" | "STATIC";
 declare function setCacheStateHeaders(headers: Headers, cacheState: VinextCacheState): void;
 declare function buildCacheStateHeaders(cacheState: VinextCacheState): Record<string, string>;
 //#endregion
-export { buildCacheStateHeaders, setCacheStateHeaders };
-//# sourceMappingURL=cache-headers.d.ts.map
+export { buildCacheStateHeaders, setCacheStateHeaders };

package/dist/server/cache-headers.js

@@ -15,5 +15,3 @@ function buildCacheStateHeaders(cacheState) {
 }
 //#endregion
 export { buildCacheStateHeaders, setCacheStateHeaders };
-
-//# sourceMappingURL=cache-headers.js.map

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

@@ -361,5 +361,4 @@ declare function createStaticLayoutArtifactReuseDecision(input: CreateStaticLayo
 declare function createCacheEntryReuseProof(decision: StaticLayoutArtifactReuseDecision | null): CacheEntryReuseProof;
 declare function createDisabledCacheProofDecision(input: CreateDisabledCacheProofDecisionInput): DisabledCacheProofDecision;
 //#endregion
-export { ALL_RENDER_REQUEST_API_KINDS, AppRouteCacheProofGraphScope, AppRouteCacheProofGraphScopeInput, BoundaryOutcome, BoundaryOutcomeCompatibility, BuildCacheVariantInput, BuildCacheVariantResult, BuildCacheVariantWithRouteBudgetInput, BuildCacheVariantWithRouteBudgetResult, BuildRenderObservationInput, BuildRenderRequestApiObservationsInput, BuildStaticLayoutReuseProofInput, BuildStaticLayoutReuseProofResult, CACHE_PROOF_MODEL_SCHEMA_VERSION, CacheEntryReuseDecision, CacheEntryReuseProof, CacheProofAcceptanceCode, CacheProofBreakerFallback, CacheProofBreakerFallbackMode, CacheProofDowngradeClassification, CacheProofDowngradeReason, CacheProofDowngradeTarget, CacheProofFallbackScope, CacheProofHotPathMetric, CacheProofModelSchemaVersion, CacheProofOutputScope, CacheProofRejectionCode, CacheProofTraceCode, CacheProofTraceFieldValue, CacheProofTraceFields, CacheVariant, CacheVariantBudget, CacheVariantDimension, CacheVariantDimensionInput, CacheVariantDimensionPrivacy, CacheVariantDimensionSource, CacheVariantRouteBudget, CacheVariantRouteBudgetAdmission, ClassifyCacheVariantDimensionDowngradeInput, ClassifyRenderObservationDowngradeInput, CreateDisabledCacheProofDecisionInput, CreateStaticLayoutArtifactReuseDecisionInput, DEFAULT_CACHE_VARIANT_BUDGET, DisabledCacheProofDecision, RenderCacheability, RenderObservation, RenderObservationCompleteness, RenderRequestApiKind, RenderRequestApiObservation, RenderRequestApiStatus, StaticLayoutArtifactReuseDecision, StaticLayoutArtifactReuseProof, StaticLayoutCacheProofOutputScope, StaticLayoutReuseProof, buildBoundaryOutcomeCompatibility, buildCacheVariant, buildCacheVariantWithRouteBudget, buildRenderObservation, buildRenderRequestApiObservations, buildStaticLayoutReuseProof, classifyCacheVariantDimensionDowngrade, classifyRenderObservationDowngrade, createAppRouteCacheProofGraphScope, createCacheEntryReuseProof, createDisabledCacheProofDecision, createStaticLayoutArtifactReuseDecision, enforceCacheVariantRouteBudget, hasCompleteNegativeRequestApiProof };
-//# sourceMappingURL=cache-proof.d.ts.map
+export { ALL_RENDER_REQUEST_API_KINDS, AppRouteCacheProofGraphScope, AppRouteCacheProofGraphScopeInput, BoundaryOutcome, BoundaryOutcomeCompatibility, BuildCacheVariantInput, BuildCacheVariantResult, BuildCacheVariantWithRouteBudgetInput, BuildCacheVariantWithRouteBudgetResult, BuildRenderObservationInput, BuildRenderRequestApiObservationsInput, BuildStaticLayoutReuseProofInput, BuildStaticLayoutReuseProofResult, CACHE_PROOF_MODEL_SCHEMA_VERSION, CacheEntryReuseDecision, CacheEntryReuseProof, CacheProofAcceptanceCode, CacheProofBreakerFallback, CacheProofBreakerFallbackMode, CacheProofDowngradeClassification, CacheProofDowngradeReason, CacheProofDowngradeTarget, CacheProofFallbackScope, CacheProofHotPathMetric, CacheProofModelSchemaVersion, CacheProofOutputScope, CacheProofRejectionCode, CacheProofTraceCode, CacheProofTraceFieldValue, CacheProofTraceFields, CacheVariant, CacheVariantBudget, CacheVariantDimension, CacheVariantDimensionInput, CacheVariantDimensionPrivacy, CacheVariantDimensionSource, CacheVariantRouteBudget, CacheVariantRouteBudgetAdmission, ClassifyCacheVariantDimensionDowngradeInput, ClassifyRenderObservationDowngradeInput, CreateDisabledCacheProofDecisionInput, CreateStaticLayoutArtifactReuseDecisionInput, DEFAULT_CACHE_VARIANT_BUDGET, DisabledCacheProofDecision, RenderCacheability, RenderObservation, RenderObservationCompleteness, RenderRequestApiKind, RenderRequestApiObservation, RenderRequestApiStatus, StaticLayoutArtifactReuseDecision, StaticLayoutArtifactReuseProof, StaticLayoutCacheProofOutputScope, StaticLayoutReuseProof, buildBoundaryOutcomeCompatibility, buildCacheVariant, buildCacheVariantWithRouteBudget, buildRenderObservation, buildRenderRequestApiObservations, buildStaticLayoutReuseProof, classifyCacheVariantDimensionDowngrade, classifyRenderObservationDowngrade, createAppRouteCacheProofGraphScope, createCacheEntryReuseProof, createDisabledCacheProofDecision, createStaticLayoutArtifactReuseDecision, enforceCacheVariantRouteBudget, hasCompleteNegativeRequestApiProof };