vinext 0.2.0 → 0.2.1

package/dist/server/dev-server.js

@@ -1,5 +1,5 @@
 import { createRequestContext, runWithRequestContext } from "../shims/unified-request-context.js";
-import { createValidFileMatcher, findFileWithExtensions } from "../routing/file-matcher.js";
+import { createValidFileMatcher, findFileWithExtensions, findFileWithExts } from "../routing/file-matcher.js";
 import { patternToNextFormat } from "../routing/route-validation.js";
 import { matchRoute } from "../routing/pages-router.js";
 import { NEXTJS_DEPLOYMENT_ID_HEADER } from "./headers.js";
@@ -17,7 +17,7 @@ import "../shims/router-state.js";
 import { runWithHeadState } from "../shims/head-state.js";
 import { runWithServerInsertedHTMLState } from "../shims/navigation-state.js";
 import { withScriptNonce } from "../shims/script-nonce-context.js";
-import { createInlineScriptTag, createNonceAttribute, safeJsonStringify } from "./html.js";
+import { createInlineScriptTag, createNonceAttribute, escapeHtmlAttr, safeJsonStringify } from "./html.js";
 import { getClientTraceMetadataHTML } from "./client-trace-metadata.js";
 import { getScriptNonceFromNodeHeaderSources } from "./csp.js";
 import { logRequest, now } from "./request-log.js";
