vinext 0.0.51 → 0.0.52

package/dist/server/client-reuse-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-reuse-manifest.js","names":[],"sources":["../../src/server/client-reuse-manifest.ts"],"sourcesContent":["import {\n  parseArtifactCompatibilityEnvelope,\n  type ArtifactCompatibilityEnvelope,\n} from \"./artifact-compatibility.js\";\nimport { AppElementsWire } from \"./app-elements-wire.js\";\nimport { fnv1a64 } from \"../utils/hash.js\";\nimport { isUnknownRecord } from \"../utils/record.js\";\n\nexport const CLIENT_REUSE_MANIFEST_SCHEMA_VERSION = 1;\nexport type ClientReuseManifestSchemaVersion = 1;\n\nexport const CLIENT_REUSE_MANIFEST_HASH_ALGORITHM = \"fnv1a64\";\nexport type ClientReuseManifestHashAlgorithm = typeof CLIENT_REUSE_MANIFEST_HASH_ALGORITHM;\n\ntype ClientReuseManifestLimits = Readonly<{\n  maxEntryCount: number;\n  maxEntryIdLength: number;\n  maxManifestBytes: number;\n  maxPayloadHashLength: number;\n  maxVariantCacheKeyLength: number;\n}>;\n\nexport const DEFAULT_CLIENT_REUSE_MANIFEST_LIMITS = {\n  maxEntryCount: 64,\n  maxEntryIdLength: 512,\n  maxManifestBytes: 4096,\n  maxPayloadHashLength: 16,\n  maxVariantCacheKeyLength: 256,\n} satisfies ClientReuseManifestLimits;\n\nexport type ClientReuseManifestEntryKind = \"layout\" | \"page\" | \"route\" | \"slot\" | \"template\";\ntype ClientReuseManifestEntryPrivacy = \"private\" | \"public\";\n\nexport type ClientReuseManifestReplayWindow = Readonly<{\n  validFromVisibleCommitVersion: number;\n  validUntilVisibleCommitVersion: number;\n}>;\n\nexport type ClientReuseManifestEntry = Readonly<{\n  artifactCompatibility: ArtifactCompatibilityEnvelope;\n  id: string;\n  kind: ClientReuseManifestEntryKind;\n  payloadHash: string;\n  privacy: \"public\";\n  variantCacheKey: string;\n}>;\n\ntype ClientReuseManifestWireEntry = Readonly<{\n  artifactCompatibility: ArtifactCompatibilityEnvelope;\n  id: string;\n  payloadHash: string;\n  privacy: ClientReuseManifestEntryPrivacy;\n  variantCacheKey: string;\n}>;\n\nexport type ClientReuseManifest = Readonly<{\n  entries: readonly ClientReuseManifestEntry[];\n  hashAlgorithm: ClientReuseManifestHashAlgorithm;\n  replayWindow: ClientReuseManifestReplayWindow;\n  schemaVersion: ClientReuseManifestSchemaVersion;\n  visibleCommitVersion: number;\n}>;\n\n// Internal: createClientReuseManifest returns wire shape while parsing decides\n// which client-declared entries can participate in future reuse.\ntype ClientReuseManifestWire = Readonly<{\n  entries: readonly ClientReuseManifestWireEntry[];\n  hashAlgorithm: ClientReuseManifestHashAlgorithm;\n  replayWindow: ClientReuseManifestReplayWindow;\n  schemaVersion: ClientReuseManifestSchemaVersion;\n  visibleCommitVersion: number;\n}>;\n\ntype CreateClientReuseManifestInput = Readonly<{\n  entries: readonly ClientReuseManifestWireEntry[];\n  replayWindow?: ClientReuseManifestReplayWindow;\n  visibleCommitVersion: number;\n}>;\n\nexport type ClientReuseManifestRejectionCode =\n  | \"SKIP_CACHE_ARTIFACT_COMPATIBILITY_INCOMPATIBLE\"\n  | \"SKIP_CACHE_ARTIFACT_COMPATIBILITY_UNKNOWN\"\n  | \"SKIP_CACHE_ARTIFACT_PROOF_MISMATCH\"\n  | \"SKIP_CACHE_ENTRY_ID_MISMATCH\"\n  | \"SKIP_CACHE_INVALIDATED\"\n  | \"SKIP_CACHE_INVALIDATION_UNKNOWN\"\n  | \"SKIP_CACHE_PAYLOAD_HASH_MISMATCH\"\n  | \"SKIP_CACHE_PAYLOAD_HASH_MISSING\"\n  | \"SKIP_CACHE_PROOF_MISSING\"\n  | \"SKIP_CACHE_PROOF_REJECTED\"\n  | \"SKIP_CACHE_REUSE_CLASS_UNSUPPORTED\"\n  | \"SKIP_CACHE_VARIANT_MISMATCH\"\n  | \"SKIP_ARTIFACT_COMPATIBILITY_INVALID\"\n  | \"SKIP_ENTRY_COUNT_EXCEEDED\"\n  | \"SKIP_ENTRY_HASH_INVALID\"\n  | \"SKIP_ENTRY_ID_INVALID\"\n  | \"SKIP_ENTRY_ID_TOO_LONG\"\n  | \"SKIP_ENTRY_MALFORMED\"\n  | \"SKIP_ENTRY_ORDER_NON_CANONICAL\"\n  | \"SKIP_HASH_ALGORITHM_UNSUPPORTED\"\n  | \"SKIP_MANIFEST_MALFORMED\"\n  | \"SKIP_MANIFEST_SCHEMA_UNSUPPORTED\"\n  | \"SKIP_MANIFEST_TOO_LARGE\"\n  | \"SKIP_PRIVATE_ENTRY\"\n  | \"SKIP_REPLAY_WINDOW_INVALID\"\n  | \"SKIP_UNKNOWN_ENTRY\"\n  | \"SKIP_VARIANT_CACHE_KEY_INVALID\"\n  | \"SKIP_VARIANT_CACHE_KEY_TOO_LONG\"\n  | \"SKIP_VISIBLE_COMMIT_VERSION_INVALID\"\n  | \"SKIP_VISIBLE_COMMIT_VERSION_MISMATCH\";\n\nexport type ClientReuseManifestDispositionCode = \"SKIP_MODEL_DISABLED\";\n\nexport type ClientReuseManifestTraceFieldValue =\n  | string\n  | number\n  | boolean\n  | null\n  | readonly string[];\n\nexport type ClientReuseManifestTraceFields = Readonly<\n  Record<string, ClientReuseManifestTraceFieldValue>\n>;\n\nexport type ClientReuseManifestRejection = Readonly<{\n  code: ClientReuseManifestRejectionCode;\n  fields: ClientReuseManifestTraceFields;\n}>;\n\nexport type ClientReuseManifestEntryRejection = ClientReuseManifestRejection &\n  Readonly<{\n    entryId: string | null;\n  }>;\n\nexport type ClientReuseManifestSkipDisposition = Readonly<{\n  code: ClientReuseManifestDispositionCode;\n  enabled: false;\n  mode: \"renderAndSend\";\n}>;\n\nexport type ClientReuseManifestParseResult =\n  | Readonly<{ kind: \"absent\" }>\n  | Readonly<{ kind: \"rejected\"; rejection: ClientReuseManifestRejection }>\n  | Readonly<{\n      entryRejections: readonly ClientReuseManifestEntryRejection[];\n      kind: \"parsed\";\n      manifest: ClientReuseManifest;\n      skipDisposition: ClientReuseManifestSkipDisposition;\n    }>;\n\ntype ParseClientReuseManifestOptions = Readonly<{\n  currentVisibleCommitVersion?: number;\n  limits?: ClientReuseManifestLimits;\n}>;\n\nconst HASH_DIGEST_PATTERN = /^[0-9a-z]+$/;\nconst textEncoder = new TextEncoder();\n\ntype ParseReplayWindowResult =\n  | Readonly<{ kind: \"parsed\"; replayWindow: ClientReuseManifestReplayWindow }>\n  | Readonly<{ kind: \"rejected\"; rejection: ClientReuseManifestRejection }>;\n\nfunction createRejection(\n  code: ClientReuseManifestRejectionCode,\n  fields: ClientReuseManifestTraceFields = {},\n): ClientReuseManifestRejection {\n  return { code, fields };\n}\n\nfunction rejectManifest(\n  code: ClientReuseManifestRejectionCode,\n  fields: ClientReuseManifestTraceFields = {},\n): ClientReuseManifestParseResult {\n  return { kind: \"rejected\", rejection: createRejection(code, fields) };\n}\n\nfunction rejectEntry(\n  code: ClientReuseManifestRejectionCode,\n  entryId: string | null,\n  fields: ClientReuseManifestTraceFields = {},\n): ClientReuseManifestEntryRejection {\n  return { code, entryId, fields };\n}\n\nfunction compareManifestEntries(\n  left: Pick<ClientReuseManifestWireEntry, \"id\">,\n  right: Pick<ClientReuseManifestWireEntry, \"id\">,\n): number {\n  if (left.id < right.id) return -1;\n  if (left.id > right.id) return 1;\n  return 0;\n}\n\nfunction createCanonicalWireEntries(\n  entries: readonly ClientReuseManifestWireEntry[],\n): ClientReuseManifestWireEntry[] {\n  const entriesById = new Map<string, ClientReuseManifestWireEntry>();\n  for (const entry of entries) {\n    if (!entriesById.has(entry.id)) {\n      entriesById.set(entry.id, entry);\n    }\n  }\n\n  return Array.from(entriesById.values()).sort(compareManifestEntries);\n}\n\n// The manifest byte budget is enforced once at the untrusted header boundary.\nfunction countUtf8Bytes(input: string): number {\n  return textEncoder.encode(input).length;\n}\n\nfunction isVisibleCommitVersion(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\n\nfunction parseReplayWindow(value: unknown, visibleCommitVersion: number): ParseReplayWindowResult {\n  if (!isUnknownRecord(value)) {\n    return {\n      kind: \"rejected\",\n      rejection: createRejection(\"SKIP_REPLAY_WINDOW_INVALID\", { field: \"replayWindow\" }),\n    };\n  }\n\n  const validFromVisibleCommitVersion = value.validFromVisibleCommitVersion;\n  const validUntilVisibleCommitVersion = value.validUntilVisibleCommitVersion;\n  if (\n    !isVisibleCommitVersion(validFromVisibleCommitVersion) ||\n    !isVisibleCommitVersion(validUntilVisibleCommitVersion) ||\n    validFromVisibleCommitVersion > validUntilVisibleCommitVersion ||\n    visibleCommitVersion < validFromVisibleCommitVersion ||\n    visibleCommitVersion > validUntilVisibleCommitVersion\n  ) {\n    return {\n      kind: \"rejected\",\n      rejection: createRejection(\"SKIP_REPLAY_WINDOW_INVALID\", {\n        validFromVisibleCommitVersion: isVisibleCommitVersion(validFromVisibleCommitVersion)\n          ? validFromVisibleCommitVersion\n          : null,\n        validUntilVisibleCommitVersion: isVisibleCommitVersion(validUntilVisibleCommitVersion)\n          ? validUntilVisibleCommitVersion\n          : null,\n        visibleCommitVersion,\n      }),\n    };\n  }\n\n  return {\n    kind: \"parsed\",\n    replayWindow: {\n      validFromVisibleCommitVersion,\n      validUntilVisibleCommitVersion,\n    },\n  };\n}\n\nfunction currentCommitVersionMatchesReplayWindow(\n  currentVisibleCommitVersion: number | undefined,\n  replayWindow: ClientReuseManifestReplayWindow,\n): boolean {\n  if (currentVisibleCommitVersion === undefined) return true;\n  return (\n    currentVisibleCommitVersion >= replayWindow.validFromVisibleCommitVersion &&\n    currentVisibleCommitVersion <= replayWindow.validUntilVisibleCommitVersion\n  );\n}\n\nfunction parseEntryKind(id: string): ClientReuseManifestEntryKind | null {\n  const parsed = AppElementsWire.parseElementKey(id);\n  if (parsed === null) return null;\n  return parsed.kind;\n}\n\nfunction isValidPayloadHash(value: unknown, limits: ClientReuseManifestLimits): value is string {\n  return (\n    typeof value === \"string\" &&\n    value.length > 0 &&\n    value.length <= limits.maxPayloadHashLength &&\n    HASH_DIGEST_PATTERN.test(value)\n  );\n}\n\nfunction parseManifestEntry(\n  value: unknown,\n  limits: ClientReuseManifestLimits,\n  index: number,\n): ClientReuseManifestEntry | ClientReuseManifestEntryRejection {\n  if (!isUnknownRecord(value)) {\n    return rejectEntry(\"SKIP_ENTRY_MALFORMED\", null, { index });\n  }\n\n  const id = value.id;\n  if (typeof id !== \"string\" || id.length === 0) {\n    return rejectEntry(\"SKIP_ENTRY_ID_INVALID\", null, { index });\n  }\n  if (id.length > limits.maxEntryIdLength) {\n    return rejectEntry(\"SKIP_ENTRY_ID_TOO_LONG\", id, {\n      idHash: createClientReusePayloadHash(id),\n      maxEntryIdLength: limits.maxEntryIdLength,\n    });\n  }\n\n  const kind = parseEntryKind(id);\n  if (kind === null) {\n    return rejectEntry(\"SKIP_UNKNOWN_ENTRY\", id, { idHash: createClientReusePayloadHash(id) });\n  }\n\n  const privacy = value.privacy;\n  if (privacy === \"private\") {\n    return rejectEntry(\"SKIP_PRIVATE_ENTRY\", id, { privacy });\n  }\n  if (privacy !== \"public\") {\n    return rejectEntry(\"SKIP_ENTRY_MALFORMED\", id, { field: \"privacy\" });\n  }\n\n  const payloadHash = value.payloadHash;\n  if (!isValidPayloadHash(payloadHash, limits)) {\n    return rejectEntry(\"SKIP_ENTRY_HASH_INVALID\", id, {\n      maxPayloadHashLength: limits.maxPayloadHashLength,\n    });\n  }\n\n  const variantCacheKey = value.variantCacheKey;\n  if (typeof variantCacheKey !== \"string\" || variantCacheKey.length === 0) {\n    return rejectEntry(\"SKIP_VARIANT_CACHE_KEY_INVALID\", id, { field: \"variantCacheKey\" });\n  }\n  if (variantCacheKey.length > limits.maxVariantCacheKeyLength) {\n    return rejectEntry(\"SKIP_VARIANT_CACHE_KEY_TOO_LONG\", id, {\n      maxVariantCacheKeyLength: limits.maxVariantCacheKeyLength,\n      variantCacheKeyHash: createClientReusePayloadHash(variantCacheKey),\n    });\n  }\n\n  const artifactCompatibility = parseArtifactCompatibilityEnvelope(value.artifactCompatibility);\n  if (artifactCompatibility === null) {\n    return rejectEntry(\"SKIP_ARTIFACT_COMPATIBILITY_INVALID\", id, {\n      field: \"artifactCompatibility\",\n    });\n  }\n\n  return {\n    artifactCompatibility,\n    id,\n    kind,\n    payloadHash,\n    privacy,\n    variantCacheKey,\n  };\n}\n\nexport function createClientReusePayloadHash(input: string): string {\n  return fnv1a64(input);\n}\n\nexport function createClientReuseManifest(\n  input: CreateClientReuseManifestInput,\n): ClientReuseManifestWire {\n  const replayWindow =\n    input.replayWindow ??\n    ({\n      validFromVisibleCommitVersion: input.visibleCommitVersion,\n      validUntilVisibleCommitVersion: input.visibleCommitVersion,\n    } satisfies ClientReuseManifestReplayWindow);\n\n  return {\n    entries: createCanonicalWireEntries(input.entries),\n    hashAlgorithm: CLIENT_REUSE_MANIFEST_HASH_ALGORITHM,\n    replayWindow,\n    schemaVersion: CLIENT_REUSE_MANIFEST_SCHEMA_VERSION,\n    visibleCommitVersion: input.visibleCommitVersion,\n  };\n}\n\nexport function serializeClientReuseManifest(input: CreateClientReuseManifestInput): string {\n  return JSON.stringify(createClientReuseManifest(input));\n}\n\nexport function parseClientReuseManifestHeader(\n  rawHeader: string | null | undefined,\n  options: ParseClientReuseManifestOptions = {},\n): ClientReuseManifestParseResult {\n  const header = rawHeader?.trim();\n  if (!header) return { kind: \"absent\" };\n\n  const limits = options.limits ?? DEFAULT_CLIENT_REUSE_MANIFEST_LIMITS;\n  const manifestBytes = countUtf8Bytes(header);\n  if (manifestBytes > limits.maxManifestBytes) {\n    return rejectManifest(\"SKIP_MANIFEST_TOO_LARGE\", {\n      manifestBytes,\n      maxManifestBytes: limits.maxManifestBytes,\n    });\n  }\n\n  let decoded: unknown;\n  try {\n    decoded = JSON.parse(header);\n  } catch {\n    return rejectManifest(\"SKIP_MANIFEST_MALFORMED\");\n  }\n\n  if (!isUnknownRecord(decoded)) {\n    return rejectManifest(\"SKIP_MANIFEST_MALFORMED\", { field: \"manifest\" });\n  }\n\n  if (decoded.schemaVersion !== CLIENT_REUSE_MANIFEST_SCHEMA_VERSION) {\n    return rejectManifest(\"SKIP_MANIFEST_SCHEMA_UNSUPPORTED\", {\n      schemaVersion:\n        typeof decoded.schemaVersion === \"number\" || typeof decoded.schemaVersion === \"string\"\n          ? decoded.schemaVersion\n          : null,\n    });\n  }\n\n  if (decoded.hashAlgorithm !== CLIENT_REUSE_MANIFEST_HASH_ALGORITHM) {\n    return rejectManifest(\"SKIP_HASH_ALGORITHM_UNSUPPORTED\", {\n      hashAlgorithm: typeof decoded.hashAlgorithm === \"string\" ? decoded.hashAlgorithm : null,\n    });\n  }\n\n  const visibleCommitVersion = decoded.visibleCommitVersion;\n  if (!isVisibleCommitVersion(visibleCommitVersion)) {\n    return rejectManifest(\"SKIP_VISIBLE_COMMIT_VERSION_INVALID\", {\n      visibleCommitVersion: null,\n    });\n  }\n\n  const replayWindowResult = parseReplayWindow(decoded.replayWindow, visibleCommitVersion);\n  if (replayWindowResult.kind === \"rejected\") {\n    return { kind: \"rejected\", rejection: replayWindowResult.rejection };\n  }\n  const { replayWindow } = replayWindowResult;\n  if (!currentCommitVersionMatchesReplayWindow(options.currentVisibleCommitVersion, replayWindow)) {\n    return rejectManifest(\"SKIP_VISIBLE_COMMIT_VERSION_MISMATCH\", {\n      currentVisibleCommitVersion: options.currentVisibleCommitVersion ?? null,\n      validFromVisibleCommitVersion: replayWindow.validFromVisibleCommitVersion,\n      validUntilVisibleCommitVersion: replayWindow.validUntilVisibleCommitVersion,\n      visibleCommitVersion,\n    });\n  }\n\n  const entriesValue = decoded.entries;\n  if (!Array.isArray(entriesValue)) {\n    return rejectManifest(\"SKIP_MANIFEST_MALFORMED\", { field: \"entries\" });\n  }\n  if (entriesValue.length > limits.maxEntryCount) {\n    return rejectManifest(\"SKIP_ENTRY_COUNT_EXCEEDED\", {\n      entryCount: entriesValue.length,\n      maxEntryCount: limits.maxEntryCount,\n    });\n  }\n\n  const entries: ClientReuseManifestEntry[] = [];\n  const entryRejections: ClientReuseManifestEntryRejection[] = [];\n  let previousEntryId: string | null = null;\n\n  for (let index = 0; index < entriesValue.length; index++) {\n    const value = entriesValue[index];\n    if (isUnknownRecord(value) && typeof value.id === \"string\") {\n      // Canonical ordering is enforced over entries with string IDs. Malformed\n      // entries cannot advance previousEntryId, so interleaving them cannot hide\n      // an ordering violation between valid checkpoints. <= rejects both\n      // out-of-order and duplicate IDs.\n      if (previousEntryId !== null && value.id <= previousEntryId) {\n        return rejectManifest(\"SKIP_ENTRY_ORDER_NON_CANONICAL\", {\n          entryIdHash: createClientReusePayloadHash(value.id),\n          previousEntryIdHash: createClientReusePayloadHash(previousEntryId),\n        });\n      }\n      previousEntryId = value.id;\n    }\n\n    const parsedEntry = parseManifestEntry(value, limits, index);\n    if (\"code\" in parsedEntry) {\n      entryRejections.push(parsedEntry);\n    } else {\n      entries.push(parsedEntry);\n    }\n  }\n\n  return {\n    entryRejections,\n    kind: \"parsed\",\n    manifest: {\n      entries,\n      hashAlgorithm: CLIENT_REUSE_MANIFEST_HASH_ALGORITHM,\n      replayWindow,\n      schemaVersion: CLIENT_REUSE_MANIFEST_SCHEMA_VERSION,\n      visibleCommitVersion,\n    },\n    skipDisposition: {\n      code: \"SKIP_MODEL_DISABLED\",\n      enabled: false,\n      mode: \"renderAndSend\",\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/server/default-global-error-module.d.ts

