vinext 0.1.8 → 0.2.0

package/dist/server/fetch-handler.js

@@ -0,0 +1,18 @@
+import handler from "virtual:vinext-worker-entry";
+//#region src/server/fetch-handler.ts
+/**
+* Default Cloudflare fetch handler for vinext.
+*
+* Use this directly in wrangler.jsonc:
+*   "main": "vinext/server/fetch-handler"
+*
+* Or import and delegate to it from a custom worker:
+*   import handler from "vinext/server/fetch-handler";
+*   return handler.fetch(request, env, ctx);
+*
+* The vinext plugin resolves this to the App Router or Pages Router handler
+* for the current project at build time.
+*/
+var fetch_handler_default = handler;
+//#endregion
+export { fetch_handler_default as default };

package/dist/server/headers.d.ts

@@ -1,3 +1,5 @@
+import { MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_SET_COOKIE_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER } from "../utils/protocol-headers.js";
+
 //#region src/server/headers.d.ts
 /**
  * Internal HTTP header name constants used throughout vinext.
@@ -15,14 +17,8 @@ declare const VINEXT_CACHE_HEADER = "X-Vinext-Cache";
 declare const NEXTJS_CACHE_HEADER = "x-nextjs-cache";
 /** Static file signal — value is URL-encoded pathname. */
 declare const VINEXT_STATIC_FILE_HEADER = "x-vinext-static-file";
-/** Serialized middleware context (JSON) forwarded from dev server to RSC entry. */
-declare const VINEXT_MW_CTX_HEADER = "x-vinext-mw-ctx";
 /** Timing metrics: `handlerStart,compileMs,renderMs`. */
 declare const VINEXT_TIMING_HEADER = "x-vinext-timing";
-/** Build-time prerender authentication secret. */
-declare const VINEXT_PRERENDER_SECRET_HEADER = "x-vinext-prerender-secret";
-/** URL-encoded JSON route params for build-time prerender renders. */
-declare const VINEXT_PRERENDER_ROUTE_PARAMS_HEADER = "x-vinext-prerender-route-params";
 /** Internal endpoint used to evaluate App Router generateStaticParams exports. */
 declare const VINEXT_PRERENDER_STATIC_PARAMS_PATH = "/__vinext/prerender/static-params";
 /** Internal endpoint used to evaluate Pages Router getStaticPaths exports. */
@@ -81,18 +77,10 @@ declare const ACTION_REDIRECT_HEADER = "x-action-redirect";
 declare const ACTION_REDIRECT_TYPE_HEADER = "x-action-redirect-type";
 /** HTTP status for a Server Action redirect (e.g. "308"). */
 declare const ACTION_REDIRECT_STATUS_HEADER = "x-action-redirect-status";
-/** Prefix for forwarded request headers (e.g. `x-middleware-request-cookie`). */
-declare const MIDDLEWARE_REQUEST_HEADER_PREFIX = "x-middleware-request-";
-/** Comma-separated list of header names that middleware wants to override. */
-declare const MIDDLEWARE_OVERRIDE_HEADERS = "x-middleware-override-headers";
-/** Carries cookies set by middleware for same-render reads. */
-declare const MIDDLEWARE_SET_COOKIE_HEADER = "x-middleware-set-cookie";
 /** Signal from `NextResponse.next()` — value "1" means "continue to next handler". */
 declare const MIDDLEWARE_NEXT_HEADER = "x-middleware-next";
 /** Rewrite destination URL set by `NextResponse.rewrite()`. */
 declare const MIDDLEWARE_REWRITE_HEADER = "x-middleware-rewrite";
-/** Generic prefix for all middleware internal headers. */
-declare const MIDDLEWARE_HEADER_PREFIX = "x-middleware-";
 declare const NEXT_ROUTER_STATE_TREE_HEADER = "Next-Router-State-Tree";
 declare const NEXT_ROUTER_PREFETCH_HEADER = "Next-Router-Prefetch";
 declare const NEXT_ROUTER_SEGMENT_PREFETCH_HEADER = "Next-Router-Segment-Prefetch";
@@ -113,4 +101,4 @@ declare const INTERNAL_HEADERS: string[];
 /** Vinext-only internal headers stripped alongside Next.js protocol internals. */
 declare const VINEXT_INTERNAL_HEADERS: string[];
 //#endregion
