vinext 0.0.52 → 0.0.54

package/dist/server/pages-body-parser-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages-body-parser-config.js","names":[],"sources":["../../src/server/pages-body-parser-config.ts"],"sourcesContent":["/**\n * Resolve the Pages Router `api.bodyParser` config from a route module export.\n *\n * Next.js API routes can opt out of automatic body parsing or raise the\n * default 1 MB size limit:\n *\n *   export const config = { api: { bodyParser: false } };\n *   export const config = { api: { bodyParser: { sizeLimit: '4mb' } } };\n *\n * `bodyParser: false` is critical for webhook handlers (Stripe, GitHub,\n * Slack, etc.) that must read the raw request bytes to verify an HMAC\n * signature. Silently parsing the body would consume the stream and break\n * signature verification — usually failing closed, sometimes failing open.\n *\n * @see https://nextjs.org/docs/pages/building-your-application/routing/api-routes#custom-config\n * @see Next.js: packages/next/src/server/api-utils/node/api-resolver.ts\n *\n * The format of `sizeLimit` mirrors what Next.js accepts via the `bytes`\n * package: a number of bytes, or a string with a unit suffix\n * (`\"500b\"`, `\"100kb\"`, `\"4mb\"`, `\"1gb\"`).\n */\n\n/**\n * Default Pages Router API body size limit, matching Next.js.\n */\nexport const DEFAULT_PAGES_API_BODY_SIZE_LIMIT = 1 * 1024 * 1024;\n\n/**\n * Resolved bodyParser configuration. When `enabled` is `false`, the body\n * MUST be passed through to the handler as a raw stream (or left unparsed\n * with `req.body === undefined`), so user code can read it itself.\n */\ntype ResolvedBodyParserConfig = { enabled: false } | { enabled: true; sizeLimit: number };\n\nconst SIZE_UNITS: Record<string, number> = {\n  b: 1,\n  kb: 1024,\n  mb: 1024 * 1024,\n  gb: 1024 * 1024 * 1024,\n  tb: 1024 * 1024 * 1024 * 1024,\n};\n\n/**\n * Parse a Next.js-style `sizeLimit` string (e.g. `\"4mb\"`, `\"100kb\"`, `\"1gb\"`)\n * or numeric byte value into a number of bytes. Returns `undefined` for\n * inputs that can't be parsed — callers should fall back to the default.\n *\n * Matches the format accepted by Next.js (the `bytes` package); we\n * implement it inline to avoid pulling a dependency for a tiny parser.\n */\nexport function parseSizeLimit(value: string | number | undefined): number | undefined {\n  if (value === undefined || value === null) return undefined;\n  if (typeof value === \"number\") {\n    return Number.isFinite(value) && value >= 0 ? value : undefined;\n  }\n  if (typeof value !== \"string\") return undefined;\n\n  const trimmed = value.trim().toLowerCase();\n  if (!trimmed) return undefined;\n\n  // Match `<number><unit?>` where number can be int/decimal and unit is one\n  // of b/kb/mb/gb/tb. The unit is optional — a bare number is bytes.\n  const match = /^(\\d+(?:\\.\\d+)?)\\s*(b|kb|mb|gb|tb)?$/.exec(trimmed);\n  if (!match) return undefined;\n\n  const amount = Number.parseFloat(match[1]);\n  if (!Number.isFinite(amount) || amount < 0) return undefined;\n\n  const unit = match[2] ?? \"b\";\n  const multiplier = SIZE_UNITS[unit];\n  if (multiplier === undefined) return undefined;\n\n  return Math.floor(amount * multiplier);\n}\n\n/**\n * Read the resolved `bodyParser` config from a route module's `config`\n * export. Defaults to enabled with the 1 MB Next.js default.\n */\nexport function resolveBodyParserConfig(\n  moduleConfig: { api?: { bodyParser?: boolean | { sizeLimit?: string | number } } } | undefined,\n  defaultSizeLimit: number = DEFAULT_PAGES_API_BODY_SIZE_LIMIT,\n): ResolvedBodyParserConfig {\n  const bodyParser = moduleConfig?.api?.bodyParser;\n\n  // Explicit opt-out: leave the body untouched so handlers can read raw bytes.\n  if (bodyParser === false) {\n    return { enabled: false };\n  }\n\n  // `true` or `undefined` → default behaviour.\n  if (bodyParser === undefined || bodyParser === true) {\n    return { enabled: true, sizeLimit: defaultSizeLimit };\n  }\n\n  // Object form: honour `sizeLimit` if present and parseable, else default.\n  if (typeof bodyParser === \"object\" && bodyParser !== null) {\n    const parsed = parseSizeLimit(bodyParser.sizeLimit);\n    return { enabled: true, sizeLimit: parsed ?? defaultSizeLimit };\n  }\n\n  // Anything else (truthy non-object/non-true) — be conservative and use\n  // the default, matching Next.js's `!== false` check.\n  return { enabled: true, sizeLimit: defaultSizeLimit };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,MAAa,oCAAoC,IAAI,OAAO;AAS5D,MAAM,aAAqC;CACzC,GAAG;CACH,IAAI;CACJ,IAAI,OAAO;CACX,IAAI,OAAO,OAAO;CAClB,IAAI,OAAO,OAAO,OAAO;CAC1B;;;;;;;;;AAUD,SAAgB,eAAe,OAAwD;CACrF,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM,OAAO,KAAA;CAClD,IAAI,OAAO,UAAU,UACnB,OAAO,OAAO,SAAS,MAAM,IAAI,SAAS,IAAI,QAAQ,KAAA;CAExD,IAAI,OAAO,UAAU,UAAU,OAAO,KAAA;CAEtC,MAAM,UAAU,MAAM,MAAM,CAAC,aAAa;CAC1C,IAAI,CAAC,SAAS,OAAO,KAAA;CAIrB,MAAM,QAAQ,uCAAuC,KAAK,QAAQ;CAClE,IAAI,CAAC,OAAO,OAAO,KAAA;CAEnB,MAAM,SAAS,OAAO,WAAW,MAAM,GAAG;CAC1C,IAAI,CAAC,OAAO,SAAS,OAAO,IAAI,SAAS,GAAG,OAAO,KAAA;CAGnD,MAAM,aAAa,WADN,MAAM,MAAM;CAEzB,IAAI,eAAe,KAAA,GAAW,OAAO,KAAA;CAErC,OAAO,KAAK,MAAM,SAAS,WAAW;;;;;;AAOxC,SAAgB,wBACd,cACA,mBAA2B,mCACD;CAC1B,MAAM,aAAa,cAAc,KAAK;CAGtC,IAAI,eAAe,OACjB,OAAO,EAAE,SAAS,OAAO;CAI3B,IAAI,eAAe,KAAA,KAAa,eAAe,MAC7C,OAAO;EAAE,SAAS;EAAM,WAAW;EAAkB;CAIvD,IAAI,OAAO,eAAe,YAAY,eAAe,MAEnD,OAAO;EAAE,SAAS;EAAM,WADT,eAAe,WAAW,UACA,IAAI;EAAkB;CAKjE,OAAO;EAAE,SAAS;EAAM,WAAW;EAAkB"}

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

@@ -53,6 +53,7 @@ function parseNextDataPathname(pathname, buildId) {
 	if (rest.length === 0) return null;
 	if (rest === "index") return { pagePathname: "/" };
 	if (rest.endsWith("/index")) return { pagePathname: `/${rest.slice(0, -6)}` };
+	if (rest.startsWith("index/")) return { pagePathname: `/${rest.slice(6)}` };
 	return { pagePathname: `/${rest}` };
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"pages-data-route.js","names":[],"sources":["../../src/server/pages-data-route.ts"],"sourcesContent":["/**\n * Helpers for the Pages Router `/_next/data/{buildId}/{...page}.json` endpoint.\n *\n * Next.js uses this endpoint for client-side navigations in the Pages Router:\n * `next/link` and `router.push()` fetch `pageProps` from this URL instead of\n * doing a full HTML navigation. The server must:\n *   1. Match the URL pattern and extract the page pathname (with the buildId\n *      and `.json` extension removed, locale prefix preserved).\n *   2. Normalize the URL BEFORE middleware runs so middleware sees the page\n *      path (e.g. `/about`) rather than the raw `/_next/data/.../about.json`.\n *   3. Invoke the same `getServerSideProps` / `getStaticProps` machinery as\n *      the HTML page and serialize the resulting props as a JSON envelope:\n *      `{ pageProps: ... }` with `Content-Type: application/json`.\n *\n * Ported from Next.js:\n *   - `packages/next/src/server/normalizers/request/next-data.ts` — prefix/suffix matcher.\n *   - `packages/next/src/server/base-server.ts` (`handleNextDataRequest`) — pipeline normalization.\n *   - `packages/next/src/server/render.tsx` — JSON envelope emission (`isNextDataRequest`).\n */\n\nconst NEXT_DATA_PREFIX = \"/_next/data/\";\nconst NEXT_DATA_SUFFIX = \".json\";\n\ntype NextDataMatch = {\n  /**\n   * The normalized page pathname (with leading slash, no trailing slash,\n   * `.json` stripped, buildId stripped). For locale-prefixed requests like\n   * `/_next/data/<buildId>/en/about.json` this is `/en/about` — locale\n   * handling is done downstream by the existing `resolvePagesI18nRequest`\n   * pipeline so this helper does not need to know about i18n config.\n   */\n  pagePathname: string;\n};\n\n/**\n * Returns true if the pathname looks like a `_next/data` request, regardless\n * of buildId. Used by the request pipeline to short-circuit before middleware\n * even when the buildId is wrong (so we can still return a 404 JSON response).\n */\nexport function isNextDataPathname(pathname: string): boolean {\n  return pathname.startsWith(NEXT_DATA_PREFIX) && pathname.endsWith(NEXT_DATA_SUFFIX);\n}\n\n/**\n * Parse `/_next/data/<buildId>/<...page>.json` and return the normalized page\n * pathname. Returns `null` if the pathname does not match the pattern or if\n * the buildId segment does not match the server's buildId.\n *\n * The returned `pagePathname` is the page route path Next.js would render for\n * the equivalent HTML navigation — including any locale prefix, which is then\n * stripped by `resolvePagesI18nRequest` downstream.\n *\n * `/_next/data/<buildId>/about.json`         → `/about`\n * `/_next/data/<buildId>/en/about.json`      → `/en/about`\n * `/_next/data/<buildId>/index.json`         → `/`\n * `/_next/data/<buildId>/en.json`            → `/en`\n * `/_next/data/<wrong-id>/about.json`        → null\n * `/_next/data/<buildId>/about`              → null  (missing .json suffix)\n */\nexport function parseNextDataPathname(pathname: string, buildId: string): NextDataMatch | null {\n  if (!buildId) return null;\n  if (!isNextDataPathname(pathname)) return null;\n\n  const expectedPrefix = `${NEXT_DATA_PREFIX}${buildId}/`;\n  // `/_next/data/<buildId>.json` (no trailing slash) is not a valid data req.\n  if (!pathname.startsWith(expectedPrefix)) return null;\n\n  const rest = pathname.slice(expectedPrefix.length, -NEXT_DATA_SUFFIX.length);\n\n  // Empty rest (`/_next/data/<buildId>/.json`) is not a valid page path.\n  if (rest.length === 0) return null;\n\n  // Next.js denormalizes `index` to `/` to mirror file-system page paths\n  // (`pages/index.tsx` → `/`). See `denormalizePagePath` in Next.js.\n  if (rest === \"index\") return { pagePathname: \"/\" };\n  if (rest.endsWith(\"/index\")) return { pagePathname: `/${rest.slice(0, -\"/index\".length)}` };\n\n  return { pagePathname: `/${rest}` };\n}\n\n/**\n * Build the JSON envelope returned by `/_next/data/<buildId>/<page>.json`.\n * Mirrors Next.js' `RenderResult(JSON.stringify(props))` path in\n * `packages/next/src/server/render.tsx` (search for `isNextDataRequest`).\n *\n * The envelope is the outer `props` object the React tree would receive:\n *   { pageProps: {...}, /* optional locale data, redirect markers, etc. *\\/ }\n */\nexport function buildNextDataJsonResponse(\n  pageProps: Record<string, unknown>,\n  safeJsonStringify: (value: unknown) => string,\n  init?: ResponseInit,\n): Response {\n  const body = safeJsonStringify({ pageProps });\n  return new Response(body, {\n    status: init?.status ?? 200,\n    statusText: init?.statusText,\n    headers: {\n      \"Content-Type\": \"application/json\",\n      ...(init?.headers as Record<string, string> | undefined),\n    },\n  });\n}\n\n/**\n * Build the 404 response Next.js returns for an unknown `_next/data` page.\n * Next.js renders this as a normal 404 page, but the body shape that clients\n * see for a missing page-data endpoint is the literal string `\"{ }\"` for the\n * body and a 404 status with `application/json` so client-side hard-navigation\n * fallback fires (see `__N_SSP` handling in `router.ts`).\n *\n * We match Next.js' behavior: 404 status + JSON content type. The body is an\n * empty JSON object so clients that blindly call `res.json()` do not throw\n * before checking the status code.\n */\nexport function buildNextDataNotFoundResponse(): Response {\n  return new Response(\"{}\", {\n    status: 404,\n    headers: { \"Content-Type\": \"application/json\" },\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,MAAM,mBAAmB;AACzB,MAAM,mBAAmB;;;;;;AAkBzB,SAAgB,mBAAmB,UAA2B;CAC5D,OAAO,SAAS,WAAW,iBAAiB,IAAI,SAAS,SAAS,iBAAiB;;;;;;;;;;;;;;;;;;AAmBrF,SAAgB,sBAAsB,UAAkB,SAAuC;CAC7F,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI,CAAC,mBAAmB,SAAS,EAAE,OAAO;CAE1C,MAAM,iBAAiB,GAAG,mBAAmB,QAAQ;CAErD,IAAI,CAAC,SAAS,WAAW,eAAe,EAAE,OAAO;CAEjD,MAAM,OAAO,SAAS,MAAM,eAAe,QAAQ,GAAyB;CAG5E,IAAI,KAAK,WAAW,GAAG,OAAO;CAI9B,IAAI,SAAS,SAAS,OAAO,EAAE,cAAc,KAAK;CAClD,IAAI,KAAK,SAAS,SAAS,EAAE,OAAO,EAAE,cAAc,IAAI,KAAK,MAAM,GAAG,GAAiB,IAAI;CAE3F,OAAO,EAAE,cAAc,IAAI,QAAQ;;;;;;;;;;AAWrC,SAAgB,0BACd,WACA,mBACA,MACU;CACV,MAAM,OAAO,kBAAkB,EAAE,WAAW,CAAC;CAC7C,OAAO,IAAI,SAAS,MAAM;EACxB,QAAQ,MAAM,UAAU;EACxB,YAAY,MAAM;EAClB,SAAS;GACP,gBAAgB;GAChB,GAAI,MAAM;GACX;EACF,CAAC;;;;;;;;;;;;;AAcJ,SAAgB,gCAA0C;CACxD,OAAO,IAAI,SAAS,MAAM;EACxB,QAAQ;EACR,SAAS,EAAE,gBAAgB,oBAAoB;EAChD,CAAC"}
+{"version":3,"file":"pages-data-route.js","names":[],"sources":["../../src/server/pages-data-route.ts"],"sourcesContent":["/**\n * Helpers for the Pages Router `/_next/data/{buildId}/{...page}.json` endpoint.\n *\n * Next.js uses this endpoint for client-side navigations in the Pages Router:\n * `next/link` and `router.push()` fetch `pageProps` from this URL instead of\n * doing a full HTML navigation. The server must:\n *   1. Match the URL pattern and extract the page pathname (with the buildId\n *      and `.json` extension removed, locale prefix preserved).\n *   2. Normalize the URL BEFORE middleware runs so middleware sees the page\n *      path (e.g. `/about`) rather than the raw `/_next/data/.../about.json`.\n *   3. Invoke the same `getServerSideProps` / `getStaticProps` machinery as\n *      the HTML page and serialize the resulting props as a JSON envelope:\n *      `{ pageProps: ... }` with `Content-Type: application/json`.\n *\n * Ported from Next.js:\n *   - `packages/next/src/server/normalizers/request/next-data.ts` — prefix/suffix matcher.\n *   - `packages/next/src/server/base-server.ts` (`handleNextDataRequest`) — pipeline normalization.\n *   - `packages/next/src/server/render.tsx` — JSON envelope emission (`isNextDataRequest`).\n */\n\nconst NEXT_DATA_PREFIX = \"/_next/data/\";\nconst NEXT_DATA_SUFFIX = \".json\";\n\ntype NextDataMatch = {\n  /**\n   * The normalized page pathname (with leading slash, no trailing slash,\n   * `.json` stripped, buildId stripped). For locale-prefixed requests like\n   * `/_next/data/<buildId>/en/about.json` this is `/en/about` — locale\n   * handling is done downstream by the existing `resolvePagesI18nRequest`\n   * pipeline so this helper does not need to know about i18n config.\n   */\n  pagePathname: string;\n};\n\n/**\n * Returns true if the pathname looks like a `_next/data` request, regardless\n * of buildId. Used by the request pipeline to short-circuit before middleware\n * even when the buildId is wrong (so we can still return a 404 JSON response).\n */\nexport function isNextDataPathname(pathname: string): boolean {\n  return pathname.startsWith(NEXT_DATA_PREFIX) && pathname.endsWith(NEXT_DATA_SUFFIX);\n}\n\n/**\n * Parse `/_next/data/<buildId>/<...page>.json` and return the normalized page\n * pathname. Returns `null` if the pathname does not match the pattern or if\n * the buildId segment does not match the server's buildId.\n *\n * The returned `pagePathname` is the page route path Next.js would render for\n * the equivalent HTML navigation — including any locale prefix, which is then\n * stripped by `resolvePagesI18nRequest` downstream.\n *\n * `/_next/data/<buildId>/about.json`         → `/about`\n * `/_next/data/<buildId>/en/about.json`      → `/en/about`\n * `/_next/data/<buildId>/index.json`         → `/`\n * `/_next/data/<buildId>/en.json`            → `/en`\n * `/_next/data/<wrong-id>/about.json`        → null\n * `/_next/data/<buildId>/about`              → null  (missing .json suffix)\n */\nexport function parseNextDataPathname(pathname: string, buildId: string): NextDataMatch | null {\n  if (!buildId) return null;\n  if (!isNextDataPathname(pathname)) return null;\n\n  const expectedPrefix = `${NEXT_DATA_PREFIX}${buildId}/`;\n  // `/_next/data/<buildId>.json` (no trailing slash) is not a valid data req.\n  if (!pathname.startsWith(expectedPrefix)) return null;\n\n  const rest = pathname.slice(expectedPrefix.length, -NEXT_DATA_SUFFIX.length);\n\n  // Empty rest (`/_next/data/<buildId>/.json`) is not a valid page path.\n  if (rest.length === 0) return null;\n\n  // Next.js denormalizes `index` to `/` to mirror file-system page paths\n  // (`pages/index.tsx` → `/`). See `denormalizePagePath` in Next.js.\n  if (rest === \"index\") return { pagePathname: \"/\" };\n  if (rest.endsWith(\"/index\")) return { pagePathname: `/${rest.slice(0, -\"/index\".length)}` };\n\n  // The encoder (`getAssetPathFromRoute` in Next.js / `buildPagesDataPath` in\n  // vinext) prefixes any path beginning with `index` with an extra `index/`\n  // segment so an explicit `pages/index/foo.tsx` page (route `/index/foo`)\n  // round-trips through the data URL without colliding with `/foo`. Strip\n  // that prefix here.\n  if (rest.startsWith(\"index/\")) return { pagePathname: `/${rest.slice(\"index/\".length)}` };\n\n  return { pagePathname: `/${rest}` };\n}\n\n/**\n * Build the JSON envelope returned by `/_next/data/<buildId>/<page>.json`.\n * Mirrors Next.js' `RenderResult(JSON.stringify(props))` path in\n * `packages/next/src/server/render.tsx` (search for `isNextDataRequest`).\n *\n * The envelope is the outer `props` object the React tree would receive:\n *   { pageProps: {...}, /* optional locale data, redirect markers, etc. *\\/ }\n */\nexport function buildNextDataJsonResponse(\n  pageProps: Record<string, unknown>,\n  safeJsonStringify: (value: unknown) => string,\n  init?: ResponseInit,\n): Response {\n  const body = safeJsonStringify({ pageProps });\n  return new Response(body, {\n    status: init?.status ?? 200,\n    statusText: init?.statusText,\n    headers: {\n      \"Content-Type\": \"application/json\",\n      ...(init?.headers as Record<string, string> | undefined),\n    },\n  });\n}\n\n/**\n * Build the 404 response Next.js returns for an unknown `_next/data` page.\n * Next.js renders this as a normal 404 page, but the body shape that clients\n * see for a missing page-data endpoint is the literal string `\"{ }\"` for the\n * body and a 404 status with `application/json` so client-side hard-navigation\n * fallback fires (see `__N_SSP` handling in `router.ts`).\n *\n * We match Next.js' behavior: 404 status + JSON content type. The body is an\n * empty JSON object so clients that blindly call `res.json()` do not throw\n * before checking the status code.\n */\nexport function buildNextDataNotFoundResponse(): Response {\n  return new Response(\"{}\", {\n    status: 404,\n    headers: { \"Content-Type\": \"application/json\" },\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,MAAM,mBAAmB;AACzB,MAAM,mBAAmB;;;;;;AAkBzB,SAAgB,mBAAmB,UAA2B;CAC5D,OAAO,SAAS,WAAW,iBAAiB,IAAI,SAAS,SAAS,iBAAiB;;;;;;;;;;;;;;;;;;AAmBrF,SAAgB,sBAAsB,UAAkB,SAAuC;CAC7F,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI,CAAC,mBAAmB,SAAS,EAAE,OAAO;CAE1C,MAAM,iBAAiB,GAAG,mBAAmB,QAAQ;CAErD,IAAI,CAAC,SAAS,WAAW,eAAe,EAAE,OAAO;CAEjD,MAAM,OAAO,SAAS,MAAM,eAAe,QAAQ,GAAyB;CAG5E,IAAI,KAAK,WAAW,GAAG,OAAO;CAI9B,IAAI,SAAS,SAAS,OAAO,EAAE,cAAc,KAAK;CAClD,IAAI,KAAK,SAAS,SAAS,EAAE,OAAO,EAAE,cAAc,IAAI,KAAK,MAAM,GAAG,GAAiB,IAAI;CAO3F,IAAI,KAAK,WAAW,SAAS,EAAE,OAAO,EAAE,cAAc,IAAI,KAAK,MAAM,EAAgB,IAAI;CAEzF,OAAO,EAAE,cAAc,IAAI,QAAQ;;;;;;;;;;AAWrC,SAAgB,0BACd,WACA,mBACA,MACU;CACV,MAAM,OAAO,kBAAkB,EAAE,WAAW,CAAC;CAC7C,OAAO,IAAI,SAAS,MAAM;EACxB,QAAQ,MAAM,UAAU;EACxB,YAAY,MAAM;EAClB,SAAS;GACP,gBAAgB;GAChB,GAAI,MAAM;GACX;EACF,CAAC;;;;;;;;;;;;;AAcJ,SAAgB,gCAA0C;CACxD,OAAO,IAAI,SAAS,MAAM;EACxB,QAAQ;EACR,SAAS,EAAE,gBAAgB,oBAAoB;EAChD,CAAC"}

package/dist/server/pages-default-404.d.ts

@@ -0,0 +1,31 @@
+//#region src/server/pages-default-404.d.ts
+/**
+ * Default 404 HTML body for the Pages Router.
+ *
+ * Used when a Pages Router request does not match any route (and the app has
+ * not supplied a custom `pages/404.tsx`). Mirrors the markup Next.js's
+ * `pages/_error.tsx` produces for a 404 response: a centered status / message
+ * pair plus minified theme CSS and dark-mode media query. The message string
+ * `"This page could not be found."` (note the trailing period) is the
+ * canonical body asserted by Next.js's deploy suite
+ * (`test/e2e/getserversideprops/test/index.test.ts`,
+ * `test/e2e/basepath/error-pages.test.ts`).
+ *
+ * Kept as a hand-rendered HTML literal rather than a React-rendered template
+ * because the Pages Router server entry is invoked from both Workers and the
+ * dev server before any React-renderer wiring is available for this path —
+ * matching the lightweight build-time strategy Next.js uses for its packaged
+ * `_error` static fallback. See:
+ *   .nextjs-ref/packages/next/src/pages/_error.tsx
+ */
+/**
+ * Build the Next.js-compatible default 404 HTML response for the Pages Router.
+ * Content-type is `text/html; charset=utf-8`, matching Next.js's
+ * `pages-handler` 404 response.
+ */
+declare function buildDefaultPagesNotFoundResponse(): Response;
+/** Exported for tests / callers that need the raw HTML body. */
+declare const DEFAULT_PAGES_NOT_FOUND_HTML = "<!DOCTYPE html><html><head><meta charset=\"utf-8\"/><meta name=\"viewport\" content=\"width=device-width\"/><title>404: This page could not be found.</title><meta name=\"next-head-count\" content=\"2\"/><style data-next-hide-fouc=\"true\">body{display:none}</style><noscript data-next-hide-fouc=\"true\"><style>body{display:block}</style></noscript></head><body><div id=\"__next\"><div style=\"font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center\"><div style=\"line-height:48px\"><style>body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}</style><h1 class=\"next-error-h1\" style=\"display:inline-block;margin:0 20px 0 0;padding-right:23px;font-size:24px;font-weight:500;vertical-align:top\">404</h1><div style=\"display:inline-block\"><h2 style=\"font-size:14px;font-weight:400;line-height:28px\">This page could not be found.</h2></div></div></div></div></body></html>";
+//#endregion
+export { DEFAULT_PAGES_NOT_FOUND_HTML, buildDefaultPagesNotFoundResponse };
+//# sourceMappingURL=pages-default-404.d.ts.map

package/dist/server/pages-default-404.js

@@ -0,0 +1,40 @@
+//#region src/server/pages-default-404.ts
+/**
+* Default 404 HTML body for the Pages Router.
+*
+* Used when a Pages Router request does not match any route (and the app has
+* not supplied a custom `pages/404.tsx`). Mirrors the markup Next.js's
+* `pages/_error.tsx` produces for a 404 response: a centered status / message
+* pair plus minified theme CSS and dark-mode media query. The message string
+* `"This page could not be found."` (note the trailing period) is the
+* canonical body asserted by Next.js's deploy suite
+* (`test/e2e/getserversideprops/test/index.test.ts`,
+* `test/e2e/basepath/error-pages.test.ts`).
+*
+* Kept as a hand-rendered HTML literal rather than a React-rendered template
+* because the Pages Router server entry is invoked from both Workers and the
+* dev server before any React-renderer wiring is available for this path —
+* matching the lightweight build-time strategy Next.js uses for its packaged
+* `_error` static fallback. See:
+*   .nextjs-ref/packages/next/src/pages/_error.tsx
+*/
+const STATUS = 404;
+const MESSAGE = "This page could not be found.";
+const HTML = `<!DOCTYPE html><html><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width"/><title>${STATUS}: ${MESSAGE}</title><meta name="next-head-count" content="2"/><style data-next-hide-fouc="true">body{display:none}</style><noscript data-next-hide-fouc="true"><style>body{display:block}</style></noscript></head><body><div id="__next"><div style="font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center"><div style="line-height:48px"><style>body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}</style><h1 class="next-error-h1" style="display:inline-block;margin:0 20px 0 0;padding-right:23px;font-size:24px;font-weight:500;vertical-align:top">${STATUS}</h1><div style="display:inline-block"><h2 style="font-size:14px;font-weight:400;line-height:28px">${MESSAGE}</h2></div></div></div></div></body></html>`;
+/**
+* Build the Next.js-compatible default 404 HTML response for the Pages Router.
+* Content-type is `text/html; charset=utf-8`, matching Next.js's
+* `pages-handler` 404 response.
+*/
+function buildDefaultPagesNotFoundResponse() {
+	return new Response(HTML, {
+		status: STATUS,
+		headers: { "Content-Type": "text/html; charset=utf-8" }
+	});
+}
+/** Exported for tests / callers that need the raw HTML body. */
+const DEFAULT_PAGES_NOT_FOUND_HTML = HTML;
+//#endregion
+export { DEFAULT_PAGES_NOT_FOUND_HTML, buildDefaultPagesNotFoundResponse };
+
+//# sourceMappingURL=pages-default-404.js.map

package/dist/server/pages-default-404.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages-default-404.js","names":[],"sources":["../../src/server/pages-default-404.ts"],"sourcesContent":["/**\n * Default 404 HTML body for the Pages Router.\n *\n * Used when a Pages Router request does not match any route (and the app has\n * not supplied a custom `pages/404.tsx`). Mirrors the markup Next.js's\n * `pages/_error.tsx` produces for a 404 response: a centered status / message\n * pair plus minified theme CSS and dark-mode media query. The message string\n * `\"This page could not be found.\"` (note the trailing period) is the\n * canonical body asserted by Next.js's deploy suite\n * (`test/e2e/getserversideprops/test/index.test.ts`,\n * `test/e2e/basepath/error-pages.test.ts`).\n *\n * Kept as a hand-rendered HTML literal rather than a React-rendered template\n * because the Pages Router server entry is invoked from both Workers and the\n * dev server before any React-renderer wiring is available for this path —\n * matching the lightweight build-time strategy Next.js uses for its packaged\n * `_error` static fallback. See:\n *   .nextjs-ref/packages/next/src/pages/_error.tsx\n */\n\nconst STATUS = 404;\nconst MESSAGE = \"This page could not be found.\";\n\nconst CSS = `body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}`;\n\nconst HTML = `<!DOCTYPE html><html><head><meta charset=\"utf-8\"/><meta name=\"viewport\" content=\"width=device-width\"/><title>${STATUS}: ${MESSAGE}</title><meta name=\"next-head-count\" content=\"2\"/><style data-next-hide-fouc=\"true\">body{display:none}</style><noscript data-next-hide-fouc=\"true\"><style>body{display:block}</style></noscript></head><body><div id=\"__next\"><div style=\"font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center\"><div style=\"line-height:48px\"><style>${CSS}</style><h1 class=\"next-error-h1\" style=\"display:inline-block;margin:0 20px 0 0;padding-right:23px;font-size:24px;font-weight:500;vertical-align:top\">${STATUS}</h1><div style=\"display:inline-block\"><h2 style=\"font-size:14px;font-weight:400;line-height:28px\">${MESSAGE}</h2></div></div></div></div></body></html>`;\n\n/**\n * Build the Next.js-compatible default 404 HTML response for the Pages Router.\n * Content-type is `text/html; charset=utf-8`, matching Next.js's\n * `pages-handler` 404 response.\n */\nexport function buildDefaultPagesNotFoundResponse(): Response {\n  return new Response(HTML, {\n    status: STATUS,\n    headers: { \"Content-Type\": \"text/html; charset=utf-8\" },\n  });\n}\n\n/** Exported for tests / callers that need the raw HTML body. */\nexport const DEFAULT_PAGES_NOT_FOUND_HTML = HTML;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,MAAM,SAAS;AACf,MAAM,UAAU;AAIhB,MAAM,OAAO,gHAAgH,OAAO,IAAI,QAAQ,u3BAAgqB,OAAO,qGAAqG,QAAQ;;;;;;AAOp6B,SAAgB,oCAA8C;CAC5D,OAAO,IAAI,SAAS,MAAM;EACxB,QAAQ;EACR,SAAS,EAAE,gBAAgB,4BAA4B;EACxD,CAAC;;;AAIJ,MAAa,+BAA+B"}

package/dist/server/pages-document-initial-props.d.ts

@@ -0,0 +1,7 @@
+import { ComponentType } from "react";
+
+//#region src/server/pages-document-initial-props.d.ts
+declare function loadUserDocumentInitialProps(DocumentComponent: ComponentType): Promise<Record<string, unknown> | null>;
+//#endregion
+export { loadUserDocumentInitialProps };
+//# sourceMappingURL=pages-document-initial-props.d.ts.map

package/dist/server/pages-document-initial-props.js

@@ -0,0 +1,14 @@
+import Document from "../shims/document.js";
+//#region src/server/pages-document-initial-props.ts
+const BASE_GET_INITIAL_PROPS = Document.getInitialProps;
+async function loadUserDocumentInitialProps(DocumentComponent) {
+	const getInitialProps = DocumentComponent.getInitialProps;
+	if (typeof getInitialProps !== "function") return null;
+	if (getInitialProps === BASE_GET_INITIAL_PROPS) return null;
+	const result = await getInitialProps({});
+	return result && typeof result === "object" ? result : null;
+}
+//#endregion
+export { loadUserDocumentInitialProps };
+
+//# sourceMappingURL=pages-document-initial-props.js.map

package/dist/server/pages-document-initial-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages-document-initial-props.js","names":["BaseDocument"],"sources":["../../src/server/pages-document-initial-props.ts"],"sourcesContent":["/**\n * Pages Router `_document.tsx` `getInitialProps` helper.\n *\n * Next.js's `pages/_document.tsx` may override\n * `static async getInitialProps(ctx)` to inject extra props onto the\n * Document element (the classic pattern is\n * `await Document.getInitialProps(ctx)` + spread, see Next.js's\n * `test/e2e/async-modules/pages/_document.jsx`). The SSR pipeline invokes\n * that hook and then renders the Document with the resolved props:\n *\n *   <Document {...htmlProps} {...docProps} />\n *\n * Reference:\n * https://github.com/vercel/next.js/blob/canary/packages/next/src/server/render.tsx\n * (search for `loadDocumentInitialProps` and `documentElement`).\n *\n * vinext only forwards `docProps`. The full `DocumentContext`\n * (`renderPage`, `defaultGetInitialProps`, `pathname`, `query`, `req`, `res`,\n * `err`, `asPath`) is not yet plumbed through. The common upstream pattern\n *\n *   static async getInitialProps(ctx) {\n *     const initialProps = await Document.getInitialProps(ctx)\n *     return { ...initialProps, docValue }\n *   }\n *\n * works because the base `Document.getInitialProps` shim in\n * `shims/document.tsx` returns `{ html: \"\" }` and ignores `ctx`. User\n * overrides that *only* read `ctx` will see `undefined` fields — that is a\n * separate gap tracked alongside the shim TODO.\n *\n * Returns `null` when the user did not override the base shim (the static\n * `getInitialProps` reference still points at the shim's stub) so callers\n * skip the spread and render the bare Document element on the fast path.\n *\n * Errors from a user `getInitialProps` propagate to the caller. Next.js's\n * `loadGetInitialProps` does not catch — a throw becomes a 500 — and vinext\n * matches that contract so user bugs surface as the loud failures Next.js\n * apps already debug against.\n */\nimport type { ComponentType } from \"react\";\n// Static import so the identity comparison below is established once at\n// module evaluation. A previous version used `await import(...)` per request\n// and was flagged by reviewers as unnecessary work — and worse, it left a\n// per-request `await` on the fast path where the user had no override.\nimport BaseDocument from \"vinext/shims/document\";\n\nconst BASE_GET_INITIAL_PROPS = (\n  BaseDocument as unknown as {\n    getInitialProps?: unknown;\n  }\n).getInitialProps;\n\nexport async function loadUserDocumentInitialProps(\n  DocumentComponent: ComponentType,\n): Promise<Record<string, unknown> | null> {\n  const getInitialProps = (\n    DocumentComponent as unknown as {\n      getInitialProps?: (\n        ctx: unknown,\n      ) => Promise<Record<string, unknown>> | Record<string, unknown>;\n    }\n  ).getInitialProps;\n  if (typeof getInitialProps !== \"function\") return null;\n\n  // Identity check: if the user did not override `static getInitialProps`,\n  // the inherited reference is the shim's stub. Skip the call so the\n  // fast path keeps the same number of awaits as before this helper landed.\n  if (getInitialProps === BASE_GET_INITIAL_PROPS) return null;\n\n  // Pass ctx as `{}`. Most upstream overrides only use ctx to delegate\n  // back to `Document.getInitialProps`, which the shim ignores. Errors\n  // propagate — matching Next.js's `loadGetInitialProps`, which has no\n  // catch and surfaces user bugs as 500s.\n  const result = await getInitialProps({});\n  return result && typeof result === \"object\" ? (result as Record<string, unknown>) : null;\n}\n"],"mappings":";;AA8CA,MAAM,yBACJA,SAGA;AAEF,eAAsB,6BACpB,mBACyC;CACzC,MAAM,kBACJ,kBAKA;CACF,IAAI,OAAO,oBAAoB,YAAY,OAAO;CAKlD,IAAI,oBAAoB,wBAAwB,OAAO;CAMvD,MAAM,SAAS,MAAM,gBAAgB,EAAE,CAAC;CACxC,OAAO,UAAU,OAAO,WAAW,WAAY,SAAqC"}

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

