vinext 0.0.45 → 0.0.47

package/dist/server/app-prerender-endpoints.js

@@ -0,0 +1,96 @@
+import { callAppPrerenderStaticParams } from "./app-prerender-static-params.js";
+//#region src/server/app-prerender-endpoints.ts
+const STATIC_PARAMS_ENDPOINT = "/__vinext/prerender/static-params";
+const PAGES_STATIC_PATHS_ENDPOINT = "/__vinext/prerender/pages-static-paths";
+const JSON_HEADERS = { "content-type": "application/json" };
+async function handleAppPrerenderEndpoint(request, options) {
+	if (options.pathname === STATIC_PARAMS_ENDPOINT) return handleStaticParamsEndpoint(request, options);
+	if (options.pathname === PAGES_STATIC_PATHS_ENDPOINT) {
+		if (!options.loadPagesRoutes) return null;
+		return handlePagesStaticPathsEndpoint(request, options);
+	}
+	return null;
+}
+async function handleStaticParamsEndpoint(request, options) {
+	if (!isEnabled(options)) return new Response("Not Found", { status: 404 });
+	const url = new URL(request.url);
+	const pattern = url.searchParams.get("pattern");
+	if (!pattern) return new Response("missing pattern", { status: 400 });
+	const generateStaticParams = options.staticParamsMap[pattern];
+	if (typeof generateStaticParams !== "function") return jsonNullResponse();
+	try {
+		return jsonResponse(await callAppPrerenderStaticParams({
+			fn: generateStaticParams,
+			params: parseParentParams(url.searchParams.get("parentParams")),
+			pattern,
+			rootParamNamesByPattern: options.rootParamNamesByPattern ?? {}
+		}));
+	} catch (error) {
+		return jsonResponse({ error: String(error) }, 500);
+	}
+}
+async function handlePagesStaticPathsEndpoint(request, options) {
+	if (!isEnabled(options)) return new Response("Not Found", { status: 404 });
+	const url = new URL(request.url);
+	const pattern = url.searchParams.get("pattern");
+	if (!pattern) return new Response("missing pattern", { status: 400 });
+	try {
+		const getStaticPaths = findPageRoute(await options.loadPagesRoutes?.(), pattern)?.module?.getStaticPaths;
+		if (typeof getStaticPaths !== "function") return jsonNullResponse();
+		return jsonResponse(await getStaticPaths({
+			locales: parseLocales(url.searchParams.get("locales")),
+			defaultLocale: url.searchParams.get("defaultLocale") ?? ""
+		}));
+	} catch (error) {
+		return jsonResponse({ error: String(error) }, 500);
+	}
+}
+function isEnabled(options) {
+	return options.isPrerenderEnabled?.() ?? false;
+}
+function jsonResponse(body, status = 200) {
+	return new Response(JSON.stringify(body), {
+		headers: JSON_HEADERS,
+		status
+	});
+}
+function jsonNullResponse() {
+	return new Response("null", {
+		headers: JSON_HEADERS,
+		status: 200
+	});
+}
+function parseParentParams(raw) {
+	if (!raw) return {};
+	const value = JSON.parse(raw);
+	if (!isPlainObject(value)) return {};
+	const params = {};
+	for (const [key, paramValue] of Object.entries(value)) if (typeof paramValue === "string" || paramValue === void 0 || isStringArray(paramValue)) params[key] = paramValue;
+	return params;
+}
+function parseLocales(raw) {
+	if (!raw) return [];
+	const value = JSON.parse(raw);
+	if (!Array.isArray(value)) return [];
+	return value.filter((locale) => typeof locale === "string");
+}
+function findPageRoute(value, pattern) {
+	if (!Array.isArray(value)) return void 0;
+	for (const route of value) if (isPageRoute(route) && route.pattern === pattern) return route;
+}
+function isPageRoute(value) {
+	if (!isPlainObject(value) || typeof value.pattern !== "string") return false;
+	if (value.module === void 0) return true;
+	if (!isPlainObject(value.module)) return false;
+	return value.module.getStaticPaths === void 0 || typeof value.module.getStaticPaths === "function";
+}
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isStringArray(value) {
+	return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+//#endregion
+export { handleAppPrerenderEndpoint };
+
+//# sourceMappingURL=app-prerender-endpoints.js.map

package/dist/server/app-prerender-endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-prerender-endpoints.js","names":[],"sources":["../../src/server/app-prerender-endpoints.ts"],"sourcesContent":["import { callAppPrerenderStaticParams } from \"./app-prerender-static-params.js\";\nimport type { RootParams } from \"vinext/shims/root-params\";\n\ntype GenerateStaticParams = (args: { params: RootParams }) => unknown;\n\ntype AppPrerenderStaticParamsMap = Record<string, GenerateStaticParams | null | undefined>;\ntype RootParamNamesMap = Record<string, readonly string[] | undefined>;\n\ntype AppPrerenderPageRoute = {\n  pattern: string;\n  module?: {\n    getStaticPaths?: (opts: { locales: string[]; defaultLocale: string }) => unknown;\n  };\n};\n\ntype HandleAppPrerenderEndpointOptions = {\n  isPrerenderEnabled?: () => boolean;\n  loadPagesRoutes?: () => Promise<unknown>;\n  pathname: string;\n  rootParamNamesByPattern?: RootParamNamesMap;\n  staticParamsMap: AppPrerenderStaticParamsMap;\n};\n\nconst STATIC_PARAMS_ENDPOINT = \"/__vinext/prerender/static-params\";\nconst PAGES_STATIC_PATHS_ENDPOINT = \"/__vinext/prerender/pages-static-paths\";\nconst JSON_HEADERS = { \"content-type\": \"application/json\" };\n\nexport async function handleAppPrerenderEndpoint(\n  request: Request,\n  options: HandleAppPrerenderEndpointOptions,\n): Promise<Response | null> {\n  if (options.pathname === STATIC_PARAMS_ENDPOINT) {\n    return handleStaticParamsEndpoint(request, options);\n  }\n\n  if (options.pathname === PAGES_STATIC_PATHS_ENDPOINT) {\n    if (!options.loadPagesRoutes) return null;\n    return handlePagesStaticPathsEndpoint(request, options);\n  }\n\n  return null;\n}\n\nasync function handleStaticParamsEndpoint(\n  request: Request,\n  options: HandleAppPrerenderEndpointOptions,\n): Promise<Response> {\n  if (!isEnabled(options)) {\n    return new Response(\"Not Found\", { status: 404 });\n  }\n\n  const url = new URL(request.url);\n  const pattern = url.searchParams.get(\"pattern\");\n  if (!pattern) return new Response(\"missing pattern\", { status: 400 });\n\n  const generateStaticParams = options.staticParamsMap[pattern];\n  if (typeof generateStaticParams !== \"function\") {\n    return jsonNullResponse();\n  }\n\n  try {\n    const params = parseParentParams(url.searchParams.get(\"parentParams\"));\n    const result = await callAppPrerenderStaticParams({\n      fn: generateStaticParams,\n      params,\n      pattern,\n      rootParamNamesByPattern: options.rootParamNamesByPattern ?? {},\n    });\n    return jsonResponse(result);\n  } catch (error) {\n    return jsonResponse({ error: String(error) }, 500);\n  }\n}\n\nasync function handlePagesStaticPathsEndpoint(\n  request: Request,\n  options: HandleAppPrerenderEndpointOptions,\n): Promise<Response> {\n  if (!isEnabled(options)) {\n    return new Response(\"Not Found\", { status: 404 });\n  }\n\n  const url = new URL(request.url);\n  const pattern = url.searchParams.get(\"pattern\");\n  if (!pattern) return new Response(\"missing pattern\", { status: 400 });\n\n  try {\n    const pageRoutes = await options.loadPagesRoutes?.();\n    const route = findPageRoute(pageRoutes, pattern);\n    const getStaticPaths = route?.module?.getStaticPaths;\n    if (typeof getStaticPaths !== \"function\") {\n      return jsonNullResponse();\n    }\n\n    const locales = parseLocales(url.searchParams.get(\"locales\"));\n    const defaultLocale = url.searchParams.get(\"defaultLocale\") ?? \"\";\n    const result = await getStaticPaths({ locales, defaultLocale });\n    return jsonResponse(result);\n  } catch (error) {\n    return jsonResponse({ error: String(error) }, 500);\n  }\n}\n\nfunction isEnabled(options: HandleAppPrerenderEndpointOptions): boolean {\n  return options.isPrerenderEnabled?.() ?? false;\n}\n\nfunction jsonResponse(body: unknown, status = 200): Response {\n  return new Response(JSON.stringify(body), {\n    headers: JSON_HEADERS,\n    status,\n  });\n}\n\nfunction jsonNullResponse(): Response {\n  return new Response(\"null\", {\n    headers: JSON_HEADERS,\n    status: 200,\n  });\n}\n\nfunction parseParentParams(raw: string | null): RootParams {\n  if (!raw) return {};\n\n  const value = JSON.parse(raw);\n  if (!isPlainObject(value)) return {};\n\n  const params: RootParams = {};\n  for (const [key, paramValue] of Object.entries(value)) {\n    if (typeof paramValue === \"string\" || paramValue === undefined || isStringArray(paramValue)) {\n      params[key] = paramValue;\n    }\n  }\n  return params;\n}\n\nfunction parseLocales(raw: string | null): string[] {\n  if (!raw) return [];\n\n  const value = JSON.parse(raw);\n  if (!Array.isArray(value)) return [];\n\n  return value.filter((locale) => typeof locale === \"string\");\n}\n\nfunction findPageRoute(value: unknown, pattern: string): AppPrerenderPageRoute | undefined {\n  if (!Array.isArray(value)) return undefined;\n\n  for (const route of value) {\n    if (isPageRoute(route) && route.pattern === pattern) {\n      return route;\n    }\n  }\n\n  return undefined;\n}\n\nfunction isPageRoute(value: unknown): value is AppPrerenderPageRoute {\n  if (!isPlainObject(value) || typeof value.pattern !== \"string\") return false;\n  if (value.module === undefined) return true;\n  if (!isPlainObject(value.module)) return false;\n\n  return (\n    value.module.getStaticPaths === undefined || typeof value.module.getStaticPaths === \"function\"\n  );\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isStringArray(value: unknown): value is string[] {\n  return Array.isArray(value) && value.every((item) => typeof item === \"string\");\n}\n"],"mappings":"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"}