-export { ACTION_FORWARDED_HEADER, ACTION_REDIRECT_HEADER, ACTION_REDIRECT_STATUS_HEADER, ACTION_REDIRECT_TYPE_HEADER, ACTION_REVALIDATED_HEADER, FLIGHT_HEADERS, INTERNAL_HEADERS, MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_NEXT_HEADER, MIDDLEWARE_OVERRIDE_HEADERS, MIDDLEWARE_REQUEST_HEADER_PREFIX, MIDDLEWARE_REWRITE_HEADER, MIDDLEWARE_SET_COOKIE_HEADER, NEXTJS_ACTION_NOT_FOUND_HEADER, NEXTJS_CACHE_HEADER, NEXTJS_DEPLOYMENT_ID_HEADER, NEXT_ACTION_HEADER, NEXT_HTML_REQUEST_ID_HEADER, NEXT_REQUEST_ID_HEADER, NEXT_ROUTER_PREFETCH_HEADER, NEXT_ROUTER_SEGMENT_PREFETCH_HEADER, NEXT_ROUTER_STATE_TREE_HEADER, NEXT_URL_HEADER, RSC_ACTION_HEADER, RSC_HEADER, VINEXT_CACHE_HEADER, VINEXT_CLIENT_REUSE_MANIFEST_HEADER, VINEXT_DYNAMIC_STALE_TIME_HEADER, VINEXT_INTERCEPTION_CONTEXT_HEADER, VINEXT_INTERNAL_HEADERS, VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PARAMS_HEADER, VINEXT_PRERENDER_PAGES_STATIC_PATHS_PATH, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_STATIC_PARAMS_PATH, VINEXT_REVALIDATE_HEADER, VINEXT_RSC_MARKER_HEADER, VINEXT_RSC_REDIRECT_HEADER, VINEXT_RSC_RENDER_MODE_HEADER, VINEXT_STATIC_FILE_HEADER, VINEXT_TIMING_HEADER };
+export { ACTION_FORWARDED_HEADER, ACTION_REDIRECT_HEADER, ACTION_REDIRECT_STATUS_HEADER, ACTION_REDIRECT_TYPE_HEADER, ACTION_REVALIDATED_HEADER, FLIGHT_HEADERS, INTERNAL_HEADERS, MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_NEXT_HEADER, MIDDLEWARE_REWRITE_HEADER, MIDDLEWARE_SET_COOKIE_HEADER, NEXTJS_ACTION_NOT_FOUND_HEADER, NEXTJS_CACHE_HEADER, NEXTJS_DEPLOYMENT_ID_HEADER, NEXT_ACTION_HEADER, NEXT_HTML_REQUEST_ID_HEADER, NEXT_REQUEST_ID_HEADER, NEXT_ROUTER_PREFETCH_HEADER, NEXT_ROUTER_SEGMENT_PREFETCH_HEADER, NEXT_ROUTER_STATE_TREE_HEADER, NEXT_URL_HEADER, RSC_ACTION_HEADER, RSC_HEADER, VINEXT_CACHE_HEADER, VINEXT_CLIENT_REUSE_MANIFEST_HEADER, VINEXT_DYNAMIC_STALE_TIME_HEADER, VINEXT_INTERCEPTION_CONTEXT_HEADER, VINEXT_INTERNAL_HEADERS, VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PARAMS_HEADER, VINEXT_PRERENDER_PAGES_STATIC_PATHS_PATH, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_STATIC_PARAMS_PATH, VINEXT_REVALIDATE_HEADER, VINEXT_RSC_MARKER_HEADER, VINEXT_RSC_REDIRECT_HEADER, VINEXT_RSC_RENDER_MODE_HEADER, VINEXT_STATIC_FILE_HEADER, VINEXT_TIMING_HEADER };

package/dist/server/headers.js

@@ -1,3 +1,4 @@
+import { MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_OVERRIDE_HEADERS, MIDDLEWARE_SET_COOKIE_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER } from "../utils/protocol-headers.js";
 //#region src/server/headers.ts
 /**
 * Internal HTTP header name constants used throughout vinext.
@@ -15,14 +16,8 @@ const VINEXT_CACHE_HEADER = "X-Vinext-Cache";
 const NEXTJS_CACHE_HEADER = "x-nextjs-cache";
 /** Static file signal — value is URL-encoded pathname. */
 const VINEXT_STATIC_FILE_HEADER = "x-vinext-static-file";
