vinext 0.0.50 → 0.0.52

package/dist/server/middleware-runtime.js

@@ -1,4 +1,5 @@
 import { normalizePathnameForRouteMatchStrict } from "../routing/utils.js";
+import "./server-globals.js";
 import { getRequestExecutionContext, runWithExecutionContext } from "../shims/request-context.js";
 import { MIDDLEWARE_REWRITE_HEADER } from "./headers.js";
 import { shouldKeepMiddlewareHeader } from "./middleware-request-headers.js";
@@ -7,6 +8,7 @@ import { normalizePath } from "./normalize-path.js";
 import { matchesMiddleware } from "./middleware-matcher.js";
 import { badRequestResponse, internalServerErrorResponse } from "./http-error-responses.js";
 import { processMiddlewareHeaders } from "./request-pipeline.js";
+import { mergeRewriteQuery } from "../utils/query.js";
 //#region src/server/middleware-runtime.ts
 function isMiddlewareHandler(value) {
 	return typeof value === "function";
@@ -42,6 +44,42 @@ function stripMiddlewareHeadersFromResponse(response) {
 		headers
 	});
 }
+/**
+* Make a same-host URL relative to the request origin. Cross-origin URLs are
+* returned unchanged. Mirrors Next.js's `getRelativeURL` behaviour:
+* https://github.com/vercel/next.js/blob/canary/packages/next/src/shared/lib/router/utils/relativize-url.ts
+*/
+function relativizeLocation(location, requestUrl) {
+	let parsed;
+	try {
+		parsed = new URL(location, requestUrl);
+	} catch {
+		return location;
+	}
+	const base = new URL(requestUrl);
+	if (parsed.origin !== base.origin) return parsed.toString();
+	return parsed.pathname + parsed.search + parsed.hash;
+}
+/**
+* Translate a middleware redirect Response into the soft-redirect protocol
+* used by Next.js for `_next/data` requests: a 200 OK with the redirect target
+* carried in the `x-nextjs-redirect` header. The client router consumes this
+* header to perform the navigation, avoiding CORS issues that would arise from
+* an actual cross-origin HTTP redirect on a data fetch.
+*
+* Reference: packages/next/src/server/web/adapter.ts
+* https://github.com/vercel/next.js/blob/canary/packages/next/src/server/web/adapter.ts
+*/
+function dataRedirectResponse(target, originalResponse) {
+	const headers = new Headers(originalResponse.headers);
+	processMiddlewareHeaders(headers);
+	headers.delete("Location");
+	headers.set("x-nextjs-redirect", target);
+	return new Response(null, {
+		status: 200,
+		headers
+	});
+}
 function collectMiddlewareHeaders(response) {
 	const responseHeaders = new Headers();
 	for (const [key, value] of response.headers) if (!key.startsWith("x-middleware-") || shouldKeepMiddlewareHeader(key)) responseHeaders.append(key, value);
@@ -62,7 +100,7 @@ function resolveMiddlewarePathname(request) {
 		return badRequestResponse();
 	}
 }