@@ -0,0 +1,20 @@
+//#region src/server/default-global-error-module.d.ts
+/**
+ * Module-shaped wrapper around vinext's built-in default global error
+ * component. Used as the fallback when an app does not define its own
+ * `app/global-error.tsx`. The runtime treats any `{ default: Component }`
+ * record as a "global error module", so wrapping the component this way lets
+ * us thread the default through the existing `globalErrorModule` plumbing
+ * without introducing a parallel code path.
+ *
+ * Mirrors Next.js's `defaultGlobalErrorPath`
+ * (`next/dist/client/components/builtin/global-error.js`), which is selected
+ * automatically when the user has not supplied a custom global error file:
+ * https://github.com/vercel/next.js/blob/canary/packages/next/src/build/webpack/loaders/next-app-loader/index.ts
+ */
+declare const DEFAULT_GLOBAL_ERROR_MODULE: {
+  readonly default: any;
+};
+//#endregion
+export { DEFAULT_GLOBAL_ERROR_MODULE };
+//# sourceMappingURL=default-global-error-module.d.ts.map

package/dist/server/default-global-error-module.js

@@ -0,0 +1,20 @@
+import DefaultGlobalError from "../shims/default-global-error.js";
+//#region src/server/default-global-error-module.ts
+/**
+* Module-shaped wrapper around vinext's built-in default global error
+* component. Used as the fallback when an app does not define its own
+* `app/global-error.tsx`. The runtime treats any `{ default: Component }`
+* record as a "global error module", so wrapping the component this way lets
+* us thread the default through the existing `globalErrorModule` plumbing
+* without introducing a parallel code path.
+*
+* Mirrors Next.js's `defaultGlobalErrorPath`
+* (`next/dist/client/components/builtin/global-error.js`), which is selected
+* automatically when the user has not supplied a custom global error file:
+* https://github.com/vercel/next.js/blob/canary/packages/next/src/build/webpack/loaders/next-app-loader/index.ts
+*/
+const DEFAULT_GLOBAL_ERROR_MODULE = { default: DefaultGlobalError };
+//#endregion
+export { DEFAULT_GLOBAL_ERROR_MODULE };
+
+//# sourceMappingURL=default-global-error-module.js.map

