@tanstack/router-core 1.171.5 → 1.171.7

package/dist/cjs/router.d.cts

@@ -10,7 +10,7 @@ import { AnyContext, AnyRoute, AnyRouteWithContext, LoaderStaleReloadMode, MakeR
 import { FullSearchSchema, RouteById, RoutePaths, RoutesById, RoutesByPath } from './routeInfo.cjs';
 import { AnyRouteMatch, MakeRouteMatchUnion, MatchRouteOptions } from './Matches.cjs';
 import { BuildLocationFn, CommitLocationOptions, NavigateFn } from './RouterProvider.cjs';
-import { Manifest, RouterManagedTag } from './manifest.cjs';
+import { Manifest, ManifestRouteAssets, RouterManagedTag } from './manifest.cjs';
 import { AnySchema } from './validators.cjs';
 import { NavigateOptions, ResolveRelativePath, ToOptions } from './link.cjs';
 import { AnySerializationAdapter, ValidateSerializableInput } from './ssr/serializer/transformer.cjs';
@@ -216,7 +216,7 @@ export interface RouterOptions<TRouteTree extends AnyRoute, TTrailingSlashOption
      * @link [API Docs](https://tanstack.com/router/latest/docs/framework/react/api/router/RouterOptionsType#dehydrate-method)
      * @link [Guide](https://tanstack.com/router/latest/docs/framework/react/guide/external-data-loading#critical-dehydrationhydration)
      */
-    dehydrate?: () => Constrain<TDehydrated, ValidateSerializableInput<Register, TDehydrated>>;
+    dehydrate?: () => Awaitable<Constrain<TDehydrated, ValidateSerializableInput<Register, TDehydrated>>>;
     /**
      * A function that will be called when the router is hydrated.
      *
@@ -505,33 +505,47 @@ export type ClearCacheFn<TRouter extends AnyRouter> = (opts?: {
     filter?: (d: MakeRouteMatchUnion<TRouter>) => boolean;
 }) => void;
 export interface ServerSsr {
-    /**
-     * Injects HTML synchronously into the stream.
-     * Emits an onInjectedHtml event that listeners can handle.
-     * If no subscriber is listening, the HTML is buffered and can be retrieved via takeBufferedHtml().
-     */
+    /** Framework-only: injects router-owned HTML into the SSR stream. */
     injectHtml: (html: string) => void;
-    /**
-     * Injects a script tag synchronously into the stream.
-     */
+    /** Framework-only: injects a router-owned script tag into the SSR stream. */
     injectScript: (script: string) => void;
     isDehydrated: () => boolean;
     isSerializationFinished: () => boolean;
+    /** Framework-only: atomically reserves the pass-through stream path if safe. */
+    reserveStreamFastPath: () => boolean;
+    /** Framework-only. */
+    onInjectedHtml: (listener: () => void) => () => void;
+    /** Framework-only. */
     onRenderFinished: (listener: () => void) => void;
+    /** Framework-only. */
     setRenderFinished: () => void;
+    /** Framework-only. */
     cleanup: () => void;
-    onSerializationFinished: (listener: () => void) => void;
+    /**
+     * Register a listener invoked when the SSR request lifecycle ends (success,
+     * error, abort, or stream lifetime expiry). Use to tear down per-request
+     * resources whose references would otherwise pin the router (e.g. query
+     * cache subscriptions, gcTime timers, abort controllers).
+     *
+     * Listeners run synchronously and exactly once. Errors are caught and logged.
+     */
+    onCleanup: (listener: () => void) => void;
+    /** Framework-only. */
+    onSerializationFinished: (listener: () => void) => () => void;
+    /** Framework-only. */
     dehydrate: (opts?: {
-        requestAssets?: Array<RouterManagedTag>;
+        requestAssets?: ManifestRouteAssets;
     }) => Promise<void>;
+    /** Framework-only. */
     takeBufferedScripts: () => RouterManagedTag | undefined;
-    /**
-     * Takes any buffered HTML that was injected.
-     * Returns the buffered HTML string (which may include multiple script tags) or undefined if empty.
-     */
+    /** Framework-only: takes buffered router-owned HTML. */
     takeBufferedHtml: () => string | undefined;
+    /** Framework-only. */
     liftScriptBarrier: () => void;
 }
+export interface RouterSsrLifecycle {
+    onServerSsrAttach?: Array<(serverSsr: ServerSsr) => void>;
+}
 export type AnyRouterWithContext<TContext> = RouterCore<AnyRouteWithContext<TContext>, any, any, any, any>;
 export type AnyRouter = RouterCore<any, any, any, any, any>;
 export interface ViewTransitionOptions {
@@ -708,6 +722,7 @@ export declare class RouterCore<in out TRouteTree extends AnyRoute, in out TTrai
         manifest: Manifest | undefined;
     };
     serverSsr?: ServerSsr;
+    serverSsrLifecycle?: RouterSsrLifecycle;
     hasNotFoundMatch: () => boolean;
 }
 /** Error thrown when search parameter validation fails. */

package/dist/cjs/scroll-restoration-script/client.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.cjs","names":[],"sources":["../../../src/scroll-restoration-script/client.ts"],"sourcesContent":["import type { AnyRouter } from '../router'\n\nexport function getScrollRestorationScriptForRouter(_router: AnyRouter) {\n  return null\n}\n"],"mappings":";;AAEA,SAAgB,oCAAoC,SAAoB;AACtE,QAAO"}
+{"version":3,"file":"client.cjs","names":[],"sources":["../../../src/scroll-restoration-script/client.ts"],"sourcesContent":["import type { AnyRouter } from '../router'\n\nexport function getScrollRestorationScriptForRouter(_router: AnyRouter) {\n  return null\n}\n"],"mappings":";;AAEA,SAAgB,oCAAoC,SAAoB;CACtE,OAAO;AACT"}

package/dist/cjs/scroll-restoration-script/server.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.cjs","names":[],"sources":["../../../src/scroll-restoration-script/server.ts"],"sourcesContent":["import minifiedScrollRestorationScript from '../scroll-restoration-inline?script-string'\nimport {\n  defaultGetScrollRestorationKey,\n  storageKey,\n} from '../scroll-restoration'\nimport { escapeHtml } from '../utils'\nimport type { AnyRouter } from '../router'\n\nconst defaultInlineScrollRestorationScript = `(${minifiedScrollRestorationScript})(${escapeHtml(\n  JSON.stringify(storageKey),\n)})`\n\nfunction getScrollRestorationScript(key?: string) {\n  if (key === undefined) {\n    return defaultInlineScrollRestorationScript\n  }\n\n  return `(${minifiedScrollRestorationScript})(${escapeHtml(JSON.stringify(storageKey))},${escapeHtml(JSON.stringify(key))})`\n}\n\nexport function getScrollRestorationScriptForRouter(router: AnyRouter) {\n  if (\n    typeof router.options.scrollRestoration === 'function' &&\n    !router.options.scrollRestoration({ location: router.latestLocation })\n  ) {\n    return null\n  }\n\n  const getKey = router.options.getScrollRestorationKey\n  if (!getKey) {\n    return defaultInlineScrollRestorationScript\n  }\n\n  const location = router.latestLocation\n  const userKey = getKey(location)\n  const defaultKey = defaultGetScrollRestorationKey(location)\n\n  if (userKey === defaultKey) {\n    return defaultInlineScrollRestorationScript\n  }\n\n  return getScrollRestorationScript(userKey)\n}\n"],"mappings":";;;;;AAQA,MAAM,uCAAuC,IAAI,kCAAA,QAAgC,IAAI,cAAA,WACnF,KAAK,UAAU,2BAAA,WAAW,CAC3B,CAAC;AAEF,SAAS,2BAA2B,KAAc;AAChD,KAAI,QAAQ,KAAA,EACV,QAAO;AAGT,QAAO,IAAI,kCAAA,QAAgC,IAAI,cAAA,WAAW,KAAK,UAAU,2BAAA,WAAW,CAAC,CAAC,GAAG,cAAA,WAAW,KAAK,UAAU,IAAI,CAAC,CAAC;;AAG3H,SAAgB,oCAAoC,QAAmB;AACrE,KACE,OAAO,OAAO,QAAQ,sBAAsB,cAC5C,CAAC,OAAO,QAAQ,kBAAkB,EAAE,UAAU,OAAO,gBAAgB,CAAC,CAEtE,QAAO;CAGT,MAAM,SAAS,OAAO,QAAQ;AAC9B,KAAI,CAAC,OACH,QAAO;CAGT,MAAM,WAAW,OAAO;CACxB,MAAM,UAAU,OAAO,SAAS;AAGhC,KAAI,YAFe,2BAAA,+BAA+B,SAAS,CAGzD,QAAO;AAGT,QAAO,2BAA2B,QAAQ"}
+{"version":3,"file":"server.cjs","names":[],"sources":["../../../src/scroll-restoration-script/server.ts"],"sourcesContent":["import minifiedScrollRestorationScript from '../scroll-restoration-inline?script-string'\nimport {\n  defaultGetScrollRestorationKey,\n  storageKey,\n} from '../scroll-restoration'\nimport { escapeHtml } from '../utils'\nimport type { AnyRouter } from '../router'\n\nconst defaultInlineScrollRestorationScript = `(${minifiedScrollRestorationScript})(${escapeHtml(\n  JSON.stringify(storageKey),\n)})`\n\nfunction getScrollRestorationScript(key?: string) {\n  if (key === undefined) {\n    return defaultInlineScrollRestorationScript\n  }\n\n  return `(${minifiedScrollRestorationScript})(${escapeHtml(JSON.stringify(storageKey))},${escapeHtml(JSON.stringify(key))})`\n}\n\nexport function getScrollRestorationScriptForRouter(router: AnyRouter) {\n  if (\n    typeof router.options.scrollRestoration === 'function' &&\n    !router.options.scrollRestoration({ location: router.latestLocation })\n  ) {\n    return null\n  }\n\n  const getKey = router.options.getScrollRestorationKey\n  if (!getKey) {\n    return defaultInlineScrollRestorationScript\n  }\n\n  const location = router.latestLocation\n  const userKey = getKey(location)\n  const defaultKey = defaultGetScrollRestorationKey(location)\n\n  if (userKey === defaultKey) {\n    return defaultInlineScrollRestorationScript\n  }\n\n  return getScrollRestorationScript(userKey)\n}\n"],"mappings":";;;;;AAQA,MAAM,uCAAuC,IAAI,kCAAA,QAAgC,IAAI,cAAA,WACnF,KAAK,UAAU,2BAAA,UAAU,CAC3B,EAAE;AAEF,SAAS,2BAA2B,KAAc;CAChD,IAAI,QAAQ,KAAA,GACV,OAAO;CAGT,OAAO,IAAI,kCAAA,QAAgC,IAAI,cAAA,WAAW,KAAK,UAAU,2BAAA,UAAU,CAAC,EAAE,GAAG,cAAA,WAAW,KAAK,UAAU,GAAG,CAAC,EAAE;AAC3H;AAEA,SAAgB,oCAAoC,QAAmB;CACrE,IACE,OAAO,OAAO,QAAQ,sBAAsB,cAC5C,CAAC,OAAO,QAAQ,kBAAkB,EAAE,UAAU,OAAO,eAAe,CAAC,GAErE,OAAO;CAGT,MAAM,SAAS,OAAO,QAAQ;CAC9B,IAAI,CAAC,QACH,OAAO;CAGT,MAAM,WAAW,OAAO;CACxB,MAAM,UAAU,OAAO,QAAQ;CAG/B,IAAI,YAFe,2BAAA,+BAA+B,QAElC,GACd,OAAO;CAGT,OAAO,2BAA2B,OAAO;AAC3C"}

package/dist/cjs/scroll-restoration.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"scroll-restoration.cjs","names":[],"sources":["../../src/scroll-restoration.ts"],"sourcesContent":["import { isServer } from '@tanstack/router-core/isServer'\nimport { locationHistoryActions } from './router'\nimport type { AnyRouter } from './router'\nimport type { ParsedLocation } from './location'\n\nexport type ScrollRestorationEntry = { scrollX: number; scrollY: number }\n\ntype ScrollRestorationByElement = Record<string, ScrollRestorationEntry>\n\ntype ScrollRestorationByKey = Record<string, ScrollRestorationByElement>\n\nexport type ScrollRestorationOptions = {\n  getKey?: (location: ParsedLocation) => string\n  scrollBehavior?: ScrollToOptions['behavior']\n}\n\nfunction getSafeSessionStorage() {\n  try {\n    // Accessing sessionStorage itself can throw SecurityError in locked-down\n    // contexts, e.g. sandboxed/opaque origins or blocked storage policies.\n    return sessionStorage\n  } catch {\n    return\n  }\n}\n\n// SessionStorage key used to store scroll positions across navigations.\nexport const storageKey = 'tsr-scroll-restoration-v1_3'\nconst safeSessionStorage = getSafeSessionStorage()\n\nfunction createScrollRestorationCache() {\n  try {\n    return JSON.parse(\n      safeSessionStorage?.getItem(storageKey) || '{}',\n    ) as ScrollRestorationByKey\n  } catch {\n    // ignore invalid session storage payloads\n    return {}\n  }\n}\n\nfunction persistScrollRestorationCache() {\n  try {\n    safeSessionStorage?.setItem(\n      storageKey,\n      JSON.stringify(scrollRestorationCache),\n    )\n  } catch {\n    if (process.env.NODE_ENV !== 'production') {\n      console.warn(\n        '[ts-router] Could not persist scroll restoration state to sessionStorage.',\n      )\n    }\n  }\n}\n\nconst scrollRestorationCache = /* @__PURE__ */ createScrollRestorationCache()\nconst scrollRestorationIdAttribute = 'data-scroll-restoration-id'\n\n/**\n * The default `getKey` function for `useScrollRestoration`.\n * It returns the `key` from the location state or the `href` of the location.\n *\n * The `location.href` is used as a fallback to support the use case where the location state is not available like the initial render.\n */\nexport const defaultGetScrollRestorationKey = (location: ParsedLocation) => {\n  return location.state.__TSR_key! || location.href\n}\n\nfunction getScrollRestorationSelector(element: Element): string {\n  const attrId = element.getAttribute(scrollRestorationIdAttribute)\n  if (attrId) {\n    return `[${scrollRestorationIdAttribute}=\"${attrId}\"]`\n  }\n\n  let selector = ''\n  let el: any = element\n  let parent: HTMLElement\n\n  while ((parent = el.parentNode)) {\n    let index = 1\n    let sibling = el\n    while ((sibling = sibling.previousElementSibling)) {\n      index++\n    }\n\n    const part = `${el.localName}:nth-child(${index})`\n    selector = selector ? `${part} > ${selector}` : part\n    el = parent\n  }\n\n  return selector\n}\n\nexport function getElementScrollRestorationEntry(\n  router: AnyRouter,\n  options: (\n    | {\n        id: string\n        getElement?: () => Window | Element | undefined | null\n      }\n    | {\n        id?: string\n        getElement: () => Window | Element | undefined | null\n      }\n  ) & {\n    getKey?: (location: ParsedLocation) => string\n  },\n): ScrollRestorationEntry | undefined {\n  const getKey = options.getKey || defaultGetScrollRestorationKey\n  const restoreKey = getKey(router.latestLocation)\n  const entries = scrollRestorationCache[restoreKey]\n\n  if (!entries) {\n    return\n  }\n\n  if (options.id) {\n    return entries[`[${scrollRestorationIdAttribute}=\"${options.id}\"]`]\n  }\n\n  const element = options.getElement?.()\n  if (!element) {\n    return\n  }\n\n  return entries[\n    element === window\n      ? windowScrollTarget\n      : getScrollRestorationSelector(element as Element)\n  ]\n}\n\nlet ignoreScroll = false\nconst windowScrollTarget = 'window'\ntype ScrollTarget = typeof windowScrollTarget | Element\n\nfunction getElement(selector: string | (() => Element | null | undefined)) {\n  try {\n    return typeof selector === 'function'\n      ? selector()\n      : document.querySelector(selector)\n  } catch {}\n  return\n}\n\nfunction getScrollToTopElements(\n  scrollToTopSelectors: NonNullable<\n    AnyRouter['options']['scrollToTopSelectors']\n  >,\n): Array<Element> {\n  const elements: Array<Element> = []\n\n  for (const selector of scrollToTopSelectors) {\n    if (selector === windowScrollTarget) {\n      continue\n    }\n\n    const element = getElement(selector)\n    if (element) {\n      elements.push(element)\n    }\n  }\n\n  return elements\n}\n\nexport function setupScrollRestoration(router: AnyRouter, force?: boolean) {\n  // Keep hash/top scrolling active even when sessionStorage is unavailable.\n\n  if (force ?? router.options.scrollRestoration) {\n    router.isScrollRestoring = true\n  }\n\n  if ((isServer ?? router.isServer) || router.isScrollRestorationSetup) {\n    return\n  }\n\n  router.isScrollRestorationSetup = true\n  ignoreScroll = false\n\n  const getKey =\n    router.options.getScrollRestorationKey || defaultGetScrollRestorationKey\n  const trackedScrollEntries = new Map<ScrollTarget, ScrollRestorationEntry>()\n  const setTrackedScrollEntry = (\n    target: ScrollTarget,\n    scrollX: number,\n    scrollY: number,\n  ) => {\n    const entry =\n      trackedScrollEntries.get(target) || ({} as ScrollRestorationEntry)\n    entry.scrollX = scrollX\n    entry.scrollY = scrollY\n    trackedScrollEntries.set(target, entry)\n  }\n\n  history.scrollRestoration = 'manual'\n\n  const onScroll = (event: Event) => {\n    if (ignoreScroll || !router.isScrollRestoring) {\n      return\n    }\n\n    if (event.target === document) {\n      setTrackedScrollEntry(windowScrollTarget, scrollX, scrollY)\n    } else {\n      const target = event.target as Element\n      setTrackedScrollEntry(target, target.scrollLeft, target.scrollTop)\n    }\n  }\n\n  // Snapshot the current page's tracked scroll targets before navigation or unload.\n  const snapshotCurrentScrollTargets = (restoreKey: string) => {\n    if (!router.isScrollRestoring) {\n      return\n    }\n\n    const keyEntry = (scrollRestorationCache[restoreKey] ||=\n      {} as ScrollRestorationByElement)\n\n    for (const [target, position] of trackedScrollEntries) {\n      if (target === windowScrollTarget) {\n        keyEntry[windowScrollTarget] = position\n      } else if (target.isConnected) {\n        keyEntry[getScrollRestorationSelector(target)] = position\n      }\n    }\n  }\n\n  document.addEventListener('scroll', onScroll, true)\n  router.subscribe('onBeforeLoad', (event) => {\n    if (event.fromLocation) {\n      snapshotCurrentScrollTargets(getKey(event.fromLocation))\n    }\n    trackedScrollEntries.clear()\n  })\n  addEventListener('pagehide', () => {\n    snapshotCurrentScrollTargets(\n      getKey(\n        router.stores.resolvedLocation.get() ?? router.stores.location.get(),\n      ),\n    )\n    persistScrollRestorationCache()\n  })\n\n  // Restore destination scroll after the new route has rendered.\n  router.subscribe('onRendered', (event) => {\n    const behavior = router.options.scrollRestorationBehavior\n    const scrollToTopSelectors = router.options.scrollToTopSelectors\n    const shouldResetScroll = router.resetNextScroll\n    let scrollToTopElements: Array<Element> | undefined\n    trackedScrollEntries.clear()\n\n    if (!shouldResetScroll) {\n      router.resetNextScroll = true\n    }\n\n    if (\n      typeof router.options.scrollRestoration === 'function' &&\n      !router.options.scrollRestoration({ location: router.latestLocation })\n    ) {\n      return\n    }\n\n    const cacheKey = getKey(event.toLocation)\n    const fromCacheKey = event.fromLocation && getKey(event.fromLocation)\n\n    if (router.isScrollRestoring && fromCacheKey && fromCacheKey !== cacheKey) {\n      const fromElementEntries = scrollRestorationCache[fromCacheKey]\n\n      if (fromElementEntries) {\n        let toElementEntries = scrollRestorationCache[cacheKey]\n\n        for (const elementSelector in fromElementEntries) {\n          if (elementSelector === windowScrollTarget) {\n            if (shouldResetScroll) {\n              continue\n            }\n          } else {\n            const element = getElement(elementSelector)\n            if (!element) {\n              continue\n            }\n\n            if (shouldResetScroll && scrollToTopSelectors) {\n              scrollToTopElements ??=\n                getScrollToTopElements(scrollToTopSelectors)\n              if (scrollToTopElements.includes(element)) {\n                continue\n              }\n            }\n          }\n\n          if (!toElementEntries) {\n            toElementEntries = scrollRestorationCache[cacheKey] =\n              {} as ScrollRestorationByElement\n          }\n\n          toElementEntries[elementSelector] ??=\n            fromElementEntries[elementSelector]!\n        }\n      }\n    }\n\n    ignoreScroll = true\n\n    try {\n      const hash = event.toLocation.hash\n      const hashScrollIntoViewOptions =\n        event.toLocation.state.__hashScrollIntoViewOptions ?? true\n      let windowRestored = false\n\n      if (shouldResetScroll) {\n        const action = locationHistoryActions.get(event.toLocation)\n        const skipWindowRestore =\n          hash &&\n          hashScrollIntoViewOptions &&\n          (action === 'PUSH' || action === 'REPLACE')\n\n        const elementEntries = router.isScrollRestoring\n          ? scrollRestorationCache[cacheKey]\n          : undefined\n\n        if (elementEntries) {\n          for (const elementSelector in elementEntries) {\n            const { scrollX, scrollY } = elementEntries[elementSelector]!\n\n            if (elementSelector === windowScrollTarget) {\n              if (skipWindowRestore) {\n                continue\n              }\n\n              scrollTo({\n                top: scrollY,\n                left: scrollX,\n                behavior,\n              })\n              windowRestored = true\n            } else {\n              const element = getElement(elementSelector)\n              if (element) {\n                element.scrollLeft = scrollX\n                element.scrollTop = scrollY\n              }\n            }\n          }\n        }\n\n        if (!windowRestored && !hash) {\n          const scrollOptions = {\n            top: 0,\n            left: 0,\n            behavior,\n          }\n\n          scrollTo(scrollOptions)\n          if (scrollToTopSelectors) {\n            scrollToTopElements ??= getScrollToTopElements(scrollToTopSelectors)\n            for (const element of scrollToTopElements) {\n              element.scrollTo(scrollOptions)\n            }\n          }\n        }\n      }\n\n      if (!windowRestored && hash && hashScrollIntoViewOptions) {\n        document.getElementById(hash)?.scrollIntoView(hashScrollIntoViewOptions)\n      }\n    } finally {\n      ignoreScroll = false\n    }\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"scroll-restoration.cjs","names":[],"sources":["../../src/scroll-restoration.ts"],"sourcesContent":["import { isServer } from '@tanstack/router-core/isServer'\nimport { locationHistoryActions } from './router'\nimport type { AnyRouter } from './router'\nimport type { ParsedLocation } from './location'\n\nexport type ScrollRestorationEntry = { scrollX: number; scrollY: number }\n\ntype ScrollRestorationByElement = Record<string, ScrollRestorationEntry>\n\ntype ScrollRestorationByKey = Record<string, ScrollRestorationByElement>\n\nexport type ScrollRestorationOptions = {\n  getKey?: (location: ParsedLocation) => string\n  scrollBehavior?: ScrollToOptions['behavior']\n}\n\nfunction getSafeSessionStorage() {\n  try {\n    // Accessing sessionStorage itself can throw SecurityError in locked-down\n    // contexts, e.g. sandboxed/opaque origins or blocked storage policies.\n    return sessionStorage\n  } catch {\n    return\n  }\n}\n\n// SessionStorage key used to store scroll positions across navigations.\nexport const storageKey = 'tsr-scroll-restoration-v1_3'\nconst safeSessionStorage = getSafeSessionStorage()\n\nfunction createScrollRestorationCache() {\n  try {\n    return JSON.parse(\n      safeSessionStorage?.getItem(storageKey) || '{}',\n    ) as ScrollRestorationByKey\n  } catch {\n    // ignore invalid session storage payloads\n    return {}\n  }\n}\n\nfunction persistScrollRestorationCache() {\n  try {\n    safeSessionStorage?.setItem(\n      storageKey,\n      JSON.stringify(scrollRestorationCache),\n    )\n  } catch {\n    if (process.env.NODE_ENV !== 'production') {\n      console.warn(\n        '[ts-router] Could not persist scroll restoration state to sessionStorage.',\n      )\n    }\n  }\n}\n\nconst scrollRestorationCache = /* @__PURE__ */ createScrollRestorationCache()\nconst scrollRestorationIdAttribute = 'data-scroll-restoration-id'\n\n/**\n * The default `getKey` function for `useScrollRestoration`.\n * It returns the `key` from the location state or the `href` of the location.\n *\n * The `location.href` is used as a fallback to support the use case where the location state is not available like the initial render.\n */\nexport const defaultGetScrollRestorationKey = (location: ParsedLocation) => {\n  return location.state.__TSR_key! || location.href\n}\n\nfunction getScrollRestorationSelector(element: Element): string {\n  const attrId = element.getAttribute(scrollRestorationIdAttribute)\n  if (attrId) {\n    return `[${scrollRestorationIdAttribute}=\"${attrId}\"]`\n  }\n\n  let selector = ''\n  let el: any = element\n  let parent: HTMLElement\n\n  while ((parent = el.parentNode)) {\n    let index = 1\n    let sibling = el\n    while ((sibling = sibling.previousElementSibling)) {\n      index++\n    }\n\n    const part = `${el.localName}:nth-child(${index})`\n    selector = selector ? `${part} > ${selector}` : part\n    el = parent\n  }\n\n  return selector\n}\n\nexport function getElementScrollRestorationEntry(\n  router: AnyRouter,\n  options: (\n    | {\n        id: string\n        getElement?: () => Window | Element | undefined | null\n      }\n    | {\n        id?: string\n        getElement: () => Window | Element | undefined | null\n      }\n  ) & {\n    getKey?: (location: ParsedLocation) => string\n  },\n): ScrollRestorationEntry | undefined {\n  const getKey = options.getKey || defaultGetScrollRestorationKey\n  const restoreKey = getKey(router.latestLocation)\n  const entries = scrollRestorationCache[restoreKey]\n\n  if (!entries) {\n    return\n  }\n\n  if (options.id) {\n    return entries[`[${scrollRestorationIdAttribute}=\"${options.id}\"]`]\n  }\n\n  const element = options.getElement?.()\n  if (!element) {\n    return\n  }\n\n  return entries[\n    element === window\n      ? windowScrollTarget\n      : getScrollRestorationSelector(element as Element)\n  ]\n}\n\nlet ignoreScroll = false\nconst windowScrollTarget = 'window'\ntype ScrollTarget = typeof windowScrollTarget | Element\n\nfunction getElement(selector: string | (() => Element | null | undefined)) {\n  try {\n    return typeof selector === 'function'\n      ? selector()\n      : document.querySelector(selector)\n  } catch {}\n  return\n}\n\nfunction getScrollToTopElements(\n  scrollToTopSelectors: NonNullable<\n    AnyRouter['options']['scrollToTopSelectors']\n  >,\n): Array<Element> {\n  const elements: Array<Element> = []\n\n  for (const selector of scrollToTopSelectors) {\n    if (selector === windowScrollTarget) {\n      continue\n    }\n\n    const element = getElement(selector)\n    if (element) {\n      elements.push(element)\n    }\n  }\n\n  return elements\n}\n\nexport function setupScrollRestoration(router: AnyRouter, force?: boolean) {\n  // Keep hash/top scrolling active even when sessionStorage is unavailable.\n\n  if (force ?? router.options.scrollRestoration) {\n    router.isScrollRestoring = true\n  }\n\n  if ((isServer ?? router.isServer) || router.isScrollRestorationSetup) {\n    return\n  }\n\n  router.isScrollRestorationSetup = true\n  ignoreScroll = false\n\n  const getKey =\n    router.options.getScrollRestorationKey || defaultGetScrollRestorationKey\n  const trackedScrollEntries = new Map<ScrollTarget, ScrollRestorationEntry>()\n  const setTrackedScrollEntry = (\n    target: ScrollTarget,\n    scrollX: number,\n    scrollY: number,\n  ) => {\n    const entry =\n      trackedScrollEntries.get(target) || ({} as ScrollRestorationEntry)\n    entry.scrollX = scrollX\n    entry.scrollY = scrollY\n    trackedScrollEntries.set(target, entry)\n  }\n\n  history.scrollRestoration = 'manual'\n\n  const onScroll = (event: Event) => {\n    if (ignoreScroll || !router.isScrollRestoring) {\n      return\n    }\n\n    if (event.target === document) {\n      setTrackedScrollEntry(windowScrollTarget, scrollX, scrollY)\n    } else {\n      const target = event.target as Element\n      setTrackedScrollEntry(target, target.scrollLeft, target.scrollTop)\n    }\n  }\n\n  // Snapshot the current page's tracked scroll targets before navigation or unload.\n  const snapshotCurrentScrollTargets = (restoreKey: string) => {\n    if (!router.isScrollRestoring) {\n      return\n    }\n\n    const keyEntry = (scrollRestorationCache[restoreKey] ||=\n      {} as ScrollRestorationByElement)\n\n    for (const [target, position] of trackedScrollEntries) {\n      if (target === windowScrollTarget) {\n        keyEntry[windowScrollTarget] = position\n      } else if (target.isConnected) {\n        keyEntry[getScrollRestorationSelector(target)] = position\n      }\n    }\n  }\n\n  document.addEventListener('scroll', onScroll, true)\n  router.subscribe('onBeforeLoad', (event) => {\n    if (event.fromLocation) {\n      snapshotCurrentScrollTargets(getKey(event.fromLocation))\n    }\n    trackedScrollEntries.clear()\n  })\n  addEventListener('pagehide', () => {\n    snapshotCurrentScrollTargets(\n      getKey(\n        router.stores.resolvedLocation.get() ?? router.stores.location.get(),\n      ),\n    )\n    persistScrollRestorationCache()\n  })\n\n  // Restore destination scroll after the new route has rendered.\n  router.subscribe('onRendered', (event) => {\n    const behavior = router.options.scrollRestorationBehavior\n    const scrollToTopSelectors = router.options.scrollToTopSelectors\n    const shouldResetScroll = router.resetNextScroll\n    let scrollToTopElements: Array<Element> | undefined\n    trackedScrollEntries.clear()\n\n    if (!shouldResetScroll) {\n      router.resetNextScroll = true\n    }\n\n    if (\n      typeof router.options.scrollRestoration === 'function' &&\n      !router.options.scrollRestoration({ location: router.latestLocation })\n    ) {\n      return\n    }\n\n    const cacheKey = getKey(event.toLocation)\n    const fromCacheKey = event.fromLocation && getKey(event.fromLocation)\n\n    if (router.isScrollRestoring && fromCacheKey && fromCacheKey !== cacheKey) {\n      const fromElementEntries = scrollRestorationCache[fromCacheKey]\n\n      if (fromElementEntries) {\n        let toElementEntries = scrollRestorationCache[cacheKey]\n\n        for (const elementSelector in fromElementEntries) {\n          if (elementSelector === windowScrollTarget) {\n            if (shouldResetScroll) {\n              continue\n            }\n          } else {\n            const element = getElement(elementSelector)\n            if (!element) {\n              continue\n            }\n\n            if (shouldResetScroll && scrollToTopSelectors) {\n              scrollToTopElements ??=\n                getScrollToTopElements(scrollToTopSelectors)\n              if (scrollToTopElements.includes(element)) {\n                continue\n              }\n            }\n          }\n\n          if (!toElementEntries) {\n            toElementEntries = scrollRestorationCache[cacheKey] =\n              {} as ScrollRestorationByElement\n          }\n\n          toElementEntries[elementSelector] ??=\n            fromElementEntries[elementSelector]!\n        }\n      }\n    }\n\n    ignoreScroll = true\n\n    try {\n      const hash = event.toLocation.hash\n      const hashScrollIntoViewOptions =\n        event.toLocation.state.__hashScrollIntoViewOptions ?? true\n      let windowRestored = false\n\n      if (shouldResetScroll) {\n        const action = locationHistoryActions.get(event.toLocation)\n        const skipWindowRestore =\n          hash &&\n          hashScrollIntoViewOptions &&\n          (action === 'PUSH' || action === 'REPLACE')\n\n        const elementEntries = router.isScrollRestoring\n          ? scrollRestorationCache[cacheKey]\n          : undefined\n\n        if (elementEntries) {\n          for (const elementSelector in elementEntries) {\n            const { scrollX, scrollY } = elementEntries[elementSelector]!\n\n            if (elementSelector === windowScrollTarget) {\n              if (skipWindowRestore) {\n                continue\n              }\n\n              scrollTo({\n                top: scrollY,\n                left: scrollX,\n                behavior,\n              })\n              windowRestored = true\n            } else {\n              const element = getElement(elementSelector)\n              if (element) {\n                element.scrollLeft = scrollX\n                element.scrollTop = scrollY\n              }\n            }\n          }\n        }\n\n        if (!windowRestored && !hash) {\n          const scrollOptions = {\n            top: 0,\n            left: 0,\n            behavior,\n          }\n\n          scrollTo(scrollOptions)\n          if (scrollToTopSelectors) {\n            scrollToTopElements ??= getScrollToTopElements(scrollToTopSelectors)\n            for (const element of scrollToTopElements) {\n              element.scrollTo(scrollOptions)\n            }\n          }\n        }\n      }\n\n      if (!windowRestored && hash && hashScrollIntoViewOptions) {\n        document.getElementById(hash)?.scrollIntoView(hashScrollIntoViewOptions)\n      }\n    } finally {\n      ignoreScroll = false\n    }\n  })\n}\n"],"mappings":"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"}

package/dist/cjs/searchMiddleware.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"searchMiddleware.cjs","names":[],"sources":["../../src/searchMiddleware.ts"],"sourcesContent":["import { deepEqual } from './utils'\nimport type { NoInfer, PickOptional } from './utils'\nimport type { SearchMiddleware } from './route'\nimport type { IsRequiredParams } from './link'\n\n/**\n * Retain specified search params across navigations.\n *\n * If `keys` is `true`, retain all current params. Otherwise, copy only the\n * listed keys from the current search into the next search.\n *\n * @param keys `true` to retain all, or a list of keys to retain.\n * @returns A search middleware suitable for route `search.middlewares`.\n * @link https://tanstack.com/router/latest/docs/framework/react/api/router/retainSearchParamsFunction\n */\nexport function retainSearchParams<TSearchSchema extends object>(\n  keys: Array<keyof TSearchSchema> | true,\n): SearchMiddleware<TSearchSchema> {\n  return ({ search, next }) => {\n    const result = next(search)\n    if (keys === true) {\n      return { ...search, ...result }\n    }\n    const copy = { ...result }\n    // add missing keys from search to copy\n    keys.forEach((key) => {\n      if (!(key in copy)) {\n        copy[key] = search[key]\n      }\n    })\n    return copy\n  }\n}\n\n/**\n * Remove optional or default-valued search params from navigations.\n *\n * - Pass `true` (only if there are no required search params) to strip all.\n * - Pass an array to always remove those optional keys.\n * - Pass an object of default values; keys equal (deeply) to the defaults are removed.\n *\n * @returns A search middleware suitable for route `search.middlewares`.\n * @link https://tanstack.com/router/latest/docs/framework/react/api/router/stripSearchParamsFunction\n */\nexport function stripSearchParams<\n  TSearchSchema,\n  TOptionalProps = PickOptional<NoInfer<TSearchSchema>>,\n  const TValues =\n    | Partial<NoInfer<TOptionalProps>>\n    | Array<keyof TOptionalProps>,\n  const TInput = IsRequiredParams<TSearchSchema> extends never\n    ? TValues | true\n    : TValues,\n>(input: NoInfer<TInput>): SearchMiddleware<TSearchSchema> {\n  return ({ search, next }) => {\n    if (input === true) {\n      return {}\n    }\n    const result = { ...next(search) } as Record<string, unknown>\n    if (Array.isArray(input)) {\n      input.forEach((key) => {\n        delete result[key]\n      })\n    } else {\n      Object.entries(input as Record<string, unknown>).forEach(\n        ([key, value]) => {\n          if (deepEqual(result[key], value)) {\n            delete result[key]\n          }\n        },\n      )\n    }\n    return result as any\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAeA,SAAgB,mBACd,MACiC;AACjC,SAAQ,EAAE,QAAQ,WAAW;EAC3B,MAAM,SAAS,KAAK,OAAO;AAC3B,MAAI,SAAS,KACX,QAAO;GAAE,GAAG;GAAQ,GAAG;GAAQ;EAEjC,MAAM,OAAO,EAAE,GAAG,QAAQ;AAE1B,OAAK,SAAS,QAAQ;AACpB,OAAI,EAAE,OAAO,MACX,MAAK,OAAO,OAAO;IAErB;AACF,SAAO;;;;;;;;;;;;;AAcX,SAAgB,kBASd,OAAyD;AACzD,SAAQ,EAAE,QAAQ,WAAW;AAC3B,MAAI,UAAU,KACZ,QAAO,EAAE;EAEX,MAAM,SAAS,EAAE,GAAG,KAAK,OAAO,EAAE;AAClC,MAAI,MAAM,QAAQ,MAAM,CACtB,OAAM,SAAS,QAAQ;AACrB,UAAO,OAAO;IACd;MAEF,QAAO,QAAQ,MAAiC,CAAC,SAC9C,CAAC,KAAK,WAAW;AAChB,OAAI,cAAA,UAAU,OAAO,MAAM,MAAM,CAC/B,QAAO,OAAO;IAGnB;AAEH,SAAO"}
+{"version":3,"file":"searchMiddleware.cjs","names":[],"sources":["../../src/searchMiddleware.ts"],"sourcesContent":["import { deepEqual } from './utils'\nimport type { NoInfer, PickOptional } from './utils'\nimport type { SearchMiddleware } from './route'\nimport type { IsRequiredParams } from './link'\n\n/**\n * Retain specified search params across navigations.\n *\n * If `keys` is `true`, retain all current params. Otherwise, copy only the\n * listed keys from the current search into the next search.\n *\n * @param keys `true` to retain all, or a list of keys to retain.\n * @returns A search middleware suitable for route `search.middlewares`.\n * @link https://tanstack.com/router/latest/docs/framework/react/api/router/retainSearchParamsFunction\n */\nexport function retainSearchParams<TSearchSchema extends object>(\n  keys: Array<keyof TSearchSchema> | true,\n): SearchMiddleware<TSearchSchema> {\n  return ({ search, next }) => {\n    const result = next(search)\n    if (keys === true) {\n      return { ...search, ...result }\n    }\n    const copy = { ...result }\n    // add missing keys from search to copy\n    keys.forEach((key) => {\n      if (!(key in copy)) {\n        copy[key] = search[key]\n      }\n    })\n    return copy\n  }\n}\n\n/**\n * Remove optional or default-valued search params from navigations.\n *\n * - Pass `true` (only if there are no required search params) to strip all.\n * - Pass an array to always remove those optional keys.\n * - Pass an object of default values; keys equal (deeply) to the defaults are removed.\n *\n * @returns A search middleware suitable for route `search.middlewares`.\n * @link https://tanstack.com/router/latest/docs/framework/react/api/router/stripSearchParamsFunction\n */\nexport function stripSearchParams<\n  TSearchSchema,\n  TOptionalProps = PickOptional<NoInfer<TSearchSchema>>,\n  const TValues =\n    | Partial<NoInfer<TOptionalProps>>\n    | Array<keyof TOptionalProps>,\n  const TInput = IsRequiredParams<TSearchSchema> extends never\n    ? TValues | true\n    : TValues,\n>(input: NoInfer<TInput>): SearchMiddleware<TSearchSchema> {\n  return ({ search, next }) => {\n    if (input === true) {\n      return {}\n    }\n    const result = { ...next(search) } as Record<string, unknown>\n    if (Array.isArray(input)) {\n      input.forEach((key) => {\n        delete result[key]\n      })\n    } else {\n      Object.entries(input as Record<string, unknown>).forEach(\n        ([key, value]) => {\n          if (deepEqual(result[key], value)) {\n            delete result[key]\n          }\n        },\n      )\n    }\n    return result as any\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAeA,SAAgB,mBACd,MACiC;CACjC,QAAQ,EAAE,QAAQ,WAAW;EAC3B,MAAM,SAAS,KAAK,MAAM;EAC1B,IAAI,SAAS,MACX,OAAO;GAAE,GAAG;GAAQ,GAAG;EAAO;EAEhC,MAAM,OAAO,EAAE,GAAG,OAAO;EAEzB,KAAK,SAAS,QAAQ;GACpB,IAAI,EAAE,OAAO,OACX,KAAK,OAAO,OAAO;EAEvB,CAAC;EACD,OAAO;CACT;AACF;;;;;;;;;;;AAYA,SAAgB,kBASd,OAAyD;CACzD,QAAQ,EAAE,QAAQ,WAAW;EAC3B,IAAI,UAAU,MACZ,OAAO,CAAC;EAEV,MAAM,SAAS,EAAE,GAAG,KAAK,MAAM,EAAE;EACjC,IAAI,MAAM,QAAQ,KAAK,GACrB,MAAM,SAAS,QAAQ;GACrB,OAAO,OAAO;EAChB,CAAC;OAED,OAAO,QAAQ,KAAgC,EAAE,SAC9C,CAAC,KAAK,WAAW;GAChB,IAAI,cAAA,UAAU,OAAO,MAAM,KAAK,GAC9B,OAAO,OAAO;EAElB,CACF;EAEF,OAAO;CACT;AACF"}

package/dist/cjs/searchParams.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"searchParams.cjs","names":[],"sources":["../../src/searchParams.ts"],"sourcesContent":["import { decode, encode } from './qss'\nimport type { AnySchema } from './validators'\n\n/** Default `parseSearch` that strips leading '?' and JSON-parses values. */\nexport const defaultParseSearch = parseSearchWith(JSON.parse)\n/** Default `stringifySearch` using JSON.stringify for complex values. */\nexport const defaultStringifySearch = stringifySearchWith(\n  JSON.stringify,\n  JSON.parse,\n)\n\n/**\n * Build a `parseSearch` function using a provided JSON-like parser.\n *\n * The returned function strips a leading `?`, decodes values, and attempts to\n * JSON-parse string values using the given `parser`.\n *\n * @param parser Function to parse a string value (e.g. `JSON.parse`).\n * @returns A `parseSearch` function compatible with `Router` options.\n * @link https://tanstack.com/router/latest/docs/framework/react/guide/custom-search-param-serialization\n */\nexport function parseSearchWith(parser: (str: string) => any) {\n  return (searchStr: string): AnySchema => {\n    if (searchStr[0] === '?') {\n      searchStr = searchStr.substring(1)\n    }\n\n    const query: Record<string, unknown> = decode(searchStr)\n\n    // Try to parse any query params that might be json\n    for (const key in query) {\n      const value = query[key]\n      if (typeof value === 'string') {\n        try {\n          query[key] = parser(value)\n        } catch (_err) {\n          // silent\n        }\n      }\n    }\n\n    return query\n  }\n}\n\n/**\n * Build a `stringifySearch` function using a provided serializer.\n *\n * Non-primitive values are serialized with `stringify`. If a `parser` is\n * supplied, string values that are parseable are re-serialized to ensure\n * symmetry with `parseSearch`.\n *\n * @param stringify Function to serialize a value (e.g. `JSON.stringify`).\n * @param parser Optional parser to detect parseable strings.\n * @returns A `stringifySearch` function compatible with `Router` options.\n * @link https://tanstack.com/router/latest/docs/framework/react/guide/custom-search-param-serialization\n */\nexport function stringifySearchWith(\n  stringify: (search: any) => string,\n  parser?: (str: string) => any,\n) {\n  const hasParser = typeof parser === 'function'\n  function stringifyValue(val: any) {\n    if (typeof val === 'object' && val !== null) {\n      try {\n        return stringify(val)\n      } catch (_err) {\n        // silent\n      }\n    } else if (hasParser && typeof val === 'string') {\n      try {\n        // Check if it's a valid parseable string.\n        // If it is, then stringify it again.\n        parser(val)\n        return stringify(val)\n      } catch (_err) {\n        // silent\n      }\n    }\n    return val\n  }\n\n  return (search: Record<string, any>) => {\n    const searchStr = encode(search, stringifyValue)\n    return searchStr ? `?${searchStr}` : ''\n  }\n}\n\nexport type SearchSerializer = (searchObj: Record<string, any>) => string\nexport type SearchParser = (searchStr: string) => Record<string, any>\n"],"mappings":";;;AAIA,MAAa,qBAAqB,gBAAgB,KAAK,MAAM;;AAE7D,MAAa,yBAAyB,oBACpC,KAAK,WACL,KAAK,MACN;;;;;;;;;;;AAYD,SAAgB,gBAAgB,QAA8B;AAC5D,SAAQ,cAAiC;AACvC,MAAI,UAAU,OAAO,IACnB,aAAY,UAAU,UAAU,EAAE;EAGpC,MAAM,QAAiC,YAAA,OAAO,UAAU;AAGxD,OAAK,MAAM,OAAO,OAAO;GACvB,MAAM,QAAQ,MAAM;AACpB,OAAI,OAAO,UAAU,SACnB,KAAI;AACF,UAAM,OAAO,OAAO,MAAM;YACnB,MAAM;;AAMnB,SAAO;;;;;;;;;;;;;;;AAgBX,SAAgB,oBACd,WACA,QACA;CACA,MAAM,YAAY,OAAO,WAAW;CACpC,SAAS,eAAe,KAAU;AAChC,MAAI,OAAO,QAAQ,YAAY,QAAQ,KACrC,KAAI;AACF,UAAO,UAAU,IAAI;WACd,MAAM;WAGN,aAAa,OAAO,QAAQ,SACrC,KAAI;AAGF,UAAO,IAAI;AACX,UAAO,UAAU,IAAI;WACd,MAAM;AAIjB,SAAO;;AAGT,SAAQ,WAAgC;EACtC,MAAM,YAAY,YAAA,OAAO,QAAQ,eAAe;AAChD,SAAO,YAAY,IAAI,cAAc"}
+{"version":3,"file":"searchParams.cjs","names":[],"sources":["../../src/searchParams.ts"],"sourcesContent":["import { decode, encode } from './qss'\nimport type { AnySchema } from './validators'\n\n/** Default `parseSearch` that strips leading '?' and JSON-parses values. */\nexport const defaultParseSearch = parseSearchWith(JSON.parse)\n/** Default `stringifySearch` using JSON.stringify for complex values. */\nexport const defaultStringifySearch = stringifySearchWith(\n  JSON.stringify,\n  JSON.parse,\n)\n\n/**\n * Build a `parseSearch` function using a provided JSON-like parser.\n *\n * The returned function strips a leading `?`, decodes values, and attempts to\n * JSON-parse string values using the given `parser`.\n *\n * @param parser Function to parse a string value (e.g. `JSON.parse`).\n * @returns A `parseSearch` function compatible with `Router` options.\n * @link https://tanstack.com/router/latest/docs/framework/react/guide/custom-search-param-serialization\n */\nexport function parseSearchWith(parser: (str: string) => any) {\n  return (searchStr: string): AnySchema => {\n    if (searchStr[0] === '?') {\n      searchStr = searchStr.substring(1)\n    }\n\n    const query: Record<string, unknown> = decode(searchStr)\n\n    // Try to parse any query params that might be json\n    for (const key in query) {\n      const value = query[key]\n      if (typeof value === 'string') {\n        try {\n          query[key] = parser(value)\n        } catch (_err) {\n          // silent\n        }\n      }\n    }\n\n    return query\n  }\n}\n\n/**\n * Build a `stringifySearch` function using a provided serializer.\n *\n * Non-primitive values are serialized with `stringify`. If a `parser` is\n * supplied, string values that are parseable are re-serialized to ensure\n * symmetry with `parseSearch`.\n *\n * @param stringify Function to serialize a value (e.g. `JSON.stringify`).\n * @param parser Optional parser to detect parseable strings.\n * @returns A `stringifySearch` function compatible with `Router` options.\n * @link https://tanstack.com/router/latest/docs/framework/react/guide/custom-search-param-serialization\n */\nexport function stringifySearchWith(\n  stringify: (search: any) => string,\n  parser?: (str: string) => any,\n) {\n  const hasParser = typeof parser === 'function'\n  function stringifyValue(val: any) {\n    if (typeof val === 'object' && val !== null) {\n      try {\n        return stringify(val)\n      } catch (_err) {\n        // silent\n      }\n    } else if (hasParser && typeof val === 'string') {\n      try {\n        // Check if it's a valid parseable string.\n        // If it is, then stringify it again.\n        parser(val)\n        return stringify(val)\n      } catch (_err) {\n        // silent\n      }\n    }\n    return val\n  }\n\n  return (search: Record<string, any>) => {\n    const searchStr = encode(search, stringifyValue)\n    return searchStr ? `?${searchStr}` : ''\n  }\n}\n\nexport type SearchSerializer = (searchObj: Record<string, any>) => string\nexport type SearchParser = (searchStr: string) => Record<string, any>\n"],"mappings":";;;AAIA,MAAa,qBAAqB,gBAAgB,KAAK,KAAK;;AAE5D,MAAa,yBAAyB,oBACpC,KAAK,WACL,KAAK,KACP;;;;;;;;;;;AAYA,SAAgB,gBAAgB,QAA8B;CAC5D,QAAQ,cAAiC;EACvC,IAAI,UAAU,OAAO,KACnB,YAAY,UAAU,UAAU,CAAC;EAGnC,MAAM,QAAiC,YAAA,OAAO,SAAS;EAGvD,KAAK,MAAM,OAAO,OAAO;GACvB,MAAM,QAAQ,MAAM;GACpB,IAAI,OAAO,UAAU,UACnB,IAAI;IACF,MAAM,OAAO,OAAO,KAAK;GAC3B,SAAS,MAAM,CAEf;EAEJ;EAEA,OAAO;CACT;AACF;;;;;;;;;;;;;AAcA,SAAgB,oBACd,WACA,QACA;CACA,MAAM,YAAY,OAAO,WAAW;CACpC,SAAS,eAAe,KAAU;EAChC,IAAI,OAAO,QAAQ,YAAY,QAAQ,MACrC,IAAI;GACF,OAAO,UAAU,GAAG;EACtB,SAAS,MAAM,CAEf;OACK,IAAI,aAAa,OAAO,QAAQ,UACrC,IAAI;GAGF,OAAO,GAAG;GACV,OAAO,UAAU,GAAG;EACtB,SAAS,MAAM,CAEf;EAEF,OAAO;CACT;CAEA,QAAQ,WAAgC;EACtC,MAAM,YAAY,YAAA,OAAO,QAAQ,cAAc;EAC/C,OAAO,YAAY,IAAI,cAAc;CACvC;AACF"}

package/dist/cjs/ssr/createRequestHandler.cjs

@@ -1,11 +1,12 @@
 const require_headers = require("./headers.cjs");
 const require_ssr_server = require("./ssr-server.cjs");
+const require_handlerCallback = require("./handlerCallback.cjs");
 let _tanstack_history = require("@tanstack/history");
 //#region src/ssr/createRequestHandler.ts
 function createRequestHandler({ createRouter, request, getRouterManifest }) {
 	return async (cb) => {
 		const router = createRouter();
-		let cbWillCleanup = false;
+		let responseOwnsCleanup = false;
 		try {
 			require_ssr_server.attachRouterServerSsrUtils({
 				router,
@@ -20,20 +21,21 @@ function createRequestHandler({ createRouter, request, getRouterManifest }) {
 			});
 			await router.load();
 			await router.serverSsr?.dehydrate();
-			const responseHeaders = getRequestHeaders({ router });
-			cbWillCleanup = true;
-			return cb({
+			const ssrResponse = require_handlerCallback.normalizeSsrResponse(await cb({
 				request,
 				router,
-				responseHeaders
-			});
+				responseHeaders: getRequestHeaders({ router })
+			}));
+			responseOwnsCleanup = ssrResponse.serverSsrCleanup === "stream";
+			return ssrResponse.response;
 		} finally {
-			if (!cbWillCleanup) router.serverSsr?.cleanup();
+			if (!responseOwnsCleanup) router.serverSsr?.cleanup();
 		}
 	};
 }
 function getRequestHeaders(opts) {
-	const matchHeaders = opts.router.stores.matches.get().map((match) => match.headers);
+	const matchHeaders = [];
+	for (const match of opts.router.stores.matches.get()) matchHeaders.push(match.headers);
 	const redirect = opts.router.stores.redirect.get();
 	if (redirect) matchHeaders.push(redirect.headers);
 	return require_headers.mergeHeaders({ "Content-Type": "text/html; charset=UTF-8" }, ...matchHeaders);

package/dist/cjs/ssr/createRequestHandler.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"createRequestHandler.cjs","names":[],"sources":["../../../src/ssr/createRequestHandler.ts"],"sourcesContent":["import { createMemoryHistory } from '@tanstack/history'\nimport { mergeHeaders } from './headers'\nimport {\n  attachRouterServerSsrUtils,\n  getNormalizedURL,\n  getOrigin,\n} from './ssr-server'\nimport type { HandlerCallback } from './handlerCallback'\nimport type { AnyHeaders } from './headers'\nimport type { AnyRouter } from '../router'\nimport type { Manifest } from '../manifest'\n\nexport type RequestHandler<TRouter extends AnyRouter> = (\n  cb: HandlerCallback<TRouter>,\n) => Promise<Response>\n\nexport function createRequestHandler<TRouter extends AnyRouter>({\n  createRouter,\n  request,\n  getRouterManifest,\n}: {\n  createRouter: () => TRouter\n  request: Request\n  getRouterManifest?: () => Manifest | Promise<Manifest>\n}): RequestHandler<TRouter> {\n  return async (cb) => {\n    const router = createRouter()\n    // Track whether the callback will handle cleanup\n    let cbWillCleanup = false\n\n    try {\n      attachRouterServerSsrUtils({\n        router,\n        manifest: await getRouterManifest?.(),\n      })\n\n      // normalizing and sanitizing the pathname here for server, so we always deal with the same format during SSR.\n      const { url } = getNormalizedURL(request.url, 'http://localhost')\n      const origin = getOrigin(request)\n      const href = url.href.replace(url.origin, '')\n\n      // Create a history for the router\n      const history = createMemoryHistory({\n        initialEntries: [href],\n      })\n\n      // Update the router with the history and context\n      router.update({\n        history,\n        origin: router.options.origin ?? origin,\n      })\n\n      await router.load()\n\n      await router.serverSsr?.dehydrate()\n\n      const responseHeaders = getRequestHeaders({\n        router,\n      })\n\n      // Mark that the callback will handle cleanup\n      cbWillCleanup = true\n      return cb({\n        request,\n        router,\n        responseHeaders,\n      })\n    } finally {\n      if (!cbWillCleanup) {\n        // Clean up router SSR state if the callback won't handle it\n        // (e.g., if an error occurred before the callback was 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    }\n  }\n}\n\nfunction getRequestHeaders(opts: { router: AnyRouter }): Headers {\n  const matchHeaders = opts.router.stores.matches\n    .get()\n    .map<AnyHeaders>((match) => match.headers)\n\n  // Handle Redirects\n  const redirect = opts.router.stores.redirect.get()\n  if (redirect) {\n    matchHeaders.push(redirect.headers)\n  }\n\n  return mergeHeaders(\n    {\n      'Content-Type': 'text/html; charset=UTF-8',\n    },\n    ...matchHeaders,\n  )\n}\n"],"mappings":";;;;AAgBA,SAAgB,qBAAgD,EAC9D,cACA,SACA,qBAK0B;AAC1B,QAAO,OAAO,OAAO;EACnB,MAAM,SAAS,cAAc;EAE7B,IAAI,gBAAgB;AAEpB,MAAI;AACF,sBAAA,2BAA2B;IACzB;IACA,UAAU,MAAM,qBAAqB;IACtC,CAAC;GAGF,MAAM,EAAE,QAAQ,mBAAA,iBAAiB,QAAQ,KAAK,mBAAmB;GACjE,MAAM,SAAS,mBAAA,UAAU,QAAQ;GAIjC,MAAM,WAAA,GAAA,kBAAA,qBAA8B,EAClC,gBAAgB,CAJL,IAAI,KAAK,QAAQ,IAAI,QAAQ,GAAG,CAIrB,EACvB,CAAC;AAGF,UAAO,OAAO;IACZ;IACA,QAAQ,OAAO,QAAQ,UAAU;IAClC,CAAC;AAEF,SAAM,OAAO,MAAM;AAEnB,SAAM,OAAO,WAAW,WAAW;GAEnC,MAAM,kBAAkB,kBAAkB,EACxC,QACD,CAAC;AAGF,mBAAgB;AAChB,UAAO,GAAG;IACR;IACA;IACA;IACD,CAAC;YACM;AACR,OAAI,CAAC,cAKH,QAAO,WAAW,SAAS;;;;AAMnC,SAAS,kBAAkB,MAAsC;CAC/D,MAAM,eAAe,KAAK,OAAO,OAAO,QACrC,KAAK,CACL,KAAiB,UAAU,MAAM,QAAQ;CAG5C,MAAM,WAAW,KAAK,OAAO,OAAO,SAAS,KAAK;AAClD,KAAI,SACF,cAAa,KAAK,SAAS,QAAQ;AAGrC,QAAO,gBAAA,aACL,EACE,gBAAgB,4BACjB,EACD,GAAG,aACJ"}
+{"version":3,"file":"createRequestHandler.cjs","names":[],"sources":["../../../src/ssr/createRequestHandler.ts"],"sourcesContent":["import { createMemoryHistory } from '@tanstack/history'\nimport { mergeHeaders } from './headers'\nimport {\n  attachRouterServerSsrUtils,\n  getNormalizedURL,\n  getOrigin,\n} from './ssr-server'\nimport { normalizeSsrResponse } from './handlerCallback'\nimport type { HandlerCallback } from './handlerCallback'\nimport type { AnyHeaders } from './headers'\nimport type { AnyRouter } from '../router'\nimport type { ServerManifest } from '../manifest'\n\nexport type RequestHandler<TRouter extends AnyRouter> = (\n  cb: HandlerCallback<TRouter>,\n) => Promise<Response>\n\nexport function createRequestHandler<TRouter extends AnyRouter>({\n  createRouter,\n  request,\n  getRouterManifest,\n}: {\n  createRouter: () => TRouter\n  request: Request\n  getRouterManifest?: () => ServerManifest | Promise<ServerManifest>\n}): RequestHandler<TRouter> {\n  return async (cb) => {\n    const router = createRouter()\n    let responseOwnsCleanup = false\n\n    try {\n      attachRouterServerSsrUtils({\n        router,\n        manifest: await getRouterManifest?.(),\n      })\n\n      // normalizing and sanitizing the pathname here for server, so we always deal with the same format during SSR.\n      const { url } = getNormalizedURL(request.url, 'http://localhost')\n      const origin = getOrigin(request)\n      const href = url.href.replace(url.origin, '')\n\n      // Create a history for the router\n      const history = createMemoryHistory({\n        initialEntries: [href],\n      })\n\n      // Update the router with the history and context\n      router.update({\n        history,\n        origin: router.options.origin ?? origin,\n      })\n\n      await router.load()\n\n      await router.serverSsr?.dehydrate()\n\n      const responseHeaders = getRequestHeaders({\n        router,\n      })\n\n      const response = await cb({\n        request,\n        router,\n        responseHeaders,\n      })\n      const ssrResponse = normalizeSsrResponse(response)\n      responseOwnsCleanup = ssrResponse.serverSsrCleanup === 'stream'\n      return ssrResponse.response\n    } finally {\n      if (!responseOwnsCleanup) {\n        // Clean up router SSR state if the callback won't handle it\n        // (e.g., if an error occurred before the callback was invoked).\n        // Transformed streaming response bodies clean up when consumed/cancelled.\n        router.serverSsr?.cleanup()\n      }\n    }\n  }\n}\n\nfunction getRequestHeaders(opts: { router: AnyRouter }): Headers {\n  const matchHeaders: Array<AnyHeaders> = []\n  for (const match of opts.router.stores.matches.get()) {\n    matchHeaders.push(match.headers)\n  }\n\n  // Handle Redirects\n  const redirect = opts.router.stores.redirect.get()\n  if (redirect) {\n    matchHeaders.push(redirect.headers)\n  }\n\n  return mergeHeaders(\n    {\n      'Content-Type': 'text/html; charset=UTF-8',\n    },\n    ...matchHeaders,\n  )\n}\n"],"mappings":";;;;;AAiBA,SAAgB,qBAAgD,EAC9D,cACA,SACA,qBAK0B;CAC1B,OAAO,OAAO,OAAO;EACnB,MAAM,SAAS,aAAa;EAC5B,IAAI,sBAAsB;EAE1B,IAAI;GACF,mBAAA,2BAA2B;IACzB;IACA,UAAU,MAAM,oBAAoB;GACtC,CAAC;GAGD,MAAM,EAAE,QAAQ,mBAAA,iBAAiB,QAAQ,KAAK,kBAAkB;GAChE,MAAM,SAAS,mBAAA,UAAU,OAAO;GAIhC,MAAM,WAAA,GAAA,kBAAA,qBAA8B,EAClC,gBAAgB,CAJL,IAAI,KAAK,QAAQ,IAAI,QAAQ,EAIvB,CAAI,EACvB,CAAC;GAGD,OAAO,OAAO;IACZ;IACA,QAAQ,OAAO,QAAQ,UAAU;GACnC,CAAC;GAED,MAAM,OAAO,KAAK;GAElB,MAAM,OAAO,WAAW,UAAU;GAWlC,MAAM,cAAc,wBAAA,qBAAqB,MALlB,GAAG;IACxB;IACA;IACA,iBAPsB,kBAAkB,EACxC,OACF,CAKE;GACF,CAAC,CACgD;GACjD,sBAAsB,YAAY,qBAAqB;GACvD,OAAO,YAAY;EACrB,UAAU;GACR,IAAI,CAAC,qBAIH,OAAO,WAAW,QAAQ;EAE9B;CACF;AACF;AAEA,SAAS,kBAAkB,MAAsC;CAC/D,MAAM,eAAkC,CAAC;CACzC,KAAK,MAAM,SAAS,KAAK,OAAO,OAAO,QAAQ,IAAI,GACjD,aAAa,KAAK,MAAM,OAAO;CAIjC,MAAM,WAAW,KAAK,OAAO,OAAO,SAAS,IAAI;CACjD,IAAI,UACF,aAAa,KAAK,SAAS,OAAO;CAGpC,OAAO,gBAAA,aACL,EACE,gBAAgB,2BAClB,GACA,GAAG,YACL;AACF"}

package/dist/cjs/ssr/createRequestHandler.d.cts

@@ -1,9 +1,9 @@
 import { HandlerCallback } from './handlerCallback.cjs';
 import { AnyRouter } from '../router.cjs';
-import { Manifest } from '../manifest.cjs';
+import { ServerManifest } from '../manifest.cjs';
 export type RequestHandler<TRouter extends AnyRouter> = (cb: HandlerCallback<TRouter>) => Promise<Response>;
 export declare function createRequestHandler<TRouter extends AnyRouter>({ createRouter, request, getRouterManifest, }: {
     createRouter: () => TRouter;
     request: Request;
-    getRouterManifest?: () => Manifest | Promise<Manifest>;
+    getRouterManifest?: () => ServerManifest | Promise<ServerManifest>;
 }): RequestHandler<TRouter>;

package/dist/cjs/ssr/handlerCallback.cjs

@@ -1,8 +1,54 @@
 //#region src/ssr/handlerCallback.ts
+function isSsrResponse(value) {
+	return typeof value === "object" && value !== null && "response" in value && "serverSsrCleanup" in value;
+}
+function normalizeSsrResponse(result) {
+	return isSsrResponse(result) ? result : {
+		response: result,
+		serverSsrCleanup: "none"
+	};
+}
+function createSsrStreamResponse(router, response) {
+	if (!response.body) throw new Error("Invariant failed: SSR stream response requires a body");
+	let disposed = false;
+	return {
+		response,
+		serverSsrCleanup: "stream",
+		async dispose(reason) {
+			if (disposed) return;
+			disposed = true;
+			try {
+				await response.body.cancel(reason);
+			} catch {}
+			router.serverSsr?.cleanup();
+		}
+	};
+}
+async function replaceSsrResponse(result, response, reason) {
+	const ssrResponse = normalizeSsrResponse(result);
+	if (ssrResponse.serverSsrCleanup === "stream") await ssrResponse.dispose(reason);
+	return {
+		response,
+		serverSsrCleanup: "none"
+	};
+}
+async function stripSsrResponseBody(result, reason) {
+	const ssrResponse = normalizeSsrResponse(result);
+	if (ssrResponse.serverSsrCleanup === "stream") await ssrResponse.dispose(reason);
+	return {
+		response: new Response(null, ssrResponse.response),
+		serverSsrCleanup: "none"
+	};
+}
 function defineHandlerCallback(handler) {
 	return handler;
 }
 //#endregion
+exports.createSsrStreamResponse = createSsrStreamResponse;
 exports.defineHandlerCallback = defineHandlerCallback;
+exports.isSsrResponse = isSsrResponse;
+exports.normalizeSsrResponse = normalizeSsrResponse;
+exports.replaceSsrResponse = replaceSsrResponse;
+exports.stripSsrResponseBody = stripSsrResponseBody;
 
 //# sourceMappingURL=handlerCallback.cjs.map

package/dist/cjs/ssr/handlerCallback.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"handlerCallback.cjs","names":[],"sources":["../../../src/ssr/handlerCallback.ts"],"sourcesContent":["import type { AnyRouter } from '../router'\n\nexport interface HandlerCallback<TRouter extends AnyRouter> {\n  (ctx: {\n    request: Request\n    router: TRouter\n    responseHeaders: Headers\n  }): Response | Promise<Response>\n}\n\nexport function defineHandlerCallback<TRouter extends AnyRouter>(\n  handler: HandlerCallback<TRouter>,\n): HandlerCallback<TRouter> {\n  return handler\n}\n"],"mappings":";AAUA,SAAgB,sBACd,SAC0B;AAC1B,QAAO"}
+{"version":3,"file":"handlerCallback.cjs","names":[],"sources":["../../../src/ssr/handlerCallback.ts"],"sourcesContent":["import type { AnyRouter } from '../router'\n\nexport type SsrResponse =\n  | {\n      response: Response\n      serverSsrCleanup: 'none'\n    }\n  | {\n      response: Response\n      serverSsrCleanup: 'stream'\n      dispose: (reason?: unknown) => Promise<void>\n    }\n\nexport type HandlerCallbackResult = Response | SsrResponse\n\nexport function isSsrResponse(value: unknown): value is SsrResponse {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'response' in value &&\n    'serverSsrCleanup' in value\n  )\n}\n\nexport function normalizeSsrResponse(\n  result: HandlerCallbackResult,\n): SsrResponse {\n  return isSsrResponse(result)\n    ? result\n    : { response: result, serverSsrCleanup: 'none' }\n}\n\nexport function createSsrStreamResponse<TRouter extends AnyRouter>(\n  router: TRouter,\n  response: Response,\n): SsrResponse {\n  if (!response.body) {\n    throw new Error('Invariant failed: SSR stream response requires a body')\n  }\n\n  let disposed = false\n  return {\n    response,\n    serverSsrCleanup: 'stream',\n    async dispose(reason?: unknown) {\n      if (disposed) return\n      disposed = true\n\n      try {\n        await response.body!.cancel(reason)\n      } catch {\n        // ignore; fallback cleanup below still releases router SSR state\n      }\n\n      router.serverSsr?.cleanup()\n    },\n  }\n}\n\nexport async function replaceSsrResponse(\n  result: HandlerCallbackResult,\n  response: Response,\n  reason?: unknown,\n): Promise<SsrResponse> {\n  const ssrResponse = normalizeSsrResponse(result)\n  if (ssrResponse.serverSsrCleanup === 'stream') {\n    await ssrResponse.dispose(reason)\n  }\n  return { response, serverSsrCleanup: 'none' }\n}\n\nexport async function stripSsrResponseBody(\n  result: HandlerCallbackResult,\n  reason?: unknown,\n): Promise<SsrResponse> {\n  const ssrResponse = normalizeSsrResponse(result)\n  if (ssrResponse.serverSsrCleanup === 'stream') {\n    await ssrResponse.dispose(reason)\n  }\n  return {\n    response: new Response(null, ssrResponse.response),\n    serverSsrCleanup: 'none',\n  }\n}\n\nexport interface HandlerCallback<TRouter extends AnyRouter> {\n  (ctx: {\n    request: Request\n    router: TRouter\n    responseHeaders: Headers\n  }): HandlerCallbackResult | Promise<HandlerCallbackResult>\n}\n\nexport function defineHandlerCallback<TRouter extends AnyRouter>(\n  handler: HandlerCallback<TRouter>,\n): HandlerCallback<TRouter> {\n  return handler\n}\n"],"mappings":";AAeA,SAAgB,cAAc,OAAsC;CAClE,OACE,OAAO,UAAU,YACjB,UAAU,QACV,cAAc,SACd,sBAAsB;AAE1B;AAEA,SAAgB,qBACd,QACa;CACb,OAAO,cAAc,MAAM,IACvB,SACA;EAAE,UAAU;EAAQ,kBAAkB;CAAO;AACnD;AAEA,SAAgB,wBACd,QACA,UACa;CACb,IAAI,CAAC,SAAS,MACZ,MAAM,IAAI,MAAM,uDAAuD;CAGzE,IAAI,WAAW;CACf,OAAO;EACL;EACA,kBAAkB;EAClB,MAAM,QAAQ,QAAkB;GAC9B,IAAI,UAAU;GACd,WAAW;GAEX,IAAI;IACF,MAAM,SAAS,KAAM,OAAO,MAAM;GACpC,QAAQ,CAER;GAEA,OAAO,WAAW,QAAQ;EAC5B;CACF;AACF;AAEA,eAAsB,mBACpB,QACA,UACA,QACsB;CACtB,MAAM,cAAc,qBAAqB,MAAM;CAC/C,IAAI,YAAY,qBAAqB,UACnC,MAAM,YAAY,QAAQ,MAAM;CAElC,OAAO;EAAE;EAAU,kBAAkB;CAAO;AAC9C;AAEA,eAAsB,qBACpB,QACA,QACsB;CACtB,MAAM,cAAc,qBAAqB,MAAM;CAC/C,IAAI,YAAY,qBAAqB,UACnC,MAAM,YAAY,QAAQ,MAAM;CAElC,OAAO;EACL,UAAU,IAAI,SAAS,MAAM,YAAY,QAAQ;EACjD,kBAAkB;CACpB;AACF;AAUA,SAAgB,sBACd,SAC0B;CAC1B,OAAO;AACT"}

package/dist/cjs/ssr/handlerCallback.d.cts

@@ -1,9 +1,23 @@
 import { AnyRouter } from '../router.cjs';
+export type SsrResponse = {
+    response: Response;
+    serverSsrCleanup: 'none';
+} | {
+    response: Response;
+    serverSsrCleanup: 'stream';
+    dispose: (reason?: unknown) => Promise<void>;
+};
+export type HandlerCallbackResult = Response | SsrResponse;
+export declare function isSsrResponse(value: unknown): value is SsrResponse;
+export declare function normalizeSsrResponse(result: HandlerCallbackResult): SsrResponse;
+export declare function createSsrStreamResponse<TRouter extends AnyRouter>(router: TRouter, response: Response): SsrResponse;
+export declare function replaceSsrResponse(result: HandlerCallbackResult, response: Response, reason?: unknown): Promise<SsrResponse>;
+export declare function stripSsrResponseBody(result: HandlerCallbackResult, reason?: unknown): Promise<SsrResponse>;
 export interface HandlerCallback<TRouter extends AnyRouter> {
     (ctx: {
         request: Request;
         router: TRouter;
         responseHeaders: Headers;
-    }): Response | Promise<Response>;
+    }): HandlerCallbackResult | Promise<HandlerCallbackResult>;
 }
 export declare function defineHandlerCallback<TRouter extends AnyRouter>(handler: HandlerCallback<TRouter>): HandlerCallback<TRouter>;

package/dist/cjs/ssr/headers.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"headers.cjs","names":[],"sources":["../../../src/ssr/headers.ts"],"sourcesContent":["import { splitSetCookieString } from 'cookie-es'\nimport type { OutgoingHttpHeaders } from 'node:http2'\n\nexport type AnyHeaders =\n  | Headers\n  | HeadersInit\n  | Record<string, string>\n  | Array<[string, string]>\n  | OutgoingHttpHeaders\n  | undefined\n\n// Helper function to convert various HeaderInit types to a Headers instance\nfunction toHeadersInstance(init: AnyHeaders) {\n  if (init instanceof Headers) {\n    return init\n  } else if (Array.isArray(init)) {\n    return new Headers(init)\n  } else if (typeof init === 'object') {\n    return new Headers(init as HeadersInit)\n  } else {\n    return null\n  }\n}\n\n// Function to merge headers with proper overrides\nexport function mergeHeaders(...headers: Array<AnyHeaders>) {\n  return headers.reduce((acc: Headers, header) => {\n    const headersInstance = toHeadersInstance(header)\n    if (!headersInstance) return acc\n    for (const [key, value] of headersInstance.entries()) {\n      if (key === 'set-cookie') {\n        const splitCookies = splitSetCookieString(value)\n        splitCookies.forEach((cookie) => acc.append('set-cookie', cookie))\n      } else {\n        acc.set(key, value)\n      }\n    }\n    return acc\n  }, new Headers())\n}\n"],"mappings":";;AAYA,SAAS,kBAAkB,MAAkB;AAC3C,KAAI,gBAAgB,QAClB,QAAO;UACE,MAAM,QAAQ,KAAK,CAC5B,QAAO,IAAI,QAAQ,KAAK;UACf,OAAO,SAAS,SACzB,QAAO,IAAI,QAAQ,KAAoB;KAEvC,QAAO;;AAKX,SAAgB,aAAa,GAAG,SAA4B;AAC1D,QAAO,QAAQ,QAAQ,KAAc,WAAW;EAC9C,MAAM,kBAAkB,kBAAkB,OAAO;AACjD,MAAI,CAAC,gBAAiB,QAAO;AAC7B,OAAK,MAAM,CAAC,KAAK,UAAU,gBAAgB,SAAS,CAClD,KAAI,QAAQ,aAEV,EAAA,GAAA,UAAA,sBAD0C,MAAM,CACnC,SAAS,WAAW,IAAI,OAAO,cAAc,OAAO,CAAC;MAElE,KAAI,IAAI,KAAK,MAAM;AAGvB,SAAO;IACN,IAAI,SAAS,CAAC"}
+{"version":3,"file":"headers.cjs","names":[],"sources":["../../../src/ssr/headers.ts"],"sourcesContent":["import { splitSetCookieString } from 'cookie-es'\nimport type { OutgoingHttpHeaders } from 'node:http2'\n\nexport type AnyHeaders =\n  | Headers\n  | HeadersInit\n  | Record<string, string>\n  | Array<[string, string]>\n  | OutgoingHttpHeaders\n  | undefined\n\n// Helper function to convert various HeaderInit types to a Headers instance\nfunction toHeadersInstance(init: AnyHeaders) {\n  if (init instanceof Headers) {\n    return init\n  } else if (Array.isArray(init)) {\n    return new Headers(init)\n  } else if (typeof init === 'object') {\n    return new Headers(init as HeadersInit)\n  } else {\n    return null\n  }\n}\n\n// Function to merge headers with proper overrides\nexport function mergeHeaders(...headers: Array<AnyHeaders>) {\n  return headers.reduce((acc: Headers, header) => {\n    const headersInstance = toHeadersInstance(header)\n    if (!headersInstance) return acc\n    for (const [key, value] of headersInstance.entries()) {\n      if (key === 'set-cookie') {\n        const splitCookies = splitSetCookieString(value)\n        splitCookies.forEach((cookie) => acc.append('set-cookie', cookie))\n      } else {\n        acc.set(key, value)\n      }\n    }\n    return acc\n  }, new Headers())\n}\n"],"mappings":";;AAYA,SAAS,kBAAkB,MAAkB;CAC3C,IAAI,gBAAgB,SAClB,OAAO;MACF,IAAI,MAAM,QAAQ,IAAI,GAC3B,OAAO,IAAI,QAAQ,IAAI;MAClB,IAAI,OAAO,SAAS,UACzB,OAAO,IAAI,QAAQ,IAAmB;MAEtC,OAAO;AAEX;AAGA,SAAgB,aAAa,GAAG,SAA4B;CAC1D,OAAO,QAAQ,QAAQ,KAAc,WAAW;EAC9C,MAAM,kBAAkB,kBAAkB,MAAM;EAChD,IAAI,CAAC,iBAAiB,OAAO;EAC7B,KAAK,MAAM,CAAC,KAAK,UAAU,gBAAgB,QAAQ,GACjD,IAAI,QAAQ,cAEV,CAAA,GAAA,UAAA,sBAD0C,KAC1C,EAAa,SAAS,WAAW,IAAI,OAAO,cAAc,MAAM,CAAC;OAEjE,IAAI,IAAI,KAAK,KAAK;EAGtB,OAAO;CACT,GAAG,IAAI,QAAQ,CAAC;AAClB"}

package/dist/cjs/ssr/json.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"json.cjs","names":[],"sources":["../../../src/ssr/json.ts"],"sourcesContent":["/**\n * @deprecated Use [`Response.json`](https://developer.mozilla.org/en-US/docs/Web/API/Response/json_static) from the standard Web API directly.\n */\nexport interface JsonResponse<TData> extends Response {\n  json: () => Promise<TData>\n}\n\n/**\n * @deprecated Use [`Response.json`](https://developer.mozilla.org/en-US/docs/Web/API/Response/json_static) from the standard Web API directly.\n */\nexport function json<TData>(\n  payload: TData,\n  init?: ResponseInit,\n): JsonResponse<TData> {\n  return Response.json(payload, init)\n}\n"],"mappings":";;;;AAUA,SAAgB,KACd,SACA,MACqB;AACrB,QAAO,SAAS,KAAK,SAAS,KAAK"}
+{"version":3,"file":"json.cjs","names":[],"sources":["../../../src/ssr/json.ts"],"sourcesContent":["/**\n * @deprecated Use [`Response.json`](https://developer.mozilla.org/en-US/docs/Web/API/Response/json_static) from the standard Web API directly.\n */\nexport interface JsonResponse<TData> extends Response {\n  json: () => Promise<TData>\n}\n\n/**\n * @deprecated Use [`Response.json`](https://developer.mozilla.org/en-US/docs/Web/API/Response/json_static) from the standard Web API directly.\n */\nexport function json<TData>(\n  payload: TData,\n  init?: ResponseInit,\n): JsonResponse<TData> {\n  return Response.json(payload, init)\n}\n"],"mappings":";;;;AAUA,SAAgB,KACd,SACA,MACqB;CACrB,OAAO,SAAS,KAAK,SAAS,IAAI;AACpC"}

