@tanstack/start-storage-context 1.166.23 → 1.166.25

package/dist/esm/async-local-storage.d.ts

@@ -1,10 +1,18 @@
-import { Awaitable, RegisteredRouter } from '@tanstack/router-core';
+import { Awaitable, RegisteredRouter, RouterManagedTag } from '@tanstack/router-core';
+export type StartHandlerType = 'router' | 'serverFn';
 export interface StartStorageContext {
     getRouter: () => Awaitable<RegisteredRouter>;
     request: Request;
     startOptions: any;
     contextAfterGlobalMiddlewares: any;
     executedRequestMiddlewares: Set<any>;
+    handlerType: StartHandlerType;
+    /**
+     * Additional assets to inject for this request.
+     * Plugins can push RouterManagedTag items here during request processing.
+     * Merged into manifest at dehydration time without mutating cached manifest.
+     */
+    requestAssets?: Array<RouterManagedTag>;
 }
 export declare function runWithStartContext<T>(context: StartStorageContext, fn: () => T | Promise<T>): Promise<T>;
 export declare function getStartContext<TThrow extends boolean = true>(opts?: {

package/dist/esm/async-local-storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"async-local-storage.js","names":[],"sources":["../../src/async-local-storage.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\nimport type { Awaitable, RegisteredRouter } from '@tanstack/router-core'\n\nexport interface StartStorageContext {\n  getRouter: () => Awaitable<RegisteredRouter>\n  request: Request\n  // TODO type this properly\n  startOptions: /* AnyStartInstanceOptions*/ any\n\n  contextAfterGlobalMiddlewares: any\n  // Track middlewares that have already executed in the request phase\n  // to prevent duplicate execution\n  executedRequestMiddlewares: Set<any>\n}\n\n// Use a global symbol to ensure the same AsyncLocalStorage instance is shared\n// across different bundles that may each bundle this module.\nconst GLOBAL_STORAGE_KEY = Symbol.for('tanstack-start:start-storage-context')\n\nconst globalObj = globalThis as typeof globalThis & {\n  [GLOBAL_STORAGE_KEY]?: AsyncLocalStorage<StartStorageContext>\n}\n\nif (!globalObj[GLOBAL_STORAGE_KEY]) {\n  globalObj[GLOBAL_STORAGE_KEY] = new AsyncLocalStorage<StartStorageContext>()\n}\n\nconst startStorage = globalObj[GLOBAL_STORAGE_KEY]\n\nexport async function runWithStartContext<T>(\n  context: StartStorageContext,\n  fn: () => T | Promise<T>,\n): Promise<T> {\n  return startStorage.run(context, fn)\n}\n\nexport function getStartContext<TThrow extends boolean = true>(opts?: {\n  throwIfNotFound?: TThrow\n}): TThrow extends false\n  ? StartStorageContext | undefined\n  : StartStorageContext {\n  const context = startStorage.getStore()\n  if (!context && opts?.throwIfNotFound !== false) {\n    throw new Error(\n      `No Start context found in AsyncLocalStorage. Make sure you are using the function within the server runtime.`,\n    )\n  }\n  return context as any\n}\n"],"mappings":";;AAiBA,IAAM,qBAAqB,OAAO,IAAI,uCAAuC;AAE7E,IAAM,YAAY;AAIlB,IAAI,CAAC,UAAU,oBACb,WAAU,sBAAsB,IAAI,mBAAwC;AAG9E,IAAM,eAAe,UAAU;AAE/B,eAAsB,oBACpB,SACA,IACY;AACZ,QAAO,aAAa,IAAI,SAAS,GAAG;;AAGtC,SAAgB,gBAA+C,MAIvC;CACtB,MAAM,UAAU,aAAa,UAAU;AACvC,KAAI,CAAC,WAAW,MAAM,oBAAoB,MACxC,OAAM,IAAI,MACR,+GACD;AAEH,QAAO"}
+{"version":3,"file":"async-local-storage.js","names":[],"sources":["../../src/async-local-storage.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\nimport type {\n  Awaitable,\n  RegisteredRouter,\n  RouterManagedTag,\n} from '@tanstack/router-core'\n\nexport type StartHandlerType = 'router' | 'serverFn'\n\nexport interface StartStorageContext {\n  getRouter: () => Awaitable<RegisteredRouter>\n  request: Request\n  // TODO type this properly\n  startOptions: /* AnyStartInstanceOptions*/ any\n\n  contextAfterGlobalMiddlewares: any\n  // Track middlewares that have already executed in the request phase\n  // to prevent duplicate execution\n  executedRequestMiddlewares: Set<any>\n  // Type of handler processing this request\n  handlerType: StartHandlerType\n\n  /**\n   * Additional assets to inject for this request.\n   * Plugins can push RouterManagedTag items here during request processing.\n   * Merged into manifest at dehydration time without mutating cached manifest.\n   */\n  requestAssets?: Array<RouterManagedTag>\n}\n\n// Use a global symbol to ensure the same AsyncLocalStorage instance is shared\n// across different bundles that may each bundle this module.\nconst GLOBAL_STORAGE_KEY = Symbol.for('tanstack-start:start-storage-context')\n\nconst globalObj = globalThis as typeof globalThis & {\n  [GLOBAL_STORAGE_KEY]?: AsyncLocalStorage<StartStorageContext>\n}\n\nif (!globalObj[GLOBAL_STORAGE_KEY]) {\n  globalObj[GLOBAL_STORAGE_KEY] = new AsyncLocalStorage<StartStorageContext>()\n}\n\nconst startStorage = globalObj[GLOBAL_STORAGE_KEY]\n\nexport async function runWithStartContext<T>(\n  context: StartStorageContext,\n  fn: () => T | Promise<T>,\n): Promise<T> {\n  return startStorage.run(context, fn)\n}\n\nexport function getStartContext<TThrow extends boolean = true>(opts?: {\n  throwIfNotFound?: TThrow\n}): TThrow extends false\n  ? StartStorageContext | undefined\n  : StartStorageContext {\n  const context = startStorage.getStore()\n  if (!context && opts?.throwIfNotFound !== false) {\n    throw new Error(\n      `No Start context found in AsyncLocalStorage. Make sure you are using the function within the server runtime.`,\n    )\n  }\n  return context as any\n}\n"],"mappings":";;AAgCA,IAAM,qBAAqB,OAAO,IAAI,uCAAuC;AAE7E,IAAM,YAAY;AAIlB,IAAI,CAAC,UAAU,oBACb,WAAU,sBAAsB,IAAI,mBAAwC;AAG9E,IAAM,eAAe,UAAU;AAE/B,eAAsB,oBACpB,SACA,IACY;AACZ,QAAO,aAAa,IAAI,SAAS,GAAG;;AAGtC,SAAgB,gBAA+C,MAIvC;CACtB,MAAM,UAAU,aAAa,UAAU;AACvC,KAAI,CAAC,WAAW,MAAM,oBAAoB,MACxC,OAAM,IAAI,MACR,+GACD;AAEH,QAAO"}

package/dist/esm/index.d.ts

@@ -1,2 +1,2 @@
 export { getStartContext, runWithStartContext } from './async-local-storage.js';
-export type { StartStorageContext } from './async-local-storage.js';
+export type { StartStorageContext, StartHandlerType, } from './async-local-storage.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/start-storage-context",
-  "version": "1.166.23",
+  "version": "1.166.25",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -43,7 +43,7 @@
     "node": ">=22.12.0"
   },
   "dependencies": {
-    "@tanstack/router-core": "1.168.9"
+    "@tanstack/router-core": "1.168.11"
   },
   "devDependencies": {
     "vite": "*",

package/src/async-local-storage.ts

@@ -1,5 +1,11 @@
 import { AsyncLocalStorage } from 'node:async_hooks'
-import type { Awaitable, RegisteredRouter } from '@tanstack/router-core'
+import type {
+  Awaitable,
+  RegisteredRouter,
+  RouterManagedTag,
+} from '@tanstack/router-core'
+
+export type StartHandlerType = 'router' | 'serverFn'
 
 export interface StartStorageContext {
   getRouter: () => Awaitable<RegisteredRouter>
@@ -11,6 +17,15 @@ export interface StartStorageContext {
   // Track middlewares that have already executed in the request phase
   // to prevent duplicate execution
   executedRequestMiddlewares: Set<any>
+  // Type of handler processing this request
+  handlerType: StartHandlerType
+
+  /**
+   * Additional assets to inject for this request.
+   * Plugins can push RouterManagedTag items here during request processing.
+   * Merged into manifest at dehydration time without mutating cached manifest.
+   */
+  requestAssets?: Array<RouterManagedTag>
 }
 
 // Use a global symbol to ensure the same AsyncLocalStorage instance is shared

package/src/index.tsx

@@ -1,2 +1,5 @@
 export { getStartContext, runWithStartContext } from './async-local-storage'
-export type { StartStorageContext } from './async-local-storage'
+export type {
+  StartStorageContext,
+  StartHandlerType,
+} from './async-local-storage'