@qzsy/vinext 0.1.12 → 0.1.81

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

@@ -14,12 +14,18 @@ import { resolvePagesI18nRequest } from "./pages-i18n.js";
 import { buildDefaultPagesNotFoundResponse } from "./pages-default-404.js";
 import { buildPagesReadinessNextData } from "./pages-readiness.js";
 import { resolvePagesPageMethodResponse } from "./pages-page-method.js";
+import { renderPagesPageResponse } from "./pages-page-response.js";
+import { hasPagesGetInitialProps } from "./pages-get-initial-props.js";
 import { buildNextDataNotFoundResponse, buildNextDataPropsJsonResponse, normalizePagesDataRequest, parseNextDataPathname } from "./pages-data-route.js";
+import { resolvePagesPageData } from "./pages-page-data.js";
 import { createPagesReqRes } from "./pages-node-compat.js";
 import { collectAssetTags, resolveClientModuleUrl } from "./pages-asset-tags.js";
-import { renderPagesPageResponse } from "./pages-page-response.js";
-import { resolvePagesPageData } from "./pages-page-data.js";
 //#region src/server/pages-page-handler.ts
+function shouldEmitPagesClientTraceMetadata(pageModule, appComponent) {
+	if (typeof pageModule.getServerSideProps === "function") return true;
+	if (typeof pageModule.getStaticProps === "function") return false;
+	return hasPagesGetInitialProps(pageModule.default) || hasPagesGetInitialProps(appComponent);
+}
 function buildI18nRenderContext(i18nConfig, locale, currentDefaultLocale, domainLocales) {
 	return {
 		locale,
@@ -334,7 +340,7 @@ function createPagesPageHandler(opts) {
 					getFontLinks,
 					getFontStyles,
 					getSSRHeadHTML: typeof getSSRHeadHTML === "function" ? getSSRHeadHTML : void 0,
-					clientTraceMetadata: vinextConfig.clientTraceMetadata,
+					clientTraceMetadata: shouldEmitPagesClientTraceMetadata(pageModule, AppComponent) ? vinextConfig.clientTraceMetadata : void 0,
 					gsspRes,
 					isrCacheKey: pageIsrCacheKey,
 					expireSeconds: vinextConfig.expireTime,
@@ -400,4 +406,4 @@ function createPagesPageHandler(opts) {
 	return renderPage;
 }
 //#endregion
-export { createPagesPageHandler };
+export { createPagesPageHandler, shouldEmitPagesClientTraceMetadata };

package/dist/server/pages-request-pipeline.d.ts

@@ -34,11 +34,13 @@ type PagesPipelineDeps = {
   hadBasePath: boolean;
   isDataReq: boolean;
   isDataRequest: boolean;
+  hasMiddleware: boolean;
   ctx?: unknown;
   rawSearch?: string;
   matchPageRoute?: ((pathname: string, request: Request) => {
     route: {
       isDynamic: boolean;
+      pattern?: string;
     };
   } | null) | null;
   runMiddleware?: ((request: Request, ctx: unknown, opts: {

package/dist/server/pages-request-pipeline.js

@@ -1,4 +1,5 @@
 import { addBasePathToPathname, hasBasePath } from "../utils/base-path.js";
+import { patternToNextFormat } from "../routing/route-validation.js";
 import { applyMiddlewareRequestHeaders, isExternalUrl, matchRedirect, matchRewrite, preserveRedirectDestinationQuery, proxyExternalRequest, requestContextFromRequest, sanitizeDestination } from "../config/config-matchers.js";
 import { applyConfigHeadersToHeaderRecord, cloneRequestWithUrl, normalizeTrailingSlash } from "./request-pipeline.js";
 import { mergeRewriteQuery } from "../utils/query.js";
@@ -141,6 +142,13 @@ async function runPagesRequest(request, deps) {
 	});
 	let resolvedPathname = pathnameForResolvedUrl(resolvedUrl);
 	const matchResolvedPathname = (p) => i18nConfig ? normalizeDefaultLocalePathname(p, i18nConfig, { hostname: requestHostname }) : p;
+	const matchedPathnameForRoute = (routePattern) => {
+		const matchedPathname = routePattern ? patternToNextFormat(routePattern) : resolvedPathname;
+		if (!i18nConfig) return matchedPathname;
+		const resolvedLocale = resolvedPathname.split("/", 3)[1];
+		if (resolvedLocale && i18nConfig.locales.includes(resolvedLocale)) return matchedPathname === "/" ? `/${resolvedLocale}` : `/${resolvedLocale}${matchedPathname}`;
+		return matchResolvedPathname(matchedPathname);
+	};
 	if (configHeaders.length) applyConfigHeadersToHeaderRecord(middlewareHeaders, {
 		configHeaders,
 		pathname: matchPathname,
@@ -268,12 +276,28 @@ async function runPagesRequest(request, deps) {
 			if (fallbackFilesystemResult) return fallbackFilesystemResult;
 			const fallbackApiResult = await handleResolvedApiRoute();
 			if (fallbackApiResult) return fallbackApiResult;
+			renderPageMatch = deps.matchPageRoute ? deps.matchPageRoute(resolvedPathname, request) : null;
 			response = await deps.renderPage(request, resolvedUrl, void 0, stagedHeaders);
 			matchedFallbackRewrite = true;
 			if (response.status !== 404) break;
 		}
 		if (response.status === 404 && shouldDeferErrorPageOnMiss && !matchedFallbackRewrite) response = await deps.renderPage(request, resolvedUrl, void 0, stagedHeaders);
-		const merged = mergeHeaders(response, middlewareHeaders, middlewareStatus);
+		const matchedPathHeaders = { ...middlewareHeaders };
+		if ((isDataReq || isDataRequest) && deps.hasMiddleware && !renderPageMatch && response.status === 404 && (middlewareStatus === void 0 || middlewareStatus === 200 || middlewareStatus === 404)) {
+			const headers = new Headers(response.headers);
+			headers.set("content-type", "application/json");
+			headers.set("x-nextjs-matched-path", matchResolvedPathname(pathname));
+			return {
+				type: "response",
+				response: mergeHeaders(new Response("{}", {
+					status: 200,
+					headers
+				}), matchedPathHeaders, void 0),
+				defaultContentType: "application/json"
+			};
+		}
+		if ((isDataReq || isDataRequest) && renderPageMatch && (middlewareStatus ?? response.status) === 200) matchedPathHeaders["x-nextjs-matched-path"] = matchedPathnameForRoute(renderPageMatch?.route.pattern);
+		const merged = mergeHeaders(response, matchedPathHeaders, middlewareStatus);
 		if (merged !== response) merged.__vinextStreamedHtmlResponse = response.__vinextStreamedHtmlResponse;
 		return {
 			type: "response",

package/dist/server/prerender-manifest.d.ts

@@ -7,11 +7,13 @@ type PrerenderManifestRoute = {
   path?: string;
   router?: string;
   fallback?: boolean;
+  headers?: Record<string, string>;
 };
 type PrerenderManifest = {
   buildId?: string;
   trailingSlash?: boolean;
   routes?: PrerenderManifestRoute[];
+  pregeneratedConcretePaths?: Array<[string, string[]]>;
 };
 declare function readPrerenderManifest(manifestPath: string): PrerenderManifest | null;
 declare function getRenderedAppRoutes(routes: PrerenderManifestRoute[]): PrerenderManifestRoute[];
@@ -30,4 +32,4 @@ declare function isFallbackShellArtifactPath(pathname: string, route?: Prerender
  */
 declare function buildPregeneratedConcretePathTable(manifest: PrerenderManifest): Array<[string, string[]]>;
 //#endregion
-export { buildPregeneratedConcretePathTable, getRenderedAppRoutes, isFallbackShellArtifactPath, readPrerenderManifest };
+export { PrerenderManifest, buildPregeneratedConcretePathTable, getRenderedAppRoutes, isFallbackShellArtifactPath, readPrerenderManifest };

package/dist/server/prerender-route-params.js

@@ -1,4 +1,4 @@
-import { VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER } from "./headers.js";
+import { VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER } from "../utils/protocol-headers.js";
 import { isUnknownRecord } from "../utils/record.js";
 //#region src/server/prerender-route-params.ts
 function isPrerenderRouteParams(value) {

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

@@ -74,7 +74,7 @@ declare function mergeResponseHeaders(middlewareHeaders: Record<string, string |
  * arguments in (headers, response) order. The request path now calls
  * `runPagesRequest`, which uses `mergeHeaders` directly; this wrapper is retained
  * only for its existing tests and any external callers, so there is a single
- * implementation to keep in sync. (deploy.ts still emits its own generated copy.)
+ * implementation to keep in sync. The init-owned Cloudflare Worker template delegates here.
  */
 declare function mergeWebResponse(middlewareHeaders: Record<string, string | string[]>, response: Response, statusOverride?: number): Response;
 /**

package/dist/server/prod-server.js

@@ -1,22 +1,24 @@
 import { normalizePathnameForRouteMatchStrict } from "../routing/utils.js";
 import { hasBasePath, stripBasePath } from "../utils/base-path.js";
-import { VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_STATIC_FILE_HEADER } from "./headers.js";
+import { VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER } from "../utils/protocol-headers.js";
+import { VINEXT_STATIC_FILE_HEADER } from "./headers.js";
 import { normalizePath } from "./normalize-path.js";
 import { notFoundResponse } from "./http-error-responses.js";
 import { isOpenRedirectShaped } from "./open-redirect.js";
 import { filterInternalHeaders } from "./request-pipeline.js";
 import { isUnknownRecord } from "../utils/record.js";
+import { buildNextDataNotFoundResponse, isNextDataPathname, parseNextDataPathname } from "./pages-data-route.js";
 import { resolveRequestHost, resolveRequestProtocol, trustProxy, trustedHosts } from "./proxy-trust.js";
 import { DEFAULT_DEVICE_SIZES, DEFAULT_IMAGE_SIZES, isImageOptimizationPath, isSafeImageContentType, parseImageParams } from "./image-optimization.js";
 import { installSocketErrorBackstop } from "./socket-error-backstop.js";
 import { ASSET_PREFIX_URL_DIR, assetPrefixPathname, isAbsoluteAssetPrefix } from "../utils/asset-prefix.js";
 import { CONTENT_TYPES, StaticFileCache, etagFromFilenameHash } from "./static-file-cache.js";
-import { buildNextDataNotFoundResponse, isNextDataPathname, parseNextDataPathname } from "./pages-data-route.js";
 import { collectInlineCssManifest } from "../build/inline-css.js";
 import { mergeHeaders } from "./worker-utils.js";
 import { runPagesRequest, wrapMiddlewareWithBasePath } from "./pages-request-pipeline.js";
-import { readTrustedPrerenderRouteParamsFromHeaders, serializePrerenderRouteParamsHeader } from "./prerender-route-params.js";
 import { computeClientRuntimeMetadata } from "../utils/client-runtime-metadata.js";
+import { readTrustedPrerenderRouteParamsFromHeaders, serializePrerenderRouteParamsHeader } from "./prerender-route-params.js";
+import { setPagesClientAssets } from "./pages-client-assets.js";
 import { readPrerenderSecret } from "../build/server-manifest.js";
 import { seedMemoryCacheFromPrerender } from "./seed-cache.js";
 import { negotiateEncoding, parseAcceptedEncodings, selectContentEncoding } from "./accept-encoding.js";
@@ -275,8 +277,11 @@ function installClientBuildManifestGlobals(clientDir, assetBase, assetPrefix) {
 		assetBase,
 		assetPrefix
 	});
-	globalThis.__VINEXT_LAZY_CHUNKS__ = metadata.lazyChunks;
-	globalThis.__VINEXT_DYNAMIC_PRELOADS__ = metadata.dynamicPreloads;
+	setPagesClientAssets({
+		appBootstrapPreinitModules: metadata.appBootstrapPreinitModules,
+		lazyChunks: metadata.lazyChunks,
+		dynamicPreloads: metadata.dynamicPreloads
+	});
 }
 function isNoBodyResponseStatus(status) {
 	return NO_BODY_RESPONSE_STATUSES.has(status);
@@ -305,7 +310,7 @@ function logProdServerStarted(host, port, purpose) {
 * arguments in (headers, response) order. The request path now calls
 * `runPagesRequest`, which uses `mergeHeaders` directly; this wrapper is retained
 * only for its existing tests and any external callers, so there is a single
-* implementation to keep in sync. (deploy.ts still emits its own generated copy.)
+* implementation to keep in sync. The init-owned Cloudflare Worker template delegates here.
 */
 function mergeWebResponse(middlewareHeaders, response, statusOverride) {
 	return mergeHeaders(response, middlewareHeaders, statusOverride);
@@ -736,18 +741,21 @@ function readSsrManifest(clientDir) {
 	}
 	return parsed;
 }
-function installPagesClientAssetGlobals(options) {
+function installPagesClientAssets(options) {
 	const ssrManifest = readSsrManifest(options.clientDir);
-	globalThis.__VINEXT_SSR_MANIFEST__ = Object.keys(ssrManifest).length > 0 ? ssrManifest : void 0;
 	const metadata = computeClientRuntimeMetadata({
 		clientDir: options.clientDir,
 		assetBase: options.assetBase,
 		assetPrefix: options.assetPrefix,
 		includeClientEntry: options.clientEntryLookup === "pages-client-entry" ? "pages-client-entry" : true
 	});
-	globalThis.__VINEXT_CLIENT_ENTRY__ = metadata.clientEntryFile;
-	globalThis.__VINEXT_LAZY_CHUNKS__ = metadata.lazyChunks;
-	globalThis.__VINEXT_DYNAMIC_PRELOADS__ = metadata.dynamicPreloads;
+	setPagesClientAssets({
+		clientEntry: metadata.clientEntryFile,
+		appBootstrapPreinitModules: metadata.appBootstrapPreinitModules,
+		ssrManifest: Object.keys(ssrManifest).length > 0 ? ssrManifest : void 0,
+		lazyChunks: metadata.lazyChunks,
+		dynamicPreloads: metadata.dynamicPreloads
+	});
 	return ssrManifest;
 }
 /**
@@ -769,11 +777,6 @@ function installPagesClientAssetGlobals(options) {
 */
 async function startAppRouterServer(options) {
 	const { port, host, clientDir, rscEntryPath, compress, purpose } = options;
-	let imageConfig;
-	const imageConfigPath = path.join(path.dirname(rscEntryPath), "image-config.json");
-	if (fs.existsSync(imageConfigPath)) try {
-		imageConfig = JSON.parse(fs.readFileSync(imageConfigPath, "utf-8"));
-	} catch {}
 	const prerenderSecret = readPrerenderSecret(path.dirname(rscEntryPath));
 	const rscModule = await importServerEntryModule(rscEntryPath);
 	const rscHandler = resolveAppRouterHandler(rscModule.default);
@@ -781,10 +784,18 @@ async function startAppRouterServer(options) {
 	const appRouterBasePath = typeof rscModule.__basePath === "string" ? rscModule.__basePath : "";
 	const appRouterInlineCss = rscModule.__inlineCss === true;
 	const appRouterHasPagesDir = rscModule.__hasPagesDir === true;
+	const appImageAllowedWidths = Array.isArray(rscModule.__imageAllowedWidths) ? rscModule.__imageAllowedWidths : [...DEFAULT_DEVICE_SIZES, ...DEFAULT_IMAGE_SIZES];
+	let imageConfig = typeof rscModule.__imageConfig === "object" && rscModule.__imageConfig !== null ? rscModule.__imageConfig : void 0;
+	if (imageConfig === void 0) {
+		const imageConfigPath = path.join(path.dirname(rscEntryPath), "image-config.json");
+		if (fs.existsSync(imageConfigPath)) try {
+			imageConfig = JSON.parse(fs.readFileSync(imageConfigPath, "utf-8"));
+		} catch {}
+	}
 	globalThis.__VINEXT_INLINE_CSS__ = appRouterInlineCss ? collectInlineCssManifest(clientDir, appRouterAssetPrefix) : void 0;
 	const appAssetPathPrefix = assetPrefixPathname(appRouterAssetPrefix);
 	const appAssetBase = appRouterBasePath ? `${appRouterBasePath}/` : "/";
-	if (appRouterHasPagesDir) installPagesClientAssetGlobals({
+	if (appRouterHasPagesDir) installPagesClientAssets({
 		clientDir,
 		assetPrefix: appRouterAssetPrefix,
 		assetBase: appAssetBase,
@@ -819,17 +830,16 @@ async function startAppRouterServer(options) {
 				return;
 			}
 		}
+		let missingBuildAsset = false;
 		{
 			const assetLookupPath = resolveAppRouterAssetPath(pathname, appAssetPathPrefix, appRouterAssetPrefix);
 			if (assetLookupPath) {
 				if (await tryServeStatic(req, res, clientDir, assetLookupPath, compress, staticCache)) return;
-				res.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
-				res.end("Not Found");
-				return;
+				missingBuildAsset = true;
 			}
 		}
 		if (isImageOptimizationPath(pathname)) {
-			const params = parseImageParams(new URL(rawUrl, "http://localhost"), [...imageConfig?.deviceSizes ?? DEFAULT_DEVICE_SIZES, ...imageConfig?.imageSizes ?? DEFAULT_IMAGE_SIZES], imageConfig?.qualities);
+			const params = parseImageParams(new URL(rawUrl, "http://localhost"), appImageAllowedWidths, imageConfig?.qualities);
 			if (!params) {
 				res.writeHead(400);
 				res.end("Bad Request");
@@ -868,6 +878,12 @@ async function startAppRouterServer(options) {
 				await sendWebResponse(notFoundResponse({ headers: toWebHeaders(staticResponseHeaders) }), req, res, compress);
 				return;
 			}
+			if (missingBuildAsset && response.status === 404) {
+				cancelResponseBody(response);
+				res.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
+				res.end("Not Found");
+				return;
+			}
 			await sendWebResponse(response, req, res, compress);
 		} catch (e) {
 			console.error("[vinext] Server error:", e);
@@ -918,6 +934,7 @@ async function startPagesRouterServer(options) {
 	const serverEntry = await importServerEntryModule(serverEntryPath);
 	const { renderPage, handleApiRoute: handleApi, runMiddleware, vinextConfig, buildId: pagesBuildId } = serverEntry;
 	const matchPageRoute = typeof serverEntry.matchPageRoute === "function" ? serverEntry.matchPageRoute : void 0;
+	const hasMiddleware = serverEntry.hasMiddleware === true;
 	const pageRoutes = readPagesServerEntryPageRoutes(serverEntry.pageRoutes);
 	const prerenderSecret = readPrerenderSecret(path.dirname(serverEntryPath));
 	const basePath = vinextConfig?.basePath ?? "";
@@ -941,7 +958,7 @@ async function startPagesRouterServer(options) {
 		contentDispositionType: vinextConfig.images.contentDispositionType,
 		contentSecurityPolicy: vinextConfig.images.contentSecurityPolicy
 	} : void 0;
-	const ssrManifest = installPagesClientAssetGlobals({
+	const ssrManifest = installPagesClientAssets({
 		clientDir,
 		assetPrefix,
 		assetBase,
@@ -1000,11 +1017,9 @@ async function startPagesRouterServer(options) {
 		}
 		const staticLookupPath = stripBasePath(pathname, basePath);
 		const pagesAssetLookup = resolveAppRouterAssetPath(pathname, pagesAssetPathPrefix, assetPrefix);
+		const missingBuildAsset = pagesAssetLookup !== null;
 		if (pagesAssetLookup) {
 			if (await tryServeStatic(req, res, clientDir, pagesAssetLookup, compress, staticCache)) return;
-			res.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
-			res.end("Not Found");
-			return;
 		}
 		if (isImageOptimizationPath(pathname) || isImageOptimizationPath(staticLookupPath)) {
 			const params = parseImageParams(new URL(rawUrl, "http://localhost"), allowedImageWidths, pagesImageConfig?.qualities);
@@ -1072,6 +1087,7 @@ async function startPagesRouterServer(options) {
 				hadBasePath,
 				isDataReq,
 				isDataRequest,
+				hasMiddleware,
 				ctx: void 0,
 				rawSearch: rawQs,
 				matchPageRoute: matchPageRoute ?? null,
@@ -1089,6 +1105,12 @@ async function startPagesRouterServer(options) {
 			if (result.type === "handled") return;
 			if (result.type === "response") {
 				const { response } = result;
+				if (missingBuildAsset && response.status === 404) {
+					cancelResponseBody(response);
+					res.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
+					res.end("Not Found");
+					return;
+				}
 				if (isVinextStreamedHtmlResponse(response) || !response.body || result.defaultContentType === void 0) {
 					await sendWebResponse(response, req, res, compress);
 					return;

package/dist/server/request-log.d.ts

@@ -1,17 +1,6 @@
+import { ServerActionLogInfo } from "./server-action-logger.js";
+
 //#region src/server/request-log.d.ts
-/**
- * Request logging for the vinext dev server.
- *
- * Matches Next.js's request log format:
- *   GET /path 200 in 123ms (compile: 45ms, render: 78ms)
- *
- * Color coding matches Next.js:
- *  - 2xx: green
- *  - 3xx: cyan
- *  - 4xx: yellow
- *  - 5xx: red
- *  - Method: bold
- */
 type RequestLogOptions = {
   method: string;
   url: string;
@@ -20,6 +9,8 @@ type RequestLogOptions = {
   compileMs?: number; /** Time spent in React rendering / HTML streaming. */
   renderMs?: number;
 };
+/** Print the nested server action log line under the request log. */
+declare function logServerAction(info: ServerActionLogInfo): void;
 /**
  * Print a single request log line to stdout.
  */
@@ -36,4 +27,4 @@ declare function logRequest({
  */
 declare function now(): number;
 //#endregion
-export { logRequest, now };
+export { RequestLogOptions, logRequest, logServerAction, now };

package/dist/server/request-log.js

@@ -1,3 +1,4 @@
+import { formatActionArgs } from "./server-action-logger.js";
 //#region src/server/request-log.ts
 /**
 * Request logging for the vinext dev server.
@@ -31,6 +32,11 @@ function formatDuration(ms) {
 	if (ms >= 1e3) return `${(ms / 1e3).toFixed(1)}s`;
 	return `${Math.round(ms)}ms`;
 }
+/** Print the nested server action log line under the request log. */
+function logServerAction(info) {
+	const argsStr = formatActionArgs(info.args);
+	process.stdout.write(` └─ ƒ ${info.functionName}(${argsStr}) in ${info.duration}ms ${pretty.dim(info.location)}\n`);
+}
 /**
 * Print a single request log line to stdout.
 */
@@ -53,4 +59,4 @@ function now() {
 	return performance.now();
 }
 //#endregion
-export { logRequest, now };
+export { logRequest, logServerAction, now };

package/dist/server/request-pipeline.js

@@ -1,4 +1,5 @@
 import { hasBasePath, removeTrailingSlash, stripBasePath } from "../utils/base-path.js";
+import "../utils/protocol-headers.js";
 import { INTERNAL_HEADERS, VINEXT_INTERNAL_HEADERS, VINEXT_STATIC_FILE_HEADER } from "./headers.js";
 import { matchHeaders } from "../config/config-matchers.js";
 import { forbiddenResponse, notFoundResponse } from "./http-error-responses.js";

package/dist/server/seed-cache.js

@@ -1,8 +1,8 @@
 import { isrCacheKey, isrSetPrerenderedAppPage } from "./isr-cache.js";
+import { getRenderedAppRoutes, isFallbackShellArtifactPath, readPrerenderManifest } from "./prerender-manifest.js";
 import { buildAppPageCacheTags } from "./app-page-cache.js";
 import { getOutputPath, getRscOutputPath } from "../utils/prerender-output-paths.js";
 import { addPregeneratedConcretePath, clearPregeneratedConcretePaths, normalizePregeneratedPathname } from "./pregenerated-concrete-paths.js";
-import { getRenderedAppRoutes, isFallbackShellArtifactPath, readPrerenderManifest } from "./prerender-manifest.js";
 import fs from "node:fs";
 import path from "node:path";
 //#region src/server/seed-cache.ts
@@ -67,7 +67,7 @@ async function seedMemoryCacheFromPrerender(serverDir, options) {
 		const revalidateSeconds = typeof route.revalidate === "number" ? route.revalidate : void 0;
 		const expireSeconds = typeof route.expire === "number" ? route.expire : void 0;
 		const tags = buildAppPageCacheTags(cachePathname, []);
-		if (await seedHtml(writeAppPageEntry, prerenderDir, htmlKey, artifactPathname, trailingSlash, revalidateSeconds, expireSeconds, tags)) {
+		if (await seedHtml(writeAppPageEntry, prerenderDir, htmlKey, artifactPathname, trailingSlash, route.headers, revalidateSeconds, expireSeconds, tags)) {
 			await seedRsc(writeAppPageEntry, prerenderDir, rscKey, artifactPathname, revalidateSeconds, expireSeconds, tags);
 			seeded++;
 		}
@@ -81,7 +81,7 @@ function createDefaultAppPageEntryWriter() {
 * Seed the HTML cache entry for a single route.
 * Returns true if the file existed and was seeded.
 */
-async function seedHtml(writeAppPageEntry, prerenderDir, key, pathname, trailingSlash, revalidateSeconds, expireSeconds, tags) {
+async function seedHtml(writeAppPageEntry, prerenderDir, key, pathname, trailingSlash, headers, revalidateSeconds, expireSeconds, tags) {
 	const relPath = getOutputPath(pathname, trailingSlash);
 	const fullPath = path.join(prerenderDir, relPath);
 	if (!fs.existsSync(fullPath)) return false;
@@ -89,7 +89,7 @@ async function seedHtml(writeAppPageEntry, prerenderDir, key, pathname, trailing
 		kind: "APP_PAGE",
 		html: fs.readFileSync(fullPath, "utf-8"),
 		rscData: void 0,
-		headers: void 0,
+		headers,
 		postponed: void 0,
 		status: void 0
 	}, {

package/dist/server/server-action-logger.d.ts

@@ -0,0 +1,39 @@
+//#region src/server/server-action-logger.d.ts
+/**
+ * Dev-only Server Action logging — metadata and wire-format helpers.
+ *
+ * Terminal output lives in `request-log.ts`. Dev middleware interception lives
+ * in `dev-response-headers.ts`.
+ *
+ * Ported from Next.js:
+ * - packages/next/src/server/dev/server-action-logger.ts
+ * - packages/next/src/server/dev/log-requests.ts
+ *
+ * https://github.com/vercel/next.js/pull/88277
+ */
+type ServerActionLogInfo = {
+  functionName: string;
+  args: unknown[];
+  location: string;
+  duration: number;
+};
+declare function isDevServerActionLoggingEnabled(): boolean;
+/**
+ * Resolve display metadata from an `x-rsc-action` / `next-action` action id.
+ *
+ * Action ids encode module path and export name:
+ *   `/app/actions/actions.ts#echoAction`
+ */
+declare function resolveServerActionLogMeta(actionId: string | null): Pick<ServerActionLogInfo, "functionName" | "location"> | null;
+/** Format action arguments for the dev log line. */
+declare function formatActionArgs(args: unknown[]): string;
+declare function serializeServerActionLogHeader(info: ServerActionLogInfo): string;
+declare function parseServerActionLogHeader(value: string): ServerActionLogInfo | null;
+declare function applyServerActionLogHeader(headers: Headers, info: ServerActionLogInfo | null): void;
+declare function createServerActionLogInfo(options: {
+  actionId: string | null;
+  args: readonly unknown[];
+  durationMs: number;
+}): ServerActionLogInfo | null;
+//#endregion
+export { ServerActionLogInfo, applyServerActionLogHeader, createServerActionLogInfo, formatActionArgs, isDevServerActionLoggingEnabled, parseServerActionLogHeader, resolveServerActionLogMeta, serializeServerActionLogHeader };

package/dist/server/server-action-logger.js

@@ -0,0 +1,104 @@
+import { VINEXT_ACTION_LOG_HEADER } from "./headers.js";
+//#region src/server/server-action-logger.ts
+/**
+* Dev-only Server Action logging — metadata and wire-format helpers.
+*
+* Terminal output lives in `request-log.ts`. Dev middleware interception lives
+* in `dev-response-headers.ts`.
+*
+* Ported from Next.js:
+* - packages/next/src/server/dev/server-action-logger.ts
+* - packages/next/src/server/dev/log-requests.ts
+*
+* https://github.com/vercel/next.js/pull/88277
+*/
+const INLINE_ACTION_PREFIXES = ["$$RSC_SERVER_ACTION_", "$$hoist_"];
+const USE_CACHE_ACTION_PREFIX = "$$RSC_SERVER_CACHE_";
+function isDevServerActionLoggingEnabled() {
+	return process.env.NODE_ENV !== "production";
+}
+function isInlineActionExport(exportedName) {
+	return INLINE_ACTION_PREFIXES.some((prefix) => exportedName.startsWith(prefix));
+}
+function isUseCacheActionExport(exportedName) {
+	return exportedName.startsWith(USE_CACHE_ACTION_PREFIX);
+}
+/**
+* Resolve display metadata from an `x-rsc-action` / `next-action` action id.
+*
+* Action ids encode module path and export name:
+*   `/app/actions/actions.ts#echoAction`
+*/
+function resolveServerActionLogMeta(actionId) {
+	if (!actionId) return null;
+	const hashIndex = actionId.lastIndexOf("#");
+	if (hashIndex <= 0) return null;
+	const exportedName = actionId.slice(hashIndex + 1);
+	if (isUseCacheActionExport(exportedName)) return null;
+	const location = actionId.slice(0, hashIndex).replace(/\\/g, "/").replace(/^\//, "");
+	let functionName;
+	if (isInlineActionExport(exportedName)) functionName = "";
+	else if (exportedName === "default") functionName = "default";
+	else functionName = exportedName;
+	return {
+		functionName,
+		location
+	};
+}
+function formatArg(arg, depth = 0) {
+	if (arg === null) return "null";
+	if (arg === void 0) return "undefined";
+	if (typeof arg === "string") return JSON.stringify(arg);
+	if (typeof arg === "number" || typeof arg === "boolean" || typeof arg === "bigint") return String(arg);
+	if (typeof arg === "symbol") return String(arg);
+	if (typeof arg === "function") return "[Function]";
+	if (depth >= 2) return "[Object]";
+	if (Array.isArray(arg)) {
+		const items = arg.slice(0, 3).map((item) => formatArg(item, depth + 1));
+		if (arg.length > 3) items.push("...");
+		return `[${items.join(",")}]`;
+	}
+	if (typeof arg === "object") try {
+		const formatted = Object.entries(arg).slice(0, 3).map(([key, value]) => `${JSON.stringify(key)}:${formatArg(value, depth + 1)}`);
+		if (Object.keys(arg).length > 3) formatted.push("...");
+		return `{${formatted.join(",")}}`;
+	} catch {
+		return "[Object]";
+	}
+	try {
+		return JSON.stringify(arg);
+	} catch {
+		return "[unserializable]";
+	}
+}
+/** Format action arguments for the dev log line. */
+function formatActionArgs(args) {
+	return args.map((arg) => formatArg(arg)).join(", ");
+}
+function serializeServerActionLogHeader(info) {
+	return JSON.stringify(info);
+}
+function parseServerActionLogHeader(value) {
+	try {
+		const parsed = JSON.parse(value);
+		if (typeof parsed.functionName === "string" && Array.isArray(parsed.args) && typeof parsed.location === "string" && typeof parsed.duration === "number") return parsed;
+	} catch {}
+	return null;
+}
+function applyServerActionLogHeader(headers, info) {
+	if (!info) return;
+	headers.set(VINEXT_ACTION_LOG_HEADER, serializeServerActionLogHeader(info));
+}
+function createServerActionLogInfo(options) {
+	if (!isDevServerActionLoggingEnabled()) return null;
+	const meta = resolveServerActionLogMeta(options.actionId);
+	if (!meta) return null;
+	const args = Array.isArray(options.args) ? options.args : [options.args];
+	return {
+		...meta,
+		args: [...args],
+		duration: options.durationMs
+	};
+}
+//#endregion
+export { applyServerActionLogHeader, createServerActionLogInfo, formatActionArgs, isDevServerActionLoggingEnabled, parseServerActionLogHeader, resolveServerActionLogMeta, serializeServerActionLogHeader };

package/dist/server/worker-utils.d.ts

@@ -1,7 +1,8 @@
 //#region src/server/worker-utils.d.ts
+declare function finalizeMissingStaticAssetResponse(response: Response, missingBuildAsset: boolean): Response;
 declare function mergeHeaders(response: Response, extraHeaders: Record<string, string | string[]>, statusOverride?: number): Response;
 declare function resolveStaticAssetSignal(signalResponse: Response, options: {
   fetchAsset(path: string): Promise<Response>;
 }): Promise<Response | null>;
 //#endregion
-export { mergeHeaders, resolveStaticAssetSignal };
+export { finalizeMissingStaticAssetResponse, mergeHeaders, resolveStaticAssetSignal };

package/dist/server/worker-utils.js

@@ -1,4 +1,5 @@
 import { VINEXT_STATIC_FILE_HEADER } from "./headers.js";
+import { notFoundStaticAssetResponse } from "./http-error-responses.js";
 //#region src/server/worker-utils.ts
 /**
 * Shared utilities for Cloudflare Worker entries.
@@ -29,6 +30,11 @@ function cancelResponseBody(response) {
 	if (!body || body.locked) return;
 	body.cancel().catch(() => {});
 }
+function finalizeMissingStaticAssetResponse(response, missingBuildAsset) {
+	if (!missingBuildAsset || response.status !== 404) return response;
+	cancelResponseBody(response);
+	return notFoundStaticAssetResponse();
+}
 function buildHeaderRecord(response, omitNames = []) {
 	const omitted = new Set(omitNames.map((name) => name.toLowerCase()));
 	const headers = {};
@@ -96,4 +102,4 @@ async function resolveStaticAssetSignal(signalResponse, options) {
 	return mergeHeaders(assetResponse, extraHeaders, assetResponse.ok && signalResponse.status !== 200 ? signalResponse.status : void 0);
 }
 //#endregion
-export { mergeHeaders, resolveStaticAssetSignal };
+export { finalizeMissingStaticAssetResponse, mergeHeaders, resolveStaticAssetSignal };

package/dist/shims/app-router-scroll-state.d.ts

@@ -2,6 +2,7 @@
 type AppRouterScrollIntent = Readonly<{
   commitId: number | null;
   hash: string | null;
+  headElements: ReadonlySet<Element> | null;
   id: number;
   targetHoistedInHead: boolean;
 }>;

package/dist/shims/app-router-scroll-state.js

@@ -14,6 +14,7 @@ function beginAppRouterScrollIntent(hash) {
 	const intent = {
 		commitId: null,
 		hash,
+		headElements: typeof document === "undefined" ? null : new Set(document.head?.children ?? []),
 		id: store.nextId,
 		targetHoistedInHead: false
 	};

package/dist/shims/app-router-scroll.js

@@ -99,7 +99,8 @@ var AppRouterScrollTargetInner = class extends React$1.Component {
 		else node = null;
 		if (node === null) {
 			node = findDOMNode(this);
-			if (node !== null && isInDocumentHead(node)) {
+			const headElement = node instanceof Element ? node : node?.parentElement;
+			if (node !== null && headElement != null && isInDocumentHead(node) && !intent.headElements?.has(headElement)) {
 				markAppRouterScrollIntentHeadHoisted(intent, this.props.commitId);
 				return;
 			}