@tanstack/start-server-core 1.169.1 → 1.169.3

package/dist/esm/createStartHandler.js

@@ -267,8 +267,7 @@ function createStartHandler(cbOrOptions) {
 				attachRouterServerSsrUtils({
 					router: routerInstance,
 					manifest,
-					getRequestAssets: () => getStartContext({ throwIfNotFound: false })?.requestAssets,
-					includeUnmatchedRouteAssets: false
+					getRequestAssets: () => getStartContext({ throwIfNotFound: false })?.requestAssets
 				});
 				routerInstance.update({ additionalContext: { serverContext } });
 				await routerInstance.load();

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          includeUnmatchedRouteAssets: false,\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":"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"}
+{"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":"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"}

package/dist/esm/early-hints.d.ts

@@ -1,4 +1,4 @@
-import { AnyRoute, AnyRouteMatch, AssetCrossOrigin, Manifest } from '@tanstack/router-core';
+import { AnyRoute, AnyRouteMatch, AssetCrossOrigin, ServerManifest } from '@tanstack/router-core';
 export type EarlyHint = {
     href: string;
     rel: 'preload' | 'modulepreload' | 'preconnect' | 'dns-prefetch';
@@ -29,14 +29,14 @@ export type ResponseLinkHeaderOptions = {
 };
 export interface EarlyHintsCollector {
     collectStatic: (opts: {
-        manifest: Manifest;
+        manifest: ServerManifest;
         matchedRoutes?: ReadonlyArray<AnyRoute>;
     }) => void;
     collectDynamic: (matches: ReadonlyArray<AnyRouteMatch>) => void;
     appendResponseHeaders: (headers: Headers) => void;
 }
 export declare function serializeEarlyHint(hint: EarlyHint): string;
-export declare function collectStaticHintsFromManifest(manifest: Manifest, matchedRoutes: ReadonlyArray<AnyRoute>): Array<EarlyHint>;
+export declare function collectStaticHintsFromManifest(manifest: ServerManifest, matchedRoutes: ReadonlyArray<AnyRoute>): Array<EarlyHint>;
 export declare function collectDynamicHintsFromMatches(matches: ReadonlyArray<AnyRouteMatch>): Array<EarlyHint>;
 export declare function createEarlyHintsEvent(opts: {
     phase: EarlyHintsPhase;

package/dist/esm/early-hints.js

@@ -1,4 +1,4 @@
-import { getStylesheetHref, resolveManifestAssetLink } from "@tanstack/router-core";
+import { getScriptPreloadAttrs, getStylesheetHref, resolveManifestCssLink } from "@tanstack/router-core";
 //#region src/early-hints.ts
 var LINK_PARAM_TOKEN_RE = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
 var PRELOAD_AS_VALUES = new Set([
@@ -83,31 +83,26 @@ function collectStaticHintsFromManifest(manifest, matchedRoutes) {
 		const routeManifest = manifest.routes[route.id];
 		if (!routeManifest) continue;
 		for (const link of routeManifest.preloads ?? []) {
-			const { href, crossOrigin } = resolveManifestAssetLink(link);
+			const attrs = getScriptPreloadAttrs(manifest, link);
 			const hint = {
-				href,
-				rel: "modulepreload",
+				href: attrs.href,
+				rel: attrs.rel,
 				as: "script"
 			};
-			if (crossOrigin !== void 0) hint.crossOrigin = crossOrigin;
+			if (attrs.crossOrigin !== void 0) hint.crossOrigin = attrs.crossOrigin;
 			hints.push(hint);
 		}
-		for (const asset of routeManifest.assets ?? []) {
-			if (asset.tag !== "link") continue;
-			const stylesheetHref = getStylesheetHref(asset);
-			if (stylesheetHref) {
-				if (manifest.inlineCss?.styles[stylesheetHref] !== void 0) continue;
-				const hint = {
-					href: stylesheetHref,
-					rel: "preload",
-					as: "style"
-				};
-				addEarlyHintFetchAttrs(hint, asset.attrs);
-				hints.push(hint);
-				continue;
-			}
-			const hint = linkAttrsToEarlyHint(asset.attrs);
-			if (hint) hints.push(hint);
+		for (const link of routeManifest.css ?? []) {
+			const stylesheetHref = getStylesheetHref(link);
+			if (manifest.inlineCss?.styles[stylesheetHref] !== void 0) continue;
+			const resolvedLink = resolveManifestCssLink(link);
+			const hint = {
+				href: stylesheetHref,
+				rel: "preload",
+				as: "style"
+			};
+			if (resolvedLink.crossOrigin !== void 0) hint.crossOrigin = resolvedLink.crossOrigin;
+			hints.push(hint);
 		}
 	}
 	return hints;

package/dist/esm/early-hints.js.map

@@ -1 +1 @@
-{"version":3,"file":"early-hints.js","names":[],"sources":["../../src/early-hints.ts"],"sourcesContent":["import {\n  getStylesheetHref,\n  resolveManifestAssetLink,\n} from '@tanstack/router-core'\nimport type {\n  AnyRoute,\n  AnyRouteMatch,\n  AssetCrossOrigin,\n  Manifest,\n  RouterManagedTag,\n} from '@tanstack/router-core'\n\nexport type EarlyHint = {\n  href: string\n  rel: 'preload' | 'modulepreload' | 'preconnect' | 'dns-prefetch'\n  as?: 'fetch' | 'font' | 'image' | 'script' | 'style' | 'track'\n  crossOrigin?: AssetCrossOrigin | ''\n  type?: string\n  integrity?: string\n  referrerPolicy?: string\n  fetchPriority?: string\n}\n\nexport type EarlyHintsPhase = 'static' | 'dynamic'\n\nexport type EarlyHintsEvent = {\n  phase: EarlyHintsPhase\n  hints: ReadonlyArray<EarlyHint>\n  links: Array<string>\n  allHints: ReadonlyArray<EarlyHint>\n  allLinks: Array<string>\n}\n\nexport type OnEarlyHints = (event: EarlyHintsEvent) => void | Promise<void>\n\nexport type ResponseLinkHeaderEntry = {\n  phase: EarlyHintsPhase\n  hint: EarlyHint\n  link: string\n}\n\nexport type ResponseLinkHeaderFilter = (\n  entry: ResponseLinkHeaderEntry,\n) => boolean\n\nexport type ResponseLinkHeaderOptions = {\n  filter?: ResponseLinkHeaderFilter\n}\n\nexport interface EarlyHintsCollector {\n  collectStatic: (opts: {\n    manifest: Manifest\n    matchedRoutes?: ReadonlyArray<AnyRoute>\n  }) => void\n  collectDynamic: (matches: ReadonlyArray<AnyRouteMatch>) => void\n  appendResponseHeaders: (headers: Headers) => void\n}\n\nconst LINK_PARAM_TOKEN_RE = /^[!#$%&'*+\\-.^_`|~0-9A-Za-z]+$/\nconst PRELOAD_AS_VALUES = new Set<EarlyHint['as']>([\n  'fetch',\n  'font',\n  'image',\n  'script',\n  'style',\n  'track',\n])\n\nfunction buildLinkParam(name: string, value: string | undefined): string {\n  if (value === undefined) return name\n  if (LINK_PARAM_TOKEN_RE.test(value)) return `${name}=${value}`\n  return `${name}=${JSON.stringify(value)}`\n}\n\nexport function serializeEarlyHint(hint: EarlyHint): string {\n  const parts = [`<${hint.href}>`, buildLinkParam('rel', hint.rel)]\n  if (hint.as) parts.push(buildLinkParam('as', hint.as))\n  if (hint.crossOrigin !== undefined) {\n    parts.push(buildLinkParam('crossorigin', hint.crossOrigin || undefined))\n  }\n  if (hint.type) parts.push(buildLinkParam('type', hint.type))\n  if (hint.integrity) parts.push(buildLinkParam('integrity', hint.integrity))\n  if (hint.referrerPolicy) {\n    parts.push(buildLinkParam('referrerpolicy', hint.referrerPolicy))\n  }\n  if (hint.fetchPriority) {\n    parts.push(buildLinkParam('fetchpriority', hint.fetchPriority))\n  }\n  return parts.join('; ')\n}\n\nfunction getStringAttr(\n  attrs: Record<string, any> | undefined,\n  name: string,\n  fallbackName?: string,\n): string | undefined {\n  const value =\n    attrs?.[name] ?? (fallbackName ? attrs?.[fallbackName] : undefined)\n  return typeof value === 'string' ? value : undefined\n}\n\nfunction getPreloadAs(\n  attrs: Record<string, any> | undefined,\n): EarlyHint['as'] | undefined {\n  const as = getStringAttr(attrs, 'as')\n  return as && PRELOAD_AS_VALUES.has(as as EarlyHint['as'])\n    ? (as as EarlyHint['as'])\n    : undefined\n}\n\nfunction addEarlyHintFetchAttrs(\n  hint: EarlyHint,\n  attrs: Record<string, any> | undefined,\n) {\n  const crossOrigin = getStringAttr(attrs, 'crossOrigin', 'crossorigin') as\n    | EarlyHint['crossOrigin']\n    | undefined\n  const type = getStringAttr(attrs, 'type')\n  const integrity = getStringAttr(attrs, 'integrity')\n  const referrerPolicy = getStringAttr(\n    attrs,\n    'referrerPolicy',\n    'referrerpolicy',\n  )\n  const fetchPriority = getStringAttr(attrs, 'fetchPriority', 'fetchpriority')\n\n  if (crossOrigin !== undefined) hint.crossOrigin = crossOrigin\n  if (type) hint.type = type\n  if (integrity) hint.integrity = integrity\n  if (referrerPolicy) hint.referrerPolicy = referrerPolicy\n  if (fetchPriority) hint.fetchPriority = fetchPriority\n}\n\nfunction linkAttrsToEarlyHint(\n  attrs: Record<string, any> | undefined,\n): EarlyHint | undefined {\n  const href = getStringAttr(attrs, 'href')\n  const rel = getStringAttr(attrs, 'rel')\n  if (!href || !rel) return undefined\n\n  const relTokens = rel.split(/\\s+/)\n  let hintRel: EarlyHint['rel'] | undefined\n  let hintAs: EarlyHint['as'] | undefined\n\n  if (relTokens.includes('modulepreload')) {\n    hintRel = 'modulepreload'\n    hintAs = 'script'\n  } else if (relTokens.includes('stylesheet')) {\n    hintRel = 'preload'\n    hintAs = 'style'\n  } else if (relTokens.includes('preload')) {\n    hintAs = getPreloadAs(attrs)\n    if (!hintAs) return undefined\n    hintRel = 'preload'\n  } else if (relTokens.includes('preconnect')) {\n    hintRel = 'preconnect'\n    hintAs = undefined\n  } else if (relTokens.includes('dns-prefetch')) {\n    hintRel = 'dns-prefetch'\n    hintAs = undefined\n  }\n\n  if (!hintRel) return undefined\n\n  const hint: EarlyHint = {\n    href,\n    rel: hintRel,\n  }\n\n  if (hintAs) hint.as = hintAs\n  addEarlyHintFetchAttrs(hint, attrs)\n\n  return hint\n}\n\nexport function collectStaticHintsFromManifest(\n  manifest: Manifest,\n  matchedRoutes: ReadonlyArray<AnyRoute>,\n): Array<EarlyHint> {\n  const hints: Array<EarlyHint> = []\n\n  for (const route of matchedRoutes) {\n    const routeManifest = manifest.routes[route.id]\n    if (!routeManifest) continue\n\n    for (const link of routeManifest.preloads ?? []) {\n      const { href, crossOrigin } = resolveManifestAssetLink(link)\n      const hint: EarlyHint = { href, rel: 'modulepreload', as: 'script' }\n      if (crossOrigin !== undefined) hint.crossOrigin = crossOrigin\n      hints.push(hint)\n    }\n\n    for (const asset of routeManifest.assets ?? []) {\n      if (asset.tag !== 'link') continue\n\n      const stylesheetHref = getStylesheetHref(asset)\n      if (stylesheetHref) {\n        if (manifest.inlineCss?.styles[stylesheetHref] !== undefined) continue\n\n        const hint: EarlyHint = {\n          href: stylesheetHref,\n          rel: 'preload',\n          as: 'style',\n        }\n        addEarlyHintFetchAttrs(hint, asset.attrs)\n        hints.push(hint)\n        continue\n      }\n\n      const hint = linkAttrsToEarlyHint(asset.attrs)\n      if (hint) {\n        hints.push(hint)\n      }\n    }\n  }\n\n  return hints\n}\n\nexport function collectDynamicHintsFromMatches(\n  matches: ReadonlyArray<AnyRouteMatch>,\n): Array<EarlyHint> {\n  const hints: Array<EarlyHint> = []\n\n  for (const match of matches) {\n    const links = match.links\n    if (!Array.isArray(links)) continue\n\n    for (const link of links as Array<RouterManagedTag['attrs']>) {\n      const hint = linkAttrsToEarlyHint(link)\n      if (hint) hints.push(hint)\n    }\n  }\n\n  return hints\n}\n\nexport function createEarlyHintsEvent(opts: {\n  phase: EarlyHintsPhase\n  hints: ReadonlyArray<EarlyHint>\n  sentLinks: Set<string>\n  sentHints: Array<EarlyHint>\n}): EarlyHintsEvent | undefined {\n  const nextHints: Array<EarlyHint> = []\n  const nextLinks: Array<string> = []\n\n  for (const hint of opts.hints) {\n    const link = serializeEarlyHint(hint)\n    if (opts.sentLinks.has(link)) continue\n    opts.sentLinks.add(link)\n    opts.sentHints.push(hint)\n    nextHints.push(hint)\n    nextLinks.push(link)\n  }\n\n  if (!nextHints.length && opts.phase !== 'dynamic') return undefined\n\n  return {\n    phase: opts.phase,\n    hints: nextHints,\n    links: nextLinks,\n    allHints: opts.sentHints.slice(),\n    allLinks: Array.from(opts.sentLinks),\n  }\n}\n\nexport function createResponseLinkHeaderEntries(opts: {\n  phase: EarlyHintsPhase\n  hints: ReadonlyArray<EarlyHint>\n  sentLinks: Set<string>\n  entries: Array<ResponseLinkHeaderEntry>\n}) {\n  for (const hint of opts.hints) {\n    const link = serializeEarlyHint(hint)\n    if (opts.sentLinks.has(link)) continue\n\n    opts.sentLinks.add(link)\n    opts.entries.push({ phase: opts.phase, hint, link })\n  }\n}\n\nexport function getResponseLinkHeaderEntries(opts: {\n  entries: ReadonlyArray<ResponseLinkHeaderEntry>\n  filter?: ResponseLinkHeaderFilter\n}): Array<string> {\n  if (!opts.filter) {\n    return opts.entries.map((entry) => entry.link)\n  }\n\n  try {\n    const links: Array<string> = []\n\n    for (const entry of opts.entries) {\n      if (opts.filter(entry)) {\n        links.push(entry.link)\n      }\n    }\n\n    return links\n  } catch (err) {\n    console.error('Error filtering response Link headers:', err)\n    return []\n  }\n}\n\nfunction notifyEarlyHints(\n  phase: EarlyHintsPhase,\n  event: EarlyHintsEvent,\n  onEarlyHints: OnEarlyHints,\n) {\n  try {\n    const result = onEarlyHints(event)\n    if (result) {\n      void Promise.resolve(result).catch((err) => {\n        console.error(`Error sending ${phase} early hints:`, err)\n      })\n    }\n  } catch (err) {\n    console.error(`Error sending ${phase} early hints:`, err)\n  }\n}\n\nfunction getResponseLinkHeaderFilter(\n  responseLinkHeader: boolean | ResponseLinkHeaderOptions | undefined,\n): ResponseLinkHeaderFilter | undefined {\n  if (typeof responseLinkHeader !== 'object') {\n    return undefined\n  }\n\n  return responseLinkHeader.filter\n}\n\nfunction appendResponseLinkHeaders(opts: {\n  responseHeaders: Headers\n  entries: ReadonlyArray<ResponseLinkHeaderEntry>\n  filter?: ResponseLinkHeaderFilter\n}) {\n  for (const link of getResponseLinkHeaderEntries(opts)) {\n    opts.responseHeaders.append('Link', link)\n  }\n}\n\nfunction collectResponseLinkHeaderEntries(opts: {\n  phase: EarlyHintsPhase\n  event: EarlyHintsEvent\n  entries: Array<ResponseLinkHeaderEntry>\n}) {\n  for (let index = 0; index < opts.event.hints.length; index++) {\n    opts.entries.push({\n      phase: opts.phase,\n      hint: opts.event.hints[index]!,\n      link: opts.event.links[index]!,\n    })\n  }\n}\n\nfunction collectEarlyHintsPhase(opts: {\n  phase: EarlyHintsPhase\n  hints: ReadonlyArray<EarlyHint>\n  sentLinks: Set<string>\n  sentHints?: Array<EarlyHint>\n  onEarlyHints?: OnEarlyHints\n  responseLinkHeaderEntries?: Array<ResponseLinkHeaderEntry>\n}) {\n  const event = opts.onEarlyHints\n    ? createEarlyHintsEvent({\n        phase: opts.phase,\n        hints: opts.hints,\n        sentLinks: opts.sentLinks,\n        sentHints: opts.sentHints!,\n      })\n    : undefined\n\n  if (event) {\n    notifyEarlyHints(opts.phase, event, opts.onEarlyHints!)\n  }\n\n  if (!opts.responseLinkHeaderEntries) return\n\n  if (event) {\n    collectResponseLinkHeaderEntries({\n      phase: opts.phase,\n      event,\n      entries: opts.responseLinkHeaderEntries,\n    })\n    return\n  }\n\n  createResponseLinkHeaderEntries({\n    phase: opts.phase,\n    hints: opts.hints,\n    sentLinks: opts.sentLinks,\n    entries: opts.responseLinkHeaderEntries,\n  })\n}\n\nexport function createEarlyHintsCollector(\n  opts:\n    | {\n        onEarlyHints?: OnEarlyHints\n        responseLinkHeader?: boolean | ResponseLinkHeaderOptions\n      }\n    | undefined,\n): EarlyHintsCollector | undefined {\n  if (\n    process.env.TSS_DEV_SERVER === 'true' ||\n    (!opts?.onEarlyHints && !opts?.responseLinkHeader)\n  ) {\n    return undefined\n  }\n\n  const sentLinks = new Set<string>()\n  const sentHints = opts.onEarlyHints ? new Array<EarlyHint>() : undefined\n  const responseLinkHeaderEntries = opts.responseLinkHeader\n    ? new Array<ResponseLinkHeaderEntry>()\n    : undefined\n  const responseLinkHeaderFilter = getResponseLinkHeaderFilter(\n    opts.responseLinkHeader,\n  )\n\n  return {\n    collectStatic: ({ manifest, matchedRoutes }) => {\n      if (!matchedRoutes?.length) return\n\n      collectEarlyHintsPhase({\n        phase: 'static',\n        hints: collectStaticHintsFromManifest(manifest, matchedRoutes),\n        sentLinks,\n        sentHints,\n        onEarlyHints: opts.onEarlyHints,\n        responseLinkHeaderEntries,\n      })\n    },\n    collectDynamic: (matches) => {\n      collectEarlyHintsPhase({\n        phase: 'dynamic',\n        hints: collectDynamicHintsFromMatches(matches),\n        sentLinks,\n        sentHints,\n        onEarlyHints: opts.onEarlyHints,\n        responseLinkHeaderEntries,\n      })\n    },\n    appendResponseHeaders: (headers) => {\n      if (!responseLinkHeaderEntries?.length) return\n\n      appendResponseLinkHeaders({\n        responseHeaders: headers,\n        entries: responseLinkHeaderEntries,\n        filter: responseLinkHeaderFilter,\n      })\n    },\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"early-hints.js","names":[],"sources":["../../src/early-hints.ts"],"sourcesContent":["import {\n  getScriptPreloadAttrs,\n  getStylesheetHref,\n  resolveManifestCssLink,\n} from '@tanstack/router-core'\nimport type {\n  AnyRoute,\n  AnyRouteMatch,\n  AssetCrossOrigin,\n  RouterManagedTag,\n  ServerManifest,\n} from '@tanstack/router-core'\n\nexport type EarlyHint = {\n  href: string\n  rel: 'preload' | 'modulepreload' | 'preconnect' | 'dns-prefetch'\n  as?: 'fetch' | 'font' | 'image' | 'script' | 'style' | 'track'\n  crossOrigin?: AssetCrossOrigin | ''\n  type?: string\n  integrity?: string\n  referrerPolicy?: string\n  fetchPriority?: string\n}\n\nexport type EarlyHintsPhase = 'static' | 'dynamic'\n\nexport type EarlyHintsEvent = {\n  phase: EarlyHintsPhase\n  hints: ReadonlyArray<EarlyHint>\n  links: Array<string>\n  allHints: ReadonlyArray<EarlyHint>\n  allLinks: Array<string>\n}\n\nexport type OnEarlyHints = (event: EarlyHintsEvent) => void | Promise<void>\n\nexport type ResponseLinkHeaderEntry = {\n  phase: EarlyHintsPhase\n  hint: EarlyHint\n  link: string\n}\n\nexport type ResponseLinkHeaderFilter = (\n  entry: ResponseLinkHeaderEntry,\n) => boolean\n\nexport type ResponseLinkHeaderOptions = {\n  filter?: ResponseLinkHeaderFilter\n}\n\nexport interface EarlyHintsCollector {\n  collectStatic: (opts: {\n    manifest: ServerManifest\n    matchedRoutes?: ReadonlyArray<AnyRoute>\n  }) => void\n  collectDynamic: (matches: ReadonlyArray<AnyRouteMatch>) => void\n  appendResponseHeaders: (headers: Headers) => void\n}\n\nconst LINK_PARAM_TOKEN_RE = /^[!#$%&'*+\\-.^_`|~0-9A-Za-z]+$/\nconst PRELOAD_AS_VALUES = new Set<EarlyHint['as']>([\n  'fetch',\n  'font',\n  'image',\n  'script',\n  'style',\n  'track',\n])\n\nfunction buildLinkParam(name: string, value: string | undefined): string {\n  if (value === undefined) return name\n  if (LINK_PARAM_TOKEN_RE.test(value)) return `${name}=${value}`\n  return `${name}=${JSON.stringify(value)}`\n}\n\nexport function serializeEarlyHint(hint: EarlyHint): string {\n  const parts = [`<${hint.href}>`, buildLinkParam('rel', hint.rel)]\n  if (hint.as) parts.push(buildLinkParam('as', hint.as))\n  if (hint.crossOrigin !== undefined) {\n    parts.push(buildLinkParam('crossorigin', hint.crossOrigin || undefined))\n  }\n  if (hint.type) parts.push(buildLinkParam('type', hint.type))\n  if (hint.integrity) parts.push(buildLinkParam('integrity', hint.integrity))\n  if (hint.referrerPolicy) {\n    parts.push(buildLinkParam('referrerpolicy', hint.referrerPolicy))\n  }\n  if (hint.fetchPriority) {\n    parts.push(buildLinkParam('fetchpriority', hint.fetchPriority))\n  }\n  return parts.join('; ')\n}\n\nfunction getStringAttr(\n  attrs: Record<string, any> | undefined,\n  name: string,\n  fallbackName?: string,\n): string | undefined {\n  const value =\n    attrs?.[name] ?? (fallbackName ? attrs?.[fallbackName] : undefined)\n  return typeof value === 'string' ? value : undefined\n}\n\nfunction getPreloadAs(\n  attrs: Record<string, any> | undefined,\n): EarlyHint['as'] | undefined {\n  const as = getStringAttr(attrs, 'as')\n  return as && PRELOAD_AS_VALUES.has(as as EarlyHint['as'])\n    ? (as as EarlyHint['as'])\n    : undefined\n}\n\nfunction addEarlyHintFetchAttrs(\n  hint: EarlyHint,\n  attrs: Record<string, any> | undefined,\n) {\n  const crossOrigin = getStringAttr(attrs, 'crossOrigin', 'crossorigin') as\n    | EarlyHint['crossOrigin']\n    | undefined\n  const type = getStringAttr(attrs, 'type')\n  const integrity = getStringAttr(attrs, 'integrity')\n  const referrerPolicy = getStringAttr(\n    attrs,\n    'referrerPolicy',\n    'referrerpolicy',\n  )\n  const fetchPriority = getStringAttr(attrs, 'fetchPriority', 'fetchpriority')\n\n  if (crossOrigin !== undefined) hint.crossOrigin = crossOrigin\n  if (type) hint.type = type\n  if (integrity) hint.integrity = integrity\n  if (referrerPolicy) hint.referrerPolicy = referrerPolicy\n  if (fetchPriority) hint.fetchPriority = fetchPriority\n}\n\nfunction linkAttrsToEarlyHint(\n  attrs: Record<string, any> | undefined,\n): EarlyHint | undefined {\n  const href = getStringAttr(attrs, 'href')\n  const rel = getStringAttr(attrs, 'rel')\n  if (!href || !rel) return undefined\n\n  const relTokens = rel.split(/\\s+/)\n  let hintRel: EarlyHint['rel'] | undefined\n  let hintAs: EarlyHint['as'] | undefined\n\n  if (relTokens.includes('modulepreload')) {\n    hintRel = 'modulepreload'\n    hintAs = 'script'\n  } else if (relTokens.includes('stylesheet')) {\n    hintRel = 'preload'\n    hintAs = 'style'\n  } else if (relTokens.includes('preload')) {\n    hintAs = getPreloadAs(attrs)\n    if (!hintAs) return undefined\n    hintRel = 'preload'\n  } else if (relTokens.includes('preconnect')) {\n    hintRel = 'preconnect'\n    hintAs = undefined\n  } else if (relTokens.includes('dns-prefetch')) {\n    hintRel = 'dns-prefetch'\n    hintAs = undefined\n  }\n\n  if (!hintRel) return undefined\n\n  const hint: EarlyHint = {\n    href,\n    rel: hintRel,\n  }\n\n  if (hintAs) hint.as = hintAs\n  addEarlyHintFetchAttrs(hint, attrs)\n\n  return hint\n}\n\nexport function collectStaticHintsFromManifest(\n  manifest: ServerManifest,\n  matchedRoutes: ReadonlyArray<AnyRoute>,\n): Array<EarlyHint> {\n  const hints: Array<EarlyHint> = []\n\n  for (const route of matchedRoutes) {\n    const routeManifest = manifest.routes[route.id]\n    if (!routeManifest) continue\n\n    for (const link of routeManifest.preloads ?? []) {\n      const attrs = getScriptPreloadAttrs(manifest, link)\n      const hint: EarlyHint = {\n        href: attrs.href,\n        rel: attrs.rel,\n        as: 'script',\n      }\n      if (attrs.crossOrigin !== undefined) hint.crossOrigin = attrs.crossOrigin\n      hints.push(hint)\n    }\n\n    for (const link of routeManifest.css ?? []) {\n      const stylesheetHref = getStylesheetHref(link)\n      if (manifest.inlineCss?.styles[stylesheetHref] !== undefined) {\n        continue\n      }\n      const resolvedLink = resolveManifestCssLink(link)\n\n      const hint: EarlyHint = {\n        href: stylesheetHref,\n        rel: 'preload',\n        as: 'style',\n      }\n      if (resolvedLink.crossOrigin !== undefined) {\n        hint.crossOrigin = resolvedLink.crossOrigin\n      }\n      hints.push(hint)\n    }\n  }\n\n  return hints\n}\n\nexport function collectDynamicHintsFromMatches(\n  matches: ReadonlyArray<AnyRouteMatch>,\n): Array<EarlyHint> {\n  const hints: Array<EarlyHint> = []\n\n  for (const match of matches) {\n    const links = match.links\n    if (!Array.isArray(links)) continue\n\n    for (const link of links as Array<RouterManagedTag['attrs']>) {\n      const hint = linkAttrsToEarlyHint(link)\n      if (hint) hints.push(hint)\n    }\n  }\n\n  return hints\n}\n\nexport function createEarlyHintsEvent(opts: {\n  phase: EarlyHintsPhase\n  hints: ReadonlyArray<EarlyHint>\n  sentLinks: Set<string>\n  sentHints: Array<EarlyHint>\n}): EarlyHintsEvent | undefined {\n  const nextHints: Array<EarlyHint> = []\n  const nextLinks: Array<string> = []\n\n  for (const hint of opts.hints) {\n    const link = serializeEarlyHint(hint)\n    if (opts.sentLinks.has(link)) continue\n    opts.sentLinks.add(link)\n    opts.sentHints.push(hint)\n    nextHints.push(hint)\n    nextLinks.push(link)\n  }\n\n  if (!nextHints.length && opts.phase !== 'dynamic') return undefined\n\n  return {\n    phase: opts.phase,\n    hints: nextHints,\n    links: nextLinks,\n    allHints: opts.sentHints.slice(),\n    allLinks: Array.from(opts.sentLinks),\n  }\n}\n\nexport function createResponseLinkHeaderEntries(opts: {\n  phase: EarlyHintsPhase\n  hints: ReadonlyArray<EarlyHint>\n  sentLinks: Set<string>\n  entries: Array<ResponseLinkHeaderEntry>\n}) {\n  for (const hint of opts.hints) {\n    const link = serializeEarlyHint(hint)\n    if (opts.sentLinks.has(link)) continue\n\n    opts.sentLinks.add(link)\n    opts.entries.push({ phase: opts.phase, hint, link })\n  }\n}\n\nexport function getResponseLinkHeaderEntries(opts: {\n  entries: ReadonlyArray<ResponseLinkHeaderEntry>\n  filter?: ResponseLinkHeaderFilter\n}): Array<string> {\n  if (!opts.filter) {\n    return opts.entries.map((entry) => entry.link)\n  }\n\n  try {\n    const links: Array<string> = []\n\n    for (const entry of opts.entries) {\n      if (opts.filter(entry)) {\n        links.push(entry.link)\n      }\n    }\n\n    return links\n  } catch (err) {\n    console.error('Error filtering response Link headers:', err)\n    return []\n  }\n}\n\nfunction notifyEarlyHints(\n  phase: EarlyHintsPhase,\n  event: EarlyHintsEvent,\n  onEarlyHints: OnEarlyHints,\n) {\n  try {\n    const result = onEarlyHints(event)\n    if (result) {\n      void Promise.resolve(result).catch((err) => {\n        console.error(`Error sending ${phase} early hints:`, err)\n      })\n    }\n  } catch (err) {\n    console.error(`Error sending ${phase} early hints:`, err)\n  }\n}\n\nfunction getResponseLinkHeaderFilter(\n  responseLinkHeader: boolean | ResponseLinkHeaderOptions | undefined,\n): ResponseLinkHeaderFilter | undefined {\n  if (typeof responseLinkHeader !== 'object') {\n    return undefined\n  }\n\n  return responseLinkHeader.filter\n}\n\nfunction appendResponseLinkHeaders(opts: {\n  responseHeaders: Headers\n  entries: ReadonlyArray<ResponseLinkHeaderEntry>\n  filter?: ResponseLinkHeaderFilter\n}) {\n  for (const link of getResponseLinkHeaderEntries(opts)) {\n    opts.responseHeaders.append('Link', link)\n  }\n}\n\nfunction collectResponseLinkHeaderEntries(opts: {\n  phase: EarlyHintsPhase\n  event: EarlyHintsEvent\n  entries: Array<ResponseLinkHeaderEntry>\n}) {\n  for (let index = 0; index < opts.event.hints.length; index++) {\n    opts.entries.push({\n      phase: opts.phase,\n      hint: opts.event.hints[index]!,\n      link: opts.event.links[index]!,\n    })\n  }\n}\n\nfunction collectEarlyHintsPhase(opts: {\n  phase: EarlyHintsPhase\n  hints: ReadonlyArray<EarlyHint>\n  sentLinks: Set<string>\n  sentHints?: Array<EarlyHint>\n  onEarlyHints?: OnEarlyHints\n  responseLinkHeaderEntries?: Array<ResponseLinkHeaderEntry>\n}) {\n  const event = opts.onEarlyHints\n    ? createEarlyHintsEvent({\n        phase: opts.phase,\n        hints: opts.hints,\n        sentLinks: opts.sentLinks,\n        sentHints: opts.sentHints!,\n      })\n    : undefined\n\n  if (event) {\n    notifyEarlyHints(opts.phase, event, opts.onEarlyHints!)\n  }\n\n  if (!opts.responseLinkHeaderEntries) return\n\n  if (event) {\n    collectResponseLinkHeaderEntries({\n      phase: opts.phase,\n      event,\n      entries: opts.responseLinkHeaderEntries,\n    })\n    return\n  }\n\n  createResponseLinkHeaderEntries({\n    phase: opts.phase,\n    hints: opts.hints,\n    sentLinks: opts.sentLinks,\n    entries: opts.responseLinkHeaderEntries,\n  })\n}\n\nexport function createEarlyHintsCollector(\n  opts:\n    | {\n        onEarlyHints?: OnEarlyHints\n        responseLinkHeader?: boolean | ResponseLinkHeaderOptions\n      }\n    | undefined,\n): EarlyHintsCollector | undefined {\n  if (\n    process.env.TSS_DEV_SERVER === 'true' ||\n    (!opts?.onEarlyHints && !opts?.responseLinkHeader)\n  ) {\n    return undefined\n  }\n\n  const sentLinks = new Set<string>()\n  const sentHints = opts.onEarlyHints ? new Array<EarlyHint>() : undefined\n  const responseLinkHeaderEntries = opts.responseLinkHeader\n    ? new Array<ResponseLinkHeaderEntry>()\n    : undefined\n  const responseLinkHeaderFilter = getResponseLinkHeaderFilter(\n    opts.responseLinkHeader,\n  )\n\n  return {\n    collectStatic: ({ manifest, matchedRoutes }) => {\n      if (!matchedRoutes?.length) return\n\n      collectEarlyHintsPhase({\n        phase: 'static',\n        hints: collectStaticHintsFromManifest(manifest, matchedRoutes),\n        sentLinks,\n        sentHints,\n        onEarlyHints: opts.onEarlyHints,\n        responseLinkHeaderEntries,\n      })\n    },\n    collectDynamic: (matches) => {\n      collectEarlyHintsPhase({\n        phase: 'dynamic',\n        hints: collectDynamicHintsFromMatches(matches),\n        sentLinks,\n        sentHints,\n        onEarlyHints: opts.onEarlyHints,\n        responseLinkHeaderEntries,\n      })\n    },\n    appendResponseHeaders: (headers) => {\n      if (!responseLinkHeaderEntries?.length) return\n\n      appendResponseLinkHeaders({\n        responseHeaders: headers,\n        entries: responseLinkHeaderEntries,\n        filter: responseLinkHeaderFilter,\n      })\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/esm/finalManifest.d.ts

@@ -1,4 +1,4 @@
-import { Manifest } from '@tanstack/router-core';
+import { ServerManifest } from '@tanstack/router-core';
 import { HandlerInlineCssOption } from './inlineCss.js';
 import { StartManifestWithClientEntry, TransformAssets } from './transformAssetUrls.js';
 export type { HandlerInlineCssOption, StartManifestWithClientEntry, TransformAssets, };
@@ -32,9 +32,9 @@ export interface FinalManifestRequestOptions {
 export interface FinalManifestResolver {
     warmup: (opts: {
         getBaseManifest: GetBaseManifest;
-    }) => Promise<Manifest> | undefined;
-    resolveCached: (opts: FinalManifestRequestOptions) => Promise<Manifest>;
-    resolveUncached: (opts: FinalManifestRequestOptions) => Promise<Manifest>;
+    }) => Promise<ServerManifest> | undefined;
+    resolveCached: (opts: FinalManifestRequestOptions) => Promise<ServerManifest>;
+    resolveUncached: (opts: FinalManifestRequestOptions) => Promise<ServerManifest>;
 }
 export declare function createCachedBaseManifestLoader(loadBaseManifest: GetBaseManifest): GetBaseManifest;
 export declare function createFinalManifestResolver(opts: FinalManifestOptions & {

package/dist/esm/finalManifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"finalManifest.js","names":[],"sources":["../../src/finalManifest.ts"],"sourcesContent":["import {\n  buildManifestWithClientEntry,\n  resolveTransformAssetsConfig,\n  transformManifestAssets,\n} from './transformAssetUrls'\nimport {\n  getStaticHandlerInlineCssDefault,\n  resolveInlineCssForRequest,\n} from './inlineCss'\nimport type { Manifest } from '@tanstack/router-core'\nimport type { HandlerInlineCssOption } from './inlineCss'\nimport type {\n  CreateTransformAssetsContext,\n  StartManifestWithClientEntry,\n  TransformAssets,\n  TransformAssetsFn,\n} from './transformAssetUrls'\n\nexport type {\n  HandlerInlineCssOption,\n  StartManifestWithClientEntry,\n  TransformAssets,\n}\n\nexport interface FinalManifestOptions {\n  /**\n   * Controls whether Start inlines build-collected CSS by default at runtime.\n   *\n   * This only has an effect when the build was created with\n   * `server.build.inlineCss` enabled. Pass a callback to decide per request.\n   * `handler(request, { inlineCss })` overrides this value for that request.\n   *\n   * @default true\n   */\n  inlineCss?: HandlerInlineCssOption\n  /**\n   * Transform manifest-managed asset URLs and attributes at runtime, e.g. to\n   * prepend a CDN prefix.\n   *\n   * This covers JS preloads, CSS links, the client entry script, and URLs\n   * inside build-collected inline CSS. Asset imports used directly in\n   * components should be handled by the bundler instead.\n   */\n  transformAssets?: TransformAssets\n}\n\ntype FinalManifestCacheKey = 'inline-css' | 'linked-css'\ntype FinalManifestCache = Map<FinalManifestCacheKey, Promise<Manifest>>\nexport type GetBaseManifest = () => Promise<StartManifestWithClientEntry>\n\nexport interface FinalManifestRequestOptions {\n  request: Request\n  requestInlineCss: boolean | undefined\n  getBaseManifest: GetBaseManifest\n}\n\ninterface FinalManifestTransformResolver {\n  cache: boolean\n  warmup: boolean\n  getTransformFn: (\n    ctx: CreateTransformAssetsContext,\n  ) => Promise<TransformAssetsFn | undefined>\n  clearCachedCreateTransform: () => void\n}\n\nexport interface FinalManifestResolver {\n  warmup: (opts: {\n    getBaseManifest: GetBaseManifest\n  }) => Promise<Manifest> | undefined\n  resolveCached: (opts: FinalManifestRequestOptions) => Promise<Manifest>\n  resolveUncached: (opts: FinalManifestRequestOptions) => Promise<Manifest>\n}\n\nexport function createCachedBaseManifestLoader(\n  loadBaseManifest: GetBaseManifest,\n): GetBaseManifest {\n  let baseManifestPromise: Promise<StartManifestWithClientEntry> | undefined\n\n  return () => {\n    if (!baseManifestPromise) {\n      baseManifestPromise = loadBaseManifest().catch((error) => {\n        baseManifestPromise = undefined\n        throw error\n      })\n    }\n\n    return baseManifestPromise\n  }\n}\n\nfunction createFinalManifestTransformResolver(\n  transformAssets: TransformAssets | undefined,\n  opts: { cacheCreateTransform: boolean },\n): FinalManifestTransformResolver {\n  const transformConfig =\n    transformAssets !== undefined\n      ? resolveTransformAssetsConfig(transformAssets)\n      : undefined\n  const cache = transformConfig ? transformConfig.cache : true\n  const warmup =\n    !!transformAssets &&\n    typeof transformAssets === 'object' &&\n    'warmup' in transformAssets &&\n    transformAssets.warmup === true\n\n  let cachedCreateTransformPromise: Promise<TransformAssetsFn> | undefined\n\n  const clearCachedCreateTransform = () => {\n    cachedCreateTransformPromise = undefined\n  }\n\n  return {\n    cache,\n    warmup,\n    clearCachedCreateTransform,\n    getTransformFn: async (ctx) => {\n      if (!transformConfig) return undefined\n\n      if (transformConfig.type !== 'createTransform') {\n        return transformConfig.transformFn\n      }\n\n      if (!cache || !opts.cacheCreateTransform) {\n        return transformConfig.createTransform(ctx)\n      }\n\n      if (!cachedCreateTransformPromise) {\n        cachedCreateTransformPromise = Promise.resolve(\n          transformConfig.createTransform(ctx),\n        ).catch((error) => {\n          clearCachedCreateTransform()\n          throw error\n        })\n      }\n\n      return cachedCreateTransformPromise\n    },\n  }\n}\n\nexport function createFinalManifestResolver(\n  opts: FinalManifestOptions & { cacheCreateTransform: boolean },\n): FinalManifestResolver {\n  const finalManifestCache: FinalManifestCache = new Map()\n  const transformResolver = createFinalManifestTransformResolver(\n    opts.transformAssets,\n    { cacheCreateTransform: opts.cacheCreateTransform },\n  )\n  const handlerDefaultInlineCss = getStaticHandlerInlineCssDefault(\n    opts.inlineCss,\n  )\n\n  const getRequestManifestOptions = async (\n    requestOpts: FinalManifestRequestOptions,\n  ) => {\n    const transformFn = await transformResolver.getTransformFn({\n      warmup: false,\n      request: requestOpts.request,\n    })\n    const inlineCss = await resolveInlineCssForRequest({\n      request: requestOpts.request,\n      handlerInlineCss: opts.inlineCss,\n      requestInlineCss: requestOpts.requestInlineCss,\n    })\n\n    return {\n      getBaseManifest: requestOpts.getBaseManifest,\n      transformFn,\n      cache: transformResolver.cache,\n      inlineCss,\n    }\n  }\n\n  const resolveRequest = async (\n    requestOpts: FinalManifestRequestOptions,\n    cache: FinalManifestCache | undefined,\n  ) => {\n    return resolveFinalManifest({\n      ...(await getRequestManifestOptions(requestOpts)),\n      finalManifestCache: cache,\n    })\n  }\n\n  return {\n    warmup: ({ getBaseManifest }) =>\n      warmupFinalManifest({\n        enabled: transformResolver.warmup,\n        handlerDefaultInlineCss,\n        cache: transformResolver.cache,\n        finalManifestCache,\n        getBaseManifest,\n        getTransformFn: () =>\n          transformResolver.getTransformFn({ warmup: true }),\n        onError: transformResolver.clearCachedCreateTransform,\n      }),\n    resolveCached: (requestOpts) =>\n      resolveRequest(requestOpts, finalManifestCache),\n    resolveUncached: (requestOpts) => resolveRequest(requestOpts, undefined),\n  }\n}\n\nfunction getFinalManifestCacheKey(inlineCss: boolean): FinalManifestCacheKey {\n  return inlineCss ? 'inline-css' : 'linked-css'\n}\n\nfunction cacheFinalManifestPromise(\n  cachedFinalManifestPromises: FinalManifestCache,\n  cacheKey: FinalManifestCacheKey,\n  promise: Promise<Manifest>,\n): Promise<Manifest> {\n  const cachedFinalManifestPromise = promise.catch((error) => {\n    if (\n      cachedFinalManifestPromises.get(cacheKey) === cachedFinalManifestPromise\n    ) {\n      cachedFinalManifestPromises.delete(cacheKey)\n    }\n    throw error\n  })\n\n  cachedFinalManifestPromises.set(cacheKey, cachedFinalManifestPromise)\n  return cachedFinalManifestPromise\n}\n\nfunction getOrCreateCachedFinalManifestPromise(\n  cachedFinalManifestPromises: FinalManifestCache,\n  cacheKey: FinalManifestCacheKey,\n  computeFinalManifest: () => Promise<Manifest>,\n): Promise<Manifest> {\n  const cachedFinalManifestPromise = cachedFinalManifestPromises.get(cacheKey)\n  if (cachedFinalManifestPromise) {\n    return cachedFinalManifestPromise\n  }\n\n  return cacheFinalManifestPromise(\n    cachedFinalManifestPromises,\n    cacheKey,\n    Promise.resolve().then(computeFinalManifest),\n  )\n}\n\nasync function buildFinalManifest(opts: {\n  base: StartManifestWithClientEntry\n  transformFn: TransformAssetsFn | undefined\n  inlineCss: boolean\n}): Promise<Manifest> {\n  return opts.transformFn\n    ? await transformManifestAssets(opts.base, opts.transformFn, {\n        inlineCss: opts.inlineCss,\n      })\n    : buildManifestWithClientEntry(opts.base, { inlineCss: opts.inlineCss })\n}\n\nasync function resolveFinalManifest(opts: {\n  getBaseManifest: () => Promise<StartManifestWithClientEntry>\n  transformFn: TransformAssetsFn | undefined\n  cache: boolean\n  inlineCss: boolean\n  finalManifestCache?: FinalManifestCache\n}): Promise<Manifest> {\n  const computeFinalManifest = async () => {\n    return buildFinalManifest({\n      base: await opts.getBaseManifest(),\n      transformFn: opts.transformFn,\n      inlineCss: opts.inlineCss,\n    })\n  }\n\n  if (opts.finalManifestCache && (!opts.transformFn || opts.cache)) {\n    return getOrCreateCachedFinalManifestPromise(\n      opts.finalManifestCache,\n      getFinalManifestCacheKey(opts.inlineCss),\n      computeFinalManifest,\n    )\n  }\n\n  return computeFinalManifest()\n}\n\nfunction warmupFinalManifest(opts: {\n  enabled: boolean\n  handlerDefaultInlineCss: boolean | undefined\n  cache: boolean\n  finalManifestCache: FinalManifestCache\n  getBaseManifest: () => Promise<StartManifestWithClientEntry>\n  getTransformFn: () => Promise<TransformAssetsFn | undefined>\n  onError?: () => void\n}): Promise<Manifest> | undefined {\n  if (\n    !opts.enabled ||\n    opts.handlerDefaultInlineCss === undefined ||\n    !opts.cache\n  ) {\n    return undefined\n  }\n\n  const inlineCss = opts.handlerDefaultInlineCss\n  const warmupPromise = getOrCreateCachedFinalManifestPromise(\n    opts.finalManifestCache,\n    getFinalManifestCacheKey(inlineCss),\n    async () => {\n      const [base, transformFn] = await Promise.all([\n        opts.getBaseManifest(),\n        opts.getTransformFn(),\n      ])\n\n      return buildFinalManifest({\n        base,\n        transformFn,\n        inlineCss,\n      })\n    },\n  )\n\n  if (opts.onError) {\n    void warmupPromise.catch(opts.onError)\n  }\n\n  return warmupPromise\n}\n"],"mappings":"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"}
+{"version":3,"file":"finalManifest.js","names":[],"sources":["../../src/finalManifest.ts"],"sourcesContent":["import {\n  buildManifestWithClientEntry,\n  resolveTransformAssetsConfig,\n  transformManifestAssets,\n} from './transformAssetUrls'\nimport {\n  getStaticHandlerInlineCssDefault,\n  resolveInlineCssForRequest,\n} from './inlineCss'\nimport type { ServerManifest } from '@tanstack/router-core'\nimport type { HandlerInlineCssOption } from './inlineCss'\nimport type {\n  CreateTransformAssetsContext,\n  StartManifestWithClientEntry,\n  TransformAssets,\n  TransformAssetsFn,\n} from './transformAssetUrls'\n\nexport type {\n  HandlerInlineCssOption,\n  StartManifestWithClientEntry,\n  TransformAssets,\n}\n\nexport interface FinalManifestOptions {\n  /**\n   * Controls whether Start inlines build-collected CSS by default at runtime.\n   *\n   * This only has an effect when the build was created with\n   * `server.build.inlineCss` enabled. Pass a callback to decide per request.\n   * `handler(request, { inlineCss })` overrides this value for that request.\n   *\n   * @default true\n   */\n  inlineCss?: HandlerInlineCssOption\n  /**\n   * Transform manifest-managed asset URLs and attributes at runtime, e.g. to\n   * prepend a CDN prefix.\n   *\n   * This covers JS preloads, CSS links, the client entry script, and URLs\n   * inside build-collected inline CSS. Asset imports used directly in\n   * components should be handled by the bundler instead.\n   */\n  transformAssets?: TransformAssets\n}\n\ntype FinalManifestCacheKey = 'inline-css' | 'linked-css'\ntype FinalManifestCache = Map<FinalManifestCacheKey, Promise<ServerManifest>>\nexport type GetBaseManifest = () => Promise<StartManifestWithClientEntry>\n\nexport interface FinalManifestRequestOptions {\n  request: Request\n  requestInlineCss: boolean | undefined\n  getBaseManifest: GetBaseManifest\n}\n\ninterface FinalManifestTransformResolver {\n  cache: boolean\n  warmup: boolean\n  getTransformFn: (\n    ctx: CreateTransformAssetsContext,\n  ) => Promise<TransformAssetsFn | undefined>\n  clearCachedCreateTransform: () => void\n}\n\nexport interface FinalManifestResolver {\n  warmup: (opts: {\n    getBaseManifest: GetBaseManifest\n  }) => Promise<ServerManifest> | undefined\n  resolveCached: (opts: FinalManifestRequestOptions) => Promise<ServerManifest>\n  resolveUncached: (\n    opts: FinalManifestRequestOptions,\n  ) => Promise<ServerManifest>\n}\n\nexport function createCachedBaseManifestLoader(\n  loadBaseManifest: GetBaseManifest,\n): GetBaseManifest {\n  let baseManifestPromise: Promise<StartManifestWithClientEntry> | undefined\n\n  return () => {\n    if (!baseManifestPromise) {\n      baseManifestPromise = loadBaseManifest().catch((error) => {\n        baseManifestPromise = undefined\n        throw error\n      })\n    }\n\n    return baseManifestPromise\n  }\n}\n\nfunction createFinalManifestTransformResolver(\n  transformAssets: TransformAssets | undefined,\n  opts: { cacheCreateTransform: boolean },\n): FinalManifestTransformResolver {\n  const transformConfig =\n    transformAssets !== undefined\n      ? resolveTransformAssetsConfig(transformAssets)\n      : undefined\n  const cache = transformConfig ? transformConfig.cache : true\n  const warmup =\n    !!transformAssets &&\n    typeof transformAssets === 'object' &&\n    'warmup' in transformAssets &&\n    transformAssets.warmup === true\n\n  let cachedCreateTransformPromise: Promise<TransformAssetsFn> | undefined\n\n  const clearCachedCreateTransform = () => {\n    cachedCreateTransformPromise = undefined\n  }\n\n  return {\n    cache,\n    warmup,\n    clearCachedCreateTransform,\n    getTransformFn: async (ctx) => {\n      if (!transformConfig) return undefined\n\n      if (transformConfig.type !== 'createTransform') {\n        return transformConfig.transformFn\n      }\n\n      if (!cache || !opts.cacheCreateTransform) {\n        return transformConfig.createTransform(ctx)\n      }\n\n      if (!cachedCreateTransformPromise) {\n        cachedCreateTransformPromise = Promise.resolve(\n          transformConfig.createTransform(ctx),\n        ).catch((error) => {\n          clearCachedCreateTransform()\n          throw error\n        })\n      }\n\n      return cachedCreateTransformPromise\n    },\n  }\n}\n\nexport function createFinalManifestResolver(\n  opts: FinalManifestOptions & { cacheCreateTransform: boolean },\n): FinalManifestResolver {\n  const finalManifestCache: FinalManifestCache = new Map()\n  const transformResolver = createFinalManifestTransformResolver(\n    opts.transformAssets,\n    { cacheCreateTransform: opts.cacheCreateTransform },\n  )\n  const handlerDefaultInlineCss = getStaticHandlerInlineCssDefault(\n    opts.inlineCss,\n  )\n\n  const getRequestManifestOptions = async (\n    requestOpts: FinalManifestRequestOptions,\n  ) => {\n    const transformFn = await transformResolver.getTransformFn({\n      warmup: false,\n      request: requestOpts.request,\n    })\n    const inlineCss = await resolveInlineCssForRequest({\n      request: requestOpts.request,\n      handlerInlineCss: opts.inlineCss,\n      requestInlineCss: requestOpts.requestInlineCss,\n    })\n\n    return {\n      getBaseManifest: requestOpts.getBaseManifest,\n      transformFn,\n      cache: transformResolver.cache,\n      inlineCss,\n    }\n  }\n\n  const resolveRequest = async (\n    requestOpts: FinalManifestRequestOptions,\n    cache: FinalManifestCache | undefined,\n  ) => {\n    return resolveFinalManifest({\n      ...(await getRequestManifestOptions(requestOpts)),\n      finalManifestCache: cache,\n    })\n  }\n\n  return {\n    warmup: ({ getBaseManifest }) =>\n      warmupFinalManifest({\n        enabled: transformResolver.warmup,\n        handlerDefaultInlineCss,\n        cache: transformResolver.cache,\n        finalManifestCache,\n        getBaseManifest,\n        getTransformFn: () =>\n          transformResolver.getTransformFn({ warmup: true }),\n        onError: transformResolver.clearCachedCreateTransform,\n      }),\n    resolveCached: (requestOpts) =>\n      resolveRequest(requestOpts, finalManifestCache),\n    resolveUncached: (requestOpts) => resolveRequest(requestOpts, undefined),\n  }\n}\n\nfunction getFinalManifestCacheKey(inlineCss: boolean): FinalManifestCacheKey {\n  return inlineCss ? 'inline-css' : 'linked-css'\n}\n\nfunction cacheFinalManifestPromise(\n  cachedFinalManifestPromises: FinalManifestCache,\n  cacheKey: FinalManifestCacheKey,\n  promise: Promise<ServerManifest>,\n): Promise<ServerManifest> {\n  const cachedFinalManifestPromise = promise.catch((error) => {\n    if (\n      cachedFinalManifestPromises.get(cacheKey) === cachedFinalManifestPromise\n    ) {\n      cachedFinalManifestPromises.delete(cacheKey)\n    }\n    throw error\n  })\n\n  cachedFinalManifestPromises.set(cacheKey, cachedFinalManifestPromise)\n  return cachedFinalManifestPromise\n}\n\nfunction getOrCreateCachedFinalManifestPromise(\n  cachedFinalManifestPromises: FinalManifestCache,\n  cacheKey: FinalManifestCacheKey,\n  computeFinalManifest: () => Promise<ServerManifest>,\n): Promise<ServerManifest> {\n  const cachedFinalManifestPromise = cachedFinalManifestPromises.get(cacheKey)\n  if (cachedFinalManifestPromise) {\n    return cachedFinalManifestPromise\n  }\n\n  return cacheFinalManifestPromise(\n    cachedFinalManifestPromises,\n    cacheKey,\n    Promise.resolve().then(computeFinalManifest),\n  )\n}\n\nasync function buildFinalManifest(opts: {\n  base: StartManifestWithClientEntry\n  transformFn: TransformAssetsFn | undefined\n  inlineCss: boolean\n}): Promise<ServerManifest> {\n  return opts.transformFn\n    ? await transformManifestAssets(opts.base, opts.transformFn, {\n        inlineCss: opts.inlineCss,\n      })\n    : buildManifestWithClientEntry(opts.base, { inlineCss: opts.inlineCss })\n}\n\nasync function resolveFinalManifest(opts: {\n  getBaseManifest: () => Promise<StartManifestWithClientEntry>\n  transformFn: TransformAssetsFn | undefined\n  cache: boolean\n  inlineCss: boolean\n  finalManifestCache?: FinalManifestCache\n}): Promise<ServerManifest> {\n  const computeFinalManifest = async () => {\n    return buildFinalManifest({\n      base: await opts.getBaseManifest(),\n      transformFn: opts.transformFn,\n      inlineCss: opts.inlineCss,\n    })\n  }\n\n  if (opts.finalManifestCache && (!opts.transformFn || opts.cache)) {\n    return getOrCreateCachedFinalManifestPromise(\n      opts.finalManifestCache,\n      getFinalManifestCacheKey(opts.inlineCss),\n      computeFinalManifest,\n    )\n  }\n\n  return computeFinalManifest()\n}\n\nfunction warmupFinalManifest(opts: {\n  enabled: boolean\n  handlerDefaultInlineCss: boolean | undefined\n  cache: boolean\n  finalManifestCache: FinalManifestCache\n  getBaseManifest: () => Promise<StartManifestWithClientEntry>\n  getTransformFn: () => Promise<TransformAssetsFn | undefined>\n  onError?: () => void\n}): Promise<ServerManifest> | undefined {\n  if (\n    !opts.enabled ||\n    opts.handlerDefaultInlineCss === undefined ||\n    !opts.cache\n  ) {\n    return undefined\n  }\n\n  const inlineCss = opts.handlerDefaultInlineCss\n  const warmupPromise = getOrCreateCachedFinalManifestPromise(\n    opts.finalManifestCache,\n    getFinalManifestCacheKey(inlineCss),\n    async () => {\n      const [base, transformFn] = await Promise.all([\n        opts.getBaseManifest(),\n        opts.getTransformFn(),\n      ])\n\n      return buildFinalManifest({\n        base,\n        transformFn,\n        inlineCss,\n      })\n    },\n  )\n\n  if (opts.onError) {\n    void warmupPromise.catch(opts.onError)\n  }\n\n  return warmupPromise\n}\n"],"mappings":"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"}

package/dist/esm/request-handler.d.ts

@@ -7,7 +7,8 @@ type EarlyHintsOptions = {
      * Fire-and-forget callback for HTTP 103 Early Hints.
      * Only invoked in production (when TSS_DEV_SERVER !== 'true').
      *
-     * The `static` phase contains transformed manifest assets for matched routes.
+     * The `static` phase contains transformed manifest preloads and stylesheets
+     * for matched routes.
      * The `dynamic` phase runs after route load, is skipped for redirects, and
      * can contain route `head().links` or empty `hints` and `links` arrays.
      * `hints` and `links` contain only values not emitted in earlier phases.

package/dist/esm/router-manifest.js

@@ -1,4 +1,4 @@
-import { buildDevStylesUrl, rootRouteId } from "@tanstack/router-core";
+import { DEV_STYLES_ATTR, buildDevStylesUrl, rootRouteId } from "@tanstack/router-core";
 //#region src/router-manifest.ts
 var DEV_SSR_STYLES_BASEPATH = process.env.TSS_DEV_SSR_STYLES_BASEPATH || "/";
 /**
@@ -16,44 +16,51 @@ var DEV_SSR_STYLES_BASEPATH = process.env.TSS_DEV_SSR_STYLES_BASEPATH || "/";
 async function getStartManifest(matchedRoutes) {
 	const { tsrStartManifest } = await import("tanstack-start-manifest:v");
 	const startManifest = tsrStartManifest();
-	const rootRoute = startManifest.routes[rootRouteId] = startManifest.routes[rootRouteId] || {};
-	rootRoute.assets = rootRoute.assets || [];
+	let routes = startManifest.routes;
+	let rootRoute = routes[rootRouteId];
+	const updateRootRoute = (nextRootRoute) => {
+		rootRoute = nextRootRoute;
+		routes = {
+			...routes,
+			[rootRouteId]: rootRoute
+		};
+	};
 	if (process.env.TSS_DEV_SERVER === "true" && process.env.TSS_DEV_SSR_STYLES_ENABLED !== "false" && matchedRoutes) {
 		const matchedRouteIds = matchedRoutes.map((route) => route.id);
-		rootRoute.assets.push({
-			tag: "link",
-			attrs: {
-				rel: "stylesheet",
+		updateRootRoute({
+			...rootRoute,
+			css: [...rootRoute?.css ?? [], {
 				href: buildDevStylesUrl(DEV_SSR_STYLES_BASEPATH, matchedRouteIds),
-				"data-tanstack-router-dev-styles": "true"
-			}
+				[DEV_STYLES_ATTR]: true
+			}]
 		});
 	}
-	let injectedHeadScripts;
 	if (process.env.TSS_DEV_SERVER === "true") {
 		const mod = await import("tanstack-start-injected-head-scripts:v");
-		if (mod.injectedHeadScripts) injectedHeadScripts = mod.injectedHeadScripts;
+		if (mod.injectedHeadScripts) updateRootRoute({
+			...rootRoute,
+			scripts: [...rootRoute?.scripts ?? [], {
+				attrs: { type: "module" },
+				children: mod.injectedHeadScripts
+			}]
+		});
+	}
+	const manifestRoutes = {};
+	for (const k in routes) {
+		const v = routes[k];
+		const result = {};
+		if (v.preloads && v.preloads.length > 0) result.preloads = v.preloads;
+		if (v.scripts && v.scripts.length > 0) result.scripts = v.scripts;
+		if (v.css?.length) result.css = v.css;
+		if (result.preloads || result.scripts || result.css) manifestRoutes[k] = result;
 	}
 	return {
 		manifest: {
-			inlineCss: startManifest.inlineCss,
-			routes: Object.fromEntries(Object.entries(startManifest.routes).flatMap(([k, v]) => {
-				const result = {};
-				let hasData = false;
-				if (v.preloads && v.preloads.length > 0) {
-					result["preloads"] = v.preloads;
-					hasData = true;
-				}
-				if (v.assets && v.assets.length > 0) {
-					result["assets"] = v.assets;
-					hasData = true;
-				}
-				if (!hasData) return [];
-				return [[k, result]];
-			}))
+			...startManifest.scriptFormat ? { scriptFormat: startManifest.scriptFormat } : {},
+			...startManifest.inlineCss ? { inlineCss: startManifest.inlineCss } : {},
+			routes: manifestRoutes
 		},
-		clientEntry: startManifest.clientEntry,
-		injectedHeadScripts
+		clientEntry: startManifest.clientEntry
 	};
 }
 //#endregion

package/dist/esm/router-manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"router-manifest.js","names":[],"sources":["../../src/router-manifest.ts"],"sourcesContent":["import { buildDevStylesUrl, rootRouteId } from '@tanstack/router-core'\nimport type {\n  AnyRoute,\n  ManifestAssetLink,\n  RouterManagedTag,\n} from '@tanstack/router-core'\nimport type { StartManifestWithClientEntry } from './transformAssetUrls'\n\n// Pre-computed constant for dev styles URL basepath.\n// Defaults to vite `base` (set via TSS_DEV_SSR_STYLES_BASEPATH in the plugin),\n// aligning dev styles with how other CSS/JS assets are served.\nconst DEV_SSR_STYLES_BASEPATH = process.env.TSS_DEV_SSR_STYLES_BASEPATH || '/'\n\n/**\n * @description Returns the router manifest data that should be sent to the client.\n * This includes only the assets and preloads for the current route and any\n * special assets that are needed for the client. It does not include relationships\n * between routes or any other data that is not needed for the client.\n *\n * The client entry URL is returned separately so that it can be transformed\n * (e.g. for CDN rewriting) before being embedded into the `<script>` tag.\n *\n * @param matchedRoutes - In dev mode, the matched routes are used to build\n * the dev styles URL for route-scoped CSS collection.\n */\nexport async function getStartManifest(\n  matchedRoutes?: ReadonlyArray<AnyRoute>,\n): Promise<StartManifestWithClientEntry> {\n  const { tsrStartManifest } = await import('tanstack-start-manifest:v')\n  const startManifest = tsrStartManifest()\n\n  const rootRoute = (startManifest.routes[rootRouteId] =\n    startManifest.routes[rootRouteId] || {})\n\n  rootRoute.assets = rootRoute.assets || []\n\n  // Inject dev styles link in dev mode (when SSR styles are enabled)\n  if (\n    process.env.TSS_DEV_SERVER === 'true' &&\n    process.env.TSS_DEV_SSR_STYLES_ENABLED !== 'false' &&\n    matchedRoutes\n  ) {\n    const matchedRouteIds = matchedRoutes.map((route) => route.id)\n    rootRoute.assets.push({\n      tag: 'link',\n      attrs: {\n        rel: 'stylesheet',\n        href: buildDevStylesUrl(DEV_SSR_STYLES_BASEPATH, matchedRouteIds),\n        'data-tanstack-router-dev-styles': 'true',\n      },\n    })\n  }\n\n  // Collect injected head scripts in dev mode (returned separately so we can\n  // build the client entry script tag after URL transforms are applied)\n  let injectedHeadScripts: string | undefined\n  if (process.env.TSS_DEV_SERVER === 'true') {\n    const mod = await import('tanstack-start-injected-head-scripts:v')\n    if (mod.injectedHeadScripts) {\n      injectedHeadScripts = mod.injectedHeadScripts\n    }\n  }\n\n  const manifest = {\n    inlineCss: startManifest.inlineCss,\n    routes: Object.fromEntries(\n      Object.entries(startManifest.routes).flatMap(([k, v]) => {\n        const result = {} as {\n          preloads?: Array<ManifestAssetLink>\n          assets?: Array<RouterManagedTag>\n        }\n        let hasData = false\n        if (v.preloads && v.preloads.length > 0) {\n          result['preloads'] = v.preloads\n          hasData = true\n        }\n        if (v.assets && v.assets.length > 0) {\n          result['assets'] = v.assets\n          hasData = true\n        }\n        if (!hasData) {\n          return []\n        }\n        return [[k, result]]\n      }),\n    ),\n  }\n\n  return {\n    manifest: manifest as StartManifestWithClientEntry['manifest'],\n    clientEntry: startManifest.clientEntry,\n    injectedHeadScripts,\n  }\n}\n"],"mappings":";;AAWA,IAAM,0BAA0B,QAAQ,IAAI,+BAA+B;;;;;;;;;;;;;AAc3E,eAAsB,iBACpB,eACuC;CACvC,MAAM,EAAE,qBAAqB,MAAM,OAAO;CAC1C,MAAM,gBAAgB,kBAAkB;CAExC,MAAM,YAAa,cAAc,OAAO,eACtC,cAAc,OAAO,gBAAgB,EAAE;AAEzC,WAAU,SAAS,UAAU,UAAU,EAAE;AAGzC,KACE,QAAQ,IAAI,mBAAmB,UAC/B,QAAQ,IAAI,+BAA+B,WAC3C,eACA;EACA,MAAM,kBAAkB,cAAc,KAAK,UAAU,MAAM,GAAG;AAC9D,YAAU,OAAO,KAAK;GACpB,KAAK;GACL,OAAO;IACL,KAAK;IACL,MAAM,kBAAkB,yBAAyB,gBAAgB;IACjE,mCAAmC;IACpC;GACF,CAAC;;CAKJ,IAAI;AACJ,KAAI,QAAQ,IAAI,mBAAmB,QAAQ;EACzC,MAAM,MAAM,MAAM,OAAO;AACzB,MAAI,IAAI,oBACN,uBAAsB,IAAI;;AA6B9B,QAAO;EACK,UA1BK;GACf,WAAW,cAAc;GACzB,QAAQ,OAAO,YACb,OAAO,QAAQ,cAAc,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO;IACvD,MAAM,SAAS,EAAE;IAIjB,IAAI,UAAU;AACd,QAAI,EAAE,YAAY,EAAE,SAAS,SAAS,GAAG;AACvC,YAAO,cAAc,EAAE;AACvB,eAAU;;AAEZ,QAAI,EAAE,UAAU,EAAE,OAAO,SAAS,GAAG;AACnC,YAAO,YAAY,EAAE;AACrB,eAAU;;AAEZ,QAAI,CAAC,QACH,QAAO,EAAE;AAEX,WAAO,CAAC,CAAC,GAAG,OAAO,CAAC;KACpB,CACH;GACF;EAIC,aAAa,cAAc;EAC3B;EACD"}
+{"version":3,"file":"router-manifest.js","names":[],"sources":["../../src/router-manifest.ts"],"sourcesContent":["import {\n  DEV_STYLES_ATTR,\n  buildDevStylesUrl,\n  rootRouteId,\n} from '@tanstack/router-core'\nimport type { AnyRoute, ServerManifestRoute } from '@tanstack/router-core'\nimport type { StartManifestWithClientEntry } from './transformAssetUrls'\n\n// Pre-computed constant for dev styles URL basepath.\n// Defaults to vite `base` (set via TSS_DEV_SSR_STYLES_BASEPATH in the plugin),\n// aligning dev styles with how other CSS/JS assets are served.\nconst DEV_SSR_STYLES_BASEPATH = process.env.TSS_DEV_SSR_STYLES_BASEPATH || '/'\n/**\n * @description Returns the router manifest data that should be sent to the client.\n * This includes only the assets and preloads for the current route and any\n * special assets that are needed for the client. It does not include relationships\n * between routes or any other data that is not needed for the client.\n *\n * The client entry URL is returned separately so that it can be transformed\n * (e.g. for CDN rewriting) before being embedded into the `<script>` tag.\n *\n * @param matchedRoutes - In dev mode, the matched routes are used to build\n * the dev styles URL for route-scoped CSS collection.\n */\nexport async function getStartManifest(\n  matchedRoutes?: ReadonlyArray<AnyRoute>,\n): Promise<StartManifestWithClientEntry> {\n  const { tsrStartManifest } = await import('tanstack-start-manifest:v')\n  const startManifest = tsrStartManifest()\n  let routes = startManifest.routes\n  let rootRoute = routes[rootRouteId]\n\n  const updateRootRoute = (nextRootRoute: ServerManifestRoute) => {\n    rootRoute = nextRootRoute\n    routes = {\n      ...routes,\n      [rootRouteId]: rootRoute,\n    }\n  }\n\n  // Inject dev styles link in dev mode (when SSR styles are enabled)\n  if (\n    process.env.TSS_DEV_SERVER === 'true' &&\n    process.env.TSS_DEV_SSR_STYLES_ENABLED !== 'false' &&\n    matchedRoutes\n  ) {\n    const matchedRouteIds = matchedRoutes.map((route) => route.id)\n    updateRootRoute({\n      ...rootRoute,\n      css: [\n        ...(rootRoute?.css ?? []),\n        {\n          href: buildDevStylesUrl(DEV_SSR_STYLES_BASEPATH, matchedRouteIds),\n          [DEV_STYLES_ATTR]: true,\n        },\n      ],\n    })\n  }\n\n  if (process.env.TSS_DEV_SERVER === 'true') {\n    const mod = await import('tanstack-start-injected-head-scripts:v')\n    if (mod.injectedHeadScripts) {\n      updateRootRoute({\n        ...rootRoute,\n        scripts: [\n          ...(rootRoute?.scripts ?? []),\n          {\n            attrs: {\n              type: 'module',\n            },\n            children: mod.injectedHeadScripts,\n          },\n        ],\n      })\n    }\n  }\n\n  const manifestRoutes: Record<string, ServerManifestRoute> = {}\n\n  for (const k in routes) {\n    const v = routes[k]!\n    const result = {} as ServerManifestRoute\n\n    if (v.preloads && v.preloads.length > 0) {\n      result.preloads = v.preloads\n    }\n    if (v.scripts && v.scripts.length > 0) {\n      result.scripts = v.scripts\n    }\n    if (v.css?.length) {\n      result.css = v.css\n    }\n    if (result.preloads || result.scripts || result.css) {\n      manifestRoutes[k] = result\n    }\n  }\n\n  const manifest = {\n    ...(startManifest.scriptFormat\n      ? { scriptFormat: startManifest.scriptFormat }\n      : {}),\n    ...(startManifest.inlineCss ? { inlineCss: startManifest.inlineCss } : {}),\n    routes: manifestRoutes,\n  }\n\n  return {\n    manifest: manifest as StartManifestWithClientEntry['manifest'],\n    clientEntry: startManifest.clientEntry,\n  }\n}\n"],"mappings":";;AAWA,IAAM,0BAA0B,QAAQ,IAAI,+BAA+B;;;;;;;;;;;;;AAa3E,eAAsB,iBACpB,eACuC;CACvC,MAAM,EAAE,qBAAqB,MAAM,OAAO;CAC1C,MAAM,gBAAgB,kBAAkB;CACxC,IAAI,SAAS,cAAc;CAC3B,IAAI,YAAY,OAAO;CAEvB,MAAM,mBAAmB,kBAAuC;AAC9D,cAAY;AACZ,WAAS;GACP,GAAG;IACF,cAAc;GAChB;;AAIH,KACE,QAAQ,IAAI,mBAAmB,UAC/B,QAAQ,IAAI,+BAA+B,WAC3C,eACA;EACA,MAAM,kBAAkB,cAAc,KAAK,UAAU,MAAM,GAAG;AAC9D,kBAAgB;GACd,GAAG;GACH,KAAK,CACH,GAAI,WAAW,OAAO,EAAE,EACxB;IACE,MAAM,kBAAkB,yBAAyB,gBAAgB;KAChE,kBAAkB;IACpB,CACF;GACF,CAAC;;AAGJ,KAAI,QAAQ,IAAI,mBAAmB,QAAQ;EACzC,MAAM,MAAM,MAAM,OAAO;AACzB,MAAI,IAAI,oBACN,iBAAgB;GACd,GAAG;GACH,SAAS,CACP,GAAI,WAAW,WAAW,EAAE,EAC5B;IACE,OAAO,EACL,MAAM,UACP;IACD,UAAU,IAAI;IACf,CACF;GACF,CAAC;;CAIN,MAAM,iBAAsD,EAAE;AAE9D,MAAK,MAAM,KAAK,QAAQ;EACtB,MAAM,IAAI,OAAO;EACjB,MAAM,SAAS,EAAE;AAEjB,MAAI,EAAE,YAAY,EAAE,SAAS,SAAS,EACpC,QAAO,WAAW,EAAE;AAEtB,MAAI,EAAE,WAAW,EAAE,QAAQ,SAAS,EAClC,QAAO,UAAU,EAAE;AAErB,MAAI,EAAE,KAAK,OACT,QAAO,MAAM,EAAE;AAEjB,MAAI,OAAO,YAAY,OAAO,WAAW,OAAO,IAC9C,gBAAe,KAAK;;AAYxB,QAAO;EACK,UATK;GACf,GAAI,cAAc,eACd,EAAE,cAAc,cAAc,cAAc,GAC5C,EAAE;GACN,GAAI,cAAc,YAAY,EAAE,WAAW,cAAc,WAAW,GAAG,EAAE;GACzE,QAAQ;GACT;EAIC,aAAa,cAAc;EAC5B"}