vinext 1.4.3 → 1.4.5

package/dist/server/app-route-handler-response.d.ts

@@ -1,6 +1,5 @@
-import { MiddlewareResponseMergeOptions } from "./middleware-response-headers.js";
 import { CacheControlMetadata, CachedRouteValue } from "../shims/cache-handler.js";
-//#region src/server/app-route-handler-response.d.ts
+import { MiddlewareResponseMergeOptions } from "./middleware-response-headers.js";
 export type RouteHandlerMiddlewareContext = {
   headers: Headers | null;
   status: number | null;
@@ -17,14 +16,16 @@ type FinalizeRouteHandlerResponseOptions = {
   draftCookie?: string | null;
   isHead: boolean;
 };
+export declare function stripRouteHandlerFramingHeaders(response: Response): Response;
 export declare function applyRouteHandlerMiddlewareContext(response: Response, middlewareContext: RouteHandlerMiddlewareContext, options?: MiddlewareResponseMergeOptions & {
   appendResponseLink?: boolean;
 }): Response;
 export declare function assertSupportedAppRouteHandlerResponse(response: Response): void;
+/** Drop a route-miss marker the handler set, so only routing can mark a miss. */
+export declare function stripAppRouteHandlerRouteMissMarker(response: Response): Response;
 export declare function buildRouteHandlerCachedResponse(cachedValue: CachedRouteValue, options: BuildRouteHandlerCachedResponseOptions): Response;
 export declare function applyRouteHandlerRevalidateHeader(response: Response, revalidateSeconds: number, expireSeconds?: number, tags?: readonly string[]): void;
 export declare function markRouteHandlerCacheMiss(response: Response): void;
 export declare function buildAppRouteCacheValue(response: Response, browserCacheControl?: string): Promise<CachedRouteValue>;
 export declare function finalizeRouteHandlerResponse(response: Response, options: FinalizeRouteHandlerResponseOptions): Response;
-//#endregion
 export {};

package/dist/server/app-route-handler-response.js

@@ -1,16 +1,39 @@
-import "../utils/protocol-headers.js";
-import { NEXT_CACHE_TAGS_HEADER, VINEXT_METADATA_ROUTE_CACHE_HEADER } from "./headers.js";
-import { processMiddlewareHeaders } from "./request-pipeline.js";
 import { markRouteCacheabilityExplicitResponsePolicy, recordRouteCacheability } from "../shims/cacheability-classification.js";
+import "../utils/protocol-headers.js";
 import { applyCdnResponseHeaders } from "./cache-control.js";
 import { buildAppRouteMissIsrCacheControl, decideIsr } from "./isr-decision.js";
+import { NEXT_CACHE_TAGS_HEADER, VINEXT_METADATA_ROUTE_CACHE_HEADER, VINEXT_ROUTE_MISS_HEADER } from "./headers.js";
 import { setCacheStateHeaders } from "./cache-headers.js";
-import { markEdgeRouteHandlerLinkHeaders } from "./app-response-header-provenance.js";
 import { mergeMiddlewareResponseHeadersOntoResponse } from "./middleware-response-headers.js";
+import { processMiddlewareHeaders } from "./request-pipeline.js";
 import { getSetCookieName } from "./cookie-utils.js";
-//#region src/server/app-route-handler-response.ts
+import { copyLinkHeaderProvenance, markEdgeRouteHandlerLinkHeaders } from "./app-response-header-provenance.js";
+import { preserveFullyBufferedBodyMetadata } from "./fully-buffered-response.js";
+// src/server/app-route-handler-response.ts
 const APP_ROUTE_REWRITE_ERROR = "NextResponse.rewrite() was used in a app route handler, this is not currently supported. Please remove the invocation to continue.";
 const APP_ROUTE_NEXT_ERROR = "NextResponse.next() was used in a app route handler, this is not supported. See here for more info: https://nextjs.org/docs/messages/next-response-next-in-app-route-handler";
+const ROUTE_HANDLER_FRAMING_HEADERS = [
+	"content-length",
+	"content-encoding",
+	"transfer-encoding"
+];
+function shouldDropRouteHandlerFramingHeaders(headers) {
+	if ("WebSocketPair" in globalThis) return false;
+	return ROUTE_HANDLER_FRAMING_HEADERS.some((name) => headers.has(name));
+}
+function deleteRouteHandlerFramingHeaders(headers) {
+	for (const name of ROUTE_HANDLER_FRAMING_HEADERS) headers.delete(name);
+}
+function stripRouteHandlerFramingHeaders(response) {
+	if (!shouldDropRouteHandlerFramingHeaders(response.headers)) return response;
+	const headers = new Headers(response.headers);
+	deleteRouteHandlerFramingHeaders(headers);
+	return preserveFullyBufferedBodyMetadata(response, new Response(response.body, {
+		status: response.status,
+		statusText: response.statusText,
+		headers
+	}));
+}
 function hasMiddlewareHeader(headers) {
 	for (const key of headers.keys()) if (key.startsWith("x-middleware-")) return true;
 	return false;
@@ -36,12 +59,26 @@ function assertSupportedAppRouteHandlerResponse(response) {
 	if (response.headers.has("x-middleware-rewrite")) throw new Error(APP_ROUTE_REWRITE_ERROR);
 	if (response.headers.get("x-middleware-next") === "1") throw new Error(APP_ROUTE_NEXT_ERROR);
 }
+/** Drop a route-miss marker the handler set, so only routing can mark a miss. */
+function stripAppRouteHandlerRouteMissMarker(response) {
+	if (!response.headers.has("x-vinext-route-miss")) return response;
+	try {
+		response.headers.delete(VINEXT_ROUTE_MISS_HEADER);
+		return response;
+	} catch {}
+	const rebuilt = preserveFullyBufferedBodyMetadata(response, new Response(response.body, response));
+	copyLinkHeaderProvenance(response.headers, rebuilt.headers);
+	rebuilt.headers.delete(VINEXT_ROUTE_MISS_HEADER);
+	return rebuilt;
+}
 function buildRouteHandlerCachedResponse(cachedValue, options) {
 	const headers = new Headers();
 	for (const [key, value] of Object.entries(cachedValue.headers)) if (Array.isArray(value)) for (const entry of value) headers.append(key, entry);
 	else headers.set(key, value);
 	headers.delete(NEXT_CACHE_TAGS_HEADER);
 	headers.delete(VINEXT_METADATA_ROUTE_CACHE_HEADER);
+	headers.delete(VINEXT_ROUTE_MISS_HEADER);
+	if (shouldDropRouteHandlerFramingHeaders(headers)) deleteRouteHandlerFramingHeaders(headers);
 	setCacheStateHeaders(headers, options.cacheState);
 	const { cacheControl } = decideIsr({
 		cacheState: options.cacheState,
@@ -152,8 +189,9 @@ async function buildAppRouteCacheValue(response, browserCacheControl) {
 }
 function finalizeRouteHandlerResponse(response, options) {
 	const { pendingCookies, draftCookie, isHead } = options;
-	if (pendingCookies.length === 0 && !draftCookie && !isHead && !hasMiddlewareHeader(response.headers)) return response;
+	if (pendingCookies.length === 0 && !draftCookie && !isHead && !hasMiddlewareHeader(response.headers) && !shouldDropRouteHandlerFramingHeaders(response.headers)) return response;
 	const headers = new Headers(response.headers);
+	if (shouldDropRouteHandlerFramingHeaders(headers)) deleteRouteHandlerFramingHeaders(headers);
 	processMiddlewareHeaders(headers);
 	applyMutableCookieFallbacks(headers, pendingCookies);
 	if (draftCookie) headers.append("Set-Cookie", draftCookie);
@@ -163,5 +201,4 @@ function finalizeRouteHandlerResponse(response, options) {
 		headers
 	});
 }
-//#endregion
-export { applyRouteHandlerMiddlewareContext, applyRouteHandlerRevalidateHeader, assertSupportedAppRouteHandlerResponse, buildAppRouteCacheValue, buildRouteHandlerCachedResponse, finalizeRouteHandlerResponse, markRouteHandlerCacheMiss };
+export { applyRouteHandlerMiddlewareContext, applyRouteHandlerRevalidateHeader, assertSupportedAppRouteHandlerResponse, buildAppRouteCacheValue, buildRouteHandlerCachedResponse, finalizeRouteHandlerResponse, markRouteHandlerCacheMiss, stripAppRouteHandlerRouteMissMarker, stripRouteHandlerFramingHeaders };

package/dist/server/app-route-handler-runtime.d.ts

@@ -1,6 +1,5 @@
 import { NextI18nConfig } from "../config/next-config.js";
 import { NextRequest } from "../shims/server.js";
-//#region src/server/app-route-handler-runtime.d.ts
 declare const ROUTE_HANDLER_HTTP_METHODS: readonly ["GET", "HEAD", "POST", "PUT", "DELETE", "PATCH", "OPTIONS"];
 export type RouteHandlerHttpMethod = (typeof ROUTE_HANDLER_HTTP_METHODS)[number];
 export type RouteHandlerModule = Partial<Record<RouteHandlerHttpMethod | "default", unknown>>;
@@ -39,5 +38,4 @@ type TrackedAppRouteRequest = {
   didAccessDynamicRequest(): boolean;
 };
 export declare function createTrackedAppRouteRequest(request: Request, options?: TrackedAppRouteRequestOptions): TrackedAppRouteRequest;
-//#endregion
 export {};

package/dist/server/app-route-handler-runtime.js

@@ -1,10 +1,10 @@
-import { buildRequestHeadersFromMiddlewareResponse } from "../utils/middleware-request-headers.js";
-import { addBasePathToPathname } from "../utils/base-path.js";
-import { cloneRequestWithHeaders, cloneRequestWithUrl } from "./request-pipeline.js";
 import { NextRequest, RequestCookies, sealRequestCookies, sealRequestHeaders } from "../shims/server.js";
 import { throwIfInsideCacheScope } from "../shims/internal/headers-state.js";
+import { cloneRequestWithHeaders, cloneRequestWithUrl } from "./request-pipeline.js";
+import { buildRequestHeadersFromMiddlewareResponse } from "../utils/middleware-request-headers.js";
+import { addBasePathToPathname } from "../utils/base-path.js";
 import { BUILT_IN_REQUEST_PROPERTIES } from "./app-route-request-built-ins.js";
-//#region src/server/app-route-handler-runtime.ts
+// src/server/app-route-handler-runtime.ts
 const BUILT_IN_REQUEST_PROPERTY_MAP = new Map(BUILT_IN_REQUEST_PROPERTIES.map((property) => [property.key, property]));
 const ROUTE_HANDLER_HTTP_METHODS = [
 	"GET",
@@ -438,5 +438,4 @@ function createTrackedAppRouteRequest(request, options = {}) {
 		}
 	};
 }
-//#endregion
 export { buildRouteHandlerAllowHeader, collectRouteHandlerMethods, createTrackedAppRouteRequest, isKnownDynamicAppRoute, isValidHTTPMethod, markKnownDynamicAppRoute };

package/dist/server/app-route-module-loader.d.ts

@@ -1,4 +1,3 @@
-//#region src/server/app-route-module-loader.d.ts
 /**
  * Lazy route-module hydration for the App Router RSC entry.
  *
@@ -141,5 +140,4 @@ export declare function loadAppInterceptLayouts(intercept: LazyLoadableIntercept
  * `null`/`undefined` routes and on eager routes that have no lazy thunks.
  */
 export declare function ensureAppRouteModulesLoaded<TRoute extends LazyLoadableRoute>(route: TRoute | null | undefined): TRoute | Promise<TRoute>;
-//#endregion
 export {};

package/dist/server/app-route-module-loader.js

@@ -1,6 +1,6 @@
 import { runOutsideRequestScopes } from "../shims/internal/als-registry.js";
 import { shareIsolatePromise } from "./isolate-shared-promise.js";
-//#region src/server/app-route-module-loader.ts
+// src/server/app-route-module-loader.ts
 /**
 * Lazy route-module hydration for the App Router RSC entry.
 *
@@ -164,5 +164,4 @@ function ensureAppRouteModulesLoaded(route) {
 	route.__loading = loading;
 	return loading;
 }
-//#endregion
 export { ensureAppRouteModulesLoaded, loadAppInterceptLayouts, loadAppInterceptNotFound, loadAppInterceptPage };

package/dist/server/app-route-request-built-ins.d.ts

@@ -1,4 +1,3 @@
-//#region src/server/app-route-request-built-ins.d.ts
 export type BuiltInRequestProperty = {
   descriptor: PropertyDescriptor;
   instanceOnly: boolean;
@@ -11,5 +10,4 @@ export type BuiltInRequestProperty = {
  * The production RSC entry imports this module ahead of userland; the global
  * symbol also preserves that first snapshot for the lazy dispatch chunk.
  */
-export declare const BUILT_IN_REQUEST_PROPERTIES: readonly BuiltInRequestProperty[];
-//#endregion
+export declare const BUILT_IN_REQUEST_PROPERTIES: readonly BuiltInRequestProperty[];

package/dist/server/app-route-request-built-ins.js

@@ -1,4 +1,4 @@
-//#region src/server/app-route-request-built-ins.ts
+// src/server/app-route-request-built-ins.ts
 const BUILT_IN_REQUEST_PROPERTIES_KEY = Symbol.for("vinext.appRouteHandlerRuntime.builtInRequestProperties");
 const globalState = globalThis;
 function captureBuiltInRequestProperties(requestInstance = new Request("http://vinext.invalid/")) {
@@ -37,5 +37,4 @@ function captureBuiltInRequestProperties(requestInstance = new Request("http://v
 * symbol also preserves that first snapshot for the lazy dispatch chunk.
 */
 const BUILT_IN_REQUEST_PROPERTIES = globalState[BUILT_IN_REQUEST_PROPERTIES_KEY] ??= captureBuiltInRequestProperties();
-//#endregion
 export { BUILT_IN_REQUEST_PROPERTIES };

package/dist/server/app-route-tree-prefetch.d.ts

@@ -1,4 +1,3 @@
-//#region src/server/app-route-tree-prefetch.d.ts
 type DynamicParamTypeShort = "d" | "c" | "oc";
 type TreePrefetchParam = {
   type: DynamicParamTypeShort;
@@ -39,5 +38,4 @@ export type PrefetchInliningConfig = false | {
 };
 export declare function isRouteTreePrefetchRequest(request: Request): boolean;
 export declare function createRouteTreePrefetchResponse(route: AppRouteTreePrefetchRoute, options?: RouteTreePrefetchResponseOptions): Promise<Response>;
-//#endregion
 export {};

package/dist/server/app-route-tree-prefetch.js

@@ -1,8 +1,8 @@
 import { VINEXT_RSC_VARY_HEADER } from "./app-rsc-vary.js";
 import { NEXTJS_DEPLOYMENT_ID_HEADER } from "./headers.js";
-import { getDeploymentId } from "../utils/deployment-id.js";
 import { VINEXT_RSC_CONTENT_TYPE, applyRscCompatibilityIdHeader } from "./app-rsc-cache-busting.js";
-//#region src/server/app-route-tree-prefetch.ts
+import { getDeploymentId } from "../utils/deployment-id.js";
+// src/server/app-route-tree-prefetch.ts
 const PARENT_INLINED_INTO_SELF = 32;
 const INLINED_INTO_CHILD = 64;
 const HEAD_INLINED_INTO_SELF = 128;
@@ -184,5 +184,4 @@ async function createRouteTreePrefetchResponse(route, options = {}) {
 	if (options.buildId) payload.buildId = options.buildId;
 	return new Response(`0:${JSON.stringify(payload)}\n`, { headers });
 }
-//#endregion
 export { createRouteTreePrefetchResponse, isRouteTreePrefetchRequest };

package/dist/server/app-route-tree.d.ts

@@ -1,7 +1,6 @@
 import { AppElements } from "./app-elements-wire.js";
 import "./app-elements.js";
 import { ReactNode } from "react";
-//#region src/server/app-route-tree.d.ts
 /**
  * Builds the App Router route tree after a sibling that the browser uses to
  * write navigation history. Insertion effects run in tree order, so that
@@ -16,5 +15,4 @@ export declare function createAppRouteTree(options: {
   elements: AppElements;
   historyCommit: ReactNode;
   routeId: string;
-}): ReactNode;
-//#endregion
+}): ReactNode;

package/dist/server/app-route-tree.js

@@ -1,6 +1,6 @@
 import { ElementsContext, Slot } from "../shims/slot.js";
 import { Fragment, createElement } from "react";
-//#region src/server/app-route-tree.ts
+// src/server/app-route-tree.ts
 /**
 * Builds the App Router route tree after a sibling that the browser uses to
 * write navigation history. Insertion effects run in tree order, so that
@@ -14,5 +14,4 @@ import { Fragment, createElement } from "react";
 function createAppRouteTree(options) {
 	return createElement(Fragment, null, options.historyCommit, createElement(ElementsContext.Provider, { value: options.elements }, createElement(Slot, { id: options.routeId })));
 }
-//#endregion
 export { createAppRouteTree };

package/dist/server/app-router-entry.d.ts

@@ -1,7 +1,6 @@
-import { VinextRequestStageContext } from "./multi-stage.js";
 import { ExecutionContextLike } from "../shims/request-context.js";
+import { VinextRequestStageContext } from "./multi-stage.js";
 import { __ensureInstrumentation } from "virtual:vinext-rsc-entry";
-//#region src/server/app-router-entry.d.ts
 type WorkerAssetEnv = {
   ASSETS?: {
     fetch(request: Request): Promise<Response> | Response;
@@ -11,5 +10,4 @@ declare const _default: {
   __ensureInstrumentation: typeof __ensureInstrumentation;
   fetch(request: Request, env?: WorkerAssetEnv, ctx?: ExecutionContextLike & VinextRequestStageContext): Promise<Response>;
 };
-//#endregion
 export { _default as default };

package/dist/server/app-router-entry.js

@@ -1,24 +1,24 @@
 import { VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_REVALIDATE_HOST_HEADER } from "../utils/protocol-headers.js";
 import "./app-rsc-vary.js";
-import { VINEXT_CACHEABILITY_PROBE_QUERY_PARAM } from "./headers.js";
-import { badRequestResponse, notFoundResponse, notFoundStaticAssetResponse } from "./http-error-responses.js";
-import { cloneRequestWithHeaders, cloneRequestWithUrl, filterInternalHeaders, guardProtocolRelativeUrl } from "./request-pipeline.js";
-import { assetPrefixPathname, isNextStaticPath } from "../utils/asset-prefix.js";
-import { runWithExecutionContext } from "../shims/request-context.js";
 import "./server-globals.js";
+import { runWithExecutionContext } from "../shims/request-context.js";
 import { getCdnCacheAdapter } from "../shims/cdn-cache.js";
 import { applyCdnResponseIdentityHeaders, validateCdnRequest } from "./cache-control.js";
 import { readImageOptimizationSignal } from "./image-optimization.js";
-import { traceFrameworkRequest } from "./request-tracing.js";
 import { createStaticAssetRequest, resolveStaticAssetSignal } from "./worker-utils.js";
-import { readTrustedPrerenderRouteParams, serializePrerenderRouteParamsHeader } from "./prerender-route-params.js";
 import { resolveClientBuildFile } from "./client-build-files.js";
+import { cloneRequestWithHeaders, cloneRequestWithUrl, filterInternalHeaders, guardProtocolRelativeUrl } from "./request-pipeline.js";
+import { VINEXT_CACHEABILITY_PROBE_QUERY_PARAM } from "./headers.js";
+import { readTrustedPrerenderRouteParams, serializePrerenderRouteParamsHeader } from "./prerender-route-params.js";
+import { badRequestResponse, notFoundResponse, notFoundStaticAssetResponse } from "./http-error-responses.js";
+import { assetPrefixPathname, isNextStaticPath } from "../utils/asset-prefix.js";
 import { createWorkerRevalidationContext } from "./worker-revalidation-context.js";
 import { createWorkerPrerenderDiscoveryContext, createWorkerPrerenderReadinessResponse } from "./worker-prerender-discovery.js";
+import { traceFrameworkRequest } from "./request-tracing.js";
 import { registerConfiguredImageOptimizer } from "virtual:vinext-image-adapters";
 import { registerConfiguredCacheAdapters } from "virtual:vinext-cache-adapters";
 import rscHandler, { __assetPrefix, __basePath, __cacheabilityManifest, __clientBuildFiles, __ensureHybridPagesApplication, __ensureInstrumentation, __imageAllowedWidths, __imageConfig, __prerenderSecret } from "virtual:vinext-rsc-entry";
-//#region src/server/app-router-entry.ts
+// src/server/app-router-entry.ts
 const __workerBasePath = typeof __basePath === "string" ? __basePath : "";
 const __workerClientBuildFiles = new Set(Array.isArray(__clientBuildFiles) ? __clientBuildFiles : []);
 const __workerAssetPathPrefix = assetPrefixPathname(typeof __assetPrefix === "string" ? __assetPrefix : "");
@@ -134,5 +134,4 @@ async function handleRequest(request, env, platformCtx) {
 	const response = new Response(String(result), { status: 200 });
 	return finalizeCacheabilityResponse ? finalizeCacheabilityResponse(response, ctx) : response;
 }
-//#endregion
 export { app_router_entry_default as default };

package/dist/server/app-rsc-cache-busting.d.ts

@@ -1,7 +1,6 @@
+import { AppRscStateFingerprintInput } from "./app-rsc-state-fingerprint.js";
 import { AppRscRenderMode } from "./app-rsc-render-mode.js";
 import { VINEXT_RSC_RENDER_MODE_HEADER, VINEXT_RSC_VARY_HEADER } from "./app-rsc-vary.js";
-import { AppRscStateFingerprintInput } from "./app-rsc-state-fingerprint.js";
-//#region src/server/app-rsc-cache-busting.d.ts
 /**
  * RSC cache-busting hashes cover the headers that make an RSC payload vary.
  * Client-side variant headers must survive transit through CDNs and reverse
@@ -119,5 +118,4 @@ export declare function createCanonicalRscRequestUrl(href: string): string;
 export declare function createServerActionRequestUrl(href: string): string;
 export declare function createRscRedirectLocation(location: string, request: Request): Promise<string>;
 export declare function resolveInvalidRscCacheBustingRequest(options: ResolveInvalidRscCacheBustingRequestOptions): Promise<Response | null>;
-//#endregion
 export { VINEXT_RSC_RENDER_MODE_HEADER, VINEXT_RSC_VARY_HEADER };

package/dist/server/app-rsc-cache-busting.js

@@ -1,10 +1,10 @@
 import { NEXT_ROUTER_PREFETCH_HEADER, NEXT_ROUTER_SEGMENT_PREFETCH_HEADER, NEXT_ROUTER_STATE_TREE_HEADER, NEXT_URL_HEADER, VINEXT_INTERCEPTION_CONTEXT_HEADER, VINEXT_INTERCEPTION_ID_HEADER, VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_RSC_RENDER_MODE_HEADER, VINEXT_RSC_STATE_FINGERPRINT_HEADER, VINEXT_RSC_VARY_HEADER } from "./app-rsc-vary.js";
-import { NEXTJS_DEPLOYMENT_ID_HEADER, VINEXT_MOUNTED_LAYOUTS_HEADER } from "./headers.js";
-import { APP_RSC_RENDER_MODE_PREFETCH_LOADING_SHELL, parseAppRscRenderMode } from "./app-rsc-render-mode.js";
 import { fnv1a64 } from "../utils/hash.js";
-import { applyDeploymentIdHeader, getDeploymentId } from "../utils/deployment-id.js";
 import { createAppRscStateFingerprint } from "./app-rsc-state-fingerprint.js";
-//#region src/server/app-rsc-cache-busting.ts
+import { APP_RSC_RENDER_MODE_PREFETCH_LOADING_SHELL, parseAppRscRenderMode } from "./app-rsc-render-mode.js";
+import { NEXTJS_DEPLOYMENT_ID_HEADER, VINEXT_MOUNTED_LAYOUTS_HEADER } from "./headers.js";
+import { applyDeploymentIdHeader, getDeploymentId } from "../utils/deployment-id.js";
+// src/server/app-rsc-cache-busting.ts
 /**
 * RSC cache-busting hashes cover the headers that make an RSC payload vary.
 * Client-side variant headers must survive transit through CDNs and reverse
@@ -296,5 +296,4 @@ async function resolveInvalidRscCacheBustingRequest(options) {
 		headers: { Location: formatRscRequestPath(url) }
 	});
 }
-//#endregion
 export { VINEXT_RSC_BUILD_ID_HEADER, VINEXT_RSC_CACHE_BUSTING_SEARCH_PARAM, VINEXT_RSC_COMPATIBILITY_ID_HEADER, VINEXT_RSC_CONTENT_TYPE, VINEXT_RSC_RENDER_MODE_HEADER, VINEXT_RSC_VARY_HEADER, applyRscCompatibilityIdHeader, applyRscDeploymentIdHeader, canonicalizeDynamicShellRscRequestHeaders, canonicalizeLoadingShellRscRequestHeaders, canonicalizePrewarmableRscRequestHeaders, computeRscCacheBustingSearchParam, createCanonicalLoadingShellRscRequestHeaders, createCanonicalRscRequestHeaders, createCanonicalRscRequestUrl, createRscRedirectLocation, createRscRequestHeaders, createRscRequestUrl, createServerActionRequestUrl, formatRscRequestPath, getVinextRscCompatibilityId, hasRscCacheBustingSearchParam, isRscCompatibilityIdCompatible, keepOnlyValidatedRscCacheBustingSearchParam, parseRscRequestPath, resolveHardNavigationTargetFromRscResponse, resolveInvalidRscCacheBustingRequest, resolveRscCompatibilityNavigationDecision, setRscCacheBustingSearchParam, stripRscCacheBustingSearchParam, toPathAbsolutePathname };

package/dist/server/app-rsc-combined-handler.d.ts

@@ -1,9 +1,7 @@
-import { VinextResponseStageDispatchOptions } from "./multi-stage.js";
-import { AppWorkerResponseStageProps } from "./app-worker-stages.js";
 import { AppRscHandlerRoute, AppRscRequestHandler, CreateAppRscHandlerOptions } from "./app-rsc-handler.js";
-//#region src/server/app-rsc-combined-handler.d.ts
+import { AppWorkerResponseStageProps } from "./app-worker-stages.js";
+import { VinextResponseStageDispatchOptions } from "./multi-stage.js";
 export type AppRscHandler = AppRscRequestHandler & {
   handleResponseStage(request: Request, ctx: unknown, props: AppWorkerResponseStageProps, options?: VinextResponseStageDispatchOptions): Promise<Response>;
 };
-export declare function createAppRscHandler<TRoute extends AppRscHandlerRoute>(options: CreateAppRscHandlerOptions<TRoute>): AppRscHandler;
-//#endregion
+export declare function createAppRscHandler<TRoute extends AppRscHandlerRoute>(options: CreateAppRscHandlerOptions<TRoute>): AppRscHandler;

package/dist/server/app-rsc-combined-handler.js

@@ -1,8 +1,8 @@
-import { getRequestExecutionContext, runWithExecutionContext } from "../shims/request-context.js";
-import { createWorkerRevalidationContext } from "./worker-revalidation-context.js";
 import { createAppRscRequestHandler } from "./app-rsc-handler.js";
 import { resolveSrvxMiddlewareOrigin } from "./srvx-middleware-origin.js";
-//#region src/server/app-rsc-combined-handler.ts
+import { createWorkerRevalidationContext } from "./worker-revalidation-context.js";
+import { getRequestExecutionContext, runWithExecutionContext } from "../shims/request-context.js";
+// src/server/app-rsc-combined-handler.ts
 /** Combined request/response handler used by default single-stage App entries. */
 function createAppRscHandler(options) {
 	const appRscRequestHandler = createAppRscRequestHandler(options);
@@ -15,5 +15,4 @@ function createAppRscHandler(options) {
 		return import("./app-rsc-response-stage.js").then(({ renderAppWorkerResponseStage }) => renderAppWorkerResponseStage(options, request, ctx, props, stageOptions));
 	} });
 }
-//#endregion
 export { createAppRscHandler };

package/dist/server/app-rsc-embedded-chunks.d.ts

@@ -1,7 +1,5 @@
-//#region src/server/app-rsc-embedded-chunks.d.ts
 export declare const RSC_EMBEDDED_BINARY_CHUNK = 3;
 export type RscEmbeddedChunk = string | [typeof RSC_EMBEDDED_BINARY_CHUNK, string];
 export declare function bytesToBase64(bytes: Uint8Array): string;
 export declare function decodeRscEmbeddedChunk(chunk: RscEmbeddedChunk): Uint8Array;
-export declare function concatUint8Arrays(chunks: readonly Uint8Array[]): Uint8Array<ArrayBuffer>;
-//#endregion
+export declare function concatUint8Arrays(chunks: readonly Uint8Array[]): Uint8Array<ArrayBuffer>;

package/dist/server/app-rsc-embedded-chunks.js

@@ -1,4 +1,4 @@
-//#region src/server/app-rsc-embedded-chunks.ts
+// src/server/app-rsc-embedded-chunks.ts
 const RSC_EMBEDDED_BINARY_CHUNK = 3;
 const BASE64_CHUNK_SIZE = 32768;
 const textEncoder = new TextEncoder();
@@ -28,5 +28,4 @@ function concatUint8Arrays(chunks) {
 	}
 	return result;
 }
-//#endregion
 export { RSC_EMBEDDED_BINARY_CHUNK, bytesToBase64, concatUint8Arrays, decodeRscEmbeddedChunk };

package/dist/server/app-rsc-error-handler.d.ts

@@ -1,4 +1,3 @@
-//#region src/server/app-rsc-error-handler.d.ts
 type ReportRequestError = (error: unknown, requestInfo: {
   path: string;
   method: string;
@@ -24,5 +23,4 @@ export type AppRenderErrorContextOverrides = {
  * each request already logged, keyed weakly by its `Request`.
  */
 export declare function createAppRscOnErrorHandler(reportRequestError: ReportRequestError, request: Request, pathname: string, routePath: string, overrides?: AppRenderErrorContextOverrides): (error: unknown) => string | undefined;
-//#endregion
 export {};

package/dist/server/app-rsc-error-handler.js

@@ -1,8 +1,8 @@
 import "../utils/protocol-headers.js";
+import { createRscOnErrorHandler } from "./app-rsc-errors.js";
 import "./app-rsc-vary.js";
 import { isOnDemandRevalidateRequest } from "./revalidation-request.js";
-import { createRscOnErrorHandler } from "./app-rsc-errors.js";
-//#region src/server/app-rsc-error-handler.ts
+// src/server/app-rsc-error-handler.ts
 const loggedErrorsByRequest = /* @__PURE__ */ new WeakMap();
 /**
 * Build a per-request RSC error handler that extracts request metadata from
@@ -41,5 +41,4 @@ function createAppRscOnErrorHandler(reportRequestError, request, pathname, route
 		requestInfo
 	});
 }
-//#endregion
 export { createAppRscOnErrorHandler };

package/dist/server/app-rsc-errors.d.ts

@@ -1,4 +1,3 @@
-//#region src/server/app-rsc-errors.d.ts
 type RscRequestInfo = {
   path: string;
   method: string;
@@ -54,5 +53,4 @@ export declare function errorDigest(input: string): string;
 export declare const PRODUCTION_SERVER_COMPONENTS_ERROR_MESSAGE = "Minified React error #441; visit https://react.dev/errors/441 for the full message or use the non-minified dev environment for full errors and additional helpful warnings.";
 export declare function sanitizeErrorForClient(error: unknown, nodeEnv?: "development" | "production" | "test"): unknown;
 export declare function createRscOnErrorHandler(options: CreateRscOnErrorHandlerOptions): (error: unknown) => string | undefined;
-//#endregion
 export {};

package/dist/server/app-rsc-errors.js

@@ -1,10 +1,10 @@
-import { isNavigationSignalError } from "../utils/navigation-signal.js";
-import { logRequestError } from "./request-error-log.js";
-import { rewriteClientHookError } from "../shims/client-hook-error.js";
 import { resolveAppPageSpecialError } from "./app-page-execution.js";
+import { isNavigationSignalError } from "../utils/navigation-signal.js";
 import { isAppRenderAbortError } from "./app-render-abort-error.js";
 import { getProperError } from "./proper-error.js";
-//#region src/server/app-rsc-errors.ts
+import { logRequestError } from "./request-error-log.js";
+import { rewriteClientHookError } from "../shims/client-hook-error.js";
+// src/server/app-rsc-errors.ts
 const ORIGINAL_SERVER_ERROR = Symbol.for("vinext.originalServerError");
 function hasDigest(error) {
 	return Boolean(error && typeof error === "object" && "digest" in error);
@@ -101,5 +101,4 @@ function createRscOnErrorHandler(options) {
 		return digest;
 	};
 }
-//#endregion
 export { PRODUCTION_SERVER_COMPONENTS_ERROR_MESSAGE, createRscOnErrorHandler, errorDigest, getDigestForWellKnownError, hasDigest, sanitizeErrorForClient };

package/dist/server/app-rsc-handler.d.ts

@@ -1,19 +1,18 @@
-import { VinextCacheabilityProbeMode } from "./multi-stage.js";
 import { NextHeader, NextI18nConfig, NextRedirect, NextRewrite } from "../config/next-config.js";
-import { AppRscRenderMode } from "./app-rsc-render-mode.js";
-import { ImageConfig } from "./image-optimization.js";
 import { ExecutionContextLike } from "../shims/request-context.js";
-import { AppMiddlewareContext, ApplyAppMiddlewareResult } from "./app-middleware.js";
 import { RootParams } from "../shims/root-params.js";
-import { AppPagePprFallbackCacheShell } from "./app-ppr-fallback-shell.js";
+import { AppMiddlewareContext, ApplyAppMiddlewareResult } from "./app-middleware.js";
+import { AppPrerenderRootParamNamesMap, AppPrerenderStaticParamsMap } from "./app-prerender-endpoints.js";
 import { AppPageNavigationParamSlot } from "./app-page-navigation-params.js";
 import { PagesRouteDataKind } from "./pages-route-data-kind.js";
-import { AppPrerenderRootParamNamesMap, AppPrerenderStaticParamsMap } from "./app-prerender-endpoints.js";
+import { ImageConfig } from "./image-optimization.js";
+import { AppRscRenderMode } from "./app-rsc-render-mode.js";
+import { AppPagePprFallbackCacheShell } from "./app-ppr-fallback-shell.js";
 import { TrustedPrerenderState } from "./prerender-route-params.js";
 import { AppRouteTreePrefetchRoute, PrefetchInliningConfig } from "./app-route-tree-prefetch.js";
 import { DispatchAppWorkerResponseStage, RenderAppWorkerResponseStageLocally } from "./app-worker-stages.js";
+import { VinextCacheabilityProbeMode } from "./multi-stage.js";
 import { ReactFormState } from "react-dom/client";
-//#region src/server/app-rsc-handler.d.ts
 type AppPageParams = Record<string, string | string[]>;
 type StaticParamsMap = AppPrerenderStaticParamsMap;
 type RootParamNamesMap = AppPrerenderRootParamNamesMap;
@@ -86,6 +85,11 @@ type DispatchMatchedPageOptions<TRoute> = {
     routePattern: string;
   };
   renderedConcreteUrlPaths?: ReadonlySet<string>;
+  /**
+   * Called on a dynamicParams = false miss. When it returns true, routing
+   * resumes with the fallback rewrites, so the miss renders no 404.
+   */
+  resumeRoutingAfterMiss?: () => boolean;
   skipStaticParamsValidation?: boolean;
   staticParamsValidationParams?: AppPageParams;
   rootParams?: RootParams;
@@ -114,6 +118,13 @@ type DispatchMatchedRouteHandlerOptions<TRoute> = {
    * matched params object.
    */
   params: AppPageParams | null;
+  /** Render the not-found page Next.js serves for an unmatched URL. */
+  renderNotFound: () => Promise<Response>;
+  /**
+   * Called on a dynamicParams = false miss. When it returns true, routing
+   * resumes with the fallback rewrites, so the miss renders no 404.
+   */
+  resumeRoutingAfterMiss?: () => boolean;
   request: Request;
   route: TRoute;
   searchParams: URLSearchParams;
@@ -231,6 +242,12 @@ export type CreateAppRscHandlerOptions<TRoute extends AppRscHandlerRoute> = {
    * dedup'd. Provided by the generated RSC entry; absent in older entries.
    */
   ensureRouteLoaded?: (route: TRoute) => unknown;
+  /**
+   * Whether a loaded page rejects these params under `dynamicParams = false`.
+   * Absent in the request-only stage, which has no route modules and sends
+   * route tree prefetches to the full graph.
+   */
+  isDynamicParamsMiss?: (route: TRoute, params: AppPageParams) => Promise<boolean>;
   ensureInstrumentation?: (ctx: ExecutionContextLike | null) => Promise<void>;
   /**
    * Register cache adapters configured via the vinext() `cache` option. Wired
@@ -276,5 +293,4 @@ export type CreateAppRscHandlerOptions<TRoute extends AppRscHandlerRoute> = {
 export type AppRscRequestHandler = (request: Request, ctx: unknown, allowInternalRscDocumentFallback?: boolean, dispatchResponseStage?: DispatchAppWorkerResponseStage, responseStageProbeMode?: VinextCacheabilityProbeMode | null, trustedPrerenderState?: TrustedPrerenderState | null) => Promise<Response>;
 /** Build the request-only handler without retaining the response renderer graph. */
 export declare function createAppRscRequestHandler<TRoute extends AppRscHandlerRoute>(options: CreateAppRscHandlerOptions<TRoute>): AppRscRequestHandler;
-//#endregion
 export {};