@sweidos/eidos 2.2.0 → 2.3.0

package/dist/resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource.js","names":[],"sources":["../src/resource.ts"],"sourcesContent":["import { useEidosStore } from './store';\nimport { sendToWorker } from './sw-bridge';\nimport type {\n  ResourceConfig,\n  ResourceHandle,\n  PatternResourceHandle,\n  ResourceEntry,\n  GeneratedStrategy,\n  CacheStrategy,\n  WarmCacheResult,\n} from './types';\n\nconst _registry = new Map<string, ResourceHandle | PatternResourceHandle>();\n\n// ── Request deduplication ─────────────────────────────────────────────────────\n// If multiple callers invoke handle.fetch() simultaneously for the same URL,\n// only one network request is made. Each caller gets its own cloned Response.\n// Keyed by URL; entry is deleted when the request settles.\nconst _inflightRequests = /* @__PURE__ */ new Map<string, Promise<Response>>();\n\n// ── TanStack Query bridge (optional) ─────────────────────────────────────────\n// Set by @sweidos/eidos/query when withEidosQueryClient() is called.\n// Lets handle.invalidate() also invalidate the matching TQ cache entry.\ntype QueryInvalidator = (queryKey: [string, string]) => void;\nlet _queryInvalidator: QueryInvalidator | null = null;\n\n/** @internal Called by @sweidos/eidos/query. */\nexport function setQueryInvalidator(fn: QueryInvalidator): void {\n  _queryInvalidator = fn;\n}\n\n// ── URL pattern helpers ───────────────────────────────────────────────────────\n\n/** Returns true if `url` contains wildcard or :param segments. */\nfunction isPattern(url: string): boolean {\n  return url.includes('*') || /:[^/]+/.test(url);\n}\n\n/**\n * Converts a URL pattern to a regex source string for SW fetch matching.\n *  `**`     → multi-segment wildcard  (`.+`)\n *  `*`      → single-segment wildcard (`[^/]+`)\n *  `:param` → named single segment    (`[^/]+`)\n *\n * Special regex characters in the pattern (e.g. `.`) are escaped first so\n * they match literally.\n *\n * @example\n *   patternToRegexStr('/api/products/*')      // '^/api/products/[^/]+$'\n *   patternToRegexStr('/api/products/**')     // '^/api/products/.+$'\n *   patternToRegexStr('/api/users/:id')       // '^/api/users/[^/]+$'\n */\nfunction patternToRegexStr(pattern: string): string {\n  // Escape all regex-special chars except `*`, `/`, `:` (handled below)\n  const escaped = pattern.replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&');\n  return (\n    '^' +\n    escaped\n      .replace(/\\*\\*/g, '.+') // ** → multi-segment wildcard\n      .replace(/\\*/g, '[^/]+') // * → single-segment wildcard\n      .replace(/:[^/]+/g, '[^/]+') + // :param → single-segment wildcard\n    '$'\n  );\n}\n\n/** Shared setup for resource()/resourcePattern(): strategy derivation, store + SW registration. */\nfunction _register(\n  url: string,\n  config: ResourceConfig,\n): { strategy: GeneratedStrategy; regexStr: string | undefined } {\n  const strategy = deriveStrategy(config);\n  const regexStr = isPattern(url) ? patternToRegexStr(url) : undefined;\n\n  const entry: ResourceEntry = {\n    url,\n    config,\n    strategy,\n    status: 'idle',\n    cacheHits: 0,\n    cacheMisses: 0,\n  };\n\n  useEidosStore.getState().registerResource(url, entry);\n\n  sendToWorker({\n    type: 'EIDOS_REGISTER_RESOURCE',\n    url,\n    strategy: strategy.swStrategy,\n    cacheName: strategy.cacheName,\n    ...(regexStr !== undefined && { pattern: regexStr }),\n  });\n\n  return { strategy, regexStr };\n}\n\nfunction _invalidate(\n  url: string,\n  strategy: GeneratedStrategy,\n  regexStr: string | undefined,\n): () => Promise<void> {\n  return async () => {\n    sendToWorker({ type: 'EIDOS_CLEAR_CACHE', url });\n    const cache = await caches.open(strategy.cacheName).catch(() => null);\n    if (cache) {\n      const keys = await cache.keys();\n      const patternRe = regexStr ? new RegExp(regexStr) : null;\n      const isCrossOrigin = url.startsWith('http');\n      await Promise.all(\n        keys\n          .filter((r) => {\n            const rUrl = r.url;\n            const p = new URL(rUrl).pathname;\n            if (patternRe) {\n              // Cross-origin patterns were compiled from absolute URLs; test full URL.\n              return patternRe.test(isCrossOrigin ? rUrl : p);\n            }\n            return isCrossOrigin ? rUrl === url : rUrl === url || p === url;\n          })\n          .map((r) => cache.delete(r)),\n      );\n    }\n    // For exact-URL resources update the store entry; patterns don't have a\n    // single entry to update (individual URLs are not tracked per-pattern).\n    if (!isPattern(url)) {\n      useEidosStore.getState().updateResource(url, {\n        status: 'stale',\n        cachedAt: undefined,\n        lastEvent: 'cache-cleared',\n        cacheHits: 0,\n        cacheMisses: 0,\n      });\n    }\n    // Notify TanStack Query bridge if registered.\n    _queryInvalidator?.(['eidos', url]);\n  };\n}\n\nfunction _unregister(url: string): () => void {\n  return () => {\n    _registry.delete(url);\n    sendToWorker({ type: 'EIDOS_UNREGISTER_RESOURCE', url });\n    useEidosStore.getState().unregisterResource(url);\n  };\n}\n\nfunction _warnIfReregisteredWithDifferentConfig(\n  url: string,\n  existing: ResourceHandle | PatternResourceHandle,\n  config: ResourceConfig,\n  factoryName: string,\n): void {\n  if (!import.meta.env.DEV) return;\n  const existingCfg = existing.config;\n  if (\n    existingCfg.offline !== config.offline ||\n    existingCfg.strategy !== config.strategy ||\n    existingCfg.cacheName !== config.cacheName ||\n    existingCfg.version !== config.version\n  ) {\n    console.warn(\n      `[eidos] ${factoryName}('${url}') already registered with a different config — returning cached handle. Call handle.unregister() first to re-register.`,\n      { registered: existingCfg, ignored: config },\n    );\n  }\n}\n\n// ── resource() ────────────────────────────────────────────────────────────────\n\n/**\n * Registers a concrete-URL resource. For URL patterns (`/api/products/*`,\n * `/api/users/:id`, `**`), use `resourcePattern()` instead.\n */\nexport function resource<T = unknown>(url: string, config: ResourceConfig): ResourceHandle<T> {\n  if (isPattern(url)) {\n    throw new Error(\n      `[eidos] resource('${url}') is a URL pattern — use resourcePattern('${url}', config) instead. ` +\n        `Pattern handles only support invalidate()/unregister(); the SW intercepts matching requests automatically.`,\n    );\n  }\n\n  if (_registry.has(url)) {\n    const existing = _registry.get(url)!;\n    _warnIfReregisteredWithDifferentConfig(url, existing, config, 'resource');\n    return existing as ResourceHandle<T>;\n  }\n\n  const { strategy } = _register(url, config);\n\n  const handle: ResourceHandle<T> = {\n    url,\n    config,\n    strategy,\n\n    fetch: async () => {\n      // ── Deduplication: coalesce concurrent fetches for the same URL ─────\n      // If a request is already in-flight, piggyback on it and return a clone\n      // so each caller gets an independent readable Response body.\n      const existing = _inflightRequests.get(url);\n      if (existing) return existing.then((r) => r.clone());\n\n      // Store the raw-response promise. All callers (including the primary)\n      // receive a clone — the raw response stays unconsumed in the map so\n      // any caller arriving while the promise is still pending can clone it.\n      const task = _fetchResource(url, config, strategy);\n      _inflightRequests.set(url, task);\n      // .catch() silences the unhandled-rejection on the cleanup promise;\n      // the error still propagates to callers via task.then() below.\n      task.finally(() => _inflightRequests.delete(url)).catch(() => {});\n      return task.then((r) => r.clone());\n    },\n\n    json: async () => {\n      const res = await handle.fetch();\n      return res.json() as Promise<T>;\n    },\n\n    query: () => ({\n      queryKey: ['eidos', url] as [string, string],\n      queryFn: () => handle.json(),\n    }),\n\n    prefetch: async () => {\n      await handle.fetch();\n    },\n\n    invalidate: _invalidate(url, strategy, undefined),\n    unregister: _unregister(url),\n  };\n\n  _registry.set(url, handle);\n  return handle;\n}\n\n// ── resourcePattern() ────────────────────────────────────────────────────────\n\n/**\n * Registers a URL pattern (`/api/products/*`, `/api/users/:id`, `**`). The SW\n * intercepts all matching requests automatically — there is no single URL to\n * fetch/cache directly, so the returned handle only supports cache management\n * (`invalidate`/`unregister`). For a fetchable resource, use `resource()`.\n */\nexport function resourcePattern(url: string, config: ResourceConfig): PatternResourceHandle {\n  if (!isPattern(url)) {\n    throw new Error(\n      `[eidos] resourcePattern('${url}') is not a URL pattern — use resource('${url}', config) instead.`,\n    );\n  }\n\n  if (_registry.has(url)) {\n    const existing = _registry.get(url)!;\n    _warnIfReregisteredWithDifferentConfig(url, existing, config, 'resourcePattern');\n    return existing as PatternResourceHandle;\n  }\n\n  const { strategy, regexStr } = _register(url, config);\n\n  const handle: PatternResourceHandle = {\n    url,\n    config,\n    strategy,\n    invalidate: _invalidate(url, strategy, regexStr),\n    unregister: _unregister(url),\n  };\n\n  _registry.set(url, handle);\n  return handle;\n}\n\n// ── _fetchResource ─────────────────────────────────────────────────────────────\n// The actual network/cache implementation. Separated from handle.fetch() so the\n// deduplication wrapper can store the Promise and share it across concurrent callers.\n// Returns the raw (unconsumed) Response — callers MUST .clone() before reading body.\nasync function _fetchResource(\n  url: string,\n  config: ResourceConfig,\n  strategy: GeneratedStrategy,\n): Promise<Response> {\n  const store = useEidosStore.getState();\n  store.updateResource(url, { status: 'fetching', fetchedAt: Date.now() });\n\n  // Open cache once and reuse across try/catch — avoids a redundant\n  // caches.open() call in the error fallback path.\n  const cache = await caches.open(strategy.cacheName).catch(() => null);\n\n  try {\n    // ── network-first: skip cache check, go straight to network ─────────\n    // For cache-first / SWR the cache check below is correct. For\n    // network-first, reading cache first and returning early would\n    // contradict the strategy — fresh data is the priority.\n    if (strategy.swStrategy !== 'network-first') {\n      // ── Direct Cache API check ─────────────────────────────────────────\n      // We read the cache in the main thread rather than waiting for\n      // an async SW postMessage. This gives instant, reliable status\n      // updates regardless of SW message timing.\n      const cached = cache ? await cache.match(url).catch(() => null) : null;\n\n      // Treat cache as miss if maxAge exceeded\n      const current = useEidosStore.getState().resources[url];\n      const expired =\n        config.maxAge !== undefined &&\n        current?.cachedAt !== undefined &&\n        Date.now() - current.cachedAt > config.maxAge;\n\n      if (cached && !expired) {\n        store.updateResource(url, {\n          status: 'fresh',\n          lastEvent: 'cache-hit',\n          cacheHits: (current?.cacheHits ?? 0) + 1,\n        });\n\n        // Background revalidation for SWR (stale-while-revalidate)\n        if (strategy.swStrategy === 'stale-while-revalidate') {\n          fetch(url, { signal: AbortSignal.timeout(5000) })\n            .then(async (resp) => {\n              if (resp.ok && cache) {\n                await cache.put(url, resp.clone());\n                useEidosStore.getState().updateResource(url, {\n                  cachedAt: Date.now(),\n                  lastEvent: 'cache-updated',\n                });\n              }\n            })\n            .catch(() => {\n              /* offline or timed out — cached version stays valid */\n            });\n        }\n\n        return cached;\n      }\n\n      // Cache miss (or expired)\n      const storeEntry = useEidosStore.getState().resources[url];\n      store.updateResource(url, {\n        cacheMisses: (storeEntry?.cacheMisses ?? 0) + 1,\n      });\n    }\n\n    const response = await fetch(url);\n\n    if (response.ok) {\n      if (cache) await cache.put(url, response.clone());\n      store.updateResource(url, {\n        status: 'fresh',\n        cachedAt: Date.now(),\n        lastEvent: 'cache-updated',\n      });\n      return response;\n    }\n\n    // Non-2xx response (e.g. 503 from offline SW) — update status and throw\n    // so callers get a proper error instead of a plain-object body they can't use.\n    store.updateResource(url, { status: response.status === 503 ? 'offline' : 'error' });\n\n    // Check if the SW tagged this as an offline response\n    const isOffline = response.headers.get('X-Eidos-Offline') === 'true';\n    throw new Error(\n      isOffline\n        ? `offline: no cached response for ${url}`\n        : `${response.status} ${response.statusText}`,\n    );\n  } catch (err) {\n    // Network failure — try cache one more time as fallback\n    const fallback = cache ? await cache.match(url).catch(() => null) : null;\n\n    if (fallback) {\n      const current = useEidosStore.getState().resources[url];\n      store.updateResource(url, {\n        status: 'fresh',\n        lastEvent: 'cache-hit',\n        cacheHits: (current?.cacheHits ?? 0) + 1,\n      });\n      return fallback;\n    }\n\n    store.updateResource(url, { status: 'error' });\n    throw err;\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Strategy derivation — intent → deterministic caching strategy\n// ─────────────────────────────────────────────────────────────────────────────\n\nfunction deriveStrategy(config: ResourceConfig): GeneratedStrategy {\n  const explicit = config.strategy;\n  if (config.offline) {\n    return buildStrategy(explicit ?? 'stale-while-revalidate', config.cacheName, config.version);\n  }\n  return buildStrategy(explicit ?? 'network-first', config.cacheName, config.version);\n}\n\n// Strategy display names — always included (tiny, used by devtools).\nconst STRATEGY_NAMES: Record<CacheStrategy, string> = {\n  'stale-while-revalidate': 'StaleWhileRevalidate',\n  'cache-first': 'CacheFirst',\n  'network-first': 'NetworkFirst',\n};\n\n// Heavy descriptive strings — stripped from production bundles by Vite's\n// import.meta.env.DEV dead-code elimination. Only the names above ship in prod.\ntype StrategyDevInfo = Pick<GeneratedStrategy, 'reasoning' | 'behavior' | 'equivalentCode'>;\nconst _STRATEGY_DEV_META: Record<CacheStrategy, StrategyDevInfo> = {\n  'stale-while-revalidate': {\n    reasoning:\n      'offline: true signals resilience. SWR returns cached data instantly while revalidating in the background — the best tradeoff between speed and freshness for offline-capable resources.',\n    behavior: [\n      'Cache hit → return immediately, kick off background revalidation',\n      'Cache miss → fetch from network, cache the response, return it',\n      'Offline → return cached version if available, 503 if not',\n      'Reconnect → next request triggers a background refresh',\n    ],\n    equivalentCode: `// Workbox equivalent\nnew StaleWhileRevalidate({\n  cacheName: 'eidos-resources-v1',\n  plugins: [new ExpirationPlugin({ maxEntries: 60 })],\n})`,\n  },\n  'cache-first': {\n    reasoning:\n      'cache-first maximises speed and offline availability. Network is consulted only on cache miss. Best for static or infrequently-updated data.',\n    behavior: [\n      'Cache hit → return immediately, no network request made',\n      'Cache miss → fetch from network, cache the response, return it',\n      'Offline → return cached version, 503 if cache is empty',\n      'Cache never expires unless explicitly invalidated',\n    ],\n    equivalentCode: `// Workbox equivalent\nnew CacheFirst({\n  cacheName: 'eidos-resources-v1',\n  plugins: [new ExpirationPlugin({ maxEntries: 60 })],\n})`,\n  },\n  'network-first': {\n    reasoning:\n      'network-first prioritises fresh data. Cache acts as a safety net when offline. Best for frequently-updated resources where stale data causes problems.',\n    behavior: [\n      'Always try network first',\n      'Network success → update cache, return fresh response',\n      'Network failure → fall back to cached version',\n      'Offline with empty cache → return 503 error response',\n    ],\n    equivalentCode: `// Workbox equivalent\nnew NetworkFirst({\n  cacheName: 'eidos-resources-v1',\n  networkTimeoutSeconds: 3,\n})`,\n  },\n};\n\nfunction buildStrategy(\n  swStrategy: CacheStrategy,\n  cacheName?: string,\n  version?: string | number,\n): GeneratedStrategy {\n  const meta = _STRATEGY_DEV_META[swStrategy];\n  const baseName = cacheName ?? 'eidos-resources-v1';\n  return {\n    name: STRATEGY_NAMES[swStrategy],\n    swStrategy,\n    cacheName: version !== undefined ? `${baseName}-v${version}` : baseName,\n    // reasoning + behavior are rendered by the playground UI from live ResourceEntry objects —\n    // keep them in all builds. equivalentCode is a static code block only used in DEV tools.\n    reasoning: meta.reasoning,\n    behavior: meta.behavior,\n    equivalentCode: import.meta.env.DEV ? meta.equivalentCode : '',\n  };\n}\n\n// ── warmCache ─────────────────────────────────────────────────────────────────\n\n/**\n * Bulk-prefetch an array of resource handles concurrently, warming the cache\n * for each one. Useful on login / app init when you know which resources the\n * user will need offline.\n *\n * Pattern handles (containing `*`, `**`, or `:param`) are silently skipped —\n * they match multiple URLs so there is no single URL to prefetch.\n *\n * @example\n * import { warmCache } from '@sweidos/eidos'\n *\n * // In EidosProvider's onReady, or after login:\n * const { warmed, failed } = await warmCache([products, userProfile, settings])\n */\nexport async function warmCache(handles: ResourceHandle[]): Promise<WarmCacheResult> {\n  const results = await Promise.allSettled(handles.map((h) => h.prefetch()));\n  const errors = results\n    .filter((r): r is PromiseRejectedResult => r.status === 'rejected')\n    .map((r) => r.reason);\n\n  if (import.meta.env.DEV && errors.length > 0) {\n    console.warn(`[eidos] warmCache: ${errors.length} handle(s) failed to prefetch`, errors);\n  }\n\n  return {\n    warmed: results.filter((r) => r.status === 'fulfilled').length,\n    failed: errors.length,\n    errors,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"resource.js","names":[],"sources":["../src/resource.ts"],"sourcesContent":["import { useEidosStore } from './store';\nimport { sendToWorker } from './sw-bridge';\nimport type {\n  ResourceConfig,\n  ResourceHandle,\n  PatternResourceHandle,\n  ResourceEntry,\n  GeneratedStrategy,\n  CacheStrategy,\n  WarmCacheResult,\n} from './types';\n\nconst _registry = new Map<string, ResourceHandle | PatternResourceHandle>();\n\n// ── Request deduplication ─────────────────────────────────────────────────────\n// If multiple callers invoke handle.fetch() simultaneously for the same URL,\n// only one network request is made. Each caller gets its own cloned Response.\n// Keyed by URL; entry is deleted when the request settles.\nconst _inflightRequests = /* @__PURE__ */ new Map<string, Promise<Response>>();\n\n// ── TanStack Query bridge (optional) ─────────────────────────────────────────\n// Set by @sweidos/eidos/query when withEidosQueryClient() is called.\n// Lets handle.invalidate() also invalidate the matching TQ cache entry.\ntype QueryInvalidator = (queryKey: [string, string]) => void;\nlet _queryInvalidator: QueryInvalidator | null = null;\n\n/** @internal Called by @sweidos/eidos/query. */\nexport function setQueryInvalidator(fn: QueryInvalidator): void {\n  _queryInvalidator = fn;\n}\n\n// ── URL pattern helpers ───────────────────────────────────────────────────────\n\n/** Returns true if `url` contains wildcard or :param segments. */\nfunction isPattern(url: string): boolean {\n  return url.includes('*') || /:[^/]+/.test(url);\n}\n\n/**\n * Converts a URL pattern to a regex source string for SW fetch matching.\n *  `**`     → multi-segment wildcard  (`.+`)\n *  `*`      → single-segment wildcard (`[^/]+`)\n *  `:param` → named single segment    (`[^/]+`)\n *\n * Special regex characters in the pattern (e.g. `.`) are escaped first so\n * they match literally.\n *\n * @example\n *   patternToRegexStr('/api/products/*')      // '^/api/products/[^/]+$'\n *   patternToRegexStr('/api/products/**')     // '^/api/products/.+$'\n *   patternToRegexStr('/api/users/:id')       // '^/api/users/[^/]+$'\n */\nfunction patternToRegexStr(pattern: string): string {\n  // Escape all regex-special chars except `*`, `/`, `:` (handled below)\n  const escaped = pattern.replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&');\n  return (\n    '^' +\n    escaped\n      .replace(/\\*\\*/g, '.+') // ** → multi-segment wildcard\n      .replace(/\\*/g, '[^/]+') // * → single-segment wildcard\n      .replace(/:[^/]+/g, '[^/]+') + // :param → single-segment wildcard\n    '$'\n  );\n}\n\n/** Shared setup for resource()/resourcePattern(): strategy derivation, store + SW registration. */\nfunction _register(\n  url: string,\n  config: ResourceConfig,\n): { strategy: GeneratedStrategy; regexStr: string | undefined } {\n  const strategy = deriveStrategy(config);\n  const regexStr = isPattern(url) ? patternToRegexStr(url) : undefined;\n\n  const entry: ResourceEntry = {\n    url,\n    config,\n    strategy,\n    status: 'idle',\n    cacheHits: 0,\n    cacheMisses: 0,\n  };\n\n  useEidosStore.getState().registerResource(url, entry);\n\n  sendToWorker({\n    type: 'EIDOS_REGISTER_RESOURCE',\n    url,\n    strategy: strategy.swStrategy,\n    cacheName: strategy.cacheName,\n    ...(regexStr !== undefined && { pattern: regexStr }),\n    ...(config.maxAge !== undefined && { maxAge: config.maxAge }),\n    ...(config.maxEntries !== undefined && { maxEntries: config.maxEntries }),\n  });\n\n  return { strategy, regexStr };\n}\n\nfunction _invalidate(\n  url: string,\n  strategy: GeneratedStrategy,\n  regexStr: string | undefined,\n): () => Promise<void> {\n  return async () => {\n    sendToWorker({ type: 'EIDOS_CLEAR_CACHE', url });\n    const cache = await caches.open(strategy.cacheName).catch(() => null);\n    if (cache) {\n      const keys = await cache.keys();\n      const patternRe = regexStr ? new RegExp(regexStr) : null;\n      const isCrossOrigin = url.startsWith('http');\n      await Promise.all(\n        keys\n          .filter((r) => {\n            const rUrl = r.url;\n            const p = new URL(rUrl).pathname;\n            if (patternRe) {\n              // Cross-origin patterns were compiled from absolute URLs; test full URL.\n              return patternRe.test(isCrossOrigin ? rUrl : p);\n            }\n            return isCrossOrigin ? rUrl === url : rUrl === url || p === url;\n          })\n          .map((r) => cache.delete(r)),\n      );\n    }\n    // For exact-URL resources update the store entry; patterns don't have a\n    // single entry to update (individual URLs are not tracked per-pattern).\n    if (!isPattern(url)) {\n      useEidosStore.getState().updateResource(url, {\n        status: 'stale',\n        cachedAt: undefined,\n        lastEvent: 'cache-cleared',\n        cacheHits: 0,\n        cacheMisses: 0,\n      });\n    }\n    // Notify TanStack Query bridge if registered.\n    _queryInvalidator?.(['eidos', url]);\n  };\n}\n\nfunction _unregister(url: string): () => void {\n  return () => {\n    _registry.delete(url);\n    sendToWorker({ type: 'EIDOS_UNREGISTER_RESOURCE', url });\n    useEidosStore.getState().unregisterResource(url);\n  };\n}\n\nfunction _warnIfReregisteredWithDifferentConfig(\n  url: string,\n  existing: ResourceHandle | PatternResourceHandle,\n  config: ResourceConfig,\n  factoryName: string,\n): void {\n  if (!import.meta.env.DEV) return;\n  const existingCfg = existing.config;\n  if (\n    existingCfg.offline !== config.offline ||\n    existingCfg.strategy !== config.strategy ||\n    existingCfg.cacheName !== config.cacheName ||\n    existingCfg.version !== config.version\n  ) {\n    console.warn(\n      `[eidos] ${factoryName}('${url}') already registered with a different config — returning cached handle. Call handle.unregister() first to re-register.`,\n      { registered: existingCfg, ignored: config },\n    );\n  }\n}\n\n// ── resource() ────────────────────────────────────────────────────────────────\n\n/**\n * Registers a concrete-URL resource. For URL patterns (`/api/products/*`,\n * `/api/users/:id`, `**`), use `resourcePattern()` instead.\n */\nexport function resource<T = unknown>(url: string, config: ResourceConfig): ResourceHandle<T> {\n  if (isPattern(url)) {\n    throw new Error(\n      `[eidos] resource('${url}') is a URL pattern — use resourcePattern('${url}', config) instead. ` +\n        `Pattern handles only support invalidate()/unregister(); the SW intercepts matching requests automatically.`,\n    );\n  }\n\n  if (_registry.has(url)) {\n    const existing = _registry.get(url)!;\n    _warnIfReregisteredWithDifferentConfig(url, existing, config, 'resource');\n    return existing as ResourceHandle<T>;\n  }\n\n  const { strategy } = _register(url, config);\n\n  const handle: ResourceHandle<T> = {\n    url,\n    config,\n    strategy,\n\n    fetch: async () => {\n      // ── Deduplication: coalesce concurrent fetches for the same URL ─────\n      // If a request is already in-flight, piggyback on it and return a clone\n      // so each caller gets an independent readable Response body.\n      const existing = _inflightRequests.get(url);\n      if (existing) return existing.then((r) => r.clone());\n\n      // Store the raw-response promise. All callers (including the primary)\n      // receive a clone — the raw response stays unconsumed in the map so\n      // any caller arriving while the promise is still pending can clone it.\n      const task = _fetchResource(url, config, strategy);\n      _inflightRequests.set(url, task);\n      // .catch() silences the unhandled-rejection on the cleanup promise;\n      // the error still propagates to callers via task.then() below.\n      task.finally(() => _inflightRequests.delete(url)).catch(() => {});\n      return task.then((r) => r.clone());\n    },\n\n    json: async () => {\n      const res = await handle.fetch();\n      return res.json() as Promise<T>;\n    },\n\n    query: () => ({\n      queryKey: ['eidos', url] as [string, string],\n      queryFn: () => handle.json(),\n    }),\n\n    prefetch: async () => {\n      await handle.fetch();\n    },\n\n    invalidate: _invalidate(url, strategy, undefined),\n    unregister: _unregister(url),\n  };\n\n  _registry.set(url, handle);\n  return handle;\n}\n\n// ── resourcePattern() ────────────────────────────────────────────────────────\n\n/**\n * Registers a URL pattern (`/api/products/*`, `/api/users/:id`, `**`). The SW\n * intercepts all matching requests automatically — there is no single URL to\n * fetch/cache directly, so the returned handle only supports cache management\n * (`invalidate`/`unregister`). For a fetchable resource, use `resource()`.\n */\nexport function resourcePattern(url: string, config: ResourceConfig): PatternResourceHandle {\n  if (!isPattern(url)) {\n    throw new Error(\n      `[eidos] resourcePattern('${url}') is not a URL pattern — use resource('${url}', config) instead.`,\n    );\n  }\n\n  if (_registry.has(url)) {\n    const existing = _registry.get(url)!;\n    _warnIfReregisteredWithDifferentConfig(url, existing, config, 'resourcePattern');\n    return existing as PatternResourceHandle;\n  }\n\n  const { strategy, regexStr } = _register(url, config);\n\n  const handle: PatternResourceHandle = {\n    url,\n    config,\n    strategy,\n    invalidate: _invalidate(url, strategy, regexStr),\n    unregister: _unregister(url),\n  };\n\n  _registry.set(url, handle);\n  return handle;\n}\n\n// ── _fetchResource ─────────────────────────────────────────────────────────────\n// The actual network/cache implementation. Separated from handle.fetch() so the\n// deduplication wrapper can store the Promise and share it across concurrent callers.\n// Returns the raw (unconsumed) Response — callers MUST .clone() before reading body.\nasync function _fetchResource(\n  url: string,\n  config: ResourceConfig,\n  strategy: GeneratedStrategy,\n): Promise<Response> {\n  const store = useEidosStore.getState();\n  store.updateResource(url, { status: 'fetching', fetchedAt: Date.now() });\n\n  // Open cache once and reuse across try/catch — avoids a redundant\n  // caches.open() call in the error fallback path.\n  const cache = await caches.open(strategy.cacheName).catch(() => null);\n\n  try {\n    // ── network-first: skip cache check, go straight to network ─────────\n    // For cache-first / SWR the cache check below is correct. For\n    // network-first, reading cache first and returning early would\n    // contradict the strategy — fresh data is the priority.\n    if (strategy.swStrategy !== 'network-first') {\n      // ── Direct Cache API check ─────────────────────────────────────────\n      // We read the cache in the main thread rather than waiting for\n      // an async SW postMessage. This gives instant, reliable status\n      // updates regardless of SW message timing.\n      const cached = cache ? await cache.match(url).catch(() => null) : null;\n\n      // Treat cache as miss if maxAge exceeded\n      const current = useEidosStore.getState().resources[url];\n      const expired =\n        config.maxAge !== undefined &&\n        current?.cachedAt !== undefined &&\n        Date.now() - current.cachedAt > config.maxAge;\n\n      if (cached && !expired) {\n        store.updateResource(url, {\n          status: 'fresh',\n          lastEvent: 'cache-hit',\n          cacheHits: (current?.cacheHits ?? 0) + 1,\n        });\n\n        // Background revalidation for SWR (stale-while-revalidate)\n        if (strategy.swStrategy === 'stale-while-revalidate') {\n          fetch(url, { signal: AbortSignal.timeout(5000) })\n            .then(async (resp) => {\n              if (resp.ok && cache) {\n                await cache.put(url, resp.clone());\n                useEidosStore.getState().updateResource(url, {\n                  cachedAt: Date.now(),\n                  lastEvent: 'cache-updated',\n                });\n              }\n            })\n            .catch(() => {\n              /* offline or timed out — cached version stays valid */\n            });\n        }\n\n        return cached;\n      }\n\n      // Cache miss (or expired)\n      const storeEntry = useEidosStore.getState().resources[url];\n      store.updateResource(url, {\n        cacheMisses: (storeEntry?.cacheMisses ?? 0) + 1,\n      });\n    }\n\n    const response = await fetch(url);\n\n    if (response.ok) {\n      if (cache) await cache.put(url, response.clone());\n      store.updateResource(url, {\n        status: 'fresh',\n        cachedAt: Date.now(),\n        lastEvent: 'cache-updated',\n      });\n      return response;\n    }\n\n    // Non-2xx response (e.g. 503 from offline SW) — update status and throw\n    // so callers get a proper error instead of a plain-object body they can't use.\n    store.updateResource(url, { status: response.status === 503 ? 'offline' : 'error' });\n\n    // Check if the SW tagged this as an offline response\n    const isOffline = response.headers.get('X-Eidos-Offline') === 'true';\n    throw new Error(\n      isOffline\n        ? `offline: no cached response for ${url}`\n        : `${response.status} ${response.statusText}`,\n    );\n  } catch (err) {\n    // Network failure — try cache one more time as fallback\n    const fallback = cache ? await cache.match(url).catch(() => null) : null;\n\n    if (fallback) {\n      const current = useEidosStore.getState().resources[url];\n      store.updateResource(url, {\n        status: 'fresh',\n        lastEvent: 'cache-hit',\n        cacheHits: (current?.cacheHits ?? 0) + 1,\n      });\n      return fallback;\n    }\n\n    store.updateResource(url, { status: 'error' });\n    throw err;\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Strategy derivation — intent → deterministic caching strategy\n// ─────────────────────────────────────────────────────────────────────────────\n\nfunction deriveStrategy(config: ResourceConfig): GeneratedStrategy {\n  const explicit = config.strategy;\n  if (config.offline) {\n    return buildStrategy(explicit ?? 'stale-while-revalidate', config.cacheName, config.version);\n  }\n  return buildStrategy(explicit ?? 'network-first', config.cacheName, config.version);\n}\n\n// Strategy display names — always included (tiny, used by devtools).\nconst STRATEGY_NAMES: Record<CacheStrategy, string> = {\n  'stale-while-revalidate': 'StaleWhileRevalidate',\n  'cache-first': 'CacheFirst',\n  'network-first': 'NetworkFirst',\n};\n\n// Heavy descriptive strings — stripped from production bundles by Vite's\n// import.meta.env.DEV dead-code elimination. Only the names above ship in prod.\ntype StrategyDevInfo = Pick<GeneratedStrategy, 'reasoning' | 'behavior' | 'equivalentCode'>;\nconst _STRATEGY_DEV_META: Record<CacheStrategy, StrategyDevInfo> = {\n  'stale-while-revalidate': {\n    reasoning:\n      'offline: true signals resilience. SWR returns cached data instantly while revalidating in the background — the best tradeoff between speed and freshness for offline-capable resources.',\n    behavior: [\n      'Cache hit → return immediately, kick off background revalidation',\n      'Cache miss → fetch from network, cache the response, return it',\n      'Offline → return cached version if available, 503 if not',\n      'Reconnect → next request triggers a background refresh',\n    ],\n    equivalentCode: `// Workbox equivalent (maxEntries/maxAge are configured via ResourceConfig)\nnew StaleWhileRevalidate({\n  cacheName: 'eidos-resources-v1',\n  plugins: [new ExpirationPlugin({ maxEntries: config.maxEntries, maxAgeSeconds: config.maxAge && config.maxAge / 1000 })],\n})`,\n  },\n  'cache-first': {\n    reasoning:\n      'cache-first maximises speed and offline availability. Network is consulted only on cache miss. Best for static or infrequently-updated data.',\n    behavior: [\n      'Cache hit → return immediately, no network request made',\n      'Cache miss → fetch from network, cache the response, return it',\n      'Offline → return cached version, 503 if cache is empty',\n      'Cache never expires unless maxAge is set or explicitly invalidated',\n    ],\n    equivalentCode: `// Workbox equivalent (maxEntries/maxAge are configured via ResourceConfig)\nnew CacheFirst({\n  cacheName: 'eidos-resources-v1',\n  plugins: [new ExpirationPlugin({ maxEntries: config.maxEntries, maxAgeSeconds: config.maxAge && config.maxAge / 1000 })],\n})`,\n  },\n  'network-first': {\n    reasoning:\n      'network-first prioritises fresh data. Cache acts as a safety net when offline. Best for frequently-updated resources where stale data causes problems.',\n    behavior: [\n      'Always try network first',\n      'Network success → update cache, return fresh response',\n      'Network failure → fall back to cached version',\n      'Offline with empty cache → return 503 error response',\n    ],\n    equivalentCode: `// Workbox equivalent\nnew NetworkFirst({\n  cacheName: 'eidos-resources-v1',\n  networkTimeoutSeconds: 3,\n})`,\n  },\n};\n\nfunction buildStrategy(\n  swStrategy: CacheStrategy,\n  cacheName?: string,\n  version?: string | number,\n): GeneratedStrategy {\n  const meta = _STRATEGY_DEV_META[swStrategy];\n  const baseName = cacheName ?? 'eidos-resources-v1';\n  return {\n    name: STRATEGY_NAMES[swStrategy],\n    swStrategy,\n    cacheName: version !== undefined ? `${baseName}-v${version}` : baseName,\n    // reasoning + behavior are rendered by the playground UI from live ResourceEntry objects —\n    // keep them in all builds. equivalentCode is a static code block only used in DEV tools.\n    reasoning: meta.reasoning,\n    behavior: meta.behavior,\n    equivalentCode: import.meta.env.DEV ? meta.equivalentCode : '',\n  };\n}\n\n// ── warmCache ─────────────────────────────────────────────────────────────────\n\n/**\n * Bulk-prefetch an array of resource handles concurrently, warming the cache\n * for each one. Useful on login / app init when you know which resources the\n * user will need offline.\n *\n * Pattern handles (containing `*`, `**`, or `:param`) are silently skipped —\n * they match multiple URLs so there is no single URL to prefetch.\n *\n * @example\n * import { warmCache } from '@sweidos/eidos'\n *\n * // In EidosProvider's onReady, or after login:\n * const { warmed, failed } = await warmCache([products, userProfile, settings])\n */\nexport async function warmCache(handles: ResourceHandle[]): Promise<WarmCacheResult> {\n  const results = await Promise.allSettled(handles.map((h) => h.prefetch()));\n  const errors = results\n    .filter((r): r is PromiseRejectedResult => r.status === 'rejected')\n    .map((r) => r.reason);\n\n  if (import.meta.env.DEV && errors.length > 0) {\n    console.warn(`[eidos] warmCache: ${errors.length} handle(s) failed to prefetch`, errors);\n  }\n\n  return {\n    warmed: results.filter((r) => r.status === 'fulfilled').length,\n    failed: errors.length,\n    errors,\n  };\n}\n"],"mappings":"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"}