package/dist/server/default-global-error-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-global-error-module.js","names":[],"sources":["../../src/server/default-global-error-module.ts"],"sourcesContent":["import DefaultGlobalError from \"vinext/shims/default-global-error\";\n\n/**\n * Module-shaped wrapper around vinext's built-in default global error\n * component. Used as the fallback when an app does not define its own\n * `app/global-error.tsx`. The runtime treats any `{ default: Component }`\n * record as a \"global error module\", so wrapping the component this way lets\n * us thread the default through the existing `globalErrorModule` plumbing\n * without introducing a parallel code path.\n *\n * Mirrors Next.js's `defaultGlobalErrorPath`\n * (`next/dist/client/components/builtin/global-error.js`), which is selected\n * automatically when the user has not supplied a custom global error file:\n * https://github.com/vercel/next.js/blob/canary/packages/next/src/build/webpack/loaders/next-app-loader/index.ts\n */\nexport const DEFAULT_GLOBAL_ERROR_MODULE = {\n  default: DefaultGlobalError,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAa,8BAA8B,EACzC,SAAS,oBACV"}

package/dist/server/dev-server.d.ts

@@ -38,7 +38,15 @@ declare function parseCookieLocale(req: IncomingMessage, i18nConfig: NextI18nCon
  */
 declare function createSSRHandler(server: ViteDevServer, runner: ModuleImporter, routes: Route[], pagesDir: string, i18nConfig?: NextI18nConfig | null, fileMatcher?: ValidFileMatcher, basePath?: string, trailingSlash?: boolean): (req: IncomingMessage, res: ServerResponse, url: string, /** Status code override — propagated from middleware rewrite status. */
 
-statusCode?: number) => Promise<void>;
+statusCode?: number,
+/**
+ * True when the request originated as `/_next/data/<buildId>/<page>.json`.
+ * When true the handler emits a `{ pageProps }` JSON envelope instead of
+ * rendering the React tree to HTML — matching Next.js' behavior for
+ * client-side navigations in the Pages Router.
+ */
+
+isDataReq?: boolean) => Promise<void>;
 //#endregion
 export { createSSRHandler, detectLocaleFromHeaders, extractLocaleFromUrl, parseCookieLocale };
 //# sourceMappingURL=dev-server.d.ts.map