-function createNextRequest(request, normalizedPathname, i18nConfig, basePath) {
+function createNextRequest(request, normalizedPathname, i18nConfig, basePath, trailingSlash) {
 	const url = new URL(request.url);
 	let mwRequest = request.body && !request.bodyUsed ? request.clone() : request;
 	if (normalizedPathname !== url.pathname) {
@@ -70,9 +108,10 @@ function createNextRequest(request, normalizedPathname, i18nConfig, basePath) {
 		mwUrl.pathname = normalizedPathname;
 		mwRequest = new Request(mwUrl, mwRequest);
 	}
-	const nextConfig = basePath || i18nConfig ? {
+	const nextConfig = basePath || i18nConfig || trailingSlash ? {
 		basePath: basePath ?? "",
-		i18n: i18nConfig ?? void 0
+		i18n: i18nConfig ?? void 0,
+		trailingSlash: trailingSlash ?? void 0
 	} : void 0;
 	return mwRequest instanceof NextRequest ? mwRequest : new NextRequest(mwRequest, nextConfig ? { nextConfig } : void 0);
 }
@@ -87,7 +126,7 @@ async function executeMiddleware(options) {
 		response: normalizedPathname
 	};
 	if (!matchesMiddleware(normalizedPathname, middlewareMatcher(options.module), options.request, options.i18nConfig)) return { continue: true };
-	const nextRequest = createNextRequest(options.request, normalizedPathname, options.i18nConfig, options.basePath);
+	const nextRequest = createNextRequest(options.request, normalizedPathname, options.i18nConfig, options.basePath, options.trailingSlash);
 	const fetchEvent = new NextFetchEvent({ page: normalizedPathname });
 	let response;
 	try {
@@ -115,13 +154,26 @@ async function executeMiddleware(options) {
 	if (response.status >= 300 && response.status < 400) {
 		const location = response.headers.get("Location") ?? response.headers.get("location");
 		if (location) {
+			const relativeLocation = relativizeLocation(location, options.request.url);
+			if (options.isDataRequest) return {
+				continue: false,
+				response: dataRedirectResponse(relativeLocation, response),
+				waitUntilPromises
+			};
 			const responseHeaders = new Headers();
 			for (const [key, value] of response.headers) if (!key.startsWith("x-middleware-") && key.toLowerCase() !== "location") responseHeaders.append(key, value);
+			const relativizedResponseHeaders = new Headers(response.headers);
+			relativizedResponseHeaders.set("Location", relativeLocation);
+			const relativizedResponse = new Response(response.body, {
+				status: response.status,
+				statusText: response.statusText,
+				headers: relativizedResponseHeaders
+			});
 			return {
 				continue: false,
-				redirectUrl: location,
+				redirectUrl: relativeLocation,
 				redirectStatus: response.status,
-				response: stripMiddlewareHeadersFromResponse(response),
+				response: stripMiddlewareHeadersFromResponse(relativizedResponse),
 				responseHeaders,
 				waitUntilPromises
 			};
@@ -133,7 +185,8 @@ async function executeMiddleware(options) {
 		try {
 			const rewriteParsed = new URL(rewriteUrl, options.request.url);
 			const requestOrigin = new URL(options.request.url).origin;
-			rewritePath = rewriteParsed.origin === requestOrigin ? rewriteParsed.pathname + rewriteParsed.search : rewriteParsed.href;
+			if (rewriteParsed.origin === requestOrigin) rewritePath = mergeRewriteQuery(options.request.url, rewriteParsed.pathname + rewriteParsed.search);
+			else rewritePath = rewriteParsed.href;
 		} catch {
 			rewritePath = rewriteUrl;
 		}

package/dist/server/middleware-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware-runtime.js","names":[],"sources":["../../src/server/middleware-runtime.ts"],"sourcesContent":["import type { NextI18nConfig } from \"../config/next-config.js\";\nimport { normalizePathnameForRouteMatchStrict } from \"../routing/utils.js\";\nimport {\n  getRequestExecutionContext,\n  runWithExecutionContext,\n  type ExecutionContextLike,\n} from \"vinext/shims/request-context\";\nimport { NextFetchEvent, NextRequest } from \"vinext/shims/server\";\nimport { normalizePath } from \"./normalize-path.js\";\nimport {\n  MIDDLEWARE_HEADER_PREFIX,\n  MIDDLEWARE_NEXT_HEADER,\n  MIDDLEWARE_REWRITE_HEADER,\n} from \"./headers.js\";\nimport { MatcherConfig, matchesMiddleware } from \"./middleware-matcher.js\";\nimport { shouldKeepMiddlewareHeader } from \"./middleware-request-headers.js\";\nimport { processMiddlewareHeaders } from \"./request-pipeline.js\";\nimport { badRequestResponse, internalServerErrorResponse } from \"./http-error-responses.js\";\n\nexport type MiddlewareModule = Record<string, unknown>;\n\nexport type MiddlewareResult = {\n  continue: boolean;\n  redirectUrl?: string;\n  redirectStatus?: number;\n  rewriteUrl?: string;\n  rewriteStatus?: number;\n  status?: number;\n  responseHeaders?: Headers;\n  response?: Response;\n  waitUntilPromises?: Promise<unknown>[];\n};\n\ntype MiddlewareHandler = (\n  request: NextRequest,\n  event: NextFetchEvent,\n) => Response | undefined | void | Promise<Response | undefined | void>;\n\ntype MiddlewareConfigExport = {\n  matcher?: MatcherConfig;\n};\n\ntype ExecuteMiddlewareOptions = {\n  basePath?: string;\n  filePath?: string;\n  i18nConfig?: NextI18nConfig | null;\n  includeErrorDetails?: boolean;\n  isProxy: boolean;\n  module: MiddlewareModule;\n  normalizedPathname?: string;\n  request: Request;\n};\n\ntype RunGeneratedMiddlewareOptions = ExecuteMiddlewareOptions & {\n  ctx?: ExecutionContextLike;\n};\n\nfunction isMiddlewareHandler(value: unknown): value is MiddlewareHandler {\n  return typeof value === \"function\";\n}\n\nfunction isMiddlewareConfigExport(value: unknown): value is MiddlewareConfigExport {\n  return !!value && typeof value === \"object\";\n}\n\nfunction middlewareFileLabel(isProxy: boolean): string {\n  return isProxy ? \"Proxy\" : \"Middleware\";\n}\n\nfunction middlewareExpectedExport(isProxy: boolean): string {\n  return isProxy ? \"proxy\" : \"middleware\";\n}\n\nexport function resolveMiddlewareModuleHandler(\n  mod: MiddlewareModule,\n  options: { filePath?: string; isProxy: boolean },\n): MiddlewareHandler {\n  const handler = options.isProxy ? (mod.proxy ?? mod.default) : (mod.middleware ?? mod.default);\n  if (isMiddlewareHandler(handler)) return handler;\n\n  const fileLabel = middlewareFileLabel(options.isProxy);\n  const expectedExport = middlewareExpectedExport(options.isProxy);\n  const fileSuffix = options.filePath ? ` \"${options.filePath}\"` : \"\";\n  throw new Error(\n    `The ${fileLabel} file${fileSuffix} must export a function named \\`${expectedExport}\\` or a \\`default\\` function.`,\n  );\n}\n\nfunction middlewareMatcher(mod: MiddlewareModule): MatcherConfig | undefined {\n  const config = mod.config;\n  if (!isMiddlewareConfigExport(config)) return undefined;\n  return config.matcher;\n}\n\nfunction stripMiddlewareHeadersFromResponse(response: Response): Response {\n  const headers = new Headers(response.headers);\n  processMiddlewareHeaders(headers);\n  return new Response(response.body, {\n    status: response.status,\n    statusText: response.statusText,\n    headers,\n  });\n}\n\nfunction collectMiddlewareHeaders(response: Response): Headers {\n  const responseHeaders = new Headers();\n  for (const [key, value] of response.headers) {\n    if (!key.startsWith(MIDDLEWARE_HEADER_PREFIX) || shouldKeepMiddlewareHeader(key)) {\n      responseHeaders.append(key, value);\n    }\n  }\n  return responseHeaders;\n}\n\nfunction drainFetchEvent(fetchEvent: NextFetchEvent): Promise<unknown>[] {\n  const waitUntilPromises = fetchEvent.waitUntilPromises;\n  const drained = fetchEvent.drainWaitUntil();\n  const executionContext = getRequestExecutionContext();\n  if (executionContext) {\n    executionContext.waitUntil(drained);\n  } else {\n    void drained;\n  }\n  return waitUntilPromises;\n}\n\nfunction resolveMiddlewarePathname(request: Request): string | Response {\n  const url = new URL(request.url);\n  try {\n    return normalizePath(normalizePathnameForRouteMatchStrict(url.pathname));\n  } catch {\n    return badRequestResponse();\n  }\n}\n\nfunction createNextRequest(\n  request: Request,\n  normalizedPathname: string,\n  i18nConfig?: NextI18nConfig | null,\n  basePath?: string,\n): NextRequest {\n  const url = new URL(request.url);\n  // Middleware gets an isolated body branch; downstream routing keeps owning\n  // the original request body.\n  let mwRequest = request.body && !request.bodyUsed ? request.clone() : request;\n  if (normalizedPathname !== url.pathname) {\n    const mwUrl = new URL(url);\n    mwUrl.pathname = normalizedPathname;\n    mwRequest = new Request(mwUrl, mwRequest);\n  }\n\n  const nextConfig =\n    basePath || i18nConfig\n      ? { basePath: basePath ?? \"\", i18n: i18nConfig ?? undefined }\n      : undefined;\n\n  return mwRequest instanceof NextRequest\n    ? mwRequest\n    : new NextRequest(mwRequest, nextConfig ? { nextConfig } : undefined);\n}\n\nexport async function executeMiddleware(\n  options: ExecuteMiddlewareOptions,\n): Promise<MiddlewareResult> {\n  const middlewareFn = resolveMiddlewareModuleHandler(options.module, {\n    filePath: options.filePath,\n    isProxy: options.isProxy,\n  });\n  const normalizedPathname =\n    options.normalizedPathname ?? resolveMiddlewarePathname(options.request);\n  if (normalizedPathname instanceof Response) {\n    return { continue: false, response: normalizedPathname };\n  }\n\n  if (\n    !matchesMiddleware(\n      normalizedPathname,\n      middlewareMatcher(options.module),\n      options.request,\n      options.i18nConfig,\n    )\n  ) {\n    return { continue: true };\n  }\n\n  const nextRequest = createNextRequest(\n    options.request,\n    normalizedPathname,\n    options.i18nConfig,\n    options.basePath,\n  );\n  const fetchEvent = new NextFetchEvent({ page: normalizedPathname });\n\n  let response: Response | undefined | void;\n  try {\n    response = await middlewareFn(nextRequest, fetchEvent);\n  } catch (e) {\n    console.error(\"[vinext] Middleware error:\", e);\n    const waitUntilPromises = drainFetchEvent(fetchEvent);\n    const message = options.includeErrorDetails\n      ? \"Middleware Error: \" + (e instanceof Error ? e.message : String(e))\n      : \"Internal Server Error\";\n    return {\n      continue: false,\n      response: internalServerErrorResponse(message),\n      waitUntilPromises,\n    };\n  }\n\n  const waitUntilPromises = drainFetchEvent(fetchEvent);\n\n  if (!response) {\n    return { continue: true, waitUntilPromises };\n  }\n\n  if (response.headers.get(MIDDLEWARE_NEXT_HEADER) === \"1\") {\n    return {\n      continue: true,\n      responseHeaders: collectMiddlewareHeaders(response),\n      status: response.status !== 200 ? response.status : undefined,\n      waitUntilPromises,\n    };\n  }\n\n  if (response.status >= 300 && response.status < 400) {\n    const location = response.headers.get(\"Location\") ?? response.headers.get(\"location\");\n    if (location) {\n      const responseHeaders = new Headers();\n      for (const [key, value] of response.headers) {\n        if (!key.startsWith(MIDDLEWARE_HEADER_PREFIX) && key.toLowerCase() !== \"location\") {\n          responseHeaders.append(key, value);\n        }\n      }\n      return {\n        continue: false,\n        redirectUrl: location,\n        redirectStatus: response.status,\n        response: stripMiddlewareHeadersFromResponse(response),\n        responseHeaders,\n        waitUntilPromises,\n      };\n    }\n  }\n\n  const rewriteUrl = response.headers.get(MIDDLEWARE_REWRITE_HEADER);\n  if (rewriteUrl) {\n    let rewritePath: string;\n    try {\n      const rewriteParsed = new URL(rewriteUrl, options.request.url);\n      const requestOrigin = new URL(options.request.url).origin;\n      rewritePath =\n        rewriteParsed.origin === requestOrigin\n          ? rewriteParsed.pathname + rewriteParsed.search\n          : rewriteParsed.href;\n    } catch {\n      rewritePath = rewriteUrl;\n    }\n    return {\n      continue: true,\n      rewriteUrl: rewritePath,\n      rewriteStatus: response.status !== 200 ? response.status : undefined,\n      responseHeaders: collectMiddlewareHeaders(response),\n      status: response.status !== 200 ? response.status : undefined,\n      waitUntilPromises,\n    };\n  }\n\n  return {\n    continue: false,\n    response: stripMiddlewareHeadersFromResponse(response),\n    waitUntilPromises,\n  };\n}\n\nexport async function runGeneratedMiddleware(\n  options: RunGeneratedMiddlewareOptions,\n): Promise<MiddlewareResult> {\n  const run = () => executeMiddleware(options);\n  return options.ctx ? runWithExecutionContext(options.ctx, run) : run();\n}\n"],"mappings":"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"}
+{"version":3,"file":"middleware-runtime.js","names":[],"sources":["../../src/server/middleware-runtime.ts"],"sourcesContent":["import \"./server-globals.js\";\nimport type { NextI18nConfig } from \"../config/next-config.js\";\nimport { normalizePathnameForRouteMatchStrict } from \"../routing/utils.js\";\nimport {\n  getRequestExecutionContext,\n  runWithExecutionContext,\n  type ExecutionContextLike,\n} from \"vinext/shims/request-context\";\nimport { NextFetchEvent, NextRequest } from \"vinext/shims/server\";\nimport { normalizePath } from \"./normalize-path.js\";\nimport {\n  MIDDLEWARE_HEADER_PREFIX,\n  MIDDLEWARE_NEXT_HEADER,\n  MIDDLEWARE_REWRITE_HEADER,\n} from \"./headers.js\";\nimport { MatcherConfig, matchesMiddleware } from \"./middleware-matcher.js\";\nimport { shouldKeepMiddlewareHeader } from \"./middleware-request-headers.js\";\nimport { processMiddlewareHeaders } from \"./request-pipeline.js\";\nimport { badRequestResponse, internalServerErrorResponse } from \"./http-error-responses.js\";\nimport { mergeRewriteQuery } from \"../utils/query.js\";\n\nexport type MiddlewareModule = Record<string, unknown>;\n\nexport type MiddlewareResult = {\n  continue: boolean;\n  redirectUrl?: string;\n  redirectStatus?: number;\n  rewriteUrl?: string;\n  rewriteStatus?: number;\n  status?: number;\n  responseHeaders?: Headers;\n  response?: Response;\n  waitUntilPromises?: Promise<unknown>[];\n};\n\ntype MiddlewareHandler = (\n  request: NextRequest,\n  event: NextFetchEvent,\n) => Response | undefined | void | Promise<Response | undefined | void>;\n\ntype MiddlewareConfigExport = {\n  matcher?: MatcherConfig;\n};\n\ntype ExecuteMiddlewareOptions = {\n  basePath?: string;\n  filePath?: string;\n  i18nConfig?: NextI18nConfig | null;\n  includeErrorDetails?: boolean;\n  /**\n   * Whether the incoming request was a Next.js `_next/data` fetch (carried\n   * `x-nextjs-data: 1`). The header itself is stripped by `filterInternalHeaders`\n   * before the middleware request is constructed, so callers must capture this\n   * flag from the raw incoming headers and forward it explicitly.\n   */\n  isDataRequest?: boolean;\n  isProxy: boolean;\n  module: MiddlewareModule;\n  normalizedPathname?: string;\n  request: Request;\n  /**\n   * The user's `trailingSlash` config. Plumbed into the NextRequest's NextURL\n   * so `request.nextUrl.toString()` formats with the configured slash policy,\n   * which feeds into `NextResponse.redirect(request.nextUrl)` Location headers.\n   * Also used to normalize redirect Location pathnames returned via plain\n   * `new URL('/x', req.url)`.\n   */\n  trailingSlash?: boolean;\n};\n\ntype RunGeneratedMiddlewareOptions = ExecuteMiddlewareOptions & {\n  ctx?: ExecutionContextLike;\n};\n\nfunction isMiddlewareHandler(value: unknown): value is MiddlewareHandler {\n  return typeof value === \"function\";\n}\n\nfunction isMiddlewareConfigExport(value: unknown): value is MiddlewareConfigExport {\n  return !!value && typeof value === \"object\";\n}\n\nfunction middlewareFileLabel(isProxy: boolean): string {\n  return isProxy ? \"Proxy\" : \"Middleware\";\n}\n\nfunction middlewareExpectedExport(isProxy: boolean): string {\n  return isProxy ? \"proxy\" : \"middleware\";\n}\n\nexport function resolveMiddlewareModuleHandler(\n  mod: MiddlewareModule,\n  options: { filePath?: string; isProxy: boolean },\n): MiddlewareHandler {\n  const handler = options.isProxy ? (mod.proxy ?? mod.default) : (mod.middleware ?? mod.default);\n  if (isMiddlewareHandler(handler)) return handler;\n\n  const fileLabel = middlewareFileLabel(options.isProxy);\n  const expectedExport = middlewareExpectedExport(options.isProxy);\n  const fileSuffix = options.filePath ? ` \"${options.filePath}\"` : \"\";\n  throw new Error(\n    `The ${fileLabel} file${fileSuffix} must export a function named \\`${expectedExport}\\` or a \\`default\\` function.`,\n  );\n}\n\nfunction middlewareMatcher(mod: MiddlewareModule): MatcherConfig | undefined {\n  const config = mod.config;\n  if (!isMiddlewareConfigExport(config)) return undefined;\n  return config.matcher;\n}\n\nfunction stripMiddlewareHeadersFromResponse(response: Response): Response {\n  const headers = new Headers(response.headers);\n  processMiddlewareHeaders(headers);\n  return new Response(response.body, {\n    status: response.status,\n    statusText: response.statusText,\n    headers,\n  });\n}\n\n/**\n * Make a same-host URL relative to the request origin. Cross-origin URLs are\n * returned unchanged. Mirrors Next.js's `getRelativeURL` behaviour:\n * https://github.com/vercel/next.js/blob/canary/packages/next/src/shared/lib/router/utils/relativize-url.ts\n */\nfunction relativizeLocation(location: string, requestUrl: string): string {\n  let parsed: URL;\n  try {\n    parsed = new URL(location, requestUrl);\n  } catch {\n    return location;\n  }\n  const base = new URL(requestUrl);\n  if (parsed.origin !== base.origin) return parsed.toString();\n  return parsed.pathname + parsed.search + parsed.hash;\n}\n\n/**\n * Translate a middleware redirect Response into the soft-redirect protocol\n * used by Next.js for `_next/data` requests: a 200 OK with the redirect target\n * carried in the `x-nextjs-redirect` header. The client router consumes this\n * header to perform the navigation, avoiding CORS issues that would arise from\n * an actual cross-origin HTTP redirect on a data fetch.\n *\n * Reference: packages/next/src/server/web/adapter.ts\n * https://github.com/vercel/next.js/blob/canary/packages/next/src/server/web/adapter.ts\n */\nfunction dataRedirectResponse(target: string, originalResponse: Response): Response {\n  const headers = new Headers(originalResponse.headers);\n  processMiddlewareHeaders(headers);\n  // Headers.delete is case-insensitive per the Fetch spec, so a single call\n  // covers `Location` / `location` / `LOCATION`.\n  headers.delete(\"Location\");\n  headers.set(\"x-nextjs-redirect\", target);\n  return new Response(null, { status: 200, headers });\n}\n\nfunction collectMiddlewareHeaders(response: Response): Headers {\n  const responseHeaders = new Headers();\n  for (const [key, value] of response.headers) {\n    if (!key.startsWith(MIDDLEWARE_HEADER_PREFIX) || shouldKeepMiddlewareHeader(key)) {\n      responseHeaders.append(key, value);\n    }\n  }\n  return responseHeaders;\n}\n\nfunction drainFetchEvent(fetchEvent: NextFetchEvent): Promise<unknown>[] {\n  const waitUntilPromises = fetchEvent.waitUntilPromises;\n  const drained = fetchEvent.drainWaitUntil();\n  const executionContext = getRequestExecutionContext();\n  if (executionContext) {\n    executionContext.waitUntil(drained);\n  } else {\n    void drained;\n  }\n  return waitUntilPromises;\n}\n\nfunction resolveMiddlewarePathname(request: Request): string | Response {\n  const url = new URL(request.url);\n  try {\n    return normalizePath(normalizePathnameForRouteMatchStrict(url.pathname));\n  } catch {\n    return badRequestResponse();\n  }\n}\n\nfunction createNextRequest(\n  request: Request,\n  normalizedPathname: string,\n  i18nConfig?: NextI18nConfig | null,\n  basePath?: string,\n  trailingSlash?: boolean,\n): NextRequest {\n  const url = new URL(request.url);\n  // Middleware gets an isolated body branch; downstream routing keeps owning\n  // the original request body.\n  let mwRequest = request.body && !request.bodyUsed ? request.clone() : request;\n  if (normalizedPathname !== url.pathname) {\n    const mwUrl = new URL(url);\n    mwUrl.pathname = normalizedPathname;\n    mwRequest = new Request(mwUrl, mwRequest);\n  }\n\n  const hasNextConfig = basePath || i18nConfig || trailingSlash;\n  const nextConfig = hasNextConfig\n    ? {\n        basePath: basePath ?? \"\",\n        i18n: i18nConfig ?? undefined,\n        trailingSlash: trailingSlash ?? undefined,\n      }\n    : undefined;\n\n  return mwRequest instanceof NextRequest\n    ? mwRequest\n    : new NextRequest(mwRequest, nextConfig ? { nextConfig } : undefined);\n}\n\nexport async function executeMiddleware(\n  options: ExecuteMiddlewareOptions,\n): Promise<MiddlewareResult> {\n  const middlewareFn = resolveMiddlewareModuleHandler(options.module, {\n    filePath: options.filePath,\n    isProxy: options.isProxy,\n  });\n  const normalizedPathname =\n    options.normalizedPathname ?? resolveMiddlewarePathname(options.request);\n  if (normalizedPathname instanceof Response) {\n    return { continue: false, response: normalizedPathname };\n  }\n\n  if (\n    !matchesMiddleware(\n      normalizedPathname,\n      middlewareMatcher(options.module),\n      options.request,\n      options.i18nConfig,\n    )\n  ) {\n    return { continue: true };\n  }\n\n  const nextRequest = createNextRequest(\n    options.request,\n    normalizedPathname,\n    options.i18nConfig,\n    options.basePath,\n    options.trailingSlash,\n  );\n  const fetchEvent = new NextFetchEvent({ page: normalizedPathname });\n\n  let response: Response | undefined | void;\n  try {\n    response = await middlewareFn(nextRequest, fetchEvent);\n  } catch (e) {\n    console.error(\"[vinext] Middleware error:\", e);\n    const waitUntilPromises = drainFetchEvent(fetchEvent);\n    const message = options.includeErrorDetails\n      ? \"Middleware Error: \" + (e instanceof Error ? e.message : String(e))\n      : \"Internal Server Error\";\n    return {\n      continue: false,\n      response: internalServerErrorResponse(message),\n      waitUntilPromises,\n    };\n  }\n\n  const waitUntilPromises = drainFetchEvent(fetchEvent);\n\n  if (!response) {\n    return { continue: true, waitUntilPromises };\n  }\n\n  if (response.headers.get(MIDDLEWARE_NEXT_HEADER) === \"1\") {\n    return {\n      continue: true,\n      responseHeaders: collectMiddlewareHeaders(response),\n      status: response.status !== 200 ? response.status : undefined,\n      waitUntilPromises,\n    };\n  }\n\n  if (response.status >= 300 && response.status < 400) {\n    const location = response.headers.get(\"Location\") ?? response.headers.get(\"location\");\n    if (location) {\n      // Make same-host Location relative for parity with Next.js, which only\n      // emits absolute URLs for cross-origin redirects:\n      // https://github.com/vercel/next.js/blob/canary/packages/next/src/server/web/adapter.ts\n      const relativeLocation = relativizeLocation(location, options.request.url);\n\n      // For `_next/data` requests, translate the HTTP redirect into the\n      // `x-nextjs-redirect` soft-redirect protocol so the client router can\n      // perform the navigation without tripping CORS on cross-origin targets.\n      // `x-nextjs-data` lives in INTERNAL_HEADERS and is stripped before the\n      // middleware request is constructed, so the flag is threaded in from the\n      // caller (which sees the raw incoming headers).\n      if (options.isDataRequest) {\n        return {\n          continue: false,\n          response: dataRedirectResponse(relativeLocation, response),\n          waitUntilPromises,\n        };\n      }\n\n      const responseHeaders = new Headers();\n      for (const [key, value] of response.headers) {\n        if (!key.startsWith(MIDDLEWARE_HEADER_PREFIX) && key.toLowerCase() !== \"location\") {\n          responseHeaders.append(key, value);\n        }\n      }\n      // Rebuild the response with the relativized Location so consumers that\n      // forward `result.response` (rather than `result.redirectUrl`) also send\n      // the correct header.\n      const relativizedResponseHeaders = new Headers(response.headers);\n      relativizedResponseHeaders.set(\"Location\", relativeLocation);\n      const relativizedResponse = new Response(response.body, {\n        status: response.status,\n        statusText: response.statusText,\n        headers: relativizedResponseHeaders,\n      });\n      return {\n        continue: false,\n        redirectUrl: relativeLocation,\n        redirectStatus: response.status,\n        response: stripMiddlewareHeadersFromResponse(relativizedResponse),\n        responseHeaders,\n        waitUntilPromises,\n      };\n    }\n  }\n\n  const rewriteUrl = response.headers.get(MIDDLEWARE_REWRITE_HEADER);\n  if (rewriteUrl) {\n    let rewritePath: string;\n    try {\n      const rewriteParsed = new URL(rewriteUrl, options.request.url);\n      const requestOrigin = new URL(options.request.url).origin;\n      if (rewriteParsed.origin === requestOrigin) {\n        // Preserve the original request's query params on internal rewrites.\n        // Next.js merges via `Object.assign(parsedUrl.query, rewrittenParsedUrl.query)`\n        // — original query first, rewrite-target overrides on key conflicts.\n        rewritePath = mergeRewriteQuery(\n          options.request.url,\n          rewriteParsed.pathname + rewriteParsed.search,\n        );\n      } else {\n        // External rewrites are proxied as-is; don't smuggle local query params\n        // into the upstream URL.\n        rewritePath = rewriteParsed.href;\n      }\n    } catch {\n      rewritePath = rewriteUrl;\n    }\n    return {\n      continue: true,\n      rewriteUrl: rewritePath,\n      rewriteStatus: response.status !== 200 ? response.status : undefined,\n      responseHeaders: collectMiddlewareHeaders(response),\n      status: response.status !== 200 ? response.status : undefined,\n      waitUntilPromises,\n    };\n  }\n\n  return {\n    continue: false,\n    response: stripMiddlewareHeadersFromResponse(response),\n    waitUntilPromises,\n  };\n}\n\nexport async function runGeneratedMiddleware(\n  options: RunGeneratedMiddlewareOptions,\n): Promise<MiddlewareResult> {\n  const run = () => executeMiddleware(options);\n  return options.ctx ? runWithExecutionContext(options.ctx, run) : run();\n}\n"],"mappings":"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"}

package/dist/server/middleware.d.ts

@@ -31,6 +31,18 @@ declare function resolveMiddlewareHandler(mod: MiddlewareModule, filePath: strin
  * Find the proxy or middleware file in the project root.
  * Checks for proxy.ts (Next.js 16) first, then falls back to middleware.ts.
  * If middleware.ts is found, logs a deprecation warning.
+ *
+ * Note on log noise: this function is called from Vite's `config` hook, which
+ * fires once per build environment (RSC, SSR, client, …). That means a project
+ * still using `middleware.ts` will see this warning emitted 2–3 times per
+ * build. The warning is benign — it does not abort the build. Next.js itself
+ * emits the same message via `Log.warnOnce`; matching that parity would
+ * require either a per-root deduplication map or hoisting the warning out of
+ * this function (e.g. into the plugin's `configResolved` hook). Tracked as a
+ * follow-up; see the deploy-suite investigation in run 25870737355.
+ *
+ * @see https://github.com/vercel/next.js/blob/canary/packages/next/src/build/index.ts
+ *   (search for "MIDDLEWARE_FILENAME" + "file convention is deprecated")
  */
 declare function findMiddlewareFile(root: string, fileMatcher: ValidFileMatcher): string | null;
 /**
@@ -45,7 +57,7 @@ declare function findMiddlewareFile(root: string, fileMatcher: ValidFileMatcher)
  * @param request - The incoming Request object
  * @returns Middleware result describing what action to take
  */
-declare function runMiddleware(runner: ModuleRunner, middlewarePath: string, request: Request, i18nConfig?: NextI18nConfig | null, basePath?: string): Promise<MiddlewareResult>;
+declare function runMiddleware(runner: ModuleRunner, middlewarePath: string, request: Request, i18nConfig?: NextI18nConfig | null, basePath?: string, trailingSlash?: boolean, isDataRequest?: boolean): Promise<MiddlewareResult>;
 //#endregion
 export { findMiddlewareFile, isProxyFile, matchPattern, matchesMiddleware, resolveMiddlewareHandler, runMiddleware };
 //# sourceMappingURL=middleware.d.ts.map

package/dist/server/middleware.js

@@ -37,6 +37,18 @@ const MIDDLEWARE_LOCATIONS = ["", "src/"];
 * Find the proxy or middleware file in the project root.
 * Checks for proxy.ts (Next.js 16) first, then falls back to middleware.ts.
 * If middleware.ts is found, logs a deprecation warning.
+*
+* Note on log noise: this function is called from Vite's `config` hook, which
+* fires once per build environment (RSC, SSR, client, …). That means a project
+* still using `middleware.ts` will see this warning emitted 2–3 times per
+* build. The warning is benign — it does not abort the build. Next.js itself
+* emits the same message via `Log.warnOnce`; matching that parity would
+* require either a per-root deduplication map or hoisting the warning out of
+* this function (e.g. into the plugin's `configResolved` hook). Tracked as a
+* follow-up; see the deploy-suite investigation in run 25870737355.
+*
+* @see https://github.com/vercel/next.js/blob/canary/packages/next/src/build/index.ts
+*   (search for "MIDDLEWARE_FILENAME" + "file convention is deprecated")
 */
 function findMiddlewareFile(root, fileMatcher) {
 	for (const dir of MIDDLEWARE_LOCATIONS) for (const ext of fileMatcher.dottedExtensions) {
@@ -67,7 +79,7 @@ function isMiddlewareModule(value) {
 * @param request - The incoming Request object
 * @returns Middleware result describing what action to take
 */
-async function runMiddleware(runner, middlewarePath, request, i18nConfig, basePath) {
+async function runMiddleware(runner, middlewarePath, request, i18nConfig, basePath, trailingSlash, isDataRequest) {
 	const mod = await runner.import(middlewarePath);
 	if (!isMiddlewareModule(mod)) throw new Error(`Middleware module "${middlewarePath}" did not evaluate to an object.`);
 	return runGeneratedMiddleware({
@@ -75,9 +87,11 @@ async function runMiddleware(runner, middlewarePath, request, i18nConfig, basePa
 		filePath: middlewarePath,
 		i18nConfig,
 		includeErrorDetails: process.env.NODE_ENV !== "production",
+		isDataRequest,
 		isProxy: isProxyFile(middlewarePath),
 		module: mod,
-		request
+		request,
+		trailingSlash
 	});
 }
 //#endregion

package/dist/server/middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.js","names":[],"sources":["../../src/server/middleware.ts"],"sourcesContent":["/**\n * proxy.ts / middleware.ts runner\n *\n * Loads and executes the user's proxy.ts (Next.js 16) or middleware.ts file\n * before routing. Runs in Node (not Edge Runtime), per the vinext design.\n *\n * In Next.js 16, proxy.ts replaces middleware.ts:\n * - proxy.ts: default export OR named `proxy` function, runs on Node.js runtime\n * - middleware.ts: deprecated but still supported for Edge runtime use cases\n *\n * The proxy/middleware receives a NextRequest and can:\n * - Return NextResponse.next() to continue to the route\n * - Return NextResponse.redirect() to redirect\n * - Return NextResponse.rewrite() to rewrite the URL\n * - Set/modify headers and cookies\n * - Return a Response directly (e.g., for auth guards)\n *\n * Supports the `config.matcher` export for path filtering.\n */\n\nimport type { ModuleRunner } from \"vite/module-runner\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport type { NextI18nConfig } from \"../config/next-config.js\";\nimport { ValidFileMatcher } from \"../routing/file-matcher.js\";\nimport {\n  resolveMiddlewareModuleHandler,\n  runGeneratedMiddleware,\n  type MiddlewareModule,\n  type MiddlewareResult,\n} from \"./middleware-runtime.js\";\n\nexport { matchPattern, matchesMiddleware } from \"./middleware-matcher.js\";\n\n/**\n * Determine whether a middleware/proxy file path refers to a proxy file.\n * proxy.ts files accept `proxy` or `default` exports.\n * middleware.ts files accept `middleware` or `default` exports.\n *\n * Matches Next.js behavior where each file type only accepts its own\n * named export or a default export:\n * https://github.com/vercel/next.js/blob/canary/packages/next/src/build/templates/middleware.ts\n */\nexport function isProxyFile(filePath: string): boolean {\n  const base = path.basename(filePath).replace(/\\.\\w+$/, \"\");\n  return base === \"proxy\";\n}\n\n/**\n * Resolve the middleware/proxy handler function from a module's exports.\n * Matches Next.js behavior: for proxy files, check `proxy` then `default`;\n * for middleware files, check `middleware` then `default`.\n *\n * Throws if the file exists but doesn't export a valid function, matching\n * Next.js's ProxyMissingExportError behavior.\n *\n * @see https://github.com/vercel/next.js/blob/canary/packages/next/src/build/templates/middleware.ts\n * @see https://github.com/vercel/next.js/blob/canary/test/e2e/app-dir/proxy-missing-export/proxy-missing-export.test.ts\n */\nexport function resolveMiddlewareHandler(mod: MiddlewareModule, filePath: string) {\n  return resolveMiddlewareModuleHandler(mod, {\n    filePath,\n    isProxy: isProxyFile(filePath),\n  });\n}\n\nconst MIDDLEWARE_LOCATIONS = [\"\", \"src/\"];\n\n/**\n * Find the proxy or middleware file in the project root.\n * Checks for proxy.ts (Next.js 16) first, then falls back to middleware.ts.\n * If middleware.ts is found, logs a deprecation warning.\n */\nexport function findMiddlewareFile(root: string, fileMatcher: ValidFileMatcher): string | null {\n  // Check proxy.ts first (Next.js 16 replacement for middleware.ts)\n  for (const dir of MIDDLEWARE_LOCATIONS) {\n    for (const ext of fileMatcher.dottedExtensions) {\n      const fullPath = path.join(root, dir, `proxy${ext}`);\n      if (fs.existsSync(fullPath)) {\n        return fullPath;\n      }\n    }\n  }\n\n  // Fall back to middleware.ts (deprecated in Next.js 16)\n  for (const dir of MIDDLEWARE_LOCATIONS) {\n    for (const ext of fileMatcher.dottedExtensions) {\n      const fullPath = path.join(root, dir, `middleware${ext}`);\n      if (fs.existsSync(fullPath)) {\n        console.warn(\n          \"[vinext] middleware.ts is deprecated in Next.js 16. \" +\n            \"Rename to proxy.ts and export a default or named proxy function.\",\n        );\n        return fullPath;\n      }\n    }\n  }\n  return null;\n}\n\nfunction isMiddlewareModule(value: unknown): value is MiddlewareModule {\n  return !!value && typeof value === \"object\";\n}\n\n/**\n * Load and execute middleware for a given request.\n *\n * @param runner - A ModuleRunner used to load the middleware module.\n *   Must be a long-lived instance created once (e.g. in configureServer) via\n *   createDirectRunner() — NOT recreated per request. Using server.ssrLoadModule\n *   directly crashes with `outsideEmitter` when @cloudflare/vite-plugin is\n *   present because SSRCompatModuleRunner reads environment.hot.api synchronously.\n * @param middlewarePath - Absolute path to the middleware file\n * @param request - The incoming Request object\n * @returns Middleware result describing what action to take\n */\nexport async function runMiddleware(\n  runner: ModuleRunner,\n  middlewarePath: string,\n  request: Request,\n  i18nConfig?: NextI18nConfig | null,\n  basePath?: string,\n): Promise<MiddlewareResult> {\n  // Load the middleware module via the direct-call ModuleRunner.\n  // This bypasses the hot channel entirely and is safe with all Vite plugin\n  // combinations, including @cloudflare/vite-plugin.\n  const mod = await runner.import(middlewarePath);\n  if (!isMiddlewareModule(mod)) {\n    throw new Error(`Middleware module \"${middlewarePath}\" did not evaluate to an object.`);\n  }\n\n  return runGeneratedMiddleware({\n    basePath,\n    filePath: middlewarePath,\n    i18nConfig,\n    includeErrorDetails: process.env.NODE_ENV !== \"production\",\n    isProxy: isProxyFile(middlewarePath),\n    module: mod,\n    request,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;AA2CA,SAAgB,YAAY,UAA2B;CAErD,OADa,KAAK,SAAS,SAAS,CAAC,QAAQ,UAAU,GAC5C,KAAK;;;;;;;;;;;;;AAclB,SAAgB,yBAAyB,KAAuB,UAAkB;CAChF,OAAO,+BAA+B,KAAK;EACzC;EACA,SAAS,YAAY,SAAS;EAC/B,CAAC;;AAGJ,MAAM,uBAAuB,CAAC,IAAI,OAAO;;;;;;AAOzC,SAAgB,mBAAmB,MAAc,aAA8C;CAE7F,KAAK,MAAM,OAAO,sBAChB,KAAK,MAAM,OAAO,YAAY,kBAAkB;EAC9C,MAAM,WAAW,KAAK,KAAK,MAAM,KAAK,QAAQ,MAAM;EACpD,IAAI,GAAG,WAAW,SAAS,EACzB,OAAO;;CAMb,KAAK,MAAM,OAAO,sBAChB,KAAK,MAAM,OAAO,YAAY,kBAAkB;EAC9C,MAAM,WAAW,KAAK,KAAK,MAAM,KAAK,aAAa,MAAM;EACzD,IAAI,GAAG,WAAW,SAAS,EAAE;GAC3B,QAAQ,KACN,uHAED;GACD,OAAO;;;CAIb,OAAO;;AAGT,SAAS,mBAAmB,OAA2C;CACrE,OAAO,CAAC,CAAC,SAAS,OAAO,UAAU;;;;;;;;;;;;;;AAerC,eAAsB,cACpB,QACA,gBACA,SACA,YACA,UAC2B;CAI3B,MAAM,MAAM,MAAM,OAAO,OAAO,eAAe;CAC/C,IAAI,CAAC,mBAAmB,IAAI,EAC1B,MAAM,IAAI,MAAM,sBAAsB,eAAe,kCAAkC;CAGzF,OAAO,uBAAuB;EAC5B;EACA,UAAU;EACV;EACA,qBAAqB,QAAQ,IAAI,aAAa;EAC9C,SAAS,YAAY,eAAe;EACpC,QAAQ;EACR;EACD,CAAC"}
+{"version":3,"file":"middleware.js","names":[],"sources":["../../src/server/middleware.ts"],"sourcesContent":["/**\n * proxy.ts / middleware.ts runner\n *\n * Loads and executes the user's proxy.ts (Next.js 16) or middleware.ts file\n * before routing. Runs in Node (not Edge Runtime), per the vinext design.\n *\n * In Next.js 16, proxy.ts replaces middleware.ts:\n * - proxy.ts: default export OR named `proxy` function, runs on Node.js runtime\n * - middleware.ts: deprecated but still supported for Edge runtime use cases\n *\n * The proxy/middleware receives a NextRequest and can:\n * - Return NextResponse.next() to continue to the route\n * - Return NextResponse.redirect() to redirect\n * - Return NextResponse.rewrite() to rewrite the URL\n * - Set/modify headers and cookies\n * - Return a Response directly (e.g., for auth guards)\n *\n * Supports the `config.matcher` export for path filtering.\n */\n\nimport type { ModuleRunner } from \"vite/module-runner\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport type { NextI18nConfig } from \"../config/next-config.js\";\nimport { ValidFileMatcher } from \"../routing/file-matcher.js\";\nimport {\n  resolveMiddlewareModuleHandler,\n  runGeneratedMiddleware,\n  type MiddlewareModule,\n  type MiddlewareResult,\n} from \"./middleware-runtime.js\";\n\nexport { matchPattern, matchesMiddleware } from \"./middleware-matcher.js\";\n\n/**\n * Determine whether a middleware/proxy file path refers to a proxy file.\n * proxy.ts files accept `proxy` or `default` exports.\n * middleware.ts files accept `middleware` or `default` exports.\n *\n * Matches Next.js behavior where each file type only accepts its own\n * named export or a default export:\n * https://github.com/vercel/next.js/blob/canary/packages/next/src/build/templates/middleware.ts\n */\nexport function isProxyFile(filePath: string): boolean {\n  const base = path.basename(filePath).replace(/\\.\\w+$/, \"\");\n  return base === \"proxy\";\n}\n\n/**\n * Resolve the middleware/proxy handler function from a module's exports.\n * Matches Next.js behavior: for proxy files, check `proxy` then `default`;\n * for middleware files, check `middleware` then `default`.\n *\n * Throws if the file exists but doesn't export a valid function, matching\n * Next.js's ProxyMissingExportError behavior.\n *\n * @see https://github.com/vercel/next.js/blob/canary/packages/next/src/build/templates/middleware.ts\n * @see https://github.com/vercel/next.js/blob/canary/test/e2e/app-dir/proxy-missing-export/proxy-missing-export.test.ts\n */\nexport function resolveMiddlewareHandler(mod: MiddlewareModule, filePath: string) {\n  return resolveMiddlewareModuleHandler(mod, {\n    filePath,\n    isProxy: isProxyFile(filePath),\n  });\n}\n\nconst MIDDLEWARE_LOCATIONS = [\"\", \"src/\"];\n\n/**\n * Find the proxy or middleware file in the project root.\n * Checks for proxy.ts (Next.js 16) first, then falls back to middleware.ts.\n * If middleware.ts is found, logs a deprecation warning.\n *\n * Note on log noise: this function is called from Vite's `config` hook, which\n * fires once per build environment (RSC, SSR, client, …). That means a project\n * still using `middleware.ts` will see this warning emitted 2–3 times per\n * build. The warning is benign — it does not abort the build. Next.js itself\n * emits the same message via `Log.warnOnce`; matching that parity would\n * require either a per-root deduplication map or hoisting the warning out of\n * this function (e.g. into the plugin's `configResolved` hook). Tracked as a\n * follow-up; see the deploy-suite investigation in run 25870737355.\n *\n * @see https://github.com/vercel/next.js/blob/canary/packages/next/src/build/index.ts\n *   (search for \"MIDDLEWARE_FILENAME\" + \"file convention is deprecated\")\n */\nexport function findMiddlewareFile(root: string, fileMatcher: ValidFileMatcher): string | null {\n  // Check proxy.ts first (Next.js 16 replacement for middleware.ts)\n  for (const dir of MIDDLEWARE_LOCATIONS) {\n    for (const ext of fileMatcher.dottedExtensions) {\n      const fullPath = path.join(root, dir, `proxy${ext}`);\n      if (fs.existsSync(fullPath)) {\n        return fullPath;\n      }\n    }\n  }\n\n  // Fall back to middleware.ts (deprecated in Next.js 16).\n  // This is a warning, not an error: middleware.ts is still fully supported\n  // by both Next.js 16 and vinext. Do not change to `throw` or `process.exit`.\n  for (const dir of MIDDLEWARE_LOCATIONS) {\n    for (const ext of fileMatcher.dottedExtensions) {\n      const fullPath = path.join(root, dir, `middleware${ext}`);\n      if (fs.existsSync(fullPath)) {\n        console.warn(\n          \"[vinext] middleware.ts is deprecated in Next.js 16. \" +\n            \"Rename to proxy.ts and export a default or named proxy function.\",\n        );\n        return fullPath;\n      }\n    }\n  }\n  return null;\n}\n\nfunction isMiddlewareModule(value: unknown): value is MiddlewareModule {\n  return !!value && typeof value === \"object\";\n}\n\n/**\n * Load and execute middleware for a given request.\n *\n * @param runner - A ModuleRunner used to load the middleware module.\n *   Must be a long-lived instance created once (e.g. in configureServer) via\n *   createDirectRunner() — NOT recreated per request. Using server.ssrLoadModule\n *   directly crashes with `outsideEmitter` when @cloudflare/vite-plugin is\n *   present because SSRCompatModuleRunner reads environment.hot.api synchronously.\n * @param middlewarePath - Absolute path to the middleware file\n * @param request - The incoming Request object\n * @returns Middleware result describing what action to take\n */\nexport async function runMiddleware(\n  runner: ModuleRunner,\n  middlewarePath: string,\n  request: Request,\n  i18nConfig?: NextI18nConfig | null,\n  basePath?: string,\n  trailingSlash?: boolean,\n  isDataRequest?: boolean,\n): Promise<MiddlewareResult> {\n  // Load the middleware module via the direct-call ModuleRunner.\n  // This bypasses the hot channel entirely and is safe with all Vite plugin\n  // combinations, including @cloudflare/vite-plugin.\n  const mod = await runner.import(middlewarePath);\n  if (!isMiddlewareModule(mod)) {\n    throw new Error(`Middleware module \"${middlewarePath}\" did not evaluate to an object.`);\n  }\n\n  return runGeneratedMiddleware({\n    basePath,\n    filePath: middlewarePath,\n    i18nConfig,\n    includeErrorDetails: process.env.NODE_ENV !== \"production\",\n    isDataRequest,\n    isProxy: isProxyFile(middlewarePath),\n    module: mod,\n    request,\n    trailingSlash,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;AA2CA,SAAgB,YAAY,UAA2B;CAErD,OADa,KAAK,SAAS,SAAS,CAAC,QAAQ,UAAU,GAC5C,KAAK;;;;;;;;;;;;;AAclB,SAAgB,yBAAyB,KAAuB,UAAkB;CAChF,OAAO,+BAA+B,KAAK;EACzC;EACA,SAAS,YAAY,SAAS;EAC/B,CAAC;;AAGJ,MAAM,uBAAuB,CAAC,IAAI,OAAO;;;;;;;;;;;;;;;;;;AAmBzC,SAAgB,mBAAmB,MAAc,aAA8C;CAE7F,KAAK,MAAM,OAAO,sBAChB,KAAK,MAAM,OAAO,YAAY,kBAAkB;EAC9C,MAAM,WAAW,KAAK,KAAK,MAAM,KAAK,QAAQ,MAAM;EACpD,IAAI,GAAG,WAAW,SAAS,EACzB,OAAO;;CAQb,KAAK,MAAM,OAAO,sBAChB,KAAK,MAAM,OAAO,YAAY,kBAAkB;EAC9C,MAAM,WAAW,KAAK,KAAK,MAAM,KAAK,aAAa,MAAM;EACzD,IAAI,GAAG,WAAW,SAAS,EAAE;GAC3B,QAAQ,KACN,uHAED;GACD,OAAO;;;CAIb,OAAO;;AAGT,SAAS,mBAAmB,OAA2C;CACrE,OAAO,CAAC,CAAC,SAAS,OAAO,UAAU;;;;;;;;;;;;;;AAerC,eAAsB,cACpB,QACA,gBACA,SACA,YACA,UACA,eACA,eAC2B;CAI3B,MAAM,MAAM,MAAM,OAAO,OAAO,eAAe;CAC/C,IAAI,CAAC,mBAAmB,IAAI,EAC1B,MAAM,IAAI,MAAM,sBAAsB,eAAe,kCAAkC;CAGzF,OAAO,uBAAuB;EAC5B;EACA,UAAU;EACV;EACA,qBAAqB,QAAQ,IAAI,aAAa;EAC9C;EACA,SAAS,YAAY,eAAe;EACpC,QAAQ;EACR;EACA;EACD,CAAC"}

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

@@ -1,4 +1,6 @@
 import { RouteManifest } from "../routing/app-route-graph.js";
+import { CacheEntryReuseDecision, CacheEntryReuseProof } from "./cache-proof.js";
+import { AppElementsSlotBinding } from "./app-elements-wire.js";
 import { NavigationTrace, NavigationTraceFields } from "./navigation-trace.js";
 
 //#region src/server/navigation-planner.d.ts
@@ -13,17 +15,28 @@ type OperationToken = {
   cacheVariantFingerprint?: string;
 };
 type RouteSnapshotV0 = {
+  interception: InterceptionSnapshotV0 | null;
+  interceptionContext: string | null;
   routeId: string;
   layoutIds: readonly string[];
   mountedParallelSlots: readonly MountedParallelSlotSnapshotV0[];
   rootBoundaryId: string | null;
   displayUrl: string;
   matchedUrl: string;
+  slotBindings: readonly ParallelSlotBindingSnapshotV0[];
+};
+type InterceptionSnapshotV0 = {
+  sourceMatchedUrl: string;
+  sourceRouteId: string;
+  slotId: string;
+  targetMatchedUrl: string;
+  targetRouteId: string;
 };
 type MountedParallelSlotSnapshotV0 = {
   slotId: string;
   ownerLayoutId: string | null;
 };
+type ParallelSlotBindingSnapshotV0 = AppElementsSlotBinding;
 type NavigationPlannerStateV0 = {
   nextOperationToken: OperationToken;
   traceFields?: NavigationTraceFields;
@@ -31,6 +44,7 @@ type NavigationPlannerStateV0 = {
   visibleSnapshot: RouteSnapshotV0;
 };
 type RefreshScope = "visible";
+type TraverseDirection = "back" | "forward" | "unknown";
 type NavigationEvent = {
   kind: "navigate";
   href: string;
@@ -40,7 +54,7 @@ type NavigationEvent = {
   scope: RefreshScope;
 } | {
   kind: "traverse";
-  direction: "back" | "forward";
+  direction: TraverseDirection;
   historyState: unknown;
 } | {
   kind: "prefetch";
@@ -55,7 +69,7 @@ type RequestedWork = {
   href: string;
   mode: "push" | "replace" | "refresh";
 } | {
-  direction: "back" | "forward";
+  direction: TraverseDirection;
   historyState: unknown;
   kind: "traverseFlight";
 } | {
@@ -63,14 +77,16 @@ type RequestedWork = {
   href: string;
 };
 type CommitProposal = {
+  cacheEntryReuseDecision?: AcceptedCacheEntryReuseDecision;
   preserveAbsentSlots: boolean;
   preserveElementIds: readonly string[];
-  reason: "currentRootBoundary" | "rootBoundaryUnknownFallback";
+  preservePreviousSlotIds: readonly string[];
+  reason: "currentRootBoundary" | "interceptedCurrentRootBoundary" | "unprovenTopologyFallback";
   targetSnapshot: RouteSnapshotV0;
 };
 type NoCommitReason = "prefetchOnly";
-type HardNavigationReason = "rootBoundaryChanged";
-type RootBoundaryTransition = "currentRootBoundary" | "rootBoundaryChanged" | "rootBoundaryUnknownFallback";
+type HardNavigationReason = "cacheProofRejected" | "interceptionProofRejected" | "rootBoundaryChanged";
+type RootBoundaryTransition = "currentRootBoundary" | "rootBoundaryChanged" | "rootBoundaryUnknown";
 type NavigationDecisionV0 = {
   kind: "requestWork";
   token: OperationToken;
@@ -94,6 +110,7 @@ type NavigationDecisionV0 = {
   trace: NavigationTrace;
 };
 type FlightResultV0 = {
+  cacheEntryReuseProof?: CacheEntryReuseProof;
   href: string;
   targetSnapshot: RouteSnapshotV0;
 };
@@ -102,6 +119,9 @@ type NavigationPlannerInput = {
   state: NavigationPlannerStateV0;
   event: NavigationEvent;
 };
+type AcceptedCacheEntryReuseDecision = Extract<CacheEntryReuseDecision, {
+  canReuse: true;
+}>;
 declare function classifyRootBoundaryTransition(currentRootBoundaryId: string | null, nextRootBoundaryId: string | null): RootBoundaryTransition;
 declare function resolveSameLayoutAncestorPersistence(currentSnapshot: RouteSnapshotV0, targetSnapshot: RouteSnapshotV0): readonly string[];
 declare function resolveMountedParallelSlotPersistence(currentSnapshot: RouteSnapshotV0, targetSnapshot: RouteSnapshotV0): readonly string[];
@@ -115,5 +135,5 @@ declare const navigationPlanner: {
   resolveSameLayoutAncestorPersistence: typeof resolveSameLayoutAncestorPersistence;
 };
 //#endregion
-export { CommitProposal, FlightResultV0, HardNavigationReason, MountedParallelSlotSnapshotV0, NavigationDecisionV0, NavigationEvent, NavigationPlannerInput, NavigationPlannerStateV0, NoCommitReason, OperationLane, OperationToken, RefreshScope, RequestedWork, RootBoundaryTransition, RouteSnapshotV0, navigationPlanner };
+export { CommitProposal, FlightResultV0, HardNavigationReason, InterceptionSnapshotV0, MountedParallelSlotSnapshotV0, NavigationDecisionV0, NavigationEvent, NavigationPlannerInput, NavigationPlannerStateV0, NoCommitReason, OperationLane, OperationToken, ParallelSlotBindingSnapshotV0, RefreshScope, RequestedWork, RootBoundaryTransition, RouteSnapshotV0, TraverseDirection, navigationPlanner };
 //# sourceMappingURL=navigation-planner.d.ts.map