-/** Serialized middleware context (JSON) forwarded from dev server to RSC entry. */
-const VINEXT_MW_CTX_HEADER = "x-vinext-mw-ctx";
 /** Timing metrics: `handlerStart,compileMs,renderMs`. */
 const VINEXT_TIMING_HEADER = "x-vinext-timing";
-/** Build-time prerender authentication secret. */
-const VINEXT_PRERENDER_SECRET_HEADER = "x-vinext-prerender-secret";
-/** URL-encoded JSON route params for build-time prerender renders. */
-const VINEXT_PRERENDER_ROUTE_PARAMS_HEADER = "x-vinext-prerender-route-params";
 /** Internal endpoint used to evaluate App Router generateStaticParams exports. */
 const VINEXT_PRERENDER_STATIC_PARAMS_PATH = "/__vinext/prerender/static-params";
 /** Internal endpoint used to evaluate Pages Router getStaticPaths exports. */
@@ -81,12 +76,6 @@ const ACTION_REDIRECT_HEADER = "x-action-redirect";
 const ACTION_REDIRECT_TYPE_HEADER = "x-action-redirect-type";
 /** HTTP status for a Server Action redirect (e.g. "308"). */
 const ACTION_REDIRECT_STATUS_HEADER = "x-action-redirect-status";
-/** Prefix for forwarded request headers (e.g. `x-middleware-request-cookie`). */
-const MIDDLEWARE_REQUEST_HEADER_PREFIX = "x-middleware-request-";
-/** Comma-separated list of header names that middleware wants to override. */
-const MIDDLEWARE_OVERRIDE_HEADERS = "x-middleware-override-headers";
-/** Carries cookies set by middleware for same-render reads. */
-const MIDDLEWARE_SET_COOKIE_HEADER = "x-middleware-set-cookie";
 /** Signal from `NextResponse.next()` — value "1" means "continue to next handler". */
 const MIDDLEWARE_NEXT_HEADER = "x-middleware-next";
 /** Rewrite destination URL set by `NextResponse.rewrite()`. */
@@ -95,8 +84,6 @@ const MIDDLEWARE_REWRITE_HEADER = "x-middleware-rewrite";
 const MIDDLEWARE_REDIRECT_HEADER = "x-middleware-redirect";
 /** Skip-middleware signal. */
 const MIDDLEWARE_SKIP_HEADER = "x-middleware-skip";
-/** Generic prefix for all middleware internal headers. */
-const MIDDLEWARE_HEADER_PREFIX = "x-middleware-";
 const NEXT_ROUTER_STATE_TREE_HEADER = "Next-Router-State-Tree";
 const NEXT_ROUTER_PREFETCH_HEADER = "Next-Router-Prefetch";
 const NEXT_ROUTER_SEGMENT_PREFETCH_HEADER = "Next-Router-Segment-Prefetch";