package/dist/server/dev-server.js

@@ -2,14 +2,14 @@ import { createRequestContext, runWithRequestContext } from "../shims/unified-re
 import { createValidFileMatcher, findFileWithExtensions } from "../routing/file-matcher.js";
 import { patternToNextFormat } from "../routing/route-validation.js";
 import { matchRoute } from "../routing/pages-router.js";
-import { VINEXT_CACHE_HEADER } from "./headers.js";
+import { mergeRouteParamsIntoQuery, parseQueryString } from "../utils/query.js";
 import { normalizeStaticPathname } from "../routing/route-pattern.js";
 import { importModule, reportRequestError } from "./instrumentation.js";
+import { buildCacheStateHeaders } from "./cache-headers.js";
 import { _runWithCacheState } from "../shims/cache.js";
 import { buildPagesCacheValue, getRevalidateDuration, isrCacheKey, isrGet, isrSet, setRevalidateDuration, triggerBackgroundRegeneration } from "./isr-cache.js";
 import { runWithPrivateCache } from "../shims/cache-runtime.js";
 import { ensureFetchPatch, runWithFetchCache } from "../shims/fetch-cache.js";
-import { mergeRouteParamsIntoQuery, parseQueryString } from "../utils/query.js";
 import "../shims/router-state.js";
 import { runWithHeadState } from "../shims/head-state.js";
 import { runWithServerInsertedHTMLState } from "../shims/navigation-state.js";
