@tanstack/start-server-core 1.121.0-alpha.27 → 1.121.0-alpha.28

package/dist/esm/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const HEADERS: {
+    readonly TSS_SHELL: "X-TSS_SHELL";
+};

package/dist/esm/constants.js

@@ -0,0 +1,7 @@
+const HEADERS = {
+  TSS_SHELL: "X-TSS_SHELL"
+};
+export {
+  HEADERS
+};
+//# sourceMappingURL=constants.js.map

package/dist/esm/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sources":["../../src/constants.ts"],"sourcesContent":["export const HEADERS = {\n  TSS_SHELL: 'X-TSS_SHELL',\n} as const\n"],"names":[],"mappings":"AAAO,MAAM,UAAU;AAAA,EACrB,WAAW;AACb;"}

package/dist/esm/createStartHandler.d.ts

@@ -1,10 +1,7 @@
-import { RequestHandler } from './h3.js';
-import { AnyRouter } from '@tanstack/router-core';
-import { HandlerCallback } from './handlerCallback.js';
+import { RequestHandler } from './request-response.js';
+import { AnyRouter, Awaitable } from '@tanstack/router-core';
+import { HandlerCallback } from '@tanstack/router-core/ssr/server';
 export type CustomizeStartHandler<TRouter extends AnyRouter> = (cb: HandlerCallback<TRouter>) => RequestHandler;
-export declare function getStartResponseHeaders(opts: {
-    router: AnyRouter;
-}): Headers;
 export declare function createStartHandler<TRouter extends AnyRouter>({ createRouter, }: {
-    createRouter: () => TRouter;
+    createRouter: () => Awaitable<TRouter>;
 }): CustomizeStartHandler<TRouter>;

package/dist/esm/createStartHandler.js

@@ -1,39 +1,39 @@
 import { createMemoryHistory } from "@tanstack/history";
-import { mergeHeaders, json, flattenMiddlewares } from "@tanstack/start-client-core";
-import { joinPaths, trimPath, isRedirect, isResolvedRedirect, processRouteTree, getMatchedRoutes, rootRouteId } from "@tanstack/router-core";
-import { getResponseHeaders, requestHandler } from "./h3.js";
-import { attachRouterServerSsrUtils, dehydrateRouter } from "./ssr-server.js";
+import { json, mergeHeaders, flattenMiddlewares } from "@tanstack/start-client-core";
+import { joinPaths, trimPath, processRouteTree, isRedirect, isResolvedRedirect, getMatchedRoutes } from "@tanstack/router-core";
+import { attachRouterServerSsrUtils } from "@tanstack/router-core/ssr/server";
+import { runWithStartContext } from "@tanstack/start-storage-context";
+import { requestHandler, getResponseHeaders } from "./request-response.js";
 import { getStartManifest } from "./router-manifest.js";
 import { handleServerAction } from "./server-functions-handler.js";
 import { VIRTUAL_MODULES } from "./virtual-modules.js";
 import { loadVirtualModule } from "./loadVirtualModule.js";
