vinext 0.0.55 → 0.1.0

package/dist/server/isr-cache.js

@@ -1,26 +1,12 @@
 import { getRequestExecutionContext } from "../shims/request-context.js";
 import { reportRequestError } from "./instrumentation.js";
 import { fnv1a64 } from "../utils/hash.js";
-import { getCacheHandler } from "../shims/cache.js";
+import { getCdnCacheAdapter } from "../shims/cdn-cache.js";
 import { normalizeMountedSlotsHeader } from "./app-mounted-slots-header.js";
 import { APP_RSC_RENDER_MODE_NAVIGATION, getRscRenderModeCacheVariant } from "./app-rsc-render-mode.js";
 import { normalizeAppPageInterceptionProofPathname } from "./app-page-render-identity.js";
 //#region src/server/isr-cache.ts
 /**
-* ISR (Incremental Static Regeneration) cache layer.
-*
-* Wraps the pluggable CacheHandler with stale-while-revalidate semantics:
-* - Fresh hit: serve immediately
-* - Stale hit: serve immediately + trigger background regeneration
-* - Miss: render synchronously, cache, serve
-*
-* Background regeneration is deduped — only one regeneration per cache key
-* runs at a time, preventing thundering herd on popular pages.
-*
-* This layer works with any CacheHandler backend (memory, Redis, KV, etc.)
-* because it only uses the standard get/set interface.
-*/
-/**
 * Get a cache entry with staleness information.
 *
 * Returns { value, isStale: false } for fresh entries,
@@ -28,7 +14,7 @@ import { normalizeAppPageInterceptionProofPathname } from "./app-page-render-ide
 * or null for cache misses.
 */
 async function isrGet(key) {
-	const result = await getCacheHandler().get(key);
+	const result = await getCdnCacheAdapter().get(key);
 	if (!result || !result.value) return null;
 	if (result.cacheState === "expired") return null;
 	return {
@@ -40,7 +26,7 @@ async function isrGet(key) {
 * Store a value in the ISR cache with a revalidation period.
 */
 async function isrSet(key, data, revalidateSeconds, tags, expireSeconds) {
-	await getCacheHandler().set(key, data, {
+	await getCdnCacheAdapter().set(key, data, {
 		cacheControl: expireSeconds === void 0 ? { revalidate: revalidateSeconds } : {
 			revalidate: revalidateSeconds,
 			expire: expireSeconds
@@ -50,19 +36,19 @@ async function isrSet(key, data, revalidateSeconds, tags, expireSeconds) {
 	});
 }
 async function isrSetPrerenderedAppPage(key, data, metadata) {
-	const handler = getCacheHandler();
 	const revalidateSeconds = metadata.revalidateSeconds;
+	const tags = metadata.tags;
 	if (process.env.NEXT_PRIVATE_DEBUG_CACHE) console.debug("[vinext] ISR: seed", key);
-	await handler.set(key, data, revalidateSeconds === void 0 ? {} : metadata.expireSeconds === void 0 ? {
-		cacheControl: { revalidate: revalidateSeconds },
-		revalidate: revalidateSeconds
-	} : {
-		cacheControl: {
+	const ctx = {};
+	if (revalidateSeconds !== void 0) {
+		ctx.revalidate = revalidateSeconds;
+		ctx.cacheControl = metadata.expireSeconds === void 0 ? { revalidate: revalidateSeconds } : {
 			revalidate: revalidateSeconds,
 			expire: metadata.expireSeconds
-		},
-		revalidate: revalidateSeconds
-	});
+		};
+	}
+	if (tags && tags.length > 0) ctx.tags = tags;
+	await getCdnCacheAdapter().set(key, data, ctx);
 	if (revalidateSeconds !== void 0) setRevalidateDuration(key, revalidateSeconds);
 }
 const _PENDING_REGEN_KEY = Symbol.for("vinext.isrCache.pendingRegenerations");
@@ -83,6 +69,7 @@ const pendingRegenerations = _g[_PENDING_REGEN_KEY] ??= /* @__PURE__ */ new Map(
 * `revalidateReason: "stale"`.
 */
 function triggerBackgroundRegeneration(key, renderFn, errorContext) {
+	if (!getCdnCacheAdapter().ownsBackgroundRevalidation) return;
 	if (pendingRegenerations.has(key)) return;
 	const promise = renderFn().catch((err) => {
 		console.error(`[vinext] ISR background regeneration failed for ${key}:`, err);
@@ -209,5 +196,3 @@ function getRevalidateDuration(key) {
 }
 //#endregion
 export { appIsrHtmlKey, appIsrRouteKey, appIsrRscKey, buildAppPageCacheValue, buildPagesCacheValue, getRevalidateDuration, isrCacheKey, isrGet, isrSet, isrSetPrerenderedAppPage, normalizeMountedSlotsHeader, setRevalidateDuration, triggerBackgroundRegeneration };
-
-//# sourceMappingURL=isr-cache.js.map

package/dist/server/metadata-route-build-data.d.ts

@@ -21,5 +21,4 @@ declare function createMetadataRouteEntryData(route: MetadataFileRoute): Metadat
 declare function createMetadataRouteEntrySource(input: MetadataRouteEntrySourceInput): string;
 declare function createMetadataRouteEntriesSource(routes: readonly MetadataFileRoute[], moduleNames: ReadonlyMap<string, string>): string[];
 //#endregion
-export { createMetadataRouteEntriesSource, createMetadataRouteEntryData, createMetadataRouteEntrySource };
-//# sourceMappingURL=metadata-route-build-data.d.ts.map
+export { createMetadataRouteEntriesSource, createMetadataRouteEntryData, createMetadataRouteEntrySource };

package/dist/server/metadata-route-build-data.js

@@ -146,5 +146,3 @@ function createMetadataRouteEntriesSource(routes, moduleNames) {
 }
 //#endregion
 export { createMetadataRouteEntriesSource, createMetadataRouteEntryData, createMetadataRouteEntrySource };
-
-//# sourceMappingURL=metadata-route-build-data.js.map

package/dist/server/metadata-route-response.d.ts

@@ -13,5 +13,4 @@ type MetadataRouteRequestOptions = {
 };
 declare function handleMetadataRouteRequest(options: MetadataRouteRequestOptions): Promise<Response | null>;
 //#endregion
-export { handleMetadataRouteRequest };
-//# sourceMappingURL=metadata-route-response.d.ts.map
+export { handleMetadataRouteRequest };

package/dist/server/metadata-route-response.js

@@ -201,5 +201,3 @@ async function handleMetadataRouteRequest(options) {
 }
 //#endregion
 export { handleMetadataRouteRequest };
-
-//# sourceMappingURL=metadata-route-response.js.map

package/dist/server/metadata-routes.d.ts

@@ -136,5 +136,4 @@ declare function matchMetadataFileBaseName(metaType: string, baseName: string):
  */
 declare function scanMetadataFiles(appDir: string): MetadataFileRoute[];
 //#endregion
-export { METADATA_FILE_MAP, ManifestConfig, MetadataFileRoute, MetadataRouteHeadData, RobotsConfig, RobotsRule, SitemapEntry, fillStaticMetadataSegment, getMetadataImageRouteKind, getMetadataRouteKind, isValidMetadataImageId, manifestToJson, matchMetadataFileBaseName, matchMetadataRoutePattern, robotsToText, scanMetadataFiles, sitemapToXml };
-//# sourceMappingURL=metadata-routes.d.ts.map
+export { METADATA_FILE_MAP, ManifestConfig, MetadataFileRoute, MetadataRouteHeadData, RobotsConfig, SitemapEntry, fillStaticMetadataSegment, getMetadataImageRouteKind, getMetadataRouteKind, isValidMetadataImageId, manifestToJson, matchMetadataFileBaseName, matchMetadataRoutePattern, robotsToText, scanMetadataFiles, sitemapToXml };

package/dist/server/metadata-routes.js

@@ -431,5 +431,3 @@ function getStaticContentType(ext, fallback) {
 }
 //#endregion
 export { METADATA_FILE_MAP, fillStaticMetadataSegment, getMetadataImageRouteKind, getMetadataRouteKind, isValidMetadataImageId, manifestToJson, matchMetadataFileBaseName, matchMetadataRoutePattern, robotsToText, scanMetadataFiles, sitemapToXml };
-
-//# sourceMappingURL=metadata-routes.js.map

package/dist/server/middleware-matcher.d.ts

@@ -11,5 +11,4 @@ type MatcherConfig = string | Array<string | MiddlewareMatcherObject>;
 declare function matchesMiddleware(pathname: string, matcher: MatcherConfig | undefined, request?: Request, i18nConfig?: NextI18nConfig | null): boolean;
 declare function matchPattern(pathname: string, pattern: string): boolean;
 //#endregion
-export { MatcherConfig, MiddlewareMatcherObject, matchPattern, matchesMiddleware };
-//# sourceMappingURL=middleware-matcher.d.ts.map
+export { MatcherConfig, matchPattern, matchesMiddleware };

package/dist/server/middleware-matcher.js

@@ -98,5 +98,3 @@ function compileMatcherPattern(pattern) {
 }
 //#endregion
 export { matchPattern, matchesMiddleware };
-
-//# sourceMappingURL=middleware-matcher.js.map

package/dist/server/middleware-request-headers.d.ts

@@ -8,5 +8,4 @@ declare function encodeMiddlewareRequestHeaders(targetHeaders: Headers, requestH
 declare function buildRequestHeadersFromMiddlewareResponse(baseHeaders: Headers, middlewareHeaders: MiddlewareHeaderSource, options?: BuildRequestHeadersOptions): Headers | null;
 declare function shouldKeepMiddlewareHeader(key: string): boolean;
 //#endregion
-export { buildRequestHeadersFromMiddlewareResponse, encodeMiddlewareRequestHeaders, shouldKeepMiddlewareHeader };
-//# sourceMappingURL=middleware-request-headers.d.ts.map
+export { buildRequestHeadersFromMiddlewareResponse, encodeMiddlewareRequestHeaders, shouldKeepMiddlewareHeader };

package/dist/server/middleware-request-headers.js

@@ -63,5 +63,3 @@ function shouldKeepMiddlewareHeader(key) {
 }
 //#endregion
 export { buildRequestHeadersFromMiddlewareResponse, encodeMiddlewareRequestHeaders, shouldKeepMiddlewareHeader };
-
-//# sourceMappingURL=middleware-request-headers.js.map

package/dist/server/middleware-response-headers.d.ts

@@ -9,5 +9,4 @@ declare function mergeVaryHeader(target: Headers, value: string): void;
  */
 declare function mergeMiddlewareResponseHeaders(target: Headers, middlewareHeaders: Headers | null): void;
 //#endregion
-export { mergeMiddlewareResponseHeaders, mergeVaryHeader };
-//# sourceMappingURL=middleware-response-headers.d.ts.map
+export { mergeMiddlewareResponseHeaders, mergeVaryHeader };

package/dist/server/middleware-response-headers.js

@@ -40,5 +40,3 @@ function mergeMiddlewareResponseHeaders(target, middlewareHeaders) {
 }
 //#endregion
 export { mergeMiddlewareResponseHeaders, mergeVaryHeader };
-
-//# sourceMappingURL=middleware-response-headers.js.map

package/dist/server/middleware-runtime.d.ts

@@ -51,5 +51,4 @@ declare function resolveMiddlewareModuleHandler(mod: MiddlewareModule, options:
 declare function executeMiddleware(options: ExecuteMiddlewareOptions): Promise<MiddlewareResult>;
 declare function runGeneratedMiddleware(options: RunGeneratedMiddlewareOptions): Promise<MiddlewareResult>;
 //#endregion
-export { MiddlewareModule, MiddlewareResult, executeMiddleware, resolveMiddlewareModuleHandler, runGeneratedMiddleware };
-//# sourceMappingURL=middleware-runtime.d.ts.map
+export { MiddlewareModule, MiddlewareResult, executeMiddleware, resolveMiddlewareModuleHandler, runGeneratedMiddleware };

package/dist/server/middleware-runtime.js

@@ -154,15 +154,26 @@ async function executeMiddleware(options) {
 		const location = response.headers.get("Location") ?? response.headers.get("location");
 		if (location) {
 			const relativeLocation = relativizeLocation(location, options.request.url);
+			let normalizedLocation = relativeLocation;
+			if (options.trailingSlash !== void 0) try {
+				const loc = new URL(relativeLocation, options.request.url);
+				if (loc.origin === new URL(options.request.url).origin) {
+					const p = loc.pathname;
+					let normalized = null;
+					if (p !== "" && p !== "/") if (options.trailingSlash) normalized = p.endsWith("/") ? null : p + "/";
+					else normalized = p.endsWith("/") ? p.slice(0, -1) : null;
+					if (normalized !== null) normalizedLocation = normalized + loc.search + loc.hash;
+				}
+			} catch {}
 			if (options.isDataRequest) return {
 				continue: false,
-				response: dataRedirectResponse(relativeLocation, response),
+				response: dataRedirectResponse(normalizedLocation, response),
 				waitUntilPromises
 			};
 			const responseHeaders = new Headers();
 			for (const [key, value] of response.headers) if (!key.startsWith("x-middleware-") && key.toLowerCase() !== "location") responseHeaders.append(key, value);
 			const relativizedResponseHeaders = new Headers(response.headers);
-			relativizedResponseHeaders.set("Location", relativeLocation);
+			relativizedResponseHeaders.set("Location", normalizedLocation);
 			const relativizedResponse = new Response(response.body, {
 				status: response.status,
 				statusText: response.statusText,
@@ -170,7 +181,7 @@ async function executeMiddleware(options) {
 			});
 			return {
 				continue: false,
-				redirectUrl: relativeLocation,
+				redirectUrl: normalizedLocation,
 				redirectStatus: response.status,
 				response: stripMiddlewareHeadersFromResponse(relativizedResponse),
 				responseHeaders,
@@ -210,5 +221,3 @@ async function runGeneratedMiddleware(options) {
 }
 //#endregion
 export { executeMiddleware, resolveMiddlewareModuleHandler, runGeneratedMiddleware };
-
-//# sourceMappingURL=middleware-runtime.js.map

package/dist/server/middleware.d.ts

@@ -1,5 +1,5 @@
-import { ValidFileMatcher } from "../routing/file-matcher.js";
 import { NextI18nConfig } from "../config/next-config.js";
+import { ValidFileMatcher } from "../routing/file-matcher.js";
 import { MiddlewareModule, MiddlewareResult } from "./middleware-runtime.js";
 import { matchPattern, matchesMiddleware } from "./middleware-matcher.js";
 import { ModuleRunner } from "vite/module-runner";
@@ -59,5 +59,4 @@ declare function findMiddlewareFile(root: string, fileMatcher: ValidFileMatcher)
  */
 declare function runMiddleware(runner: ModuleRunner, middlewarePath: string, request: Request, i18nConfig?: NextI18nConfig | null, basePath?: string, trailingSlash?: boolean, isDataRequest?: boolean): Promise<MiddlewareResult>;
 //#endregion
-export { findMiddlewareFile, isProxyFile, matchPattern, matchesMiddleware, resolveMiddlewareHandler, runMiddleware };
-//# sourceMappingURL=middleware.d.ts.map
+export { findMiddlewareFile, isProxyFile, matchPattern, matchesMiddleware, resolveMiddlewareHandler, runMiddleware };

package/dist/server/middleware.js

@@ -96,5 +96,3 @@ async function runMiddleware(runner, middlewarePath, request, i18nConfig, basePa
 }
 //#endregion
 export { findMiddlewareFile, isProxyFile, matchPattern, matchesMiddleware, resolveMiddlewareHandler, runMiddleware };
-
-//# sourceMappingURL=middleware.js.map

package/dist/server/navigation-planner.d.ts

@@ -126,6 +126,21 @@ declare function classifyRootBoundaryTransition(currentRootBoundaryId: string |
 declare function resolveSameLayoutAncestorPersistence(currentSnapshot: RouteSnapshotV0, targetSnapshot: RouteSnapshotV0): readonly string[];
 declare function resolveMountedParallelSlotPersistence(currentSnapshot: RouteSnapshotV0, targetSnapshot: RouteSnapshotV0): readonly string[];
 declare function resolveCurrentRootBoundaryElementPersistence(currentSnapshot: RouteSnapshotV0, targetSnapshot: RouteSnapshotV0): readonly string[];
+/**
+ * Default/unmatched slot preservation law:
+ *
+ * A target default/unmatched slot may reuse previous content only when:
+ * - the slot's owner layout is part of the preserved layout ancestor set;
+ * - the current visible snapshot proves the same slot had renderable content;
+ * - the navigation is not a traversal.
+ *
+ * Wire absence and UNMATCHED_SLOT markers are not semantic proof.
+ */
+declare function resolveDefaultOrUnmatchedSlotPersistenceForLayouts(options: {
+  currentSlotBindings: readonly ParallelSlotBindingSnapshotV0[];
+  preservedLayoutIds: readonly string[];
+  targetSlotBindings: readonly ParallelSlotBindingSnapshotV0[];
+}): readonly string[];
 declare function planNavigation(input: NavigationPlannerInput): NavigationDecisionV0;
 declare const navigationPlanner: {
   classifyRootBoundaryTransition: typeof classifyRootBoundaryTransition;
@@ -135,5 +150,4 @@ declare const navigationPlanner: {
   resolveSameLayoutAncestorPersistence: typeof resolveSameLayoutAncestorPersistence;
 };
 //#endregion
-export { CommitProposal, FlightResultV0, HardNavigationReason, InterceptionSnapshotV0, MountedParallelSlotSnapshotV0, NavigationDecisionV0, NavigationEvent, NavigationPlannerInput, NavigationPlannerStateV0, NoCommitReason, OperationLane, OperationToken, ParallelSlotBindingSnapshotV0, RefreshScope, RequestedWork, RootBoundaryTransition, RouteSnapshotV0, TraverseDirection, navigationPlanner };
-//# sourceMappingURL=navigation-planner.d.ts.map
+export { FlightResultV0, InterceptionSnapshotV0, MountedParallelSlotSnapshotV0, NavigationDecisionV0, NavigationEvent, NavigationPlannerInput, NavigationPlannerStateV0, OperationLane, OperationToken, ParallelSlotBindingSnapshotV0, RefreshScope, RootBoundaryTransition, RouteSnapshotV0, TraverseDirection, navigationPlanner, resolveDefaultOrUnmatchedSlotPersistenceForLayouts };

package/dist/server/navigation-planner.js

@@ -500,6 +500,4 @@ const navigationPlanner = {
 	resolveSameLayoutAncestorPersistence
 };
 //#endregion
-export { navigationPlanner };
-
-//# sourceMappingURL=navigation-planner.js.map
+export { navigationPlanner, resolveDefaultOrUnmatchedSlotPersistenceForLayouts };

package/dist/server/navigation-trace.d.ts

@@ -47,5 +47,4 @@ declare function createNavigationLifecycleTraceFields(options: {
 declare function createNavigationTrace(code: NavigationTraceCode, fields?: NavigationTraceFields): NavigationTrace;
 declare function prependNavigationTraceEntry(trace: NavigationTrace, code: NavigationTraceCode, fields?: NavigationTraceFields): NavigationTrace;
 //#endregion
-export { NAVIGATION_TRACE_SCHEMA_VERSION, NavigationTrace, NavigationTraceCode, NavigationTraceEntry, NavigationTraceFieldName, NavigationTraceFieldValue, NavigationTraceFields, NavigationTraceReasonCode, NavigationTraceReasonCodes, NavigationTraceSchemaVersion, NavigationTraceTransactionCode, NavigationTraceTransactionCodes, createNavigationLifecycleTraceFields, createNavigationTrace, prependNavigationTraceEntry };
-//# sourceMappingURL=navigation-trace.d.ts.map
+export { NAVIGATION_TRACE_SCHEMA_VERSION, NavigationTrace, NavigationTraceCode, NavigationTraceFields, NavigationTraceReasonCode, NavigationTraceReasonCodes, NavigationTraceTransactionCode, NavigationTraceTransactionCodes, createNavigationLifecycleTraceFields, createNavigationTrace, prependNavigationTraceEntry };

package/dist/server/navigation-trace.js

@@ -51,5 +51,3 @@ function prependNavigationTraceEntry(trace, code, fields = {}) {
 }
 //#endregion
 export { NAVIGATION_TRACE_SCHEMA_VERSION, NavigationTraceReasonCodes, NavigationTraceTransactionCodes, createNavigationLifecycleTraceFields, createNavigationTrace, prependNavigationTraceEntry };
-
-//# sourceMappingURL=navigation-trace.js.map

package/dist/server/next-error-digest.d.ts

@@ -41,5 +41,4 @@ declare function parseNextRedirectDigest(digest: string): NextRedirectDigest | n
  */
 declare function parseNextHttpErrorDigest(digest: string): NextHttpErrorDigest | null;
 //#endregion
-export { getNextErrorDigest, parseNextHttpErrorDigest, parseNextRedirectDigest };
-//# sourceMappingURL=next-error-digest.d.ts.map
+export { getNextErrorDigest, parseNextHttpErrorDigest, parseNextRedirectDigest };

package/dist/server/next-error-digest.js

@@ -38,5 +38,3 @@ function parseNextHttpErrorDigest(digest) {
 }
 //#endregion
 export { getNextErrorDigest, parseNextHttpErrorDigest, parseNextRedirectDigest };
-
-//# sourceMappingURL=next-error-digest.js.map

package/dist/server/normalize-path.d.ts

@@ -43,5 +43,4 @@ declare function isInterceptionMatchedUrlPath(value: string): boolean;
  */
 declare function normalizePath(pathname: string): string;
 //#endregion
-export { decodePathParams, escapePathDelimiters, isInterceptionMatchedUrlPath, normalizePath };
-//# sourceMappingURL=normalize-path.d.ts.map
+export { decodePathParams, escapePathDelimiters, isInterceptionMatchedUrlPath, normalizePath };

package/dist/server/normalize-path.js

@@ -66,5 +66,3 @@ function normalizePath(pathname) {
 }
 //#endregion
 export { decodePathParams, escapePathDelimiters, isInterceptionMatchedUrlPath, normalizePath };
-
-//# sourceMappingURL=normalize-path.js.map

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

@@ -63,5 +63,4 @@ type HandlePagesApiRouteOptions = {
 };
 declare function handlePagesApiRoute(options: HandlePagesApiRouteOptions): Promise<Response>;
 //#endregion
-export { PagesApiRouteMatch, handlePagesApiRoute };
-//# sourceMappingURL=pages-api-route.d.ts.map
+export { PagesApiRouteMatch, handlePagesApiRoute };

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

@@ -38,7 +38,7 @@ async function _handlePagesApiRoute(options) {
 		const query = buildPagesApiQuery(options.url, params);
 		const bodyParserConfig = resolveBodyParserConfig(route.module.config);
 		const { req, res, responsePromise } = createPagesReqRes({
-			body: bodyParserConfig.enabled ? await parsePagesApiBody(options.request, bodyParserConfig.sizeLimit) : options.request.body ?? void 0,
+			body: bodyParserConfig.enabled ? await parsePagesApiBody(options.request, bodyParserConfig.sizeLimit) : void 0,
 			query,
 			request: options.request,
 			url: options.url
@@ -57,5 +57,3 @@ async function _handlePagesApiRoute(options) {
 }
 //#endregion
 export { handlePagesApiRoute };
-
-//# sourceMappingURL=pages-api-route.js.map

package/dist/server/pages-asset-tags.d.ts

@@ -0,0 +1,66 @@
+//#region src/server/pages-asset-tags.d.ts
+/**
+ * Pages Router SSR asset-tag helpers.
+ *
+ * Builds the `<link rel="modulepreload">`, `<link rel="stylesheet">`, and
+ * `<script type="module">` tags injected into the SSR HTML response.
+ *
+ * Extracted from `entries/pages-server-entry.ts` so the logic is
+ * unit-testable and lives in a normal typed module rather than a codegen
+ * template string.
+ */
+/**
+ * Resolve the effective SSR manifest: prefer the caller-supplied object (dev
+ * or test) and fall back to the Worker-embedded `globalThis.__VINEXT_SSR_MANIFEST__`
+ * injected by `vinext:cloudflare-build` at build time.
+ */
+declare function resolveSsrManifest(manifest: Record<string, string[]> | null | undefined): Record<string, string[]> | null;
+/**
+ * Look up the asset-file list for a module ID in the SSR manifest.
+ *
+ * The manifest keys may use relative paths while callers supply absolute
+ * paths, so a suffix-match fallback is used when an exact-key lookup fails.
+ */
+declare function getManifestFilesForModule(manifest: Record<string, string[]> | null | undefined, moduleId: string | null | undefined): string[] | null;
+/**
+ * Find the first `.js` file in the manifest for `moduleId` and return its
+ * URL-path form (with a leading `/`). Used to resolve the hydration URL for
+ * the matched page or the `_app` module.
+ */
+declare function resolveClientModuleUrl(manifest: Record<string, string[]> | null | undefined, moduleId: string | null | undefined): string | undefined;
+type CollectAssetTagsOptions = {
+  /**
+   * SSR manifest mapping module file paths to their associated asset list.
+   * When empty/null the Worker-embedded `__VINEXT_SSR_MANIFEST__` is used.
+   */
+  manifest: Record<string, string[]> | null | undefined;
+  /**
+   * Module IDs whose assets should be injected (page + `_app`). When empty
+   * all manifest assets are injected.
+   */
+  moduleIds: (string | null | undefined)[]; /** Script nonce for CSP. */
+  scriptNonce?: string;
+  /**
+   * When `false` (default), page scripts are emitted with the `defer`
+   * attribute mirroring Next.js's `experimental.disableOptimizedLoading`
+   * default.
+   */
+  disableOptimizedLoading: boolean;
+};
+/**
+ * Build the HTML `<link>` and `<script>` tag string for the SSR response.
+ *
+ * Mirrors Next.js `_document` behaviour:
+ * - CSS files → `<link rel="stylesheet">`.
+ * - JS files → `<link rel="modulepreload">` + `<script type="module" defer>`.
+ * - Lazy chunks (behind `React.lazy` / `next/dynamic`) are skipped.
+ * - The Worker-embedded client-entry bootstrap (`__VINEXT_CLIENT_ENTRY__`) is
+ *   injected first so hydration starts as early as possible.
+ * - Shared framework / vinext runtime chunks are always included alongside
+ *   page-specific chunks.
+ *
+ * Extracted from `entries/pages-server-entry.ts`.
+ */
+declare function collectAssetTags(options: CollectAssetTagsOptions): string;
+//#endregion
+export { collectAssetTags, getManifestFilesForModule, resolveClientModuleUrl, resolveSsrManifest };

package/dist/server/pages-asset-tags.js

@@ -0,0 +1,116 @@
+import { createNonceAttribute } from "./html.js";
+//#region src/server/pages-asset-tags.ts
+/**
+* Pages Router SSR asset-tag helpers.
+*
+* Builds the `<link rel="modulepreload">`, `<link rel="stylesheet">`, and
+* `<script type="module">` tags injected into the SSR HTML response.
+*
+* Extracted from `entries/pages-server-entry.ts` so the logic is
+* unit-testable and lives in a normal typed module rather than a codegen
+* template string.
+*/
+/**
+* Resolve the effective SSR manifest: prefer the caller-supplied object (dev
+* or test) and fall back to the Worker-embedded `globalThis.__VINEXT_SSR_MANIFEST__`
+* injected by `vinext:cloudflare-build` at build time.
+*/
+function resolveSsrManifest(manifest) {
+	if (manifest && Object.keys(manifest).length > 0) return manifest;
+	return (typeof globalThis !== "undefined" ? globalThis.__VINEXT_SSR_MANIFEST__ : null) ?? null;
+}
+/**
+* Look up the asset-file list for a module ID in the SSR manifest.
+*
+* The manifest keys may use relative paths while callers supply absolute
+* paths, so a suffix-match fallback is used when an exact-key lookup fails.
+*/
+function getManifestFilesForModule(manifest, moduleId) {
+	if (!manifest || !moduleId) return null;
+	const files = manifest[moduleId];
+	if (files) return files;
+	for (const key in manifest) if (moduleId.endsWith("/" + key) || moduleId === key) return manifest[key];
+	return null;
+}
+/**
+* Find the first `.js` file in the manifest for `moduleId` and return its
+* URL-path form (with a leading `/`). Used to resolve the hydration URL for
+* the matched page or the `_app` module.
+*/
+function resolveClientModuleUrl(manifest, moduleId) {
+	const files = getManifestFilesForModule(resolveSsrManifest(manifest), moduleId);
+	if (!files) return void 0;
+	for (let i = 0; i < files.length; i++) {
+		let file = files[i];
+		if (!file || !file.endsWith(".js")) continue;
+		if (file.charAt(0) !== "/") file = "/" + file;
+		return file;
+	}
+}
+/**
+* Build the HTML `<link>` and `<script>` tag string for the SSR response.
+*
+* Mirrors Next.js `_document` behaviour:
+* - CSS files → `<link rel="stylesheet">`.
+* - JS files → `<link rel="modulepreload">` + `<script type="module" defer>`.
+* - Lazy chunks (behind `React.lazy` / `next/dynamic`) are skipped.
+* - The Worker-embedded client-entry bootstrap (`__VINEXT_CLIENT_ENTRY__`) is
+*   injected first so hydration starts as early as possible.
+* - Shared framework / vinext runtime chunks are always included alongside
+*   page-specific chunks.
+*
+* Extracted from `entries/pages-server-entry.ts`.
+*/
+function collectAssetTags(options) {
+	const m = resolveSsrManifest(options.manifest);
+	const tags = [];
+	const seen = /* @__PURE__ */ new Set();
+	const nonceAttr = createNonceAttribute(options.scriptNonce);
+	const deferAttr = options.disableOptimizedLoading ? "" : " defer";
+	const lazyChunks = typeof globalThis !== "undefined" && globalThis.__VINEXT_LAZY_CHUNKS__ || null;
+	const lazySet = lazyChunks && lazyChunks.length > 0 ? new Set(lazyChunks) : null;
+	if (typeof globalThis !== "undefined" && globalThis.__VINEXT_CLIENT_ENTRY__) {
+		const entry = globalThis.__VINEXT_CLIENT_ENTRY__;
+		seen.add(entry);
+		tags.push("<link rel=\"modulepreload\"" + nonceAttr + " href=\"/" + entry + "\" />");
+		tags.push("<script type=\"module\"" + deferAttr + nonceAttr + " src=\"/" + entry + "\" crossorigin><\/script>");
+	}
+	if (m) {
+		const allFiles = [];
+		const moduleIds = options.moduleIds;
+		if (moduleIds && moduleIds.length > 0) {
+			for (let mi = 0; mi < moduleIds.length; mi++) {
+				const id = moduleIds[mi];
+				const files = getManifestFilesForModule(m, id);
+				if (files) for (let fi = 0; fi < files.length; fi++) allFiles.push(files[fi]);
+			}
+			for (const key in m) {
+				const vals = m[key];
+				if (!vals) continue;
+				for (let vi = 0; vi < vals.length; vi++) {
+					const file = vals[vi];
+					const basename = file.split("/").pop() || "";
+					if (basename.startsWith("framework-") || basename.startsWith("vinext-") || basename.includes("vinext-client-entry") || basename.includes("vinext-app-browser-entry")) allFiles.push(file);
+				}
+			}
+		} else for (const akey in m) {
+			const avals = m[akey];
+			if (avals) for (let ai = 0; ai < avals.length; ai++) allFiles.push(avals[ai]);
+		}
+		for (let ti = 0; ti < allFiles.length; ti++) {
+			let tf = allFiles[ti];
+			if (tf.charAt(0) === "/") tf = tf.slice(1);
+			if (seen.has(tf)) continue;
+			seen.add(tf);
+			if (tf.endsWith(".css")) tags.push("<link rel=\"stylesheet\"" + nonceAttr + " href=\"/" + tf + "\" />");
+			else if (tf.endsWith(".js")) {
+				if (lazySet && lazySet.has(tf)) continue;
+				tags.push("<link rel=\"modulepreload\"" + nonceAttr + " href=\"/" + tf + "\" />");
+				tags.push("<script type=\"module\"" + deferAttr + nonceAttr + " src=\"/" + tf + "\" crossorigin><\/script>");
+			}
+		}
+	}
+	return tags.join("\n  ");
+}
+//#endregion
+export { collectAssetTags, getManifestFilesForModule, resolveClientModuleUrl, resolveSsrManifest };

package/dist/server/pages-body-parser-config.d.ts

@@ -56,5 +56,4 @@ declare function resolveBodyParserConfig(moduleConfig: {
   };
 } | undefined, defaultSizeLimit?: number): ResolvedBodyParserConfig;
 //#endregion
-export { DEFAULT_PAGES_API_BODY_SIZE_LIMIT, parseSizeLimit, resolveBodyParserConfig };
-//# sourceMappingURL=pages-body-parser-config.d.ts.map
+export { DEFAULT_PAGES_API_BODY_SIZE_LIMIT, parseSizeLimit, resolveBodyParserConfig };

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

@@ -75,5 +75,3 @@ function resolveBodyParserConfig(moduleConfig, defaultSizeLimit = DEFAULT_PAGES_
 }
 //#endregion
 export { DEFAULT_PAGES_API_BODY_SIZE_LIMIT, parseSizeLimit, resolveBodyParserConfig };
-
-//# sourceMappingURL=pages-body-parser-config.js.map

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

@@ -72,6 +72,43 @@ declare function buildNextDataJsonResponse(pageProps: Record<string, unknown>, s
  * before checking the status code.
  */
 declare function buildNextDataNotFoundResponse(): Response;
+type NormalizePagesDataRequestResult = {
+  isDataReq: false;
+  request: Request;
+  normalizedPathname: null;
+  search: "";
+  notFoundResponse: null;
+} | {
+  isDataReq: false;
+  request: Request;
+  normalizedPathname: null;
+  search: "";
+  notFoundResponse: Response;
+} | {
+  isDataReq: true;
+  request: Request;
+  normalizedPathname: string;
+  search: string;
+  notFoundResponse: null;
+};
+/**
+ * Detect and normalize `/_next/data/<buildId>/<page>.json` requests in one
+ * place so the Pages Router pipeline and middleware shim do not need to know
+ * about the data-endpoint protocol.
+ *
+ * Returns:
+ * - `isDataReq: false, notFoundResponse: null` — not a data request.
+ * - `isDataReq: false, notFoundResponse: Response` — looks like a data URL but
+ *   the buildId does not match; callers should return `notFoundResponse`
+ *   immediately so stale clients fall back to a hard navigation.
+ * - `isDataReq: true` — valid data request; `request` is re-pointed at the
+ *   normalized page path, `normalizedPathname` carries the bare page path, and
+ *   `search` carries the original query string for callers that need to
+ *   preserve it.
+ *
+ * Extracted from `entries/pages-server-entry.ts` so both `renderPage` and
+ * `runMiddleware` share a single implementation.
+ */
+declare function normalizePagesDataRequest(request: Request, buildId: string | null): NormalizePagesDataRequestResult;
 //#endregion
-export { buildNextDataJsonResponse, buildNextDataNotFoundResponse, isNextDataPathname, parseNextDataPathname };
-//# sourceMappingURL=pages-data-route.d.ts.map
+export { buildNextDataJsonResponse, buildNextDataNotFoundResponse, isNextDataPathname, normalizePagesDataRequest, parseNextDataPathname };