@@ -136,7 +136,7 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 	const matcher = fileMatcher ?? createValidFileMatcher();
 	const _alsRegistration = Promise.all([runner.import("vinext/head-state"), runner.import("vinext/router-state")]);
 	_alsRegistration.catch(() => {});
-	return async (req, res, url, statusCode) => {
+	return async (req, res, url, statusCode, isDataReq = false) => {
 		const _reqStart = now();
 		let _compileEnd;
 		let _renderEnd;
@@ -170,10 +170,16 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 		}
 		const match = matchRoute(localeStrippedUrl, routes);
 		if (!match) {
+			if (isDataReq) {
+				res.writeHead(404, { "Content-Type": "application/json" });
+				res.end("{}");
+				return;
+			}
 			await renderErrorPage(server, runner, req, res, url, pagesDir, 404, void 0, matcher);
 			return;
 		}
 		const { route, params } = match;
+		const userFacingParams = route.isDynamic ? params : null;
 		const query = mergeRouteParamsIntoQuery(parseQueryString(url), params);
 		return runWithRequestContext(createRequestContext(), async () => {
 			ensureFetchPatch();
@@ -211,34 +217,53 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 				}
 				let pageProps = {};
 				let isrRevalidateSeconds = null;
+				let isFallbackRender = false;
 				if (typeof pageModule.getStaticPaths === "function" && route.isDynamic) {
 					const pathsResult = await pageModule.getStaticPaths({
 						locales: i18nConfig?.locales ?? [],
 						defaultLocale: currentDefaultLocale ?? ""
 					});
-					if ((pathsResult?.fallback ?? false) === false) {
-						const paths = pathsResult?.paths ?? [];
-						const currentPathname = normalizeStaticPathname(url);
-						if (!paths.some((p) => {
-							if (typeof p === "string") return normalizeStaticPathname(p) === currentPathname;
-							const entryParams = p.params;
-							if (entryParams === void 0 || entryParams === null) return false;
-							return Object.entries(entryParams).every(([key, val]) => {
-								const actual = params[key];
-								if (Array.isArray(val)) return Array.isArray(actual) && val.join("/") === actual.join("/");
-								return String(val) === String(actual);
-							});
-						})) {
-							await renderErrorPage(server, runner, req, res, url, pagesDir, 404, routerShim.wrapWithRouterContext, matcher);
+					const fallback = pathsResult?.fallback ?? false;
+					const paths = pathsResult?.paths ?? [];
+					const currentPathname = normalizeStaticPathname(url);
+					const isValidPath = paths.some((p) => {
+						if (typeof p === "string") return normalizeStaticPathname(p) === currentPathname;
+						const entryParams = p.params;
+						if (entryParams === void 0 || entryParams === null) return false;
+						return Object.entries(entryParams).every(([key, val]) => {
+							const actual = params[key];
+							if (Array.isArray(val)) return Array.isArray(actual) && val.join("/") === actual.join("/");
+							return String(val) === String(actual);
+						});
+					});
+					if (fallback === false && !isValidPath) {
+						if (isDataReq) {
+							res.writeHead(404, { "Content-Type": "application/json" });
+							res.end("{}");
 							return;
 						}
+						await renderErrorPage(server, runner, req, res, url, pagesDir, 404, routerShim.wrapWithRouterContext, matcher);
+						return;
+					}
+					if (fallback === true && !isValidPath && !isDataReq) {
+						isFallbackRender = true;
+						if (typeof routerShim.setSSRContext === "function") routerShim.setSSRContext({
+							pathname: patternToNextFormat(route.pattern),
+							query,
+							asPath: url,
+							locale: locale ?? currentDefaultLocale,
+							locales: i18nConfig?.locales,
+							defaultLocale: currentDefaultLocale,
+							domainLocales,
+							isFallback: true
+						});
 					}
 				}
 				const gsspExtraHeaders = {};
-				if (typeof pageModule.getServerSideProps === "function") {
+				if (typeof pageModule.getServerSideProps === "function" && !isFallbackRender) {
 					const headersBeforeGSSP = new Set(Object.keys(res.getHeaders()));
 					const context = {
-						params,
+						params: userFacingParams,
 						req,
 						res,
 						query,
@@ -260,6 +285,11 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 						return;
 					}
 					if (result && "notFound" in result && result.notFound) {
+						if (isDataReq) {
+							res.writeHead(404, { "Content-Type": "application/json" });
+							res.end("{}");
+							return;
+						}
 						await renderErrorPage(server, runner, req, res, url, pagesDir, 404, routerShim.wrapWithRouterContext);
 						return;
 					}
@@ -283,16 +313,16 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 					if (typeof fontLocalEarly.getSSRFontPreloads === "function") earlyPreloads.push(...fontLocalEarly.getSSRFontPreloads());
 					if (earlyPreloads.length > 0) earlyFontLinkHeader = earlyPreloads.map((p) => `<${p.href}>; rel=preload; as=font; type=${p.type}; crossorigin`).join(", ");
 				} catch {}
-				if (typeof pageModule.getStaticProps === "function") {
+				if (typeof pageModule.getStaticProps === "function" && !isFallbackRender) {
 					const cacheKey = isrCacheKey("pages", url.split("?")[0], process.env.__VINEXT_BUILD_ID);
 					const cached = await isrGet(cacheKey);
-					if (cached && !cached.isStale && cached.value.value?.kind === "PAGES" && !scriptNonce) {
+					if (cached && !cached.isStale && cached.value.value?.kind === "PAGES" && !scriptNonce && !isDataReq) {
 						const cachedHtml = cached.value.value.html;
 						const transformedHtml = await server.transformIndexHtml(url, cachedHtml);
 						const revalidateSecs = getRevalidateDuration(cacheKey) ?? 60;
 						const hitHeaders = {
 							"Content-Type": "text/html",
-							[VINEXT_CACHE_HEADER]: "HIT",
+							...buildCacheStateHeaders("HIT"),
 							"Cache-Control": `s-maxage=${revalidateSecs}, stale-while-revalidate`
 						};
 						if (earlyFontLinkHeader) hitHeaders["Link"] = earlyFontLinkHeader;
@@ -300,14 +330,14 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 						res.end(transformedHtml);
 						return;
 					}
-					if (cached && cached.isStale && cached.value.value?.kind === "PAGES" && !scriptNonce) {
+					if (cached && cached.isStale && cached.value.value?.kind === "PAGES" && !scriptNonce && !isDataReq) {
 						const cachedHtml = cached.value.value.html;
 						const transformedHtml = await server.transformIndexHtml(url, cachedHtml);
 						triggerBackgroundRegeneration(cacheKey, async () => {
 							return runWithRequestContext(createRequestContext({ executionContext: null }), async () => {
 								ensureFetchPatch();
 								const freshResult = await pageModule.getStaticProps({
-									params,
+									params: userFacingParams,
 									locale: locale ?? currentDefaultLocale,
 									locales: i18nConfig?.locales,
 									defaultLocale: currentDefaultLocale
@@ -377,7 +407,7 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 						const revalidateSecs = getRevalidateDuration(cacheKey) ?? 60;
 						const staleHeaders = {
 							"Content-Type": "text/html",
-							[VINEXT_CACHE_HEADER]: "STALE",
+							...buildCacheStateHeaders("STALE"),
 							"Cache-Control": `s-maxage=${revalidateSecs}, stale-while-revalidate`
 						};
 						if (earlyFontLinkHeader) staleHeaders["Link"] = earlyFontLinkHeader;
@@ -386,7 +416,7 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 						return;
 					}
 					const context = {
-						params,
+						params: userFacingParams,
 						locale: locale ?? currentDefaultLocale,
 						locales: i18nConfig?.locales,
 						defaultLocale: currentDefaultLocale
@@ -403,11 +433,24 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 						return;
 					}
 					if (result && "notFound" in result && result.notFound) {
+						if (isDataReq) {
+							res.writeHead(404, { "Content-Type": "application/json" });
+							res.end("{}");
+							return;
+						}
 						await renderErrorPage(server, runner, req, res, url, pagesDir, 404, routerShim.wrapWithRouterContext);
 						return;
 					}
 					if (typeof result?.revalidate === "number" && result.revalidate > 0) isrRevalidateSeconds = result.revalidate;
 				}
+				if (isDataReq) {
+					const dataHeaders = { "Content-Type": "application/json" };
+					if (gsspExtraHeaders) for (const [k, v] of Object.entries(gsspExtraHeaders)) dataHeaders[k] = v;
+					res.writeHead(statusCode ?? 200, dataHeaders);
+					res.end(JSON.stringify({ pageProps }));
+					_renderEnd = now();
+					return;
+				}
 				let AppComponent = null;
 				const appPath = path.join(pagesDir, "_app");
 				if (findFileWithExtensions(appPath, matcher)) try {
@@ -483,7 +526,11 @@ async function hydrate() {
   const root = hydrateRoot(document.getElementById("__next"), element);
   window.__VINEXT_ROOT__ = root;
   installPagesRouterRuntime();
-  window.__VINEXT_HYDRATED_AT = performance.now();
+  const hydratedAt = performance.now();
+  window.__VINEXT_HYDRATED_AT = hydratedAt;
+  window.__NEXT_HYDRATED = true;
+  window.__NEXT_HYDRATED_AT = hydratedAt;
+  window.__NEXT_HYDRATED_CB?.();
 }
 hydrate();
 <\/script>`;
@@ -492,7 +539,7 @@ hydrate();
 					page: patternToNextFormat(route.pattern),
 					query: params,
 					buildId: process.env.__VINEXT_BUILD_ID,
-					isFallback: false,
+					isFallback: isFallbackRender,
 					locale: locale ?? currentDefaultLocale,
 					locales: i18nConfig?.locales,
 					defaultLocale: currentDefaultLocale,
@@ -512,7 +559,7 @@ hydrate();
 				if (isrRevalidateSeconds) if (scriptNonce) extraHeaders["Cache-Control"] = "no-store, must-revalidate";
 				else {
 					extraHeaders["Cache-Control"] = `s-maxage=${isrRevalidateSeconds}, stale-while-revalidate`;
-					extraHeaders[VINEXT_CACHE_HEADER] = "MISS";
+					Object.assign(extraHeaders, buildCacheStateHeaders("MISS"));
 				}
 				if (allFontPreloads.length > 0) extraHeaders["Link"] = allFontPreloads.map((p) => `<${p.href}>; rel=preload; as=font; type=${p.type}; crossorigin`).join(", ");
 				await streamPageToResponse(res, withScriptNonce(element, scriptNonce), {