+import { HEADERS } from "./constants.js";
 function getStartResponseHeaders(opts) {
-  let headers = mergeHeaders(
+  const headers = mergeHeaders(
     getResponseHeaders(),
     {
-      "Content-Type": "text/html; charset=UTF-8"
+      "Content-Type": "text/html; charset=utf-8"
     },
     ...opts.router.state.matches.map((match) => {
       return match.headers;
     })
   );
-  const { redirect } = opts.router.state;
-  if (redirect) {
-    headers = mergeHeaders(headers, redirect.headers);
-  }
   return headers;
 }
 function createStartHandler({
   createRouter
 }) {
-  let serverRouteTree = null;
+  let routeTreeModule = null;
+  let startRoutesManifest = null;
+  let processedServerRouteTree = void 0;
   return (cb) => {
     const originalFetch = globalThis.fetch;
-    const startRequestResolver = async ({ request }) => {
+    const startRequestResolver = async (request) => {
       globalThis.fetch = async function(input, init) {
         function resolve(url2, requestOptions) {
           const fetchRequest = new Request(url2, requestOptions);
-          return startRequestResolver({ request: fetchRequest });
+          return startRequestResolver(fetchRequest);
         }
         function getOrigin() {
           return request.headers.get("Origin") || request.headers.get("Referer") || "http://localhost";
@@ -48,16 +48,21 @@ function createStartHandler({
         return originalFetch(input, init);
       };
       const url = new URL(request.url);
-      const href = url.href.replace(url.origin, "");
+      const href = decodeURIComponent(url.href.replace(url.origin, ""));
+      const APP_BASE = process.env.TSS_APP_BASE || "/";
+      const router = await createRouter();
       const history = createMemoryHistory({
         initialEntries: [href]
       });
-      const APP_BASE = process.env.TSS_APP_BASE || "/";
-      const router = createRouter();
-      const startRoutesManifest = await getStartManifest({ basePath: APP_BASE });
-      attachRouterServerSsrUtils(router, startRoutesManifest);
+      const isPrerendering = process.env.TSS_PRERENDERING === "true";
+      let isShell = process.env.TSS_SHELL === "true";
+      if (isPrerendering && !isShell) {
+        isShell = request.headers.get(HEADERS.TSS_SHELL) === "true";
+      }
       router.update({
-        history
+        history,
+        isShell,
+        isPrerendering
       });
       const response = await (async () => {
         try {
@@ -74,49 +79,75 @@ function createStartHandler({
           if (href.startsWith(serverFnBase)) {
             return await handleServerAction({ request });
           }
-          if (serverRouteTree === null) {
+          if (routeTreeModule === null) {
             try {
-              serverRouteTree = (await loadVirtualModule(VIRTUAL_MODULES.routeTree)).serverRouteTree;
+              routeTreeModule = await loadVirtualModule(
+                VIRTUAL_MODULES.routeTree
+              );
+              if (routeTreeModule.serverRouteTree) {
+                processedServerRouteTree = processRouteTree({
+                  routeTree: routeTreeModule.serverRouteTree,
+                  initRoute: (route, i) => {
+                    route.init({
+                      originalIndex: i
+                    });
+                  }
+                });
+              }
             } catch (e) {
               console.log(e);
             }
           }
-          if (serverRouteTree) {
-            const [_matchedRoutes, response3] = await handleServerRoutes({
-              routeTree: serverRouteTree,
+          const executeRouter = () => runWithStartContext({ router }, async () => {
+            const requestAcceptHeader = request.headers.get("Accept") || "*/*";
+            const splitRequestAcceptHeader = requestAcceptHeader.split(",");
+            const supportedMimeTypes = ["*/*", "text/html"];
+            const isRouterAcceptSupported = supportedMimeTypes.some(
+              (mimeType) => splitRequestAcceptHeader.some(
+                (acceptedMimeType) => acceptedMimeType.trim().startsWith(mimeType)
+              )
+            );
+            if (!isRouterAcceptSupported) {
+              return json(
+                {
+                  error: "Only HTML requests are supported here"
+                },
+                {
+                  status: 500
+                }
+              );
+            }
+            if (startRoutesManifest === null) {
+              startRoutesManifest = await getStartManifest({
+                basePath: APP_BASE
+              });
+            }
+            attachRouterServerSsrUtils(router, startRoutesManifest);
+            await router.load();
+            if (router.state.redirect) {
+              return router.state.redirect;
+            }
+            await router.serverSsr.dehydrate();
+            const responseHeaders = getStartResponseHeaders({ router });
+            const response2 = await cb({
               request,
-              basePath: APP_BASE
+              router,
+              responseHeaders
             });
-            if (response3) return response3;
-          }
-          const requestAcceptHeader = request.headers.get("Accept") || "*/*";
-          const splitRequestAcceptHeader = requestAcceptHeader.split(",");
-          const supportedMimeTypes = ["*/*", "text/html"];
-          const isRouterAcceptSupported = supportedMimeTypes.some(
-            (mimeType) => splitRequestAcceptHeader.some(
-              (acceptedMimeType) => acceptedMimeType.trim().startsWith(mimeType)
-            )
-          );
-          if (!isRouterAcceptSupported) {
-            return json(
-              {
-                error: "Only HTML requests are supported here"
-              },
-              {
-                status: 500
-              }
-            );
-          }
-          await router.load();
-          if (router.state.redirect) return router.state.redirect;
-          dehydrateRouter(router);
-          const responseHeaders = getStartResponseHeaders({ router });
-          const response2 = await cb({
-            request,
-            router,
-            responseHeaders
+            return response2;
           });
-          return response2;
+          if (processedServerRouteTree) {
+            const [_matchedRoutes, response2] = await handleServerRoutes({
+              processedServerRouteTree,
+              router,
+              request,
+              basePath: APP_BASE,
+              executeRouter
+            });
+            if (response2) return response2;
+          }
+          const routerResponse = await executeRouter();
+          return routerResponse;
         } catch (err) {
           if (err instanceof Response) {
             return err;
@@ -141,7 +172,7 @@ function createStartHandler({
         }
         if (response.options.to && typeof response.options.to === "string" && !response.options.to.startsWith("/")) {
           throw new Error(
-            `Server side redirects must use absolute paths via the 'href' or 'to' options. Received: ${JSON.stringify(response.options)}`
+            `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(response.options)}`
           );
         }
         if (["params", "search", "hash"].some(
@@ -172,60 +203,90 @@ function createStartHandler({
     return requestHandler(startRequestResolver);
   };
 }
-async function handleServerRoutes({
-  routeTree,
-  request,
-  basePath
-}) {
-  const { flatRoutes, routesById, routesByPath } = processRouteTree({
-    routeTree,
-    initRoute: (route, i) => {
-      route.init({
-        originalIndex: i
-      });
-    }
-  });
-  const url = new URL(request.url);
+async function handleServerRoutes(opts) {
+  const url = new URL(opts.request.url);
   const pathname = url.pathname;
-  const history = createMemoryHistory({
-    initialEntries: [pathname]
-  });
-  const { matchedRoutes, foundRoute, routeParams } = getMatchedRoutes({
-    pathname: history.location.pathname,
-    basepath: basePath,
+  const serverTreeResult = getMatchedRoutes({
+    pathname,
+    basepath: opts.basePath,
     caseSensitive: true,
-    routesByPath,
-    routesById,
-    flatRoutes
+    routesByPath: opts.processedServerRouteTree.routesByPath,
+    routesById: opts.processedServerRouteTree.routesById,
+    flatRoutes: opts.processedServerRouteTree.flatRoutes
   });
+  const routeTreeResult = opts.router.getMatchedRoutes(pathname, void 0);
   let response;
-  if (foundRoute && foundRoute.id !== rootRouteId) {
-    const method = Object.keys(foundRoute.options.methods).find(
-      (method2) => method2.toLowerCase() === request.method.toLowerCase()
-    );
-    if (method) {
-      const handler = foundRoute.options.methods[method];
-      if (handler) {
-        const middlewares = flattenMiddlewares(
-          matchedRoutes.flatMap((r) => r.options.middleware).filter(Boolean)
-        ).map((d) => d.options.server);
-        middlewares.push(handlerToMiddleware(handler));
-        const ctx = await executeMiddleware(middlewares, {
-          request,
-          context: {},
-          params: routeParams,
-          pathname: history.location.pathname
-        });
-        response = ctx.response;
+  let matchedRoutes = [];
+  matchedRoutes = serverTreeResult.matchedRoutes;
+  if (routeTreeResult.foundRoute) {
+    if (serverTreeResult.matchedRoutes.length < routeTreeResult.matchedRoutes.length) {
+      const closestCommon = [...routeTreeResult.matchedRoutes].reverse().find((r) => {
+        return opts.processedServerRouteTree.routesById[r.id] !== void 0;
+      });
+      if (closestCommon) {
+        let routeId = closestCommon.id;
+        matchedRoutes = [];
+        do {
+          const route = opts.processedServerRouteTree.routesById[routeId];
+          if (!route) {
+            break;
+          }
+          matchedRoutes.push(route);
+          routeId = route.parentRoute?.id;
+        } while (routeId);
+        matchedRoutes.reverse();
       }
     }
   }
+  if (matchedRoutes.length) {
+    const middlewares = flattenMiddlewares(
+      matchedRoutes.flatMap((r) => r.options.middleware).filter(Boolean)
+    ).map((d) => d.options.server);
+    if (serverTreeResult.foundRoute?.options.methods) {
+      const method = Object.keys(
+        serverTreeResult.foundRoute.options.methods
+      ).find(
+        (method2) => method2.toLowerCase() === opts.request.method.toLowerCase()
+      );
+      if (method) {
+        const handler = serverTreeResult.foundRoute.options.methods[method];
+        if (handler) {
+          if (typeof handler === "function") {
+            middlewares.push(handlerToMiddleware(handler));
+          } else {
+            if (handler._options.middlewares && handler._options.middlewares.length) {
+              middlewares.push(
+                ...flattenMiddlewares(handler._options.middlewares).map(
+                  (d) => d.options.server
+                )
+              );
+            }
+            if (handler._options.handler) {
+              middlewares.push(handlerToMiddleware(handler._options.handler));
+            }
+          }
+        }
+      }
+    }
+    middlewares.push(handlerToMiddleware(opts.executeRouter));
+    const ctx = await executeMiddleware(middlewares, {
+      request: opts.request,
+      context: {},
+      params: serverTreeResult.routeParams,
+      pathname
+    });
+    response = ctx.response;
+  }
   return [matchedRoutes, response];
 }
 function handlerToMiddleware(handler) {
-  return async ({ next: _next, ...rest }) => ({
-    response: await handler(rest)
-  });
+  return async ({ next: _next, ...rest }) => {
+    const response = await handler(rest);
+    if (response) {
+      return { response };
+    }
+    return _next(rest);
+  };
 }
 function executeMiddleware(middlewares, ctx) {
   let index = -1;
@@ -237,7 +298,14 @@ function executeMiddleware(middlewares, ctx) {
       ...ctx2,
       // Allow the middleware to call the next middleware in the chain
       next: async (nextCtx) => {
-        const nextResult = await next({ ...ctx2, ...nextCtx });
+        const nextResult = await next({
+          ...ctx2,
+          ...nextCtx,
+          context: {
+            ...ctx2.context,
+            ...nextCtx?.context || {}
+          }
+        });
         return Object.assign(ctx2, handleCtxResult(nextResult));
       }
       // Allow the middleware result to extend the return context
@@ -268,7 +336,6 @@ function isResponse(response) {
   return response instanceof Response;
 }
 export {
-  createStartHandler,
-  getStartResponseHeaders
+  createStartHandler
 };
 //# sourceMappingURL=createStartHandler.js.map

package/dist/esm/createStartHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"createStartHandler.js","sources":["../../src/createStartHandler.ts"],"sourcesContent":["import { createMemoryHistory } from '@tanstack/history'\nimport {\n  flattenMiddlewares,\n  json,\n  mergeHeaders,\n} from '@tanstack/start-client-core'\nimport {\n  getMatchedRoutes,\n  isRedirect,\n  isResolvedRedirect,\n  joinPaths,\n  processRouteTree,\n  rootRouteId,\n  trimPath,\n} from '@tanstack/router-core'\nimport { getResponseHeaders, requestHandler } from './h3'\nimport { attachRouterServerSsrUtils, dehydrateRouter } from './ssr-server'\nimport { getStartManifest } from './router-manifest'\nimport { handleServerAction } from './server-functions-handler'\nimport { VIRTUAL_MODULES } from './virtual-modules'\nimport { loadVirtualModule } from './loadVirtualModule'\nimport type { AnyServerRoute, AnyServerRouteWithTypes } from './serverRoute'\nimport type { RequestHandler } from './h3'\nimport type { AnyRouter } from '@tanstack/router-core'\nimport type { HandlerCallback } from './handlerCallback'\n\ntype TODO = any\n\nexport type CustomizeStartHandler<TRouter extends AnyRouter> = (\n  cb: HandlerCallback<TRouter>,\n) => RequestHandler\n\nexport function getStartResponseHeaders(opts: { router: AnyRouter }) {\n  let headers = mergeHeaders(\n    getResponseHeaders(),\n    {\n      'Content-Type': 'text/html; charset=UTF-8',\n    },\n    ...opts.router.state.matches.map((match) => {\n      return match.headers\n    }),\n  )\n  // Handle Redirects\n  const { redirect } = opts.router.state\n\n  if (redirect) {\n    headers = mergeHeaders(headers, redirect.headers)\n  }\n  return headers\n}\n\nexport function createStartHandler<TRouter extends AnyRouter>({\n  createRouter,\n}: {\n  createRouter: () => TRouter\n}): CustomizeStartHandler<TRouter> {\n  let serverRouteTree: AnyServerRoute | undefined | null = null\n\n  return (cb) => {\n    const originalFetch = globalThis.fetch\n\n    const startRequestResolver: RequestHandler = async ({ request }) => {\n      // Patching fetch function to use our request resolver\n      // if the input starts with `/` which is a common pattern for\n      // client-side routing.\n      // When we encounter similar requests, we can assume that the\n      // user wants to use the same origin as the current request.\n      globalThis.fetch = async function (input, init) {\n        function resolve(url: URL, requestOptions: RequestInit | undefined) {\n          const fetchRequest = new Request(url, requestOptions)\n          return startRequestResolver({ request: fetchRequest })\n        }\n\n        function getOrigin() {\n          return (\n            request.headers.get('Origin') ||\n            request.headers.get('Referer') ||\n            'http://localhost'\n          )\n        }\n\n        if (typeof input === 'string' && input.startsWith('/')) {\n          // e.g: fetch('/api/data')\n          const url = new URL(input, getOrigin())\n          return resolve(url, init)\n        } else if (\n          typeof input === 'object' &&\n          'url' in input &&\n          typeof input.url === 'string' &&\n          input.url.startsWith('/')\n        ) {\n          // e.g: fetch(new Request('/api/data'))\n          const url = new URL(input.url, getOrigin())\n          return resolve(url, init)\n        }\n\n        // If not, it should just use the original fetch\n        return originalFetch(input, init)\n      }\n\n      const url = new URL(request.url)\n      const href = url.href.replace(url.origin, '')\n\n      // Create a history for the client-side router\n      const history = createMemoryHistory({\n        initialEntries: [href],\n      })\n\n      const APP_BASE = process.env.TSS_APP_BASE || '/'\n\n      // TODO do not create a router instance before we need it\n      // Create the client-side router\n      const router = createRouter()\n\n      // TODO only build startRoutesManifest once, not per request\n      // Attach the server-side SSR utils to the client-side router\n      const startRoutesManifest = await getStartManifest({ basePath: APP_BASE })\n      attachRouterServerSsrUtils(router, startRoutesManifest)\n\n      // Update the client-side router with the history and context\n      router.update({\n        history,\n      })\n\n      const response = await (async () => {\n        try {\n          if (!process.env.TSS_SERVER_FN_BASE) {\n            throw new Error(\n              'tanstack/start-server-core: TSS_SERVER_FN_BASE must be defined in your environment for createStartHandler()',\n            )\n          }\n\n          // First, let's attempt to handle server functions\n          // Add trailing slash to sanitise user defined TSS_SERVER_FN_BASE\n          const serverFnBase = joinPaths([\n            APP_BASE,\n            trimPath(process.env.TSS_SERVER_FN_BASE),\n            '/',\n          ])\n          if (href.startsWith(serverFnBase)) {\n            return await handleServerAction({ request })\n          }\n\n          if (serverRouteTree === null) {\n            try {\n              serverRouteTree = (\n                await loadVirtualModule(VIRTUAL_MODULES.routeTree)\n              ).serverRouteTree\n            } catch (e) {\n              console.log(e)\n            }\n          }\n\n          // If we have a server route tree, then we try matching to see if we have a\n          // server route that matches the request.\n          if (serverRouteTree) {\n            const [_matchedRoutes, response] = await handleServerRoutes({\n              routeTree: serverRouteTree,\n              request,\n              basePath: APP_BASE,\n            })\n\n            if (response) return response\n          }\n\n          const requestAcceptHeader = request.headers.get('Accept') || '*/*'\n          const splitRequestAcceptHeader = requestAcceptHeader.split(',')\n\n          const supportedMimeTypes = ['*/*', 'text/html']\n          const isRouterAcceptSupported = supportedMimeTypes.some((mimeType) =>\n            splitRequestAcceptHeader.some((acceptedMimeType) =>\n              acceptedMimeType.trim().startsWith(mimeType),\n            ),\n          )\n\n          if (!isRouterAcceptSupported) {\n            return json(\n              {\n                error: 'Only HTML requests are supported here',\n              },\n              {\n                status: 500,\n              },\n            )\n          }\n\n          // If no Server Routes were found, so fallback to normal SSR matching using\n          // the router\n\n          await router.load()\n\n          // If there was a redirect, skip rendering the page at all\n          if (router.state.redirect) return router.state.redirect\n\n          dehydrateRouter(router)\n\n          const responseHeaders = getStartResponseHeaders({ router })\n          const response = await cb({\n            request,\n            router,\n            responseHeaders,\n          })\n\n          return response\n        } catch (err) {\n          if (err instanceof Response) {\n            return err\n          }\n\n          throw err\n        }\n      })()\n\n      if (isRedirect(response)) {\n        if (isResolvedRedirect(response)) {\n          if (request.headers.get('x-tsr-redirect') === 'manual') {\n            return json(\n              {\n                ...response.options,\n                isSerializedRedirect: true,\n              },\n              {\n                headers: response.headers,\n              },\n            )\n          }\n          return response\n        }\n        if (\n          response.options.to &&\n          typeof response.options.to === 'string' &&\n          !response.options.to.startsWith('/')\n        ) {\n          throw new Error(\n            `Server side redirects must use absolute paths via the 'href' or 'to' options. Received: ${JSON.stringify(response.options)}`,\n          )\n        }\n\n        if (\n          ['params', 'search', 'hash'].some(\n            (d) => typeof (response.options as any)[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              response.options,\n            )\n              .filter((d) => typeof (response.options as any)[d] === 'function')\n              .map((d) => `\"${d}\"`)\n              .join(', ')}`,\n          )\n        }\n\n        const redirect = router.resolveRedirect(response)\n\n        if (request.headers.get('x-tsr-redirect') === 'manual') {\n          return json(\n            {\n              ...response.options,\n              isSerializedRedirect: true,\n            },\n            {\n              headers: response.headers,\n            },\n          )\n        }\n\n        return redirect\n      }\n\n      return response\n    }\n\n    return requestHandler(startRequestResolver)\n  }\n}\n\nasync function handleServerRoutes({\n  routeTree,\n  request,\n  basePath,\n}: {\n  routeTree: AnyServerRouteWithTypes\n  request: Request\n  basePath: string\n}) {\n  // TODO only process server route tree once, not per request\n  const { flatRoutes, routesById, routesByPath } = processRouteTree({\n    routeTree,\n    initRoute: (route, i) => {\n      route.init({\n        originalIndex: i,\n      })\n    },\n  })\n\n  const url = new URL(request.url)\n  const pathname = url.pathname\n\n  // TODO history seems not to be needed, we can just use the pathname\n  const history = createMemoryHistory({\n    initialEntries: [pathname],\n  })\n\n  const { matchedRoutes, foundRoute, routeParams } =\n    getMatchedRoutes<AnyServerRouteWithTypes>({\n      pathname: history.location.pathname,\n      basepath: basePath,\n      caseSensitive: true,\n      routesByPath,\n      routesById,\n      flatRoutes,\n    })\n\n  let response: Response | undefined\n\n  if (foundRoute && foundRoute.id !== rootRouteId) {\n    // We've found a server route that matches the request, so we can call it.\n    // TODO: Get the input type-signature correct\n    // TODO: Perform the middlewares?\n    // TODO: Error handling? What happens when its `throw redirect()` vs `throw new Error()`?\n\n    const method = Object.keys(foundRoute.options.methods).find(\n      (method) => method.toLowerCase() === request.method.toLowerCase(),\n    )\n\n    if (method) {\n      const handler = foundRoute.options.methods[method]\n\n      if (handler) {\n        const middlewares = flattenMiddlewares(\n          matchedRoutes.flatMap((r) => r.options.middleware).filter(Boolean),\n        ).map((d) => d.options.server)\n\n        middlewares.push(handlerToMiddleware(handler) as TODO)\n\n        // TODO: This is starting to feel too much like a server function\n        // Do generalize the existing middleware execution? Or do we need to\n        // build a new middleware execution system for server routes?\n        const ctx = await executeMiddleware(middlewares, {\n          request,\n          context: {},\n          params: routeParams,\n          pathname: history.location.pathname,\n        })\n\n        response = ctx.response\n      }\n    }\n  }\n\n  // We return the matched routes too so if\n  // the app router happens to match the same path,\n  // it can use any request middleware from server routes\n  return [matchedRoutes, response] as const\n}\n\nfunction handlerToMiddleware(\n  handler: AnyServerRouteWithTypes['options']['methods'][string],\n) {\n  return async ({ next: _next, ...rest }: TODO) => ({\n    response: await handler(rest),\n  })\n}\n\nfunction executeMiddleware(middlewares: TODO, ctx: TODO) {\n  let index = -1\n\n  const next = async (ctx: TODO) => {\n    index++\n    const middleware = middlewares[index]\n    if (!middleware) return ctx\n\n    const result = await middleware({\n      ...ctx,\n      // Allow the middleware to call the next middleware in the chain\n      next: async (nextCtx: TODO) => {\n        // Allow the caller to extend the context for the next middleware\n        const nextResult = await next({ ...ctx, ...nextCtx })\n\n        // Merge the result into the context\\\n        return Object.assign(ctx, handleCtxResult(nextResult))\n      },\n      // Allow the middleware result to extend the return context\n    }).catch((err: TODO) => {\n      if (isSpecialResponse(err)) {\n        return {\n          response: err,\n        }\n      }\n\n      throw err\n    })\n\n    // Merge the middleware result into the context, just in case it\n    // returns a partial context\n    return Object.assign(ctx, handleCtxResult(result))\n  }\n\n  return handleCtxResult(next(ctx))\n}\n\nfunction handleCtxResult(result: TODO) {\n  if (isSpecialResponse(result)) {\n    return {\n      response: result,\n    }\n  }\n\n  return result\n}\n\nfunction isSpecialResponse(err: TODO) {\n  return isResponse(err) || isRedirect(err)\n}\n\nfunction isResponse(response: Response): response is Response {\n  return response instanceof Response\n}\n"],"names":["url","response","method","ctx"],"mappings":"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"}
+{"version":3,"file":"createStartHandler.js","sources":["../../src/createStartHandler.ts"],"sourcesContent":["import { createMemoryHistory } from '@tanstack/history'\nimport {\n  flattenMiddlewares,\n  json,\n  mergeHeaders,\n} from '@tanstack/start-client-core'\nimport {\n  getMatchedRoutes,\n  isRedirect,\n  isResolvedRedirect,\n  joinPaths,\n  processRouteTree,\n  trimPath,\n} from '@tanstack/router-core'\nimport { attachRouterServerSsrUtils } from '@tanstack/router-core/ssr/server'\nimport { runWithStartContext } from '@tanstack/start-storage-context'\nimport { getResponseHeaders, requestHandler } from './request-response'\nimport { getStartManifest } from './router-manifest'\nimport { handleServerAction } from './server-functions-handler'\nimport { VIRTUAL_MODULES } from './virtual-modules'\nimport { loadVirtualModule } from './loadVirtualModule'\n\nimport { HEADERS } from './constants'\nimport type {\n  AnyServerRouteWithTypes,\n  ServerRouteMethodHandlerFn,\n} from './serverRoute'\nimport type { RequestHandler } from './request-response'\nimport type {\n  AnyRoute,\n  AnyRouter,\n  Awaitable,\n  Manifest,\n  ProcessRouteTreeResult,\n} from '@tanstack/router-core'\nimport type { HandlerCallback } from '@tanstack/router-core/ssr/server'\n\ntype TODO = any\n\nexport type CustomizeStartHandler<TRouter extends AnyRouter> = (\n  cb: HandlerCallback<TRouter>,\n) => RequestHandler\n\nfunction getStartResponseHeaders(opts: { router: AnyRouter }) {\n  const headers = mergeHeaders(\n    getResponseHeaders() as Headers,\n    {\n      'Content-Type': 'text/html; charset=utf-8',\n    },\n    ...opts.router.state.matches.map((match) => {\n      return match.headers\n    }),\n  )\n  return headers\n}\n\nexport function createStartHandler<TRouter extends AnyRouter>({\n  createRouter,\n}: {\n  createRouter: () => Awaitable<TRouter>\n}): CustomizeStartHandler<TRouter> {\n  let routeTreeModule: {\n    serverRouteTree: AnyServerRouteWithTypes | undefined\n    routeTree: AnyRoute | undefined\n  } | null = null\n  let startRoutesManifest: Manifest | null = null\n  let processedServerRouteTree:\n    | ProcessRouteTreeResult<AnyServerRouteWithTypes>\n    | undefined = undefined\n\n  return (cb) => {\n    const originalFetch = globalThis.fetch\n\n    const startRequestResolver: RequestHandler = async (request) => {\n      // Patching fetch function to use our request resolver\n      // if the input starts with `/` which is a common pattern for\n      // client-side routing.\n      // When we encounter similar requests, we can assume that the\n      // user wants to use the same origin as the current request.\n      globalThis.fetch = async function (input, init) {\n        function resolve(url: URL, requestOptions: RequestInit | undefined) {\n          const fetchRequest = new Request(url, requestOptions)\n          return startRequestResolver(fetchRequest)\n        }\n\n        function getOrigin() {\n          return (\n            request.headers.get('Origin') ||\n            request.headers.get('Referer') ||\n            'http://localhost'\n          )\n        }\n\n        if (typeof input === 'string' && input.startsWith('/')) {\n          // e.g: fetch('/api/data')\n          const url = new URL(input, getOrigin())\n          return resolve(url, init)\n        } else if (\n          typeof input === 'object' &&\n          'url' in input &&\n          typeof input.url === 'string' &&\n          input.url.startsWith('/')\n        ) {\n          // e.g: fetch(new Request('/api/data'))\n          const url = new URL(input.url, getOrigin())\n          return resolve(url, init)\n        }\n\n        // If not, it should just use the original fetch\n        return originalFetch(input, init)\n      }\n\n      const url = new URL(request.url)\n      const href = decodeURIComponent(url.href.replace(url.origin, ''))\n\n      const APP_BASE = process.env.TSS_APP_BASE || '/'\n\n      // TODO how does this work with base path? does the router need to be configured the same as APP_BASE?\n      const router = await createRouter()\n\n      // Create a history for the client-side router\n      const history = createMemoryHistory({\n        initialEntries: [href],\n      })\n\n      // Update the client-side router with the history\n      const isPrerendering = process.env.TSS_PRERENDERING === 'true'\n      // env var is set during dev is SPA mode is enabled\n      let isShell = process.env.TSS_SHELL === 'true'\n      if (isPrerendering && !isShell) {\n        // only read the shell header if we are prerendering\n        // to avoid runtime behavior changes by injecting this header\n        // the header is set by the prerender plugin\n        isShell = request.headers.get(HEADERS.TSS_SHELL) === 'true'\n      }\n      router.update({\n        history,\n        isShell,\n        isPrerendering,\n      })\n\n      const response = await (async () => {\n        try {\n          if (!process.env.TSS_SERVER_FN_BASE) {\n            throw new Error(\n              'tanstack/start-server-core: TSS_SERVER_FN_BASE must be defined in your environment for createStartHandler()',\n            )\n          }\n\n          // First, let's attempt to handle server functions\n          // Add trailing slash to sanitise user defined TSS_SERVER_FN_BASE\n          const serverFnBase = joinPaths([\n            APP_BASE,\n            trimPath(process.env.TSS_SERVER_FN_BASE),\n            '/',\n          ])\n          if (href.startsWith(serverFnBase)) {\n            return await handleServerAction({ request })\n          }\n\n          if (routeTreeModule === null) {\n            try {\n              routeTreeModule = await loadVirtualModule(\n                VIRTUAL_MODULES.routeTree,\n              )\n              if (routeTreeModule.serverRouteTree) {\n                processedServerRouteTree =\n                  processRouteTree<AnyServerRouteWithTypes>({\n                    routeTree: routeTreeModule.serverRouteTree,\n                    initRoute: (route, i) => {\n                      route.init({\n                        originalIndex: i,\n                      })\n                    },\n                  })\n              }\n            } catch (e) {\n              console.log(e)\n            }\n          }\n\n          const executeRouter = () =>\n            runWithStartContext({ router }, async () => {\n              const requestAcceptHeader = request.headers.get('Accept') || '*/*'\n              const splitRequestAcceptHeader = requestAcceptHeader.split(',')\n\n              const supportedMimeTypes = ['*/*', 'text/html']\n              const isRouterAcceptSupported = supportedMimeTypes.some(\n                (mimeType) =>\n                  splitRequestAcceptHeader.some((acceptedMimeType) =>\n                    acceptedMimeType.trim().startsWith(mimeType),\n                  ),\n              )\n\n              if (!isRouterAcceptSupported) {\n                return json(\n                  {\n                    error: 'Only HTML requests are supported here',\n                  },\n                  {\n                    status: 500,\n                  },\n                )\n              }\n\n              // if the startRoutesManifest is not loaded yet, load it once\n              if (startRoutesManifest === null) {\n                startRoutesManifest = await getStartManifest({\n                  basePath: APP_BASE,\n                })\n              }\n\n              // Attach the server-side SSR utils to the client-side router\n              attachRouterServerSsrUtils(router, startRoutesManifest)\n\n              await router.load()\n\n              // If there was a redirect, skip rendering the page at all\n              if (router.state.redirect) {\n                return router.state.redirect\n              }\n\n              await router.serverSsr!.dehydrate()\n\n              const responseHeaders = getStartResponseHeaders({ router })\n              const response = await cb({\n                request,\n                router,\n                responseHeaders,\n              })\n\n              return response\n            })\n\n          // If we have a server route tree, then we try matching to see if we have a\n          // server route that matches the request.\n          if (processedServerRouteTree) {\n            const [_matchedRoutes, response] = await handleServerRoutes({\n              processedServerRouteTree,\n              router,\n              request,\n              basePath: APP_BASE,\n              executeRouter,\n            })\n\n            if (response) return response\n          }\n\n          // Server Routes did not produce a response, so fallback to normal SSR matching using the router\n          const routerResponse = await executeRouter()\n          return routerResponse\n        } catch (err) {\n          if (err instanceof Response) {\n            return err\n          }\n\n          throw err\n        }\n      })()\n\n      if (isRedirect(response)) {\n        if (isResolvedRedirect(response)) {\n          if (request.headers.get('x-tsr-redirect') === 'manual') {\n            return json(\n              {\n                ...response.options,\n                isSerializedRedirect: true,\n              },\n              {\n                headers: response.headers,\n              },\n            )\n          }\n          return response\n        }\n        if (\n          response.options.to &&\n          typeof response.options.to === 'string' &&\n          !response.options.to.startsWith('/')\n        ) {\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(response.options)}`,\n          )\n        }\n\n        if (\n          ['params', 'search', 'hash'].some(\n            (d) => typeof (response.options as any)[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              response.options,\n            )\n              .filter((d) => typeof (response.options as any)[d] === 'function')\n              .map((d) => `\"${d}\"`)\n              .join(', ')}`,\n          )\n        }\n\n        const redirect = router.resolveRedirect(response)\n\n        if (request.headers.get('x-tsr-redirect') === 'manual') {\n          return json(\n            {\n              ...response.options,\n              isSerializedRedirect: true,\n            },\n            {\n              headers: response.headers,\n            },\n          )\n        }\n\n        return redirect\n      }\n\n      return response\n    }\n\n    return requestHandler(startRequestResolver)\n  }\n}\n\nasync function handleServerRoutes(opts: {\n  router: AnyRouter\n  processedServerRouteTree: ProcessRouteTreeResult<AnyServerRouteWithTypes>\n  request: Request\n  basePath: string\n  executeRouter: () => Promise<Response>\n}) {\n  const url = new URL(opts.request.url)\n  const pathname = url.pathname\n\n  const serverTreeResult = getMatchedRoutes<AnyServerRouteWithTypes>({\n    pathname,\n    basepath: opts.basePath,\n    caseSensitive: true,\n    routesByPath: opts.processedServerRouteTree.routesByPath,\n    routesById: opts.processedServerRouteTree.routesById,\n    flatRoutes: opts.processedServerRouteTree.flatRoutes,\n  })\n\n  const routeTreeResult = opts.router.getMatchedRoutes(pathname, undefined)\n\n  let response: Response | undefined\n  let matchedRoutes: Array<AnyServerRouteWithTypes> = []\n  matchedRoutes = serverTreeResult.matchedRoutes\n  // check if the app route tree found a match that is deeper than the server route tree\n  if (routeTreeResult.foundRoute) {\n    if (\n      serverTreeResult.matchedRoutes.length <\n      routeTreeResult.matchedRoutes.length\n    ) {\n      const closestCommon = [...routeTreeResult.matchedRoutes]\n        .reverse()\n        .find((r) => {\n          return opts.processedServerRouteTree.routesById[r.id] !== undefined\n        })\n      if (closestCommon) {\n        // walk up the tree and collect all parents\n        let routeId = closestCommon.id\n        matchedRoutes = []\n        do {\n          const route = opts.processedServerRouteTree.routesById[routeId]\n          if (!route) {\n            break\n          }\n          matchedRoutes.push(route)\n          routeId = route.parentRoute?.id\n        } while (routeId)\n\n        matchedRoutes.reverse()\n      }\n    }\n  }\n\n  if (matchedRoutes.length) {\n    // We've found a server route that (partially) matches the request, so we can call it.\n    // TODO: Error handling? What happens when its `throw redirect()` vs `throw new Error()`?\n\n    const middlewares = flattenMiddlewares(\n      matchedRoutes.flatMap((r) => r.options.middleware).filter(Boolean),\n    ).map((d) => d.options.server)\n\n    if (serverTreeResult.foundRoute?.options.methods) {\n      const method = Object.keys(\n        serverTreeResult.foundRoute.options.methods,\n      ).find(\n        (method) => method.toLowerCase() === opts.request.method.toLowerCase(),\n      )\n\n      if (method) {\n        const handler = serverTreeResult.foundRoute.options.methods[method]\n        if (handler) {\n          if (typeof handler === 'function') {\n            middlewares.push(handlerToMiddleware(handler) as TODO)\n          } else {\n            if (\n              handler._options.middlewares &&\n              handler._options.middlewares.length\n            ) {\n              middlewares.push(\n                ...flattenMiddlewares(handler._options.middlewares as any).map(\n                  (d) => d.options.server,\n                ),\n              )\n            }\n            if (handler._options.handler) {\n              middlewares.push(handlerToMiddleware(handler._options.handler))\n            }\n          }\n        }\n      }\n    }\n\n    // eventually, execute the router\n    middlewares.push(handlerToMiddleware(opts.executeRouter))\n\n    // TODO: This is starting to feel too much like a server function\n    // Do generalize the existing middleware execution? Or do we need to\n    // build a new middleware execution system for server routes?\n    const ctx = await executeMiddleware(middlewares, {\n      request: opts.request,\n      context: {},\n      params: serverTreeResult.routeParams,\n      pathname,\n    })\n\n    response = ctx.response\n  }\n\n  // We return the matched routes too so if\n  // the app router happens to match the same path,\n  // it can use any request middleware from server routes\n  return [matchedRoutes, response] as const\n}\n\nfunction handlerToMiddleware(\n  handler: ServerRouteMethodHandlerFn<\n    AnyServerRouteWithTypes,\n    any,\n    any,\n    any,\n    any\n  >,\n) {\n  return async ({ next: _next, ...rest }: TODO) => {\n    const response = await handler(rest)\n    if (response) {\n      return { response }\n    }\n    return _next(rest)\n  }\n}\n\nfunction executeMiddleware(middlewares: TODO, ctx: TODO) {\n  let index = -1\n\n  const next = async (ctx: TODO) => {\n    index++\n    const middleware = middlewares[index]\n    if (!middleware) return ctx\n\n    const result = await middleware({\n      ...ctx,\n      // Allow the middleware to call the next middleware in the chain\n      next: async (nextCtx: TODO) => {\n        // Allow the caller to extend the context for the next middleware\n        const nextResult = await next({\n          ...ctx,\n          ...nextCtx,\n          context: {\n            ...ctx.context,\n            ...(nextCtx?.context || {}),\n          },\n        })\n\n        // Merge the result into the context\\\n        return Object.assign(ctx, handleCtxResult(nextResult))\n      },\n      // Allow the middleware result to extend the return context\n    }).catch((err: TODO) => {\n      if (isSpecialResponse(err)) {\n        return {\n          response: err,\n        }\n      }\n\n      throw err\n    })\n\n    // Merge the middleware result into the context, just in case it\n    // returns a partial context\n    return Object.assign(ctx, handleCtxResult(result))\n  }\n\n  return handleCtxResult(next(ctx))\n}\n\nfunction handleCtxResult(result: TODO) {\n  if (isSpecialResponse(result)) {\n    return {\n      response: result,\n    }\n  }\n\n  return result\n}\n\nfunction isSpecialResponse(err: TODO) {\n  return isResponse(err) || isRedirect(err)\n}\n\nfunction isResponse(response: Response): response is Response {\n  return response instanceof Response\n}\n"],"names":["url","response","method","ctx"],"mappings":";;;;;;;;;;;AA2CA,SAAS,wBAAwB,MAA6B;AAC5D,QAAM,UAAU;AAAA,IACd,mBAAA;AAAA,IACA;AAAA,MACE,gBAAgB;AAAA,IAAA;AAAA,IAElB,GAAG,KAAK,OAAO,MAAM,QAAQ,IAAI,CAAC,UAAU;AAC1C,aAAO,MAAM;AAAA,IACf,CAAC;AAAA,EAAA;AAEH,SAAO;AACT;AAEO,SAAS,mBAA8C;AAAA,EAC5D;AACF,GAEmC;AACjC,MAAI,kBAGO;AACX,MAAI,sBAAuC;AAC3C,MAAI,2BAEY;AAEhB,SAAO,CAAC,OAAO;AACb,UAAM,gBAAgB,WAAW;AAEjC,UAAM,uBAAuC,OAAO,YAAY;AAM9D,iBAAW,QAAQ,eAAgB,OAAO,MAAM;AAC9C,iBAAS,QAAQA,MAAU,gBAAyC;AAClE,gBAAM,eAAe,IAAI,QAAQA,MAAK,cAAc;AACpD,iBAAO,qBAAqB,YAAY;AAAA,QAC1C;AAEA,iBAAS,YAAY;AACnB,iBACE,QAAQ,QAAQ,IAAI,QAAQ,KAC5B,QAAQ,QAAQ,IAAI,SAAS,KAC7B;AAAA,QAEJ;AAEA,YAAI,OAAO,UAAU,YAAY,MAAM,WAAW,GAAG,GAAG;AAEtD,gBAAMA,OAAM,IAAI,IAAI,OAAO,WAAW;AACtC,iBAAO,QAAQA,MAAK,IAAI;AAAA,QAC1B,WACE,OAAO,UAAU,YACjB,SAAS,SACT,OAAO,MAAM,QAAQ,YACrB,MAAM,IAAI,WAAW,GAAG,GACxB;AAEA,gBAAMA,OAAM,IAAI,IAAI,MAAM,KAAK,WAAW;AAC1C,iBAAO,QAAQA,MAAK,IAAI;AAAA,QAC1B;AAGA,eAAO,cAAc,OAAO,IAAI;AAAA,MAClC;AAEA,YAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;AAC/B,YAAM,OAAO,mBAAmB,IAAI,KAAK,QAAQ,IAAI,QAAQ,EAAE,CAAC;AAEhE,YAAM,WAAW,QAAQ,IAAI,gBAAgB;AAG7C,YAAM,SAAS,MAAM,aAAA;AAGrB,YAAM,UAAU,oBAAoB;AAAA,QAClC,gBAAgB,CAAC,IAAI;AAAA,MAAA,CACtB;AAGD,YAAM,iBAAiB,QAAQ,IAAI,qBAAqB;AAExD,UAAI,UAAU,QAAQ,IAAI,cAAc;AACxC,UAAI,kBAAkB,CAAC,SAAS;AAI9B,kBAAU,QAAQ,QAAQ,IAAI,QAAQ,SAAS,MAAM;AAAA,MACvD;AACA,aAAO,OAAO;AAAA,QACZ;AAAA,QACA;AAAA,QACA;AAAA,MAAA,CACD;AAED,YAAM,WAAW,OAAO,YAAY;AAClC,YAAI;AACF,cAAI,CAAC,QAAQ,IAAI,oBAAoB;AACnC,kBAAM,IAAI;AAAA,cACR;AAAA,YAAA;AAAA,UAEJ;AAIA,gBAAM,eAAe,UAAU;AAAA,YAC7B;AAAA,YACA,SAAS,QAAQ,IAAI,kBAAkB;AAAA,YACvC;AAAA,UAAA,CACD;AACD,cAAI,KAAK,WAAW,YAAY,GAAG;AACjC,mBAAO,MAAM,mBAAmB,EAAE,SAAS;AAAA,UAC7C;AAEA,cAAI,oBAAoB,MAAM;AAC5B,gBAAI;AACF,gCAAkB,MAAM;AAAA,gBACtB,gBAAgB;AAAA,cAAA;AAElB,kBAAI,gBAAgB,iBAAiB;AACnC,2CACE,iBAA0C;AAAA,kBACxC,WAAW,gBAAgB;AAAA,kBAC3B,WAAW,CAAC,OAAO,MAAM;AACvB,0BAAM,KAAK;AAAA,sBACT,eAAe;AAAA,oBAAA,CAChB;AAAA,kBACH;AAAA,gBAAA,CACD;AAAA,cACL;AAAA,YACF,SAAS,GAAG;AACV,sBAAQ,IAAI,CAAC;AAAA,YACf;AAAA,UACF;AAEA,gBAAM,gBAAgB,MACpB,oBAAoB,EAAE,OAAA,GAAU,YAAY;AAC1C,kBAAM,sBAAsB,QAAQ,QAAQ,IAAI,QAAQ,KAAK;AAC7D,kBAAM,2BAA2B,oBAAoB,MAAM,GAAG;AAE9D,kBAAM,qBAAqB,CAAC,OAAO,WAAW;AAC9C,kBAAM,0BAA0B,mBAAmB;AAAA,cACjD,CAAC,aACC,yBAAyB;AAAA,gBAAK,CAAC,qBAC7B,iBAAiB,KAAA,EAAO,WAAW,QAAQ;AAAA,cAAA;AAAA,YAC7C;AAGJ,gBAAI,CAAC,yBAAyB;AAC5B,qBAAO;AAAA,gBACL;AAAA,kBACE,OAAO;AAAA,gBAAA;AAAA,gBAET;AAAA,kBACE,QAAQ;AAAA,gBAAA;AAAA,cACV;AAAA,YAEJ;AAGA,gBAAI,wBAAwB,MAAM;AAChC,oCAAsB,MAAM,iBAAiB;AAAA,gBAC3C,UAAU;AAAA,cAAA,CACX;AAAA,YACH;AAGA,uCAA2B,QAAQ,mBAAmB;AAEtD,kBAAM,OAAO,KAAA;AAGb,gBAAI,OAAO,MAAM,UAAU;AACzB,qBAAO,OAAO,MAAM;AAAA,YACtB;AAEA,kBAAM,OAAO,UAAW,UAAA;AAExB,kBAAM,kBAAkB,wBAAwB,EAAE,QAAQ;AAC1D,kBAAMC,YAAW,MAAM,GAAG;AAAA,cACxB;AAAA,cACA;AAAA,cACA;AAAA,YAAA,CACD;AAED,mBAAOA;AAAAA,UACT,CAAC;AAIH,cAAI,0BAA0B;AAC5B,kBAAM,CAAC,gBAAgBA,SAAQ,IAAI,MAAM,mBAAmB;AAAA,cAC1D;AAAA,cACA;AAAA,cACA;AAAA,cACA,UAAU;AAAA,cACV;AAAA,YAAA,CACD;AAED,gBAAIA,UAAU,QAAOA;AAAAA,UACvB;AAGA,gBAAM,iBAAiB,MAAM,cAAA;AAC7B,iBAAO;AAAA,QACT,SAAS,KAAK;AACZ,cAAI,eAAe,UAAU;AAC3B,mBAAO;AAAA,UACT;AAEA,gBAAM;AAAA,QACR;AAAA,MACF,GAAA;AAEA,UAAI,WAAW,QAAQ,GAAG;AACxB,YAAI,mBAAmB,QAAQ,GAAG;AAChC,cAAI,QAAQ,QAAQ,IAAI,gBAAgB,MAAM,UAAU;AACtD,mBAAO;AAAA,cACL;AAAA,gBACE,GAAG,SAAS;AAAA,gBACZ,sBAAsB;AAAA,cAAA;AAAA,cAExB;AAAA,gBACE,SAAS,SAAS;AAAA,cAAA;AAAA,YACpB;AAAA,UAEJ;AACA,iBAAO;AAAA,QACT;AACA,YACE,SAAS,QAAQ,MACjB,OAAO,SAAS,QAAQ,OAAO,YAC/B,CAAC,SAAS,QAAQ,GAAG,WAAW,GAAG,GACnC;AACA,gBAAM,IAAI;AAAA,YACR,oNAAoN,KAAK,UAAU,SAAS,OAAO,CAAC;AAAA,UAAA;AAAA,QAExP;AAEA,YACE,CAAC,UAAU,UAAU,MAAM,EAAE;AAAA,UAC3B,CAAC,MAAM,OAAQ,SAAS,QAAgB,CAAC,MAAM;AAAA,QAAA,GAEjD;AACA,gBAAM,IAAI;AAAA,YACR,+IAA+I,OAAO;AAAA,cACpJ,SAAS;AAAA,YAAA,EAER,OAAO,CAAC,MAAM,OAAQ,SAAS,QAAgB,CAAC,MAAM,UAAU,EAChE,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EACnB,KAAK,IAAI,CAAC;AAAA,UAAA;AAAA,QAEjB;AAEA,cAAM,WAAW,OAAO,gBAAgB,QAAQ;AAEhD,YAAI,QAAQ,QAAQ,IAAI,gBAAgB,MAAM,UAAU;AACtD,iBAAO;AAAA,YACL;AAAA,cACE,GAAG,SAAS;AAAA,cACZ,sBAAsB;AAAA,YAAA;AAAA,YAExB;AAAA,cACE,SAAS,SAAS;AAAA,YAAA;AAAA,UACpB;AAAA,QAEJ;AAEA,eAAO;AAAA,MACT;AAEA,aAAO;AAAA,IACT;AAEA,WAAO,eAAe,oBAAoB;AAAA,EAC5C;AACF;AAEA,eAAe,mBAAmB,MAM/B;AACD,QAAM,MAAM,IAAI,IAAI,KAAK,QAAQ,GAAG;AACpC,QAAM,WAAW,IAAI;AAErB,QAAM,mBAAmB,iBAA0C;AAAA,IACjE;AAAA,IACA,UAAU,KAAK;AAAA,IACf,eAAe;AAAA,IACf,cAAc,KAAK,yBAAyB;AAAA,IAC5C,YAAY,KAAK,yBAAyB;AAAA,IAC1C,YAAY,KAAK,yBAAyB;AAAA,EAAA,CAC3C;AAED,QAAM,kBAAkB,KAAK,OAAO,iBAAiB,UAAU,MAAS;AAExE,MAAI;AACJ,MAAI,gBAAgD,CAAA;AACpD,kBAAgB,iBAAiB;AAEjC,MAAI,gBAAgB,YAAY;AAC9B,QACE,iBAAiB,cAAc,SAC/B,gBAAgB,cAAc,QAC9B;AACA,YAAM,gBAAgB,CAAC,GAAG,gBAAgB,aAAa,EACpD,QAAA,EACA,KAAK,CAAC,MAAM;AACX,eAAO,KAAK,yBAAyB,WAAW,EAAE,EAAE,MAAM;AAAA,MAC5D,CAAC;AACH,UAAI,eAAe;AAEjB,YAAI,UAAU,cAAc;AAC5B,wBAAgB,CAAA;AAChB,WAAG;AACD,gBAAM,QAAQ,KAAK,yBAAyB,WAAW,OAAO;AAC9D,cAAI,CAAC,OAAO;AACV;AAAA,UACF;AACA,wBAAc,KAAK,KAAK;AACxB,oBAAU,MAAM,aAAa;AAAA,QAC/B,SAAS;AAET,sBAAc,QAAA;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AAEA,MAAI,cAAc,QAAQ;AAIxB,UAAM,cAAc;AAAA,MAClB,cAAc,QAAQ,CAAC,MAAM,EAAE,QAAQ,UAAU,EAAE,OAAO,OAAO;AAAA,IAAA,EACjE,IAAI,CAAC,MAAM,EAAE,QAAQ,MAAM;AAE7B,QAAI,iBAAiB,YAAY,QAAQ,SAAS;AAChD,YAAM,SAAS,OAAO;AAAA,QACpB,iBAAiB,WAAW,QAAQ;AAAA,MAAA,EACpC;AAAA,QACA,CAACC,YAAWA,QAAO,YAAA,MAAkB,KAAK,QAAQ,OAAO,YAAA;AAAA,MAAY;AAGvE,UAAI,QAAQ;AACV,cAAM,UAAU,iBAAiB,WAAW,QAAQ,QAAQ,MAAM;AAClE,YAAI,SAAS;AACX,cAAI,OAAO,YAAY,YAAY;AACjC,wBAAY,KAAK,oBAAoB,OAAO,CAAS;AAAA,UACvD,OAAO;AACL,gBACE,QAAQ,SAAS,eACjB,QAAQ,SAAS,YAAY,QAC7B;AACA,0BAAY;AAAA,gBACV,GAAG,mBAAmB,QAAQ,SAAS,WAAkB,EAAE;AAAA,kBACzD,CAAC,MAAM,EAAE,QAAQ;AAAA,gBAAA;AAAA,cACnB;AAAA,YAEJ;AACA,gBAAI,QAAQ,SAAS,SAAS;AAC5B,0BAAY,KAAK,oBAAoB,QAAQ,SAAS,OAAO,CAAC;AAAA,YAChE;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAGA,gBAAY,KAAK,oBAAoB,KAAK,aAAa,CAAC;AAKxD,UAAM,MAAM,MAAM,kBAAkB,aAAa;AAAA,MAC/C,SAAS,KAAK;AAAA,MACd,SAAS,CAAA;AAAA,MACT,QAAQ,iBAAiB;AAAA,MACzB;AAAA,IAAA,CACD;AAED,eAAW,IAAI;AAAA,EACjB;AAKA,SAAO,CAAC,eAAe,QAAQ;AACjC;AAEA,SAAS,oBACP,SAOA;AACA,SAAO,OAAO,EAAE,MAAM,OAAO,GAAG,WAAiB;AAC/C,UAAM,WAAW,MAAM,QAAQ,IAAI;AACnC,QAAI,UAAU;AACZ,aAAO,EAAE,SAAA;AAAA,IACX;AACA,WAAO,MAAM,IAAI;AAAA,EACnB;AACF;AAEA,SAAS,kBAAkB,aAAmB,KAAW;AACvD,MAAI,QAAQ;AAEZ,QAAM,OAAO,OAAOC,SAAc;AAChC;AACA,UAAM,aAAa,YAAY,KAAK;AACpC,QAAI,CAAC,WAAY,QAAOA;AAExB,UAAM,SAAS,MAAM,WAAW;AAAA,MAC9B,GAAGA;AAAAA;AAAAA,MAEH,MAAM,OAAO,YAAkB;AAE7B,cAAM,aAAa,MAAM,KAAK;AAAA,UAC5B,GAAGA;AAAAA,UACH,GAAG;AAAA,UACH,SAAS;AAAA,YACP,GAAGA,KAAI;AAAA,YACP,GAAI,SAAS,WAAW,CAAA;AAAA,UAAC;AAAA,QAC3B,CACD;AAGD,eAAO,OAAO,OAAOA,MAAK,gBAAgB,UAAU,CAAC;AAAA,MACvD;AAAA;AAAA,IAAA,CAED,EAAE,MAAM,CAAC,QAAc;AACtB,UAAI,kBAAkB,GAAG,GAAG;AAC1B,eAAO;AAAA,UACL,UAAU;AAAA,QAAA;AAAA,MAEd;AAEA,YAAM;AAAA,IACR,CAAC;AAID,WAAO,OAAO,OAAOA,MAAK,gBAAgB,MAAM,CAAC;AAAA,EACnD;AAEA,SAAO,gBAAgB,KAAK,GAAG,CAAC;AAClC;AAEA,SAAS,gBAAgB,QAAc;AACrC,MAAI,kBAAkB,MAAM,GAAG;AAC7B,WAAO;AAAA,MACL,UAAU;AAAA,IAAA;AAAA,EAEd;AAEA,SAAO;AACT;AAEA,SAAS,kBAAkB,KAAW;AACpC,SAAO,WAAW,GAAG,KAAK,WAAW,GAAG;AAC1C;AAEA,SAAS,WAAW,UAA0C;AAC5D,SAAO,oBAAoB;AAC7B;"}

package/dist/esm/index.d.ts

@@ -1,12 +1,10 @@
-export { transformReadableStreamWithRouter, transformPipeableStreamWithRouter, } from './transformStreamWithRouter.js';
-export { getStartResponseHeaders, createStartHandler, } from './createStartHandler.js';
+export { createStartHandler } from './createStartHandler.js';
 export type { CustomizeStartHandler } from './createStartHandler.js';
-export { createRequestHandler } from './createRequestHandler.js';
-export { defineHandlerCallback } from './handlerCallback.js';
-export type { HandlerCallback } from './handlerCallback.js';
-export { attachRouterServerSsrUtils, dehydrateRouter } from './ssr-server.js';
+export { attachRouterServerSsrUtils, createRequestHandler, defineHandlerCallback, transformReadableStreamWithRouter, transformPipeableStreamWithRouter, } from '@tanstack/router-core/ssr/server';
+export type { HandlerCallback } from '@tanstack/router-core/ssr/server';
 export { handleServerAction } from './server-functions-handler.js';
-export * from './h3.js';
+export * from './request-response.js';
 export { createServerRoute, createServerFileRoute, createServerRootRoute, } from './serverRoute.js';
-export type { CreateServerFileRoute, ServerFileRoutesByPath, } from './serverRoute.js';
+export type { CreateServerFileRoute, ServerFileRoutesByPath, ServerRouteOptions, ServerRouteManifest, ServerRouteAddFileChildrenFn, ServerRouteMethodBuilderOptions, AnyServerRouteWithTypes, ServerRouteWithTypes, ServerRouteTypes, ResolveAllServerContext, AnyServerRoute, ServerRoute, ServerRouteMiddleware, ServerRouteAfterMiddleware, ServerRouteMethods, ServerRouteMethodsOptions, ServerRouteMethodsRecord, ServerRouteMethodRecordValue, ServerRouteVerb, ServerRouteMethodHandlerFn, ServerRouteMethodHandlerCtx, MergeMethodMiddlewares, AssignAllMethodContext, AnyRouteMethodsBuilder, ServerRouteMethodBuilder, ServerRouteMethodBuilderWithTypes, ServerRouteMethodBuilderTypes, ServerRouteMethodBuilderMiddleware, ServerRouteMethodBuilderAfterMiddleware, ServerRouteMethodBuilderHandler, ServerRouteMethodBuilderAfterHandler, ServerRouteMethod, ServerRouteAfterMethods, } from './serverRoute.js';
 export * from './virtual-modules.js';
+export { HEADERS } from './constants.js';