{"version":3,"file":"navigation-state.js","names":[],"sources":["../../src/shims/navigation-state.ts"],"sourcesContent":["/**\n * Server-only navigation state backed by AsyncLocalStorage.\n *\n * This module provides request-scoped isolation for navigation context\n * and useServerInsertedHTML callbacks. Without ALS, concurrent requests\n * on Cloudflare Workers would share module-level state and leak data\n * (pathnames, params, CSS-in-JS styles) between requests.\n *\n * This module is server-only — it imports node:async_hooks and must NOT\n * be bundled for the browser. The dual-environment navigation.ts shim\n * uses a registration pattern so it works in both environments.\n */\n\nimport { getOrCreateAls } from \"./internal/als-registry.js\";\nimport {\n  _registerStateAccessors,\n  type NavigationContext,\n  GLOBAL_ACCESSORS_KEY,\n} from \"./navigation.js\";\nimport {\n  isInsideUnifiedScope,\n  getRequestContext,\n  runWithUnifiedStateMutation,\n} from \"./unified-request-context.js\";\n\n// ---------------------------------------------------------------------------\n// ALS setup — same pattern as headers.ts\n// ---------------------------------------------------------------------------\n\nexport type NavigationState = {\n  serverContext: NavigationContext | null;\n  serverInsertedHTMLCallbacks: Array<() => unknown>;\n};\n\nconst _FALLBACK_KEY = Symbol.for(\"vinext.navigation.fallback\");\nconst _g = globalThis as unknown as Record<PropertyKey, unknown>;\nconst _als = getOrCreateAls<NavigationState>(\"vinext.navigation.als\");\n\nconst _fallbackState = (_g[_FALLBACK_KEY] ??= {\n  serverContext: null,\n  serverInsertedHTMLCallbacks: [],\n} satisfies NavigationState) as NavigationState;\n\nfunction _getState(): NavigationState {\n  if (isInsideUnifiedScope()) {\n    return getRequestContext();\n  }\n  return _als.getStore() ?? _fallbackState;\n}\n\n/**\n * Run a function within a navigation ALS scope.\n * Ensures per-request isolation for navigation context and\n * useServerInsertedHTML callbacks on concurrent runtimes.\n */\nexport function runWithNavigationContext<T>(fn: () => Promise<T>): Promise<T>;\nexport function runWithNavigationContext<T>(fn: () => T | Promise<T>): T | Promise<T>;\nexport function runWithNavigationContext<T>(fn: () => T | Promise<T>): T | Promise<T> {\n  if (isInsideUnifiedScope()) {\n    return runWithUnifiedStateMutation((uCtx) => {\n      uCtx.serverContext = null;\n      uCtx.serverInsertedHTMLCallbacks = [];\n    }, fn);\n  }\n  const state: NavigationState = {\n    serverContext: null,\n    serverInsertedHTMLCallbacks: [],\n  };\n  return _als.run(state, fn);\n}\n\n/**\n * Run a function with a fresh useServerInsertedHTML callback list while\n * preserving the current navigation context.\n *\n * Used by the Pages Router ISR cache-fill pass: it is the same request/path,\n * but it needs a fresh callback collection so CSS-in-JS insertions from the\n * streamed render cannot accumulate into the cache-fill render.\n */\nexport function runWithServerInsertedHTMLState<T>(fn: () => Promise<T>): Promise<T>;\nexport function runWithServerInsertedHTMLState<T>(fn: () => T | Promise<T>): T | Promise<T>;\nexport function runWithServerInsertedHTMLState<T>(fn: () => T | Promise<T>): T | Promise<T> {\n  if (isInsideUnifiedScope()) {\n    return runWithUnifiedStateMutation((uCtx) => {\n      uCtx.serverInsertedHTMLCallbacks = [];\n    }, fn);\n  }\n\n  const parentState = _als.getStore() ?? _fallbackState;\n  const state: NavigationState = {\n    serverContext: parentState.serverContext,\n    serverInsertedHTMLCallbacks: [],\n  };\n  return _als.run(state, fn);\n}\n\n// ---------------------------------------------------------------------------\n// Register ALS-backed accessors into navigation.ts\n//\n// Two registration paths (issue #688):\n// 1. _registerStateAccessors — updates the module-level function pointers\n//    in the same module instance that imported us (the SSR entry's copy).\n// 2. globalThis[Symbol.for(...)] — makes the accessors discoverable by ANY\n//    module instance of navigation.ts, even if Vite created a separate one\n//    for \"use client\" components due to pre-bundling or env separation.\n// ---------------------------------------------------------------------------\n\nconst _accessors = {\n  getServerContext(): NavigationContext | null {\n    return _getState().serverContext;\n  },\n\n  setServerContext(ctx: NavigationContext | null): void {\n    _getState().serverContext = ctx;\n  },\n\n  getInsertedHTMLCallbacks(): Array<() => unknown> {\n    return _getState().serverInsertedHTMLCallbacks;\n  },\n\n  clearInsertedHTMLCallbacks(): void {\n    _getState().serverInsertedHTMLCallbacks = [];\n  },\n} satisfies Parameters<typeof _registerStateAccessors>[0];\n\n_registerStateAccessors(_accessors);\n(globalThis as unknown as Record<PropertyKey, unknown>)[GLOBAL_ACCESSORS_KEY] = _accessors;\n"],"mappings":";;;;;;;;;;;;;;;;AAkCA,MAAM,gBAAgB,OAAO,IAAI,6BAA6B;AAC9D,MAAM,KAAK;AACX,MAAM,OAAO,eAAgC,wBAAwB;AAErE,MAAM,iBAAkB,GAAG,mBAAmB;CAC5C,eAAe;CACf,6BAA6B,EAAE;CAChC;AAED,SAAS,YAA6B;CACpC,IAAI,sBAAsB,EACxB,OAAO,mBAAmB;CAE5B,OAAO,KAAK,UAAU,IAAI;;AAU5B,SAAgB,yBAA4B,IAA0C;CACpF,IAAI,sBAAsB,EACxB,OAAO,6BAA6B,SAAS;EAC3C,KAAK,gBAAgB;EACrB,KAAK,8BAA8B,EAAE;IACpC,GAAG;CAMR,OAAO,KAAK,IAAI;EAHd,eAAe;EACf,6BAA6B,EAAE;EAEZ,EAAE,GAAG;;AAa5B,SAAgB,+BAAkC,IAA0C;CAC1F,IAAI,sBAAsB,EACxB,OAAO,6BAA6B,SAAS;EAC3C,KAAK,8BAA8B,EAAE;IACpC,GAAG;CAIR,MAAM,QAAyB;EAC7B,gBAFkB,KAAK,UAAU,IAAI,gBAEV;EAC3B,6BAA6B,EAAE;EAChC;CACD,OAAO,KAAK,IAAI,OAAO,GAAG;;AAc5B,MAAM,aAAa;CACjB,mBAA6C;EAC3C,OAAO,WAAW,CAAC;;CAGrB,iBAAiB,KAAqC;EACpD,WAAW,CAAC,gBAAgB;;CAG9B,2BAAiD;EAC/C,OAAO,WAAW,CAAC;;CAGrB,6BAAmC;EACjC,WAAW,CAAC,8BAA8B,EAAE;;CAE/C;AAED,wBAAwB,WAAW;AACnC,WAAwD,wBAAwB"}