vinext 1.1.0 → 1.2.1

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

@@ -119,9 +119,6 @@ function attachPagesPreviewApi(req, res) {
 var PagesResponseStream = class extends Writable {
 	resolveResponse;
 	rejectResponse;
-	requestHeaders;
-	trustedRevalidateOrigin;
-	allowedRevalidateHeaderKeys;
 	resStatusCode = 200;
 	resHeaders = {};
 	setCookieHeaders = [];
@@ -131,13 +128,10 @@ var PagesResponseStream = class extends Writable {
 	streamEnded = false;
 	pendingWrite = null;
 	discardBody = false;
-	constructor(resolveResponse, rejectResponse, requestHeaders, trustedRevalidateOrigin, allowedRevalidateHeaderKeys = []) {
+	constructor(resolveResponse, rejectResponse) {
 		super();
 		this.resolveResponse = resolveResponse;
 		this.rejectResponse = rejectResponse;
-		this.requestHeaders = requestHeaders;
-		this.trustedRevalidateOrigin = trustedRevalidateOrigin;
-		this.allowedRevalidateHeaderKeys = allowedRevalidateHeaderKeys;
 		this.once("error", (err) => {
 			if (!this.resolved) {
 				this.resolved = true;
@@ -206,9 +200,6 @@ var PagesResponseStream = class extends Writable {
 		if (this.setCookieHeaders.length > 0) headers["set-cookie"] = this.setCookieHeaders;
 		return headers;
 	}
-	async revalidate(urlPath, opts) {
-		await performOnDemandRevalidate(this.requestHeaders, urlPath, opts, this.trustedRevalidateOrigin, this.allowedRevalidateHeaderKeys);
-	}
 	setPreviewData(data, options = {}) {
 		setPagesPreviewData(this, data, options);
 		return this;
@@ -346,7 +337,7 @@ function createPagesReqRes(options) {
 		resolveResponse = resolve;
 		rejectResponse = reject;
 	});
-	const res = new PagesResponseStream(resolveResponse, rejectResponse, options.request.headers, options.trustedRevalidateOrigin ?? new URL(options.request.url).origin, options.allowedRevalidateHeaderKeys);
+	const res = new PagesResponseStream(resolveResponse, rejectResponse);
 	for (const [name, value] of options.initialResponseHeaders ?? []) {
 		if (name.toLowerCase() === "set-cookie") continue;
 		res.setHeader(name, value);
@@ -360,5 +351,22 @@ function createPagesReqRes(options) {
 		responsePromise
 	};
 }
+/**
+* Create the req/res pair for a Pages API route. Only API responses get
+* `res.revalidate()`: Next.js attaches it in apiResolver
+* (`packages/next/src/server/api-utils/node/api-resolver.ts`), so a page's
+* getServerSideProps `res` never carries the revalidation secret.
+*/
+function createPagesApiReqRes(options) {
+	const { req, res, responsePromise } = createPagesReqRes(options);
+	const trustedRevalidateOrigin = options.trustedRevalidateOrigin ?? new URL(options.request.url).origin;
+	return {
+		req,
+		res: Object.assign(res, { async revalidate(urlPath, opts) {
+			await performOnDemandRevalidate(options.request.headers, urlPath, opts, trustedRevalidateOrigin, options.allowedRevalidateHeaderKeys);
+		} }),
+		responsePromise
+	};
+}
 //#endregion
-export { PagesBodyParseError as PagesApiBodyParseError, attachPagesPreviewApi, attachPagesRequestCookies, createPagesReqRes, isVinextStreamedApiResponse, markVinextStreamedApiResponse, parsePagesApiBody };
+export { PagesBodyParseError as PagesApiBodyParseError, attachPagesPreviewApi, attachPagesRequestCookies, createPagesApiReqRes, createPagesReqRes, isVinextStreamedApiResponse, markVinextStreamedApiResponse, parsePagesApiBody };

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

@@ -1,5 +1,4 @@
 import { Route } from "../routing/pages-router.js";
-import { VinextNextData } from "../client/vinext-next-data.js";
 import { CachedPagesValue, CachedRedirectValue } from "../shims/cache-handler.js";
 import { ISRCacheEntry, IsrWritePolicy } from "./isr-cache.js";
 import { PagesPreviewData } from "./pages-preview.js";
@@ -43,6 +42,14 @@ export declare function assertPages404DoesNotReturnNotFound(routePattern: string
  * - packages/next/src/server/render.tsx (`metadata.cacheControl`)
  * - packages/next/src/server/route-modules/pages/pages-handler.ts
  */
+/**
+ * Next.js renders a shared getStaticProps status page (/404, /500) for its own
+ * pathname, never for the request that reached it. Only the original
+ * request's trailing slash carries over under `trailingSlash`, read before
+ * rewrites and locale stripping.
+ * https://github.com/vercel/next.js/blob/canary/packages/next/src/server/route-modules/pages/pages-handler.ts
+ */
+export declare function resolvePagesStatusPageRenderPath(statusPathname: string, trailingSlash: boolean, requestPathname: string): string;
 export declare function resolvePagesRevalidateSeconds(result: PagesPagePropsResult, routeUrl?: string): number | false;
 type PagesMutableGsspResponse = {
   headersSent: boolean;
@@ -115,25 +122,9 @@ export type PagesPageModule = {
     revalidateReason?: "build" | "on-demand" | "stale";
   }) => Promise<PagesPagePropsResult> | PagesPagePropsResult;
 };
-type RenderPagesIsrHtmlOptions = {
-  buildId: string | null;
-  cachedHtml: string;
-  collectIsrHeadHTML?: (() => string) | undefined;
-  createPageElement: (props: Record<string, unknown>) => ReactNode;
-  i18n: PagesI18nRenderContext;
-  pageProps: Record<string, unknown>;
-  props?: Record<string, unknown>;
-  params: Record<string, unknown>;
-  renderIsrPassToStringAsync: (element: ReactNode, onHeadReady?: () => Promise<void>) => Promise<string>;
-  routePattern: string;
-  safeJsonStringify: (value: unknown) => string;
-  vinext?: VinextNextData["__vinext"];
-  nextData?: PagesNextDataExtras;
-};
 export type ResolvePagesPageDataOptions = {
   applyRequestContexts: () => void;
   basePath?: string;
-  buildId: string | null;
   /**
    * When true, this is a `/_next/data/<buildId>/<page>.json` request. Callers
    * that respond with a JSON envelope (`{ pageProps }`) instead of HTML must
@@ -145,6 +136,8 @@ export type ResolvePagesPageDataOptions = {
   isDataReq?: boolean;
   err?: unknown;
   createGsspReqRes: () => PagesGsspContextResponse;
+  /** The req/res for a stale regeneration's render; defaults to `createGsspReqRes`. */
+  createRegenerationReqRes?: () => PagesGsspContextResponse;
   createAppTree?: (props: Record<string, unknown>) => ReactNode;
   createPageElement: (props: Record<string, unknown>) => ReactNode;
   fontLinkHeader: string;
@@ -188,6 +181,12 @@ export type ResolvePagesPageDataOptions = {
    * fallback path. Mirrors Next.js `unstable_onlyGenerated`.
    */
   revalidateOnlyGenerated?: boolean;
+  /**
+   * Set when a cache adapter regenerates an entry it stores for this build.
+   * The stored entry proves the path was admitted, so `getStaticPaths()` is
+   * skipped as it is for an entry read through `isrGet`.
+   */
+  regeneratesStoredEntry?: boolean;
   previewData?: PagesPreviewData | false;
   /**
    * The deployment ID used for deployment-skew protection. When set, it is
@@ -226,14 +225,19 @@ export type ResolvePagesPageDataOptions = {
     routePath: string;
     routeType: "render";
   }) => void;
-  renderIsrPassToStringAsync: (element: ReactNode, onHeadReady?: () => Promise<void>) => Promise<string>;
   /**
-   * Serializes the `<head>` collected by an ISR regeneration render. Called
-   * inside that render's head scope so the regenerated shell can pick up
-   * `next/head` output derived from the refreshed `getStaticProps` data.
+   * Render the whole document for regenerated props and store it as the ISR
+   * entry, through the same pipeline (and with the same cache write) as a
+   * foreground MISS. Next.js re-runs its full render on regeneration too;
+   * resolves once the entry is written.
    */
-  collectIsrHeadHTML?: (() => string) | undefined;
-  vinext?: VinextNextData["__vinext"];
+  renderIsrDocument: (input: {
+    documentReqRes: PagesGsspContextResponse;
+    expireSeconds: number | undefined;
+    pageProps: Record<string, unknown>;
+    props: Record<string, unknown>;
+    revalidateSeconds: number | false;
+  }) => Promise<void>;
   nextData?: PagesNextDataExtras;
   /**
    * The request's User-Agent string. When this matches a known crawler/bot
@@ -250,6 +254,11 @@ export type ResolvePagesPageDataOptions = {
    * response is a `304 Not Modified` with no body.
    */
   ifNoneMatch?: string;
+  /**
+   * The incoming request's `If-Modified-Since` header value. As in Next.js,
+   * which gives a page no Last-Modified, a request with it gets the page.
+   */
+  ifModifiedSince?: string;
   /**
    * The incoming request's `Cache-Control` header value. When it contains
    * `no-cache`, the 304 short-circuit is skipped and a full response is
@@ -320,6 +329,5 @@ export type PagesRouteParam = {
 };
 export declare function getPagesRouteParams(routePattern: string): PagesRouteParam[];
 export declare function matchesPagesStaticPath(pathEntry: PagesStaticPathsEntry, params: Record<string, unknown>, routeParams: PagesRouteParam[], routeUrl: string, i18n?: Pick<PagesI18nRenderContext, "locale" | "locales" | "defaultLocale">): boolean;
-export declare function renderPagesIsrHtml(options: RenderPagesIsrHtmlOptions): Promise<string>;
 export declare function resolvePagesPageData(options: ResolvePagesPageDataOptions): Promise<ResolvePagesPageDataResult>;
 //#endregion

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

@@ -1,20 +1,20 @@
 import { isUnknownRecord } from "../utils/record.js";
 import { isBotUserAgent } from "../utils/html-limited-bots.js";
-import { normalizePathnameForRouteMatch } from "../routing/utils.js";
 import { NEXTJS_CACHE_HEADER, NEXTJS_DEPLOYMENT_ID_HEADER } from "./headers.js";
+import { normalizePathnameForRouteMatch } from "../routing/utils.js";
 import { isDangerousScheme } from "../shims/url-safety.js";
 import { extractLocaleFromUrl } from "./pages-i18n.js";
+import { buildNextDataPropsJsonResponse } from "./pages-data-route.js";
 import { recordRouteCacheability } from "../shims/cacheability-classification.js";
 import { applyCdnResponseHeaders } from "./cache-control.js";
 import { buildMissIsrCacheControl, decideIsr } from "./isr-decision.js";
-import { buildPagesCacheValue, isrCacheControl } from "./isr-cache.js";
-import { encodeCacheTag } from "../utils/encode-cache-tag.js";
+import { isrCacheControl } from "./isr-cache.js";
 import { normalizeStaticPathname } from "../routing/route-pattern.js";
 import { buildCacheStateHeaders } from "./cache-headers.js";
-import { matchesIfNoneMatch } from "./http-conditional.js";
-import { buildPagesNextDataScript, generatePagesETag, isPagesStreamingBot, requestsNoCache } from "./pages-page-response.js";
+import { pagesPathCacheTag } from "./pages-cache-tag.js";
+import { isPageNotModified } from "./http-conditional.js";
+import { generatePagesETag, isPagesStreamingBot, rendersPagesNotModified } from "./pages-page-response.js";
 import { createPagesGetInitialPropsRouter, hasPagesGetInitialProps, isResponseSent, loadPagesGetInitialProps } from "./pages-get-initial-props.js";
-import { buildNextDataPropsJsonResponse } from "./pages-data-route.js";
 import { isSerializableProps } from "./pages-serializable-props.js";
 import { tracePagesData, tracePagesDocument } from "./pages-execution-tracing.js";
 //#region src/server/pages-page-data.ts
@@ -43,6 +43,16 @@ function assertPages404DoesNotReturnNotFound(routePattern, result) {
 * - packages/next/src/server/render.tsx (`metadata.cacheControl`)
 * - packages/next/src/server/route-modules/pages/pages-handler.ts
 */
+/**
+* Next.js renders a shared getStaticProps status page (/404, /500) for its own
+* pathname, never for the request that reached it. Only the original
+* request's trailing slash carries over under `trailingSlash`, read before
+* rewrites and locale stripping.
+* https://github.com/vercel/next.js/blob/canary/packages/next/src/server/route-modules/pages/pages-handler.ts
+*/
+function resolvePagesStatusPageRenderPath(statusPathname, trailingSlash, requestPathname) {
+	return trailingSlash && requestPathname.endsWith("/") ? statusPathname + "/" : statusPathname;
+}
 function resolvePagesRevalidateSeconds(result, routeUrl = "") {
 	const revalidate = result.revalidate;
 	if (revalidate === true) return 1;
@@ -103,14 +113,13 @@ function mergePagesNotFoundSourceHeaders(response, sourceHeaders) {
 	});
 }
 function applyPagesTerminalMissHeaders(response, revalidateSeconds, isrCachePathname, expireSeconds) {
-	const stem = isrCachePathname.endsWith("/") ? isrCachePathname.slice(0, -1) : isrCachePathname;
 	recordRouteCacheability({
 		cacheable: revalidateSeconds !== 0,
 		cacheControl: buildMissIsrCacheControl(revalidateSeconds, expireSeconds)
 	});
 	applyCdnResponseHeaders(response.headers, {
 		cacheControl: buildMissIsrCacheControl(revalidateSeconds, expireSeconds),
-		tags: [encodeCacheTag(`_N_T_${stem || "/"}`)]
+		tags: [pagesPathCacheTag(isrCachePathname)]
 	});
 	for (const [name, value] of Object.entries(buildCacheStateHeaders("MISS"))) response.headers.set(name, value);
 	return response;
@@ -216,7 +225,7 @@ async function loadPagesAppInitialRenderProps(options, getSharedReqRes) {
 			defaultLocale: options.i18n.defaultLocale
 		}
 	});
-	if (isResponseSent(res)) return {
+	if (isResponseSent(res) && typeof options.pageModule.getStaticProps !== "function") return {
 		kind: "response",
 		response: responsePromise
 	};
@@ -367,7 +376,7 @@ function matchesPagesStaticPath(pathEntry, params, routeParams, routeUrl, i18n)
 		const actual = params[key];
 		if (Array.isArray(value)) {
 			if (optional && value.length === 0 && actual === void 0) return true;
-			return Array.isArray(actual) && value.join("/") === actual.join("/");
+			return Array.isArray(actual) && value.length === actual.length && actual.every((part, index) => part === value[index]);
 		}
 		return String(value) === String(actual);
 	});
@@ -408,7 +417,11 @@ function finalizeCachedPagesResponse(response, options, html) {
 	if (html !== void 0 && options.userAgent && isPagesStreamingBot(options.userAgent)) {
 		const etag = generatePagesETag(html);
 		response.headers.set("ETag", etag);
-		if (!requestsNoCache(options.requestCacheControl) && options.ifNoneMatch && matchesIfNoneMatch(options.ifNoneMatch, etag)) response = new Response(null, {
+		if (isPageNotModified({
+			cacheControl: options.requestCacheControl,
+			ifModifiedSince: options.ifModifiedSince,
+			ifNoneMatch: options.ifNoneMatch
+		}, etag) && rendersPagesNotModified(response.status)) response = new Response(null, {
 			status: 304,
 			headers: response.headers
 		});
@@ -418,92 +431,6 @@ function finalizeCachedPagesResponse(response, options, html) {
 		response
 	};
 }
-/**
-* Matches one serialized `next/head` tag. `getSSRHeadHTML()` stamps every tag
-* it emits with `data-next-head=""` (see `shims/head.ts`), which is the same
-* marker Next.js uses to reconcile the head on the client — so it is a stable
-* anchor for finding the collector's output inside an already-rendered shell.
-*
-* Raw-content tags are safe to match non-greedily: `headChildToHTML()` escapes
-* closing-tag sequences in `<style>`/`<script>` bodies, so the first `</style>`
-* encountered is always the real terminator.
-*/
-const SSR_HEAD_TAG_PATTERN = /<(title|meta|link|style|script|base|noscript)\b[^>]*?\sdata-next-head=""[^>]*?(?:\/>|>[\s\S]*?<\/\1>)/g;
-/**
-* Matches a whole head element whose body may contain markup-looking text.
-* Script/style are raw-text elements, title is RCDATA, and noscript is raw
-* text while scripting is enabled. In all four, a literal `</head>` does not
-* close the document head. `headChildToHTML()` only escapes the element's own
-* closing sequence for script/style, while `dangerouslySetInnerHTML` may leave
-* `</head>` intact in any of them.
-*/
-const HEAD_TEXT_ELEMENT_PATTERN = /<(script|style|title|noscript)\b[^>]*>[\s\S]*?<\/\1>/gi;
-/**
-* Replace the `next/head` region of a cached shell with a freshly collected
-* one.
-*
-* ISR regeneration re-renders the page body but reuses the cached shell, so
-* without this the `<head>` stays frozen at whatever the first cache-filling
-* render produced — a page whose `<title>`/meta derive from `getStaticProps`
-* data would serve an updated body under permanently stale metadata.
-*
-* The collector emits its tags as one contiguous run (`ssrHeadHTML` is
-* concatenated ahead of trace meta and `_document` styles in
-* `buildPagesShellHtml`), so replacing first-match-start through
-* last-match-end swaps exactly that run and leaves `_document`-owned head
-* markup either side of it untouched.
-*
-* Only the `next/head` run refreshes. `_document`-rendered head children and
-* CSS-in-JS `styles` still come from the cached shell, because regeneration
-* never re-renders `_document` — refreshing those means running the full
-* document pipeline on regeneration the way Next.js does.
-*/
-function refreshCachedHeadTags(cachedHtml, freshHead) {
-	if (!freshHead) return cachedHtml;
-	const headEnd = cachedHtml.replace(HEAD_TEXT_ELEMENT_PATTERN, (element) => " ".repeat(element.length)).indexOf("</head>");
-	if (headEnd < 0) return cachedHtml;
-	const matches = [...cachedHtml.slice(0, headEnd).matchAll(SSR_HEAD_TAG_PATTERN)];
-	const first = matches[0];
-	const last = matches[matches.length - 1];
-	if (!first || !last || first.index === void 0 || last.index === void 0) return cachedHtml;
-	return cachedHtml.slice(0, first.index) + freshHead + cachedHtml.slice(last.index + last[0].length);
-}
-function rewritePagesCachedHtml(cachedHtml, freshBody, nextDataScript) {
-	const bodyStart = cachedHtml.indexOf("<div id=\"__next\">");
-	const contentStart = bodyStart >= 0 ? bodyStart + 17 : -1;
-	const canonicalNextDataStart = cachedHtml.search(/<script\b(?=[^>]*\bid=["']__NEXT_DATA__["'])(?=[^>]*\btype=["']application\/json["'])[^>]*>/);
-	const legacyNextDataStart = cachedHtml.indexOf("<script>window.__NEXT_DATA__");
-	const nextDataStart = canonicalNextDataStart >= 0 ? canonicalNextDataStart : legacyNextDataStart;
-	if (contentStart >= 0 && nextDataStart >= 0) {
-		const region = cachedHtml.slice(contentStart, nextDataStart);
-		const lastCloseDiv = region.lastIndexOf("</div>");
-		const gap = lastCloseDiv >= 0 ? region.slice(lastCloseDiv + 6) : "";
-		const nextDataEnd = cachedHtml.indexOf("<\/script>", nextDataStart) + 9;
-		const tail = cachedHtml.slice(nextDataEnd);
-		return cachedHtml.slice(0, contentStart) + freshBody + "</div>" + gap + nextDataScript + tail;
-	}
-	return "<!DOCTYPE html>\n<html>\n<head>\n</head>\n<body>\n  <div id=\"__next\">" + freshBody + "</div>\n  " + nextDataScript + "\n</body>\n</html>";
-}
-async function renderPagesIsrHtml(options) {
-	const renderProps = options.props ?? { pageProps: options.pageProps };
-	const collectHead = options.collectIsrHeadHTML;
-	let freshHead = "";
-	const freshBody = await options.renderIsrPassToStringAsync(options.createPageElement(renderProps), collectHead && (async () => {
-		freshHead = collectHead();
-	}));
-	const nextDataScript = buildPagesNextDataScript({
-		buildId: options.buildId,
-		i18n: options.i18n,
-		pageProps: options.pageProps,
-		props: renderProps,
-		params: options.params,
-		routePattern: options.routePattern,
-		safeJsonStringify: options.safeJsonStringify,
-		nextData: options.nextData,
-		vinext: options.vinext
-	});
-	return rewritePagesCachedHtml(refreshCachedHeadTags(options.cachedHtml, freshHead), freshBody, nextDataScript);
-}
 async function resolvePagesPageData(options) {
 	const userFacingParams = options.route.isDynamic ? options.params : null;
 	let isFallback = false;
@@ -515,13 +442,13 @@ async function resolvePagesPageData(options) {
 		const value = cached?.value.value;
 		if (cached && !cached.isStale && !cached.isExpired && value?.kind === "PAGES") return finalizeCachedPagesResponse(options.isDataReq ? applyCachedPagesRepresentationHeaders(buildNextDataPropsJsonResponse(normalizePagesRenderProps(value.pageData), options.safeJsonStringify, options.deploymentId ? { headers: { [NEXTJS_DEPLOYMENT_ID_HEADER]: options.deploymentId } } : void 0), "HIT", cached.value, options) : buildPagesCacheResponse(value.html, "HIT", options.fontLinkHeader, void 0, options.expireSeconds, cached.value.cacheControl, options.statusCode ?? value.status, value.headers), options, options.isDataReq ? void 0 : value.html);
 	}
-	let hasFreshPrerenderedEntry = false;
-	if (options.hasPrerenderedPages && options.route.isDynamic && typeof options.pageModule.getStaticProps === "function" && typeof options.pageModule.getServerSideProps !== "function" && !options.isOnDemandRevalidate && previewData === false) {
+	let hasStoredEntry = options.regeneratesStoredEntry === true;
+	if (options.route.isDynamic && typeof options.pageModule.getStaticProps === "function" && typeof options.pageModule.getServerSideProps !== "function" && !hasStoredEntry && !options.isOnDemandRevalidate && previewData === false) {
 		previousCacheEntry = await options.isrGet(options.isrCacheKey("pages", options.isrCachePathname ?? options.routeUrl.split("?")[0]));
 		const value = previousCacheEntry?.value.value;
-		hasFreshPrerenderedEntry = !!previousCacheEntry && !previousCacheEntry.isStale && !previousCacheEntry.isExpired && (value === null || value?.kind === "PAGES" || value?.kind === "REDIRECT");
+		hasStoredEntry = !!previousCacheEntry && !previousCacheEntry.isExpired && (value === null || value?.kind === "PAGES" || value?.kind === "REDIRECT");
 	}
-	if (!hasFreshPrerenderedEntry && typeof options.pageModule.getStaticPaths === "function" && options.route.isDynamic) {
+	if (!hasStoredEntry && previewData === false && typeof options.pageModule.getStaticPaths === "function" && options.route.isDynamic) {
 		const staticPathsI18n = {
 			...options.i18n,
 			defaultLocale: options.staticPathsDefaultLocale ?? options.i18n.defaultLocale
@@ -534,7 +461,7 @@ async function resolvePagesPageData(options) {
 		const paths = pathsResult?.paths ?? [];
 		const routeParams = getPagesRouteParams(options.routePattern);
 		const isValidPath = paths.some((pathEntry) => matchesPagesStaticPath(pathEntry, options.params, routeParams, options.routeUrl, staticPathsI18n));
-		if (fallback === false && !isValidPath && previewData === false) {
+		if (fallback === false && !isValidPath) {
 			if (options.isOnDemandRevalidate && !options.revalidateOnlyGenerated) return {
 				kind: "response",
 				response: new Response("This page could not be found", { status: 404 }),
@@ -543,7 +470,7 @@ async function resolvePagesPageData(options) {
 			return buildPagesNotFoundResult(options);
 		}
 		const isBotRequest = !!options.userAgent && isBotUserAgent(options.userAgent, options.htmlLimitedBots);
-		if (fallback === true && !isValidPath && !options.isDataReq && !isBotRequest && previewData === false) isFallback = true;
+		if (fallback === true && !isValidPath && !options.isDataReq && !isBotRequest) isFallback = true;
 		shouldPersistFallbackData = fallback === true && !isValidPath && options.isDataReq === true;
 	}
 	if (typeof options.pageModule.getStaticProps === "function" && options.isOnDemandRevalidate && options.revalidateOnlyGenerated) {
@@ -571,6 +498,13 @@ async function resolvePagesPageData(options) {
 	}
 	let renderProps = { pageProps };
 	if (previewData !== false) renderProps.__N_PREVIEW = true;
+	async function takeSentResponse() {
+		if (options.isOnDemandRevalidate || !sharedReqRes || !isResponseSent(sharedReqRes.res)) return null;
+		return {
+			kind: "response",
+			response: await sharedReqRes.responsePromise
+		};
+	}
 	async function loadForegroundAppInitialRenderProps() {
 		const result = await loadPagesAppInitialRenderProps(options, getSharedReqRes);
 		if (result.kind === "response") return {
@@ -583,7 +517,7 @@ async function resolvePagesPageData(options) {
 	}
 	if (isFallback) {
 		const pathname = options.isrCachePathname ?? options.routeUrl.split("?")[0];
-		if ((await options.isrGet(options.isrCacheKey("pages", pathname)))?.value.value?.kind !== "PAGES") {
+		if ((previousCacheEntry !== void 0 ? previousCacheEntry : await options.isrGet(options.isrCacheKey("pages", pathname)))?.value.value?.kind !== "PAGES") {
 			const appShortCircuit = await loadForegroundAppInitialRenderProps();
 			if (appShortCircuit) return appShortCircuit;
 			pageProps = {};
@@ -656,7 +590,8 @@ async function resolvePagesPageData(options) {
 			options.triggerBackgroundRegeneration(cacheKey, async function() {
 				return options.runInFreshUnifiedContext(async () => {
 					options.applyRequestContexts();
-					const freshAppResult = await loadPagesAppInitialRenderProps(options, () => options.createGsspReqRes());
+					const reqRes = (options.createRegenerationReqRes ?? options.createGsspReqRes)();
+					const freshAppResult = await loadPagesAppInitialRenderProps(options, () => reqRes);
 					if (freshAppResult.kind === "response") return;
 					let freshPageProps = freshAppResult.pageProps;
 					let freshRenderProps = freshAppResult.renderProps;
@@ -696,22 +631,13 @@ async function resolvePagesPageData(options) {
 					};
 					if (options.validatePropsSerialization !== false) isSerializableProps(options.routePattern, "getStaticProps", freshPageProps);
 					if (cachedValue?.kind === "PAGES" && !cachedValue.generatedFromDataRequest) {
-						const freshHtml = await tracePagesDocument(options.routePattern, () => renderPagesIsrHtml({
-							buildId: options.buildId,
-							cachedHtml: cachedValue.html,
-							createPageElement: options.createPageElement,
-							i18n: options.i18n,
+						await tracePagesDocument(options.routePattern, () => options.renderIsrDocument({
+							documentReqRes: reqRes,
+							expireSeconds,
 							pageProps: freshPageProps,
 							props: freshRenderProps,
-							params: options.params,
-							renderIsrPassToStringAsync: options.renderIsrPassToStringAsync,
-							collectIsrHeadHTML: options.collectIsrHeadHTML,
-							routePattern: options.routePattern,
-							safeJsonStringify: options.safeJsonStringify,
-							nextData: options.nextData,
-							vinext: options.vinext
+							revalidateSeconds
 						}));
-						await options.isrSet(cacheKey, buildPagesCacheValue(freshHtml, freshRenderProps, options.statusCode), { cacheControl: isrCacheControl(revalidateSeconds, { expireSeconds }) });
 						return;
 					}
 					await options.isrSet(cacheKey, {
@@ -788,7 +714,7 @@ async function resolvePagesPageData(options) {
 				}, { cacheControl: isrCacheControl(revalidateSeconds, { expireSeconds }) });
 				applyPagesTerminalMissHeaders(response, revalidateSeconds, pathname, expireSeconds);
 			}
-			return {
+			return await takeSentResponse() ?? {
 				kind: "response",
 				response
 			};
@@ -799,7 +725,7 @@ async function resolvePagesPageData(options) {
 			if (previewData === false) await options.isrSet(cacheKey, null, { cacheControl: isrCacheControl(revalidateSeconds, { expireSeconds }) });
 			const notFoundResult = buildPagesNotFoundResult(options, revalidateSeconds, previewData === false ? "MISS" : void 0, expireSeconds);
 			if (notFoundResult.kind === "response" && previewData === false) applyPagesTerminalMissHeaders(notFoundResult.response, revalidateSeconds, pathname, expireSeconds);
-			return notFoundResult;
+			return await takeSentResponse() ?? notFoundResult;
 		}
 		if (result?.props !== void 0 && options.validatePropsSerialization !== false) isSerializableProps(options.routePattern, "getStaticProps", pageProps);
 		if (previewData === false && result) {
@@ -854,6 +780,10 @@ async function resolvePagesPageData(options) {
 			};
 		}
 	}
+	if (options.isDataReq) {
+		const sentResponse = await takeSentResponse();
+		if (sentResponse) return sentResponse;
+	}
 	return {
 		kind: "render",
 		documentReqRes: sharedReqRes,
@@ -866,4 +796,4 @@ async function resolvePagesPageData(options) {
 	};
 }
 //#endregion
-export { assertPages404DoesNotReturnNotFound, buildPagesRedirectProps, getPagesRouteParams, matchesPagesStaticPath, mergePagesDataProps, mergePagesNotFoundSourceHeaders, renderPagesIsrHtml, resolvePagesPageData, resolvePagesRedirect, resolvePagesRedirectLocation, resolvePagesRevalidateSeconds };
+export { assertPages404DoesNotReturnNotFound, buildPagesRedirectProps, getPagesRouteParams, matchesPagesStaticPath, mergePagesDataProps, mergePagesNotFoundSourceHeaders, resolvePagesPageData, resolvePagesRedirect, resolvePagesRedirectLocation, resolvePagesRevalidateSeconds, resolvePagesStatusPageRenderPath };

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

@@ -99,12 +99,6 @@ export type CreatePagesPageHandlerOptions = {
   }>;
   /** `renderToReadableStream` from `react-dom/server.edge`. */
   renderToReadableStream: (element: ReactNode) => Promise<ReadableStream<Uint8Array>>;
-  /**
-   * Render a second ISR pass to a string (wraps renderToReadableStream).
-   * `onHeadReady` runs inside the pass's head scope, after the render and
-   * before the scope unwinds, so callers can read the collected `<head>`.
-   */
-  renderIsrPassToStringAsync: (element: ReactNode, onHeadReady?: () => Promise<void>) => Promise<string>;
   /** `safeJsonStringify` from `vinext/html`. */
   safeJsonStringify: (value: unknown) => string;
   /** `sanitizeDestination` from the config-matchers module. */