@fayz-ai/core 0.9.0 → 0.11.0

package/dist/chunk-OXQGRJZT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/router/index.ts"],"names":[],"mappings":"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","file":"chunk-OXQGRJZT.js","sourcesContent":["// ---------------------------------------------------------------------------\n// Router adapters — the seam between SDK surfaces (storefront, portal, admin)\n// and however the host app addresses pages.\n//\n// A surface never reads `window.location` directly; it asks the adapter. That\n// is what lets the same components render under a hash SPA (the historical\n// default), a real-URL SPA, and a server render where there is no `window` at\n// all. `href()` is part of the contract for exactly this reason: a link's shape\n// is a property of the addressing scheme, not of the component drawing it, so\n// `<Link>` never branches on which adapter is active.\n// ---------------------------------------------------------------------------\n\nexport interface RouterAdapter {\n  /** Move to `to` ('/product/x'). No-op where navigation is not possible (SSR). */\n  navigate(to: string): void\n  /**\n   * Move to `to` without adding a history entry — for state that lives in the\n   * URL (catalogue filters, sort) where every keystroke must not become a\n   * \"back\" step. No-op under SSR.\n   */\n  replace(to: string): void\n  /** Current in-app path, always leading-slash, never including the origin. */\n  getCurrentPath(): string\n  /** Subscribe to path changes. Returns an unsubscribe fn. */\n  onPathChange(cb: (path: string) => void): () => void\n  /**\n   * The `href` an anchor to `to` should carry. Hash routing needs the '#'\n   * prefix; real-URL routing passes the path through untouched.\n   */\n  href(to: string): string\n  /**\n   * Whether a plain left-click on an in-app anchor must be intercepted and\n   * routed in-page. False for hash routing, where the browser already handles\n   * fragment navigation natively without a document load.\n   */\n  readonly interceptsLinkClicks: boolean\n}\n\nfunction normalize(path: string): string {\n  if (!path) return '/'\n  return path.startsWith('/') ? path : `/${path}`\n}\n\n/**\n * Fragment addressing (`example.com/#/product/x`). The historical SDK default.\n *\n * Deliberately kept as-is: every shipped app addresses pages this way, and the\n * fragment survives static hosting with no server rewrite rules. Its cost is\n * that the fragment never reaches the server, so a hash-addressed page can be\n * neither server-rendered nor indexed as a distinct URL — use\n * `historyRouterAdapter` when either matters.\n */\nexport function hashRouterAdapter(): RouterAdapter {\n  return {\n    navigate(to) { window.location.hash = to },\n    replace(to) { window.history.replaceState(null, '', `#${normalize(to)}`) },\n    getCurrentPath() { return window.location.hash.slice(1) || '/' },\n    onPathChange(cb) {\n      const handler = () => cb(window.location.hash.slice(1) || '/')\n      window.addEventListener('hashchange', handler)\n      return () => window.removeEventListener('hashchange', handler)\n    },\n    href(to) { return `#${normalize(to)}` },\n    interceptsLinkClicks: false,\n  }\n}\n\n/**\n * Real-URL addressing (`example.com/product/x`) over the History API.\n *\n * `history.pushState` does NOT emit `popstate` (HTML spec), so a subscriber\n * list is the only way programmatic navigation can notify renderers — an\n * adapter that only listens for `popstate` silently changes the URL without\n * re-rendering. Back/forward still arrive via `popstate` and are fanned out to\n * the same subscribers.\n *\n * Requires the host to serve the app shell for unknown paths (SPA fallback);\n * without it a deep link 404s before the adapter ever runs.\n */\nexport function historyRouterAdapter(): RouterAdapter {\n  const subscribers = new Set<(path: string) => void>()\n  let popstateBound = false\n\n  const currentPath = () => window.location.pathname + window.location.search\n  const emit = () => { for (const cb of subscribers) cb(currentPath()) }\n\n  return {\n    navigate(to) {\n      const next = normalize(to)\n      if (next === currentPath()) return\n      window.history.pushState(null, '', next)\n      emit()\n    },\n    replace(to) {\n      const next = normalize(to)\n      if (next === currentPath()) return\n      window.history.replaceState(null, '', next)\n      emit()\n    },\n    getCurrentPath() { return currentPath() },\n    onPathChange(cb) {\n      subscribers.add(cb)\n      if (!popstateBound) {\n        window.addEventListener('popstate', emit)\n        popstateBound = true\n      }\n      return () => {\n        subscribers.delete(cb)\n        if (subscribers.size === 0 && popstateBound) {\n          window.removeEventListener('popstate', emit)\n          popstateBound = false\n        }\n      }\n    },\n    href(to) { return normalize(to) },\n    interceptsLinkClicks: true,\n  }\n}\n\n/**\n * A fixed path with no browser behind it — the server half of a render.\n *\n * Every method is total: `navigate` is a no-op and `onPathChange` never fires,\n * so a component that navigates during render degrades to \"nothing happened\"\n * instead of throwing. Anchors still render real, crawlable hrefs, which is the\n * whole point of rendering server-side.\n */\nexport function staticRouterAdapter(\n  path: string,\n  options: {\n    /**\n     * How to write an anchor's href. Defaults to the path verbatim — real URLs,\n     * which is the reason to render statically at all. A caller rendering a\n     * store that is *served* as a hash SPA passes that scheme's writer instead,\n     * because the addressing scheme is a property of how the store is served,\n     * not of whether this particular render happens to be headless.\n     */\n    href?: (to: string) => string\n  } = {},\n): RouterAdapter {\n  const fixed = normalize(path)\n  const writeHref = options.href ?? ((to: string) => normalize(to))\n  return {\n    navigate() {},\n    replace() {},\n    getCurrentPath() { return fixed },\n    onPathChange() { return () => {} },\n    href(to) { return writeHref(to) },\n    interceptsLinkClicks: true,\n  }\n}\n\n/**\n * Bridge any host router (TanStack Router, React Router, Next) into the SDK.\n * The host stays the single source of truth for history; the SDK only reads.\n */\nexport function hostRouterAdapter(host: {\n  navigate: (to: string) => void\n  /** Falls back to `navigate` when the host draws no push/replace distinction. */\n  replace?: (to: string) => void\n  currentPath: () => string\n  subscribe?: (cb: (path: string) => void) => () => void\n}): RouterAdapter {\n  return {\n    navigate(to) { host.navigate(normalize(to)) },\n    replace(to) { (host.replace ?? host.navigate)(normalize(to)) },\n    getCurrentPath() { return normalize(host.currentPath()) },\n    onPathChange(cb) { return host.subscribe?.(cb) ?? (() => {}) },\n    href(to) { return normalize(to) },\n    interceptsLinkClicks: true,\n  }\n}\n\n/**\n * The adapter that fits the current environment: static during SSR (no\n * `window`), otherwise the caller's choice of addressing scheme.\n */\nexport function defaultRouterAdapter(\n  scheme: 'hash' | 'history' = 'hash',\n  ssrPath = '/',\n): RouterAdapter {\n  if (typeof window !== 'undefined') {\n    return scheme === 'history' ? historyRouterAdapter() : hashRouterAdapter()\n  }\n  // No window: a static adapter, but still writing hrefs in the requested\n  // scheme. Dropping the scheme here would make a headless render of a\n  // hash-served store emit `/x` links that do not resolve — the render must\n  // describe how the store is served, not how it happens to be rendered.\n  return staticRouterAdapter(ssrPath, {\n    href: scheme === 'hash' ? (to) => `#${normalize(to)}` : undefined,\n  })\n}\n\n/** @deprecated Use `historyRouterAdapter()` — this one never notified on push. */\nexport const windowRouterAdapter = historyRouterAdapter\n"]}