@@ -135,4 +122,4 @@ const INTERNAL_HEADERS = [
 /** Vinext-only internal headers stripped alongside Next.js protocol internals. */
 const VINEXT_INTERNAL_HEADERS = [VINEXT_PRERENDER_ROUTE_PARAMS_HEADER];
 //#endregion
-export { ACTION_FORWARDED_HEADER, ACTION_REDIRECT_HEADER, ACTION_REDIRECT_STATUS_HEADER, ACTION_REDIRECT_TYPE_HEADER, ACTION_REVALIDATED_HEADER, FLIGHT_HEADERS, INTERNAL_HEADERS, MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_NEXT_HEADER, MIDDLEWARE_OVERRIDE_HEADERS, MIDDLEWARE_REQUEST_HEADER_PREFIX, MIDDLEWARE_REWRITE_HEADER, MIDDLEWARE_SET_COOKIE_HEADER, NEXTJS_ACTION_NOT_FOUND_HEADER, NEXTJS_CACHE_HEADER, NEXTJS_DEPLOYMENT_ID_HEADER, NEXT_ACTION_HEADER, NEXT_HTML_REQUEST_ID_HEADER, NEXT_REQUEST_ID_HEADER, NEXT_ROUTER_PREFETCH_HEADER, NEXT_ROUTER_SEGMENT_PREFETCH_HEADER, NEXT_ROUTER_STATE_TREE_HEADER, NEXT_URL_HEADER, RSC_ACTION_HEADER, RSC_HEADER, VINEXT_CACHE_HEADER, VINEXT_CLIENT_REUSE_MANIFEST_HEADER, VINEXT_DYNAMIC_STALE_TIME_HEADER, VINEXT_INTERCEPTION_CONTEXT_HEADER, VINEXT_INTERNAL_HEADERS, VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PARAMS_HEADER, VINEXT_PRERENDER_PAGES_STATIC_PATHS_PATH, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_STATIC_PARAMS_PATH, VINEXT_REVALIDATE_HEADER, VINEXT_RSC_MARKER_HEADER, VINEXT_RSC_REDIRECT_HEADER, VINEXT_RSC_RENDER_MODE_HEADER, VINEXT_STATIC_FILE_HEADER, VINEXT_TIMING_HEADER };
+export { ACTION_FORWARDED_HEADER, ACTION_REDIRECT_HEADER, ACTION_REDIRECT_STATUS_HEADER, ACTION_REDIRECT_TYPE_HEADER, ACTION_REVALIDATED_HEADER, FLIGHT_HEADERS, INTERNAL_HEADERS, MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_NEXT_HEADER, MIDDLEWARE_REWRITE_HEADER, MIDDLEWARE_SET_COOKIE_HEADER, NEXTJS_ACTION_NOT_FOUND_HEADER, NEXTJS_CACHE_HEADER, NEXTJS_DEPLOYMENT_ID_HEADER, NEXT_ACTION_HEADER, NEXT_HTML_REQUEST_ID_HEADER, NEXT_REQUEST_ID_HEADER, NEXT_ROUTER_PREFETCH_HEADER, NEXT_ROUTER_SEGMENT_PREFETCH_HEADER, NEXT_ROUTER_STATE_TREE_HEADER, NEXT_URL_HEADER, RSC_ACTION_HEADER, RSC_HEADER, VINEXT_CACHE_HEADER, VINEXT_CLIENT_REUSE_MANIFEST_HEADER, VINEXT_DYNAMIC_STALE_TIME_HEADER, VINEXT_INTERCEPTION_CONTEXT_HEADER, VINEXT_INTERNAL_HEADERS, VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PARAMS_HEADER, VINEXT_PRERENDER_PAGES_STATIC_PATHS_PATH, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_STATIC_PARAMS_PATH, VINEXT_REVALIDATE_HEADER, VINEXT_RSC_MARKER_HEADER, VINEXT_RSC_REDIRECT_HEADER, VINEXT_RSC_RENDER_MODE_HEADER, VINEXT_STATIC_FILE_HEADER, VINEXT_TIMING_HEADER };

package/dist/server/image-optimization.d.ts

@@ -121,5 +121,55 @@ type ImageHandlers = {
  * cache headers.
  */
 declare function handleImageOptimization(request: Request, handlers: ImageHandlers, allowedWidths?: number[], imageConfig?: ImageConfig): Promise<Response>;
+/**
+ * A server-side image optimizer: the transform backend that resizes/transcodes
+ * a source image. Produced by an adapter factory (e.g. `imagesOptimizer()` from
+ * `@vinext/cloudflare/images/images-optimizer`) and registered via
+ * {@link setImageOptimizer}.
+ */
+type ImageOptimizer = {
+  /** Transform the source image (resize, format, quality). */transformImage: (body: ReadableStream, options: {
+    width: number;
+    format: string;
+    quality: number;
+  }) => Promise<Response>;
+};
+/**
+ * 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.
+ */
+declare function setImageOptimizer(optimizer: ImageOptimizer | null): void;
+/** Get the active image optimizer, or `null` when none is configured. */
+declare function getImageOptimizer(): ImageOptimizer | 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.
+ */
+declare function handleConfiguredImageOptimization(request: Request, fetchAsset: (path: string, request: Request) => Promise<Response>, allowedWidths?: number[], imageConfig?: ImageConfig): Promise<Response>;
 //#endregion
-export { DEFAULT_DEVICE_SIZES, DEFAULT_IMAGE_SIZES, IMAGE_CACHE_CONTROL, IMAGE_CONTENT_SECURITY_POLICY, IMAGE_OPTIMIZATION_PATH, ImageConfig, ImageHandlers, ParseImageParamsOptions, 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, ImageConfig, ImageHandlers, ImageOptimizer, ParseImageParamsOptions, VINEXT_IMAGE_OPTIMIZATION_PATH, getImageOptimizer, handleConfiguredImageOptimization, handleImageOptimization, isImageOptimizationPath, isSafeImageContentType, negotiateImageFormat, parseImageParams, resolveDevImageRedirect, setImageOptimizer };

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

@@ -95,7 +95,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).

package/dist/server/isr-cache.js

@@ -188,12 +188,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
 	};

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-node-compat.d.ts