package/dist/server/app-prerender-static-params.d.ts

@@ -0,0 +1,16 @@
+import { RootParams } from "../shims/root-params.js";
+
+//#region src/server/app-prerender-static-params.d.ts
+type GenerateStaticParamsFunction = (input: {
+  params: RootParams;
+}) => unknown;
+type CallAppPrerenderStaticParamsOptions = {
+  fn: GenerateStaticParamsFunction;
+  params: RootParams;
+  pattern: string;
+  rootParamNamesByPattern: Record<string, readonly string[] | undefined>;
+};
+declare function callAppPrerenderStaticParams(options: CallAppPrerenderStaticParamsOptions): Promise<unknown>;
+//#endregion
+export { callAppPrerenderStaticParams };
+//# sourceMappingURL=app-prerender-static-params.d.ts.map

package/dist/server/app-prerender-static-params.js

@@ -0,0 +1,14 @@
+import { pickRootParams, setRootParams } from "../shims/root-params.js";
+//#region src/server/app-prerender-static-params.ts
+async function callAppPrerenderStaticParams(options) {
+	setRootParams(pickRootParams(options.params, options.rootParamNamesByPattern[options.pattern]));
+	try {
+		return await options.fn({ params: options.params });
+	} finally {
+		setRootParams(null);
+	}
+}
+//#endregion
+export { callAppPrerenderStaticParams };
+
+//# sourceMappingURL=app-prerender-static-params.js.map

package/dist/server/app-prerender-static-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-prerender-static-params.js","names":[],"sources":["../../src/server/app-prerender-static-params.ts"],"sourcesContent":["import { pickRootParams, setRootParams, type RootParams } from \"vinext/shims/root-params\";\n\ntype GenerateStaticParamsFunction = (input: { params: RootParams }) => unknown;\n\ntype CallAppPrerenderStaticParamsOptions = {\n  fn: GenerateStaticParamsFunction;\n  params: RootParams;\n  pattern: string;\n  rootParamNamesByPattern: Record<string, readonly string[] | undefined>;\n};\n\nexport async function callAppPrerenderStaticParams(\n  options: CallAppPrerenderStaticParamsOptions,\n): Promise<unknown> {\n  setRootParams(pickRootParams(options.params, options.rootParamNamesByPattern[options.pattern]));\n  try {\n    return await options.fn({ params: options.params });\n  } finally {\n    setRootParams(null);\n  }\n}\n"],"mappings":";;AAWA,eAAsB,6BACpB,SACkB;AAClB,eAAc,eAAe,QAAQ,QAAQ,QAAQ,wBAAwB,QAAQ,SAAS,CAAC;AAC/F,KAAI;AACF,SAAO,MAAM,QAAQ,GAAG,EAAE,QAAQ,QAAQ,QAAQ,CAAC;WAC3C;AACR,gBAAc,KAAK"}

package/dist/server/app-request-context.d.ts

@@ -0,0 +1,22 @@
+import { NavigationContext } from "../shims/navigation.js";
+
+//#region src/server/app-request-context.d.ts
+/**
+ * Set navigation context in the ALS-backed store. "use client" components
+ * rendered during SSR need the pathname/searchParams/params but the SSR
+ * environment has a separate module instance of next/navigation.
+ *
+ * Clearing nav context (ctx === null) also clears root params.
+ */
+declare function setAppNavigationContext(ctx: NavigationContext | null): void;
+/**
+ * Clear all per-request ALS state owned by the App Router handler.
+ * Must be called before returning a non-page response (redirect, public
+ * file proxy, etc.) to prevent state leaking between requests on Workers.
+ *
+ * Clears: headers, navigation context, root params.
+ */
+declare function clearAppRequestContext(): void;
+//#endregion
+export { clearAppRequestContext, setAppNavigationContext };
+//# sourceMappingURL=app-request-context.d.ts.map

package/dist/server/app-request-context.js

@@ -0,0 +1,30 @@
+import { setHeadersContext } from "../shims/headers.js";
+import { setNavigationContext } from "../shims/navigation.js";
+import { setRootParams } from "../shims/root-params.js";
+//#region src/server/app-request-context.ts
+/**
+* Set navigation context in the ALS-backed store. "use client" components
+* rendered during SSR need the pathname/searchParams/params but the SSR
+* environment has a separate module instance of next/navigation.
+*
+* Clearing nav context (ctx === null) also clears root params.
+*/
+function setAppNavigationContext(ctx) {
+	setNavigationContext(ctx);
+	if (ctx === null) setRootParams(null);
+}
+/**
+* Clear all per-request ALS state owned by the App Router handler.
+* Must be called before returning a non-page response (redirect, public
+* file proxy, etc.) to prevent state leaking between requests on Workers.
+*
+* Clears: headers, navigation context, root params.
+*/
+function clearAppRequestContext() {
+	setHeadersContext(null);
+	setAppNavigationContext(null);
+}
+//#endregion
+export { clearAppRequestContext, setAppNavigationContext };
+
+//# sourceMappingURL=app-request-context.js.map

package/dist/server/app-request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-request-context.js","names":[],"sources":["../../src/server/app-request-context.ts"],"sourcesContent":["import { setHeadersContext } from \"vinext/shims/headers\";\nimport {\n  setNavigationContext as setNavigationContextOrig,\n  type NavigationContext,\n} from \"vinext/shims/navigation\";\nimport { setRootParams } from \"vinext/shims/root-params\";\n\n/**\n * Set navigation context in the ALS-backed store. \"use client\" components\n * rendered during SSR need the pathname/searchParams/params but the SSR\n * environment has a separate module instance of next/navigation.\n *\n * Clearing nav context (ctx === null) also clears root params.\n */\nexport function setAppNavigationContext(ctx: NavigationContext | null): void {\n  setNavigationContextOrig(ctx);\n  if (ctx === null) setRootParams(null);\n}\n\n/**\n * Clear all per-request ALS state owned by the App Router handler.\n * Must be called before returning a non-page response (redirect, public\n * file proxy, etc.) to prevent state leaking between requests on Workers.\n *\n * Clears: headers, navigation context, root params.\n */\nexport function clearAppRequestContext(): void {\n  setHeadersContext(null);\n  setAppNavigationContext(null);\n}\n"],"mappings":";;;;;;;;;;;AAcA,SAAgB,wBAAwB,KAAqC;AAC3E,sBAAyB,IAAI;AAC7B,KAAI,QAAQ,KAAM,eAAc,KAAK;;;;;;;;;AAUvC,SAAgB,yBAA+B;AAC7C,mBAAkB,KAAK;AACvB,yBAAwB,KAAK"}

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

@@ -1,5 +1,6 @@
 import { NextI18nConfig } from "../config/next-config.js";
 import { ISRCacheEntry } from "./isr-cache.js";