@@ -31,8 +31,9 @@ import { hasPagesGetInitialProps, loadDevAppInitialProps, loadPagesGetInitialPro
 import { isSerializableProps } from "./pages-serializable-props.js";
 import { isBotUserAgent } from "../utils/html-limited-bots.js";
 import { getPagesRouteParams, matchesPagesStaticPath } from "./pages-page-data.js";
-import { createPagesDevModuleUrl } from "./pages-dev-module-url.js";
-import { attachPagesRequestCookies } from "./pages-node-compat.js";
+import { createPagesDevAssetUrl, createPagesDevModuleUrl } from "./pages-dev-module-url.js";
+import { getManifestFilesForModule } from "./pages-asset-tags.js";
+import { attachPagesRequestCookies, getPagesPreviewDataFromCookieHeader } from "./pages-node-compat.js";
 import path from "node:path";
 import React from "react";
 import { renderToReadableStream } from "react-dom/server.edge";
@@ -52,6 +53,35 @@ async function renderToStringAsync(element) {
 async function renderIsrPassToStringAsync(element) {
 	return await runWithServerInsertedHTMLState(() => runWithHeadState(() => _runWithCacheState(() => runWithPrivateCache(() => runWithFetchCache(async () => renderToStringAsync(element))))));
 }
+const DEV_STYLESHEET_ASSET_RE = /\.(?:css|scss|sass)$/i;
+function createDevInitialStylesheetHeadHTML(options) {
+	const { ssrManifest, moduleIds, nonceAttr } = options;
+	if (!ssrManifest || moduleIds.length === 0) return "";
+	const seen = /* @__PURE__ */ new Set();
+	let html = "";
+	for (const moduleId of moduleIds) {
+		const files = getManifestFilesForModule(ssrManifest, moduleId);
+		if (!files) continue;
+		for (const file of files) {
+			if (!DEV_STYLESHEET_ASSET_RE.test(file) || seen.has(file)) continue;
+			seen.add(file);
+			const href = createPagesDevAssetUrl(file);
+			html += `<link rel="stylesheet"${nonceAttr} href="${escapeHtmlAttr(href)}" />\n  `;
+		}
+	}
+	return html;
+}
+async function collectDevInitialStylesheetHeadHTML(runner, moduleIds, nonceAttr) {
+	try {
+		return createDevInitialStylesheetHeadHTML({
+			ssrManifest: (await runner.import("virtual:vinext-pages-client-assets")).default?.ssrManifest,
+			moduleIds,
+			nonceAttr
+		});
+	} catch {
+		return "";
+	}
+}
 /**
 * Emit a `getServerSideProps` / `getStaticProps` `{ redirect }` result.
 *
@@ -102,7 +132,7 @@ const STREAM_BODY_MARKER = "<!--VINEXT_STREAM_BODY-->";
 * shell sooner).
 */
 async function streamPageToResponse(res, element, options) {
-	const { url, server, fontHeadHTML, scripts, DocumentComponent, statusCode, extraHeaders, getHeadHTML, enhancePageElement, scriptNonce, documentContext, setDocumentInitialHead, bufferBodyBeforeHeaders = false } = options;
+	const { url, server, fontHeadHTML, assetHeadHTML = "", scripts, DocumentComponent, statusCode, extraHeaders, getHeadHTML, enhancePageElement, scriptNonce, documentContext, setDocumentInitialHead, bufferBodyBeforeHeaders = false } = options;
 	const documentRenderPage = await runDocumentRenderPage({
 		DocumentComponent,
 		enhancePageElement,
@@ -129,7 +159,7 @@ async function streamPageToResponse(res, element, options) {
 		const docProps = documentRenderPage.status === "skipped" ? await loadUserDocumentInitialProps(DocumentComponent) : documentRenderPage.docProps;
 		let docHtml = await renderToStringAsync(docProps ? React.createElement(DocumentComponent, docProps) : React.createElement(DocumentComponent));
 		docHtml = docHtml.replace("__NEXT_MAIN__", STREAM_BODY_MARKER);
-		if (headHTML || fontHeadHTML) docHtml = docHtml.replace("</head>", `  ${fontHeadHTML}${headHTML}\n</head>`);
+		if (headHTML || fontHeadHTML || assetHeadHTML) docHtml = docHtml.replace("</head>", `  ${fontHeadHTML}${headHTML}\n  ${assetHeadHTML}\n</head>`);
 		docHtml = docHtml.replace("<!-- __NEXT_SCRIPTS__ -->", scripts);
 		if (!docHtml.includes("__NEXT_DATA__")) docHtml = docHtml.replace("</body>", `  ${scripts}\n</body>`);
 		shellTemplate = docHtml;
@@ -137,6 +167,7 @@ async function streamPageToResponse(res, element, options) {
 <html>
 <head>
   ${fontHeadHTML}${headHTML}
+  ${assetHeadHTML}
 </head>
 <body>
   <div id="__next">${STREAM_BODY_MARKER}</div>
@@ -204,7 +235,7 @@ function parseCookieLocale(req, i18nConfig) {
 * 4. Render the component to HTML
 * 5. Wrap in _document shell and send response
 */
-function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatcher, basePath = "", trailingSlash = false, hasMiddleware = false, hasRewrites = false, clientTraceMetadata, htmlLimitedBots) {
+function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatcher, basePath = "", trailingSlash = false, hasMiddleware = false, hasRewrites = false, clientTraceMetadata, htmlLimitedBots, reactStrictMode = false) {
 	const matcher = fileMatcher ?? createValidFileMatcher();
 	const pagePatterns = routes.map((r) => patternToNextFormat(r.pattern));
 	const _alsRegistration = Promise.all([runner.import("vinext/head-state"), runner.import("vinext/router-state")]);
@@ -337,6 +368,7 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 				let isrRevalidateSeconds = null;
 				let isFallbackRender = false;
 				let shouldPersistFallbackData = false;
+				let staticPropsPreviewData = false;
 				if (typeof pageModule.getStaticPaths === "function" && route.isDynamic) {
 					const pathsResult = await pageModule.getStaticPaths({
 						locales: i18nConfig?.locales ?? [],
@@ -416,6 +448,12 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 						__N_SSP: true
 					};
 					const headersBeforeGSSP = new Set(Object.keys(res.getHeaders()));
+					const previewData = getPagesPreviewDataFromCookieHeader(req.headers.cookie);
+					const previewContext = previewData === false ? {} : {
+						draftMode: true,
+						preview: true,
+						previewData
+					};
 					const context = {
 						params: userFacingParams,
 						req,
@@ -424,7 +462,8 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 						resolvedUrl: gsspResolvedUrl,
 						locale: locale ?? currentDefaultLocale,
 						locales: i18nConfig?.locales,
-						defaultLocale: currentDefaultLocale
+						defaultLocale: currentDefaultLocale,
+						...previewContext
 					};
 					const result = await pageModule.getServerSideProps(context);
 					if (res.writableEnded) return;
@@ -480,7 +519,14 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 					const cacheKey = pagesIsrCacheKey(url.split("?")[0]);
 					const cached = await isrGet(cacheKey);
 					const isOnDemandRevalidate = isOnDemandRevalidateRequest(req.headers[PRERENDER_REVALIDATE_HEADER]);
-					if (!isOnDemandRevalidate && cached && !cached.isStale && cached.value.value?.kind === "PAGES" && !cached.value.value.generatedFromDataRequest && !scriptNonce && !isDataReq) {
+					const previewData = getPagesPreviewDataFromCookieHeader(req.headers.cookie, { isOnDemandRevalidate });
+					staticPropsPreviewData = previewData;
+					const previewContext = previewData === false ? {} : {
+						draftMode: true,
+						preview: true,
+						previewData
+					};
+					if (!isOnDemandRevalidate && cached && !cached.isStale && cached.value.value?.kind === "PAGES" && !cached.value.value.generatedFromDataRequest && !scriptNonce && !isDataReq && previewData === false) {
 						const cachedHtml = cached.value.value.html;
 						const transformedHtml = await server.transformIndexHtml(url, cachedHtml);
 						const { cacheControl: hitCacheControl } = decideIsr({
@@ -498,7 +544,7 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 						res.end(transformedHtml);
 						return;
 					}
-					if (!isOnDemandRevalidate && cached && cached.isStale && cached.value.value?.kind === "PAGES" && !cached.value.value.generatedFromDataRequest && !scriptNonce && !isDataReq) {
+					if (!isOnDemandRevalidate && cached && cached.isStale && cached.value.value?.kind === "PAGES" && !cached.value.value.generatedFromDataRequest && !scriptNonce && !isDataReq && previewData === false) {
 						const cachedHtml = cached.value.value.html;
 						const transformedHtml = await server.transformIndexHtml(url, cachedHtml);
 						triggerBackgroundRegeneration(cacheKey, async () => {
@@ -677,9 +723,10 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 						locale: locale ?? currentDefaultLocale,
 						locales: i18nConfig?.locales,
 						defaultLocale: currentDefaultLocale,
-						revalidateReason: isOnDemandRevalidate ? "on-demand" : "stale"
+						revalidateReason: isOnDemandRevalidate ? "on-demand" : "stale",
+						...previewContext
 					};
-					const generatedPageData = !isOnDemandRevalidate && cached?.isStale === false && cached?.value.value?.kind === "PAGES" && cached.value.value.generatedFromDataRequest && isUnknownRecord(cached.value.value.pageData) ? cached.value.value.pageData : null;
+					const generatedPageData = !isOnDemandRevalidate && previewData === false && cached?.isStale === false && cached?.value.value?.kind === "PAGES" && cached.value.value.generatedFromDataRequest && isUnknownRecord(cached.value.value.pageData) ? cached.value.value.pageData : null;
 					if (!generatedPageData && await loadAppInitialProps()) return;
 					const result = generatedPageData ? null : await pageModule.getStaticProps(context);
 					if (generatedPageData) {
@@ -713,8 +760,8 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 						return;
 					}
 					if (result && "props" in result) isSerializableProps(patternToNextFormat(route.pattern), "getStaticProps", pageProps);
-					if (typeof result?.revalidate === "number" && result.revalidate > 0) isrRevalidateSeconds = result.revalidate;
-					else if (cached?.value.value?.kind === "PAGES" && cached.value.value.generatedFromDataRequest) isrRevalidateSeconds = cached.value.cacheControl?.revalidate ?? 31536e3;
+					if (previewData === false && typeof result?.revalidate === "number" && result.revalidate > 0) isrRevalidateSeconds = result.revalidate;
+					else if (previewData === false && cached?.value.value?.kind === "PAGES" && cached.value.value.generatedFromDataRequest) isrRevalidateSeconds = cached.value.cacheControl?.revalidate ?? 31536e3;
 				}
 				if (typeof pageModule.getServerSideProps !== "function" && typeof pageModule.getStaticProps !== "function" && hasAppGetInitialProps) {
 					if (await loadAppInitialProps()) return;
@@ -743,7 +790,7 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 					}
 				}
 				if (isDataReq) {
-					if (shouldPersistFallbackData) {
+					if (shouldPersistFallbackData && staticPropsPreviewData === false) {
 						const cacheKey = pagesIsrCacheKey(url.split("?")[0]);
 						const revalidateSeconds = isrRevalidateSeconds ?? 31536e3;
 						await isrSet(cacheKey, {
@@ -786,6 +833,7 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 				if (typeof dynamicShim.flushPreloads === "function") await dynamicShim.flushPreloads();
 				const nonceAttr = createNonceAttribute(scriptNonce);
 				let fontHeadHTML = "";
+				const assetHeadHTML = await collectDevInitialStylesheetHeadHTML(runner, [AppComponent ? findFileWithExts(pagesDir, "_app", matcher) : null, route.filePath], nonceAttr);
 				const allFontStyles = [];
 				const allFontPreloads = [];
 				try {
@@ -847,6 +895,9 @@ const rawPageProps = props.pageProps;
 const pageProps = rawPageProps && typeof rawPageProps === "object" ? rawPageProps : {};
 window.__VINEXT_PAGE_LOADERS__ = { [nextData.page]: () => import("${pageModuleSource}") };
 window.__VINEXT_APP_LOADER__ = ${appModuleSource ? `() => import("${appModuleSource}")` : "undefined"};
+// reactStrictMode flag — read by wrapWithRouterContext so the <React.StrictMode>
+// wrap is applied on initial hydration and every navigation (matches Next.js).
+window.__VINEXT_REACT_STRICT_MODE__ = ${JSON.stringify(reactStrictMode === true)};
 
 async function hydrate() {
   let hydrateRootOptions;
@@ -923,6 +974,7 @@ hydrate();
 					url,
 					server,
 					fontHeadHTML,
+					assetHeadHTML,
 					scripts: allScripts,
 					DocumentComponent,
 					statusCode,
@@ -969,7 +1021,7 @@ hydrate();
 						pageProps
 					}) : createElement(pageModule.default, pageProps);
 					if (wrapWithRouterContext) isrElement = wrapWithRouterContext(isrElement);
-					const isrHtml = `<!DOCTYPE html><html><head></head><body><div id="__next">${await renderIsrPassToStringAsync(withScriptNonce(isrElement, scriptNonce))}</div>${allScripts}</body></html>`;
+					const isrHtml = `<!DOCTYPE html><html><head>${assetHeadHTML}</head><body><div id="__next">${await renderIsrPassToStringAsync(withScriptNonce(isrElement, scriptNonce))}</div>${allScripts}</body></html>`;
 					const cacheKey = pagesIsrCacheKey(url.split("?")[0]);
 					await isrSet(cacheKey, buildPagesCacheValue(isrHtml, pageProps), isrRevalidateSeconds);
 					setRevalidateDuration(cacheKey, isrRevalidateSeconds);
@@ -1008,14 +1060,15 @@ async function renderErrorPage(server, runner, req, res, url, pagesDir, statusCo
 	const matcher = fileMatcher ?? createValidFileMatcher();
 	const candidates = statusCode === 404 ? ["404", "_error"] : statusCode === 500 ? ["500", "_error"] : ["_error"];
 	for (const candidate of candidates) try {
-		const candidatePath = path.join(pagesDir, candidate);
-		if (!findFileWithExtensions(candidatePath, matcher)) continue;
-		const ErrorComponent = (await importModule(runner, candidatePath)).default;
+		const errorAssetPath = findFileWithExts(pagesDir, candidate, matcher);
+		if (!errorAssetPath) continue;
+		const ErrorComponent = (await importModule(runner, errorAssetPath)).default;
 		if (!ErrorComponent) continue;
 		let AppComponent = null;
 		const appPathErr = path.join(pagesDir, "_app");
+		const appAssetPath = findFileWithExts(pagesDir, "_app", matcher);
 		if (findFileWithExtensions(appPathErr, matcher)) try {
-			AppComponent = (await importModule(runner, appPathErr)).default ?? null;
+			AppComponent = (await importModule(runner, appAssetPath ?? appPathErr)).default ?? null;
 		} catch {}
 		const createElement = React.createElement;
 		const initialErrorProps = await loadPagesGetInitialProps(ErrorComponent, {
@@ -1051,12 +1104,16 @@ async function renderErrorPage(server, runner, req, res, url, pagesDir, statusCo
 		const element = createErrorElement(AppComponent, ErrorComponent);
 		const headShim = await importModule(runner, "next/head");
 		if (typeof headShim.resetSSRHead === "function") headShim.resetSSRHead();
+		const responseHeaders = typeof res.getHeaders === "function" ? res.getHeaders() : void 0;
+		const nonceAttr = createNonceAttribute(getScriptNonceFromNodeHeaderSources(req.headers, responseHeaders));
+		const assetHeadHTML = await collectDevInitialStylesheetHeadHTML(runner, [appAssetPath, errorAssetPath], nonceAttr);
 		if (DocumentComponent) {
 			const errorPathname = candidate === "_error" ? "/_error" : `/${candidate}`;
 			await streamPageToResponse(res, element, {
 				url,
 				server,
 				fontHeadHTML: "",
+				assetHeadHTML,
 				scripts: "",
 				DocumentComponent,
 				statusCode,
@@ -1084,6 +1141,7 @@ async function renderErrorPage(server, runner, req, res, url, pagesDir, statusCo
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1" />
+  ${assetHeadHTML}
 </head>
 <body>
   <div id="__next">${await renderToStringAsync(element)}</div>

package/dist/server/headers.d.ts

@@ -1,4 +1,4 @@
-import { MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_SET_COOKIE_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER } from "../utils/protocol-headers.js";
+import { MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_SET_COOKIE_HEADER, MIDDLEWARE_SKIP_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_SPECULATIVE_HEADER } from "../utils/protocol-headers.js";
 
 //#region src/server/headers.d.ts
 /**
@@ -33,6 +33,10 @@ declare const VINEXT_PARAMS_HEADER = "X-Vinext-Params";
 declare const VINEXT_MOUNTED_SLOTS_HEADER = "X-Vinext-Mounted-Slots";
 /** Per-page dynamic stale time in seconds for App Router RSC responses. */
 declare const VINEXT_DYNAMIC_STALE_TIME_HEADER = "X-Vinext-Dynamic-Stale-Time";
+/** URL-encoded rendered path and search after middleware/config rewrites. */
+declare const VINEXT_RENDERED_PATH_AND_SEARCH_HEADER = "X-Vinext-Rendered-Path-And-Search";
+/** Prerender-only JSON side channel carrying request cacheLife metadata. */
+declare const VINEXT_PRERENDER_CACHE_LIFE_HEADER = "x-vinext-prerender-cache-life";
 /** Route interception context for parallel/intercepting routes. */
 declare const VINEXT_INTERCEPTION_CONTEXT_HEADER = "X-Vinext-Interception-Context";
 /** RSC render mode (e.g. "navigation", "prefetch"). */
@@ -101,4 +105,4 @@ declare const INTERNAL_HEADERS: string[];
 /** Vinext-only internal headers stripped alongside Next.js protocol internals. */
 declare const VINEXT_INTERNAL_HEADERS: string[];
 //#endregion
-export { ACTION_FORWARDED_HEADER, ACTION_REDIRECT_HEADER, ACTION_REDIRECT_STATUS_HEADER, ACTION_REDIRECT_TYPE_HEADER, ACTION_REVALIDATED_HEADER, FLIGHT_HEADERS, INTERNAL_HEADERS, MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_NEXT_HEADER, MIDDLEWARE_REWRITE_HEADER, MIDDLEWARE_SET_COOKIE_HEADER, NEXTJS_ACTION_NOT_FOUND_HEADER, NEXTJS_CACHE_HEADER, NEXTJS_DEPLOYMENT_ID_HEADER, NEXT_ACTION_HEADER, NEXT_HTML_REQUEST_ID_HEADER, NEXT_REQUEST_ID_HEADER, NEXT_ROUTER_PREFETCH_HEADER, NEXT_ROUTER_SEGMENT_PREFETCH_HEADER, NEXT_ROUTER_STATE_TREE_HEADER, NEXT_URL_HEADER, RSC_ACTION_HEADER, RSC_HEADER, VINEXT_CACHE_HEADER, VINEXT_CLIENT_REUSE_MANIFEST_HEADER, VINEXT_DYNAMIC_STALE_TIME_HEADER, VINEXT_INTERCEPTION_CONTEXT_HEADER, VINEXT_INTERNAL_HEADERS, VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PARAMS_HEADER, VINEXT_PRERENDER_PAGES_STATIC_PATHS_PATH, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_STATIC_PARAMS_PATH, VINEXT_REVALIDATE_HEADER, VINEXT_RSC_MARKER_HEADER, VINEXT_RSC_REDIRECT_HEADER, VINEXT_RSC_RENDER_MODE_HEADER, VINEXT_STATIC_FILE_HEADER, VINEXT_TIMING_HEADER };
+export { ACTION_FORWARDED_HEADER, ACTION_REDIRECT_HEADER, ACTION_REDIRECT_STATUS_HEADER, ACTION_REDIRECT_TYPE_HEADER, ACTION_REVALIDATED_HEADER, FLIGHT_HEADERS, INTERNAL_HEADERS, MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_NEXT_HEADER, MIDDLEWARE_REWRITE_HEADER, MIDDLEWARE_SET_COOKIE_HEADER, MIDDLEWARE_SKIP_HEADER, NEXTJS_ACTION_NOT_FOUND_HEADER, NEXTJS_CACHE_HEADER, NEXTJS_DEPLOYMENT_ID_HEADER, NEXT_ACTION_HEADER, NEXT_HTML_REQUEST_ID_HEADER, NEXT_REQUEST_ID_HEADER, NEXT_ROUTER_PREFETCH_HEADER, NEXT_ROUTER_SEGMENT_PREFETCH_HEADER, NEXT_ROUTER_STATE_TREE_HEADER, NEXT_URL_HEADER, RSC_ACTION_HEADER, RSC_HEADER, VINEXT_CACHE_HEADER, VINEXT_CLIENT_REUSE_MANIFEST_HEADER, VINEXT_DYNAMIC_STALE_TIME_HEADER, VINEXT_INTERCEPTION_CONTEXT_HEADER, VINEXT_INTERNAL_HEADERS, VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PARAMS_HEADER, VINEXT_PRERENDER_CACHE_LIFE_HEADER, VINEXT_PRERENDER_PAGES_STATIC_PATHS_PATH, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_SPECULATIVE_HEADER, VINEXT_PRERENDER_STATIC_PARAMS_PATH, VINEXT_RENDERED_PATH_AND_SEARCH_HEADER, VINEXT_REVALIDATE_HEADER, VINEXT_RSC_MARKER_HEADER, VINEXT_RSC_REDIRECT_HEADER, VINEXT_RSC_RENDER_MODE_HEADER, VINEXT_STATIC_FILE_HEADER, VINEXT_TIMING_HEADER };

package/dist/server/headers.js

@@ -1,4 +1,4 @@
-import { MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_OVERRIDE_HEADERS, MIDDLEWARE_SET_COOKIE_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER } from "../utils/protocol-headers.js";
+import { MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_OVERRIDE_HEADERS, MIDDLEWARE_SET_COOKIE_HEADER, MIDDLEWARE_SKIP_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_SPECULATIVE_HEADER } from "../utils/protocol-headers.js";
 //#region src/server/headers.ts
 /**
 * Internal HTTP header name constants used throughout vinext.
@@ -32,6 +32,10 @@ const VINEXT_PARAMS_HEADER = "X-Vinext-Params";
 const VINEXT_MOUNTED_SLOTS_HEADER = "X-Vinext-Mounted-Slots";
 /** Per-page dynamic stale time in seconds for App Router RSC responses. */
 const VINEXT_DYNAMIC_STALE_TIME_HEADER = "X-Vinext-Dynamic-Stale-Time";
+/** URL-encoded rendered path and search after middleware/config rewrites. */
+const VINEXT_RENDERED_PATH_AND_SEARCH_HEADER = "X-Vinext-Rendered-Path-And-Search";
+/** Prerender-only JSON side channel carrying request cacheLife metadata. */
+const VINEXT_PRERENDER_CACHE_LIFE_HEADER = "x-vinext-prerender-cache-life";
 /** Route interception context for parallel/intercepting routes. */
 const VINEXT_INTERCEPTION_CONTEXT_HEADER = "X-Vinext-Interception-Context";
 /** RSC render mode (e.g. "navigation", "prefetch"). */
@@ -82,8 +86,6 @@ const MIDDLEWARE_NEXT_HEADER = "x-middleware-next";
 const MIDDLEWARE_REWRITE_HEADER = "x-middleware-rewrite";
 /** Redirect URL set by middleware. */
 const MIDDLEWARE_REDIRECT_HEADER = "x-middleware-redirect";
-/** Skip-middleware signal. */
-const MIDDLEWARE_SKIP_HEADER = "x-middleware-skip";
 const NEXT_ROUTER_STATE_TREE_HEADER = "Next-Router-State-Tree";
 const NEXT_ROUTER_PREFETCH_HEADER = "Next-Router-Prefetch";
 const NEXT_ROUTER_SEGMENT_PREFETCH_HEADER = "Next-Router-Segment-Prefetch";
@@ -120,6 +122,10 @@ const INTERNAL_HEADERS = [
 	ACTION_FORWARDED_HEADER
 ];
 /** Vinext-only internal headers stripped alongside Next.js protocol internals. */
-const VINEXT_INTERNAL_HEADERS = [VINEXT_PRERENDER_ROUTE_PARAMS_HEADER];
+const VINEXT_INTERNAL_HEADERS = [
+	VINEXT_PRERENDER_ROUTE_PARAMS_HEADER,
+	VINEXT_PRERENDER_SPECULATIVE_HEADER,
+	VINEXT_PRERENDER_CACHE_LIFE_HEADER
+];
 //#endregion
-export { ACTION_FORWARDED_HEADER, ACTION_REDIRECT_HEADER, ACTION_REDIRECT_STATUS_HEADER, ACTION_REDIRECT_TYPE_HEADER, ACTION_REVALIDATED_HEADER, FLIGHT_HEADERS, INTERNAL_HEADERS, MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_NEXT_HEADER, MIDDLEWARE_REWRITE_HEADER, MIDDLEWARE_SET_COOKIE_HEADER, NEXTJS_ACTION_NOT_FOUND_HEADER, NEXTJS_CACHE_HEADER, NEXTJS_DEPLOYMENT_ID_HEADER, NEXT_ACTION_HEADER, NEXT_HTML_REQUEST_ID_HEADER, NEXT_REQUEST_ID_HEADER, NEXT_ROUTER_PREFETCH_HEADER, NEXT_ROUTER_SEGMENT_PREFETCH_HEADER, NEXT_ROUTER_STATE_TREE_HEADER, NEXT_URL_HEADER, RSC_ACTION_HEADER, RSC_HEADER, VINEXT_CACHE_HEADER, VINEXT_CLIENT_REUSE_MANIFEST_HEADER, VINEXT_DYNAMIC_STALE_TIME_HEADER, VINEXT_INTERCEPTION_CONTEXT_HEADER, VINEXT_INTERNAL_HEADERS, VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PARAMS_HEADER, VINEXT_PRERENDER_PAGES_STATIC_PATHS_PATH, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_STATIC_PARAMS_PATH, VINEXT_REVALIDATE_HEADER, VINEXT_RSC_MARKER_HEADER, VINEXT_RSC_REDIRECT_HEADER, VINEXT_RSC_RENDER_MODE_HEADER, VINEXT_STATIC_FILE_HEADER, VINEXT_TIMING_HEADER };
+export { ACTION_FORWARDED_HEADER, ACTION_REDIRECT_HEADER, ACTION_REDIRECT_STATUS_HEADER, ACTION_REDIRECT_TYPE_HEADER, ACTION_REVALIDATED_HEADER, FLIGHT_HEADERS, INTERNAL_HEADERS, MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_NEXT_HEADER, MIDDLEWARE_REWRITE_HEADER, MIDDLEWARE_SET_COOKIE_HEADER, MIDDLEWARE_SKIP_HEADER, NEXTJS_ACTION_NOT_FOUND_HEADER, NEXTJS_CACHE_HEADER, NEXTJS_DEPLOYMENT_ID_HEADER, NEXT_ACTION_HEADER, NEXT_HTML_REQUEST_ID_HEADER, NEXT_REQUEST_ID_HEADER, NEXT_ROUTER_PREFETCH_HEADER, NEXT_ROUTER_SEGMENT_PREFETCH_HEADER, NEXT_ROUTER_STATE_TREE_HEADER, NEXT_URL_HEADER, RSC_ACTION_HEADER, RSC_HEADER, VINEXT_CACHE_HEADER, VINEXT_CLIENT_REUSE_MANIFEST_HEADER, VINEXT_DYNAMIC_STALE_TIME_HEADER, VINEXT_INTERCEPTION_CONTEXT_HEADER, VINEXT_INTERNAL_HEADERS, VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PARAMS_HEADER, VINEXT_PRERENDER_CACHE_LIFE_HEADER, VINEXT_PRERENDER_PAGES_STATIC_PATHS_PATH, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_SPECULATIVE_HEADER, VINEXT_PRERENDER_STATIC_PARAMS_PATH, VINEXT_RENDERED_PATH_AND_SEARCH_HEADER, VINEXT_REVALIDATE_HEADER, VINEXT_RSC_MARKER_HEADER, VINEXT_RSC_REDIRECT_HEADER, VINEXT_RSC_RENDER_MODE_HEADER, VINEXT_STATIC_FILE_HEADER, VINEXT_TIMING_HEADER };

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

@@ -34,6 +34,7 @@ declare const PRERENDER_REVALIDATE_HEADER = "x-prerender-revalidate";
  */
 declare const PRERENDER_REVALIDATE_ONLY_GENERATED_HEADER = "x-prerender-revalidate-if-generated";
 declare function getRevalidateSecret(): string;
+declare function isRevalidateSecret(value: string | null | undefined): boolean;
 /**
  * Authorize an incoming request as an on-demand revalidation trigger. Mirrors
  * Next.js's `checkIsOnDemandRevalidate`: the {@link PRERENDER_REVALIDATE_HEADER}
@@ -124,4 +125,4 @@ declare function setRevalidateDuration(key: string, seconds: number): void;
  */
 declare function getRevalidateDuration(key: string): number | undefined;
 //#endregion
-export { ISRCacheEntry, PRERENDER_REVALIDATE_HEADER, PRERENDER_REVALIDATE_ONLY_GENERATED_HEADER, appIsrHtmlKey, appIsrRouteKey, appIsrRscKey, buildAppPageCacheValue, buildPagesCacheValue, getRevalidateDuration, getRevalidateSecret, isOnDemandRevalidateRequest, isrCacheKey, isrGet, isrSet, isrSetPrerenderedAppPage, normalizeMountedSlotsHeader, setRevalidateDuration, triggerBackgroundRegeneration };
+export { ISRCacheEntry, PRERENDER_REVALIDATE_HEADER, PRERENDER_REVALIDATE_ONLY_GENERATED_HEADER, appIsrHtmlKey, appIsrRouteKey, appIsrRscKey, buildAppPageCacheValue, buildPagesCacheValue, getRevalidateDuration, getRevalidateSecret, isOnDemandRevalidateRequest, isRevalidateSecret, isrCacheKey, isrGet, isrSet, isrSetPrerenderedAppPage, normalizeMountedSlotsHeader, setRevalidateDuration, triggerBackgroundRegeneration };

package/dist/server/isr-cache.js

@@ -80,6 +80,10 @@ function safeEqual(a, b) {
 	for (let i = 0; i < a.length; i++) mismatch |= a.charCodeAt(i) ^ b.charCodeAt(i);
 	return mismatch === 0;
 }
+function isRevalidateSecret(value) {
+	if (typeof value !== "string" || value.length === 0) return false;
+	return safeEqual(value, getRevalidateSecret());
+}
 /**
 * Authorize an incoming request as an on-demand revalidation trigger. Mirrors
 * Next.js's `checkIsOnDemandRevalidate`: the {@link PRERENDER_REVALIDATE_HEADER}
@@ -87,8 +91,8 @@ function safeEqual(a, b) {
 * NOT sufficient — see the security note on {@link PRERENDER_REVALIDATE_HEADER}.
 */
 function isOnDemandRevalidateRequest(headerValue) {
-	if (typeof headerValue !== "string" || headerValue.length === 0) return false;
-	return safeEqual(headerValue, getRevalidateSecret());
+	if (typeof headerValue !== "string") return false;
+	return isRevalidateSecret(headerValue);
 }
 /**
 * Get a cache entry with staleness information.
@@ -279,4 +283,4 @@ function getRevalidateDuration(key) {
 	return revalidateDurations.get(key);
 }
 //#endregion
-export { PRERENDER_REVALIDATE_HEADER, PRERENDER_REVALIDATE_ONLY_GENERATED_HEADER, appIsrHtmlKey, appIsrRouteKey, appIsrRscKey, buildAppPageCacheValue, buildPagesCacheValue, getRevalidateDuration, getRevalidateSecret, isOnDemandRevalidateRequest, isrCacheKey, isrGet, isrSet, isrSetPrerenderedAppPage, normalizeMountedSlotsHeader, setRevalidateDuration, triggerBackgroundRegeneration };
+export { PRERENDER_REVALIDATE_HEADER, PRERENDER_REVALIDATE_ONLY_GENERATED_HEADER, appIsrHtmlKey, appIsrRouteKey, appIsrRscKey, buildAppPageCacheValue, buildPagesCacheValue, getRevalidateDuration, getRevalidateSecret, isOnDemandRevalidateRequest, isRevalidateSecret, isrCacheKey, isrGet, isrSet, isrSetPrerenderedAppPage, normalizeMountedSlotsHeader, setRevalidateDuration, triggerBackgroundRegeneration };

package/dist/server/pages-data-route.d.ts

@@ -51,6 +51,7 @@ declare function isNextDataPathname(pathname: string): boolean;
  * `/_next/data/<buildId>/about`              → null  (missing .json suffix)
  */
 declare function parseNextDataPathname(pathname: string, buildId: string): NextDataMatch | null;
+declare function normalizeNextDataPagePathname(pagePathname: string, trailingSlash?: boolean): string;
 /**
  * Build the JSON envelope returned by `/_next/data/<buildId>/<page>.json`.
  * Mirrors Next.js' `RenderResult(JSON.stringify(props))` path in
@@ -79,6 +80,7 @@ declare function buildNextDataPropsJsonResponse(props: Record<string, unknown>,
  * before checking the status code.
  */
 declare function buildNextDataNotFoundResponse(): Response;
+declare function buildMiddlewarePrefetchSkipResponse(matchedPathname: string): Response;
 type NormalizePagesDataRequestResult = {
   isDataReq: false;
   request: Request;
@@ -116,6 +118,6 @@ type NormalizePagesDataRequestResult = {
  * Extracted from `entries/pages-server-entry.ts` so both `renderPage` and
  * `runMiddleware` share a single implementation.
  */
-declare function normalizePagesDataRequest(request: Request, buildId: string | null, basePath?: string): NormalizePagesDataRequestResult;
+declare function normalizePagesDataRequest(request: Request, buildId: string | null, basePath?: string, trailingSlash?: boolean): NormalizePagesDataRequestResult;
 //#endregion
-export { buildNextDataJsonResponse, buildNextDataNotFoundResponse, buildNextDataPropsJsonResponse, isNextDataPathname, normalizePagesDataRequest, parseNextDataPathname };
+export { buildMiddlewarePrefetchSkipResponse, buildNextDataJsonResponse, buildNextDataNotFoundResponse, buildNextDataPropsJsonResponse, isNextDataPathname, normalizeNextDataPagePathname, normalizePagesDataRequest, parseNextDataPathname };

package/dist/server/pages-data-route.js

@@ -1,4 +1,5 @@
 import { addBasePathToPathname, hasBasePath, stripBasePath } from "../utils/base-path.js";
+import { MIDDLEWARE_SKIP_HEADER } from "../utils/protocol-headers.js";
 import { NEXTJS_DEPLOYMENT_ID_HEADER } from "./headers.js";
 //#region src/server/pages-data-route.ts
 /**
@@ -58,6 +59,10 @@ function parseNextDataPathname(pathname, buildId) {
 	if (rest.startsWith("index/")) return { pagePathname: `/${rest.slice(6)}` };
 	return { pagePathname: `/${rest}` };
 }
+function normalizeNextDataPagePathname(pagePathname, trailingSlash = false) {
+	if (!trailingSlash || pagePathname === "/" || pagePathname.endsWith("/")) return pagePathname;
+	return `${pagePathname}/`;
+}
 /**
 * Build the JSON envelope returned by `/_next/data/<buildId>/<page>.json`.
 * Mirrors Next.js' `RenderResult(JSON.stringify(props))` path in
@@ -106,6 +111,14 @@ function buildNextDataNotFoundResponse() {
 		headers
 	});
 }
+function buildMiddlewarePrefetchSkipResponse(matchedPathname) {
+	return new Response("{}", { headers: {
+		"Content-Type": "application/json",
+		"x-matched-path": matchedPathname,
+		[MIDDLEWARE_SKIP_HEADER]: "1",
+		"Cache-Control": "private, no-cache, no-store, max-age=0, must-revalidate"
+	} });
+}
 /**
 * Detect and normalize `/_next/data/<buildId>/<page>.json` requests in one
 * place so the Pages Router pipeline and middleware shim do not need to know
@@ -124,7 +137,7 @@ function buildNextDataNotFoundResponse() {
 * Extracted from `entries/pages-server-entry.ts` so both `renderPage` and
 * `runMiddleware` share a single implementation.
 */
-function normalizePagesDataRequest(request, buildId, basePath = "") {
+function normalizePagesDataRequest(request, buildId, basePath = "", trailingSlash = false) {
 	const reqUrl = new URL(request.url);
 	const hadBasePath = !!basePath && hasBasePath(reqUrl.pathname, basePath);
 	const dataPathname = basePath ? stripBasePath(reqUrl.pathname, basePath) : reqUrl.pathname;
@@ -143,15 +156,16 @@ function normalizePagesDataRequest(request, buildId, basePath = "") {
 		search: "",
 		notFoundResponse: buildNextDataNotFoundResponse()
 	};
+	const pagePathname = normalizeNextDataPagePathname(dataMatch.pagePathname, trailingSlash);
 	const normalizedUrl = new URL(reqUrl);
-	normalizedUrl.pathname = hadBasePath ? addBasePathToPathname(dataMatch.pagePathname, basePath) : dataMatch.pagePathname;
+	normalizedUrl.pathname = hadBasePath ? addBasePathToPathname(pagePathname, basePath) : pagePathname;
 	return {
 		isDataReq: true,
 		request: new Request(normalizedUrl, request),
-		normalizedPathname: dataMatch.pagePathname,
+		normalizedPathname: pagePathname,
 		search: reqUrl.search,
 		notFoundResponse: null
 	};
 }
 //#endregion
-export { buildNextDataJsonResponse, buildNextDataNotFoundResponse, buildNextDataPropsJsonResponse, isNextDataPathname, normalizePagesDataRequest, parseNextDataPathname };
+export { buildMiddlewarePrefetchSkipResponse, buildNextDataJsonResponse, buildNextDataNotFoundResponse, buildNextDataPropsJsonResponse, isNextDataPathname, normalizeNextDataPagePathname, normalizePagesDataRequest, parseNextDataPathname };

package/dist/server/pages-dev-module-url.d.ts

@@ -1,4 +1,5 @@
 //#region src/server/pages-dev-module-url.d.ts
+declare function createPagesDevAssetUrl(assetPath: string): string;
 declare function createPagesDevModuleUrl(viteRoot: string, moduleFilePath: string, viteBase: string): string;
 //#endregion
-export { createPagesDevModuleUrl };
+export { createPagesDevAssetUrl, createPagesDevModuleUrl };

package/dist/server/pages-dev-module-url.js

@@ -4,12 +4,15 @@ function normalizeBase(base) {
 	if (!base || base === "/") return "/";
 	return `/${base.replace(/^\/+|\/+$/g, "")}/`;
 }
-function encodeModulePath(modulePath) {
+function encodePagesDevModulePath(modulePath) {
 	return encodeURI(modulePath).replace(/%5B/gi, "[").replace(/%5D/gi, "]").replace(/\?/g, "%3F").replace(/#/g, "%23");
 }
+function createPagesDevAssetUrl(assetPath) {
+	return "/" + encodePagesDevModulePath(assetPath.replace(/^\/+/, ""));
+}
 function createPagesDevModuleUrl(viteRoot, moduleFilePath, viteBase) {
 	const relativePath = (/^[A-Za-z]:[\\/]/.test(viteRoot) ? path.win32 : path).relative(viteRoot, moduleFilePath).replace(/\\/g, "/");
-	return normalizeBase(viteBase) + encodeModulePath(relativePath);
+	return normalizeBase(viteBase) + encodePagesDevModulePath(relativePath);
 }
 //#endregion
-export { createPagesDevModuleUrl };
+export { createPagesDevAssetUrl, createPagesDevModuleUrl };

package/dist/server/pages-node-compat.d.ts

@@ -27,6 +27,10 @@ type PagesReqResResponse = Writable & {
   redirect: (statusOrUrl: number | string, url?: string) => void;
   getHeaders: () => PagesReqResHeaders;
   revalidate: (urlPath: string, opts?: RevalidateOptions) => Promise<void>;
+  setPreviewData: (data: object | string, options?: {
+    maxAge?: number;
+    path?: string;
+  }) => PagesReqResResponse;
 };
 type PagesRequestCookiesCarrier = {
   headers: {
@@ -45,6 +49,7 @@ type CreatePagesReqResResult = {
   res: PagesReqResResponse;
   responsePromise: Promise<Response>;
 };
+type PagesPreviewData = object | string;
 /**
  * Read and parse a Pages Router API request body for the Workers/prod path.
  *
@@ -56,7 +61,13 @@ type CreatePagesReqResResult = {
  * @see https://nextjs.org/docs/pages/building-your-application/routing/api-routes#custom-config
  */
 declare function parsePagesApiBody(request: Request, maxBytes?: number): Promise<unknown>;
+declare function getPagesPreviewDataFromCookieHeader(cookieHeader: string | string[] | null | undefined, options?: {
+  isOnDemandRevalidate?: boolean;
+}): PagesPreviewData | false;
+declare function getPagesPreviewData(request: Request, options?: {
+  isOnDemandRevalidate?: boolean;
+}): PagesPreviewData | false;
 declare function attachPagesRequestCookies(req: PagesRequestCookiesCarrier): void;
 declare function createPagesReqRes(options: CreatePagesReqResOptions): CreatePagesReqResResult;
 //#endregion
-export { PagesBodyParseError as PagesApiBodyParseError, PagesReqResRequest, PagesReqResResponse, PagesRequestQuery, attachPagesRequestCookies, createPagesReqRes, parsePagesApiBody };
+export { PagesBodyParseError as PagesApiBodyParseError, PagesPreviewData, PagesReqResRequest, PagesReqResResponse, PagesRequestQuery, attachPagesRequestCookies, createPagesReqRes, getPagesPreviewData, getPagesPreviewDataFromCookieHeader, parsePagesApiBody };

package/dist/server/pages-node-compat.js

@@ -1,4 +1,5 @@
 import { parseCookieHeader } from "../utils/parse-cookie.js";
+import { getRevalidateSecret, isRevalidateSecret } from "./isr-cache.js";
 import { readStreamAsTextWithLimit } from "../utils/text-stream.js";
 import { DEFAULT_PAGES_API_BODY_SIZE_LIMIT } from "./pages-body-parser-config.js";
 import { PagesBodyParseError, getMediaType, isJsonMediaType } from "./pages-media-type.js";
@@ -64,6 +65,44 @@ function createRequestReadable(request) {
 function parsePagesRequestCookies(cookieHeader) {
 	return parseCookieHeader(Array.isArray(cookieHeader) ? cookieHeader.join("; ") : cookieHeader);
 }
+function serializePreviewCookie(name, value, options = {}) {
+	const parts = [
+		`${name}=${encodeURIComponent(value)}`,
+		"HttpOnly",
+		`Path=${options.path ?? "/"}`,
+		process.env.NODE_ENV !== "development" ? "SameSite=None" : "SameSite=Lax"
+	];
+	if (process.env.NODE_ENV !== "development") parts.push("Secure");
+	if (options.maxAge !== void 0) parts.push(`Max-Age=${Math.trunc(options.maxAge)}`);
+	return parts.join("; ");
+}
+function decodePagesPreviewPayload(payload) {
+	try {
+		const decoded = Buffer.from(payload, "base64url").toString("utf8");
+		const value = JSON.parse(decoded);
+		return typeof value === "object" && value !== null ? value : String(value);
+	} catch {
+		return false;
+	}
+}
+function getPagesPreviewDataFromCookieHeader(cookieHeader, options = {}) {
+	if (options.isOnDemandRevalidate) return false;
+	const cookies = parsePagesRequestCookies(cookieHeader);
+	const bypass = cookies.__prerender_bypass;
+	const payload = cookies.__next_preview_data;
+	if (!bypass && !payload) return false;
+	if (!isRevalidateSecret(bypass)) return false;
+	if (!payload) return {};
+	return decodePagesPreviewPayload(payload);
+}
+function getPagesPreviewData(request, options = {}) {
+	return getPagesPreviewDataFromCookieHeader(request.headers.get("cookie"), options);
+}
+function normalizeSetCookieHeader(value) {
+	if (value === void 0) return [];
+	if (Array.isArray(value)) return value.map(String);
+	return [String(value)];
+}
 function attachPagesRequestCookies(req) {
 	if (Object.hasOwn(req, "cookies")) return;
 	Object.defineProperty(req, "cookies", {
@@ -170,6 +209,16 @@ var PagesResponseStream = class extends Writable {
 	async revalidate(urlPath, opts) {
 		await performOnDemandRevalidate(this.requestHeaders, urlPath, opts);
 	}
+	setPreviewData(data, options = {}) {
+		const payload = Buffer.from(JSON.stringify(data)).toString("base64url");
+		if (payload.length > 2048) throw new Error("Preview data is limited to 2KB currently, reduce how much data you are storing as preview data to continue");
+		this.setHeader("Set-Cookie", [
+			...normalizeSetCookieHeader(this.getHeader("Set-Cookie")),
+			serializePreviewCookie("__prerender_bypass", getRevalidateSecret(), options),
+			serializePreviewCookie("__next_preview_data", payload, options)
+		]);
+		return this;
+	}
 	_write(chunk, encoding, callback) {
 		const buffer = typeof chunk === "string" ? Buffer.from(chunk, encoding) : Buffer.from(chunk);
 		if (this.controller && !this.streamEnded) try {
@@ -260,4 +309,4 @@ function createPagesReqRes(options) {
 	};
 }
 //#endregion
-export { PagesBodyParseError as PagesApiBodyParseError, attachPagesRequestCookies, createPagesReqRes, parsePagesApiBody };
+export { PagesBodyParseError as PagesApiBodyParseError, attachPagesRequestCookies, createPagesReqRes, getPagesPreviewData, getPagesPreviewDataFromCookieHeader, parsePagesApiBody };

package/dist/server/pages-page-data.d.ts

@@ -2,6 +2,7 @@ import { Route } from "../routing/pages-router.js";
 import { VinextNextData } from "../client/vinext-next-data.js";
 import { CachedPagesValue } from "../shims/cache-handler.js";
 import { ISRCacheEntry } from "./isr-cache.js";
+import { PagesPreviewData } from "./pages-node-compat.js";
 import { PagesGsspResponse, PagesI18nRenderContext, PagesNextDataExtras } from "./pages-page-response.js";
 import { ReactNode } from "react";
 
@@ -62,12 +63,18 @@ type PagesPageModule = {
     locale?: string;
     locales?: string[];
     defaultLocale?: string;
+    draftMode?: true;
+    preview?: true;
+    previewData?: PagesPreviewData;
   }) => Promise<PagesPagePropsResult> | PagesPagePropsResult;
   getStaticProps?: (context: {
     params: Record<string, unknown> | null;
     locale?: string;
     locales?: string[];
     defaultLocale?: string;
+    draftMode?: true;
+    preview?: true;
+    previewData?: PagesPreviewData;
     /**
      * Indicates why `getStaticProps` was invoked.
      *
@@ -127,6 +134,7 @@ type ResolvePagesPageDataOptions = {
    * `.nextjs-ref/packages/next/src/server/render.tsx`.
    */
   isBuildTimePrerendering?: boolean;
+  validatePropsSerialization?: boolean;
   /**
    * When true, this dispatch was triggered by an on-demand revalidation
    * request (e.g. `res.revalidate()` in a Pages Router API route, or an
@@ -143,6 +151,7 @@ type ResolvePagesPageDataOptions = {
    * presence — see the security note in `isr-cache.ts`.
    */
   isOnDemandRevalidate?: boolean;
+  previewData?: PagesPreviewData | false;
   /**
    * The deployment ID used for deployment-skew protection. When set, it is
    * included as `x-nextjs-deployment-id` on all `_next/data` responses