vinext 0.1.8 → 0.2.1

package/dist/server/image-optimization.js

@@ -78,7 +78,8 @@ function parseImageParams(url, allowedWidths = [...DEFAULT_DEVICE_SIZES, ...DEFA
 	const allowedParamNames = new Set([
 		"url",
 		"w",
-		"q"
+		"q",
+		"dpl"
 	]);
 	for (const name of url.searchParams.keys()) if (!allowedParamNames.has(name) || url.searchParams.getAll(name).length !== 1) return null;
 	const imageUrl = url.searchParams.get("url");
@@ -225,5 +226,54 @@ async function handleImageOptimization(request, handlers, allowedWidths, imageCo
 		return createPassthroughImageResponse(refetchedSource, imageConfig);
 	}
 }
+const _IMAGE_OPTIMIZER_KEY = Symbol.for("vinext.imageOptimizer");
+const _gImageOptimizer = globalThis;
+/**
+* Register the active image optimizer (transform backend). An explicit
+* registration always wins; passing `null` clears it (falling back to
+* unoptimized passthrough).
+*
+* Configure this declaratively via the `images.optimizer` option on the
+* `vinext()` plugin in your `vite.config.ts` rather than calling it directly.
+* On Cloudflare Workers:
+*
+* ```ts
+* import { vinext } from "vinext";
+* import { imagesOptimizer } from "@vinext/cloudflare/images/images-optimizer";
+*
+* export default defineConfig({
+*   plugins: [vinext({ images: { optimizer: imagesOptimizer() } })],
+* });
+* ```
+*
+* The plugin registers the optimizer across every runtime/router entry, so you
+* don't have to wire `env.IMAGES` into a custom worker entry. This setter
+* remains the internal registration target.
+*/
+function setImageOptimizer(optimizer) {
+	_gImageOptimizer[_IMAGE_OPTIMIZER_KEY] = optimizer ?? void 0;
+}
+/** Get the active image optimizer, or `null` when none is configured. */
+function getImageOptimizer() {
+	return _gImageOptimizer[_IMAGE_OPTIMIZER_KEY] ?? null;
+}
+/**
+* Handle an image optimization request using the configured optimizer (if any).
+*
+* This is the single entry point every runtime/router seam (App Router worker,
+* Pages worker, Node prod server) should call: it reads the registered
+* {@link ImageOptimizer} and wires its `transformImage` into
+* {@link handleImageOptimization}, with the caller supplying the runtime's
+* `fetchAsset` (e.g. the Cloudflare `ASSETS` binding, or filesystem reads on
+* Node). When no optimizer is registered, the request is served unoptimized
+* (passthrough) with the same security/cache headers.
+*/
+function handleConfiguredImageOptimization(request, fetchAsset, allowedWidths, imageConfig) {
+	const optimizer = getImageOptimizer();
+	return handleImageOptimization(request, {
+		fetchAsset,
+		transformImage: optimizer ? (body, options) => optimizer.transformImage(body, options) : void 0
+	}, allowedWidths, imageConfig);
+}
 //#endregion
-export { DEFAULT_DEVICE_SIZES, DEFAULT_IMAGE_SIZES, IMAGE_CACHE_CONTROL, IMAGE_CONTENT_SECURITY_POLICY, IMAGE_OPTIMIZATION_PATH, VINEXT_IMAGE_OPTIMIZATION_PATH, handleImageOptimization, isImageOptimizationPath, isSafeImageContentType, negotiateImageFormat, parseImageParams, resolveDevImageRedirect };
+export { DEFAULT_DEVICE_SIZES, DEFAULT_IMAGE_SIZES, IMAGE_CACHE_CONTROL, IMAGE_CONTENT_SECURITY_POLICY, IMAGE_OPTIMIZATION_PATH, VINEXT_IMAGE_OPTIMIZATION_PATH, getImageOptimizer, handleConfiguredImageOptimization, handleImageOptimization, isImageOptimizationPath, isSafeImageContentType, negotiateImageFormat, parseImageParams, resolveDevImageRedirect, setImageOptimizer };

package/dist/server/implicit-tags.js

@@ -33,7 +33,7 @@ function buildAppPageTags(cleanPathname, extraTags, routeSegments) {
 	return buildPageCacheTags(cleanPathname, extraTags, [...routeSegments], "page");
 }
 function buildPageCacheTags(pathname, extraTags, routeSegments, leafKind) {
-	const tags = [pathname, `${NEXT_CACHE_IMPLICIT_TAG_ID}${pathname}`];
+	const tags = [pathname, `${NEXT_CACHE_IMPLICIT_TAG_ID}${pathname.length > 1 && pathname.endsWith("/") ? pathname.slice(0, -1) : pathname}`];
 	if (pathname === "/") appendUnique(tags, `${NEXT_CACHE_IMPLICIT_TAG_ID}/index`);
 	if (pathname === "/index") appendUnique(tags, `${NEXT_CACHE_IMPLICIT_TAG_ID}/`);
 	appendDerivedTags(tags, buildRouteCachePath(routeSegments, leafKind));

package/dist/server/isr-cache.d.ts

@@ -34,6 +34,7 @@ declare const PRERENDER_REVALIDATE_HEADER = "x-prerender-revalidate";
  */
 declare const PRERENDER_REVALIDATE_ONLY_GENERATED_HEADER = "x-prerender-revalidate-if-generated";
 declare function getRevalidateSecret(): string;
+declare function isRevalidateSecret(value: string | null | undefined): boolean;
 /**
  * Authorize an incoming request as an on-demand revalidation trigger. Mirrors
  * Next.js's `checkIsOnDemandRevalidate`: the {@link PRERENDER_REVALIDATE_HEADER}
@@ -95,7 +96,7 @@ declare function buildPagesCacheValue(html: string, pageData: object, status?: n
 /**
  * Build a CachedAppPageValue for the App Router ISR cache.
  */
-declare function buildAppPageCacheValue(html: string, rscData?: ArrayBuffer, status?: number, renderObservation?: RenderObservation): CachedAppPageValue;
+declare function buildAppPageCacheValue(html: string, rscData?: ArrayBuffer, status?: number, renderObservation?: RenderObservation, headers?: CachedAppPageValue["headers"]): CachedAppPageValue;
 /**
  * Compute an ISR cache key for a given router type and pathname.
  * Long pathnames are hashed to stay within KV key-length limits (512 bytes).
@@ -124,4 +125,4 @@ declare function setRevalidateDuration(key: string, seconds: number): void;
  */
 declare function getRevalidateDuration(key: string): number | undefined;
 //#endregion
-export { ISRCacheEntry, PRERENDER_REVALIDATE_HEADER, PRERENDER_REVALIDATE_ONLY_GENERATED_HEADER, appIsrHtmlKey, appIsrRouteKey, appIsrRscKey, buildAppPageCacheValue, buildPagesCacheValue, getRevalidateDuration, getRevalidateSecret, isOnDemandRevalidateRequest, isrCacheKey, isrGet, isrSet, isrSetPrerenderedAppPage, normalizeMountedSlotsHeader, setRevalidateDuration, triggerBackgroundRegeneration };
+export { ISRCacheEntry, PRERENDER_REVALIDATE_HEADER, PRERENDER_REVALIDATE_ONLY_GENERATED_HEADER, appIsrHtmlKey, appIsrRouteKey, appIsrRscKey, buildAppPageCacheValue, buildPagesCacheValue, getRevalidateDuration, getRevalidateSecret, isOnDemandRevalidateRequest, isRevalidateSecret, isrCacheKey, isrGet, isrSet, isrSetPrerenderedAppPage, normalizeMountedSlotsHeader, setRevalidateDuration, triggerBackgroundRegeneration };

package/dist/server/isr-cache.js

@@ -80,6 +80,10 @@ function safeEqual(a, b) {
 	for (let i = 0; i < a.length; i++) mismatch |= a.charCodeAt(i) ^ b.charCodeAt(i);
 	return mismatch === 0;
 }
+function isRevalidateSecret(value) {
+	if (typeof value !== "string" || value.length === 0) return false;
+	return safeEqual(value, getRevalidateSecret());
+}
 /**
 * Authorize an incoming request as an on-demand revalidation trigger. Mirrors
 * Next.js's `checkIsOnDemandRevalidate`: the {@link PRERENDER_REVALIDATE_HEADER}
@@ -87,8 +91,8 @@ function safeEqual(a, b) {
 * NOT sufficient — see the security note on {@link PRERENDER_REVALIDATE_HEADER}.
 */
 function isOnDemandRevalidateRequest(headerValue) {
-	if (typeof headerValue !== "string" || headerValue.length === 0) return false;
-	return safeEqual(headerValue, getRevalidateSecret());
+	if (typeof headerValue !== "string") return false;
+	return isRevalidateSecret(headerValue);
 }
 /**
 * Get a cache entry with staleness information.
@@ -188,12 +192,12 @@ function buildPagesCacheValue(html, pageData, status) {
 /**
 * Build a CachedAppPageValue for the App Router ISR cache.
 */
-function buildAppPageCacheValue(html, rscData, status, renderObservation) {
+function buildAppPageCacheValue(html, rscData, status, renderObservation, headers) {
 	const value = {
 		kind: "APP_PAGE",
 		html,
 		rscData,
-		headers: void 0,
+		headers,
 		postponed: void 0,
 		status
 	};
@@ -279,4 +283,4 @@ function getRevalidateDuration(key) {
 	return revalidateDurations.get(key);
 }
 //#endregion
-export { PRERENDER_REVALIDATE_HEADER, PRERENDER_REVALIDATE_ONLY_GENERATED_HEADER, appIsrHtmlKey, appIsrRouteKey, appIsrRscKey, buildAppPageCacheValue, buildPagesCacheValue, getRevalidateDuration, getRevalidateSecret, isOnDemandRevalidateRequest, isrCacheKey, isrGet, isrSet, isrSetPrerenderedAppPage, normalizeMountedSlotsHeader, setRevalidateDuration, triggerBackgroundRegeneration };
+export { PRERENDER_REVALIDATE_HEADER, PRERENDER_REVALIDATE_ONLY_GENERATED_HEADER, appIsrHtmlKey, appIsrRouteKey, appIsrRscKey, buildAppPageCacheValue, buildPagesCacheValue, getRevalidateDuration, getRevalidateSecret, isOnDemandRevalidateRequest, isRevalidateSecret, isrCacheKey, isrGet, isrSet, isrSetPrerenderedAppPage, normalizeMountedSlotsHeader, setRevalidateDuration, triggerBackgroundRegeneration };

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

@@ -131,9 +131,11 @@ declare function getMetadataImageRouteKind(route: Pick<MetadataFileRoute, "type"
 declare function isValidMetadataImageId(id: string): boolean;
 declare function matchMetadataRoutePattern(urlParts: string[], patternParts: string[]): Record<string, string | string[]> | null;
 declare function matchMetadataFileBaseName(metaType: string, baseName: string): string | null;
+/** Clear the {@link scanMetadataFiles} cache (call when app files change in dev). */
+declare function invalidateMetadataFileCache(): void;
 /**
  * Scan an app directory for metadata files.
  */
 declare function scanMetadataFiles(appDir: string): MetadataFileRoute[];
 //#endregion
-export { METADATA_FILE_MAP, ManifestConfig, MetadataFileRoute, MetadataRouteHeadData, RobotsConfig, SitemapEntry, fillStaticMetadataSegment, getMetadataImageRouteKind, getMetadataRouteKind, isValidMetadataImageId, manifestToJson, matchMetadataFileBaseName, matchMetadataRoutePattern, robotsToText, scanMetadataFiles, sitemapToXml };
+export { METADATA_FILE_MAP, ManifestConfig, MetadataFileRoute, MetadataRouteHeadData, RobotsConfig, SitemapEntry, fillStaticMetadataSegment, getMetadataImageRouteKind, getMetadataRouteKind, invalidateMetadataFileCache, isValidMetadataImageId, manifestToJson, matchMetadataFileBaseName, matchMetadataRoutePattern, robotsToText, scanMetadataFiles, sitemapToXml };

package/dist/server/metadata-routes.js

@@ -357,10 +357,18 @@ function matchMetadataFileBaseName(metaType, baseName) {
 	}
 	return null;
 }
+let cachedMetadataRoutes = null;
+let cachedMetadataAppDir = null;
+/** Clear the {@link scanMetadataFiles} cache (call when app files change in dev). */
+function invalidateMetadataFileCache() {
+	cachedMetadataRoutes = null;
+	cachedMetadataAppDir = null;
+}
 /**
 * Scan an app directory for metadata files.
 */
 function scanMetadataFiles(appDir) {
+	if (cachedMetadataRoutes && cachedMetadataAppDir === appDir) return cachedMetadataRoutes;
 	const routes = [];
 	function scan(dir, urlPrefix, parentSegments) {
 		if (!fs.existsSync(dir)) return;
@@ -409,7 +417,9 @@ function scanMetadataFiles(appDir) {
 		if (!existing) byUrl.set(route.servedUrl, route);
 		else if (route.isDynamic && !existing.isDynamic) byUrl.set(route.servedUrl, route);
 	}
-	return Array.from(byUrl.values());
+	cachedMetadataRoutes = Array.from(byUrl.values());
+	cachedMetadataAppDir = appDir;
+	return cachedMetadataRoutes;
 }
 function resolveStaticMetadataAltFilePath(dir, baseName) {
 	const altPath = path.join(dir, `${baseName}.alt.txt`);
@@ -430,4 +440,4 @@ function getStaticContentType(ext, fallback) {
 	}[ext] ?? fallback;
 }
 //#endregion
-export { METADATA_FILE_MAP, fillStaticMetadataSegment, getMetadataImageRouteKind, getMetadataRouteKind, isValidMetadataImageId, manifestToJson, matchMetadataFileBaseName, matchMetadataRoutePattern, robotsToText, scanMetadataFiles, sitemapToXml };
+export { METADATA_FILE_MAP, fillStaticMetadataSegment, getMetadataImageRouteKind, getMetadataRouteKind, invalidateMetadataFileCache, isValidMetadataImageId, manifestToJson, matchMetadataFileBaseName, matchMetadataRoutePattern, robotsToText, scanMetadataFiles, sitemapToXml };

package/dist/server/middleware-runtime.js

@@ -2,8 +2,9 @@ import { normalizePathnameForRouteMatchStrict } from "../routing/utils.js";
 import { addBasePathToPathname, hasBasePath, removeTrailingSlash, stripBasePath } from "../utils/base-path.js";
 import "./server-globals.js";
 import { getRequestExecutionContext, runWithExecutionContext } from "../shims/request-context.js";
+import "../utils/protocol-headers.js";
 import { MIDDLEWARE_REWRITE_HEADER } from "./headers.js";
-import { shouldKeepMiddlewareHeader } from "./middleware-request-headers.js";
+import { shouldKeepMiddlewareHeader } from "../utils/middleware-request-headers.js";
 import { NextFetchEvent, NextRequest } from "../shims/server.js";
 import { normalizePath } from "./normalize-path.js";
 import { matchesMiddleware } from "./middleware-matcher.js";
@@ -141,6 +142,10 @@ async function executeMiddleware(options) {
 	const matchPathname = options.basePath ? stripBasePath(normalizedPathname, options.basePath) : normalizedPathname;
 	if (!matchesMiddleware(matchPathname, middlewareMatcher(options.module), options.request, options.i18nConfig)) return { continue: true };
 	const nextRequest = createNextRequest(options.request, normalizedPathname, options.i18nConfig, options.basePath, options.trailingSlash, hadBasePath);
+	if (options.isDataRequest) Object.defineProperty(nextRequest, "__isData", {
+		enumerable: false,
+		value: true
+	});
 	const fetchEvent = new NextFetchEvent({ page: removeTrailingSlash(matchPathname) });
 	let response;
 	try {

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

@@ -103,6 +103,7 @@ type NavigationDecision = {
 type FlightResult = {
   cacheEntryReuseProof?: CacheEntryReuseProof;
   href: string;
+  restoredHistorySnapshot?: boolean;
   targetSnapshot: RouteSnapshot;
 };
 type RscFetchResultSource = "cached" | "live";

package/dist/server/navigation-planner.js

@@ -1,8 +1,8 @@
 import { splitPathnameForRouteMatch } from "../routing/utils.js";
 import { stripBasePath } from "../utils/base-path.js";
-import { matchRoutePattern, matchRoutePatternPrefix, matchRoutePatternWithOptionalDynamicSegments } from "../routing/route-pattern.js";
 import { compareAppElementsSlotIds } from "./app-elements-wire.js";
 import "./app-elements.js";
+import { matchRoutePattern, matchRoutePatternPrefix, matchRoutePatternWithOptionalDynamicSegments } from "../routing/route-pattern.js";
 import { resolveHardNavigationTargetFromRscResponse, resolveRscCompatibilityNavigationDecision } from "./app-rsc-cache-busting.js";
 import { resolveRscRedirectLifecycleHop, resolveStreamedRscRedirectLifecycleHop } from "./app-browser-rsc-redirect.js";
 import { NavigationTraceReasonCodes, createNavigationLifecycleTraceFields, createNavigationTrace } from "./navigation-trace.js";
@@ -291,6 +291,11 @@ function stripInterceptionContextFromRouteId(routeId) {
 	const separatorIndex = routeId.indexOf(ROUTE_INTERCEPTION_CONTEXT_SEPARATOR);
 	return separatorIndex === -1 ? routeId : routeId.slice(0, separatorIndex);
 }
+function matchedUrlFromConcreteRouteId(routeId) {
+	const normalizedRouteId = stripInterceptionContextFromRouteId(routeId);
+	if (!normalizedRouteId.startsWith("route:/")) return null;
+	return normalizedRouteId.slice(6);
+}
 function getMatchedUrlPathname(matchedUrl) {
 	try {
 		return new URL(matchedUrl, "https://vinext.local").pathname;
@@ -315,6 +320,11 @@ function findRouteManifestRouteByIdOrMatchedUrl(options) {
 	const routeId = stripInterceptionContextFromRouteId(options.routeId);
 	const route = options.routeManifest.segmentGraph.routes.get(routeId);
 	if (route && routeManifestRouteMatchesUrl(route, options.matchedUrl)) return route;
+	const concreteRouteMatchedUrl = route === void 0 ? matchedUrlFromConcreteRouteId(options.routeId) : null;
+	if (concreteRouteMatchedUrl !== null) {
+		const concreteRoute = findRouteManifestRouteByMatchedUrl(options.routeManifest, concreteRouteMatchedUrl);
+		if (concreteRoute !== null) return concreteRoute;
+	}
 	return findRouteManifestRouteByMatchedUrl(options.routeManifest, options.matchedUrl);
 }
 function findRouteManifestRouteForSnapshot(routeManifest, snapshot) {
@@ -480,7 +490,7 @@ function getVisibleInterceptionSourceIdentity(snapshot) {
 		routeId: snapshot.interception.sourceRouteId
 	};
 	return {
-		matchedUrl: snapshot.matchedUrl,
+		matchedUrl: matchedUrlFromConcreteRouteId(snapshot.routeId) ?? snapshot.matchedUrl,
 		routeId: snapshot.routeId
 	};
 }
@@ -567,7 +577,7 @@ function validateInterceptedPreservation(options) {
 		reasonCode: NavigationTraceReasonCodes.interceptedRejectedTargetMismatch
 	};
 	const sourceIdentity = getVisibleInterceptionSourceIdentity(options.currentSnapshot);
-	if (proof.sourceMatchedUrl !== sourceIdentity.matchedUrl || proof.sourceRouteId !== sourceIdentity.routeId) return {
+	if (!options.restoredHistorySnapshot && (proof.sourceMatchedUrl !== sourceIdentity.matchedUrl || proof.sourceRouteId !== sourceIdentity.routeId)) return {
 		kind: "rejected",
 		reasonCode: NavigationTraceReasonCodes.interceptedRejectedUnknownSource
 	};
@@ -654,6 +664,7 @@ function planFlightResponseArrived(options) {
 		const validation = validateInterceptedPreservation({
 			currentSnapshot: options.state.visibleSnapshot,
 			currentTopology: currentTopology.topology,
+			restoredHistorySnapshot: options.event.result.restoredHistorySnapshot === true,
 			routeManifest: options.routeManifest,
 			targetSnapshot,
 			targetTopology: targetTopology.topology

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

@@ -4,10 +4,10 @@ import { NextRequest } from "../shims/server.js";
 import { internalServerErrorResponse } from "./http-error-responses.js";
 import { cloneRequestWithUrl } from "./request-pipeline.js";
 import { mergeRouteParamsIntoQuery, parseQueryString, urlQueryToSearchParams } from "../utils/query.js";
-import { PagesBodyParseError } from "./pages-media-type.js";
-import { isEdgeApiRuntime } from "./edge-api-runtime.js";
 import { resolveBodyParserConfig } from "./pages-body-parser-config.js";
+import { PagesBodyParseError } from "./pages-media-type.js";
 import { createPagesReqRes, parsePagesApiBody } from "./pages-node-compat.js";
+import { isEdgeApiRuntime } from "./edge-api-runtime.js";
 //#region src/server/pages-api-route.ts
 function resolveModuleRuntime(module) {
 	return module.runtime ?? module.config?.runtime;

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

@@ -10,9 +10,8 @@
  * 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.
+ * Resolve the effective SSR manifest: prefer the caller-supplied object and
+ * fall back to the registered client build metadata.
  */
 declare function resolveSsrManifest(manifest: Record<string, string[]> | null | undefined): Record<string, string[]> | null;
 /**
@@ -34,7 +33,7 @@ declare function resolveClientModuleUrl(manifest: Record<string, string[]> | nul
 type CollectAssetTagsOptions = {
   /**
    * SSR manifest mapping module file paths to their associated asset list.
-   * When empty/null the Worker-embedded `__VINEXT_SSR_MANIFEST__` is used.
+   * When empty/null the registered client build manifest is used.
    */
   manifest: Record<string, string[]> | null | undefined;
   /**
@@ -66,8 +65,7 @@ type CollectAssetTagsOptions = {
  * - 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.
+ * - The registered client-entry bootstrap is injected first.
  * - Shared framework / vinext runtime chunks are always included alongside
  *   page-specific chunks.
  *

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

@@ -1,6 +1,7 @@
 import { appendDeploymentIdQuery } from "../utils/deployment-id.js";
 import { createNonceAttribute } from "./html.js";
 import { assetServingUrlFromBaseAnchored } from "../utils/manifest-paths.js";
+import { getPagesClientAssets } from "./pages-client-assets.js";
 //#region src/server/pages-asset-tags.ts
 /**
 * Pages Router SSR asset-tag helpers.
@@ -13,13 +14,12 @@ import { assetServingUrlFromBaseAnchored } from "../utils/manifest-paths.js";
 * 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.
+* Resolve the effective SSR manifest: prefer the caller-supplied object and
+* fall back to the registered client build metadata.
 */
 function resolveSsrManifest(manifest) {
 	if (manifest && Object.keys(manifest).length > 0) return manifest;
-	return (typeof globalThis !== "undefined" ? globalThis.__VINEXT_SSR_MANIFEST__ : null) ?? null;
+	return getPagesClientAssets().ssrManifest ?? null;
 }
 /**
 * Look up the asset-file list for a module ID in the SSR manifest.
@@ -58,8 +58,7 @@ function resolveClientModuleUrl(manifest, moduleId, basePath = "", assetPrefix =
 * - 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.
+* - The registered client-entry bootstrap is injected first.
 * - Shared framework / vinext runtime chunks are always included alongside
 *   page-specific chunks.
 *
@@ -77,13 +76,14 @@ function collectAssetTags(options) {
 		const url = assetServingUrlFromBaseAnchored(value, basePath, assetPrefix);
 		return value.endsWith(".js") ? url : appendDeploymentIdQuery(url, options.deploymentId);
 	};
-	const lazyChunks = typeof globalThis !== "undefined" && globalThis.__VINEXT_LAZY_CHUNKS__ || null;
+	const runtimeAssets = getPagesClientAssets();
+	const lazyChunks = runtimeAssets.lazyChunks ?? 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=\"" + href(entry) + "\" />");
-		tags.push("<script type=\"module\"" + deferAttr + nonceAttr + " src=\"" + href(entry) + "\" crossorigin><\/script>");
+	const clientEntry = runtimeAssets.clientEntry;
+	if (clientEntry) {
+		seen.add(clientEntry);
+		tags.push("<link rel=\"modulepreload\"" + nonceAttr + " href=\"" + href(clientEntry) + "\" />");
+		tags.push("<script type=\"module\"" + deferAttr + nonceAttr + " src=\"" + href(clientEntry) + "\" crossorigin><\/script>");
 	}
 	if (m) {
 		const allFiles = [];

package/dist/server/pages-client-assets.d.ts

@@ -0,0 +1,12 @@
+//#region src/server/pages-client-assets.d.ts
+type PagesClientAssets = {
+  clientEntry?: string;
+  appBootstrapPreinitModules?: string[];
+  ssrManifest?: Record<string, string[]>;
+  lazyChunks?: string[];
+  dynamicPreloads?: Record<string, string[]>;
+};
+declare function setPagesClientAssets(assets: PagesClientAssets | undefined): void;
+declare function getPagesClientAssets(): PagesClientAssets;
+//#endregion
+export { PagesClientAssets, getPagesClientAssets, setPagesClientAssets };

package/dist/server/pages-client-assets.js

@@ -0,0 +1,10 @@
+//#region src/server/pages-client-assets.ts
+let pagesClientAssets = {};
+function setPagesClientAssets(assets) {
+	pagesClientAssets = assets ?? {};
+}
+function getPagesClientAssets() {
+	return pagesClientAssets;
+}
+//#endregion
+export { getPagesClientAssets, setPagesClientAssets };

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

@@ -51,6 +51,7 @@ declare function isNextDataPathname(pathname: string): boolean;
  * `/_next/data/<buildId>/about`              → null  (missing .json suffix)
  */
 declare function parseNextDataPathname(pathname: string, buildId: string): NextDataMatch | null;
+declare function normalizeNextDataPagePathname(pagePathname: string, trailingSlash?: boolean): string;
 /**
  * Build the JSON envelope returned by `/_next/data/<buildId>/<page>.json`.
  * Mirrors Next.js' `RenderResult(JSON.stringify(props))` path in
@@ -79,6 +80,7 @@ declare function buildNextDataPropsJsonResponse(props: Record<string, unknown>,
  * before checking the status code.
  */
 declare function buildNextDataNotFoundResponse(): Response;
+declare function buildMiddlewarePrefetchSkipResponse(matchedPathname: string): Response;
 type NormalizePagesDataRequestResult = {
   isDataReq: false;
   request: Request;
@@ -116,6 +118,6 @@ type NormalizePagesDataRequestResult = {
  * Extracted from `entries/pages-server-entry.ts` so both `renderPage` and
  * `runMiddleware` share a single implementation.
  */
-declare function normalizePagesDataRequest(request: Request, buildId: string | null, basePath?: string): NormalizePagesDataRequestResult;
+declare function normalizePagesDataRequest(request: Request, buildId: string | null, basePath?: string, trailingSlash?: boolean): NormalizePagesDataRequestResult;
 //#endregion
-export { buildNextDataJsonResponse, buildNextDataNotFoundResponse, buildNextDataPropsJsonResponse, isNextDataPathname, normalizePagesDataRequest, parseNextDataPathname };
+export { buildMiddlewarePrefetchSkipResponse, buildNextDataJsonResponse, buildNextDataNotFoundResponse, buildNextDataPropsJsonResponse, isNextDataPathname, normalizeNextDataPagePathname, normalizePagesDataRequest, parseNextDataPathname };

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

@@ -1,4 +1,5 @@
 import { addBasePathToPathname, hasBasePath, stripBasePath } from "../utils/base-path.js";
+import { MIDDLEWARE_SKIP_HEADER } from "../utils/protocol-headers.js";
 import { NEXTJS_DEPLOYMENT_ID_HEADER } from "./headers.js";
 //#region src/server/pages-data-route.ts
 /**
@@ -58,6 +59,10 @@ function parseNextDataPathname(pathname, buildId) {
 	if (rest.startsWith("index/")) return { pagePathname: `/${rest.slice(6)}` };
 	return { pagePathname: `/${rest}` };
 }
+function normalizeNextDataPagePathname(pagePathname, trailingSlash = false) {
+	if (!trailingSlash || pagePathname === "/" || pagePathname.endsWith("/")) return pagePathname;
+	return `${pagePathname}/`;
+}
 /**
 * Build the JSON envelope returned by `/_next/data/<buildId>/<page>.json`.
 * Mirrors Next.js' `RenderResult(JSON.stringify(props))` path in
@@ -106,6 +111,14 @@ function buildNextDataNotFoundResponse() {
 		headers
 	});
 }
+function buildMiddlewarePrefetchSkipResponse(matchedPathname) {
+	return new Response("{}", { headers: {
+		"Content-Type": "application/json",
+		"x-matched-path": matchedPathname,
+		[MIDDLEWARE_SKIP_HEADER]: "1",
+		"Cache-Control": "private, no-cache, no-store, max-age=0, must-revalidate"
+	} });
+}
 /**
 * 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
@@ -124,7 +137,7 @@ function buildNextDataNotFoundResponse() {
 * Extracted from `entries/pages-server-entry.ts` so both `renderPage` and
 * `runMiddleware` share a single implementation.
 */
-function normalizePagesDataRequest(request, buildId, basePath = "") {
+function normalizePagesDataRequest(request, buildId, basePath = "", trailingSlash = false) {
 	const reqUrl = new URL(request.url);
 	const hadBasePath = !!basePath && hasBasePath(reqUrl.pathname, basePath);
 	const dataPathname = basePath ? stripBasePath(reqUrl.pathname, basePath) : reqUrl.pathname;
@@ -143,15 +156,16 @@ function normalizePagesDataRequest(request, buildId, basePath = "") {
 		search: "",
 		notFoundResponse: buildNextDataNotFoundResponse()
 	};
+	const pagePathname = normalizeNextDataPagePathname(dataMatch.pagePathname, trailingSlash);
 	const normalizedUrl = new URL(reqUrl);
-	normalizedUrl.pathname = hadBasePath ? addBasePathToPathname(dataMatch.pagePathname, basePath) : dataMatch.pagePathname;
+	normalizedUrl.pathname = hadBasePath ? addBasePathToPathname(pagePathname, basePath) : pagePathname;
 	return {
 		isDataReq: true,
 		request: new Request(normalizedUrl, request),
-		normalizedPathname: dataMatch.pagePathname,
+		normalizedPathname: pagePathname,
 		search: reqUrl.search,
 		notFoundResponse: null
 	};
 }
 //#endregion
-export { buildNextDataJsonResponse, buildNextDataNotFoundResponse, buildNextDataPropsJsonResponse, isNextDataPathname, normalizePagesDataRequest, parseNextDataPathname };
+export { buildMiddlewarePrefetchSkipResponse, buildNextDataJsonResponse, buildNextDataNotFoundResponse, buildNextDataPropsJsonResponse, isNextDataPathname, normalizeNextDataPagePathname, normalizePagesDataRequest, parseNextDataPathname };

package/dist/server/pages-dev-module-url.d.ts

@@ -1,4 +1,5 @@
 //#region src/server/pages-dev-module-url.d.ts
+declare function createPagesDevAssetUrl(assetPath: string): string;
 declare function createPagesDevModuleUrl(viteRoot: string, moduleFilePath: string, viteBase: string): string;
 //#endregion
-export { createPagesDevModuleUrl };
+export { createPagesDevAssetUrl, createPagesDevModuleUrl };

package/dist/server/pages-dev-module-url.js

@@ -4,12 +4,15 @@ function normalizeBase(base) {
 	if (!base || base === "/") return "/";
 	return `/${base.replace(/^\/+|\/+$/g, "")}/`;
 }
-function encodeModulePath(modulePath) {
+function encodePagesDevModulePath(modulePath) {
 	return encodeURI(modulePath).replace(/%5B/gi, "[").replace(/%5D/gi, "]").replace(/\?/g, "%3F").replace(/#/g, "%23");
 }
+function createPagesDevAssetUrl(assetPath) {
+	return "/" + encodePagesDevModulePath(assetPath.replace(/^\/+/, ""));
+}
 function createPagesDevModuleUrl(viteRoot, moduleFilePath, viteBase) {
 	const relativePath = (/^[A-Za-z]:[\\/]/.test(viteRoot) ? path.win32 : path).relative(viteRoot, moduleFilePath).replace(/\\/g, "/");
-	return normalizeBase(viteBase) + encodeModulePath(relativePath);
+	return normalizeBase(viteBase) + encodePagesDevModulePath(relativePath);
 }
 //#endregion
-export { createPagesDevModuleUrl };
+export { createPagesDevAssetUrl, createPagesDevModuleUrl };

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

@@ -27,6 +27,16 @@ type PagesReqResResponse = Writable & {
   redirect: (statusOrUrl: number | string, url?: string) => void;
   getHeaders: () => PagesReqResHeaders;
   revalidate: (urlPath: string, opts?: RevalidateOptions) => Promise<void>;
+  setPreviewData: (data: object | string, options?: {
+    maxAge?: number;
+    path?: string;
+  }) => PagesReqResResponse;
+};
+type PagesRequestCookiesCarrier = {
+  headers: {
+    cookie?: string | string[] | null | undefined;
+  };
+  cookies?: unknown;
 };
 type CreatePagesReqResOptions = {
   body: unknown;
@@ -39,6 +49,7 @@ type CreatePagesReqResResult = {
   res: PagesReqResResponse;
   responsePromise: Promise<Response>;
 };
+type PagesPreviewData = object | string;
 /**
  * Read and parse a Pages Router API request body for the Workers/prod path.
  *
@@ -50,6 +61,13 @@ type CreatePagesReqResResult = {
  * @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 getPagesPreviewDataFromCookieHeader(cookieHeader: string | string[] | null | undefined, options?: {
+  isOnDemandRevalidate?: boolean;
+}): PagesPreviewData | false;
+declare function getPagesPreviewData(request: Request, options?: {
+  isOnDemandRevalidate?: boolean;
+}): PagesPreviewData | false;
+declare function attachPagesRequestCookies(req: PagesRequestCookiesCarrier): void;
 declare function createPagesReqRes(options: CreatePagesReqResOptions): CreatePagesReqResResult;
 //#endregion
-export { PagesBodyParseError as PagesApiBodyParseError, PagesReqResRequest, PagesReqResResponse, PagesRequestQuery, createPagesReqRes, parsePagesApiBody };
+export { PagesBodyParseError as PagesApiBodyParseError, PagesPreviewData, PagesReqResRequest, PagesReqResResponse, PagesRequestQuery, attachPagesRequestCookies, createPagesReqRes, getPagesPreviewData, getPagesPreviewDataFromCookieHeader, parsePagesApiBody };