@@ -28,6 +28,12 @@ type PagesReqResResponse = Writable & {
   getHeaders: () => PagesReqResHeaders;
   revalidate: (urlPath: string, opts?: RevalidateOptions) => Promise<void>;
 };
+type PagesRequestCookiesCarrier = {
+  headers: {
+    cookie?: string | string[] | null | undefined;
+  };
+  cookies?: unknown;
+};
 type CreatePagesReqResOptions = {
   body: unknown;
   query: PagesRequestQuery;
@@ -50,6 +56,7 @@ 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 attachPagesRequestCookies(req: PagesRequestCookiesCarrier): void;
 declare function createPagesReqRes(options: CreatePagesReqResOptions): CreatePagesReqResResult;
 //#endregion
-export { PagesBodyParseError as PagesApiBodyParseError, PagesReqResRequest, PagesReqResResponse, PagesRequestQuery, createPagesReqRes, parsePagesApiBody };
+export { PagesBodyParseError as PagesApiBodyParseError, PagesReqResRequest, PagesReqResResponse, PagesRequestQuery, attachPagesRequestCookies, createPagesReqRes, parsePagesApiBody };

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

@@ -1,7 +1,7 @@
 import { parseCookieHeader } from "../utils/parse-cookie.js";
 import { readStreamAsTextWithLimit } from "../utils/text-stream.js";
-import { PagesBodyParseError, getMediaType, isJsonMediaType } from "./pages-media-type.js";
 import { DEFAULT_PAGES_API_BODY_SIZE_LIMIT } from "./pages-body-parser-config.js";
+import { PagesBodyParseError, getMediaType, isJsonMediaType } from "./pages-media-type.js";
 import { performOnDemandRevalidate } from "./pages-revalidate.js";
 import { decode } from "node:querystring";
 import { Readable, Writable } from "node:stream";
@@ -61,6 +61,34 @@ async function* requestBodyChunks(request) {
 function createRequestReadable(request) {
 	return Readable.from(requestBodyChunks(request), { objectMode: false });
 }
+function parsePagesRequestCookies(cookieHeader) {
+	return parseCookieHeader(Array.isArray(cookieHeader) ? cookieHeader.join("; ") : cookieHeader);
+}
+function attachPagesRequestCookies(req) {
+	if (Object.hasOwn(req, "cookies")) return;
+	Object.defineProperty(req, "cookies", {
+		configurable: true,
+		enumerable: true,
+		get() {
+			const cookies = parsePagesRequestCookies(req.headers.cookie);
+			Object.defineProperty(req, "cookies", {
+				configurable: true,
+				enumerable: true,
+				value: cookies,
+				writable: true
+			});
+			return cookies;
+		},
+		set(value) {
+			Object.defineProperty(req, "cookies", {
+				configurable: true,
+				enumerable: true,
+				value,
+				writable: true
+			});
+		}
+	});
+}
 var PagesResponseStream = class extends Writable {
 	resolveResponse;
 	rejectResponse;
@@ -216,9 +244,9 @@ function createPagesReqRes(options) {
 		url: options.url,
 		headers: headersObj,
 		query: options.query,
-		body: options.body,
-		cookies: parseCookieHeader(options.request.headers.get("cookie"))
+		body: options.body
 	});
+	attachPagesRequestCookies(req);
 	let resolveResponse;
 	let rejectResponse;
 	const responsePromise = new Promise((resolve, reject) => {
@@ -232,4 +260,4 @@ function createPagesReqRes(options) {
 	};
 }
 //#endregion
-export { PagesBodyParseError as PagesApiBodyParseError, createPagesReqRes, parsePagesApiBody };
+export { PagesBodyParseError as PagesApiBodyParseError, attachPagesRequestCookies, createPagesReqRes, parsePagesApiBody };