package/dist/runtime-rn.d.ts

@@ -1,5 +1,4 @@
 import { AsyncStorageLike } from './index.ts';
-
 export interface EidosRNConfig {
     /** AsyncStorage singleton (or any AsyncStorageLike key-value store). */
     storage: AsyncStorageLike;

package/dist/runtime.d.ts

@@ -0,0 +1,39 @@
+import { ReliabilityStats } from './types';
+export interface EidosConfig {
+    /** Path to the eidos service worker. Defaults to '/eidos-sw.js'. */
+    swPath?: string;
+    /** Automatically replay the action queue on reconnect. Default: true. */
+    autoReplay?: boolean;
+    /**
+     * When `true` (default), the new service worker activates immediately when an
+     * update is available — matching the pre-v2.3 behaviour. Set to `false` to opt
+     * into a toast-then-reload pattern: `onUpdateAvailable` fires instead and you
+     * call `triggerSwUpdate()` when the user confirms the reload.
+     *
+     * Note: avoid calling `triggerSwUpdate()` while `neverLose` actions are mid-replay
+     * — the BroadcastChannel/Web-Locks replay coordination survives SW activation, but
+     * triggering an update during an active replay pass is unnecessary churn.
+     */
+    skipWaiting?: boolean;
+    /**
+     * Called when a new service worker version has installed and is waiting to
+     * activate. Use this to show a "reload to update" toast. Only fires when
+     * `skipWaiting: false`; with the default `skipWaiting: true` the update
+     * applies automatically and this callback is never needed.
+     *
+     * Call `triggerSwUpdate()` when the user confirms the reload — it tells the
+     * waiting SW to activate, then reload the page.
+     */
+    onUpdateAvailable?: (registration: ServiceWorkerRegistration) => void;
+    /**
+     * Opt-in reliability telemetry. Called with a snapshot of cumulative
+     * `neverLose` queue outcome counters (`ReliabilityStats`) every
+     * `reliabilityReportInterval` ms — wire this up to your analytics backend.
+     * Not called if omitted.
+     */
+    onReliabilityReport?: (stats: ReliabilityStats) => void;
+    /** Interval (ms) between `onReliabilityReport` calls. Default: 60000. */
+    reliabilityReportInterval?: number;
+}
+export declare function initEidos(config?: EidosConfig): Promise<void>;
+export declare function _resetEidos(): void;

package/dist/runtime.js

@@ -1,10 +1,10 @@
 import { useEidosStore as n } from "./store.js";
-import { registerBgSyncHandler as c, registerServiceWorker as y } from "./sw-bridge.js";
-import { idbGetQueue as m, idbQueueStorage as p } from "./idb.js";
-import { _getQueueStorage as d } from "./queue-storage.js";
+import { registerBgSyncHandler as p, registerServiceWorker as y } from "./sw-bridge.js";
+import { idbGetQueue as m, idbQueueStorage as d } from "./idb.js";
+import { _getQueueStorage as b } from "./queue-storage.js";
 import { subscribeQueueSync as f } from "./queue-sync.js";
-import { replayQueue as b } from "./action.js";
-import { subscribeReplayOnReconnect as h } from "./replay.js";
+import { replayQueue as h } from "./action.js";
+import { subscribeReplayOnReconnect as v } from "./replay.js";
 async function R(e) {
   if (e.schemaVersion === 2 && e.idempotencyKey) return e;
   const t = {
@@ -12,44 +12,47 @@ async function R(e) {
     schemaVersion: 2,
     idempotencyKey: e.idempotencyKey ?? crypto.randomUUID()
   };
-  return await (d() ?? p).update(t.id, {
+  return await (b() ?? d).update(t.id, {
     schemaVersion: t.schemaVersion,
     idempotencyKey: t.idempotencyKey
   }).catch(() => {
   }), t;
 }
-var o = !1, s = null, u = null, i = null;
-async function K(e = {}) {
+var o = !1, s = null, u = null, r = null;
+async function U(e = {}) {
   if (typeof window > "u" || o) return;
   o = !0;
-  const t = e.swPath ?? "/eidos-sw.js", l = e.autoReplay ?? !0;
+  const t = e.swPath ?? "/eidos-sw.js", l = e.autoReplay ?? !0, c = e.skipWaiting ?? !0;
   try {
-    const r = await m();
-    if (r.length > 0) {
-      const a = await Promise.all(r.map(R));
+    const i = await m();
+    if (i.length > 0) {
+      const a = await Promise.all(i.map(R));
       n.getState().hydrateQueue(a);
     }
   } catch {
   }
   try {
-    await y(t);
+    await y(t, {
+      skipWaiting: c,
+      onUpdateAvailable: e.onUpdateAvailable
+    });
   } catch {
   }
-  if (c(() => {
-    n.getState().isOnline && setTimeout(b, 200);
-  }), l && (s = h()), u = f(), e.onReliabilityReport) {
-    const r = e.reliabilityReportInterval ?? 6e4, a = e.onReliabilityReport;
-    i = setInterval(() => {
+  if (p(() => {
+    n.getState().isOnline && setTimeout(h, 200);
+  }), l && (s = v()), u = f(), e.onReliabilityReport) {
+    const i = e.reliabilityReportInterval ?? 6e4, a = e.onReliabilityReport;
+    r = setInterval(() => {
       a(n.getState().reliability);
-    }, r);
+    }, i);
   }
 }
 function V() {
-  s?.(), s = null, u?.(), u = null, i && clearInterval(i), i = null, o = !1;
+  s?.(), s = null, u?.(), u = null, r && clearInterval(r), r = null, o = !1;
 }
 export {
   V as _resetEidos,
-  K as initEidos
+  U as initEidos
 };
 
 //# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","names":[],"sources":["../src/runtime.ts"],"sourcesContent":["import { registerServiceWorker, registerBgSyncHandler } from './sw-bridge';\nimport { replayQueue } from './action';\nimport { useEidosStore } from './store';\nimport { idbGetQueue, idbQueueStorage } from './idb';\nimport { _getQueueStorage } from './queue-storage';\nimport { subscribeReplayOnReconnect } from './replay';\nimport { subscribeQueueSync } from './queue-sync';\nimport { CURRENT_QUEUE_SCHEMA_VERSION } from './types';\nimport type { ActionQueueItem, ReliabilityStats } from './types';\n\n// Items persisted before idempotencyKey/schemaVersion existed (v1) are migrated\n// in place: assign a fresh idempotencyKey and bump schemaVersion. A fresh key on\n// first replay after upgrade is correct — these items were never sent with one.\nasync function migrateQueueItem(item: ActionQueueItem): Promise<ActionQueueItem> {\n  if (item.schemaVersion === CURRENT_QUEUE_SCHEMA_VERSION && item.idempotencyKey) {\n    return item;\n  }\n  const migrated: ActionQueueItem = {\n    ...item,\n    schemaVersion: CURRENT_QUEUE_SCHEMA_VERSION,\n    idempotencyKey: item.idempotencyKey ?? crypto.randomUUID(),\n  };\n  const storage = _getQueueStorage() ?? idbQueueStorage;\n  await storage\n    .update(migrated.id, {\n      schemaVersion: migrated.schemaVersion,\n      idempotencyKey: migrated.idempotencyKey,\n    })\n    .catch(() => {\n      // Best-effort persist — item still gets the migrated shape in memory this session\n    });\n  return migrated;\n}\n\nexport interface EidosConfig {\n  /** Path to the eidos service worker. Defaults to '/eidos-sw.js'. */\n  swPath?: string;\n  /** Automatically replay the action queue on reconnect. Default: true. */\n  autoReplay?: boolean;\n  /**\n   * Opt-in reliability telemetry. Called with a snapshot of cumulative\n   * `neverLose` queue outcome counters (`ReliabilityStats`) every\n   * `reliabilityReportInterval` ms — wire this up to your analytics backend.\n   * Not called if omitted.\n   */\n  onReliabilityReport?: (stats: ReliabilityStats) => void;\n  /** Interval (ms) between `onReliabilityReport` calls. Default: 60000. */\n  reliabilityReportInterval?: number;\n}\n\nlet _initialized = false;\nlet _unsubscribe: (() => void) | null = null;\nlet _unsubscribeQueueSync: (() => void) | null = null;\nlet _reliabilityReportTimer: ReturnType<typeof setInterval> | null = null;\n\nexport async function initEidos(config: EidosConfig = {}): Promise<void> {\n  // Skip silently during SSR — SW, IndexedDB, and window are browser-only.\n  if (typeof window === 'undefined') return;\n  if (_initialized) return;\n  _initialized = true;\n\n  const swPath = config.swPath ?? '/eidos-sw.js';\n  const autoReplay = config.autoReplay ?? true;\n\n  // Restore persisted queue from IndexedDB on startup\n  try {\n    const persisted = await idbGetQueue();\n    if (persisted.length > 0) {\n      const migrated = await Promise.all(persisted.map(migrateQueueItem));\n      useEidosStore.getState().hydrateQueue(migrated);\n    }\n  } catch {\n    // IndexedDB unavailable (Firefox private browsing) — silent fallback\n  }\n\n  try {\n    await registerServiceWorker(swPath);\n  } catch {\n    // SW registration failed; app continues without offline support\n  }\n\n  // When the SW fires the Background Sync tag, replay the queue in the main thread.\n  // This path runs even if the user briefly navigated away and back — the browser\n  // triggers the sync event on the SW, which wakes up all open clients.\n  registerBgSyncHandler(() => {\n    if (useEidosStore.getState().isOnline) {\n      setTimeout(replayQueue, 200);\n    }\n  });\n\n  if (autoReplay) {\n    _unsubscribe = subscribeReplayOnReconnect();\n  }\n\n  // Apply queue-item status changes broadcast by the replay-lock holder so\n  // non-leader tabs reflect live status without waiting for re-hydration.\n  _unsubscribeQueueSync = subscribeQueueSync();\n\n  if (config.onReliabilityReport) {\n    const interval = config.reliabilityReportInterval ?? 60_000;\n    const report = config.onReliabilityReport;\n    _reliabilityReportTimer = setInterval(() => {\n      report(useEidosStore.getState().reliability);\n    }, interval);\n  }\n\n  if (import.meta.env.DEV) {\n    const store = useEidosStore.getState();\n    console.groupCollapsed('%c⚡ Eidos', 'color:#22C55E;font-weight:bold');\n    console.log('SW path    :', swPath);\n    console.log('Auto-replay:', autoReplay);\n    console.log('SW status  :', store.swStatus);\n    console.groupEnd();\n  }\n}\n\nexport function _resetEidos() {\n  _unsubscribe?.();\n  _unsubscribe = null;\n  _unsubscribeQueueSync?.();\n  _unsubscribeQueueSync = null;\n  if (_reliabilityReportTimer) clearInterval(_reliabilityReportTimer);\n  _reliabilityReportTimer = null;\n  _initialized = false;\n}\n"],"mappings":";;;;;;;AAaA,eAAe,EAAiB,GAAiD;AAC/E,MAAI,EAAK,kBAAA,KAAkD,EAAK,eAC9D,QAAO;AAET,QAAM,IAA4B;AAAA,IAChC,GAAG;AAAA,IACH,eAAA;AAAA,IACA,gBAAgB,EAAK,kBAAkB,OAAO,WAAW;AAAA,EAC3D;AAEA,gBADgB,EAAiB,KAAK,GAEnC,OAAO,EAAS,IAAI;AAAA,IACnB,eAAe,EAAS;AAAA,IACxB,gBAAgB,EAAS;AAAA,EAC3B,CAAC,EACA,MAAA,MAAY;AAAA,EAEb,CAAC,GACI;AACT;AAkBA,IAAI,IAAe,IACf,IAAoC,MACpC,IAA6C,MAC7C,IAAiE;AAErE,eAAsB,EAAU,IAAsB,CAAC,GAAkB;AAGvE,MADI,OAAO,SAAW,OAClB,EAAc;AAClB,EAAA,IAAe;AAEf,QAAM,IAAS,EAAO,UAAU,gBAC1B,IAAa,EAAO,cAAc;AAGxC,MAAI;AACF,UAAM,IAAY,MAAM,EAAY;AACpC,QAAI,EAAU,SAAS,GAAG;AACxB,YAAM,IAAW,MAAM,QAAQ,IAAI,EAAU,IAAI,CAAgB,CAAC;AAClE,MAAA,EAAc,SAAS,EAAE,aAAa,CAAQ;AAAA,IAChD;AAAA,EACF,QAAQ;AAAA,EAER;AAEA,MAAI;AACF,UAAM,EAAsB,CAAM;AAAA,EACpC,QAAQ;AAAA,EAER;AAmBA,MAdA,EAAA,MAA4B;AAC1B,IAAI,EAAc,SAAS,EAAE,YAC3B,WAAW,GAAa,GAAG;AAAA,EAE/B,CAAC,GAEG,MACF,IAAe,EAA2B,IAK5C,IAAwB,EAAmB,GAEvC,EAAO,qBAAqB;AAC9B,UAAM,IAAW,EAAO,6BAA6B,KAC/C,IAAS,EAAO;AACtB,IAAA,IAA0B,YAAA,MAAkB;AAC1C,MAAA,EAAO,EAAc,SAAS,EAAE,WAAW;AAAA,IAC7C,GAAG,CAAQ;AAAA,EACb;AAUF;AAEA,SAAgB,IAAc;AAC5B,EAAA,IAAe,GACf,IAAe,MACf,IAAwB,GACxB,IAAwB,MACpB,KAAyB,cAAc,CAAuB,GAClE,IAA0B,MAC1B,IAAe;AACjB"}
+{"version":3,"file":"runtime.js","names":[],"sources":["../src/runtime.ts"],"sourcesContent":["import { registerServiceWorker, registerBgSyncHandler } from './sw-bridge';\nimport { replayQueue } from './action';\nimport { useEidosStore } from './store';\nimport { idbGetQueue, idbQueueStorage } from './idb';\nimport { _getQueueStorage } from './queue-storage';\nimport { subscribeReplayOnReconnect } from './replay';\nimport { subscribeQueueSync } from './queue-sync';\nimport { CURRENT_QUEUE_SCHEMA_VERSION } from './types';\nimport type { ActionQueueItem, ReliabilityStats } from './types';\n\n// Items persisted before idempotencyKey/schemaVersion existed (v1) are migrated\n// in place: assign a fresh idempotencyKey and bump schemaVersion. A fresh key on\n// first replay after upgrade is correct — these items were never sent with one.\nasync function migrateQueueItem(item: ActionQueueItem): Promise<ActionQueueItem> {\n  if (item.schemaVersion === CURRENT_QUEUE_SCHEMA_VERSION && item.idempotencyKey) {\n    return item;\n  }\n  const migrated: ActionQueueItem = {\n    ...item,\n    schemaVersion: CURRENT_QUEUE_SCHEMA_VERSION,\n    idempotencyKey: item.idempotencyKey ?? crypto.randomUUID(),\n  };\n  const storage = _getQueueStorage() ?? idbQueueStorage;\n  await storage\n    .update(migrated.id, {\n      schemaVersion: migrated.schemaVersion,\n      idempotencyKey: migrated.idempotencyKey,\n    })\n    .catch(() => {\n      // Best-effort persist — item still gets the migrated shape in memory this session\n    });\n  return migrated;\n}\n\nexport interface EidosConfig {\n  /** Path to the eidos service worker. Defaults to '/eidos-sw.js'. */\n  swPath?: string;\n  /** Automatically replay the action queue on reconnect. Default: true. */\n  autoReplay?: boolean;\n  /**\n   * When `true` (default), the new service worker activates immediately when an\n   * update is available — matching the pre-v2.3 behaviour. Set to `false` to opt\n   * into a toast-then-reload pattern: `onUpdateAvailable` fires instead and you\n   * call `triggerSwUpdate()` when the user confirms the reload.\n   *\n   * Note: avoid calling `triggerSwUpdate()` while `neverLose` actions are mid-replay\n   * — the BroadcastChannel/Web-Locks replay coordination survives SW activation, but\n   * triggering an update during an active replay pass is unnecessary churn.\n   */\n  skipWaiting?: boolean;\n  /**\n   * Called when a new service worker version has installed and is waiting to\n   * activate. Use this to show a \"reload to update\" toast. Only fires when\n   * `skipWaiting: false`; with the default `skipWaiting: true` the update\n   * applies automatically and this callback is never needed.\n   *\n   * Call `triggerSwUpdate()` when the user confirms the reload — it tells the\n   * waiting SW to activate, then reload the page.\n   */\n  onUpdateAvailable?: (registration: ServiceWorkerRegistration) => void;\n  /**\n   * Opt-in reliability telemetry. Called with a snapshot of cumulative\n   * `neverLose` queue outcome counters (`ReliabilityStats`) every\n   * `reliabilityReportInterval` ms — wire this up to your analytics backend.\n   * Not called if omitted.\n   */\n  onReliabilityReport?: (stats: ReliabilityStats) => void;\n  /** Interval (ms) between `onReliabilityReport` calls. Default: 60000. */\n  reliabilityReportInterval?: number;\n}\n\nlet _initialized = false;\nlet _unsubscribe: (() => void) | null = null;\nlet _unsubscribeQueueSync: (() => void) | null = null;\nlet _reliabilityReportTimer: ReturnType<typeof setInterval> | null = null;\n\nexport async function initEidos(config: EidosConfig = {}): Promise<void> {\n  // Skip silently during SSR — SW, IndexedDB, and window are browser-only.\n  if (typeof window === 'undefined') return;\n  if (_initialized) return;\n  _initialized = true;\n\n  const swPath = config.swPath ?? '/eidos-sw.js';\n  const autoReplay = config.autoReplay ?? true;\n  const skipWaiting = config.skipWaiting ?? true;\n\n  // Restore persisted queue from IndexedDB on startup\n  try {\n    const persisted = await idbGetQueue();\n    if (persisted.length > 0) {\n      const migrated = await Promise.all(persisted.map(migrateQueueItem));\n      useEidosStore.getState().hydrateQueue(migrated);\n    }\n  } catch {\n    // IndexedDB unavailable (Firefox private browsing) — silent fallback\n  }\n\n  try {\n    await registerServiceWorker(swPath, {\n      skipWaiting,\n      onUpdateAvailable: config.onUpdateAvailable,\n    });\n  } catch {\n    // SW registration failed; app continues without offline support\n  }\n\n  // When the SW fires the Background Sync tag, replay the queue in the main thread.\n  // This path runs even if the user briefly navigated away and back — the browser\n  // triggers the sync event on the SW, which wakes up all open clients.\n  registerBgSyncHandler(() => {\n    if (useEidosStore.getState().isOnline) {\n      setTimeout(replayQueue, 200);\n    }\n  });\n\n  if (autoReplay) {\n    _unsubscribe = subscribeReplayOnReconnect();\n  }\n\n  // Apply queue-item status changes broadcast by the replay-lock holder so\n  // non-leader tabs reflect live status without waiting for re-hydration.\n  _unsubscribeQueueSync = subscribeQueueSync();\n\n  if (config.onReliabilityReport) {\n    const interval = config.reliabilityReportInterval ?? 60_000;\n    const report = config.onReliabilityReport;\n    _reliabilityReportTimer = setInterval(() => {\n      report(useEidosStore.getState().reliability);\n    }, interval);\n  }\n\n  if (import.meta.env.DEV) {\n    const store = useEidosStore.getState();\n    console.groupCollapsed('%c⚡ Eidos', 'color:#22C55E;font-weight:bold');\n    console.log('SW path    :', swPath);\n    console.log('Auto-replay:', autoReplay);\n    console.log('SW status  :', store.swStatus);\n    console.groupEnd();\n  }\n}\n\nexport function _resetEidos() {\n  _unsubscribe?.();\n  _unsubscribe = null;\n  _unsubscribeQueueSync?.();\n  _unsubscribeQueueSync = null;\n  if (_reliabilityReportTimer) clearInterval(_reliabilityReportTimer);\n  _reliabilityReportTimer = null;\n  _initialized = false;\n}\n"],"mappings":";;;;;;;AAaA,eAAe,EAAiB,GAAiD;AAC/E,MAAI,EAAK,kBAAA,KAAkD,EAAK,eAC9D,QAAO;AAET,QAAM,IAA4B;AAAA,IAChC,GAAG;AAAA,IACH,eAAA;AAAA,IACA,gBAAgB,EAAK,kBAAkB,OAAO,WAAW;AAAA,EAC3D;AAEA,gBADgB,EAAiB,KAAK,GAEnC,OAAO,EAAS,IAAI;AAAA,IACnB,eAAe,EAAS;AAAA,IACxB,gBAAgB,EAAS;AAAA,EAC3B,CAAC,EACA,MAAA,MAAY;AAAA,EAEb,CAAC,GACI;AACT;AAuCA,IAAI,IAAe,IACf,IAAoC,MACpC,IAA6C,MAC7C,IAAiE;AAErE,eAAsB,EAAU,IAAsB,CAAC,GAAkB;AAGvE,MADI,OAAO,SAAW,OAClB,EAAc;AAClB,EAAA,IAAe;AAEf,QAAM,IAAS,EAAO,UAAU,gBAC1B,IAAa,EAAO,cAAc,IAClC,IAAc,EAAO,eAAe;AAG1C,MAAI;AACF,UAAM,IAAY,MAAM,EAAY;AACpC,QAAI,EAAU,SAAS,GAAG;AACxB,YAAM,IAAW,MAAM,QAAQ,IAAI,EAAU,IAAI,CAAgB,CAAC;AAClE,MAAA,EAAc,SAAS,EAAE,aAAa,CAAQ;AAAA,IAChD;AAAA,EACF,QAAQ;AAAA,EAER;AAEA,MAAI;AACF,UAAM,EAAsB,GAAQ;AAAA,MAClC,aAAA;AAAA,MACA,mBAAmB,EAAO;AAAA,IAC5B,CAAC;AAAA,EACH,QAAQ;AAAA,EAER;AAmBA,MAdA,EAAA,MAA4B;AAC1B,IAAI,EAAc,SAAS,EAAE,YAC3B,WAAW,GAAa,GAAG;AAAA,EAE/B,CAAC,GAEG,MACF,IAAe,EAA2B,IAK5C,IAAwB,EAAmB,GAEvC,EAAO,qBAAqB;AAC9B,UAAM,IAAW,EAAO,6BAA6B,KAC/C,IAAS,EAAO;AACtB,IAAA,IAA0B,YAAA,MAAkB;AAC1C,MAAA,EAAO,EAAc,SAAS,EAAE,WAAW;AAAA,IAC7C,GAAG,CAAQ;AAAA,EACb;AAUF;AAEA,SAAgB,IAAc;AAC5B,EAAA,IAAe,GACf,IAAe,MACf,IAAwB,GACxB,IAAwB,MACpB,KAAyB,cAAc,CAAuB,GAClE,IAA0B,MAC1B,IAAe;AACjB"}

package/dist/store-slices.d.ts

@@ -0,0 +1,26 @@
+import { ResourceEntry, ActionQueueItem, ReliabilityStats } from './types';
+import { EidosStore } from './store';
+type Setter = (updater: (prev: EidosStore) => Partial<EidosStore>) => void;
+export interface ResourceActions {
+    registerResource: (url: string, entry: ResourceEntry) => void;
+    updateResource: (url: string, update: Partial<ResourceEntry>) => void;
+    unregisterResource: (url: string) => void;
+}
+export declare function createResourceActions(set: Setter): ResourceActions;
+export interface QueueActions {
+    addQueueItem: (item: ActionQueueItem) => void;
+    updateQueueItem: (id: string, update: Partial<ActionQueueItem>) => void;
+    batchUpdateQueueItems: (updates: Array<{
+        id: string;
+        update: Partial<ActionQueueItem>;
+    }>) => void;
+    removeQueueItem: (id: string) => void;
+    hydrateQueue: (items: ActionQueueItem[]) => void;
+}
+export declare function createQueueActions(set: Setter): QueueActions;
+export interface ReliabilityActions {
+    recordReliabilityEvent: (event: keyof ReliabilityStats) => void;
+    resetReliabilityStats: () => void;
+}
+export declare function createReliabilityActions(set: Setter): ReliabilityActions;
+export {};

package/dist/store.d.ts

@@ -0,0 +1,15 @@
+import { EidosState } from './types';
+import { ResourceActions, QueueActions, ReliabilityActions } from './store-slices';
+export interface EidosStore extends EidosState, ResourceActions, QueueActions, ReliabilityActions {
+    setOnline: (online: boolean) => void;
+    setSwStatus: (status: EidosState['swStatus'], error?: string) => void;
+}
+type Listener = () => void;
+declare function _getState(): EidosStore;
+declare function _subscribe(listener: Listener): () => void;
+export declare const useEidosStore: {
+    getState: typeof _getState;
+    subscribe: typeof _subscribe;
+    setState: (partial: Partial<EidosStore> | ((s: EidosStore) => Partial<EidosStore>)) => void;
+};
+export {};

package/dist/stores.d.ts

@@ -0,0 +1,64 @@
+import { EidosStore } from './store';
+import { ActionQueueItem, ResourceEntry, ReliabilityStats } from './types';
+export interface EidosReadable<T> {
+    /** Subscribe to value changes. Returns an unsubscribe function. */
+    subscribe(run: (value: T) => void): () => void;
+    /** Read the current value synchronously without subscribing. */
+    getState(): T;
+}
+/** Full Eidos state snapshot. Prefer the narrower stores below. */
+export declare const eidosStore: EidosReadable<EidosStore>;
+/** The action queue. Re-notifies on every queue mutation. */
+export declare const eidosQueue: EidosReadable<ActionQueueItem[]>;
+/**
+ * Online status + SW lifecycle.
+ * Only re-emits when isOnline, swStatus, or swError actually changes.
+ */
+export declare const eidosStatus: EidosReadable<{
+    isOnline: boolean;
+    swStatus: EidosStore['swStatus'];
+    swError: string | undefined;
+}>;
+/**
+ * Queue counts. Re-emits only when a count actually changes, not on every
+ * queue mutation (e.g. a status transition that doesn't change counts is skipped).
+ */
+export declare const eidosQueueStats: EidosReadable<{
+    pending: number;
+    failed: number;
+    replaying: number;
+    total: number;
+}>;
+/**
+ * Cumulative, session-scoped `neverLose` queue outcome counters — opt-in
+ * reliability telemetry. Re-emits only when a counter changes. See
+ * `EidosConfig.onReliabilityReport` to forward these to an analytics backend.
+ */
+export declare const eidosReliabilityStats: EidosReadable<ReliabilityStats>;
+/**
+ * Live cache state for a single registered resource URL.
+ * @example
+ *   // Svelte
+ *   const entry = eidosResource('/api/products')
+ *   $: hits = $entry?.cacheHits ?? 0
+ */
+export declare function eidosResource(url: string): EidosReadable<ResourceEntry | undefined>;
+/**
+ * Live state for a single queue item by ID. Returns `undefined` once the item
+ * is removed from the queue (after a successful replay or `clearQueue()`).
+ * @example
+ *   // Svelte
+ *   const item = eidosAction(queuedResult.id)
+ *   $: status = $item?.status  // 'pending' | 'replaying' | 'succeeded' | 'failed' | undefined
+ */
+export declare function eidosAction(id: string): EidosReadable<ActionQueueItem | undefined>;
+/**
+ * Calls `callback` once each time the action queue drains from non-empty → 0.
+ * Framework-agnostic equivalent of `useEidosOnDrain` for Svelte/Vue/vanilla.
+ * Returns an unsubscribe function.
+ *
+ * @example
+ *   // Svelte
+ *   onMount(() => onQueueDrain(() => toast.success('All offline actions synced!')))
+ */
+export declare function onQueueDrain(callback: () => void): () => void;

package/dist/sveltekit.d.ts

@@ -1,5 +1,4 @@
 import { EidosConfig } from './index.ts';
-
 /**
  * Returns an `onMount`-compatible callback that initialises the Eidos runtime
  * on the client only. Prevents SSR crashes caused by accessing `indexedDB` or

package/dist/sw-bridge.d.ts

@@ -0,0 +1,24 @@
+export declare function getSwRegistration(): ServiceWorkerRegistration | null;
+interface SwRegistrationOptions {
+    skipWaiting: boolean;
+    onUpdateAvailable?: (registration: ServiceWorkerRegistration) => void;
+}
+export declare function registerServiceWorker(swPath: string, options?: SwRegistrationOptions): Promise<void>;
+export declare function sendToWorker(message: Record<string, unknown>): void;
+export declare function registerBgSyncHandler(fn: () => void): void;
+export declare function isBgSyncSupported(): boolean;
+interface PushHandlers {
+    onNotificationClick?: (data: unknown) => void;
+    onSubscriptionExpired?: (sub: PushSubscriptionJSON) => void;
+}
+export declare function registerPushCallbacks(handlers: PushHandlers): void;
+export declare function setOfflineSimulation(enabled: boolean): void;
+/**
+ * Tells the waiting service worker to activate immediately, then reloads the page.
+ * Only relevant when `skipWaiting: false` — call this after the user confirms
+ * a "reload to update" toast shown via `onUpdateAvailable`.
+ */
+export declare function triggerSwUpdate(): void;
+/** Test-only: resets module-level state between test cases. */
+export declare function _resetSwBridgeForTests(): void;
+export {};

package/dist/sw-bridge.js

@@ -1,78 +1,78 @@
 import { useEidosStore as a } from "./store.js";
-var s = null, o = [];
+var i = null, o = [];
 function E() {
-  return s;
+  return i;
 }
-async function p(e) {
+async function w(t, e = { skipWaiting: !0 }) {
   if (typeof navigator > "u" || !("serviceWorker" in navigator)) {
     a.getState().setSwStatus("unsupported");
     return;
   }
-  const t = a.getState();
-  t.setSwStatus("registering");
+  const n = a.getState();
+  n.setSwStatus("registering");
   try {
-    s = await navigator.serviceWorker.register(e, { scope: "/" }), await d(s), t.setSwStatus("active"), navigator.serviceWorker.addEventListener("message", g), window.addEventListener("online", () => t.setOnline(!0)), window.addEventListener("offline", () => t.setOnline(!1)), l();
-  } catch (n) {
-    t.setSwStatus("error", String(n));
+    i = await navigator.serviceWorker.register(t, { scope: "/" }), await d(i), n.setSwStatus("active"), navigator.serviceWorker.addEventListener("message", S), window.addEventListener("online", () => n.setOnline(!0)), window.addEventListener("offline", () => n.setOnline(!1)), l(), v(i, e);
+  } catch (r) {
+    n.setSwStatus("error", String(r));
   }
 }
-function d(e) {
-  return new Promise((t) => {
-    if (e.active) {
-      t();
+function d(t) {
+  return new Promise((e) => {
+    if (t.active) {
+      e();
       return;
     }
-    const n = e.installing ?? e.waiting;
+    const n = t.installing ?? t.waiting;
     if (!n) {
-      t();
+      e();
       return;
     }
-    const i = setTimeout(t, 1e4);
-    n.addEventListener("statechange", function r() {
-      n.state === "activated" && (clearTimeout(i), n.removeEventListener("statechange", r), t());
+    const r = setTimeout(e, 1e4);
+    n.addEventListener("statechange", function s() {
+      n.state === "activated" && (clearTimeout(r), n.removeEventListener("statechange", s), e());
     });
   });
 }
-function S(e) {
-  const t = s?.active;
-  t ? t.postMessage(e) : o.push(e);
+function g(t) {
+  const e = i?.active;
+  e ? e.postMessage(t) : o.push(t);
 }
 var u = null;
-function w(e) {
-  u = e;
+function I(t) {
+  u = t;
 }
-function h() {
+function _() {
   try {
-    return typeof navigator < "u" && "serviceWorker" in navigator && s !== null && "sync" in s;
+    return typeof navigator < "u" && "serviceWorker" in navigator && i !== null && "sync" in i;
   } catch {
     return !1;
   }
 }
 var c = {};
-function O(e) {
-  c = e;
+function h(t) {
+  c = t;
 }
-function g(e) {
-  const t = e.data;
-  if (!t?.type) return;
-  const n = a.getState(), { type: i, url: r } = t;
-  if (i === "EIDOS_BACKGROUND_SYNC") {
+function S(t) {
+  const e = t.data;
+  if (!e?.type) return;
+  const n = a.getState(), { type: r, url: s } = e;
+  if (r === "EIDOS_BACKGROUND_SYNC") {
     u?.();
     return;
   }
-  if (i === "EIDOS_NOTIFICATION_CLICK") {
-    c.onNotificationClick?.(t.data);
+  if (r === "EIDOS_NOTIFICATION_CLICK") {
+    c.onNotificationClick?.(e.data);
     return;
   }
-  if (i === "EIDOS_SUBSCRIPTION_EXPIRED") {
-    c.onSubscriptionExpired?.(t.subscription);
+  if (r === "EIDOS_SUBSCRIPTION_EXPIRED") {
+    c.onSubscriptionExpired?.(e.subscription);
     return;
   }
-  if (r)
-    switch (i) {
+  if (s)
+    switch (r) {
       case "EIDOS_CACHE_HIT": {
-        const f = n.resources[r];
-        n.updateResource(r, {
+        const f = n.resources[s];
+        n.updateResource(s, {
           status: "fresh",
           lastEvent: "cache-hit",
           cacheHits: (f?.cacheHits ?? 0) + 1
@@ -80,41 +80,56 @@ function g(e) {
         break;
       }
       case "EIDOS_CACHE_UPDATED":
-        n.updateResource(r, {
+        n.updateResource(s, {
           status: "fresh",
           lastEvent: "cache-updated",
           cachedAt: Date.now()
         });
         break;
       case "EIDOS_NETWORK_ERROR":
-        n.updateResource(r, {
+        n.updateResource(s, {
           status: "error",
           lastEvent: "network-error"
         });
         break;
     }
 }
-function _(e) {
-  S({
+function O(t) {
+  g({
     type: "EIDOS_SIMULATE_OFFLINE",
-    enabled: e
-  }), a.getState().setOnline(!e);
+    enabled: t
+  }), a.getState().setOnline(!t);
 }
 function l() {
-  const e = s?.active;
-  if (e) {
-    for (const t of o) e.postMessage(t);
+  const t = i?.active;
+  if (t) {
+    for (const e of o) t.postMessage(e);
     o = [];
   }
 }
+function v(t, e) {
+  const n = (r) => {
+    e.skipWaiting ? r.waiting?.postMessage({ type: "EIDOS_SKIP_WAITING" }) : e.onUpdateAvailable?.(r);
+  };
+  t.waiting && navigator.serviceWorker.controller && n(t), t.addEventListener("updatefound", () => {
+    const r = t.installing;
+    r && r.addEventListener("statechange", () => {
+      r.state === "installed" && navigator.serviceWorker.controller && n(t);
+    });
+  });
+}
+function k() {
+  i?.waiting?.postMessage({ type: "EIDOS_SKIP_WAITING" });
+}
 export {
   E as getSwRegistration,
-  h as isBgSyncSupported,
-  w as registerBgSyncHandler,
-  O as registerPushCallbacks,
-  p as registerServiceWorker,
-  S as sendToWorker,
-  _ as setOfflineSimulation
+  _ as isBgSyncSupported,
+  I as registerBgSyncHandler,
+  h as registerPushCallbacks,
+  w as registerServiceWorker,
+  g as sendToWorker,
+  O as setOfflineSimulation,
+  k as triggerSwUpdate
 };
 
 //# sourceMappingURL=sw-bridge.js.map