vinext 1.0.0-beta.1 → 1.0.0-beta.3

package/dist/server/pages-page-handler.js

@@ -1,19 +1,21 @@
-import { createRequestContext, runWithRequestContext } from "../shims/unified-request-context.js";
+import { closeAfterResponse, closeAfterResponseWithBody, createRequestContext, runWithRequestContext } from "../shims/unified-request-context.js";
 import { patternToNextFormat } from "../routing/route-validation.js";
 import { getRequestExecutionContext } from "../shims/request-context.js";
-import { NEXTJS_DEPLOYMENT_ID_HEADER } from "./headers.js";
+import { PRERENDER_REVALIDATE_HEADER } from "../utils/protocol-headers.js";
+import { NEXTJS_CACHE_HEADER, NEXTJS_DEPLOYMENT_ID_HEADER, VINEXT_CACHE_HEADER } from "./headers.js";
 import { reportRequestError } from "./instrumentation.js";
 import { BROWSER_REVALIDATE_CACHE_CONTROL, NEVER_CACHE_CONTROL, applyCdnResponseHeaders, shouldUseNextDeployCacheControl } from "./cache-control.js";
 import { buildMissIsrCacheControl } from "./isr-decision.js";
-import { PRERENDER_REVALIDATE_HEADER, isOnDemandRevalidateRequest, isrCacheKey, isrGet, isrSet, triggerBackgroundRegeneration } from "./isr-cache.js";
+import { coalesceOnDemandRevalidation, isOnDemandRevalidateRequest, isrCacheKey, isrGet, isrSet, triggerBackgroundRegeneration } from "./isr-cache.js";
+import { encodeCacheTag } from "../utils/encode-cache-tag.js";
 import { ensureFetchPatch } from "../shims/fetch-cache.js";
-import { appendAssetDeploymentIdQuery } from "../utils/deployment-id.js";
 import { mergeRouteParamsIntoQuery, parseQueryString } from "../utils/query.js";
 import { getScriptNonceFromHeaderSources } from "./csp.js";
 import { extractLocaleFromUrl, resolvePagesI18nRequest } from "./pages-i18n.js";
 import { buildDefaultPagesNotFoundResponse } from "./pages-default-404.js";
 import { buildPagesReadinessNextData } from "./pages-readiness.js";
 import { resolvePagesPageMethodResponse } from "./pages-page-method.js";
+import { setCacheStateHeaders } from "./cache-headers.js";
 import { renderPagesPageResponse } from "./pages-page-response.js";
 import { hasPagesGetInitialProps } from "./pages-get-initial-props.js";
 import { buildNextDataNotFoundResponse, buildNextDataPropsJsonResponse, normalizePagesDataRequest, parseNextDataPathname } from "./pages-data-route.js";