+import { HeadersAccessPhase } from "../shims/headers.js";
 import { RouteHandlerMiddlewareContext } from "./app-route-handler-response.js";
 import { AppRouteDebugLogger, AppRouteDynamicUsageFn, AppRouteHandlerFunction, AppRouteParams, MarkAppRouteDynamicUsageFn, RouteHandlerCacheSetter } from "./app-route-handler-execution.js";
 
@@ -13,6 +14,7 @@ type ReadAppRouteHandlerCacheOptions = {
   cleanPathname: string;
   clearRequestContext: () => void;
   consumeDynamicUsage: AppRouteDynamicUsageFn;
+  dynamicConfig?: string;
   getCollectedFetchTags: () => string[];
   handlerFn: AppRouteHandlerFunction;
   i18n?: NextI18nConfig | null;
@@ -26,10 +28,12 @@ type ReadAppRouteHandlerCacheOptions = {
   params: AppRouteParams;
   requestUrl: string;
   revalidateSearchParams: URLSearchParams;
+  expireSeconds?: number;
   revalidateSeconds: number;
   routePattern: string;
   runInRevalidationContext: RouteHandlerRevalidationContextRunner;
   scheduleBackgroundRegeneration: RouteHandlerBackgroundRegenerator;
+  setHeadersAccessPhase: (phase: HeadersAccessPhase) => HeadersAccessPhase;
   setNavigationContext: (context: {
     pathname: string;
     searchParams: URLSearchParams;

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

@@ -1,5 +1,5 @@
-import { applyRouteHandlerMiddlewareContext, buildAppRouteCacheValue, buildRouteHandlerCachedResponse } from "./app-route-handler-response.js";
 import { markKnownDynamicAppRoute } from "./app-route-handler-runtime.js";
+import { applyRouteHandlerMiddlewareContext, assertSupportedAppRouteHandlerResponse, buildAppRouteCacheValue, buildRouteHandlerCachedResponse } from "./app-route-handler-response.js";
 import { runAppRouteHandler } from "./app-route-handler-execution.js";
 //#region src/server/app-route-handler-cache.ts
 function getCachedAppRouteValue(entry) {
@@ -15,6 +15,8 @@ async function readAppRouteHandlerCacheResponse(options) {
 			options.clearRequestContext();
 			return applyRouteHandlerMiddlewareContext(buildRouteHandlerCachedResponse(cachedValue, {
 				cacheState: "HIT",
+				cacheControl: cached?.value.cacheControl,
+				expireSeconds: options.expireSeconds,
 				isHead: options.isAutoHead,
 				revalidateSeconds: options.revalidateSeconds
 			}), options.middlewareContext);
@@ -32,13 +34,17 @@ async function readAppRouteHandlerCacheResponse(options) {
 					const { dynamicUsedInHandler, response } = await runAppRouteHandler({
 						basePath: options.basePath,
 						consumeDynamicUsage: options.consumeDynamicUsage,
+						dynamicConfig: options.dynamicConfig,
 						handlerFn: options.handlerFn,
 						i18n: options.i18n,
 						markDynamicUsage: options.markDynamicUsage,
 						params: options.params,
-						request: new Request(options.requestUrl, { method: "GET" })
+						request: new Request(options.requestUrl, { method: "GET" }),
+						routePattern: options.routePattern,
+						setHeadersAccessPhase: options.setHeadersAccessPhase
 					});
 					options.setNavigationContext(null);
+					assertSupportedAppRouteHandlerResponse(response);
 					if (dynamicUsedInHandler) {
 						markKnownDynamicAppRoute(options.routePattern);
 						options.isrDebug?.("route regen skipped (dynamic usage)", options.cleanPathname);
@@ -46,7 +52,7 @@ async function readAppRouteHandlerCacheResponse(options) {
 					}
 					const routeTags = options.buildPageCacheTags(options.cleanPathname, options.getCollectedFetchTags());
 					const routeCacheValue = await buildAppRouteCacheValue(response);
-					await options.isrSet(routeKey, routeCacheValue, options.revalidateSeconds, routeTags);
+					await options.isrSet(routeKey, routeCacheValue, options.revalidateSeconds, routeTags, options.expireSeconds);
 					options.isrDebug?.("route regen complete", routeKey);
 				});
 			});
@@ -54,6 +60,8 @@ async function readAppRouteHandlerCacheResponse(options) {
 			options.clearRequestContext();
 			return applyRouteHandlerMiddlewareContext(buildRouteHandlerCachedResponse(staleValue, {
 				cacheState: "STALE",
+				cacheControl: cached.value.cacheControl,
+				expireSeconds: options.expireSeconds,
 				isHead: options.isAutoHead,
 				revalidateSeconds: options.revalidateSeconds
 			}), options.middlewareContext);

package/dist/server/app-route-handler-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-route-handler-cache.js","names":[],"sources":["../../src/server/app-route-handler-cache.ts"],"sourcesContent":["import type { NextI18nConfig } from \"../config/next-config.js\";\nimport type { ISRCacheEntry } from \"./isr-cache.js\";\nimport type { RouteHandlerMiddlewareContext } from \"./app-route-handler-response.js\";\nimport {\n  applyRouteHandlerMiddlewareContext,\n  buildAppRouteCacheValue,\n  buildRouteHandlerCachedResponse,\n} from \"./app-route-handler-response.js\";\nimport { markKnownDynamicAppRoute } from \"./app-route-handler-runtime.js\";\nimport {\n  runAppRouteHandler,\n  type AppRouteDebugLogger,\n  type AppRouteDynamicUsageFn,\n  type AppRouteHandlerFunction,\n  type AppRouteParams,\n  type MarkAppRouteDynamicUsageFn,\n  type RouteHandlerCacheSetter,\n} from \"./app-route-handler-execution.js\";\n\ntype RouteHandlerCacheGetter = (key: string) => Promise<ISRCacheEntry | null>;\ntype RouteHandlerBackgroundRegenerator = (key: string, renderFn: () => Promise<void>) => void;\ntype RouteHandlerRevalidationContextRunner = (renderFn: () => Promise<void>) => Promise<void>;\n\ntype ReadAppRouteHandlerCacheOptions = {\n  basePath?: string;\n  buildPageCacheTags: (pathname: string, extraTags: string[]) => string[];\n  cleanPathname: string;\n  clearRequestContext: () => void;\n  consumeDynamicUsage: AppRouteDynamicUsageFn;\n  getCollectedFetchTags: () => string[];\n  handlerFn: AppRouteHandlerFunction;\n  i18n?: NextI18nConfig | null;\n  isAutoHead: boolean;\n  isrDebug?: AppRouteDebugLogger;\n  isrGet: RouteHandlerCacheGetter;\n  isrRouteKey: (pathname: string) => string;\n  isrSet: RouteHandlerCacheSetter;\n  markDynamicUsage: MarkAppRouteDynamicUsageFn;\n  middlewareContext: RouteHandlerMiddlewareContext;\n  params: AppRouteParams;\n  requestUrl: string;\n  revalidateSearchParams: URLSearchParams;\n  revalidateSeconds: number;\n  routePattern: string;\n  runInRevalidationContext: RouteHandlerRevalidationContextRunner;\n  scheduleBackgroundRegeneration: RouteHandlerBackgroundRegenerator;\n  setNavigationContext: (\n    context: {\n      pathname: string;\n      searchParams: URLSearchParams;\n      params: AppRouteParams;\n    } | null,\n  ) => void;\n};\n\nfunction getCachedAppRouteValue(entry: ISRCacheEntry | null) {\n  return entry?.value.value && entry.value.value.kind === \"APP_ROUTE\" ? entry.value.value : null;\n}\n\nexport async function readAppRouteHandlerCacheResponse(\n  options: ReadAppRouteHandlerCacheOptions,\n): Promise<Response | null> {\n  const routeKey = options.isrRouteKey(options.cleanPathname);\n\n  try {\n    const cached = await options.isrGet(routeKey);\n    const cachedValue = getCachedAppRouteValue(cached);\n\n    if (cachedValue && !cached?.isStale) {\n      options.isrDebug?.(\"HIT (route)\", options.cleanPathname);\n      options.clearRequestContext();\n      return applyRouteHandlerMiddlewareContext(\n        buildRouteHandlerCachedResponse(cachedValue, {\n          cacheState: \"HIT\",\n          isHead: options.isAutoHead,\n          revalidateSeconds: options.revalidateSeconds,\n        }),\n        options.middlewareContext,\n      );\n    }\n\n    if (cached?.isStale && cachedValue) {\n      const staleValue = cachedValue;\n      const revalidateSearchParams = new URLSearchParams(options.revalidateSearchParams);\n\n      options.scheduleBackgroundRegeneration(routeKey, async () => {\n        await options.runInRevalidationContext(async () => {\n          options.setNavigationContext({\n            pathname: options.cleanPathname,\n            searchParams: revalidateSearchParams,\n            params: options.params,\n          });\n\n          const { dynamicUsedInHandler, response } = await runAppRouteHandler({\n            basePath: options.basePath,\n            consumeDynamicUsage: options.consumeDynamicUsage,\n            handlerFn: options.handlerFn,\n            i18n: options.i18n,\n            markDynamicUsage: options.markDynamicUsage,\n            params: options.params,\n            request: new Request(options.requestUrl, { method: \"GET\" }),\n          });\n\n          options.setNavigationContext(null);\n\n          if (dynamicUsedInHandler) {\n            markKnownDynamicAppRoute(options.routePattern);\n            options.isrDebug?.(\"route regen skipped (dynamic usage)\", options.cleanPathname);\n            return;\n          }\n\n          const routeTags = options.buildPageCacheTags(\n            options.cleanPathname,\n            options.getCollectedFetchTags(),\n          );\n          const routeCacheValue = await buildAppRouteCacheValue(response);\n          await options.isrSet(routeKey, routeCacheValue, options.revalidateSeconds, routeTags);\n          options.isrDebug?.(\"route regen complete\", routeKey);\n        });\n      });\n\n      options.isrDebug?.(\"STALE (route)\", options.cleanPathname);\n      options.clearRequestContext();\n      return applyRouteHandlerMiddlewareContext(\n        buildRouteHandlerCachedResponse(staleValue, {\n          cacheState: \"STALE\",\n          isHead: options.isAutoHead,\n          revalidateSeconds: options.revalidateSeconds,\n        }),\n        options.middlewareContext,\n      );\n    }\n  } catch (routeCacheError) {\n    console.error(\"[vinext] ISR route cache read error:\", routeCacheError);\n  }\n\n  return null;\n}\n"],"mappings":";;;;AAuDA,SAAS,uBAAuB,OAA6B;AAC3D,QAAO,OAAO,MAAM,SAAS,MAAM,MAAM,MAAM,SAAS,cAAc,MAAM,MAAM,QAAQ;;AAG5F,eAAsB,iCACpB,SAC0B;CAC1B,MAAM,WAAW,QAAQ,YAAY,QAAQ,cAAc;AAE3D,KAAI;EACF,MAAM,SAAS,MAAM,QAAQ,OAAO,SAAS;EAC7C,MAAM,cAAc,uBAAuB,OAAO;AAElD,MAAI,eAAe,CAAC,QAAQ,SAAS;AACnC,WAAQ,WAAW,eAAe,QAAQ,cAAc;AACxD,WAAQ,qBAAqB;AAC7B,UAAO,mCACL,gCAAgC,aAAa;IAC3C,YAAY;IACZ,QAAQ,QAAQ;IAChB,mBAAmB,QAAQ;IAC5B,CAAC,EACF,QAAQ,kBACT;;AAGH,MAAI,QAAQ,WAAW,aAAa;GAClC,MAAM,aAAa;GACnB,MAAM,yBAAyB,IAAI,gBAAgB,QAAQ,uBAAuB;AAElF,WAAQ,+BAA+B,UAAU,YAAY;AAC3D,UAAM,QAAQ,yBAAyB,YAAY;AACjD,aAAQ,qBAAqB;MAC3B,UAAU,QAAQ;MAClB,cAAc;MACd,QAAQ,QAAQ;MACjB,CAAC;KAEF,MAAM,EAAE,sBAAsB,aAAa,MAAM,mBAAmB;MAClE,UAAU,QAAQ;MAClB,qBAAqB,QAAQ;MAC7B,WAAW,QAAQ;MACnB,MAAM,QAAQ;MACd,kBAAkB,QAAQ;MAC1B,QAAQ,QAAQ;MAChB,SAAS,IAAI,QAAQ,QAAQ,YAAY,EAAE,QAAQ,OAAO,CAAC;MAC5D,CAAC;AAEF,aAAQ,qBAAqB,KAAK;AAElC,SAAI,sBAAsB;AACxB,+BAAyB,QAAQ,aAAa;AAC9C,cAAQ,WAAW,uCAAuC,QAAQ,cAAc;AAChF;;KAGF,MAAM,YAAY,QAAQ,mBACxB,QAAQ,eACR,QAAQ,uBAAuB,CAChC;KACD,MAAM,kBAAkB,MAAM,wBAAwB,SAAS;AAC/D,WAAM,QAAQ,OAAO,UAAU,iBAAiB,QAAQ,mBAAmB,UAAU;AACrF,aAAQ,WAAW,wBAAwB,SAAS;MACpD;KACF;AAEF,WAAQ,WAAW,iBAAiB,QAAQ,cAAc;AAC1D,WAAQ,qBAAqB;AAC7B,UAAO,mCACL,gCAAgC,YAAY;IAC1C,YAAY;IACZ,QAAQ,QAAQ;IAChB,mBAAmB,QAAQ;IAC5B,CAAC,EACF,QAAQ,kBACT;;UAEI,iBAAiB;AACxB,UAAQ,MAAM,wCAAwC,gBAAgB;;AAGxE,QAAO"}
+{"version":3,"file":"app-route-handler-cache.js","names":[],"sources":["../../src/server/app-route-handler-cache.ts"],"sourcesContent":["import type { NextI18nConfig } from \"../config/next-config.js\";\nimport type { HeadersAccessPhase } from \"vinext/shims/headers\";\nimport type { ISRCacheEntry } from \"./isr-cache.js\";\nimport type { RouteHandlerMiddlewareContext } from \"./app-route-handler-response.js\";\nimport {\n  applyRouteHandlerMiddlewareContext,\n  assertSupportedAppRouteHandlerResponse,\n  buildAppRouteCacheValue,\n  buildRouteHandlerCachedResponse,\n} from \"./app-route-handler-response.js\";\nimport { markKnownDynamicAppRoute } from \"./app-route-handler-runtime.js\";\nimport {\n  runAppRouteHandler,\n  type AppRouteDebugLogger,\n  type AppRouteDynamicUsageFn,\n  type AppRouteHandlerFunction,\n  type AppRouteParams,\n  type MarkAppRouteDynamicUsageFn,\n  type RouteHandlerCacheSetter,\n} from \"./app-route-handler-execution.js\";\n\ntype RouteHandlerCacheGetter = (key: string) => Promise<ISRCacheEntry | null>;\ntype RouteHandlerBackgroundRegenerator = (key: string, renderFn: () => Promise<void>) => void;\ntype RouteHandlerRevalidationContextRunner = (renderFn: () => Promise<void>) => Promise<void>;\n\ntype ReadAppRouteHandlerCacheOptions = {\n  basePath?: string;\n  buildPageCacheTags: (pathname: string, extraTags: string[]) => string[];\n  cleanPathname: string;\n  clearRequestContext: () => void;\n  consumeDynamicUsage: AppRouteDynamicUsageFn;\n  dynamicConfig?: string;\n  getCollectedFetchTags: () => string[];\n  handlerFn: AppRouteHandlerFunction;\n  i18n?: NextI18nConfig | null;\n  isAutoHead: boolean;\n  isrDebug?: AppRouteDebugLogger;\n  isrGet: RouteHandlerCacheGetter;\n  isrRouteKey: (pathname: string) => string;\n  isrSet: RouteHandlerCacheSetter;\n  markDynamicUsage: MarkAppRouteDynamicUsageFn;\n  middlewareContext: RouteHandlerMiddlewareContext;\n  params: AppRouteParams;\n  requestUrl: string;\n  revalidateSearchParams: URLSearchParams;\n  expireSeconds?: number;\n  revalidateSeconds: number;\n  routePattern: string;\n  runInRevalidationContext: RouteHandlerRevalidationContextRunner;\n  scheduleBackgroundRegeneration: RouteHandlerBackgroundRegenerator;\n  setHeadersAccessPhase: (phase: HeadersAccessPhase) => HeadersAccessPhase;\n  setNavigationContext: (\n    context: {\n      pathname: string;\n      searchParams: URLSearchParams;\n      params: AppRouteParams;\n    } | null,\n  ) => void;\n};\n\nfunction getCachedAppRouteValue(entry: ISRCacheEntry | null) {\n  return entry?.value.value && entry.value.value.kind === \"APP_ROUTE\" ? entry.value.value : null;\n}\n\nexport async function readAppRouteHandlerCacheResponse(\n  options: ReadAppRouteHandlerCacheOptions,\n): Promise<Response | null> {\n  const routeKey = options.isrRouteKey(options.cleanPathname);\n\n  try {\n    const cached = await options.isrGet(routeKey);\n    const cachedValue = getCachedAppRouteValue(cached);\n\n    if (cachedValue && !cached?.isStale) {\n      options.isrDebug?.(\"HIT (route)\", options.cleanPathname);\n      options.clearRequestContext();\n      return applyRouteHandlerMiddlewareContext(\n        buildRouteHandlerCachedResponse(cachedValue, {\n          cacheState: \"HIT\",\n          cacheControl: cached?.value.cacheControl,\n          expireSeconds: options.expireSeconds,\n          isHead: options.isAutoHead,\n          revalidateSeconds: options.revalidateSeconds,\n        }),\n        options.middlewareContext,\n      );\n    }\n\n    if (cached?.isStale && cachedValue) {\n      const staleValue = cachedValue;\n      const revalidateSearchParams = new URLSearchParams(options.revalidateSearchParams);\n\n      options.scheduleBackgroundRegeneration(routeKey, async () => {\n        await options.runInRevalidationContext(async () => {\n          options.setNavigationContext({\n            pathname: options.cleanPathname,\n            searchParams: revalidateSearchParams,\n            params: options.params,\n          });\n\n          const { dynamicUsedInHandler, response } = await runAppRouteHandler({\n            basePath: options.basePath,\n            consumeDynamicUsage: options.consumeDynamicUsage,\n            dynamicConfig: options.dynamicConfig,\n            handlerFn: options.handlerFn,\n            i18n: options.i18n,\n            markDynamicUsage: options.markDynamicUsage,\n            params: options.params,\n            request: new Request(options.requestUrl, { method: \"GET\" }),\n            routePattern: options.routePattern,\n            setHeadersAccessPhase: options.setHeadersAccessPhase,\n          });\n\n          options.setNavigationContext(null);\n          assertSupportedAppRouteHandlerResponse(response);\n\n          if (dynamicUsedInHandler) {\n            markKnownDynamicAppRoute(options.routePattern);\n            options.isrDebug?.(\"route regen skipped (dynamic usage)\", options.cleanPathname);\n            return;\n          }\n\n          const routeTags = options.buildPageCacheTags(\n            options.cleanPathname,\n            options.getCollectedFetchTags(),\n          );\n          const routeCacheValue = await buildAppRouteCacheValue(response);\n          await options.isrSet(\n            routeKey,\n            routeCacheValue,\n            options.revalidateSeconds,\n            routeTags,\n            options.expireSeconds,\n          );\n          options.isrDebug?.(\"route regen complete\", routeKey);\n        });\n      });\n\n      options.isrDebug?.(\"STALE (route)\", options.cleanPathname);\n      options.clearRequestContext();\n      return applyRouteHandlerMiddlewareContext(\n        buildRouteHandlerCachedResponse(staleValue, {\n          cacheState: \"STALE\",\n          cacheControl: cached.value.cacheControl,\n          expireSeconds: options.expireSeconds,\n          isHead: options.isAutoHead,\n          revalidateSeconds: options.revalidateSeconds,\n        }),\n        options.middlewareContext,\n      );\n    }\n  } catch (routeCacheError) {\n    console.error(\"[vinext] ISR route cache read error:\", routeCacheError);\n  }\n\n  return null;\n}\n"],"mappings":";;;;AA4DA,SAAS,uBAAuB,OAA6B;AAC3D,QAAO,OAAO,MAAM,SAAS,MAAM,MAAM,MAAM,SAAS,cAAc,MAAM,MAAM,QAAQ;;AAG5F,eAAsB,iCACpB,SAC0B;CAC1B,MAAM,WAAW,QAAQ,YAAY,QAAQ,cAAc;AAE3D,KAAI;EACF,MAAM,SAAS,MAAM,QAAQ,OAAO,SAAS;EAC7C,MAAM,cAAc,uBAAuB,OAAO;AAElD,MAAI,eAAe,CAAC,QAAQ,SAAS;AACnC,WAAQ,WAAW,eAAe,QAAQ,cAAc;AACxD,WAAQ,qBAAqB;AAC7B,UAAO,mCACL,gCAAgC,aAAa;IAC3C,YAAY;IACZ,cAAc,QAAQ,MAAM;IAC5B,eAAe,QAAQ;IACvB,QAAQ,QAAQ;IAChB,mBAAmB,QAAQ;IAC5B,CAAC,EACF,QAAQ,kBACT;;AAGH,MAAI,QAAQ,WAAW,aAAa;GAClC,MAAM,aAAa;GACnB,MAAM,yBAAyB,IAAI,gBAAgB,QAAQ,uBAAuB;AAElF,WAAQ,+BAA+B,UAAU,YAAY;AAC3D,UAAM,QAAQ,yBAAyB,YAAY;AACjD,aAAQ,qBAAqB;MAC3B,UAAU,QAAQ;MAClB,cAAc;MACd,QAAQ,QAAQ;MACjB,CAAC;KAEF,MAAM,EAAE,sBAAsB,aAAa,MAAM,mBAAmB;MAClE,UAAU,QAAQ;MAClB,qBAAqB,QAAQ;MAC7B,eAAe,QAAQ;MACvB,WAAW,QAAQ;MACnB,MAAM,QAAQ;MACd,kBAAkB,QAAQ;MAC1B,QAAQ,QAAQ;MAChB,SAAS,IAAI,QAAQ,QAAQ,YAAY,EAAE,QAAQ,OAAO,CAAC;MAC3D,cAAc,QAAQ;MACtB,uBAAuB,QAAQ;MAChC,CAAC;AAEF,aAAQ,qBAAqB,KAAK;AAClC,4CAAuC,SAAS;AAEhD,SAAI,sBAAsB;AACxB,+BAAyB,QAAQ,aAAa;AAC9C,cAAQ,WAAW,uCAAuC,QAAQ,cAAc;AAChF;;KAGF,MAAM,YAAY,QAAQ,mBACxB,QAAQ,eACR,QAAQ,uBAAuB,CAChC;KACD,MAAM,kBAAkB,MAAM,wBAAwB,SAAS;AAC/D,WAAM,QAAQ,OACZ,UACA,iBACA,QAAQ,mBACR,WACA,QAAQ,cACT;AACD,aAAQ,WAAW,wBAAwB,SAAS;MACpD;KACF;AAEF,WAAQ,WAAW,iBAAiB,QAAQ,cAAc;AAC1D,WAAQ,qBAAqB;AAC7B,UAAO,mCACL,gCAAgC,YAAY;IAC1C,YAAY;IACZ,cAAc,OAAO,MAAM;IAC3B,eAAe,QAAQ;IACvB,QAAQ,QAAQ;IAChB,mBAAmB,QAAQ;IAC5B,CAAC,EACF,QAAQ,kBACT;;UAEI,iBAAiB;AACxB,UAAQ,MAAM,wCAAwC,gBAAgB;;AAGxE,QAAO"}

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

@@ -0,0 +1,43 @@
+import { NextI18nConfig } from "../config/next-config.js";
+import { ISRCacheEntry } from "./isr-cache.js";
+import { RouteHandlerMiddlewareContext } from "./app-route-handler-response.js";
+import { AppRouteHandlerModule } from "./app-route-handler-policy.js";
+import { AppRouteDebugLogger, AppRouteParams, RouteHandlerCacheSetter } from "./app-route-handler-execution.js";
+
+//#region src/server/app-route-handler-dispatch.d.ts
+type AppRouteHandlerDispatchRoute = {
+  pattern: string;
+  routeHandler: AppRouteHandlerModule;
+  routeSegments: string[];
+};
+type RouteHandlerCacheGetter = (key: string) => Promise<ISRCacheEntry | null>;
+type RouteHandlerBackgroundRegenerationErrorContext = {
+  routerKind: "App Router";
+  routePath: string;
+  routeType: "route";
+};
+type RouteHandlerBackgroundRegenerator = (key: string, renderFn: () => Promise<void>, errorContext?: RouteHandlerBackgroundRegenerationErrorContext) => void;
+type DispatchAppRouteHandlerOptions = {
+  basePath?: string;
+  cleanPathname: string;
+  clearRequestContext: () => void;
+  expireSeconds?: number;
+  i18n?: NextI18nConfig | null;
+  isDevelopment?: boolean;
+  isProduction?: boolean;
+  isrDebug?: AppRouteDebugLogger;
+  isrGet: RouteHandlerCacheGetter;
+  isrRouteKey: (pathname: string) => string;
+  isrSet: RouteHandlerCacheSetter;
+  middlewareContext: RouteHandlerMiddlewareContext;
+  middlewareRequestHeaders?: Headers | null;
+  params: AppRouteParams;
+  request: Request;
+  route: AppRouteHandlerDispatchRoute;
+  scheduleBackgroundRegeneration: RouteHandlerBackgroundRegenerator;
+  searchParams: URLSearchParams;
+};
+declare function dispatchAppRouteHandler(options: DispatchAppRouteHandlerOptions): Promise<Response>;
+//#endregion
+export { dispatchAppRouteHandler };
+//# sourceMappingURL=app-route-handler-dispatch.d.ts.map

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

@@ -0,0 +1,149 @@
+import { createRequestContext, runWithRequestContext } from "../shims/unified-request-context.js";
+import { getRequestExecutionContext } from "../shims/request-context.js";
+import { reportRequestError } from "./instrumentation.js";
+import { consumeDynamicUsage, getAndClearPendingCookies, getDraftModeCookieHeader, markDynamicUsage, setHeadersAccessPhase } from "../shims/headers.js";
+import { ensureFetchPatch, getCollectedFetchTags, setCurrentFetchSoftTags } from "../shims/fetch-cache.js";
+import { setNavigationContext } from "../shims/navigation.js";
+import { isKnownDynamicAppRoute } from "./app-route-handler-runtime.js";
+import { getAppRouteHandlerRevalidateSeconds, hasAppRouteHandlerDefaultExport, resolveAppRouteHandlerMethod, shouldReadAppRouteHandlerCache } from "./app-route-handler-policy.js";
+import { createStaticGenerationHeadersContext } from "./app-static-generation.js";
+import { buildPageCacheTags } from "./implicit-tags.js";
+import { applyRouteHandlerMiddlewareContext } from "./app-route-handler-response.js";
+import { executeAppRouteHandler } from "./app-route-handler-execution.js";
+import { readAppRouteHandlerCacheResponse } from "./app-route-handler-cache.js";
+//#region src/server/app-route-handler-dispatch.ts
+function isAppRouteHandlerFunction(value) {
+	return typeof value === "function";
+}
+function makeThenableParams(params) {
+	const plain = { ...params };
+	return Object.assign(Promise.resolve(plain), plain);
+}
+function buildRouteHandlerPageCacheTags(pathname, extraTags, routeSegments) {
+	return buildPageCacheTags(pathname, extraTags, routeSegments, "route");
+}
+async function runInRouteHandlerRevalidationContext(options, renderFn) {
+	await runWithRequestContext(createRequestContext({
+		headersContext: createStaticGenerationHeadersContext({
+			dynamicConfig: options.dynamicConfig,
+			routeKind: "route",
+			routePattern: options.routePattern
+		}),
+		executionContext: getRequestExecutionContext(),
+		unstableCacheRevalidation: "foreground"
+	}), async () => {
+		ensureFetchPatch();
+		setCurrentFetchSoftTags(buildRouteHandlerPageCacheTags(options.cleanPathname, [], options.routeSegments));
+		await renderFn();
+	});
+}
+async function dispatchAppRouteHandler(options) {
+	const { route } = options;
+	const handler = route.routeHandler;
+	const method = options.request.method.toUpperCase();
+	const revalidateSeconds = getAppRouteHandlerRevalidateSeconds(handler);
+	const isDevelopment = options.isDevelopment ?? process.env.NODE_ENV === "development";
+	const isProduction = options.isProduction ?? process.env.NODE_ENV === "production";
+	if (hasAppRouteHandlerDefaultExport(handler) && isDevelopment) console.error("[vinext] Detected default export in route handler " + route.pattern + ". Export a named export for each HTTP method instead.");
+	const { allowHeaderForOptions, handlerFn, isAutoHead, shouldAutoRespondToOptions } = resolveAppRouteHandlerMethod(handler, method);
+	if (shouldAutoRespondToOptions) {
+		options.clearRequestContext();
+		return applyRouteHandlerMiddlewareContext(new Response(null, {
+			status: 204,
+			headers: { Allow: allowHeaderForOptions }
+		}), options.middlewareContext);
+	}
+	const resolvedHandlerFn = isAppRouteHandlerFunction(handlerFn) ? handlerFn : void 0;
+	if (revalidateSeconds !== null && shouldReadAppRouteHandlerCache({
+		dynamicConfig: handler.dynamic,
+		handlerFn: resolvedHandlerFn,
+		isAutoHead,
+		isKnownDynamic: isKnownDynamicAppRoute(route.pattern),
+		isProduction,
+		method,
+		revalidateSeconds
+	}) && resolvedHandlerFn) {
+		const cachedRouteResponse = await readAppRouteHandlerCacheResponse({
+			basePath: options.basePath,
+			buildPageCacheTags(pathname, extraTags) {
+				return buildRouteHandlerPageCacheTags(pathname, extraTags, route.routeSegments);
+			},
+			cleanPathname: options.cleanPathname,
+			clearRequestContext: options.clearRequestContext,
+			consumeDynamicUsage,
+			dynamicConfig: handler.dynamic,
+			getCollectedFetchTags,
+			handlerFn: resolvedHandlerFn,
+			i18n: options.i18n,
+			isAutoHead,
+			isrDebug: options.isrDebug,
+			isrGet: options.isrGet,
+			isrRouteKey: options.isrRouteKey,
+			isrSet: options.isrSet,
+			markDynamicUsage,
+			middlewareContext: options.middlewareContext,
+			params: options.params,
+			requestUrl: options.request.url,
+			revalidateSearchParams: options.searchParams,
+			expireSeconds: options.expireSeconds,
+			revalidateSeconds,
+			routePattern: route.pattern,
+			runInRevalidationContext(renderFn) {
+				return runInRouteHandlerRevalidationContext({
+					cleanPathname: options.cleanPathname,
+					dynamicConfig: handler.dynamic,
+					routePattern: route.pattern,
+					routeSegments: route.routeSegments
+				}, renderFn);
+			},
+			scheduleBackgroundRegeneration(key, renderFn) {
+				options.scheduleBackgroundRegeneration(key, renderFn, {
+					routerKind: "App Router",
+					routePath: route.pattern,
+					routeType: "route"
+				});
+			},
+			setHeadersAccessPhase,
+			setNavigationContext
+		});
+		if (cachedRouteResponse) return cachedRouteResponse;
+	}
+	if (resolvedHandlerFn) return executeAppRouteHandler({
+		basePath: options.basePath,
+		buildPageCacheTags(pathname, extraTags) {
+			return buildRouteHandlerPageCacheTags(pathname, extraTags, route.routeSegments);
+		},
+		cleanPathname: options.cleanPathname,
+		clearRequestContext: options.clearRequestContext,
+		consumeDynamicUsage,
+		executionContext: getRequestExecutionContext(),
+		getAndClearPendingCookies,
+		getCollectedFetchTags,
+		getDraftModeCookieHeader,
+		handler,
+		handlerFn: resolvedHandlerFn,
+		i18n: options.i18n,
+		isAutoHead,
+		isProduction,
+		isrDebug: options.isrDebug,
+		isrRouteKey: options.isrRouteKey,
+		isrSet: options.isrSet,
+		markDynamicUsage,
+		method,
+		middlewareContext: options.middlewareContext,
+		middlewareRequestHeaders: options.middlewareRequestHeaders,
+		params: makeThenableParams(options.params),
+		reportRequestError,
+		request: options.request,
+		expireSeconds: options.expireSeconds,
+		revalidateSeconds,
+		routePattern: route.pattern,
+		setHeadersAccessPhase
+	});
+	options.clearRequestContext();
+	return applyRouteHandlerMiddlewareContext(new Response(null, { status: 405 }), options.middlewareContext);
+}
+//#endregion
+export { dispatchAppRouteHandler };
+
+//# sourceMappingURL=app-route-handler-dispatch.js.map

package/dist/server/app-route-handler-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-route-handler-dispatch.js","names":[],"sources":["../../src/server/app-route-handler-dispatch.ts"],"sourcesContent":["import type { NextI18nConfig } from \"../config/next-config.js\";\nimport {\n  getCollectedFetchTags,\n  ensureFetchPatch,\n  setCurrentFetchSoftTags,\n} from \"vinext/shims/fetch-cache\";\nimport {\n  consumeDynamicUsage,\n  getAndClearPendingCookies,\n  getDraftModeCookieHeader,\n  markDynamicUsage,\n  setHeadersAccessPhase,\n} from \"vinext/shims/headers\";\nimport { setNavigationContext } from \"vinext/shims/navigation\";\nimport { getRequestExecutionContext } from \"vinext/shims/request-context\";\nimport { createRequestContext, runWithRequestContext } from \"vinext/shims/unified-request-context\";\nimport type { ISRCacheEntry } from \"./isr-cache.js\";\nimport {\n  getAppRouteHandlerRevalidateSeconds,\n  hasAppRouteHandlerDefaultExport,\n  resolveAppRouteHandlerMethod,\n  shouldReadAppRouteHandlerCache,\n  type AppRouteHandlerModule,\n} from \"./app-route-handler-policy.js\";\nimport { readAppRouteHandlerCacheResponse } from \"./app-route-handler-cache.js\";\nimport {\n  executeAppRouteHandler,\n  type AppRouteDebugLogger,\n  type AppRouteHandlerFunction,\n  type AppRouteParams,\n  type RouteHandlerCacheSetter,\n} from \"./app-route-handler-execution.js\";\nimport { isKnownDynamicAppRoute } from \"./app-route-handler-runtime.js\";\nimport {\n  applyRouteHandlerMiddlewareContext,\n  type RouteHandlerMiddlewareContext,\n} from \"./app-route-handler-response.js\";\nimport { createStaticGenerationHeadersContext } from \"./app-static-generation.js\";\nimport { buildPageCacheTags } from \"./implicit-tags.js\";\nimport { reportRequestError } from \"./instrumentation.js\";\n\ntype AppRouteHandlerDispatchRoute = {\n  pattern: string;\n  routeHandler: AppRouteHandlerModule;\n  routeSegments: string[];\n};\n\ntype RouteHandlerCacheGetter = (key: string) => Promise<ISRCacheEntry | null>;\ntype RouteHandlerBackgroundRegenerationErrorContext = {\n  routerKind: \"App Router\";\n  routePath: string;\n  routeType: \"route\";\n};\ntype RouteHandlerBackgroundRegenerator = (\n  key: string,\n  renderFn: () => Promise<void>,\n  errorContext?: RouteHandlerBackgroundRegenerationErrorContext,\n) => void;\n\ntype DispatchAppRouteHandlerOptions = {\n  basePath?: string;\n  cleanPathname: string;\n  clearRequestContext: () => void;\n  expireSeconds?: number;\n  i18n?: NextI18nConfig | null;\n  isDevelopment?: boolean;\n  isProduction?: boolean;\n  isrDebug?: AppRouteDebugLogger;\n  isrGet: RouteHandlerCacheGetter;\n  isrRouteKey: (pathname: string) => string;\n  isrSet: RouteHandlerCacheSetter;\n  middlewareContext: RouteHandlerMiddlewareContext;\n  middlewareRequestHeaders?: Headers | null;\n  params: AppRouteParams;\n  request: Request;\n  route: AppRouteHandlerDispatchRoute;\n  scheduleBackgroundRegeneration: RouteHandlerBackgroundRegenerator;\n  searchParams: URLSearchParams;\n};\n\nfunction isAppRouteHandlerFunction(value: unknown): value is AppRouteHandlerFunction {\n  return typeof value === \"function\";\n}\n\nfunction makeThenableParams<T extends AppRouteParams>(params: T): Promise<T> & T {\n  const plain = { ...params };\n  return Object.assign(Promise.resolve(plain), plain);\n}\n\nfunction buildRouteHandlerPageCacheTags(\n  pathname: string,\n  extraTags: string[],\n  routeSegments: string[],\n): string[] {\n  return buildPageCacheTags(pathname, extraTags, routeSegments, \"route\");\n}\n\nasync function runInRouteHandlerRevalidationContext(\n  options: {\n    cleanPathname: string;\n    dynamicConfig?: string;\n    routePattern: string;\n    routeSegments: string[];\n  },\n  renderFn: () => Promise<void>,\n): Promise<void> {\n  const headersContext = createStaticGenerationHeadersContext({\n    dynamicConfig: options.dynamicConfig,\n    routeKind: \"route\",\n    routePattern: options.routePattern,\n  });\n  const requestContext = createRequestContext({\n    headersContext,\n    executionContext: getRequestExecutionContext(),\n    unstableCacheRevalidation: \"foreground\",\n  });\n\n  await runWithRequestContext(requestContext, async () => {\n    ensureFetchPatch();\n    setCurrentFetchSoftTags(\n      buildRouteHandlerPageCacheTags(options.cleanPathname, [], options.routeSegments),\n    );\n    await renderFn();\n  });\n}\n\nexport async function dispatchAppRouteHandler(\n  options: DispatchAppRouteHandlerOptions,\n): Promise<Response> {\n  const { route } = options;\n  const handler = route.routeHandler;\n  const method = options.request.method.toUpperCase();\n  const revalidateSeconds = getAppRouteHandlerRevalidateSeconds(handler);\n  const isDevelopment = options.isDevelopment ?? process.env.NODE_ENV === \"development\";\n  const isProduction = options.isProduction ?? process.env.NODE_ENV === \"production\";\n\n  if (hasAppRouteHandlerDefaultExport(handler) && isDevelopment) {\n    console.error(\n      \"[vinext] Detected default export in route handler \" +\n        route.pattern +\n        \". Export a named export for each HTTP method instead.\",\n    );\n  }\n\n  const { allowHeaderForOptions, handlerFn, isAutoHead, shouldAutoRespondToOptions } =\n    resolveAppRouteHandlerMethod(handler, method);\n\n  if (shouldAutoRespondToOptions) {\n    options.clearRequestContext();\n    return applyRouteHandlerMiddlewareContext(\n      new Response(null, {\n        status: 204,\n        headers: { Allow: allowHeaderForOptions },\n      }),\n      options.middlewareContext,\n    );\n  }\n\n  const resolvedHandlerFn = isAppRouteHandlerFunction(handlerFn) ? handlerFn : undefined;\n\n  if (\n    revalidateSeconds !== null &&\n    shouldReadAppRouteHandlerCache({\n      dynamicConfig: handler.dynamic,\n      handlerFn: resolvedHandlerFn,\n      isAutoHead,\n      isKnownDynamic: isKnownDynamicAppRoute(route.pattern),\n      isProduction,\n      method,\n      revalidateSeconds,\n    }) &&\n    resolvedHandlerFn\n  ) {\n    const cachedRouteResponse = await readAppRouteHandlerCacheResponse({\n      basePath: options.basePath,\n      buildPageCacheTags(pathname, extraTags) {\n        return buildRouteHandlerPageCacheTags(pathname, extraTags, route.routeSegments);\n      },\n      cleanPathname: options.cleanPathname,\n      clearRequestContext: options.clearRequestContext,\n      consumeDynamicUsage,\n      dynamicConfig: handler.dynamic,\n      getCollectedFetchTags,\n      handlerFn: resolvedHandlerFn,\n      i18n: options.i18n,\n      isAutoHead,\n      isrDebug: options.isrDebug,\n      isrGet: options.isrGet,\n      isrRouteKey: options.isrRouteKey,\n      isrSet: options.isrSet,\n      markDynamicUsage,\n      middlewareContext: options.middlewareContext,\n      params: options.params,\n      requestUrl: options.request.url,\n      revalidateSearchParams: options.searchParams,\n      expireSeconds: options.expireSeconds,\n      revalidateSeconds,\n      routePattern: route.pattern,\n      runInRevalidationContext(renderFn) {\n        return runInRouteHandlerRevalidationContext(\n          {\n            cleanPathname: options.cleanPathname,\n            dynamicConfig: handler.dynamic,\n            routePattern: route.pattern,\n            routeSegments: route.routeSegments,\n          },\n          renderFn,\n        );\n      },\n      scheduleBackgroundRegeneration(key, renderFn) {\n        options.scheduleBackgroundRegeneration(key, renderFn, {\n          routerKind: \"App Router\",\n          routePath: route.pattern,\n          routeType: \"route\",\n        });\n      },\n      setHeadersAccessPhase,\n      setNavigationContext,\n    });\n    if (cachedRouteResponse) {\n      return cachedRouteResponse;\n    }\n  }\n\n  if (resolvedHandlerFn) {\n    return executeAppRouteHandler({\n      basePath: options.basePath,\n      buildPageCacheTags(pathname, extraTags) {\n        return buildRouteHandlerPageCacheTags(pathname, extraTags, route.routeSegments);\n      },\n      cleanPathname: options.cleanPathname,\n      clearRequestContext: options.clearRequestContext,\n      consumeDynamicUsage,\n      executionContext: getRequestExecutionContext(),\n      getAndClearPendingCookies,\n      getCollectedFetchTags,\n      getDraftModeCookieHeader,\n      handler,\n      handlerFn: resolvedHandlerFn,\n      i18n: options.i18n,\n      isAutoHead,\n      isProduction,\n      isrDebug: options.isrDebug,\n      isrRouteKey: options.isrRouteKey,\n      isrSet: options.isrSet,\n      markDynamicUsage,\n      method,\n      middlewareContext: options.middlewareContext,\n      middlewareRequestHeaders: options.middlewareRequestHeaders,\n      params: makeThenableParams(options.params),\n      reportRequestError,\n      request: options.request,\n      expireSeconds: options.expireSeconds,\n      revalidateSeconds,\n      routePattern: route.pattern,\n      setHeadersAccessPhase,\n    });\n  }\n\n  options.clearRequestContext();\n  return applyRouteHandlerMiddlewareContext(\n    new Response(null, {\n      status: 405,\n    }),\n    options.middlewareContext,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;AAgFA,SAAS,0BAA0B,OAAkD;AACnF,QAAO,OAAO,UAAU;;AAG1B,SAAS,mBAA6C,QAA2B;CAC/E,MAAM,QAAQ,EAAE,GAAG,QAAQ;AAC3B,QAAO,OAAO,OAAO,QAAQ,QAAQ,MAAM,EAAE,MAAM;;AAGrD,SAAS,+BACP,UACA,WACA,eACU;AACV,QAAO,mBAAmB,UAAU,WAAW,eAAe,QAAQ;;AAGxE,eAAe,qCACb,SAMA,UACe;AAYf,OAAM,sBANiB,qBAAqB;EAC1C,gBANqB,qCAAqC;GAC1D,eAAe,QAAQ;GACvB,WAAW;GACX,cAAc,QAAQ;GACvB,CAAC;EAGA,kBAAkB,4BAA4B;EAC9C,2BAA2B;EAC5B,CAAC,EAE0C,YAAY;AACtD,oBAAkB;AAClB,0BACE,+BAA+B,QAAQ,eAAe,EAAE,EAAE,QAAQ,cAAc,CACjF;AACD,QAAM,UAAU;GAChB;;AAGJ,eAAsB,wBACpB,SACmB;CACnB,MAAM,EAAE,UAAU;CAClB,MAAM,UAAU,MAAM;CACtB,MAAM,SAAS,QAAQ,QAAQ,OAAO,aAAa;CACnD,MAAM,oBAAoB,oCAAoC,QAAQ;CACtE,MAAM,gBAAgB,QAAQ,iBAAiB,QAAQ,IAAI,aAAa;CACxE,MAAM,eAAe,QAAQ,gBAAgB,QAAQ,IAAI,aAAa;AAEtE,KAAI,gCAAgC,QAAQ,IAAI,cAC9C,SAAQ,MACN,uDACE,MAAM,UACN,wDACH;CAGH,MAAM,EAAE,uBAAuB,WAAW,YAAY,+BACpD,6BAA6B,SAAS,OAAO;AAE/C,KAAI,4BAA4B;AAC9B,UAAQ,qBAAqB;AAC7B,SAAO,mCACL,IAAI,SAAS,MAAM;GACjB,QAAQ;GACR,SAAS,EAAE,OAAO,uBAAuB;GAC1C,CAAC,EACF,QAAQ,kBACT;;CAGH,MAAM,oBAAoB,0BAA0B,UAAU,GAAG,YAAY,KAAA;AAE7E,KACE,sBAAsB,QACtB,+BAA+B;EAC7B,eAAe,QAAQ;EACvB,WAAW;EACX;EACA,gBAAgB,uBAAuB,MAAM,QAAQ;EACrD;EACA;EACA;EACD,CAAC,IACF,mBACA;EACA,MAAM,sBAAsB,MAAM,iCAAiC;GACjE,UAAU,QAAQ;GAClB,mBAAmB,UAAU,WAAW;AACtC,WAAO,+BAA+B,UAAU,WAAW,MAAM,cAAc;;GAEjF,eAAe,QAAQ;GACvB,qBAAqB,QAAQ;GAC7B;GACA,eAAe,QAAQ;GACvB;GACA,WAAW;GACX,MAAM,QAAQ;GACd;GACA,UAAU,QAAQ;GAClB,QAAQ,QAAQ;GAChB,aAAa,QAAQ;GACrB,QAAQ,QAAQ;GAChB;GACA,mBAAmB,QAAQ;GAC3B,QAAQ,QAAQ;GAChB,YAAY,QAAQ,QAAQ;GAC5B,wBAAwB,QAAQ;GAChC,eAAe,QAAQ;GACvB;GACA,cAAc,MAAM;GACpB,yBAAyB,UAAU;AACjC,WAAO,qCACL;KACE,eAAe,QAAQ;KACvB,eAAe,QAAQ;KACvB,cAAc,MAAM;KACpB,eAAe,MAAM;KACtB,EACD,SACD;;GAEH,+BAA+B,KAAK,UAAU;AAC5C,YAAQ,+BAA+B,KAAK,UAAU;KACpD,YAAY;KACZ,WAAW,MAAM;KACjB,WAAW;KACZ,CAAC;;GAEJ;GACA;GACD,CAAC;AACF,MAAI,oBACF,QAAO;;AAIX,KAAI,kBACF,QAAO,uBAAuB;EAC5B,UAAU,QAAQ;EAClB,mBAAmB,UAAU,WAAW;AACtC,UAAO,+BAA+B,UAAU,WAAW,MAAM,cAAc;;EAEjF,eAAe,QAAQ;EACvB,qBAAqB,QAAQ;EAC7B;EACA,kBAAkB,4BAA4B;EAC9C;EACA;EACA;EACA;EACA,WAAW;EACX,MAAM,QAAQ;EACd;EACA;EACA,UAAU,QAAQ;EAClB,aAAa,QAAQ;EACrB,QAAQ,QAAQ;EAChB;EACA;EACA,mBAAmB,QAAQ;EAC3B,0BAA0B,QAAQ;EAClC,QAAQ,mBAAmB,QAAQ,OAAO;EAC1C;EACA,SAAS,QAAQ;EACjB,eAAe,QAAQ;EACvB;EACA,cAAc,MAAM;EACpB;EACD,CAAC;AAGJ,SAAQ,qBAAqB;AAC7B,QAAO,mCACL,IAAI,SAAS,MAAM,EACjB,QAAQ,KACT,CAAC,EACF,QAAQ,kBACT"}

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

@@ -1,18 +1,19 @@
 import { NextI18nConfig } from "../config/next-config.js";
 import { ExecutionContextLike } from "../shims/request-context.js";
 import { CachedRouteValue } from "../shims/cache.js";
-import { RouteHandlerMiddlewareContext } from "./app-route-handler-response.js";
+import { NextRequest } from "../shims/server.js";
 import { HeadersAccessPhase } from "../shims/headers.js";
+import { RouteHandlerMiddlewareContext } from "./app-route-handler-response.js";
 import { AppRouteHandlerModule } from "./app-route-handler-policy.js";
 
 //#region src/server/app-route-handler-execution.d.ts
 type AppRouteParams = Record<string, string | string[]>;
 type AppRouteDynamicUsageFn = () => boolean;
 type MarkAppRouteDynamicUsageFn = () => void;
-type AppRouteHandlerFunction = (request: Request, context: {
+type AppRouteHandlerFunction = (request: NextRequest, context: {
   params: AppRouteParams;
 }) => Response | Promise<Response>;
-type RouteHandlerCacheSetter = (key: string, data: CachedRouteValue, revalidateSeconds: number, tags: string[]) => Promise<void>;
+type RouteHandlerCacheSetter = (key: string, data: CachedRouteValue, revalidateSeconds: number, tags: string[], expireSeconds?: number) => Promise<void>;
 type AppRouteErrorReporter = (error: Error, request: {
   path: string;
   method: string;
@@ -26,12 +27,15 @@ type AppRouteDebugLogger = (event: string, detail: string) => void;
 type RunAppRouteHandlerOptions = {
   basePath?: string;
   consumeDynamicUsage: AppRouteDynamicUsageFn;
+  dynamicConfig?: string;
   handlerFn: AppRouteHandlerFunction;
   i18n?: NextI18nConfig | null;
   markDynamicUsage: MarkAppRouteDynamicUsageFn;
   middlewareRequestHeaders?: Headers | null;
   params: AppRouteParams;
   request: Request;
+  routePattern?: string;
+  setHeadersAccessPhase?: (phase: HeadersAccessPhase) => HeadersAccessPhase;
 };
 type RunAppRouteHandlerResult = {
   dynamicUsedInHandler: boolean;
@@ -54,6 +58,7 @@ type ExecuteAppRouteHandlerOptions = {
   method: string;
   middlewareContext: RouteHandlerMiddlewareContext;
   reportRequestError: AppRouteErrorReporter;
+  expireSeconds?: number;
   revalidateSeconds: number | null;
   routePattern: string;
   setHeadersAccessPhase: (phase: HeadersAccessPhase) => HeadersAccessPhase;