@tanstack/start-server-core 1.169.5 → 1.169.6

package/dist/esm/createStartHandler.js

@@ -8,7 +8,7 @@ import { ServerFunctionSerializationAdapter } from "./serializer/ServerFunctionS
 import { createMemoryHistory } from "@tanstack/history";
 import { createCsrfMiddleware, createNullProtoObject, csrfSymbol, flattenMiddlewares, mergeHeaders, safeObjectMerge } from "@tanstack/start-client-core";
 import { executeRewriteInput, isRedirect, isResolvedRedirect } from "@tanstack/router-core";
-import { attachRouterServerSsrUtils, getNormalizedURL, getOrigin } from "@tanstack/router-core/ssr/server";
+import { attachRouterServerSsrUtils, getNormalizedURL, getOrigin, isSsrResponse, normalizeSsrResponse, replaceSsrResponse, stripSsrResponseBody } from "@tanstack/router-core/ssr/server";
 import { getStartContext, runWithStartContext } from "@tanstack/start-storage-context";
 //#region src/createStartHandler.ts
 function getStartResponseHeaders(opts) {
@@ -90,18 +90,48 @@ function isSpecialResponse(value) {
 * Normalize middleware result to context shape
 */
 function handleCtxResult(result) {
-	if (isSpecialResponse(result)) return { response: result };
+	if (isSsrResponse(result) || isSpecialResponse(result)) return { response: result };
 	return result;
 }
 /**
 * Execute a middleware chain
 */
-function executeMiddleware(middlewares, ctx) {
+async function executeMiddleware(middlewares, ctx) {
 	let index = -1;
+	let streamResponse;
+	const setResponse = (response) => {
+		if (isSsrResponse(response)) {
+			if (response.serverSsrCleanup === "stream") streamResponse = response;
+			ctx.response = response.response;
+			return;
+		}
+		ctx.response = response;
+	};
+	const disposeStreamResponse = async (reason) => {
+		const response = streamResponse;
+		if (!response) return;
+		streamResponse = void 0;
+		const currentResponse = ctx.response;
+		if (currentResponse === response.response || currentResponse instanceof Response && response.response.body !== null && currentResponse.body === response.response.body) ctx.response = void 0;
+		await response.dispose(reason);
+	};
+	const getFinalResponse = async () => {
+		const response = ctx.response;
+		if (!response) throwRouteHandlerError();
+		if (!streamResponse) return response;
+		if (response === streamResponse.response) return streamResponse;
+		if (streamResponse.response.body !== null && response.body === streamResponse.response.body) return {
+			...streamResponse,
+			response
+		};
+		await disposeStreamResponse("middleware response replaced");
+		return response;
+	};
 	const next = async (nextCtx) => {
 		if (nextCtx) {
 			if (nextCtx.context) ctx.context = safeObjectMerge(ctx.context, nextCtx.context);
-			for (const key of Object.keys(nextCtx)) if (key !== "context") ctx[key] = nextCtx[key];
+			for (const key of Object.keys(nextCtx)) if (key === "response") setResponse(nextCtx.response);
+			else if (key !== "context") ctx[key] = nextCtx[key];
 		}
 		index++;
 		const middleware = middlewares[index];
@@ -114,19 +144,24 @@ function executeMiddleware(middlewares, ctx) {
 			});
 		} catch (err) {
 			if (isSpecialResponse(err)) {
-				ctx.response = err;
+				setResponse(err);
 				return ctx;
 			}
+			await disposeStreamResponse("middleware error");
 			throw err;
 		}
 		const normalized = handleCtxResult(result);
 		if (normalized) {
-			if (normalized.response !== void 0) ctx.response = normalized.response;
+			if (normalized.response !== void 0) setResponse(normalized.response);
 			if (normalized.context) ctx.context = safeObjectMerge(ctx.context, normalized.context);
 		}
 		return ctx;
 	};
-	return next();
+	await next();
+	return {
+		ctx,
+		response: await getFinalResponse()
+	};
 }
 /**
 * Wrap a route handler as middleware
@@ -183,7 +218,7 @@ function createStartHandler(cbOrOptions) {
 	if (process.env.TSS_DEV_SERVER !== "true") finalManifestResolver.warmup({ getBaseManifest: () => getBaseManifest(void 0) });
 	const startRequestResolver = async (request, requestOpts) => {
 		let router = null;
-		let cbWillCleanup = false;
+		let responseOwnsCleanup = false;
 		try {
 			const { url, handledProtocolRelativeURL } = getNormalizedURL(request.url);
 			const href = url.pathname + url.search + url.hash;
@@ -240,16 +275,19 @@ function createStartHandler(cbOrOptions) {
 						serverFnId
 					}));
 				};
-				return handleRedirectResponse((await executeMiddleware([...flattenedRequestMiddlewares.map((d) => d.options.server), serverFnHandler], {
+				const { response: middlewareResponse } = await executeMiddleware([...flattenedRequestMiddlewares.map((d) => d.options.server), serverFnHandler], {
 					request,
 					pathname: url.pathname,
 					handlerType: "serverFn",
 					context: createNullProtoObject(requestOpts?.context)
-				})).response, request, getRouter);
+				});
+				const result = await handleRedirectResponse(middlewareResponse, request, getRouter);
+				responseOwnsCleanup = result.serverSsrCleanup === "stream";
+				return result.response;
 			}
 			const executeRouter = async (serverContext, matchedRoutes) => {
 				const acceptParts = (request.headers.get("Accept") || "*/*").split(",");
-				if (!["*/*", "text/html"].some((mimeType) => acceptParts.some((part) => part.trim().startsWith(mimeType)))) return Response.json({ error: "Only HTML requests are supported here" }, { status: 500 });
+				if (!["*/*", "text/html"].some((mimeType) => acceptParts.some((part) => part.trim().startsWith(mimeType)))) return normalizeSsrResponse(Response.json({ error: "Only HTML requests are supported here" }, { status: 500 }));
 				const manifest = await resolveManifestForRequest({
 					request,
 					requestInlineCss: requestOpts?.inlineCss,
@@ -271,18 +309,17 @@ function createStartHandler(cbOrOptions) {
 				});
 				routerInstance.update({ additionalContext: { serverContext } });
 				await routerInstance.load();
-				if (routerInstance.state.redirect) return routerInstance.state.redirect;
+				if (routerInstance.state.redirect) return normalizeSsrResponse(routerInstance.state.redirect);
 				earlyHints?.collectDynamic(routerInstance.stores.matches.get());
 				const ctx = getStartContext({ throwIfNotFound: false });
 				await routerInstance.serverSsr.dehydrate({ requestAssets: ctx?.requestAssets });
 				const responseHeaders = getStartResponseHeaders({ router: routerInstance });
 				earlyHints?.appendResponseHeaders(responseHeaders);
-				cbWillCleanup = true;
-				return cb({
+				return normalizeSsrResponse(await cb({
 					request,
 					router: routerInstance,
 					responseHeaders
-				});
+				}));
 			};
 			const requestHandlerMiddleware = async ({ context }) => {
 				return runWithStartContext({
@@ -308,41 +345,45 @@ function createStartHandler(cbOrOptions) {
 					}
 				});
 			};
-			return handleRedirectResponse((await executeMiddleware([...flattenedRequestMiddlewares.map((d) => d.options.server), requestHandlerMiddleware], {
+			const { response: middlewareResponse } = await executeMiddleware([...flattenedRequestMiddlewares.map((d) => d.options.server), requestHandlerMiddleware], {
 				request,
 				pathname: url.pathname,
 				handlerType: "router",
 				context: createNullProtoObject(requestOpts?.context)
-			})).response, request, getRouter);
+			});
+			const response = await handleRedirectResponse(middlewareResponse, request, getRouter);
+			responseOwnsCleanup = response.serverSsrCleanup === "stream";
+			return response.response;
 		} finally {
-			if (router && !cbWillCleanup) router.serverSsr?.cleanup();
+			if (router?.serverSsr && !responseOwnsCleanup) router.serverSsr.cleanup();
 			router = null;
 		}
 	};
 	return requestHandler(startRequestResolver);
 }
 async function handleRedirectResponse(response, request, getRouter) {
-	if (!isRedirect(response)) return response;
-	if (isResolvedRedirect(response)) {
-		if (request.headers.get("x-tsr-serverFn") === "true") return Response.json({
-			...response.options,
+	const ssrResponse = normalizeSsrResponse(response);
+	if (!isRedirect(ssrResponse.response)) return ssrResponse;
+	if (isResolvedRedirect(ssrResponse.response)) {
+		if (request.headers.get("x-tsr-serverFn") === "true") return replaceSsrResponse(ssrResponse, Response.json({
+			...ssrResponse.response.options,
 			isSerializedRedirect: true
-		}, { headers: response.headers });
-		return response;
+		}, { headers: ssrResponse.response.headers }), "redirect response replaced");
+		return ssrResponse;
 	}
-	const opts = response.options;
+	const opts = ssrResponse.response.options;
 	if (opts.to && typeof opts.to === "string" && !opts.to.startsWith("/")) throw new Error(`Server side redirects must use absolute paths via the 'href' or 'to' options. The redirect() method's "to" property accepts an internal path only. Use the "href" property to provide an external URL. Received: ${JSON.stringify(opts)}`);
 	if ([
 		"params",
 		"search",
 		"hash"
 	].some((d) => typeof opts[d] === "function")) throw new Error(`Server side redirects must use static search, params, and hash values and do not support functional values. Received functional values for: ${Object.keys(opts).filter((d) => typeof opts[d] === "function").map((d) => `"${d}"`).join(", ")}`);
-	const redirect = (await getRouter()).resolveRedirect(response);
-	if (request.headers.get("x-tsr-serverFn") === "true") return Response.json({
-		...response.options,
+	const redirect = (await getRouter()).resolveRedirect(ssrResponse.response);
+	if (request.headers.get("x-tsr-serverFn") === "true") return replaceSsrResponse(ssrResponse, Response.json({
+		...ssrResponse.response.options,
 		isSerializedRedirect: true
-	}, { headers: response.headers });
-	return redirect;
+	}, { headers: ssrResponse.response.headers }), "redirect response replaced");
+	return replaceSsrResponse(ssrResponse, redirect, "redirect response replaced");
 }
 async function handleServerRoutes({ getRouter, request, url, executeRouter, context, executedRequestMiddlewares }) {
 	const router = await getRouter();
@@ -376,8 +417,8 @@ async function handleServerRoutes({ getRouter, request, url, executeRouter, cont
 			}
 		}
 	}
-	routeMiddlewares.push((ctx) => executeRouter(ctx.context, matchedRoutes));
-	const ctx = await executeMiddleware(routeMiddlewares, {
+	routeMiddlewares.push(((ctx) => executeRouter(ctx.context, matchedRoutes)));
+	const { ctx, response } = await executeMiddleware(routeMiddlewares, {
 		request,
 		context,
 		params: routeParams,
@@ -386,10 +427,9 @@ async function handleServerRoutes({ getRouter, request, url, executeRouter, cont
 	});
 	if (isHeadFallback) {
 		if (!ctx.response) throwRouteHandlerError();
-		const resolved = await handleRedirectResponse(ctx.response, request, getRouter);
-		return new Response(null, resolved);
+		return stripSsrResponseBody(await handleRedirectResponse(response, request, getRouter), "HEAD body stripped");
 	}
-	return ctx.response;
+	return normalizeSsrResponse(response);
 }
 //#endregion
 export { createStartHandler };

package/dist/esm/createStartHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"createStartHandler.js","names":[],"sources":["../../src/createStartHandler.ts"],"sourcesContent":["import { createMemoryHistory } from '@tanstack/history'\nimport {\n  createCsrfMiddleware,\n  createNullProtoObject,\n  csrfSymbol,\n  flattenMiddlewares,\n  mergeHeaders,\n  safeObjectMerge,\n} from '@tanstack/start-client-core'\nimport {\n  executeRewriteInput,\n  isRedirect,\n  isResolvedRedirect,\n} from '@tanstack/router-core'\nimport {\n  attachRouterServerSsrUtils,\n  getNormalizedURL,\n  getOrigin,\n} from '@tanstack/router-core/ssr/server'\nimport {\n  getStartContext,\n  runWithStartContext,\n} from '@tanstack/start-storage-context'\nimport { requestHandler } from './request-response'\nimport { getStartManifest } from './router-manifest'\nimport { handleServerAction } from './server-functions-handler'\nimport { createEarlyHintsCollector } from './early-hints'\nimport {\n  createCachedBaseManifestLoader,\n  createFinalManifestResolver,\n} from './finalManifest'\n\nimport { HEADERS } from './constants'\nimport { ServerFunctionSerializationAdapter } from './serializer/ServerFunctionSerializationAdapter'\nimport type {\n  AnyFunctionMiddleware,\n  AnyRequestMiddleware,\n  AnyStartInstanceOptions,\n  RouteMethod,\n  RouteMethodHandlerFn,\n  RouterEntry,\n  StartEntry,\n} from '@tanstack/start-client-core'\nimport type { RequestHandler } from './request-handler'\nimport type {\n  AnyRoute,\n  AnyRouter,\n  AnySerializationAdapter,\n  Register,\n} from '@tanstack/router-core'\nimport type { HandlerCallback } from '@tanstack/router-core/ssr/server'\nimport type { FinalManifestOptions } from './finalManifest'\n\ntype TODO = any\n\ntype AnyMiddlewareServerFn =\n  | AnyRequestMiddleware['options']['server']\n  | AnyFunctionMiddleware['options']['server']\n\nexport interface CreateStartHandlerOptions extends FinalManifestOptions {\n  handler: HandlerCallback<AnyRouter>\n}\n\nfunction getStartResponseHeaders(opts: { router: AnyRouter }) {\n  const headers = mergeHeaders(\n    {\n      'Content-Type': 'text/html; charset=utf-8',\n    },\n    ...opts.router.stores.matches.get().map((match) => {\n      return match.headers\n    }),\n  )\n  return headers\n}\n\ninterface PluginAdaptersEntry {\n  hasPluginAdapters: boolean\n  pluginSerializationAdapters: Array<AnySerializationAdapter>\n}\n\ninterface Entries {\n  startEntry: StartEntry\n  routerEntry: RouterEntry\n  pluginAdapters: PluginAdaptersEntry\n}\n\n// Cached entries - promises stored immediately to prevent concurrent imports\n// that can cause race conditions during module initialization\nlet entriesPromise: Promise<Entries> | undefined\nlet hasWarnedMissingCsrfMiddleware = false\nconst defaultCsrfMiddleware = createCsrfMiddleware({\n  filter: (ctx) => ctx.handlerType === 'serverFn',\n})\nconst getCachedBaseManifest = createCachedBaseManifestLoader(() =>\n  getStartManifest(),\n)\nconst getProdBaseManifest: typeof getStartManifest = () =>\n  getCachedBaseManifest()\nconst getBaseManifest =\n  process.env.TSS_DEV_SERVER === 'true' ? getStartManifest : getProdBaseManifest\nconst createEarlyHintsForRequest: typeof createEarlyHintsCollector =\n  process.env.TSS_DEV_SERVER === 'true'\n    ? () => undefined\n    : createEarlyHintsCollector\n\nasync function loadEntries(): Promise<Entries> {\n  const [routerEntry, startEntry, pluginAdapters] = await Promise.all([\n    // @ts-ignore When building, we currently don't respect tsconfig.ts' `include` so we are not picking up the .d.ts from start-client-core\n    import('#tanstack-router-entry'),\n    // @ts-ignore When building, we currently don't respect tsconfig.ts' `include` so we are not picking up the .d.ts from start-client-core\n    import('#tanstack-start-entry'),\n    // @ts-ignore When building, we currently don't respect tsconfig.ts' `include` so we are not picking up the .d.ts from start-client-core\n    import('#tanstack-start-plugin-adapters'),\n  ])\n  return {\n    routerEntry: routerEntry as unknown as RouterEntry,\n    startEntry: startEntry as unknown as StartEntry,\n    pluginAdapters: pluginAdapters as unknown as PluginAdaptersEntry,\n  }\n}\n\nfunction getEntries() {\n  if (!entriesPromise) {\n    entriesPromise = loadEntries()\n  }\n  return entriesPromise\n}\n\nfunction hasCsrfMiddleware(\n  middlewares: Array<AnyRequestMiddleware | AnyFunctionMiddleware>,\n): boolean {\n  return middlewares.some((middleware) => csrfSymbol in middleware)\n}\n\nfunction warnMissingCsrfMiddlewareOnce() {\n  if (hasWarnedMissingCsrfMiddleware) return\n  hasWarnedMissingCsrfMiddleware = true\n\n  console.warn(`TanStack Start server functions are not protected by the CSRF middleware.\n\nServer functions are same-origin RPC endpoints and should be protected from cross-site requests.\n\nAdd the CSRF middleware in src/start.ts:\n\n  const csrfMiddleware = createCsrfMiddleware({\n    filter: (ctx) => ctx.handlerType === 'serverFn',\n  })\n\n  export const startInstance = createStart(() => ({\n    requestMiddleware: [csrfMiddleware],\n  }))\n\nIf you intentionally handle CSRF another way, disable this warning:\n\n  tanstackStart({\n    serverFns: {\n      disableCsrfMiddlewareWarning: true,\n    },\n  })`)\n}\n\n// Pre-computed constants\nconst ROUTER_BASEPATH = process.env.TSS_ROUTER_BASEPATH || '/'\nconst SERVER_FN_BASE = process.env.TSS_SERVER_FN_BASE\nconst IS_PRERENDERING = process.env.TSS_PRERENDERING === 'true'\nconst IS_SHELL_ENV = process.env.TSS_SHELL === 'true'\nconst IS_DEV = process.env.NODE_ENV === 'development'\n\n// Reusable error messages\nconst ERR_NO_RESPONSE = IS_DEV\n  ? `It looks like you forgot to return a response from your server route handler. If you want to defer to the app router, make sure to have a component set in this route.`\n  : 'Internal Server Error'\n\nconst ERR_NO_DEFER = IS_DEV\n  ? `You cannot defer to the app router if there is no component defined on this route.`\n  : 'Internal Server Error'\n\nfunction throwRouteHandlerError(): never {\n  throw new Error(ERR_NO_RESPONSE)\n}\n\nfunction throwIfMayNotDefer(): never {\n  throw new Error(ERR_NO_DEFER)\n}\n\n/**\n * Check if a value is a special response (Response or Redirect)\n */\nfunction isSpecialResponse(value: unknown): value is Response {\n  return value instanceof Response || isRedirect(value)\n}\n\n/**\n * Normalize middleware result to context shape\n */\nfunction handleCtxResult(result: TODO) {\n  if (isSpecialResponse(result)) {\n    return { response: result }\n  }\n  return result\n}\n\n/**\n * Execute a middleware chain\n */\nfunction executeMiddleware(middlewares: Array<TODO>, ctx: TODO): Promise<TODO> {\n  let index = -1\n\n  const next = async (nextCtx?: TODO): Promise<TODO> => {\n    // Merge context if provided using safeObjectMerge for prototype pollution prevention\n    if (nextCtx) {\n      if (nextCtx.context) {\n        ctx.context = safeObjectMerge(ctx.context, nextCtx.context)\n      }\n      // Copy own properties except context (Object.keys returns only own enumerable properties)\n      for (const key of Object.keys(nextCtx)) {\n        if (key !== 'context') {\n          ctx[key] = nextCtx[key]\n        }\n      }\n    }\n\n    index++\n    const middleware = middlewares[index]\n    if (!middleware) return ctx\n\n    let result: TODO\n    try {\n      result = await middleware({ ...ctx, next })\n    } catch (err) {\n      if (isSpecialResponse(err)) {\n        ctx.response = err\n        return ctx\n      }\n      throw err\n    }\n\n    const normalized = handleCtxResult(result)\n    if (normalized) {\n      if (normalized.response !== undefined) {\n        ctx.response = normalized.response\n      }\n      if (normalized.context) {\n        ctx.context = safeObjectMerge(ctx.context, normalized.context)\n      }\n    }\n\n    return ctx\n  }\n\n  return next()\n}\n\n/**\n * Wrap a route handler as middleware\n */\nfunction handlerToMiddleware(\n  handler: RouteMethodHandlerFn<any, AnyRoute, any, any, any, any, any>,\n  mayDefer: boolean = false,\n): TODO {\n  if (mayDefer) {\n    return handler\n  }\n  return async (ctx: TODO) => {\n    const response = await handler({ ...ctx, next: throwIfMayNotDefer })\n    if (!response) {\n      throwRouteHandlerError()\n    }\n    return response\n  }\n}\n\n/**\n * Creates the TanStack Start request handler.\n *\n * @example Backwards-compatible usage (handler callback only):\n * ```ts\n * export default createStartHandler(defaultStreamHandler)\n * ```\n *\n * @example With CDN URL rewriting:\n * ```ts\n * export default createStartHandler({\n *   handler: defaultStreamHandler,\n *   transformAssets: 'https://cdn.example.com',\n * })\n * ```\n *\n * @example With per-request URL rewriting:\n * ```ts\n * export default createStartHandler({\n *   handler: defaultStreamHandler,\n *   transformAssets: {\n *     transform: ({ url }) => {\n *       const cdnBase = getRequest().headers.get('x-cdn-base') || ''\n *       return { href: `${cdnBase}${url}` }\n *     },\n *     cache: false,\n *   },\n * })\n * ```\n */\nexport function createStartHandler<TRegister = Register>(\n  cbOrOptions: HandlerCallback<AnyRouter> | CreateStartHandlerOptions,\n): RequestHandler<TRegister> {\n  const handlerOptions: FinalManifestOptions =\n    typeof cbOrOptions === 'function' ? {} : cbOrOptions\n  const cb: HandlerCallback<AnyRouter> =\n    typeof cbOrOptions === 'function' ? cbOrOptions : cbOrOptions.handler\n  const finalManifestResolver = createFinalManifestResolver({\n    ...handlerOptions,\n    cacheCreateTransform: process.env.TSS_DEV_SERVER !== 'true',\n  })\n  const resolveManifestForRequest =\n    process.env.TSS_DEV_SERVER === 'true'\n      ? finalManifestResolver.resolveUncached\n      : finalManifestResolver.resolveCached\n\n  if (process.env.TSS_DEV_SERVER !== 'true') {\n    finalManifestResolver.warmup({\n      getBaseManifest: () => getBaseManifest(undefined),\n    })\n  }\n\n  const startRequestResolver: RequestHandler<Register> = async (\n    request,\n    requestOpts,\n  ) => {\n    let router: AnyRouter | null = null as AnyRouter | null\n    let cbWillCleanup = false as boolean\n\n    try {\n      // normalizing and sanitizing the pathname here for server, so we always deal with the same format during SSR.\n      // during normalization paths like '//posts' are flattened to '/posts'.\n      // in these cases we would prefer to redirect to the new path\n      const { url, handledProtocolRelativeURL } = getNormalizedURL(request.url)\n      const href = url.pathname + url.search + url.hash\n      const origin = getOrigin(request)\n\n      if (handledProtocolRelativeURL) {\n        return Response.redirect(url, 308)\n      }\n\n      const entries = await getEntries()\n      const hasStartInstance = !!entries.startEntry.startInstance\n      const startOptions: AnyStartInstanceOptions =\n        (await entries.startEntry.startInstance?.getOptions()) ||\n        ({} as AnyStartInstanceOptions)\n\n      const { hasPluginAdapters, pluginSerializationAdapters } =\n        entries.pluginAdapters\n\n      const serializationAdapters = [\n        ...(startOptions.serializationAdapters || []),\n        ...(hasPluginAdapters ? pluginSerializationAdapters : []),\n        ServerFunctionSerializationAdapter,\n      ]\n\n      const requestStartOptions = {\n        ...startOptions,\n        requestMiddleware: hasStartInstance\n          ? startOptions.requestMiddleware\n          : [defaultCsrfMiddleware],\n        serializationAdapters,\n      }\n\n      // Flatten request middlewares once\n      const flattenedRequestMiddlewares = requestStartOptions.requestMiddleware\n        ? flattenMiddlewares(requestStartOptions.requestMiddleware)\n        : []\n\n      // Create set for deduplication\n      const executedRequestMiddlewares = new Set<TODO>(\n        flattenedRequestMiddlewares,\n      )\n\n      // Memoized router getter\n      const getRouter = async (): Promise<AnyRouter> => {\n        if (router) return router\n\n        router = await entries.routerEntry.getRouter()\n\n        let isShell = IS_SHELL_ENV\n        if (IS_PRERENDERING && !isShell) {\n          isShell = request.headers.get(HEADERS.TSS_SHELL) === 'true'\n        }\n\n        const history = createMemoryHistory({\n          initialEntries: [href],\n        })\n\n        router.update({\n          history,\n          isShell,\n          isPrerendering: IS_PRERENDERING,\n          origin: router.options.origin ?? origin,\n          ...{\n            defaultSsr: requestStartOptions.defaultSsr,\n            serializationAdapters: [\n              ...requestStartOptions.serializationAdapters,\n              ...(router.options.serializationAdapters || []),\n            ],\n          },\n          basepath: ROUTER_BASEPATH,\n        })\n\n        return router\n      }\n\n      // Check for server function requests first (early exit)\n      if (SERVER_FN_BASE && url.pathname.startsWith(SERVER_FN_BASE)) {\n        if (\n          process.env.NODE_ENV !== 'production' &&\n          process.env.TSS_DISABLE_CSRF_MIDDLEWARE_WARNING !== 'true' &&\n          !hasCsrfMiddleware(flattenedRequestMiddlewares)\n        ) {\n          warnMissingCsrfMiddlewareOnce()\n        }\n\n        const serverFnId = url.pathname\n          .slice(SERVER_FN_BASE.length)\n          .split('/')[0]\n\n        if (!serverFnId) {\n          throw new Error('Invalid server action param for serverFnId')\n        }\n\n        const serverFnHandler = async ({ context }: TODO) => {\n          return runWithStartContext(\n            {\n              getRouter,\n              startOptions: requestStartOptions,\n              contextAfterGlobalMiddlewares: context,\n              request,\n              executedRequestMiddlewares,\n              handlerType: 'serverFn',\n            },\n            () =>\n              handleServerAction({\n                request,\n                context: requestOpts?.context,\n                serverFnId,\n              }),\n          )\n        }\n\n        const middlewares = flattenedRequestMiddlewares.map(\n          (d) => d.options.server,\n        )\n        const ctx = await executeMiddleware([...middlewares, serverFnHandler], {\n          request,\n          pathname: url.pathname,\n          handlerType: 'serverFn',\n          context: createNullProtoObject(requestOpts?.context),\n        })\n\n        return handleRedirectResponse(ctx.response, request, getRouter)\n      }\n\n      // Router execution function\n      const executeRouter = async (\n        serverContext: TODO,\n        matchedRoutes?: ReadonlyArray<AnyRoute>,\n      ): Promise<Response> => {\n        const acceptHeader = request.headers.get('Accept') || '*/*'\n        const acceptParts = acceptHeader.split(',')\n        const supportedMimeTypes = ['*/*', 'text/html']\n\n        const isSupported = supportedMimeTypes.some((mimeType) =>\n          acceptParts.some((part) => part.trim().startsWith(mimeType)),\n        )\n\n        if (!isSupported) {\n          return Response.json(\n            { error: 'Only HTML requests are supported here' },\n            { status: 500 },\n          )\n        }\n\n        const manifest = await resolveManifestForRequest({\n          request,\n          requestInlineCss: requestOpts?.inlineCss,\n          getBaseManifest: () => getBaseManifest(matchedRoutes),\n        })\n\n        const earlyHints = createEarlyHintsForRequest({\n          onEarlyHints: requestOpts?.onEarlyHints,\n          responseLinkHeader: requestOpts?.responseLinkHeader,\n        })\n\n        earlyHints?.collectStatic({ manifest, matchedRoutes })\n\n        const routerInstance = await getRouter()\n\n        attachRouterServerSsrUtils({\n          router: routerInstance,\n          manifest,\n          getRequestAssets: () =>\n            getStartContext({ throwIfNotFound: false })?.requestAssets,\n        })\n\n        routerInstance.update({ additionalContext: { serverContext } })\n        await routerInstance.load()\n\n        if (routerInstance.state.redirect) {\n          return routerInstance.state.redirect\n        }\n\n        earlyHints?.collectDynamic(routerInstance.stores.matches.get())\n\n        // Pass request-scoped assets to dehydrate for manifest injection\n        const ctx = getStartContext({ throwIfNotFound: false })\n        await routerInstance.serverSsr!.dehydrate({\n          requestAssets: ctx?.requestAssets,\n        })\n\n        const responseHeaders = getStartResponseHeaders({\n          router: routerInstance,\n        })\n        earlyHints?.appendResponseHeaders(responseHeaders)\n        cbWillCleanup = true\n\n        return cb({\n          request,\n          router: routerInstance,\n          responseHeaders,\n        })\n      }\n\n      // Main request handler\n      const requestHandlerMiddleware = async ({ context }: TODO) => {\n        return runWithStartContext(\n          {\n            getRouter,\n            startOptions: requestStartOptions,\n            contextAfterGlobalMiddlewares: context,\n            request,\n            executedRequestMiddlewares,\n            handlerType: 'router',\n          },\n          async () => {\n            try {\n              return await handleServerRoutes({\n                getRouter,\n                request,\n                url,\n                executeRouter,\n                context,\n                executedRequestMiddlewares,\n              })\n            } catch (err) {\n              if (err instanceof Response) {\n                return err\n              }\n              throw err\n            }\n          },\n        )\n      }\n\n      const middlewares = flattenedRequestMiddlewares.map(\n        (d) => d.options.server,\n      )\n      const ctx = await executeMiddleware(\n        [...middlewares, requestHandlerMiddleware],\n        {\n          request,\n          pathname: url.pathname,\n          handlerType: 'router',\n          context: createNullProtoObject(requestOpts?.context),\n        },\n      )\n\n      return handleRedirectResponse(ctx.response, request, getRouter)\n    } finally {\n      if (router && !cbWillCleanup) {\n        // Clean up router SSR state if it was set up but won't be cleaned up by the callback\n        // (e.g., in redirect cases or early returns before the callback is invoked).\n        // When the callback runs, it handles cleanup (either via transformStreamWithRouter\n        // for streaming, or directly in renderRouterToString for non-streaming).\n        router.serverSsr?.cleanup()\n      }\n      router = null\n    }\n  }\n\n  return requestHandler(startRequestResolver)\n}\n\nasync function handleRedirectResponse(\n  response: Response,\n  request: Request,\n  getRouter: () => Promise<AnyRouter>,\n): Promise<Response> {\n  if (!isRedirect(response)) {\n    return response\n  }\n\n  if (isResolvedRedirect(response)) {\n    if (request.headers.get('x-tsr-serverFn') === 'true') {\n      return Response.json(\n        { ...response.options, isSerializedRedirect: true },\n        { headers: response.headers },\n      )\n    }\n    return response\n  }\n\n  const opts = response.options\n  if (opts.to && typeof opts.to === 'string' && !opts.to.startsWith('/')) {\n    throw new Error(\n      `Server side redirects must use absolute paths via the 'href' or 'to' options. The redirect() method's \"to\" property accepts an internal path only. Use the \"href\" property to provide an external URL. Received: ${JSON.stringify(opts)}`,\n    )\n  }\n\n  if (\n    ['params', 'search', 'hash'].some(\n      (d) => typeof (opts as TODO)[d] === 'function',\n    )\n  ) {\n    throw new Error(\n      `Server side redirects must use static search, params, and hash values and do not support functional values. Received functional values for: ${Object.keys(\n        opts,\n      )\n        .filter((d) => typeof (opts as TODO)[d] === 'function')\n        .map((d) => `\"${d}\"`)\n        .join(', ')}`,\n    )\n  }\n\n  const router = await getRouter()\n  const redirect = router.resolveRedirect(response)\n\n  if (request.headers.get('x-tsr-serverFn') === 'true') {\n    return Response.json(\n      { ...response.options, isSerializedRedirect: true },\n      { headers: response.headers },\n    )\n  }\n\n  return redirect\n}\n\nasync function handleServerRoutes({\n  getRouter,\n  request,\n  url,\n  executeRouter,\n  context,\n  executedRequestMiddlewares,\n}: {\n  getRouter: () => Promise<AnyRouter>\n  request: Request\n  url: URL\n  executeRouter: (\n    serverContext: any,\n    matchedRoutes?: ReadonlyArray<AnyRoute>,\n  ) => Promise<Response>\n  context: any\n  executedRequestMiddlewares: Set<AnyRequestMiddleware>\n}): Promise<Response> {\n  const router = await getRouter()\n  const rewrittenUrl = executeRewriteInput(router.rewrite, url)\n  const pathname = rewrittenUrl.pathname\n  // this will perform a fuzzy match, however for server routes we need an exact match\n  // if the route is not an exact match, executeRouter will handle rendering the app router\n  // the match will be cached internally, so no extra work is done during the app router render\n  const { matchedRoutes, foundRoute, routeParams } =\n    router.getMatchedRoutes(pathname)\n\n  const isExactMatch = foundRoute && routeParams['**'] === undefined\n\n  // Collect and dedupe route middlewares\n  const routeMiddlewares: Array<AnyMiddlewareServerFn> = []\n\n  // Collect middleware from matched routes, filtering out those already executed\n  // in the request phase\n  for (const route of matchedRoutes) {\n    const serverMiddleware = route.options.server?.middleware as\n      | Array<AnyRequestMiddleware>\n      | undefined\n    if (serverMiddleware) {\n      const flattened = flattenMiddlewares(serverMiddleware)\n      for (const m of flattened) {\n        if (!executedRequestMiddlewares.has(m)) {\n          routeMiddlewares.push(m.options.server)\n        }\n      }\n    }\n  }\n\n  // Add handler middleware if exact match\n  const server = foundRoute?.options.server\n  let isHeadFallback = false\n  if (server?.handlers && isExactMatch) {\n    const handlers =\n      typeof server.handlers === 'function'\n        ? server.handlers({ createHandlers: (d: any) => d })\n        : server.handlers\n\n    const requestMethod = request.method.toUpperCase() as RouteMethod\n    // Per RFC 9110 §9.3.2, HEAD must return the same header fields as GET.\n    // Priority for HEAD: explicit HEAD handler → GET → ANY (last resort).\n    const handler =\n      requestMethod === 'HEAD'\n        ? (handlers['HEAD'] ?? handlers['GET'] ?? handlers['ANY'])\n        : (handlers[requestMethod] ?? handlers['ANY'])\n    isHeadFallback =\n      requestMethod === 'HEAD' && handler !== undefined && !handlers['HEAD']\n\n    if (handler) {\n      const mayDefer = !!foundRoute.options.component\n\n      if (typeof handler === 'function') {\n        routeMiddlewares.push(handlerToMiddleware(handler, mayDefer))\n      } else {\n        if (handler.middleware?.length) {\n          const handlerMiddlewares = flattenMiddlewares(handler.middleware)\n          for (const m of handlerMiddlewares) {\n            routeMiddlewares.push(m.options.server)\n          }\n        }\n        if (handler.handler) {\n          routeMiddlewares.push(handlerToMiddleware(handler.handler, mayDefer))\n        }\n      }\n    }\n  }\n\n  // Final middleware: execute router with matched routes for dev styles\n  routeMiddlewares.push((ctx: TODO) =>\n    executeRouter(ctx.context, matchedRoutes),\n  )\n\n  const ctx = await executeMiddleware(routeMiddlewares, {\n    request,\n    context,\n    params: routeParams,\n    pathname,\n    handlerType: 'router',\n  })\n\n  // RFC 9110 §9.3.2: HEAD must carry the same header fields as GET but no body.\n  // Resolve any redirect before stripping so the Location header survives.\n  if (isHeadFallback) {\n    if (!ctx.response) {\n      throwRouteHandlerError()\n    }\n\n    const resolved = await handleRedirectResponse(\n      ctx.response,\n      request,\n      getRouter,\n    )\n    return new Response(null, resolved)\n  }\n\n  return ctx.response\n}\n"],"mappings":";;;;;;;;;;;;;AA+DA,SAAS,wBAAwB,MAA6B;CAS5D,OARgB,aACd,EACE,gBAAgB,2BAClB,GACA,GAAG,KAAK,OAAO,OAAO,QAAQ,IAAI,EAAE,KAAK,UAAU;EACjD,OAAO,MAAM;CACf,CAAC,CAEI;AACT;AAeA,IAAI;AACJ,IAAI,iCAAiC;AACrC,IAAM,wBAAwB,qBAAqB,EACjD,SAAS,QAAQ,IAAI,gBAAgB,WACvC,CAAC;AACD,IAAM,wBAAwB,qCAC5B,iBAAiB,CACnB;AACA,IAAM,4BACJ,sBAAsB;AACxB,IAAM,kBACJ,QAAQ,IAAI,mBAAmB,SAAS,mBAAmB;AAC7D,IAAM,6BACJ,QAAQ,IAAI,mBAAmB,eACrB,KAAA,IACN;AAEN,eAAe,cAAgC;CAC7C,MAAM,CAAC,aAAa,YAAY,kBAAkB,MAAM,QAAQ,IAAI;EAElE,OAAO;EAEP,OAAO;EAEP,OAAO;CACT,CAAC;CACD,OAAO;EACQ;EACD;EACI;CAClB;AACF;AAEA,SAAS,aAAa;CACpB,IAAI,CAAC,gBACH,iBAAiB,YAAY;CAE/B,OAAO;AACT;AAEA,SAAS,kBACP,aACS;CACT,OAAO,YAAY,MAAM,eAAe,cAAc,UAAU;AAClE;AAEA,SAAS,gCAAgC;CACvC,IAAI,gCAAgC;CACpC,iCAAiC;CAEjC,QAAQ,KAAK;;;;;;;;;;;;;;;;;;;;KAoBV;AACL;AAGA,IAAM,kBAAkB,QAAQ,IAAI,uBAAuB;AAC3D,IAAM,iBAAiB,QAAQ,IAAI;AACnC,IAAM,kBAAkB,QAAQ,IAAI,qBAAqB;AACzD,IAAM,eAAe,QAAQ,IAAI,cAAc;AAC/C,IAAM,SAAA,QAAA,IAAA,aAAkC;AAGxC,IAAM,kBAAkB,SACpB,2KACA;AAEJ,IAAM,eAAe,SACjB,uFACA;AAEJ,SAAS,yBAAgC;CACvC,MAAM,IAAI,MAAM,eAAe;AACjC;AAEA,SAAS,qBAA4B;CACnC,MAAM,IAAI,MAAM,YAAY;AAC9B;;;;AAKA,SAAS,kBAAkB,OAAmC;CAC5D,OAAO,iBAAiB,YAAY,WAAW,KAAK;AACtD;;;;AAKA,SAAS,gBAAgB,QAAc;CACrC,IAAI,kBAAkB,MAAM,GAC1B,OAAO,EAAE,UAAU,OAAO;CAE5B,OAAO;AACT;;;;AAKA,SAAS,kBAAkB,aAA0B,KAA0B;CAC7E,IAAI,QAAQ;CAEZ,MAAM,OAAO,OAAO,YAAkC;EAEpD,IAAI,SAAS;GACX,IAAI,QAAQ,SACV,IAAI,UAAU,gBAAgB,IAAI,SAAS,QAAQ,OAAO;GAG5D,KAAK,MAAM,OAAO,OAAO,KAAK,OAAO,GACnC,IAAI,QAAQ,WACV,IAAI,OAAO,QAAQ;EAGzB;EAEA;EACA,MAAM,aAAa,YAAY;EAC/B,IAAI,CAAC,YAAY,OAAO;EAExB,IAAI;EACJ,IAAI;GACF,SAAS,MAAM,WAAW;IAAE,GAAG;IAAK;GAAK,CAAC;EAC5C,SAAS,KAAK;GACZ,IAAI,kBAAkB,GAAG,GAAG;IAC1B,IAAI,WAAW;IACf,OAAO;GACT;GACA,MAAM;EACR;EAEA,MAAM,aAAa,gBAAgB,MAAM;EACzC,IAAI,YAAY;GACd,IAAI,WAAW,aAAa,KAAA,GAC1B,IAAI,WAAW,WAAW;GAE5B,IAAI,WAAW,SACb,IAAI,UAAU,gBAAgB,IAAI,SAAS,WAAW,OAAO;EAEjE;EAEA,OAAO;CACT;CAEA,OAAO,KAAK;AACd;;;;AAKA,SAAS,oBACP,SACA,WAAoB,OACd;CACN,IAAI,UACF,OAAO;CAET,OAAO,OAAO,QAAc;EAC1B,MAAM,WAAW,MAAM,QAAQ;GAAE,GAAG;GAAK,MAAM;EAAmB,CAAC;EACnE,IAAI,CAAC,UACH,uBAAuB;EAEzB,OAAO;CACT;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,mBACd,aAC2B;CAC3B,MAAM,iBACJ,OAAO,gBAAgB,aAAa,CAAC,IAAI;CAC3C,MAAM,KACJ,OAAO,gBAAgB,aAAa,cAAc,YAAY;CAChE,MAAM,wBAAwB,4BAA4B;EACxD,GAAG;EACH,sBAAsB,QAAQ,IAAI,mBAAmB;CACvD,CAAC;CACD,MAAM,4BACJ,QAAQ,IAAI,mBAAmB,SAC3B,sBAAsB,kBACtB,sBAAsB;CAE5B,IAAI,QAAQ,IAAI,mBAAmB,QACjC,sBAAsB,OAAO,EAC3B,uBAAuB,gBAAgB,KAAA,CAAS,EAClD,CAAC;CAGH,MAAM,uBAAiD,OACrD,SACA,gBACG;EACH,IAAI,SAA2B;EAC/B,IAAI,gBAAgB;EAEpB,IAAI;GAIF,MAAM,EAAE,KAAK,+BAA+B,iBAAiB,QAAQ,GAAG;GACxE,MAAM,OAAO,IAAI,WAAW,IAAI,SAAS,IAAI;GAC7C,MAAM,SAAS,UAAU,OAAO;GAEhC,IAAI,4BACF,OAAO,SAAS,SAAS,KAAK,GAAG;GAGnC,MAAM,UAAU,MAAM,WAAW;GACjC,MAAM,mBAAmB,CAAC,CAAC,QAAQ,WAAW;GAC9C,MAAM,eACH,MAAM,QAAQ,WAAW,eAAe,WAAW,KACnD,CAAC;GAEJ,MAAM,EAAE,mBAAmB,gCACzB,QAAQ;GAEV,MAAM,wBAAwB;IAC5B,GAAI,aAAa,yBAAyB,CAAC;IAC3C,GAAI,oBAAoB,8BAA8B,CAAC;IACvD;GACF;GAEA,MAAM,sBAAsB;IAC1B,GAAG;IACH,mBAAmB,mBACf,aAAa,oBACb,CAAC,qBAAqB;IAC1B;GACF;GAGA,MAAM,8BAA8B,oBAAoB,oBACpD,mBAAmB,oBAAoB,iBAAiB,IACxD,CAAC;GAGL,MAAM,6BAA6B,IAAI,IACrC,2BACF;GAGA,MAAM,YAAY,YAAgC;IAChD,IAAI,QAAQ,OAAO;IAEnB,SAAS,MAAM,QAAQ,YAAY,UAAU;IAE7C,IAAI,UAAU;IACd,IAAI,mBAAmB,CAAC,SACtB,UAAU,QAAQ,QAAQ,IAAI,QAAQ,SAAS,MAAM;IAGvD,MAAM,UAAU,oBAAoB,EAClC,gBAAgB,CAAC,IAAI,EACvB,CAAC;IAED,OAAO,OAAO;KACZ;KACA;KACA,gBAAgB;KAChB,QAAQ,OAAO,QAAQ,UAAU;KAE/B,YAAY,oBAAoB;KAChC,uBAAuB,CACrB,GAAG,oBAAoB,uBACvB,GAAI,OAAO,QAAQ,yBAAyB,CAAC,CAC/C;KAEF,UAAU;IACZ,CAAC;IAED,OAAO;GACT;GAGA,IAAI,kBAAkB,IAAI,SAAS,WAAW,cAAc,GAAG;IAC7D,IAAA,QAAA,IAAA,aAC2B,gBACzB,QAAQ,IAAI,wCAAwC,UACpD,CAAC,kBAAkB,2BAA2B,GAE9C,8BAA8B;IAGhC,MAAM,aAAa,IAAI,SACpB,MAAM,eAAe,MAAM,EAC3B,MAAM,GAAG,EAAE;IAEd,IAAI,CAAC,YACH,MAAM,IAAI,MAAM,4CAA4C;IAG9D,MAAM,kBAAkB,OAAO,EAAE,cAAoB;KACnD,OAAO,oBACL;MACE;MACA,cAAc;MACd,+BAA+B;MAC/B;MACA;MACA,aAAa;KACf,SAEE,mBAAmB;MACjB;MACA,SAAS,aAAa;MACtB;KACF,CAAC,CACL;IACF;IAYA,OAAO,wBAAuB,MAPZ,kBAAkB,CAAC,GAHjB,4BAA4B,KAC7C,MAAM,EAAE,QAAQ,MAEqB,GAAa,eAAe,GAAG;KACrE;KACA,UAAU,IAAI;KACd,aAAa;KACb,SAAS,sBAAsB,aAAa,OAAO;IACrD,CAAC,GAEiC,UAAU,SAAS,SAAS;GAChE;GAGA,MAAM,gBAAgB,OACpB,eACA,kBACsB;IAEtB,MAAM,eADe,QAAQ,QAAQ,IAAI,QAAQ,KAAK,OACrB,MAAM,GAAG;IAO1C,IAAI,CAJgB,CAFQ,OAAO,WAEf,EAAmB,MAAM,aAC3C,YAAY,MAAM,SAAS,KAAK,KAAK,EAAE,WAAW,QAAQ,CAAC,CAGxD,GACH,OAAO,SAAS,KACd,EAAE,OAAO,wCAAwC,GACjD,EAAE,QAAQ,IAAI,CAChB;IAGF,MAAM,WAAW,MAAM,0BAA0B;KAC/C;KACA,kBAAkB,aAAa;KAC/B,uBAAuB,gBAAgB,aAAa;IACtD,CAAC;IAED,MAAM,aAAa,2BAA2B;KAC5C,cAAc,aAAa;KAC3B,oBAAoB,aAAa;IACnC,CAAC;IAED,YAAY,cAAc;KAAE;KAAU;IAAc,CAAC;IAErD,MAAM,iBAAiB,MAAM,UAAU;IAEvC,2BAA2B;KACzB,QAAQ;KACR;KACA,wBACE,gBAAgB,EAAE,iBAAiB,MAAM,CAAC,GAAG;IACjD,CAAC;IAED,eAAe,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,CAAC;IAC9D,MAAM,eAAe,KAAK;IAE1B,IAAI,eAAe,MAAM,UACvB,OAAO,eAAe,MAAM;IAG9B,YAAY,eAAe,eAAe,OAAO,QAAQ,IAAI,CAAC;IAG9D,MAAM,MAAM,gBAAgB,EAAE,iBAAiB,MAAM,CAAC;IACtD,MAAM,eAAe,UAAW,UAAU,EACxC,eAAe,KAAK,cACtB,CAAC;IAED,MAAM,kBAAkB,wBAAwB,EAC9C,QAAQ,eACV,CAAC;IACD,YAAY,sBAAsB,eAAe;IACjD,gBAAgB;IAEhB,OAAO,GAAG;KACR;KACA,QAAQ;KACR;IACF,CAAC;GACH;GAGA,MAAM,2BAA2B,OAAO,EAAE,cAAoB;IAC5D,OAAO,oBACL;KACE;KACA,cAAc;KACd,+BAA+B;KAC/B;KACA;KACA,aAAa;IACf,GACA,YAAY;KACV,IAAI;MACF,OAAO,MAAM,mBAAmB;OAC9B;OACA;OACA;OACA;OACA;OACA;MACF,CAAC;KACH,SAAS,KAAK;MACZ,IAAI,eAAe,UACjB,OAAO;MAET,MAAM;KACR;IACF,CACF;GACF;GAeA,OAAO,wBAAuB,MAVZ,kBAChB,CAAC,GAJiB,4BAA4B,KAC7C,MAAM,EAAE,QAAQ,MAGb,GAAa,wBAAwB,GACzC;IACE;IACA,UAAU,IAAI;IACd,aAAa;IACb,SAAS,sBAAsB,aAAa,OAAO;GACrD,CACF,GAEkC,UAAU,SAAS,SAAS;EAChE,UAAU;GACR,IAAI,UAAU,CAAC,eAKb,OAAO,WAAW,QAAQ;GAE5B,SAAS;EACX;CACF;CAEA,OAAO,eAAe,oBAAoB;AAC5C;AAEA,eAAe,uBACb,UACA,SACA,WACmB;CACnB,IAAI,CAAC,WAAW,QAAQ,GACtB,OAAO;CAGT,IAAI,mBAAmB,QAAQ,GAAG;EAChC,IAAI,QAAQ,QAAQ,IAAI,gBAAgB,MAAM,QAC5C,OAAO,SAAS,KACd;GAAE,GAAG,SAAS;GAAS,sBAAsB;EAAK,GAClD,EAAE,SAAS,SAAS,QAAQ,CAC9B;EAEF,OAAO;CACT;CAEA,MAAM,OAAO,SAAS;CACtB,IAAI,KAAK,MAAM,OAAO,KAAK,OAAO,YAAY,CAAC,KAAK,GAAG,WAAW,GAAG,GACnE,MAAM,IAAI,MACR,oNAAoN,KAAK,UAAU,IAAI,GACzO;CAGF,IACE;EAAC;EAAU;EAAU;CAAM,EAAE,MAC1B,MAAM,OAAQ,KAAc,OAAO,UACtC,GAEA,MAAM,IAAI,MACR,+IAA+I,OAAO,KACpJ,IACF,EACG,QAAQ,MAAM,OAAQ,KAAc,OAAO,UAAU,EACrD,KAAK,MAAM,IAAI,EAAE,EAAE,EACnB,KAAK,IAAI,GACd;CAIF,MAAM,YAAW,MADI,UAAU,GACP,gBAAgB,QAAQ;CAEhD,IAAI,QAAQ,QAAQ,IAAI,gBAAgB,MAAM,QAC5C,OAAO,SAAS,KACd;EAAE,GAAG,SAAS;EAAS,sBAAsB;CAAK,GAClD,EAAE,SAAS,SAAS,QAAQ,CAC9B;CAGF,OAAO;AACT;AAEA,eAAe,mBAAmB,EAChC,WACA,SACA,KACA,eACA,SACA,8BAWoB;CACpB,MAAM,SAAS,MAAM,UAAU;CAE/B,MAAM,WADe,oBAAoB,OAAO,SAAS,GACxC,EAAa;CAI9B,MAAM,EAAE,eAAe,YAAY,gBACjC,OAAO,iBAAiB,QAAQ;CAElC,MAAM,eAAe,cAAc,YAAY,UAAU,KAAA;CAGzD,MAAM,mBAAiD,CAAC;CAIxD,KAAK,MAAM,SAAS,eAAe;EACjC,MAAM,mBAAmB,MAAM,QAAQ,QAAQ;EAG/C,IAAI,kBAAkB;GACpB,MAAM,YAAY,mBAAmB,gBAAgB;GACrD,KAAK,MAAM,KAAK,WACd,IAAI,CAAC,2BAA2B,IAAI,CAAC,GACnC,iBAAiB,KAAK,EAAE,QAAQ,MAAM;EAG5C;CACF;CAGA,MAAM,SAAS,YAAY,QAAQ;CACnC,IAAI,iBAAiB;CACrB,IAAI,QAAQ,YAAY,cAAc;EACpC,MAAM,WACJ,OAAO,OAAO,aAAa,aACvB,OAAO,SAAS,EAAE,iBAAiB,MAAW,EAAE,CAAC,IACjD,OAAO;EAEb,MAAM,gBAAgB,QAAQ,OAAO,YAAY;EAGjD,MAAM,UACJ,kBAAkB,SACb,SAAS,WAAW,SAAS,UAAU,SAAS,SAChD,SAAS,kBAAkB,SAAS;EAC3C,iBACE,kBAAkB,UAAU,YAAY,KAAA,KAAa,CAAC,SAAS;EAEjE,IAAI,SAAS;GACX,MAAM,WAAW,CAAC,CAAC,WAAW,QAAQ;GAEtC,IAAI,OAAO,YAAY,YACrB,iBAAiB,KAAK,oBAAoB,SAAS,QAAQ,CAAC;QACvD;IACL,IAAI,QAAQ,YAAY,QAAQ;KAC9B,MAAM,qBAAqB,mBAAmB,QAAQ,UAAU;KAChE,KAAK,MAAM,KAAK,oBACd,iBAAiB,KAAK,EAAE,QAAQ,MAAM;IAE1C;IACA,IAAI,QAAQ,SACV,iBAAiB,KAAK,oBAAoB,QAAQ,SAAS,QAAQ,CAAC;GAExE;EACF;CACF;CAGA,iBAAiB,MAAM,QACrB,cAAc,IAAI,SAAS,aAAa,CAC1C;CAEA,MAAM,MAAM,MAAM,kBAAkB,kBAAkB;EACpD;EACA;EACA,QAAQ;EACR;EACA,aAAa;CACf,CAAC;CAID,IAAI,gBAAgB;EAClB,IAAI,CAAC,IAAI,UACP,uBAAuB;EAGzB,MAAM,WAAW,MAAM,uBACrB,IAAI,UACJ,SACA,SACF;EACA,OAAO,IAAI,SAAS,MAAM,QAAQ;CACpC;CAEA,OAAO,IAAI;AACb"}
+{"version":3,"file":"createStartHandler.js","names":[],"sources":["../../src/createStartHandler.ts"],"sourcesContent":["import { createMemoryHistory } from '@tanstack/history'\nimport {\n  createCsrfMiddleware,\n  createNullProtoObject,\n  csrfSymbol,\n  flattenMiddlewares,\n  mergeHeaders,\n  safeObjectMerge,\n} from '@tanstack/start-client-core'\nimport {\n  executeRewriteInput,\n  isRedirect,\n  isResolvedRedirect,\n} from '@tanstack/router-core'\nimport {\n  attachRouterServerSsrUtils,\n  getNormalizedURL,\n  getOrigin,\n  isSsrResponse,\n  normalizeSsrResponse,\n  replaceSsrResponse,\n  stripSsrResponseBody,\n} from '@tanstack/router-core/ssr/server'\nimport {\n  getStartContext,\n  runWithStartContext,\n} from '@tanstack/start-storage-context'\nimport { requestHandler } from './request-response'\nimport { getStartManifest } from './router-manifest'\nimport { handleServerAction } from './server-functions-handler'\nimport { createEarlyHintsCollector } from './early-hints'\nimport {\n  createCachedBaseManifestLoader,\n  createFinalManifestResolver,\n} from './finalManifest'\n\nimport { HEADERS } from './constants'\nimport { ServerFunctionSerializationAdapter } from './serializer/ServerFunctionSerializationAdapter'\nimport type {\n  AnyFunctionMiddleware,\n  AnyRequestMiddleware,\n  AnyStartInstanceOptions,\n  RouteMethod,\n  RouteMethodHandlerFn,\n  RouterEntry,\n  StartEntry,\n} from '@tanstack/start-client-core'\nimport type { RequestHandler } from './request-handler'\nimport type {\n  AnyRoute,\n  AnyRouter,\n  AnySerializationAdapter,\n  Register,\n} from '@tanstack/router-core'\nimport type {\n  HandlerCallback,\n  HandlerCallbackResult,\n  SsrResponse,\n} from '@tanstack/router-core/ssr/server'\nimport type { FinalManifestOptions } from './finalManifest'\n\ntype TODO = any\n\ntype AnyMiddlewareServerFn =\n  | AnyRequestMiddleware['options']['server']\n  | AnyFunctionMiddleware['options']['server']\n\nexport interface CreateStartHandlerOptions extends FinalManifestOptions {\n  handler: HandlerCallback<AnyRouter>\n}\n\nfunction getStartResponseHeaders(opts: { router: AnyRouter }) {\n  const headers = mergeHeaders(\n    {\n      'Content-Type': 'text/html; charset=utf-8',\n    },\n    ...opts.router.stores.matches.get().map((match) => {\n      return match.headers\n    }),\n  )\n  return headers\n}\n\ninterface PluginAdaptersEntry {\n  hasPluginAdapters: boolean\n  pluginSerializationAdapters: Array<AnySerializationAdapter>\n}\n\ninterface Entries {\n  startEntry: StartEntry\n  routerEntry: RouterEntry\n  pluginAdapters: PluginAdaptersEntry\n}\n\n// Cached entries - promises stored immediately to prevent concurrent imports\n// that can cause race conditions during module initialization\nlet entriesPromise: Promise<Entries> | undefined\nlet hasWarnedMissingCsrfMiddleware = false\nconst defaultCsrfMiddleware = createCsrfMiddleware({\n  filter: (ctx) => ctx.handlerType === 'serverFn',\n})\nconst getCachedBaseManifest = createCachedBaseManifestLoader(() =>\n  getStartManifest(),\n)\nconst getProdBaseManifest: typeof getStartManifest = () =>\n  getCachedBaseManifest()\nconst getBaseManifest =\n  process.env.TSS_DEV_SERVER === 'true' ? getStartManifest : getProdBaseManifest\nconst createEarlyHintsForRequest: typeof createEarlyHintsCollector =\n  process.env.TSS_DEV_SERVER === 'true'\n    ? () => undefined\n    : createEarlyHintsCollector\n\nasync function loadEntries(): Promise<Entries> {\n  const [routerEntry, startEntry, pluginAdapters] = await Promise.all([\n    // @ts-ignore When building, we currently don't respect tsconfig.ts' `include` so we are not picking up the .d.ts from start-client-core\n    import('#tanstack-router-entry'),\n    // @ts-ignore When building, we currently don't respect tsconfig.ts' `include` so we are not picking up the .d.ts from start-client-core\n    import('#tanstack-start-entry'),\n    // @ts-ignore When building, we currently don't respect tsconfig.ts' `include` so we are not picking up the .d.ts from start-client-core\n    import('#tanstack-start-plugin-adapters'),\n  ])\n  return {\n    routerEntry: routerEntry as unknown as RouterEntry,\n    startEntry: startEntry as unknown as StartEntry,\n    pluginAdapters: pluginAdapters as unknown as PluginAdaptersEntry,\n  }\n}\n\nfunction getEntries() {\n  if (!entriesPromise) {\n    entriesPromise = loadEntries()\n  }\n  return entriesPromise\n}\n\nfunction hasCsrfMiddleware(\n  middlewares: Array<AnyRequestMiddleware | AnyFunctionMiddleware>,\n): boolean {\n  return middlewares.some((middleware) => csrfSymbol in middleware)\n}\n\nfunction warnMissingCsrfMiddlewareOnce() {\n  if (hasWarnedMissingCsrfMiddleware) return\n  hasWarnedMissingCsrfMiddleware = true\n\n  console.warn(`TanStack Start server functions are not protected by the CSRF middleware.\n\nServer functions are same-origin RPC endpoints and should be protected from cross-site requests.\n\nAdd the CSRF middleware in src/start.ts:\n\n  const csrfMiddleware = createCsrfMiddleware({\n    filter: (ctx) => ctx.handlerType === 'serverFn',\n  })\n\n  export const startInstance = createStart(() => ({\n    requestMiddleware: [csrfMiddleware],\n  }))\n\nIf you intentionally handle CSRF another way, disable this warning:\n\n  tanstackStart({\n    serverFns: {\n      disableCsrfMiddlewareWarning: true,\n    },\n  })`)\n}\n\n// Pre-computed constants\nconst ROUTER_BASEPATH = process.env.TSS_ROUTER_BASEPATH || '/'\nconst SERVER_FN_BASE = process.env.TSS_SERVER_FN_BASE\nconst IS_PRERENDERING = process.env.TSS_PRERENDERING === 'true'\nconst IS_SHELL_ENV = process.env.TSS_SHELL === 'true'\nconst IS_DEV = process.env.NODE_ENV === 'development'\n\n// Reusable error messages\nconst ERR_NO_RESPONSE = IS_DEV\n  ? `It looks like you forgot to return a response from your server route handler. If you want to defer to the app router, make sure to have a component set in this route.`\n  : 'Internal Server Error'\n\nconst ERR_NO_DEFER = IS_DEV\n  ? `You cannot defer to the app router if there is no component defined on this route.`\n  : 'Internal Server Error'\n\nfunction throwRouteHandlerError(): never {\n  throw new Error(ERR_NO_RESPONSE)\n}\n\nfunction throwIfMayNotDefer(): never {\n  throw new Error(ERR_NO_DEFER)\n}\n\n/**\n * Check if a value is a special response (Response or Redirect)\n */\nfunction isSpecialResponse(value: unknown): value is Response {\n  return value instanceof Response || isRedirect(value)\n}\n\n/**\n * Normalize middleware result to context shape\n */\nfunction handleCtxResult(result: TODO) {\n  if (isSsrResponse(result) || isSpecialResponse(result)) {\n    return { response: result }\n  }\n  return result\n}\n\n/**\n * Execute a middleware chain\n */\nasync function executeMiddleware(\n  middlewares: Array<TODO>,\n  ctx: TODO,\n): Promise<{ ctx: TODO; response: HandlerCallbackResult }> {\n  let index = -1\n  let streamResponse:\n    | Extract<SsrResponse, { serverSsrCleanup: 'stream' }>\n    | undefined\n\n  const setResponse = (response: TODO) => {\n    if (isSsrResponse(response)) {\n      if (response.serverSsrCleanup === 'stream') {\n        streamResponse = response\n      }\n      ctx.response = response.response\n      return\n    }\n\n    ctx.response = response\n  }\n\n  const disposeStreamResponse = async (reason: string) => {\n    const response = streamResponse\n    if (!response) {\n      return\n    }\n\n    streamResponse = undefined\n    const currentResponse = ctx.response\n    if (\n      currentResponse === response.response ||\n      (currentResponse instanceof Response &&\n        response.response.body !== null &&\n        currentResponse.body === response.response.body)\n    ) {\n      ctx.response = undefined\n    }\n    await response.dispose(reason)\n  }\n\n  const getFinalResponse = async (): Promise<HandlerCallbackResult> => {\n    const response = ctx.response\n    if (!response) {\n      throwRouteHandlerError()\n    }\n\n    if (!streamResponse) {\n      return response\n    }\n\n    if (response === streamResponse.response) {\n      return streamResponse\n    }\n\n    if (\n      streamResponse.response.body !== null &&\n      response.body === streamResponse.response.body\n    ) {\n      return { ...streamResponse, response }\n    }\n\n    await disposeStreamResponse('middleware response replaced')\n    return response\n  }\n\n  const next = async (nextCtx?: TODO): Promise<TODO> => {\n    // Merge context if provided using safeObjectMerge for prototype pollution prevention\n    if (nextCtx) {\n      if (nextCtx.context) {\n        ctx.context = safeObjectMerge(ctx.context, nextCtx.context)\n      }\n      // Copy own properties except context (Object.keys returns only own enumerable properties)\n      for (const key of Object.keys(nextCtx)) {\n        if (key === 'response') {\n          setResponse(nextCtx.response)\n        } else if (key !== 'context') {\n          ctx[key] = nextCtx[key]\n        }\n      }\n    }\n\n    index++\n    const middleware = middlewares[index]\n    if (!middleware) return ctx\n\n    let result: TODO\n    try {\n      result = await middleware({ ...ctx, next })\n    } catch (err) {\n      if (isSpecialResponse(err)) {\n        setResponse(err)\n        return ctx\n      }\n      await disposeStreamResponse('middleware error')\n      throw err\n    }\n\n    const normalized = handleCtxResult(result)\n    if (normalized) {\n      if (normalized.response !== undefined) {\n        setResponse(normalized.response)\n      }\n      if (normalized.context) {\n        ctx.context = safeObjectMerge(ctx.context, normalized.context)\n      }\n    }\n\n    return ctx\n  }\n\n  await next()\n  return { ctx, response: await getFinalResponse() }\n}\n\n/**\n * Wrap a route handler as middleware\n */\nfunction handlerToMiddleware(\n  handler: RouteMethodHandlerFn<any, AnyRoute, any, any, any, any, any>,\n  mayDefer: boolean = false,\n): TODO {\n  if (mayDefer) {\n    return handler\n  }\n  return async (ctx: TODO) => {\n    const response = await handler({ ...ctx, next: throwIfMayNotDefer })\n    if (!response) {\n      throwRouteHandlerError()\n    }\n    return response\n  }\n}\n\n/**\n * Creates the TanStack Start request handler.\n *\n * @example Backwards-compatible usage (handler callback only):\n * ```ts\n * export default createStartHandler(defaultStreamHandler)\n * ```\n *\n * @example With CDN URL rewriting:\n * ```ts\n * export default createStartHandler({\n *   handler: defaultStreamHandler,\n *   transformAssets: 'https://cdn.example.com',\n * })\n * ```\n *\n * @example With per-request URL rewriting:\n * ```ts\n * export default createStartHandler({\n *   handler: defaultStreamHandler,\n *   transformAssets: {\n *     transform: ({ url }) => {\n *       const cdnBase = getRequest().headers.get('x-cdn-base') || ''\n *       return { href: `${cdnBase}${url}` }\n *     },\n *     cache: false,\n *   },\n * })\n * ```\n */\nexport function createStartHandler<TRegister = Register>(\n  cbOrOptions: HandlerCallback<AnyRouter> | CreateStartHandlerOptions,\n): RequestHandler<TRegister> {\n  const handlerOptions: FinalManifestOptions =\n    typeof cbOrOptions === 'function' ? {} : cbOrOptions\n  const cb: HandlerCallback<AnyRouter> =\n    typeof cbOrOptions === 'function' ? cbOrOptions : cbOrOptions.handler\n  const finalManifestResolver = createFinalManifestResolver({\n    ...handlerOptions,\n    cacheCreateTransform: process.env.TSS_DEV_SERVER !== 'true',\n  })\n  const resolveManifestForRequest =\n    process.env.TSS_DEV_SERVER === 'true'\n      ? finalManifestResolver.resolveUncached\n      : finalManifestResolver.resolveCached\n\n  if (process.env.TSS_DEV_SERVER !== 'true') {\n    finalManifestResolver.warmup({\n      getBaseManifest: () => getBaseManifest(undefined),\n    })\n  }\n\n  const startRequestResolver: RequestHandler<Register> = async (\n    request,\n    requestOpts,\n  ) => {\n    let router: AnyRouter | null = null as AnyRouter | null\n    let responseOwnsCleanup = false as boolean\n\n    try {\n      // normalizing and sanitizing the pathname here for server, so we always deal with the same format during SSR.\n      // during normalization paths like '//posts' are flattened to '/posts'.\n      // in these cases we would prefer to redirect to the new path\n      const { url, handledProtocolRelativeURL } = getNormalizedURL(request.url)\n      const href = url.pathname + url.search + url.hash\n      const origin = getOrigin(request)\n\n      if (handledProtocolRelativeURL) {\n        return Response.redirect(url, 308)\n      }\n\n      const entries = await getEntries()\n      const hasStartInstance = !!entries.startEntry.startInstance\n      const startOptions: AnyStartInstanceOptions =\n        (await entries.startEntry.startInstance?.getOptions()) ||\n        ({} as AnyStartInstanceOptions)\n\n      const { hasPluginAdapters, pluginSerializationAdapters } =\n        entries.pluginAdapters\n\n      const serializationAdapters = [\n        ...(startOptions.serializationAdapters || []),\n        ...(hasPluginAdapters ? pluginSerializationAdapters : []),\n        ServerFunctionSerializationAdapter,\n      ]\n\n      const requestStartOptions = {\n        ...startOptions,\n        requestMiddleware: hasStartInstance\n          ? startOptions.requestMiddleware\n          : [defaultCsrfMiddleware],\n        serializationAdapters,\n      }\n\n      // Flatten request middlewares once\n      const flattenedRequestMiddlewares = requestStartOptions.requestMiddleware\n        ? flattenMiddlewares(requestStartOptions.requestMiddleware)\n        : []\n\n      // Create set for deduplication\n      const executedRequestMiddlewares = new Set<TODO>(\n        flattenedRequestMiddlewares,\n      )\n\n      // Memoized router getter\n      const getRouter = async (): Promise<AnyRouter> => {\n        if (router) return router\n\n        router = await entries.routerEntry.getRouter()\n\n        let isShell = IS_SHELL_ENV\n        if (IS_PRERENDERING && !isShell) {\n          isShell = request.headers.get(HEADERS.TSS_SHELL) === 'true'\n        }\n\n        const history = createMemoryHistory({\n          initialEntries: [href],\n        })\n\n        router.update({\n          history,\n          isShell,\n          isPrerendering: IS_PRERENDERING,\n          origin: router.options.origin ?? origin,\n          ...{\n            defaultSsr: requestStartOptions.defaultSsr,\n            serializationAdapters: [\n              ...requestStartOptions.serializationAdapters,\n              ...(router.options.serializationAdapters || []),\n            ],\n          },\n          basepath: ROUTER_BASEPATH,\n        })\n\n        return router\n      }\n\n      // Check for server function requests first (early exit)\n      if (SERVER_FN_BASE && url.pathname.startsWith(SERVER_FN_BASE)) {\n        if (\n          process.env.NODE_ENV !== 'production' &&\n          process.env.TSS_DISABLE_CSRF_MIDDLEWARE_WARNING !== 'true' &&\n          !hasCsrfMiddleware(flattenedRequestMiddlewares)\n        ) {\n          warnMissingCsrfMiddlewareOnce()\n        }\n\n        const serverFnId = url.pathname\n          .slice(SERVER_FN_BASE.length)\n          .split('/')[0]\n\n        if (!serverFnId) {\n          throw new Error('Invalid server action param for serverFnId')\n        }\n\n        const serverFnHandler = async ({ context }: TODO) => {\n          return runWithStartContext(\n            {\n              getRouter,\n              startOptions: requestStartOptions,\n              contextAfterGlobalMiddlewares: context,\n              request,\n              executedRequestMiddlewares,\n              handlerType: 'serverFn',\n            },\n            () =>\n              handleServerAction({\n                request,\n                context: requestOpts?.context,\n                serverFnId,\n              }),\n          )\n        }\n\n        const middlewares = flattenedRequestMiddlewares.map(\n          (d) => d.options.server,\n        )\n        const { response: middlewareResponse } = await executeMiddleware(\n          [...middlewares, serverFnHandler],\n          {\n            request,\n            pathname: url.pathname,\n            handlerType: 'serverFn',\n            context: createNullProtoObject(requestOpts?.context),\n          },\n        )\n\n        const result = await handleRedirectResponse(\n          middlewareResponse,\n          request,\n          getRouter,\n        )\n        responseOwnsCleanup = result.serverSsrCleanup === 'stream'\n        return result.response\n      }\n\n      // Router execution function\n      const executeRouter = async (\n        serverContext: TODO,\n        matchedRoutes?: ReadonlyArray<AnyRoute>,\n      ): Promise<SsrResponse> => {\n        const acceptHeader = request.headers.get('Accept') || '*/*'\n        const acceptParts = acceptHeader.split(',')\n        const supportedMimeTypes = ['*/*', 'text/html']\n\n        const isSupported = supportedMimeTypes.some((mimeType) =>\n          acceptParts.some((part) => part.trim().startsWith(mimeType)),\n        )\n\n        if (!isSupported) {\n          return normalizeSsrResponse(\n            Response.json(\n              { error: 'Only HTML requests are supported here' },\n              { status: 500 },\n            ),\n          )\n        }\n\n        const manifest = await resolveManifestForRequest({\n          request,\n          requestInlineCss: requestOpts?.inlineCss,\n          getBaseManifest: () => getBaseManifest(matchedRoutes),\n        })\n\n        const earlyHints = createEarlyHintsForRequest({\n          onEarlyHints: requestOpts?.onEarlyHints,\n          responseLinkHeader: requestOpts?.responseLinkHeader,\n        })\n\n        earlyHints?.collectStatic({ manifest, matchedRoutes })\n\n        const routerInstance = await getRouter()\n\n        attachRouterServerSsrUtils({\n          router: routerInstance,\n          manifest,\n          getRequestAssets: () =>\n            getStartContext({ throwIfNotFound: false })?.requestAssets,\n        })\n\n        routerInstance.update({ additionalContext: { serverContext } })\n        await routerInstance.load()\n\n        if (routerInstance.state.redirect) {\n          return normalizeSsrResponse(routerInstance.state.redirect)\n        }\n\n        earlyHints?.collectDynamic(routerInstance.stores.matches.get())\n\n        // Pass request-scoped assets to dehydrate for manifest injection\n        const ctx = getStartContext({ throwIfNotFound: false })\n        await routerInstance.serverSsr!.dehydrate({\n          requestAssets: ctx?.requestAssets,\n        })\n\n        const responseHeaders = getStartResponseHeaders({\n          router: routerInstance,\n        })\n        earlyHints?.appendResponseHeaders(responseHeaders)\n        const response = await cb({\n          request,\n          router: routerInstance,\n          responseHeaders,\n        })\n        return normalizeSsrResponse(response)\n      }\n\n      // Main request handler\n      const requestHandlerMiddleware = async ({ context }: TODO) => {\n        return runWithStartContext(\n          {\n            getRouter,\n            startOptions: requestStartOptions,\n            contextAfterGlobalMiddlewares: context,\n            request,\n            executedRequestMiddlewares,\n            handlerType: 'router',\n          },\n          async () => {\n            try {\n              return await handleServerRoutes({\n                getRouter,\n                request,\n                url,\n                executeRouter,\n                context,\n                executedRequestMiddlewares,\n              })\n            } catch (err) {\n              if (err instanceof Response) {\n                return err\n              }\n              throw err\n            }\n          },\n        )\n      }\n\n      const middlewares = flattenedRequestMiddlewares.map(\n        (d) => d.options.server,\n      )\n      const { response: middlewareResponse } = await executeMiddleware(\n        [...middlewares, requestHandlerMiddleware],\n        {\n          request,\n          pathname: url.pathname,\n          handlerType: 'router',\n          context: createNullProtoObject(requestOpts?.context),\n        },\n      )\n\n      const response = await handleRedirectResponse(\n        middlewareResponse,\n        request,\n        getRouter,\n      )\n      responseOwnsCleanup = response.serverSsrCleanup === 'stream'\n      return response.response\n    } finally {\n      if (router?.serverSsr && !responseOwnsCleanup) {\n        // Clean up router SSR state if it was set up but won't be cleaned up by the callback\n        // (e.g., in redirect cases or early returns before the callback is invoked).\n        // Transformed streaming response bodies clean up when consumed/cancelled.\n        router.serverSsr.cleanup()\n      }\n      router = null\n    }\n  }\n\n  return requestHandler(startRequestResolver)\n}\n\nasync function handleRedirectResponse(\n  response: HandlerCallbackResult,\n  request: Request,\n  getRouter: () => Promise<AnyRouter>,\n): Promise<SsrResponse> {\n  const ssrResponse = normalizeSsrResponse(response)\n  if (!isRedirect(ssrResponse.response)) {\n    return ssrResponse\n  }\n\n  if (isResolvedRedirect(ssrResponse.response)) {\n    if (request.headers.get('x-tsr-serverFn') === 'true') {\n      return replaceSsrResponse(\n        ssrResponse,\n        Response.json(\n          { ...ssrResponse.response.options, isSerializedRedirect: true },\n          { headers: ssrResponse.response.headers },\n        ),\n        'redirect response replaced',\n      )\n    }\n    return ssrResponse\n  }\n\n  const opts = ssrResponse.response.options\n  if (opts.to && typeof opts.to === 'string' && !opts.to.startsWith('/')) {\n    throw new Error(\n      `Server side redirects must use absolute paths via the 'href' or 'to' options. The redirect() method's \"to\" property accepts an internal path only. Use the \"href\" property to provide an external URL. Received: ${JSON.stringify(opts)}`,\n    )\n  }\n\n  if (\n    ['params', 'search', 'hash'].some(\n      (d) => typeof (opts as TODO)[d] === 'function',\n    )\n  ) {\n    throw new Error(\n      `Server side redirects must use static search, params, and hash values and do not support functional values. Received functional values for: ${Object.keys(\n        opts,\n      )\n        .filter((d) => typeof (opts as TODO)[d] === 'function')\n        .map((d) => `\"${d}\"`)\n        .join(', ')}`,\n    )\n  }\n\n  const router = await getRouter()\n  const redirect = router.resolveRedirect(ssrResponse.response)\n\n  if (request.headers.get('x-tsr-serverFn') === 'true') {\n    return replaceSsrResponse(\n      ssrResponse,\n      Response.json(\n        { ...ssrResponse.response.options, isSerializedRedirect: true },\n        { headers: ssrResponse.response.headers },\n      ),\n      'redirect response replaced',\n    )\n  }\n\n  return replaceSsrResponse(ssrResponse, redirect, 'redirect response replaced')\n}\n\nasync function handleServerRoutes({\n  getRouter,\n  request,\n  url,\n  executeRouter,\n  context,\n  executedRequestMiddlewares,\n}: {\n  getRouter: () => Promise<AnyRouter>\n  request: Request\n  url: URL\n  executeRouter: (\n    serverContext: any,\n    matchedRoutes?: ReadonlyArray<AnyRoute>,\n  ) => Promise<SsrResponse>\n  context: any\n  executedRequestMiddlewares: Set<AnyRequestMiddleware>\n}): Promise<SsrResponse> {\n  const router = await getRouter()\n  const rewrittenUrl = executeRewriteInput(router.rewrite, url)\n  const pathname = rewrittenUrl.pathname\n  // this will perform a fuzzy match, however for server routes we need an exact match\n  // if the route is not an exact match, executeRouter will handle rendering the app router\n  // the match will be cached internally, so no extra work is done during the app router render\n  const { matchedRoutes, foundRoute, routeParams } =\n    router.getMatchedRoutes(pathname)\n\n  const isExactMatch = foundRoute && routeParams['**'] === undefined\n\n  // Collect and dedupe route middlewares\n  const routeMiddlewares: Array<AnyMiddlewareServerFn> = []\n\n  // Collect middleware from matched routes, filtering out those already executed\n  // in the request phase\n  for (const route of matchedRoutes) {\n    const serverMiddleware = route.options.server?.middleware as\n      | Array<AnyRequestMiddleware>\n      | undefined\n    if (serverMiddleware) {\n      const flattened = flattenMiddlewares(serverMiddleware)\n      for (const m of flattened) {\n        if (!executedRequestMiddlewares.has(m)) {\n          routeMiddlewares.push(m.options.server)\n        }\n      }\n    }\n  }\n\n  // Add handler middleware if exact match\n  const server = foundRoute?.options.server\n  let isHeadFallback = false\n  if (server?.handlers && isExactMatch) {\n    const handlers =\n      typeof server.handlers === 'function'\n        ? server.handlers({ createHandlers: (d: any) => d })\n        : server.handlers\n\n    const requestMethod = request.method.toUpperCase() as RouteMethod\n    // Per RFC 9110 §9.3.2, HEAD must return the same header fields as GET.\n    // Priority for HEAD: explicit HEAD handler → GET → ANY (last resort).\n    const handler =\n      requestMethod === 'HEAD'\n        ? (handlers['HEAD'] ?? handlers['GET'] ?? handlers['ANY'])\n        : (handlers[requestMethod] ?? handlers['ANY'])\n    isHeadFallback =\n      requestMethod === 'HEAD' && handler !== undefined && !handlers['HEAD']\n\n    if (handler) {\n      const mayDefer = !!foundRoute.options.component\n\n      if (typeof handler === 'function') {\n        routeMiddlewares.push(handlerToMiddleware(handler, mayDefer))\n      } else {\n        if (handler.middleware?.length) {\n          const handlerMiddlewares = flattenMiddlewares(handler.middleware)\n          for (const m of handlerMiddlewares) {\n            routeMiddlewares.push(m.options.server)\n          }\n        }\n        if (handler.handler) {\n          routeMiddlewares.push(handlerToMiddleware(handler.handler, mayDefer))\n        }\n      }\n    }\n  }\n\n  // Final middleware: execute router with matched routes for dev styles\n  routeMiddlewares.push(((ctx: TODO) =>\n    executeRouter(ctx.context, matchedRoutes)) as TODO)\n\n  const { ctx, response } = await executeMiddleware(routeMiddlewares, {\n    request,\n    context,\n    params: routeParams,\n    pathname,\n    handlerType: 'router',\n  })\n\n  // RFC 9110 §9.3.2: HEAD must carry the same header fields as GET but no body.\n  // Resolve any redirect before stripping so the Location header survives.\n  if (isHeadFallback) {\n    if (!ctx.response) {\n      throwRouteHandlerError()\n    }\n\n    const resolved = await handleRedirectResponse(response, request, getRouter)\n    return stripSsrResponseBody(resolved, 'HEAD body stripped')\n  }\n\n  return normalizeSsrResponse(response)\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/start-server-core",
-  "version": "1.169.5",
+  "version": "1.169.6",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -70,9 +70,9 @@
     "h3-v2": "npm:h3@2.0.1-rc.20",
     "seroval": "^1.5.4",
     "@tanstack/history": "1.162.0",
-    "@tanstack/router-core": "1.171.6",
-    "@tanstack/start-client-core": "1.170.4",
-    "@tanstack/start-storage-context": "1.167.8"
+    "@tanstack/start-storage-context": "1.167.9",
+    "@tanstack/router-core": "1.171.7",
+    "@tanstack/start-client-core": "1.170.5"
   },
   "devDependencies": {
     "@standard-schema/spec": "^1.0.0",

package/src/createStartHandler.ts

@@ -16,6 +16,10 @@ import {
   attachRouterServerSsrUtils,
   getNormalizedURL,
   getOrigin,
+  isSsrResponse,
+  normalizeSsrResponse,
+  replaceSsrResponse,
+  stripSsrResponseBody,
 } from '@tanstack/router-core/ssr/server'
 import {
   getStartContext,
@@ -48,7 +52,11 @@ import type {
   AnySerializationAdapter,
   Register,
 } from '@tanstack/router-core'
-import type { HandlerCallback } from '@tanstack/router-core/ssr/server'
+import type {
+  HandlerCallback,
+  HandlerCallbackResult,
+  SsrResponse,
+} from '@tanstack/router-core/ssr/server'
 import type { FinalManifestOptions } from './finalManifest'
 
 type TODO = any
@@ -194,7 +202,7 @@ function isSpecialResponse(value: unknown): value is Response {
  * Normalize middleware result to context shape
  */
 function handleCtxResult(result: TODO) {
-  if (isSpecialResponse(result)) {
+  if (isSsrResponse(result) || isSpecialResponse(result)) {
     return { response: result }
   }
   return result
@@ -203,8 +211,70 @@ function handleCtxResult(result: TODO) {
 /**
  * Execute a middleware chain
  */
-function executeMiddleware(middlewares: Array<TODO>, ctx: TODO): Promise<TODO> {
+async function executeMiddleware(
+  middlewares: Array<TODO>,
+  ctx: TODO,
+): Promise<{ ctx: TODO; response: HandlerCallbackResult }> {
   let index = -1
+  let streamResponse:
+    | Extract<SsrResponse, { serverSsrCleanup: 'stream' }>
+    | undefined
+
+  const setResponse = (response: TODO) => {
+    if (isSsrResponse(response)) {
+      if (response.serverSsrCleanup === 'stream') {
+        streamResponse = response
+      }
+      ctx.response = response.response
+      return
+    }
+
+    ctx.response = response
+  }
+
+  const disposeStreamResponse = async (reason: string) => {
+    const response = streamResponse
+    if (!response) {
+      return
+    }
+
+    streamResponse = undefined
+    const currentResponse = ctx.response
+    if (
+      currentResponse === response.response ||
+      (currentResponse instanceof Response &&
+        response.response.body !== null &&
+        currentResponse.body === response.response.body)
+    ) {
+      ctx.response = undefined
+    }
+    await response.dispose(reason)
+  }
+
+  const getFinalResponse = async (): Promise<HandlerCallbackResult> => {
+    const response = ctx.response
+    if (!response) {
+      throwRouteHandlerError()
+    }
+
+    if (!streamResponse) {
+      return response
+    }
+
+    if (response === streamResponse.response) {
+      return streamResponse
+    }
+
+    if (
+      streamResponse.response.body !== null &&
+      response.body === streamResponse.response.body
+    ) {
+      return { ...streamResponse, response }
+    }
+
+    await disposeStreamResponse('middleware response replaced')
+    return response
+  }
 
   const next = async (nextCtx?: TODO): Promise<TODO> => {
     // Merge context if provided using safeObjectMerge for prototype pollution prevention
@@ -214,7 +284,9 @@ function executeMiddleware(middlewares: Array<TODO>, ctx: TODO): Promise<TODO> {
       }
       // Copy own properties except context (Object.keys returns only own enumerable properties)
       for (const key of Object.keys(nextCtx)) {
-        if (key !== 'context') {
+        if (key === 'response') {
+          setResponse(nextCtx.response)
+        } else if (key !== 'context') {
           ctx[key] = nextCtx[key]
         }
       }
@@ -229,16 +301,17 @@ function executeMiddleware(middlewares: Array<TODO>, ctx: TODO): Promise<TODO> {
       result = await middleware({ ...ctx, next })
     } catch (err) {
       if (isSpecialResponse(err)) {
-        ctx.response = err
+        setResponse(err)
         return ctx
       }
+      await disposeStreamResponse('middleware error')
       throw err
     }
 
     const normalized = handleCtxResult(result)
     if (normalized) {
       if (normalized.response !== undefined) {
-        ctx.response = normalized.response
+        setResponse(normalized.response)
       }
       if (normalized.context) {
         ctx.context = safeObjectMerge(ctx.context, normalized.context)
@@ -248,7 +321,8 @@ function executeMiddleware(middlewares: Array<TODO>, ctx: TODO): Promise<TODO> {
     return ctx
   }
 
-  return next()
+  await next()
+  return { ctx, response: await getFinalResponse() }
 }
 
 /**
@@ -327,7 +401,7 @@ export function createStartHandler<TRegister = Register>(
     requestOpts,
   ) => {
     let router: AnyRouter | null = null as AnyRouter | null
-    let cbWillCleanup = false as boolean
+    let responseOwnsCleanup = false as boolean
 
     try {
       // normalizing and sanitizing the pathname here for server, so we always deal with the same format during SSR.
@@ -447,21 +521,30 @@ export function createStartHandler<TRegister = Register>(
         const middlewares = flattenedRequestMiddlewares.map(
           (d) => d.options.server,
         )
-        const ctx = await executeMiddleware([...middlewares, serverFnHandler], {
-          request,
-          pathname: url.pathname,
-          handlerType: 'serverFn',
-          context: createNullProtoObject(requestOpts?.context),
-        })
+        const { response: middlewareResponse } = await executeMiddleware(
+          [...middlewares, serverFnHandler],
+          {
+            request,
+            pathname: url.pathname,
+            handlerType: 'serverFn',
+            context: createNullProtoObject(requestOpts?.context),
+          },
+        )
 
-        return handleRedirectResponse(ctx.response, request, getRouter)
+        const result = await handleRedirectResponse(
+          middlewareResponse,
+          request,
+          getRouter,
+        )
+        responseOwnsCleanup = result.serverSsrCleanup === 'stream'
+        return result.response
       }
 
       // Router execution function
       const executeRouter = async (
         serverContext: TODO,
         matchedRoutes?: ReadonlyArray<AnyRoute>,
-      ): Promise<Response> => {
+      ): Promise<SsrResponse> => {
         const acceptHeader = request.headers.get('Accept') || '*/*'
         const acceptParts = acceptHeader.split(',')
         const supportedMimeTypes = ['*/*', 'text/html']
@@ -471,9 +554,11 @@ export function createStartHandler<TRegister = Register>(
         )
 
         if (!isSupported) {
-          return Response.json(
-            { error: 'Only HTML requests are supported here' },
-            { status: 500 },
+          return normalizeSsrResponse(
+            Response.json(
+              { error: 'Only HTML requests are supported here' },
+              { status: 500 },
+            ),
           )
         }
 
@@ -503,7 +588,7 @@ export function createStartHandler<TRegister = Register>(
         await routerInstance.load()
 
         if (routerInstance.state.redirect) {
-          return routerInstance.state.redirect
+          return normalizeSsrResponse(routerInstance.state.redirect)
         }
 
         earlyHints?.collectDynamic(routerInstance.stores.matches.get())
@@ -518,13 +603,12 @@ export function createStartHandler<TRegister = Register>(
           router: routerInstance,
         })
         earlyHints?.appendResponseHeaders(responseHeaders)
-        cbWillCleanup = true
-
-        return cb({
+        const response = await cb({
           request,
           router: routerInstance,
           responseHeaders,
         })
+        return normalizeSsrResponse(response)
       }
 
       // Main request handler
@@ -561,7 +645,7 @@ export function createStartHandler<TRegister = Register>(
       const middlewares = flattenedRequestMiddlewares.map(
         (d) => d.options.server,
       )
-      const ctx = await executeMiddleware(
+      const { response: middlewareResponse } = await executeMiddleware(
         [...middlewares, requestHandlerMiddleware],
         {
           request,
@@ -571,14 +655,19 @@ export function createStartHandler<TRegister = Register>(
         },
       )
 
-      return handleRedirectResponse(ctx.response, request, getRouter)
+      const response = await handleRedirectResponse(
+        middlewareResponse,
+        request,
+        getRouter,
+      )
+      responseOwnsCleanup = response.serverSsrCleanup === 'stream'
+      return response.response
     } finally {
-      if (router && !cbWillCleanup) {
+      if (router?.serverSsr && !responseOwnsCleanup) {
         // Clean up router SSR state if it was set up but won't be cleaned up by the callback
         // (e.g., in redirect cases or early returns before the callback is invoked).
-        // When the callback runs, it handles cleanup (either via transformStreamWithRouter
-        // for streaming, or directly in renderRouterToString for non-streaming).
-        router.serverSsr?.cleanup()
+        // Transformed streaming response bodies clean up when consumed/cancelled.
+        router.serverSsr.cleanup()
       }
       router = null
     }
@@ -588,25 +677,30 @@ export function createStartHandler<TRegister = Register>(
 }
 
 async function handleRedirectResponse(
-  response: Response,
+  response: HandlerCallbackResult,
   request: Request,
   getRouter: () => Promise<AnyRouter>,
-): Promise<Response> {
-  if (!isRedirect(response)) {
-    return response
+): Promise<SsrResponse> {
+  const ssrResponse = normalizeSsrResponse(response)
+  if (!isRedirect(ssrResponse.response)) {
+    return ssrResponse
   }
 
-  if (isResolvedRedirect(response)) {
+  if (isResolvedRedirect(ssrResponse.response)) {
     if (request.headers.get('x-tsr-serverFn') === 'true') {
-      return Response.json(
-        { ...response.options, isSerializedRedirect: true },
-        { headers: response.headers },
+      return replaceSsrResponse(
+        ssrResponse,
+        Response.json(
+          { ...ssrResponse.response.options, isSerializedRedirect: true },
+          { headers: ssrResponse.response.headers },
+        ),
+        'redirect response replaced',
       )
     }
-    return response
+    return ssrResponse
   }
 
-  const opts = response.options
+  const opts = ssrResponse.response.options
   if (opts.to && typeof opts.to === 'string' && !opts.to.startsWith('/')) {
     throw new Error(
       `Server side redirects must use absolute paths via the 'href' or 'to' options. The redirect() method's "to" property accepts an internal path only. Use the "href" property to provide an external URL. Received: ${JSON.stringify(opts)}`,
@@ -629,16 +723,20 @@ async function handleRedirectResponse(
   }
 
   const router = await getRouter()
-  const redirect = router.resolveRedirect(response)
+  const redirect = router.resolveRedirect(ssrResponse.response)
 
   if (request.headers.get('x-tsr-serverFn') === 'true') {
-    return Response.json(
-      { ...response.options, isSerializedRedirect: true },
-      { headers: response.headers },
+    return replaceSsrResponse(
+      ssrResponse,
+      Response.json(
+        { ...ssrResponse.response.options, isSerializedRedirect: true },
+        { headers: ssrResponse.response.headers },
+      ),
+      'redirect response replaced',
     )
   }
 
-  return redirect
+  return replaceSsrResponse(ssrResponse, redirect, 'redirect response replaced')
 }
 
 async function handleServerRoutes({
@@ -655,10 +753,10 @@ async function handleServerRoutes({
   executeRouter: (
     serverContext: any,
     matchedRoutes?: ReadonlyArray<AnyRoute>,
-  ) => Promise<Response>
+  ) => Promise<SsrResponse>
   context: any
   executedRequestMiddlewares: Set<AnyRequestMiddleware>
-}): Promise<Response> {
+}): Promise<SsrResponse> {
   const router = await getRouter()
   const rewrittenUrl = executeRewriteInput(router.rewrite, url)
   const pathname = rewrittenUrl.pathname
@@ -728,11 +826,10 @@ async function handleServerRoutes({
   }
 
   // Final middleware: execute router with matched routes for dev styles
-  routeMiddlewares.push((ctx: TODO) =>
-    executeRouter(ctx.context, matchedRoutes),
-  )
+  routeMiddlewares.push(((ctx: TODO) =>
+    executeRouter(ctx.context, matchedRoutes)) as TODO)
 
-  const ctx = await executeMiddleware(routeMiddlewares, {
+  const { ctx, response } = await executeMiddleware(routeMiddlewares, {
     request,
     context,
     params: routeParams,
@@ -747,13 +844,9 @@ async function handleServerRoutes({
       throwRouteHandlerError()
     }
 
-    const resolved = await handleRedirectResponse(
-      ctx.response,
-      request,
-      getRouter,
-    )
-    return new Response(null, resolved)
+    const resolved = await handleRedirectResponse(response, request, getRouter)
+    return stripSsrResponseBody(resolved, 'HEAD body stripped')
   }
 
-  return ctx.response
+  return normalizeSsrResponse(response)
 }