@@ -25,7 +27,12 @@ import { createPagesReqRes } from "./pages-node-compat.js";
 function finalizePagesPreviewResponse(response, preview) {
 	if (preview.data === false && !preview.shouldClear) return response;
 	const headers = new Headers(response.headers);
-	if (preview.data !== false) headers.set("Cache-Control", PAGES_PREVIEW_CACHE_CONTROL);
+	if (preview.data !== false) {
+		headers.set("Cache-Control", PAGES_PREVIEW_CACHE_CONTROL);
+		headers.delete("CDN-Cache-Control");
+		headers.delete("Cloudflare-CDN-Cache-Control");
+		headers.delete("Cache-Tag");
+	}
 	if (preview.shouldClear) appendPagesPreviewClearCookies(headers);
 	return new Response(response.body, {
 		headers,
@@ -33,6 +40,41 @@ function finalizePagesPreviewResponse(response, preview) {
 		statusText: response.statusText
 	});
 }
+function withPagesCacheState(response, state) {
+	const headers = new Headers(response.headers);
+	if (state === "REVALIDATED") {
+		headers.set(NEXTJS_CACHE_HEADER, state);
+		headers.delete(VINEXT_CACHE_HEADER);
+	} else setCacheStateHeaders(headers, state);
+	return new Response(response.body, {
+		headers,
+		status: response.status,
+		statusText: response.statusText
+	});
+}
+function applyPagesErrorCachePolicy(response, revalidateSeconds, expireSeconds, cacheTagPathname) {
+	const headers = new Headers(response.headers);
+	const browserPolicy = headers.get("Cache-Control");
+	const sharedPolicies = [headers.get("CDN-Cache-Control"), headers.get("Cloudflare-CDN-Cache-Control")];
+	const hasCacheableSharedPolicy = sharedPolicies.some((value) => value && /(?:^|,)\s*s-maxage\s*=/i.test(value));
+	if (sharedPolicies.some((value) => value && /(?:private|no-store|no-cache)/i.test(value)) || !hasCacheableSharedPolicy && browserPolicy && /(?:private|no-store|no-cache)/i.test(browserPolicy)) return response;
+	headers.delete("CDN-Cache-Control");
+	headers.delete("Cloudflare-CDN-Cache-Control");
+	headers.delete("Cache-Tag");
+	if (revalidateSeconds === void 0) applyCdnResponseHeaders(headers, { cacheControl: NEVER_CACHE_CONTROL });
+	else {
+		const stem = cacheTagPathname.endsWith("/") ? cacheTagPathname.slice(0, -1) : cacheTagPathname;
+		applyCdnResponseHeaders(headers, {
+			cacheControl: buildMissIsrCacheControl(revalidateSeconds, expireSeconds),
+			tags: [encodeCacheTag(`_N_T_${stem || "/"}`)]
+		});
+	}
+	return new Response(response.body, {
+		headers,
+		status: response.status,
+		statusText: response.statusText
+	});
+}
 function shouldEmitPagesClientTraceMetadata(pageModule, appComponent) {
 	if (typeof pageModule.getServerSideProps === "function") return true;
 	if (typeof pageModule.getStaticProps === "function") return false;
@@ -53,7 +95,7 @@ function buildI18nRenderContext(i18nConfig, locale, currentDefaultLocale, domain
 * accepts the same options shape the generated entry always passed inline.
 */
 function createPagesPageHandler(opts) {
-	const { pageRoutes, errorPageRoute, matchRoute, i18nConfig, vinextConfig, buildId, hasMiddleware, appAssetPath, hasRewrites, setSSRContext, getPagesNavigationIsReadyFromSerializedState, setI18nContext, wrapWithRouterContext, resetSSRHead, getSSRHeadHTML, setDocumentInitialHead, flushPreloads, getFontLinks, getFontStyles, getFontPreloads, renderToReadableStream, renderIsrPassToStringAsync, safeJsonStringify, sanitizeDestination, createPageElement, enhancePageElement, AppComponent, DocumentComponent } = opts;
+	const { pageRoutes, errorPageRoute, matchRoute, i18nConfig, vinextConfig, buildId, hasMiddleware, appAssetPath, hasRewrites, setSSRContext, getPagesNavigationIsReadyFromSerializedState, setI18nContext, wrapWithRouterContext, router, resetSSRHead, getSSRHeadHTML, setDocumentInitialHead, flushPreloads, getFontLinks, getFontStyles, getFontPreloads, renderToReadableStream, renderIsrPassToStringAsync, safeJsonStringify, sanitizeDestination, createPageElement, enhancePageElement, AppComponent, DocumentComponent } = opts;
 	function renderToStringAsync(element) {
 		return renderToReadableStream(element).then((stream) => new Response(stream).text());
 	}
@@ -122,6 +164,7 @@ function createPagesPageHandler(opts) {
 			route: options.__forcedRoute,
 			params: {}
 		} : matchRoute(routeUrl, pageRoutes);
+		let isRouteMissErrorRender = false;
 		let renderStatusCodeOverride = statusCode;
 		let renderAsPath = asPath;
 		if (!match) {
@@ -133,21 +176,52 @@ function createPagesPageHandler(opts) {
 					route: notFoundRoute,
 					params: {}
 				};
+				isRouteMissErrorRender = true;
 				renderStatusCodeOverride = 404;
 				renderAsPath = routeUrl;
 			} else return buildDefaultPagesNotFoundResponse();
 		}
 		const { route, params } = match;
-		const routerAsPath = i18nConfig ? extractLocaleFromUrl(renderAsPath ?? routeUrl, i18nConfig, locale).url : renderAsPath ?? routeUrl;
-		return runWithRequestContext(createRequestContext({ executionContext: getRequestExecutionContext() }), async () => {
+		const pageModule = route.module;
+		const isStaticPropsRoute = typeof pageModule.getStaticProps === "function";
+		const isStaticPropsRender = isStaticPropsRoute && typeof pageModule.getServerSideProps !== "function";
+		if (!options?.__skipOnDemandCoalesce && !options?.__forcedRoute && isStaticPropsRoute && isOnDemandRevalidateRequest(request.headers.get("x-prerender-revalidate"))) {
+			const snapshot = await coalesceOnDemandRevalidation(pageIsrCacheKey("pages", routeUrl.split("?")[0]), async () => {
+				const response = await renderPage(request, url, manifest, middlewareHeaders, {
+					...options,
+					__skipOnDemandCoalesce: true
+				});
+				return {
+					body: request.method === "HEAD" || response.status === 204 || response.status === 304 ? null : new Uint8Array(await response.arrayBuffer()),
+					headers: [...response.headers.entries()],
+					status: response.status,
+					statusText: response.statusText
+				};
+			});
+			return new Response(snapshot.body?.slice() ?? null, {
+				headers: snapshot.headers,
+				status: snapshot.status,
+				statusText: snapshot.statusText
+			});
+		}
+		const renderRouteUrl = isStaticPropsRender ? routeUrl.split("?")[0] : routeUrl;
+		const routerAsPathSource = isStaticPropsRender ? renderRouteUrl : renderAsPath ?? renderRouteUrl;
+		const routerAsPath = i18nConfig ? extractLocaleFromUrl(routerAsPathSource, i18nConfig, locale).url : routerAsPathSource;
+		const uCtx = createRequestContext({ executionContext: getRequestExecutionContext() });
+		return closeAfterResponseWithBody(await runWithRequestContext(uCtx, async () => {
 			ensureFetchPatch();
 			try {
 				const routePattern = patternToNextFormat(route.pattern);
 				const renderStatusCode = renderStatusCodeOverride ?? (routePattern === "/404" ? 404 : void 0);
-				const query = mergeRouteParamsIntoQuery(parseQueryString(routeUrl), params);
-				const pageModule = route.module;
-				const isStaticPropsRoute = typeof pageModule.getStaticProps === "function";
+				const isrCachePathname = isStaticPropsRender && (routePattern === "/404" || routePattern === "/500" || routePattern === "/_error") ? routePattern : renderRouteUrl.split("?")[0];
+				const isNotFoundErrorRender = routePattern === "/404" || routePattern === "/_error" && renderStatusCode === 404;
+				const isStatusErrorRender = isNotFoundErrorRender || routePattern === "/500" || routePattern === "/_error" && renderStatusCode === 500;
+				const errorPageRevalidateSeconds = isNotFoundErrorRender ? options?.__notFoundRevalidateSeconds : void 0;
+				const errorPageExpireSeconds = isNotFoundErrorRender ? options?.__notFoundExpireSeconds : void 0;
+				const errorResponseCachePathname = options?.__notFoundCachePathname ?? isrCachePathname;
+				const query = mergeRouteParamsIntoQuery(parseQueryString(renderRouteUrl), params);
 				const isOnDemandRevalidate = isOnDemandRevalidateRequest(request.headers.get(PRERENDER_REVALIDATE_HEADER));
+				const revalidateOnlyGenerated = isOnDemandRevalidate && request.headers.has("x-prerender-revalidate-if-generated");
 				const preview = isStaticPropsRoute || typeof pageModule.getServerSideProps === "function" ? getPagesPreviewState(request.headers.get("cookie"), { isOnDemandRevalidate }) : {
 					data: false,
 					shouldClear: false
@@ -161,7 +235,7 @@ function createPagesPageHandler(opts) {
 					}),
 					...previewData === false ? {} : { isPreview: true }
 				};
-				const navigationIsReady = typeof getPagesNavigationIsReadyFromSerializedState === "function" ? getPagesNavigationIsReadyFromSerializedState(routePattern, new URL(routerAsPath, "http://_").search, pagesNextData) : true;
+				const navigationIsReady = isStaticPropsRender ? false : typeof getPagesNavigationIsReadyFromSerializedState === "function" ? getPagesNavigationIsReadyFromSerializedState(routePattern, originalRequestUrl.search, pagesNextData) : true;
 				function applySSRContext(extra) {
 					if (typeof setSSRContext === "function") setSSRContext({
 						pathname: routePattern,
@@ -204,15 +278,16 @@ function createPagesPageHandler(opts) {
 						pageModuleUrl,
 						appModuleUrl,
 						hasMiddleware,
-						routeUrl
+						routeUrl: renderRouteUrl
 					}
 				};
 				const scriptNonce = getScriptNonceFromHeaderSources(request.headers, middlewareHeaders);
+				const shouldApplyErrorResponsePolicy = previewData === false && !scriptNonce && isStatusErrorRender && (isStaticPropsRoute || isRouteMissErrorRender || options?.__forcedRoute !== void 0);
 				let fontLinkHeader = "";
 				let allFontPreloads = [];
 				try {
 					allFontPreloads = getFontPreloads();
-					if (allFontPreloads.length > 0) fontLinkHeader = allFontPreloads.map((p) => "<" + appendAssetDeploymentIdQuery(p.href) + ">; rel=preload; as=font; type=" + p.type + "; crossorigin").join(", ");
+					if (allFontPreloads.length > 0) fontLinkHeader = allFontPreloads.map((p) => "<" + p.href + ">; rel=preload; as=font; type=" + p.type + "; crossorigin").join(", ");
 				} catch {}
 				const pagesResolvedUrl = (new URL(routeUrl, originalRequestUrl).pathname || "/") + originalRequestUrl.search;
 				const createPageReqRes = () => {
@@ -229,6 +304,7 @@ function createPagesPageHandler(opts) {
 					isDataReq,
 					err: err instanceof Error ? err : void 0,
 					applyRequestContexts: applySSRContext,
+					basePath: vinextConfig.basePath,
 					buildId,
 					deploymentId: process.env.__VINEXT_DEPLOYMENT_ID || process.env.NEXT_DEPLOYMENT_ID,
 					htmlLimitedBots: vinextConfig.htmlLimitedBots,
@@ -250,9 +326,11 @@ function createPagesPageHandler(opts) {
 					isBuildTimePrerendering: typeof process !== "undefined" && process.env && process.env.VINEXT_PRERENDER === "1",
 					validatePropsSerialization: process.env.NODE_ENV !== "production" || process.env.VINEXT_PRERENDER === "1",
 					isOnDemandRevalidate,
+					revalidateOnlyGenerated,
 					previewData,
 					pageModule,
 					AppComponent,
+					router,
 					params,
 					query,
 					asPath: routerAsPath,
@@ -260,11 +338,17 @@ function createPagesPageHandler(opts) {
 					renderIsrPassToStringAsync,
 					route: { isDynamic: route.isDynamic },
 					routePattern,
-					routeUrl,
+					routeUrl: renderRouteUrl,
+					isrCachePathname,
 					runInFreshUnifiedContext(callback) {
-						return runWithRequestContext(createRequestContext({ executionContext: null }), async () => {
+						const revalCtx = createRequestContext({ executionContext: null });
+						return runWithRequestContext(revalCtx, async () => {
 							ensureFetchPatch();
-							return callback();
+							try {
+								return await callback();
+							} finally {
+								await closeAfterResponse(revalCtx);
+							}
 						});
 					},
 					safeJsonStringify,
@@ -280,15 +364,26 @@ function createPagesPageHandler(opts) {
 				});
 				if (pageDataResult.kind === "notFound") {
 					const notFoundRoute = findNotFoundRoute();
-					if (notFoundRoute && routePattern !== "/404" && routePattern !== "/_error") return finalizePagesPreviewResponse(await renderPage(request, url, manifest, middlewareHeaders, {
+					let notFoundResponse;
+					if (notFoundRoute && routePattern !== "/404" && routePattern !== "/_error") notFoundResponse = await renderPage(request, url, manifest, middlewareHeaders, {
 						statusCode: 404,
 						asPath: routerAsPath,
 						renderErrorPageOnMiss: false,
-						__forcedRoute: notFoundRoute
-					}), preview);
-					return finalizePagesPreviewResponse(buildDefaultPagesNotFoundResponse(), preview);
+						__forcedRoute: notFoundRoute,
+						__notFoundRevalidateSeconds: pageDataResult.revalidateSeconds,
+						__notFoundExpireSeconds: pageDataResult.expireSeconds,
+						__notFoundCachePathname: isrCachePathname
+					});
+					else notFoundResponse = buildDefaultPagesNotFoundResponse();
+					if (isOnDemandRevalidate) notFoundResponse = withPagesCacheState(notFoundResponse, "REVALIDATED");
+					else if (pageDataResult.cacheState) notFoundResponse = withPagesCacheState(notFoundResponse, pageDataResult.cacheState);
+					return finalizePagesPreviewResponse(notFoundResponse, preview);
+				}
+				if (pageDataResult.kind === "response") {
+					let response = isOnDemandRevalidate && pageDataResult.onDemandRevalidateSuccess !== false ? withPagesCacheState(pageDataResult.response, "REVALIDATED") : pageDataResult.response;
+					if (shouldApplyErrorResponsePolicy) response = applyPagesErrorCachePolicy(response, errorPageRevalidateSeconds, errorPageExpireSeconds, errorResponseCachePathname);
+					return finalizePagesPreviewResponse(response, preview);
 				}
-				if (pageDataResult.kind === "response") return finalizePagesPreviewResponse(pageDataResult.response, preview);
 				let pageProps = pageDataResult.pageProps;
 				let renderProps = pageDataResult.props;
 				if (previewData !== false) renderProps = {
@@ -308,16 +403,12 @@ function createPagesPageHandler(opts) {
 				const gsspRes = pageDataResult.gsspRes;
 				const documentReqRes = serializedPagesNextData.autoExport === true ? null : pageDataResult.documentReqRes ?? createPageReqRes();
 				const isrRevalidateSeconds = pageDataResult.isrRevalidateSeconds;
+				const isrExpireSeconds = pageDataResult.isrExpireSeconds;
 				const isFallbackRender = pageDataResult.isFallback === true;
-				if (isFallbackRender && typeof setSSRContext === "function") setSSRContext({
-					pathname: routePattern,
-					query,
-					asPath: routerAsPath,
+				if (isFallbackRender) applySSRContext({
+					query: {},
+					asPath: routePattern,
 					navigationIsReady: false,
-					locale,
-					locales: i18nConfig ? i18nConfig.locales : void 0,
-					defaultLocale: currentDefaultLocale,
-					domainLocales,
 					isFallback: true
 				});
 				if (isDataReq) {
@@ -338,7 +429,7 @@ function createPagesPageHandler(opts) {
 						}
 						if (!hasUserCacheControl) init.headers["Cache-Control"] = NEVER_CACHE_CONTROL;
 					} else if (isStaticPropsRoute) {
-						if (isrRevalidateSeconds) {
+						if (isrRevalidateSeconds !== null) {
 							const headers = new Headers(init.headers);
 							applyCdnResponseHeaders(headers, { cacheControl: buildMissIsrCacheControl(isrRevalidateSeconds, vinextConfig.expireTime) });
 							for (const [key, value] of headers) init.headers[key] = value;
@@ -353,7 +444,7 @@ function createPagesPageHandler(opts) {
 				const pageModuleIds = [];
 				if (appAssetPath) pageModuleIds.push(appAssetPath);
 				if (route.filePath) pageModuleIds.push(route.filePath);
-				return finalizePagesPreviewResponse(await renderPagesPageResponse({
+				let pageResponse = await renderPagesPageResponse({
 					assetTags: collectAssetTags({
 						manifest,
 						moduleIds: pageModuleIds,
@@ -387,8 +478,10 @@ function createPagesPageHandler(opts) {
 					documentReqRes,
 					gsspRes,
 					isrCacheKey: pageIsrCacheKey,
-					expireSeconds: vinextConfig.expireTime,
+					isrCachePathname,
+					expireSeconds: isrExpireSeconds,
 					isrRevalidateSeconds,
+					isOnDemandRevalidate,
 					isStaticPropsRoute,
 					isrSet,
 					i18n: buildI18nRenderContext(i18nConfig, locale, currentDefaultLocale, domainLocales),
@@ -404,7 +497,7 @@ function createPagesPageHandler(opts) {
 					resetSSRHead: typeof resetSSRHead === "function" ? resetSSRHead : void 0,
 					setDocumentInitialHead: typeof setDocumentInitialHead === "function" ? setDocumentInitialHead : void 0,
 					routePattern,
-					routeUrl,
+					routeUrl: renderRouteUrl,
 					safeJsonStringify,
 					scriptNonce,
 					statusCode: renderStatusCode,
@@ -412,7 +505,9 @@ function createPagesPageHandler(opts) {
 					userAgent: request.headers.get("user-agent") ?? void 0,
 					ifNoneMatch: request.headers.get("if-none-match") ?? void 0,
 					requestCacheControl: request.headers.get("cache-control") ?? void 0
-				}), preview);
+				});
+				if (shouldApplyErrorResponsePolicy) pageResponse = applyPagesErrorCachePolicy(pageResponse, errorPageRevalidateSeconds, errorPageExpireSeconds, errorResponseCachePathname);
+				return finalizePagesPreviewResponse(pageResponse, preview);
 			} catch (e) {
 				console.error("[vinext] SSR error:", e);
 				reportRequestError(e instanceof Error ? e : new Error(String(e)), {
@@ -446,7 +541,7 @@ function createPagesPageHandler(opts) {
 				}
 				return new Response("Internal Server Error", { status: 500 });
 			}
-		});
+		}), uCtx);
 	}
 	return renderPage;
 }

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

@@ -88,11 +88,13 @@ type RenderPagesPageResponseOptions = {
   setDocumentInitialHead?: ((head: ReactNode[]) => void) | undefined;
   documentReqRes?: PagesDocumentReqRes | null;
   gsspRes: PagesGsspResponse | null;
-  isrCacheKey: (router: string, pathname: string) => string;
+  isrCacheKey: (router: string, pathname: string) => string; /** Filesystem-route identity used for ISR persistence and cache tags. */
+  isrCachePathname?: string;
   expireSeconds?: number;
-  isrRevalidateSeconds: number | null;
+  isrRevalidateSeconds: number | false | null; /** Synchronous `res.revalidate()` render; cache persistence must finish before returning. */
+  isOnDemandRevalidate?: boolean;
   isStaticPropsRoute?: boolean;
-  isrSet: (key: string, data: CachedPagesValue, revalidateSeconds: number, tags?: string[], expireSeconds?: number) => Promise<void>;
+  isrSet: (key: string, data: CachedPagesValue, revalidateSeconds: number | false, tags?: string[], expireSeconds?: number) => Promise<void>;
   i18n: PagesI18nRenderContext;
   /**
    * True when rendering a `getStaticPaths` fallback shell for a path that

package/dist/server/pages-page-response.js

@@ -1,6 +1,6 @@
 import { getRequestExecutionContext } from "../shims/request-context.js";
+import { NEXTJS_CACHE_HEADER } from "./headers.js";
 import { reportRequestError } from "./instrumentation.js";
-import { setCacheStateHeaders } from "./cache-headers.js";
 import { BROWSER_REVALIDATE_CACHE_CONTROL, NEVER_CACHE_CONTROL, NO_STORE_CACHE_CONTROL, applyCdnResponseHeaders, shouldUseNextDeployCacheControl } from "./cache-control.js";
 import { buildMissIsrCacheControl } from "./isr-decision.js";
 import { fnv1a52 } from "../utils/hash.js";
@@ -9,29 +9,19 @@ import { appendAssetDeploymentIdQuery } from "../utils/deployment-id.js";
 import { withScriptNonce } from "../shims/script-nonce-context.js";
 import { createNonceAttribute, escapeHtmlAttr } from "./html.js";
 import { getClientTraceMetadataHTML } from "./client-trace-metadata.js";
+import { setCacheStateHeaders } from "./cache-headers.js";
 import { readStreamAsText } from "../utils/text-stream.js";
 import { loadUserDocumentInitialProps, runDocumentRenderPage } from "./pages-document-initial-props.js";
 import { callDocumentGetInitialProps } from "./document-initial-head.js";
+import { isBotUserAgent } from "../utils/html-limited-bots.js";
 import React from "react";
 //#region src/server/pages-page-response.ts
 /**
-* Crawlers that cannot handle streamed HTML: they read metadata only from
-* the first network chunk, so streaming would give them an incomplete <head>.
-* Pattern sourced from Next.js html-bots.ts (updated to match the canary).
-*/
-const HTML_LIMITED_BOT_UA_RE = /[\w-]+-Google|Google-[\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight/i;
-/**
-* Googlebot (the main search crawler) executes JavaScript via a headless
-* browser, so it too cannot safely handle mid-stream HTML mutations.
-* Matches "Googlebot" but NOT suffixed variants like "Googlebot-Image".
-*/
-const HEADLESS_BROWSER_BOT_UA_RE = /Googlebot(?!-)|Googlebot$/i;
-/**
 * Returns true when the User-Agent belongs to a bot or crawler that cannot
 * reliably consume a streamed HTML response.
 */
 function isPagesStreamingBot(userAgent) {
-	return HEADLESS_BROWSER_BOT_UA_RE.test(userAgent) || HTML_LIMITED_BOT_UA_RE.test(userAgent);
+	return isBotUserAgent(userAgent);
 }
 function generatePagesETag(payload) {
 	return "\"" + fnv1a52(payload).toString(36) + payload.length.toString(36) + "\"";
@@ -64,7 +54,7 @@ function buildPagesFontHeadHtml(fontLinks, fontPreloads, fontStyles, scriptNonce
 	let html = "";
 	const nonceAttr = createNonceAttribute(scriptNonce);
 	for (const link of fontLinks) html += `<link rel="stylesheet"${nonceAttr} href="${escapeHtmlAttr(appendAssetDeploymentIdQuery(link))}" />\n  `;
-	for (const preload of fontPreloads) html += `<link rel="preload"${nonceAttr} href="${escapeHtmlAttr(appendAssetDeploymentIdQuery(preload.href))}" as="font" type="${escapeHtmlAttr(preload.type)}" crossorigin />\n  `;
+	for (const preload of fontPreloads) html += `<link rel="preload"${nonceAttr} href="${escapeHtmlAttr(preload.href)}" as="font" type="${escapeHtmlAttr(preload.type)}" crossorigin />\n  `;
 	if (fontStyles.length > 0) html += `<style data-vinext-fonts${nonceAttr}>${fontStyles.join("\n")}</style>\n  `;
 	return html;
 }
@@ -72,7 +62,7 @@ function buildPagesNextDataScript(options) {
 	const nextDataPayload = {
 		props: options.props ?? { pageProps: options.pageProps },
 		page: options.routePattern,
-		query: options.params,
+		query: options.isFallback === true ? {} : options.params,
 		buildId: options.buildId,
 		isFallback: options.isFallback === true
 	};
@@ -142,14 +132,18 @@ async function reportPagesIsrCacheWriteError(error, cacheKey, routePattern) {
 		});
 	} catch {}
 }
-function schedulePagesIsrCacheWrite(options) {
-	const cacheWritePromise = readStreamAsText(options.stream).then((bodyHtml) => options.setCache(options.cacheKey, {
+async function writePagesIsrCache(options) {
+	const bodyHtml = await readStreamAsText(options.stream);
+	await options.setCache(options.cacheKey, {
 		kind: "PAGES",
 		html: options.shellPrefix + bodyHtml + options.shellSuffix,
 		pageData: options.pageData,
 		headers: void 0,
 		status: options.status
-	}, options.revalidateSeconds, void 0, options.expireSeconds)).catch((error) => reportPagesIsrCacheWriteError(error, options.cacheKey, options.routePattern));
+	}, options.revalidateSeconds, void 0, options.expireSeconds);
+}
+function schedulePagesIsrCacheWrite(options) {
+	const cacheWritePromise = writePagesIsrCache(options).catch((error) => reportPagesIsrCacheWriteError(error, options.cacheKey, options.routePattern));
 	getRequestExecutionContext()?.waitUntil(cacheWritePromise);
 }
 function applyGsspHeaders(headers, gsspRes, statusCode) {
@@ -235,15 +229,15 @@ async function renderPagesPageResponse(options) {
 	const responseHeaders = new Headers({ "Content-Type": "text/html; charset=utf-8" });
 	const finalStatus = applyGsspHeaders(responseHeaders, options.gsspRes ?? options.documentReqRes?.res ?? null, options.statusCode);
 	let responseBodyStream = bodyStream;
-	if (!options.scriptNonce && options.isrRevalidateSeconds !== null && options.isrRevalidateSeconds > 0) {
+	if (!options.scriptNonce && options.isrRevalidateSeconds !== null && (options.isrRevalidateSeconds === false || options.isrRevalidateSeconds > 0)) {
 		const cacheBodyStreamPair = bodyStream.tee();
 		responseBodyStream = cacheBodyStreamPair[0];
 		const cacheBodyStream = cacheBodyStreamPair[1];
-		const isrPathname = options.routeUrl.split("?")[0];
-		schedulePagesIsrCacheWrite({
+		const isrPathname = options.isrCachePathname ?? options.routeUrl.split("?")[0];
+		const cacheWriteOptions = {
 			cacheKey: options.isrCacheKey("pages", isrPathname),
 			expireSeconds: options.expireSeconds,
-			pageData: options.pageProps,
+			pageData: options.props ?? { pageProps: options.pageProps },
 			revalidateSeconds: options.isrRevalidateSeconds,
 			routePattern: options.routePattern,
 			setCache: options.isrSet,
@@ -251,19 +245,22 @@ async function renderPagesPageResponse(options) {
 			shellSuffix,
 			status: finalStatus,
 			stream: cacheBodyStream
-		});
+		};
+		if (options.isOnDemandRevalidate) await writePagesIsrCache(cacheWriteOptions);
+		else schedulePagesIsrCacheWrite(cacheWriteOptions);
 	}
 	const compositeStream = await buildPagesCompositeStream(responseBodyStream, shellPrefix, shellSuffix);
 	const userSetCacheControl = responseHeaders.has("Cache-Control");
 	if (options.scriptNonce) responseHeaders.set("Cache-Control", NO_STORE_CACHE_CONTROL);
-	else if (options.isrRevalidateSeconds) {
-		const isrPathname = options.routeUrl.split("?")[0];
+	else if (options.isrRevalidateSeconds !== null) {
+		const isrPathname = options.isrCachePathname ?? options.routeUrl.split("?")[0];
 		const stem = isrPathname.endsWith("/") ? isrPathname.slice(0, -1) : isrPathname;
 		applyCdnResponseHeaders(responseHeaders, {
 			cacheControl: buildMissIsrCacheControl(options.isrRevalidateSeconds, options.expireSeconds),
 			tags: [encodeCacheTag(`_N_T_${stem || "/"}`)]
 		});
-		setCacheStateHeaders(responseHeaders, "MISS");
+		if (options.isOnDemandRevalidate) responseHeaders.set(NEXTJS_CACHE_HEADER, "REVALIDATED");
+		else setCacheStateHeaders(responseHeaders, "MISS");
 	} else if (options.isStaticPropsRoute && shouldUseNextDeployCacheControl()) responseHeaders.set("Cache-Control", BROWSER_REVALIDATE_CACHE_CONTROL);
 	else if (options.gsspRes && !userSetCacheControl) responseHeaders.set("Cache-Control", NEVER_CACHE_CONTROL);
 	if (options.fontLinkHeader) responseHeaders.set("Link", options.fontLinkHeader);

package/dist/server/pages-readiness.d.ts

@@ -7,9 +7,9 @@ import { PagesPageModule } from "./pages-page-data.js";
  *
  * The initial `router.isReady` value for the `next/navigation` compat hooks is
  * derived from the page/_app data-fetching exports plus the configured-rewrites
- * flag, serialized into `__NEXT_DATA__`. The dev SSR handler and the production
- * Pages page handler must compute this identically so server HTML and client
- * hydration agree — see `getPagesNavigationIsReadyFromSerializedState` in
+ * flag. The client recomputes readiness from those flags and its live URL,
+ * matching the Pages Router constructor; server-only readiness remains in the
+ * request context. See `getPagesNavigationIsReadyFromSerializedState` in
  * `shims/router.ts`.
  */
 /**

package/dist/server/pages-request-pipeline.d.ts

@@ -44,6 +44,14 @@ type PagesPipelineDeps = {
   hasMiddleware: boolean;
   ctx?: unknown;
   rawSearch?: string;
+  configMatchPathname?: string;
+  /**
+   * Validate an on-demand revalidation credential using the runtime's
+   * authoritative build secret. Production adapters must inject the verifier
+   * exported by the generated server entry so this early middleware decision
+   * uses the same baked secret as the eventual page renderer.
+   */
+  authorizeOnDemandRevalidate?: (headerValue: string | null) => boolean;
   matchPageRoute?: ((pathname: string, request: Request) => PageRouteMatch | null) | null;
   runMiddleware?: ((request: Request, ctx: unknown, opts: {
     isDataRequest: boolean;