@@ -37,6 +37,16 @@ type CreatePagesReqResResult = {
   res: PagesReqResResponse;
   responsePromise: Promise<Response>;
 };
+/**
+ * Read and parse a Pages Router API request body for the Workers/prod path.
+ *
+ * `maxBytes` defaults to the 1 MB Next.js default but may be overridden by
+ * `export const config = { api: { bodyParser: { sizeLimit: '4mb' } } }` on
+ * the route module. Handlers that opt out entirely (`bodyParser: false`)
+ * MUST skip this function so the body stream stays intact for user code.
+ *
+ * @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 createPagesReqRes(options: CreatePagesReqResOptions): CreatePagesReqResResult;
 //#endregion

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

@@ -1,15 +1,26 @@
 import { parseCookies } from "../config/config-matchers.js";
 import { PagesBodyParseError, getMediaType, isJsonMediaType } from "./pages-media-type.js";
+import { DEFAULT_PAGES_API_BODY_SIZE_LIMIT } from "./pages-body-parser-config.js";
 import { readStreamAsTextWithLimit } from "../utils/text-stream.js";
 import { decode } from "node:querystring";
 //#region src/server/pages-node-compat.ts
-const MAX_PAGES_API_BODY_SIZE = 1 * 1024 * 1024;
+const MAX_PAGES_API_BODY_SIZE = DEFAULT_PAGES_API_BODY_SIZE_LIMIT;
 async function readPagesRequestBodyWithLimit(request, maxBytes) {
 	if (!request.body) return "";
 	return readStreamAsTextWithLimit(request.body, maxBytes, () => {
 		throw new PagesBodyParseError("Request body too large", 413);
 	});
 }
+/**
+* Read and parse a Pages Router API request body for the Workers/prod path.
+*
+* `maxBytes` defaults to the 1 MB Next.js default but may be overridden by
+* `export const config = { api: { bodyParser: { sizeLimit: '4mb' } } }` on
+* the route module. Handlers that opt out entirely (`bodyParser: false`)
+* MUST skip this function so the body stream stays intact for user code.
+*
+* @see https://nextjs.org/docs/pages/building-your-application/routing/api-routes#custom-config
+*/
 async function parsePagesApiBody(request, maxBytes = MAX_PAGES_API_BODY_SIZE) {
 	if (Number.parseInt(request.headers.get("content-length") || "0", 10) > maxBytes) throw new PagesBodyParseError("Request body too large", 413);
 	let rawBody = "";

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

@@ -1 +1 @@
-{"version":3,"file":"pages-node-compat.js","names":["decodeQueryString"],"sources":["../../src/server/pages-node-compat.ts"],"sourcesContent":["import { decode as decodeQueryString } from \"node:querystring\";\nimport { parseCookies } from \"../config/config-matchers.js\";\nimport { readStreamAsTextWithLimit } from \"../utils/text-stream.js\";\nimport { PagesBodyParseError, getMediaType, isJsonMediaType } from \"./pages-media-type.js\";\n\nconst MAX_PAGES_API_BODY_SIZE = 1 * 1024 * 1024;\n\n/**\n * @deprecated Use PagesBodyParseError from pages-media-type.ts instead.\n * Kept for backwards compatibility.\n */\nexport { PagesBodyParseError as PagesApiBodyParseError };\n\nexport type PagesRequestQuery = Record<string, string | string[]>;\n\nexport type PagesReqResRequest = {\n  method: string;\n  url: string;\n  headers: Record<string, string>;\n  query: PagesRequestQuery;\n  body: unknown;\n  cookies: Record<string, string>;\n};\n\nexport type PagesReqResHeaders = {\n  [key: string]: string | number | boolean | string[];\n};\n\nexport type PagesReqResResponse = {\n  statusCode: number;\n  readonly headersSent: boolean;\n  writeHead: (code: number, headers?: PagesReqResHeaders) => PagesReqResResponse;\n  setHeader: (name: string, value: string | number | boolean | string[]) => PagesReqResResponse;\n  getHeader: (name: string) => string | number | boolean | string[] | undefined;\n  end: (data?: BodyInit | null) => void;\n  status: (code: number) => PagesReqResResponse;\n  json: (data: unknown) => void;\n  send: (data: unknown) => void;\n  redirect: (statusOrUrl: number | string, url?: string) => void;\n  getHeaders: () => PagesReqResHeaders;\n};\n\ntype CreatePagesReqResOptions = {\n  body: unknown;\n  query: PagesRequestQuery;\n  request: Request;\n  url: string;\n};\n\ntype CreatePagesReqResResult = {\n  req: PagesReqResRequest;\n  res: PagesReqResResponse;\n  responsePromise: Promise<Response>;\n};\n\nasync function readPagesRequestBodyWithLimit(request: Request, maxBytes: number): Promise<string> {\n  if (!request.body) {\n    return \"\";\n  }\n\n  return readStreamAsTextWithLimit(request.body, maxBytes, () => {\n    throw new PagesBodyParseError(\"Request body too large\", 413);\n  });\n}\n\nexport async function parsePagesApiBody(\n  request: Request,\n  maxBytes = MAX_PAGES_API_BODY_SIZE,\n): Promise<unknown> {\n  const contentLength = Number.parseInt(request.headers.get(\"content-length\") || \"0\", 10);\n  if (contentLength > maxBytes) {\n    throw new PagesBodyParseError(\"Request body too large\", 413);\n  }\n\n  let rawBody = \"\";\n  try {\n    rawBody = await readPagesRequestBodyWithLimit(request, maxBytes);\n  } catch (err) {\n    if (err instanceof PagesBodyParseError) {\n      throw err;\n    }\n    throw new PagesBodyParseError(\"Request body too large\", 413);\n  }\n\n  const mediaType = getMediaType(request.headers.get(\"content-type\"));\n  if (!rawBody) {\n    return isJsonMediaType(mediaType)\n      ? {}\n      : mediaType === \"application/x-www-form-urlencoded\"\n        ? decodeQueryString(rawBody)\n        : undefined;\n  }\n\n  if (isJsonMediaType(mediaType)) {\n    try {\n      return JSON.parse(rawBody);\n    } catch {\n      throw new PagesBodyParseError(\"Invalid JSON\", 400);\n    }\n  }\n\n  if (mediaType === \"application/x-www-form-urlencoded\") {\n    return decodeQueryString(rawBody);\n  }\n\n  return rawBody;\n}\n\nexport function createPagesReqRes(options: CreatePagesReqResOptions): CreatePagesReqResResult {\n  const headersObj: Record<string, string> = {};\n  for (const [key, value] of options.request.headers) {\n    headersObj[key.toLowerCase()] = value;\n  }\n\n  const req: PagesReqResRequest = {\n    method: options.request.method,\n    url: options.url,\n    headers: headersObj,\n    query: options.query,\n    body: options.body,\n    cookies: parseCookies(options.request.headers.get(\"cookie\")),\n  };\n\n  let resStatusCode = 200;\n  const resHeaders: Record<string, string | number | boolean> = {};\n  const setCookieHeaders: string[] = [];\n  let resBody: BodyInit | null = null;\n  let ended = false;\n  let resolveResponse!: (value: Response) => void;\n  const responsePromise = new Promise<Response>((resolve) => {\n    resolveResponse = resolve;\n  });\n\n  const res: PagesReqResResponse = {\n    get statusCode() {\n      return resStatusCode;\n    },\n    set statusCode(code) {\n      resStatusCode = code;\n    },\n    get headersSent() {\n      return ended;\n    },\n    writeHead(code, headers) {\n      resStatusCode = code;\n      if (headers) {\n        for (const [key, value] of Object.entries(headers)) {\n          if (key.toLowerCase() === \"set-cookie\") {\n            if (Array.isArray(value)) {\n              setCookieHeaders.push(...value.map(String));\n            } else {\n              setCookieHeaders.push(String(value));\n            }\n          } else {\n            resHeaders[key.toLowerCase()] = Array.isArray(value) ? value.join(\", \") : value;\n          }\n        }\n      }\n      return res;\n    },\n    setHeader(name, value) {\n      if (name.toLowerCase() === \"set-cookie\") {\n        // Node.js res.setHeader() replaces the existing value entirely.\n        setCookieHeaders.length = 0;\n        if (Array.isArray(value)) {\n          setCookieHeaders.push(...value.map(String));\n        } else {\n          setCookieHeaders.push(String(value));\n        }\n      } else {\n        resHeaders[name.toLowerCase()] = Array.isArray(value) ? value.join(\", \") : value;\n      }\n      return res;\n    },\n    getHeader(name) {\n      if (name.toLowerCase() === \"set-cookie\") {\n        return setCookieHeaders.length > 0 ? setCookieHeaders : undefined;\n      }\n      return resHeaders[name.toLowerCase()];\n    },\n    end(data) {\n      if (ended) {\n        return;\n      }\n      ended = true;\n      if (data !== undefined && data !== null) {\n        resBody = data;\n      }\n      const headers = new Headers();\n      for (const [key, value] of Object.entries(resHeaders)) {\n        headers.set(key, String(value));\n      }\n      for (const cookie of setCookieHeaders) {\n        headers.append(\"set-cookie\", cookie);\n      }\n      resolveResponse(new Response(resBody, { status: resStatusCode, headers }));\n    },\n    status(code) {\n      resStatusCode = code;\n      return res;\n    },\n    json(data) {\n      resHeaders[\"content-type\"] = \"application/json\";\n      res.end(JSON.stringify(data));\n    },\n    send(data) {\n      if (Buffer.isBuffer(data)) {\n        if (!resHeaders[\"content-type\"]) {\n          resHeaders[\"content-type\"] = \"application/octet-stream\";\n        }\n        resHeaders[\"content-length\"] = String(data.length);\n        res.end(new Uint8Array(data));\n        return;\n      }\n\n      if (typeof data === \"object\" && data !== null) {\n        resHeaders[\"content-type\"] = \"application/json\";\n        res.end(JSON.stringify(data));\n        return;\n      }\n\n      if (!resHeaders[\"content-type\"]) {\n        resHeaders[\"content-type\"] = \"text/plain\";\n      }\n      res.end(String(data));\n    },\n    redirect(statusOrUrl, url) {\n      if (typeof statusOrUrl === \"string\") {\n        res.writeHead(307, { Location: statusOrUrl });\n      } else {\n        res.writeHead(statusOrUrl, { Location: url ?? \"\" });\n      }\n      res.end();\n    },\n    getHeaders() {\n      const headers: PagesReqResHeaders = { ...resHeaders };\n      if (setCookieHeaders.length > 0) {\n        headers[\"set-cookie\"] = setCookieHeaders;\n      }\n      return headers;\n    },\n  };\n\n  return { req, res, responsePromise };\n}\n"],"mappings":"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"}
+{"version":3,"file":"pages-node-compat.js","names":["decodeQueryString"],"sources":["../../src/server/pages-node-compat.ts"],"sourcesContent":["import { decode as decodeQueryString } from \"node:querystring\";\nimport { parseCookies } from \"../config/config-matchers.js\";\nimport { readStreamAsTextWithLimit } from \"../utils/text-stream.js\";\nimport { DEFAULT_PAGES_API_BODY_SIZE_LIMIT } from \"./pages-body-parser-config.js\";\nimport { PagesBodyParseError, getMediaType, isJsonMediaType } from \"./pages-media-type.js\";\n\nconst MAX_PAGES_API_BODY_SIZE = DEFAULT_PAGES_API_BODY_SIZE_LIMIT;\n\n/**\n * @deprecated Use PagesBodyParseError from pages-media-type.ts instead.\n * Kept for backwards compatibility.\n */\nexport { PagesBodyParseError as PagesApiBodyParseError };\n\nexport type PagesRequestQuery = Record<string, string | string[]>;\n\nexport type PagesReqResRequest = {\n  method: string;\n  url: string;\n  headers: Record<string, string>;\n  query: PagesRequestQuery;\n  body: unknown;\n  cookies: Record<string, string>;\n};\n\nexport type PagesReqResHeaders = {\n  [key: string]: string | number | boolean | string[];\n};\n\nexport type PagesReqResResponse = {\n  statusCode: number;\n  readonly headersSent: boolean;\n  writeHead: (code: number, headers?: PagesReqResHeaders) => PagesReqResResponse;\n  setHeader: (name: string, value: string | number | boolean | string[]) => PagesReqResResponse;\n  getHeader: (name: string) => string | number | boolean | string[] | undefined;\n  end: (data?: BodyInit | null) => void;\n  status: (code: number) => PagesReqResResponse;\n  json: (data: unknown) => void;\n  send: (data: unknown) => void;\n  redirect: (statusOrUrl: number | string, url?: string) => void;\n  getHeaders: () => PagesReqResHeaders;\n};\n\ntype CreatePagesReqResOptions = {\n  body: unknown;\n  query: PagesRequestQuery;\n  request: Request;\n  url: string;\n};\n\ntype CreatePagesReqResResult = {\n  req: PagesReqResRequest;\n  res: PagesReqResResponse;\n  responsePromise: Promise<Response>;\n};\n\nasync function readPagesRequestBodyWithLimit(request: Request, maxBytes: number): Promise<string> {\n  if (!request.body) {\n    return \"\";\n  }\n\n  return readStreamAsTextWithLimit(request.body, maxBytes, () => {\n    throw new PagesBodyParseError(\"Request body too large\", 413);\n  });\n}\n\n/**\n * Read and parse a Pages Router API request body for the Workers/prod path.\n *\n * `maxBytes` defaults to the 1 MB Next.js default but may be overridden by\n * `export const config = { api: { bodyParser: { sizeLimit: '4mb' } } }` on\n * the route module. Handlers that opt out entirely (`bodyParser: false`)\n * MUST skip this function so the body stream stays intact for user code.\n *\n * @see https://nextjs.org/docs/pages/building-your-application/routing/api-routes#custom-config\n */\nexport async function parsePagesApiBody(\n  request: Request,\n  maxBytes = MAX_PAGES_API_BODY_SIZE,\n): Promise<unknown> {\n  const contentLength = Number.parseInt(request.headers.get(\"content-length\") || \"0\", 10);\n  if (contentLength > maxBytes) {\n    throw new PagesBodyParseError(\"Request body too large\", 413);\n  }\n\n  let rawBody = \"\";\n  try {\n    rawBody = await readPagesRequestBodyWithLimit(request, maxBytes);\n  } catch (err) {\n    if (err instanceof PagesBodyParseError) {\n      throw err;\n    }\n    throw new PagesBodyParseError(\"Request body too large\", 413);\n  }\n\n  const mediaType = getMediaType(request.headers.get(\"content-type\"));\n  if (!rawBody) {\n    return isJsonMediaType(mediaType)\n      ? {}\n      : mediaType === \"application/x-www-form-urlencoded\"\n        ? decodeQueryString(rawBody)\n        : undefined;\n  }\n\n  if (isJsonMediaType(mediaType)) {\n    try {\n      return JSON.parse(rawBody);\n    } catch {\n      throw new PagesBodyParseError(\"Invalid JSON\", 400);\n    }\n  }\n\n  if (mediaType === \"application/x-www-form-urlencoded\") {\n    return decodeQueryString(rawBody);\n  }\n\n  return rawBody;\n}\n\nexport function createPagesReqRes(options: CreatePagesReqResOptions): CreatePagesReqResResult {\n  const headersObj: Record<string, string> = {};\n  for (const [key, value] of options.request.headers) {\n    headersObj[key.toLowerCase()] = value;\n  }\n\n  const req: PagesReqResRequest = {\n    method: options.request.method,\n    url: options.url,\n    headers: headersObj,\n    query: options.query,\n    body: options.body,\n    cookies: parseCookies(options.request.headers.get(\"cookie\")),\n  };\n\n  let resStatusCode = 200;\n  const resHeaders: Record<string, string | number | boolean> = {};\n  const setCookieHeaders: string[] = [];\n  let resBody: BodyInit | null = null;\n  let ended = false;\n  let resolveResponse!: (value: Response) => void;\n  const responsePromise = new Promise<Response>((resolve) => {\n    resolveResponse = resolve;\n  });\n\n  const res: PagesReqResResponse = {\n    get statusCode() {\n      return resStatusCode;\n    },\n    set statusCode(code) {\n      resStatusCode = code;\n    },\n    get headersSent() {\n      return ended;\n    },\n    writeHead(code, headers) {\n      resStatusCode = code;\n      if (headers) {\n        for (const [key, value] of Object.entries(headers)) {\n          if (key.toLowerCase() === \"set-cookie\") {\n            if (Array.isArray(value)) {\n              setCookieHeaders.push(...value.map(String));\n            } else {\n              setCookieHeaders.push(String(value));\n            }\n          } else {\n            resHeaders[key.toLowerCase()] = Array.isArray(value) ? value.join(\", \") : value;\n          }\n        }\n      }\n      return res;\n    },\n    setHeader(name, value) {\n      if (name.toLowerCase() === \"set-cookie\") {\n        // Node.js res.setHeader() replaces the existing value entirely.\n        setCookieHeaders.length = 0;\n        if (Array.isArray(value)) {\n          setCookieHeaders.push(...value.map(String));\n        } else {\n          setCookieHeaders.push(String(value));\n        }\n      } else {\n        resHeaders[name.toLowerCase()] = Array.isArray(value) ? value.join(\", \") : value;\n      }\n      return res;\n    },\n    getHeader(name) {\n      if (name.toLowerCase() === \"set-cookie\") {\n        return setCookieHeaders.length > 0 ? setCookieHeaders : undefined;\n      }\n      return resHeaders[name.toLowerCase()];\n    },\n    end(data) {\n      if (ended) {\n        return;\n      }\n      ended = true;\n      if (data !== undefined && data !== null) {\n        resBody = data;\n      }\n      const headers = new Headers();\n      for (const [key, value] of Object.entries(resHeaders)) {\n        headers.set(key, String(value));\n      }\n      for (const cookie of setCookieHeaders) {\n        headers.append(\"set-cookie\", cookie);\n      }\n      resolveResponse(new Response(resBody, { status: resStatusCode, headers }));\n    },\n    status(code) {\n      resStatusCode = code;\n      return res;\n    },\n    json(data) {\n      resHeaders[\"content-type\"] = \"application/json\";\n      res.end(JSON.stringify(data));\n    },\n    send(data) {\n      if (Buffer.isBuffer(data)) {\n        if (!resHeaders[\"content-type\"]) {\n          resHeaders[\"content-type\"] = \"application/octet-stream\";\n        }\n        resHeaders[\"content-length\"] = String(data.length);\n        res.end(new Uint8Array(data));\n        return;\n      }\n\n      if (typeof data === \"object\" && data !== null) {\n        resHeaders[\"content-type\"] = \"application/json\";\n        res.end(JSON.stringify(data));\n        return;\n      }\n\n      if (!resHeaders[\"content-type\"]) {\n        resHeaders[\"content-type\"] = \"text/plain\";\n      }\n      res.end(String(data));\n    },\n    redirect(statusOrUrl, url) {\n      if (typeof statusOrUrl === \"string\") {\n        res.writeHead(307, { Location: statusOrUrl });\n      } else {\n        res.writeHead(statusOrUrl, { Location: url ?? \"\" });\n      }\n      res.end();\n    },\n    getHeaders() {\n      const headers: PagesReqResHeaders = { ...resHeaders };\n      if (setCookieHeaders.length > 0) {\n        headers[\"set-cookie\"] = setCookieHeaders;\n      }\n      return headers;\n    },\n  };\n\n  return { req, res, responsePromise };\n}\n"],"mappings":"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"}

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

@@ -1,4 +1,5 @@
 import { Route } from "../routing/pages-router.js";
+import { VinextNextData } from "../client/vinext-next-data.js";
 import { CachedPagesValue } from "../shims/cache.js";
 import { ISRCacheEntry } from "./isr-cache.js";
 import { PagesGsspResponse, PagesI18nRenderContext } from "./pages-page-response.js";
@@ -64,6 +65,18 @@ type PagesPageModule = {
     locale?: string;
     locales?: string[];
     defaultLocale?: string;
+    /**
+     * Indicates why `getStaticProps` was invoked.
+     *
+     * - `"build"`: initial build-time prerender (before runtime traffic).
+     * - `"on-demand"`: triggered by `res.revalidate()` from an API route.
+     * - `"stale"`: stale-while-revalidate background regeneration.
+     *
+     * Mirrors Next.js `render.tsx`'s `revalidateReason` on the
+     * `GetStaticPropsContext` type — see
+     * `.nextjs-ref/packages/next/src/types.ts`.
+     */
+    revalidateReason?: "build" | "on-demand" | "stale";
   }) => Promise<PagesPagePropsResult> | PagesPagePropsResult;
 };
 type RenderPagesIsrHtmlOptions = {
@@ -76,6 +89,7 @@ type RenderPagesIsrHtmlOptions = {
   renderIsrPassToStringAsync: (element: ReactNode) => Promise<string>;
   routePattern: string;
   safeJsonStringify: (value: unknown) => string;
+  vinext?: VinextNextData["__vinext"];
 };
 type ResolvePagesPageDataOptions = {
   applyRequestContexts: () => void;
@@ -97,6 +111,30 @@ type ResolvePagesPageDataOptions = {
   isrGet: (key: string) => Promise<ISRCacheEntry | null>;
   isrSet: (key: string, data: CachedPagesValue, revalidateSeconds: number, tags?: string[], expireSeconds?: number) => Promise<void>;
   expireSeconds?: number;
+  /**
+   * When true, this dispatch corresponds to a build-time prerender (the
+   * `vinext` build phase fetches each statically generated page through the
+   * production server). Maps to `revalidateReason: "build"` when
+   * `getStaticProps` is invoked. Mirrors Next.js's
+   * `renderOpts.isBuildTimePrerendering` flag — see
+   * `.nextjs-ref/packages/next/src/server/render.tsx`.
+   */
+  isBuildTimePrerendering?: 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
+   * equivalent webhook). Maps to `revalidateReason: "on-demand"` when
+   * `getStaticProps` is invoked. Mirrors Next.js's
+   * `renderOpts.isOnDemandRevalidate` flag — see
+   * `.nextjs-ref/packages/next/src/server/render.tsx`.
+   *
+   * Forward-looking plumbing: no caller currently sets this — `res.revalidate()`
+   * is not yet implemented in vinext. The `"on-demand"` branch in the
+   * `revalidateReason` resolver is intentionally unreachable today; keeping the
+   * typed contract here means wiring it up will be a one-line change once the
+   * trigger lands.
+   */
+  isOnDemandRevalidate?: boolean;
   pageModule: PagesPageModule;
   params: Record<string, unknown>;
   query: Record<string, unknown>;
@@ -107,12 +145,14 @@ type ResolvePagesPageDataOptions = {
   safeJsonStringify: (value: unknown) => string;
   sanitizeDestination: (destination: string) => string;
   scriptNonce?: string;
+  statusCode?: number;
   triggerBackgroundRegeneration: (key: string, renderFn: () => Promise<void>, errorContext?: {
     routerKind: "Pages Router";
     routePath: string;
     routeType: "render";
   }) => void;
   renderIsrPassToStringAsync: (element: ReactNode) => Promise<string>;
+  vinext?: VinextNextData["__vinext"];
 };
 type ResolvePagesPageDataRenderResult = {
   kind: "render";

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

@@ -1,14 +1,13 @@
 import { normalizeStaticPathname } from "../routing/route-pattern.js";
 import { buildCacheStateHeaders } from "./cache-headers.js";
 import { buildPagesCacheValue } from "./isr-cache.js";
+import { buildDefaultPagesNotFoundResponse } from "./pages-default-404.js";
+import { isSerializableProps } from "./pages-serializable-props.js";
 import { buildCachedRevalidateCacheControl } from "./cache-control.js";
 import { buildPagesNextDataScript } from "./pages-page-response.js";
 //#region src/server/pages-page-data.ts
 function buildPagesNotFoundResponse() {
-	return new Response("<!DOCTYPE html><html><body><h1>404 - Page not found</h1></body></html>", {
-		status: 404,
-		headers: { "Content-Type": "text/html" }
-	});
+	return buildDefaultPagesNotFoundResponse();
 }
 function buildPagesDataNotFoundResponse() {
 	return new Response("{}", {
@@ -44,7 +43,7 @@ function matchesPagesStaticPath(pathEntry, params, routeUrl) {
 		return String(value) === String(actual);
 	});
 }
-function buildPagesCacheResponse(html, cacheState, fontLinkHeader, revalidateSeconds, expireSeconds, cacheControl) {
+function buildPagesCacheResponse(html, cacheState, fontLinkHeader, revalidateSeconds, expireSeconds, cacheControl, status) {
 	const effectiveRevalidateSeconds = cacheControl?.revalidate ?? revalidateSeconds ?? 60;
 	const effectiveExpireSeconds = cacheControl === void 0 ? void 0 : cacheControl.expire ?? expireSeconds;
 	const headers = {
@@ -54,7 +53,7 @@ function buildPagesCacheResponse(html, cacheState, fontLinkHeader, revalidateSec
 	};
 	if (fontLinkHeader) headers.Link = fontLinkHeader;
 	return new Response(html, {
-		status: 200,
+		status: status ?? 200,
 		headers
 	});
 }
@@ -80,7 +79,8 @@ async function renderPagesIsrHtml(options) {
 		pageProps: options.pageProps,
 		params: options.params,
 		routePattern: options.routePattern,
-		safeJsonStringify: options.safeJsonStringify
+		safeJsonStringify: options.safeJsonStringify,
+		vinext: options.vinext
 	});
 	return rewritePagesCachedHtml(options.cachedHtml, freshBody, nextDataScript);
 }
@@ -125,7 +125,7 @@ async function resolvePagesPageData(options) {
 			kind: "response",
 			response: await responsePromise
 		};
-		if (result?.props) pageProps = result.props;
+		if (result?.props) pageProps = await Promise.resolve(result.props);
 		if (result?.redirect) return {
 			kind: "response",
 			response: new Response(null, {
@@ -137,6 +137,7 @@ async function resolvePagesPageData(options) {
 			kind: "response",
 			response: options.isDataReq ? buildPagesDataNotFoundResponse() : buildPagesNotFoundResponse()
 		};
+		if (result?.props !== void 0) isSerializableProps(options.routePattern, "getServerSideProps", pageProps);
 		gsspRes = res;
 	}
 	let isrRevalidateSeconds = null;
@@ -147,7 +148,7 @@ async function resolvePagesPageData(options) {
 		const cachedValue = cached?.value.value;
 		if (cachedValue?.kind === "PAGES" && cached && !cached.isStale && !options.scriptNonce && !options.isDataReq) return {
 			kind: "response",
-			response: buildPagesCacheResponse(cachedValue.html, "HIT", options.fontLinkHeader, void 0, options.expireSeconds, cached.value.cacheControl)
+			response: buildPagesCacheResponse(cachedValue.html, "HIT", options.fontLinkHeader, void 0, options.expireSeconds, cached.value.cacheControl, cachedValue.status)
 		};
 		if (cachedValue?.kind === "PAGES" && cached && cached.isStale && !options.scriptNonce && !options.isDataReq) {
 			options.triggerBackgroundRegeneration(cacheKey, async function() {
@@ -156,7 +157,8 @@ async function resolvePagesPageData(options) {
 						params: userFacingParams,
 						locale: options.i18n.locale,
 						locales: options.i18n.locales,
-						defaultLocale: options.i18n.defaultLocale
+						defaultLocale: options.i18n.defaultLocale,
+						revalidateReason: "stale"
 					});
 					if (freshResult?.props && typeof freshResult.revalidate === "number" && freshResult.revalidate > 0) {
 						options.applyRequestContexts();
@@ -169,9 +171,10 @@ async function resolvePagesPageData(options) {
 							params: options.params,
 							renderIsrPassToStringAsync: options.renderIsrPassToStringAsync,
 							routePattern: options.routePattern,
-							safeJsonStringify: options.safeJsonStringify
+							safeJsonStringify: options.safeJsonStringify,
+							vinext: options.vinext
 						});
-						await options.isrSet(cacheKey, buildPagesCacheValue(freshHtml, freshResult.props), freshResult.revalidate, void 0, options.expireSeconds);
+						await options.isrSet(cacheKey, buildPagesCacheValue(freshHtml, freshResult.props, options.statusCode), freshResult.revalidate, void 0, options.expireSeconds);
 					}
 				});
 			}, {
@@ -181,14 +184,15 @@ async function resolvePagesPageData(options) {
 			});
 			return {
 				kind: "response",
-				response: buildPagesCacheResponse(cachedValue.html, "STALE", options.fontLinkHeader, void 0, options.expireSeconds, cached.value.cacheControl)
+				response: buildPagesCacheResponse(cachedValue.html, "STALE", options.fontLinkHeader, void 0, options.expireSeconds, cached.value.cacheControl, cachedValue.status)
 			};
 		}
 		const result = await options.pageModule.getStaticProps({
 			params: userFacingParams,
 			locale: options.i18n.locale,
 			locales: options.i18n.locales,
-			defaultLocale: options.i18n.defaultLocale
+			defaultLocale: options.i18n.defaultLocale,
+			revalidateReason: options.isOnDemandRevalidate ? "on-demand" : options.isBuildTimePrerendering ? "build" : "stale"
 		});
 		if (result?.props) pageProps = result.props;
 		if (result?.redirect) return {
@@ -202,6 +206,7 @@ async function resolvePagesPageData(options) {
 			kind: "response",
 			response: options.isDataReq ? buildPagesDataNotFoundResponse() : buildPagesNotFoundResponse()
 		};
+		if (result?.props !== void 0) isSerializableProps(options.routePattern, "getStaticProps", pageProps);
 		if (typeof result?.revalidate === "number" && result.revalidate > 0) isrRevalidateSeconds = result.revalidate;
 	}
 	return {