package/dist/cjs/ssr/serializer/RawStream.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"RawStream.cjs","names":[],"sources":["../../../../src/ssr/serializer/RawStream.ts"],"sourcesContent":["import { createPlugin, createStream } from 'seroval'\nimport type { PluginData, PluginInfo, SerovalNode } from 'seroval'\n\n/**\n * Hint for RawStream encoding strategy during SSR serialization.\n * - 'binary': Always use base64 encoding (best for binary data like files, images)\n * - 'text': Try UTF-8 first, fallback to base64 (best for text-heavy data like RSC payloads)\n */\nexport type RawStreamHint = 'binary' | 'text'\n\n/**\n * Options for RawStream configuration.\n */\nexport interface RawStreamOptions {\n  /**\n   * Encoding hint for SSR serialization.\n   * - 'binary' (default): Always use base64 encoding\n   * - 'text': Try UTF-8 first, fallback to base64 for invalid UTF-8 chunks\n   */\n  hint?: RawStreamHint\n}\n\n/**\n * Marker class for ReadableStream<Uint8Array> that should be serialized\n * with base64 encoding (SSR) or binary framing (server functions).\n *\n * Wrap your binary streams with this to get efficient serialization:\n * ```ts\n * // For binary data (files, images, etc.)\n * return { data: new RawStream(file.stream()) }\n *\n * // For text-heavy data (RSC payloads, etc.)\n * return { data: new RawStream(rscStream, { hint: 'text' }) }\n * ```\n */\nexport class RawStream {\n  public readonly hint: RawStreamHint\n\n  constructor(\n    public readonly stream: ReadableStream<Uint8Array>,\n    options?: RawStreamOptions,\n  ) {\n    this.hint = options?.hint ?? 'binary'\n  }\n}\n\n/**\n * Callback type for RPC plugin to register raw streams with multiplexer\n */\nexport type OnRawStreamCallback = (\n  streamId: number,\n  stream: ReadableStream<Uint8Array>,\n) => void\n\n// Base64 helpers used in both Node and browser.\n// In Node-like runtimes, prefer Buffer for speed and compatibility.\nconst BufferCtor: any = (globalThis as any).Buffer\nconst hasNodeBuffer = !!BufferCtor && typeof BufferCtor.from === 'function'\n\nfunction uint8ArrayToBase64(bytes: Uint8Array): string {\n  if (bytes.length === 0) return ''\n\n  if (hasNodeBuffer) {\n    return BufferCtor.from(bytes).toString('base64')\n  }\n\n  // Browser fallback: chunked String.fromCharCode + btoa\n  const CHUNK_SIZE = 0x8000 // 32KB chunks to avoid stack overflow\n  const chunks: Array<string> = []\n  for (let i = 0; i < bytes.length; i += CHUNK_SIZE) {\n    const chunk = bytes.subarray(i, i + CHUNK_SIZE)\n    chunks.push(String.fromCharCode.apply(null, chunk as any))\n  }\n  return btoa(chunks.join(''))\n}\n\nfunction base64ToUint8Array(base64: string): Uint8Array {\n  if (base64.length === 0) return new Uint8Array(0)\n\n  if (hasNodeBuffer) {\n    const buf = BufferCtor.from(base64, 'base64')\n    return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength)\n  }\n\n  const binary = atob(base64)\n  const bytes = new Uint8Array(binary.length)\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i)\n  }\n  return bytes\n}\n\n// Factory sentinels - use null-proto objects to avoid prototype surprises\nconst RAW_STREAM_FACTORY_BINARY: Record<string, never> = Object.create(null)\nconst RAW_STREAM_FACTORY_TEXT: Record<string, never> = Object.create(null)\n\n// Factory constructor for binary mode - converts seroval stream to ReadableStream<Uint8Array>\n// All chunks are base64 encoded strings\nconst RAW_STREAM_FACTORY_CONSTRUCTOR_BINARY = (\n  stream: ReturnType<typeof createStream>,\n) =>\n  new ReadableStream<Uint8Array>({\n    start(controller) {\n      stream.on({\n        next(base64: string) {\n          try {\n            controller.enqueue(base64ToUint8Array(base64))\n          } catch {\n            // Stream may be closed\n          }\n        },\n        throw(error: unknown) {\n          controller.error(error)\n        },\n        return() {\n          try {\n            controller.close()\n          } catch {\n            // Stream may already be closed\n          }\n        },\n      })\n    },\n  })\n\n// Factory constructor for text mode - converts seroval stream to ReadableStream<Uint8Array>\n// Chunks are either strings (UTF-8) or { $b64: string } (base64 fallback)\n// Use module-level TextEncoder to avoid per-factory allocation\nconst textEncoderForFactory = new TextEncoder()\nconst RAW_STREAM_FACTORY_CONSTRUCTOR_TEXT = (\n  stream: ReturnType<typeof createStream>,\n) => {\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      stream.on({\n        next(value: string | { $b64: string }) {\n          try {\n            if (typeof value === 'string') {\n              controller.enqueue(textEncoderForFactory.encode(value))\n            } else {\n              controller.enqueue(base64ToUint8Array(value.$b64))\n            }\n          } catch {\n            // Stream may be closed\n          }\n        },\n        throw(error: unknown) {\n          controller.error(error)\n        },\n        return() {\n          try {\n            controller.close()\n          } catch {\n            // Stream may already be closed\n          }\n        },\n      })\n    },\n  })\n}\n\n// Minified factory function for binary mode - all chunks are base64 strings\n// This must be self-contained since it's injected into the HTML\nconst FACTORY_BINARY = `(s=>new ReadableStream({start(c){s.on({next(b){try{const d=atob(b),a=new Uint8Array(d.length);for(let i=0;i<d.length;i++)a[i]=d.charCodeAt(i);c.enqueue(a)}catch(_){}},throw(e){c.error(e)},return(){try{c.close()}catch(_){}}})}}))`\n\n// Minified factory function for text mode - chunks are string or {$b64: string}\n// Uses cached TextEncoder for performance\nconst FACTORY_TEXT = `(s=>{const e=new TextEncoder();return new ReadableStream({start(c){s.on({next(v){try{if(typeof v==='string'){c.enqueue(e.encode(v))}else{const d=atob(v.$b64),a=new Uint8Array(d.length);for(let i=0;i<d.length;i++)a[i]=d.charCodeAt(i);c.enqueue(a)}}catch(_){}},throw(x){c.error(x)},return(){try{c.close()}catch(_){}}})}})})`\n\n// Convert ReadableStream<Uint8Array> to seroval stream with base64-encoded chunks (binary mode)\nfunction toBinaryStream(readable: ReadableStream<Uint8Array>) {\n  const stream = createStream()\n  const reader = readable.getReader()\n\n  // Use iterative loop instead of recursive async to avoid stack accumulation\n  ;(async () => {\n    try {\n      while (true) {\n        const { done, value } = await reader.read()\n        if (done) {\n          stream.return(undefined)\n          break\n        }\n        stream.next(uint8ArrayToBase64(value))\n      }\n    } catch (error) {\n      stream.throw(error)\n    } finally {\n      reader.releaseLock()\n    }\n  })()\n\n  return stream\n}\n\n// Convert ReadableStream<Uint8Array> to seroval stream with UTF-8 first, base64 fallback (text mode)\nfunction toTextStream(readable: ReadableStream<Uint8Array>) {\n  const stream = createStream()\n  const reader = readable.getReader()\n  const decoder = new TextDecoder('utf-8', { fatal: true })\n\n  // Use iterative loop instead of recursive async to avoid stack accumulation\n  ;(async () => {\n    try {\n      while (true) {\n        const { done, value } = await reader.read()\n        if (done) {\n          // Flush any remaining bytes in the decoder\n          try {\n            const remaining = decoder.decode()\n            if (remaining.length > 0) {\n              stream.next(remaining)\n            }\n          } catch {\n            // Ignore decode errors on flush\n          }\n          stream.return(undefined)\n          break\n        }\n\n        try {\n          // Try UTF-8 decode first\n          const text = decoder.decode(value, { stream: true })\n          if (text.length > 0) {\n            stream.next(text)\n          }\n        } catch {\n          // UTF-8 decode failed, fallback to base64\n          stream.next({ $b64: uint8ArrayToBase64(value) })\n        }\n      }\n    } catch (error) {\n      stream.throw(error)\n    } finally {\n      reader.releaseLock()\n    }\n  })()\n\n  return stream\n}\n\n// Factory plugin for binary mode\nconst RawStreamFactoryBinaryPlugin = /* @__PURE__ */ createPlugin<\n  Record<string, never>,\n  PluginInfo\n>({\n  tag: 'tss/RawStreamFactory',\n  test(value) {\n    return value === RAW_STREAM_FACTORY_BINARY\n  },\n  parse: {\n    sync(_value, _ctx, _data) {\n      return {}\n    },\n    async async(_value, _ctx, _data) {\n      return {}\n    },\n    stream(_value, _ctx, _data) {\n      return {}\n    },\n  },\n  serialize(_node, _ctx, _data) {\n    return FACTORY_BINARY\n  },\n  deserialize(_node, _ctx, _data) {\n    return RAW_STREAM_FACTORY_BINARY\n  },\n})\n\n// Factory plugin for text mode\nconst RawStreamFactoryTextPlugin = /* @__PURE__ */ createPlugin<\n  Record<string, never>,\n  PluginInfo\n>({\n  tag: 'tss/RawStreamFactoryText',\n  test(value) {\n    return value === RAW_STREAM_FACTORY_TEXT\n  },\n  parse: {\n    sync(_value, _ctx, _data) {\n      return {}\n    },\n    async async(_value, _ctx, _data) {\n      return {}\n    },\n    stream(_value, _ctx, _data) {\n      return {}\n    },\n  },\n  serialize(_node, _ctx, _data) {\n    return FACTORY_TEXT\n  },\n  deserialize(_node, _ctx, _data) {\n    return RAW_STREAM_FACTORY_TEXT\n  },\n})\n\nexport interface RawStreamSSRNode extends PluginInfo {\n  hint: SerovalNode\n  factory: SerovalNode\n  stream: SerovalNode\n}\n\nexport interface RawStreamRPCNode extends PluginInfo {\n  streamId: SerovalNode\n}\n\n/**\n * SSR Plugin - uses base64 or UTF-8+base64 encoding for chunks, delegates to seroval's stream mechanism.\n * Used during SSR when serializing to JavaScript code for HTML injection.\n *\n * Supports two modes based on RawStream hint:\n * - 'binary': Always base64 encode (default)\n * - 'text': Try UTF-8 first, fallback to base64 for invalid UTF-8\n */\nexport const RawStreamSSRPlugin = /* @__PURE__ */ createPlugin<\n  RawStream,\n  RawStreamSSRNode\n>({\n  tag: 'tss/RawStream',\n  extends: [RawStreamFactoryBinaryPlugin, RawStreamFactoryTextPlugin],\n\n  test(value: unknown) {\n    return value instanceof RawStream\n  },\n\n  parse: {\n    sync(value: RawStream, ctx, _data) {\n      // Sync parse not really supported for streams, return empty stream\n      const factory =\n        value.hint === 'text'\n          ? RAW_STREAM_FACTORY_TEXT\n          : RAW_STREAM_FACTORY_BINARY\n      return {\n        hint: ctx.parse(value.hint),\n        factory: ctx.parse(factory),\n        stream: ctx.parse(createStream()),\n      }\n    },\n    async async(value: RawStream, ctx, _data) {\n      const factory =\n        value.hint === 'text'\n          ? RAW_STREAM_FACTORY_TEXT\n          : RAW_STREAM_FACTORY_BINARY\n      const encodedStream =\n        value.hint === 'text'\n          ? toTextStream(value.stream)\n          : toBinaryStream(value.stream)\n      return {\n        hint: await ctx.parse(value.hint),\n        factory: await ctx.parse(factory),\n        stream: await ctx.parse(encodedStream),\n      }\n    },\n    stream(value: RawStream, ctx, _data) {\n      const factory =\n        value.hint === 'text'\n          ? RAW_STREAM_FACTORY_TEXT\n          : RAW_STREAM_FACTORY_BINARY\n      const encodedStream =\n        value.hint === 'text'\n          ? toTextStream(value.stream)\n          : toBinaryStream(value.stream)\n      return {\n        hint: ctx.parse(value.hint),\n        factory: ctx.parse(factory),\n        stream: ctx.parse(encodedStream),\n      }\n    },\n  },\n\n  serialize(node: RawStreamSSRNode, ctx, _data) {\n    return (\n      '(' +\n      ctx.serialize(node.factory) +\n      ')(' +\n      ctx.serialize(node.stream) +\n      ')'\n    )\n  },\n\n  deserialize(node: RawStreamSSRNode, ctx, _data): any {\n    const stream: ReturnType<typeof createStream> = ctx.deserialize(node.stream)\n    const hint = ctx.deserialize(node.hint)\n    return hint === 'text'\n      ? RAW_STREAM_FACTORY_CONSTRUCTOR_TEXT(stream)\n      : RAW_STREAM_FACTORY_CONSTRUCTOR_BINARY(stream)\n  },\n})\n\n/**\n * Creates an RPC plugin instance that registers raw streams with a multiplexer.\n * Used for server function responses where we want binary framing.\n * Note: RPC always uses binary framing regardless of hint.\n *\n * @param onRawStream Callback invoked when a RawStream is encountered during serialization\n */\n/* @__NO_SIDE_EFFECTS__ */\nexport function createRawStreamRPCPlugin(onRawStream: OnRawStreamCallback) {\n  // Own stream counter - sequential IDs starting at 1, independent of seroval internals\n  let nextStreamId = 1\n\n  return /* @__PURE__ */ createPlugin<RawStream, RawStreamRPCNode>({\n    tag: 'tss/RawStream',\n\n    test(value: unknown) {\n      return value instanceof RawStream\n    },\n\n    parse: {\n      async async(value: RawStream, ctx, _data: PluginData) {\n        const streamId = nextStreamId++\n        onRawStream(streamId, value.stream)\n        return { streamId: await ctx.parse(streamId) }\n      },\n      stream(value: RawStream, ctx, _data: PluginData) {\n        const streamId = nextStreamId++\n        onRawStream(streamId, value.stream)\n        return { streamId: ctx.parse(streamId) }\n      },\n    },\n\n    serialize(): never {\n      // RPC uses toCrossJSONStream which produces JSON nodes, not JS code.\n      // This method is only called by crossSerialize* which we don't use.\n      throw new Error(\n        'RawStreamRPCPlugin.serialize should not be called. RPC uses JSON serialization, not JS code generation.',\n      )\n    },\n\n    deserialize(): never {\n      // Client uses createRawStreamDeserializePlugin instead\n      throw new Error(\n        'RawStreamRPCPlugin.deserialize should not be called. Use createRawStreamDeserializePlugin on client.',\n      )\n    },\n  })\n}\n\n/**\n * Creates a deserialize-only plugin for client-side stream reconstruction.\n * Used in serverFnFetcher to wire up streams from frame decoder.\n *\n * @param getOrCreateStream Function to get/create a stream by ID from frame decoder\n */\nexport function createRawStreamDeserializePlugin(\n  getOrCreateStream: (id: number) => ReadableStream<Uint8Array>,\n) {\n  return /* @__PURE__ */ createPlugin<any, RawStreamRPCNode>({\n    tag: 'tss/RawStream',\n\n    test: () => false, // Client never serializes RawStream\n\n    parse: {}, // Client only deserializes, never parses\n\n    serialize(): never {\n      // Client never serializes RawStream back to server\n      throw new Error(\n        'RawStreamDeserializePlugin.serialize should not be called. Client only deserializes.',\n      )\n    },\n\n    deserialize(node, ctx, _data) {\n      // In normal seroval usage, ctx.deserialize exists.\n      // Some unit tests call plugin.deserialize directly with a minimal ctx.\n      const id =\n        typeof (ctx as any)?.deserialize === 'function'\n          ? (ctx as any).deserialize(node.streamId)\n          : (node as any).streamId\n      return getOrCreateStream(id as number)\n    },\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"RawStream.cjs","names":[],"sources":["../../../../src/ssr/serializer/RawStream.ts"],"sourcesContent":["import { createPlugin, createStream } from 'seroval'\nimport type { PluginData, PluginInfo, SerovalNode } from 'seroval'\n\n/**\n * Hint for RawStream encoding strategy during SSR serialization.\n * - 'binary': Always use base64 encoding (best for binary data like files, images)\n * - 'text': Try UTF-8 first, fallback to base64 (best for text-heavy data like RSC payloads)\n */\nexport type RawStreamHint = 'binary' | 'text'\n\n/**\n * Options for RawStream configuration.\n */\nexport interface RawStreamOptions {\n  /**\n   * Encoding hint for SSR serialization.\n   * - 'binary' (default): Always use base64 encoding\n   * - 'text': Try UTF-8 first, fallback to base64 for invalid UTF-8 chunks\n   */\n  hint?: RawStreamHint\n}\n\n/**\n * Marker class for ReadableStream<Uint8Array> that should be serialized\n * with base64 encoding (SSR) or binary framing (server functions).\n *\n * Wrap your binary streams with this to get efficient serialization:\n * ```ts\n * // For binary data (files, images, etc.)\n * return { data: new RawStream(file.stream()) }\n *\n * // For text-heavy data (RSC payloads, etc.)\n * return { data: new RawStream(rscStream, { hint: 'text' }) }\n * ```\n */\nexport class RawStream {\n  public readonly hint: RawStreamHint\n\n  constructor(\n    public readonly stream: ReadableStream<Uint8Array>,\n    options?: RawStreamOptions,\n  ) {\n    this.hint = options?.hint ?? 'binary'\n  }\n}\n\n/**\n * Callback type for RPC plugin to register raw streams with multiplexer\n */\nexport type OnRawStreamCallback = (\n  streamId: number,\n  stream: ReadableStream<Uint8Array>,\n) => void\n\n// Base64 helpers used in both Node and browser.\n// In Node-like runtimes, prefer Buffer for speed and compatibility.\nconst BufferCtor: any = (globalThis as any).Buffer\nconst hasNodeBuffer = !!BufferCtor && typeof BufferCtor.from === 'function'\n\nfunction uint8ArrayToBase64(bytes: Uint8Array): string {\n  if (bytes.length === 0) return ''\n\n  if (hasNodeBuffer) {\n    return BufferCtor.from(bytes).toString('base64')\n  }\n\n  // Browser fallback: chunked String.fromCharCode + btoa\n  const CHUNK_SIZE = 0x8000 // 32KB chunks to avoid stack overflow\n  const chunks: Array<string> = []\n  for (let i = 0; i < bytes.length; i += CHUNK_SIZE) {\n    const chunk = bytes.subarray(i, i + CHUNK_SIZE)\n    chunks.push(String.fromCharCode.apply(null, chunk as any))\n  }\n  return btoa(chunks.join(''))\n}\n\nfunction base64ToUint8Array(base64: string): Uint8Array {\n  if (base64.length === 0) return new Uint8Array(0)\n\n  if (hasNodeBuffer) {\n    const buf = BufferCtor.from(base64, 'base64')\n    return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength)\n  }\n\n  const binary = atob(base64)\n  const bytes = new Uint8Array(binary.length)\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i)\n  }\n  return bytes\n}\n\n// Factory sentinels - use null-proto objects to avoid prototype surprises\nconst RAW_STREAM_FACTORY_BINARY: Record<string, never> = Object.create(null)\nconst RAW_STREAM_FACTORY_TEXT: Record<string, never> = Object.create(null)\n\n// Factory constructor for binary mode - converts seroval stream to ReadableStream<Uint8Array>\n// All chunks are base64 encoded strings\nconst RAW_STREAM_FACTORY_CONSTRUCTOR_BINARY = (\n  stream: ReturnType<typeof createStream>,\n) =>\n  new ReadableStream<Uint8Array>({\n    start(controller) {\n      stream.on({\n        next(base64: string) {\n          try {\n            controller.enqueue(base64ToUint8Array(base64))\n          } catch {\n            // Stream may be closed\n          }\n        },\n        throw(error: unknown) {\n          controller.error(error)\n        },\n        return() {\n          try {\n            controller.close()\n          } catch {\n            // Stream may already be closed\n          }\n        },\n      })\n    },\n  })\n\n// Factory constructor for text mode - converts seroval stream to ReadableStream<Uint8Array>\n// Chunks are either strings (UTF-8) or { $b64: string } (base64 fallback)\n// Use module-level TextEncoder to avoid per-factory allocation\nconst textEncoderForFactory = new TextEncoder()\nconst RAW_STREAM_FACTORY_CONSTRUCTOR_TEXT = (\n  stream: ReturnType<typeof createStream>,\n) => {\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      stream.on({\n        next(value: string | { $b64: string }) {\n          try {\n            if (typeof value === 'string') {\n              controller.enqueue(textEncoderForFactory.encode(value))\n            } else {\n              controller.enqueue(base64ToUint8Array(value.$b64))\n            }\n          } catch {\n            // Stream may be closed\n          }\n        },\n        throw(error: unknown) {\n          controller.error(error)\n        },\n        return() {\n          try {\n            controller.close()\n          } catch {\n            // Stream may already be closed\n          }\n        },\n      })\n    },\n  })\n}\n\n// Minified factory function for binary mode - all chunks are base64 strings\n// This must be self-contained since it's injected into the HTML\nconst FACTORY_BINARY = `(s=>new ReadableStream({start(c){s.on({next(b){try{const d=atob(b),a=new Uint8Array(d.length);for(let i=0;i<d.length;i++)a[i]=d.charCodeAt(i);c.enqueue(a)}catch(_){}},throw(e){c.error(e)},return(){try{c.close()}catch(_){}}})}}))`\n\n// Minified factory function for text mode - chunks are string or {$b64: string}\n// Uses cached TextEncoder for performance\nconst FACTORY_TEXT = `(s=>{const e=new TextEncoder();return new ReadableStream({start(c){s.on({next(v){try{if(typeof v==='string'){c.enqueue(e.encode(v))}else{const d=atob(v.$b64),a=new Uint8Array(d.length);for(let i=0;i<d.length;i++)a[i]=d.charCodeAt(i);c.enqueue(a)}}catch(_){}},throw(x){c.error(x)},return(){try{c.close()}catch(_){}}})}})})`\n\n// Convert ReadableStream<Uint8Array> to seroval stream with base64-encoded chunks (binary mode)\nfunction toBinaryStream(readable: ReadableStream<Uint8Array>) {\n  const stream = createStream()\n  const reader = readable.getReader()\n\n  // Use iterative loop instead of recursive async to avoid stack accumulation\n  ;(async () => {\n    try {\n      while (true) {\n        const { done, value } = await reader.read()\n        if (done) {\n          stream.return(undefined)\n          break\n        }\n        stream.next(uint8ArrayToBase64(value))\n      }\n    } catch (error) {\n      stream.throw(error)\n    } finally {\n      reader.releaseLock()\n    }\n  })()\n\n  return stream\n}\n\n// Convert ReadableStream<Uint8Array> to seroval stream with UTF-8 first, base64 fallback (text mode)\nfunction toTextStream(readable: ReadableStream<Uint8Array>) {\n  const stream = createStream()\n  const reader = readable.getReader()\n  const decoder = new TextDecoder('utf-8', { fatal: true })\n\n  // Use iterative loop instead of recursive async to avoid stack accumulation\n  ;(async () => {\n    try {\n      while (true) {\n        const { done, value } = await reader.read()\n        if (done) {\n          // Flush any remaining bytes in the decoder\n          try {\n            const remaining = decoder.decode()\n            if (remaining.length > 0) {\n              stream.next(remaining)\n            }\n          } catch {\n            // Ignore decode errors on flush\n          }\n          stream.return(undefined)\n          break\n        }\n\n        try {\n          // Try UTF-8 decode first\n          const text = decoder.decode(value, { stream: true })\n          if (text.length > 0) {\n            stream.next(text)\n          }\n        } catch {\n          // UTF-8 decode failed, fallback to base64\n          stream.next({ $b64: uint8ArrayToBase64(value) })\n        }\n      }\n    } catch (error) {\n      stream.throw(error)\n    } finally {\n      reader.releaseLock()\n    }\n  })()\n\n  return stream\n}\n\n// Factory plugin for binary mode\nconst RawStreamFactoryBinaryPlugin = /* @__PURE__ */ createPlugin<\n  Record<string, never>,\n  PluginInfo\n>({\n  tag: 'tss/RawStreamFactory',\n  test(value) {\n    return value === RAW_STREAM_FACTORY_BINARY\n  },\n  parse: {\n    sync(_value, _ctx, _data) {\n      return {}\n    },\n    async async(_value, _ctx, _data) {\n      return {}\n    },\n    stream(_value, _ctx, _data) {\n      return {}\n    },\n  },\n  serialize(_node, _ctx, _data) {\n    return FACTORY_BINARY\n  },\n  deserialize(_node, _ctx, _data) {\n    return RAW_STREAM_FACTORY_BINARY\n  },\n})\n\n// Factory plugin for text mode\nconst RawStreamFactoryTextPlugin = /* @__PURE__ */ createPlugin<\n  Record<string, never>,\n  PluginInfo\n>({\n  tag: 'tss/RawStreamFactoryText',\n  test(value) {\n    return value === RAW_STREAM_FACTORY_TEXT\n  },\n  parse: {\n    sync(_value, _ctx, _data) {\n      return {}\n    },\n    async async(_value, _ctx, _data) {\n      return {}\n    },\n    stream(_value, _ctx, _data) {\n      return {}\n    },\n  },\n  serialize(_node, _ctx, _data) {\n    return FACTORY_TEXT\n  },\n  deserialize(_node, _ctx, _data) {\n    return RAW_STREAM_FACTORY_TEXT\n  },\n})\n\nexport interface RawStreamSSRNode extends PluginInfo {\n  hint: SerovalNode\n  factory: SerovalNode\n  stream: SerovalNode\n}\n\nexport interface RawStreamRPCNode extends PluginInfo {\n  streamId: SerovalNode\n}\n\n/**\n * SSR Plugin - uses base64 or UTF-8+base64 encoding for chunks, delegates to seroval's stream mechanism.\n * Used during SSR when serializing to JavaScript code for HTML injection.\n *\n * Supports two modes based on RawStream hint:\n * - 'binary': Always base64 encode (default)\n * - 'text': Try UTF-8 first, fallback to base64 for invalid UTF-8\n */\nexport const RawStreamSSRPlugin = /* @__PURE__ */ createPlugin<\n  RawStream,\n  RawStreamSSRNode\n>({\n  tag: 'tss/RawStream',\n  extends: [RawStreamFactoryBinaryPlugin, RawStreamFactoryTextPlugin],\n\n  test(value: unknown) {\n    return value instanceof RawStream\n  },\n\n  parse: {\n    sync(value: RawStream, ctx, _data) {\n      // Sync parse not really supported for streams, return empty stream\n      const factory =\n        value.hint === 'text'\n          ? RAW_STREAM_FACTORY_TEXT\n          : RAW_STREAM_FACTORY_BINARY\n      return {\n        hint: ctx.parse(value.hint),\n        factory: ctx.parse(factory),\n        stream: ctx.parse(createStream()),\n      }\n    },\n    async async(value: RawStream, ctx, _data) {\n      const factory =\n        value.hint === 'text'\n          ? RAW_STREAM_FACTORY_TEXT\n          : RAW_STREAM_FACTORY_BINARY\n      const encodedStream =\n        value.hint === 'text'\n          ? toTextStream(value.stream)\n          : toBinaryStream(value.stream)\n      return {\n        hint: await ctx.parse(value.hint),\n        factory: await ctx.parse(factory),\n        stream: await ctx.parse(encodedStream),\n      }\n    },\n    stream(value: RawStream, ctx, _data) {\n      const factory =\n        value.hint === 'text'\n          ? RAW_STREAM_FACTORY_TEXT\n          : RAW_STREAM_FACTORY_BINARY\n      const encodedStream =\n        value.hint === 'text'\n          ? toTextStream(value.stream)\n          : toBinaryStream(value.stream)\n      return {\n        hint: ctx.parse(value.hint),\n        factory: ctx.parse(factory),\n        stream: ctx.parse(encodedStream),\n      }\n    },\n  },\n\n  serialize(node: RawStreamSSRNode, ctx, _data) {\n    return (\n      '(' +\n      ctx.serialize(node.factory) +\n      ')(' +\n      ctx.serialize(node.stream) +\n      ')'\n    )\n  },\n\n  deserialize(node: RawStreamSSRNode, ctx, _data): any {\n    const stream: ReturnType<typeof createStream> = ctx.deserialize(node.stream)\n    const hint = ctx.deserialize(node.hint)\n    return hint === 'text'\n      ? RAW_STREAM_FACTORY_CONSTRUCTOR_TEXT(stream)\n      : RAW_STREAM_FACTORY_CONSTRUCTOR_BINARY(stream)\n  },\n})\n\n/**\n * Creates an RPC plugin instance that registers raw streams with a multiplexer.\n * Used for server function responses where we want binary framing.\n * Note: RPC always uses binary framing regardless of hint.\n *\n * @param onRawStream Callback invoked when a RawStream is encountered during serialization\n */\n/* @__NO_SIDE_EFFECTS__ */\nexport function createRawStreamRPCPlugin(onRawStream: OnRawStreamCallback) {\n  // Own stream counter - sequential IDs starting at 1, independent of seroval internals\n  let nextStreamId = 1\n\n  return /* @__PURE__ */ createPlugin<RawStream, RawStreamRPCNode>({\n    tag: 'tss/RawStream',\n\n    test(value: unknown) {\n      return value instanceof RawStream\n    },\n\n    parse: {\n      async async(value: RawStream, ctx, _data: PluginData) {\n        const streamId = nextStreamId++\n        onRawStream(streamId, value.stream)\n        return { streamId: await ctx.parse(streamId) }\n      },\n      stream(value: RawStream, ctx, _data: PluginData) {\n        const streamId = nextStreamId++\n        onRawStream(streamId, value.stream)\n        return { streamId: ctx.parse(streamId) }\n      },\n    },\n\n    serialize(): never {\n      // RPC uses toCrossJSONStream which produces JSON nodes, not JS code.\n      // This method is only called by crossSerialize* which we don't use.\n      throw new Error(\n        'RawStreamRPCPlugin.serialize should not be called. RPC uses JSON serialization, not JS code generation.',\n      )\n    },\n\n    deserialize(): never {\n      // Client uses createRawStreamDeserializePlugin instead\n      throw new Error(\n        'RawStreamRPCPlugin.deserialize should not be called. Use createRawStreamDeserializePlugin on client.',\n      )\n    },\n  })\n}\n\n/**\n * Creates a deserialize-only plugin for client-side stream reconstruction.\n * Used in serverFnFetcher to wire up streams from frame decoder.\n *\n * @param getOrCreateStream Function to get/create a stream by ID from frame decoder\n */\nexport function createRawStreamDeserializePlugin(\n  getOrCreateStream: (id: number) => ReadableStream<Uint8Array>,\n) {\n  return /* @__PURE__ */ createPlugin<any, RawStreamRPCNode>({\n    tag: 'tss/RawStream',\n\n    test: () => false, // Client never serializes RawStream\n\n    parse: {}, // Client only deserializes, never parses\n\n    serialize(): never {\n      // Client never serializes RawStream back to server\n      throw new Error(\n        'RawStreamDeserializePlugin.serialize should not be called. Client only deserializes.',\n      )\n    },\n\n    deserialize(node, ctx, _data) {\n      // In normal seroval usage, ctx.deserialize exists.\n      // Some unit tests call plugin.deserialize directly with a minimal ctx.\n      const id =\n        typeof (ctx as any)?.deserialize === 'function'\n          ? (ctx as any).deserialize(node.streamId)\n          : (node as any).streamId\n      return getOrCreateStream(id as number)\n    },\n  })\n}\n"],"mappings":"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"}

package/dist/cjs/ssr/serializer/ShallowErrorPlugin.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ShallowErrorPlugin.cjs","names":[],"sources":["../../../../src/ssr/serializer/ShallowErrorPlugin.ts"],"sourcesContent":["import { createPlugin } from 'seroval'\nimport type { PluginInfo, SerovalNode } from 'seroval'\n\nexport interface ErrorNode extends PluginInfo {\n  message: SerovalNode\n}\n\n/**\n * this plugin serializes only the `message` part of an Error\n * this helps with serializing e.g. a ZodError which has functions attached that cannot be serialized\n */\nexport const ShallowErrorPlugin = /* @__PURE__ */ createPlugin<\n  Error,\n  ErrorNode\n>({\n  tag: '$TSR/Error',\n  test(value) {\n    return value instanceof Error\n  },\n  parse: {\n    sync(value, ctx) {\n      return {\n        message: ctx.parse(value.message),\n      }\n    },\n    async async(value, ctx) {\n      return {\n        message: await ctx.parse(value.message),\n      }\n    },\n    stream(value, ctx) {\n      return {\n        message: ctx.parse(value.message),\n      }\n    },\n  },\n  serialize(node, ctx) {\n    return 'new Error(' + ctx.serialize(node.message) + ')'\n  },\n  deserialize(node, ctx) {\n    return new Error(ctx.deserialize(node.message))\n  },\n})\n"],"mappings":";;;;;AAWA,MAAa,qBAAqC,iBAAA,sBAAA,cAGhD;CACA,KAAK;CACL,KAAK,OAAO;AACV,SAAO,iBAAiB;;CAE1B,OAAO;EACL,KAAK,OAAO,KAAK;AACf,UAAO,EACL,SAAS,IAAI,MAAM,MAAM,QAAQ,EAClC;;EAEH,MAAM,MAAM,OAAO,KAAK;AACtB,UAAO,EACL,SAAS,MAAM,IAAI,MAAM,MAAM,QAAQ,EACxC;;EAEH,OAAO,OAAO,KAAK;AACjB,UAAO,EACL,SAAS,IAAI,MAAM,MAAM,QAAQ,EAClC;;EAEJ;CACD,UAAU,MAAM,KAAK;AACnB,SAAO,eAAe,IAAI,UAAU,KAAK,QAAQ,GAAG;;CAEtD,YAAY,MAAM,KAAK;AACrB,SAAO,IAAI,MAAM,IAAI,YAAY,KAAK,QAAQ,CAAC;;CAElD,CAAC"}
+{"version":3,"file":"ShallowErrorPlugin.cjs","names":[],"sources":["../../../../src/ssr/serializer/ShallowErrorPlugin.ts"],"sourcesContent":["import { createPlugin } from 'seroval'\nimport type { PluginInfo, SerovalNode } from 'seroval'\n\nexport interface ErrorNode extends PluginInfo {\n  message: SerovalNode\n}\n\n/**\n * this plugin serializes only the `message` part of an Error\n * this helps with serializing e.g. a ZodError which has functions attached that cannot be serialized\n */\nexport const ShallowErrorPlugin = /* @__PURE__ */ createPlugin<\n  Error,\n  ErrorNode\n>({\n  tag: '$TSR/Error',\n  test(value) {\n    return value instanceof Error\n  },\n  parse: {\n    sync(value, ctx) {\n      return {\n        message: ctx.parse(value.message),\n      }\n    },\n    async async(value, ctx) {\n      return {\n        message: await ctx.parse(value.message),\n      }\n    },\n    stream(value, ctx) {\n      return {\n        message: ctx.parse(value.message),\n      }\n    },\n  },\n  serialize(node, ctx) {\n    return 'new Error(' + ctx.serialize(node.message) + ')'\n  },\n  deserialize(node, ctx) {\n    return new Error(ctx.deserialize(node.message))\n  },\n})\n"],"mappings":";;;;;AAWA,MAAa,qBAAqC,iBAAA,oBAAA,EAAA,cAGhD;CACA,KAAK;CACL,KAAK,OAAO;EACV,OAAO,iBAAiB;CAC1B;CACA,OAAO;EACL,KAAK,OAAO,KAAK;GACf,OAAO,EACL,SAAS,IAAI,MAAM,MAAM,OAAO,EAClC;EACF;EACA,MAAM,MAAM,OAAO,KAAK;GACtB,OAAO,EACL,SAAS,MAAM,IAAI,MAAM,MAAM,OAAO,EACxC;EACF;EACA,OAAO,OAAO,KAAK;GACjB,OAAO,EACL,SAAS,IAAI,MAAM,MAAM,OAAO,EAClC;EACF;CACF;CACA,UAAU,MAAM,KAAK;EACnB,OAAO,eAAe,IAAI,UAAU,KAAK,OAAO,IAAI;CACtD;CACA,YAAY,MAAM,KAAK;EACrB,OAAO,IAAI,MAAM,IAAI,YAAY,KAAK,OAAO,CAAC;CAChD;AACF,CAAC"}

package/dist/cjs/ssr/serializer/seroval-plugins.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"seroval-plugins.cjs","names":[],"sources":["../../../../src/ssr/serializer/seroval-plugins.ts"],"sourcesContent":["import { ReadableStreamPlugin } from 'seroval-plugins/web'\nimport { ShallowErrorPlugin } from './ShallowErrorPlugin'\nimport { RawStreamSSRPlugin } from './RawStream'\nimport type { RawStream } from './RawStream'\nimport type { Plugin } from 'seroval'\n\nexport const defaultSerovalPlugins = [\n  ShallowErrorPlugin as Plugin<Error, any>,\n  // RawStreamSSRPlugin must come before ReadableStreamPlugin to match first\n  RawStreamSSRPlugin as Plugin<RawStream, any>,\n  // ReadableStreamNode is not exported by seroval\n  ReadableStreamPlugin as Plugin<ReadableStream, any>,\n]\n"],"mappings":";;;;AAMA,MAAa,wBAAwB;CACnC,2BAAA;CAEA,kBAAA;CAEA,oBAAA;CACD"}
+{"version":3,"file":"seroval-plugins.cjs","names":[],"sources":["../../../../src/ssr/serializer/seroval-plugins.ts"],"sourcesContent":["import { ReadableStreamPlugin } from 'seroval-plugins/web'\nimport { ShallowErrorPlugin } from './ShallowErrorPlugin'\nimport { RawStreamSSRPlugin } from './RawStream'\nimport type { RawStream } from './RawStream'\nimport type { Plugin } from 'seroval'\n\nexport const defaultSerovalPlugins = [\n  ShallowErrorPlugin as Plugin<Error, any>,\n  // RawStreamSSRPlugin must come before ReadableStreamPlugin to match first\n  RawStreamSSRPlugin as Plugin<RawStream, any>,\n  // ReadableStreamNode is not exported by seroval\n  ReadableStreamPlugin as Plugin<ReadableStream, any>,\n]\n"],"mappings":";;;;AAMA,MAAa,wBAAwB;CACnC,2BAAA;CAEA,kBAAA;CAEA,oBAAA;AACF"}