@sweidos/eidos 2.1.0 → 2.3.0

package/dist/resource.js

@@ -1,79 +1,81 @@
 import { useEidosStore as h } from "./store.js";
-import { sendToWorker as p } from "./sw-bridge.js";
-var d = /* @__PURE__ */ new Map(), l = /* @__PURE__ */ new Map(), g = null;
-function _(e) {
-  g = e;
+import { sendToWorker as g } from "./sw-bridge.js";
+var d = /* @__PURE__ */ new Map(), l = /* @__PURE__ */ new Map(), v = null;
+function q(e) {
+  v = e;
 }
-function f(e) {
+function u(e) {
   return e.includes("*") || /:[^/]+/.test(e);
 }
-function k(e) {
+function R(e) {
   return "^" + e.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, ".+").replace(/\*/g, "[^/]+").replace(/:[^/]+/g, "[^/]+") + "$";
 }
-function m(e, s) {
-  const a = b(s), t = f(e) ? k(e) : void 0, r = {
+function w(e, a) {
+  const s = k(a), t = u(e) ? R(e) : void 0, r = {
     url: e,
-    config: s,
-    strategy: a,
+    config: a,
+    strategy: s,
     status: "idle",
     cacheHits: 0,
     cacheMisses: 0
   };
-  return h.getState().registerResource(e, r), p({
+  return h.getState().registerResource(e, r), g({
     type: "EIDOS_REGISTER_RESOURCE",
     url: e,
-    strategy: a.swStrategy,
-    cacheName: a.cacheName,
-    ...t !== void 0 && { pattern: t }
+    strategy: s.swStrategy,
+    cacheName: s.cacheName,
+    ...t !== void 0 && { pattern: t },
+    ...a.maxAge !== void 0 && { maxAge: a.maxAge },
+    ...a.maxEntries !== void 0 && { maxEntries: a.maxEntries }
   }), {
-    strategy: a,
+    strategy: s,
     regexStr: t
   };
 }
-function y(e, s, a) {
+function y(e, a, s) {
   return async () => {
-    p({
+    g({
       type: "EIDOS_CLEAR_CACHE",
       url: e
     });
-    const t = await caches.open(s.cacheName).catch(() => null);
+    const t = await caches.open(a.cacheName).catch(() => null);
     if (t) {
-      const r = await t.keys(), n = a ? new RegExp(a) : null, c = e.startsWith("http");
-      await Promise.all(r.filter((i) => {
-        const o = i.url, u = new URL(o).pathname;
-        return n ? n.test(c ? o : u) : c ? o === e : o === e || u === e;
-      }).map((i) => t.delete(i)));
+      const r = await t.keys(), n = s ? new RegExp(s) : null, i = e.startsWith("http");
+      await Promise.all(r.filter((c) => {
+        const o = c.url, f = new URL(o).pathname;
+        return n ? n.test(i ? o : f) : i ? o === e : o === e || f === e;
+      }).map((c) => t.delete(c)));
     }
-    f(e) || h.getState().updateResource(e, {
+    u(e) || h.getState().updateResource(e, {
       status: "stale",
       cachedAt: void 0,
       lastEvent: "cache-cleared",
       cacheHits: 0,
       cacheMisses: 0
-    }), g?.(["eidos", e]);
+    }), v?.(["eidos", e]);
   };
 }
 function E(e) {
   return () => {
-    d.delete(e), p({
+    d.delete(e), g({
       type: "EIDOS_UNREGISTER_RESOURCE",
       url: e
     }), h.getState().unregisterResource(e);
   };
 }
-function A(e, s) {
-  if (f(e)) throw new Error(`[eidos] resource('${e}') is a URL pattern — use resourcePattern('${e}', config) instead. Pattern handles only support invalidate()/unregister(); the SW intercepts matching requests automatically.`);
+function _(e, a) {
+  if (u(e)) throw new Error(`[eidos] resource('${e}') is a URL pattern — use resourcePattern('${e}', config) instead. Pattern handles only support invalidate()/unregister(); the SW intercepts matching requests automatically.`);
   if (d.has(e)) return d.get(e);
-  const { strategy: a } = m(e, s), t = {
+  const { strategy: s } = w(e, a), t = {
     url: e,
-    config: s,
-    strategy: a,
+    config: a,
+    strategy: s,
     fetch: async () => {
       const r = l.get(e);
-      if (r) return r.then((c) => c.clone());
-      const n = S(e, s, a);
+      if (r) return r.then((i) => i.clone());
+      const n = S(e, a, s);
       return l.set(e, n), n.finally(() => l.delete(e)).catch(() => {
-      }), n.then((c) => c.clone());
+      }), n.then((i) => i.clone());
     },
     json: async () => (await t.fetch()).json(),
     query: () => ({
@@ -83,47 +85,47 @@ function A(e, s) {
     prefetch: async () => {
       await t.fetch();
     },
-    invalidate: y(e, a, void 0),
+    invalidate: y(e, s, void 0),
     unregister: E(e)
   };
   return d.set(e, t), t;
 }
-function $(e, s) {
-  if (!f(e)) throw new Error(`[eidos] resourcePattern('${e}') is not a URL pattern — use resource('${e}', config) instead.`);
+function $(e, a) {
+  if (!u(e)) throw new Error(`[eidos] resourcePattern('${e}') is not a URL pattern — use resource('${e}', config) instead.`);
   if (d.has(e)) return d.get(e);
-  const { strategy: a, regexStr: t } = m(e, s), r = {
+  const { strategy: s, regexStr: t } = w(e, a), r = {
     url: e,
-    config: s,
-    strategy: a,
-    invalidate: y(e, a, t),
+    config: a,
+    strategy: s,
+    invalidate: y(e, s, t),
     unregister: E(e)
   };
   return d.set(e, r), r;
 }
-async function S(e, s, a) {
+async function S(e, a, s) {
   const t = h.getState();
   t.updateResource(e, {
     status: "fetching",
     fetchedAt: Date.now()
   });
-  const r = await caches.open(a.cacheName).catch(() => null);
+  const r = await caches.open(s.cacheName).catch(() => null);
   try {
-    if (a.swStrategy !== "network-first") {
-      const i = r ? await r.match(e).catch(() => null) : null, o = h.getState().resources[e], u = s.maxAge !== void 0 && o?.cachedAt !== void 0 && Date.now() - o.cachedAt > s.maxAge;
-      if (i && !u)
+    if (s.swStrategy !== "network-first") {
+      const c = r ? await r.match(e).catch(() => null) : null, o = h.getState().resources[e], f = a.maxAge !== void 0 && o?.cachedAt !== void 0 && Date.now() - o.cachedAt > a.maxAge;
+      if (c && !f)
         return t.updateResource(e, {
           status: "fresh",
           lastEvent: "cache-hit",
           cacheHits: (o?.cacheHits ?? 0) + 1
-        }), a.swStrategy === "stale-while-revalidate" && fetch(e, { signal: AbortSignal.timeout(5e3) }).then(async (w) => {
-          w.ok && r && (await r.put(e, w.clone()), h.getState().updateResource(e, {
+        }), s.swStrategy === "stale-while-revalidate" && fetch(e, { signal: AbortSignal.timeout(5e3) }).then(async (m) => {
+          m.ok && r && (await r.put(e, m.clone()), h.getState().updateResource(e, {
             cachedAt: Date.now(),
             lastEvent: "cache-updated"
           }));
         }).catch(() => {
-        }), i;
-      const R = h.getState().resources[e];
-      t.updateResource(e, { cacheMisses: (R?.cacheMisses ?? 0) + 1 });
+        }), c;
+      const x = h.getState().resources[e];
+      t.updateResource(e, { cacheMisses: (x?.cacheMisses ?? 0) + 1 });
     }
     const n = await fetch(e);
     if (n.ok)
@@ -133,30 +135,30 @@ async function S(e, s, a) {
         lastEvent: "cache-updated"
       }), n;
     t.updateResource(e, { status: n.status === 503 ? "offline" : "error" });
-    const c = n.headers.get("X-Eidos-Offline") === "true";
-    throw new Error(c ? `offline: no cached response for ${e}` : `${n.status} ${n.statusText}`);
+    const i = n.headers.get("X-Eidos-Offline") === "true";
+    throw new Error(i ? `offline: no cached response for ${e}` : `${n.status} ${n.statusText}`);
   } catch (n) {
-    const c = r ? await r.match(e).catch(() => null) : null;
-    if (c) {
-      const i = h.getState().resources[e];
+    const i = r ? await r.match(e).catch(() => null) : null;
+    if (i) {
+      const c = h.getState().resources[e];
       return t.updateResource(e, {
         status: "fresh",
         lastEvent: "cache-hit",
-        cacheHits: (i?.cacheHits ?? 0) + 1
-      }), c;
+        cacheHits: (c?.cacheHits ?? 0) + 1
+      }), i;
     }
     throw t.updateResource(e, { status: "error" }), n;
   }
 }
-function b(e) {
-  const s = e.strategy;
-  return e.offline ? v(s ?? "stale-while-revalidate", e.cacheName, e.version) : v(s ?? "network-first", e.cacheName, e.version);
+function k(e) {
+  const a = e.strategy;
+  return e.offline ? p(a ?? "stale-while-revalidate", e.cacheName, e.version) : p(a ?? "network-first", e.cacheName, e.version);
 }
-var x = {
+var A = {
   "stale-while-revalidate": "StaleWhileRevalidate",
   "cache-first": "CacheFirst",
   "network-first": "NetworkFirst"
-}, C = {
+}, b = {
   "stale-while-revalidate": {
     reasoning: "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.",
     behavior: [
@@ -165,10 +167,10 @@ var x = {
       "Offline → return cached version if available, 503 if not",
       "Reconnect → next request triggers a background refresh"
     ],
-    equivalentCode: `// Workbox equivalent
+    equivalentCode: `// Workbox equivalent (maxEntries/maxAge are configured via ResourceConfig)
 new StaleWhileRevalidate({
   cacheName: 'eidos-resources-v1',
-  plugins: [new ExpirationPlugin({ maxEntries: 60 })],
+  plugins: [new ExpirationPlugin({ maxEntries: config.maxEntries, maxAgeSeconds: config.maxAge && config.maxAge / 1000 })],
 })`
   },
   "cache-first": {
@@ -177,12 +179,12 @@ new StaleWhileRevalidate({
       "Cache hit → return immediately, no network request made",
       "Cache miss → fetch from network, cache the response, return it",
       "Offline → return cached version, 503 if cache is empty",
-      "Cache never expires unless explicitly invalidated"
+      "Cache never expires unless maxAge is set or explicitly invalidated"
     ],
-    equivalentCode: `// Workbox equivalent
+    equivalentCode: `// Workbox equivalent (maxEntries/maxAge are configured via ResourceConfig)
 new CacheFirst({
   cacheName: 'eidos-resources-v1',
-  plugins: [new ExpirationPlugin({ maxEntries: 60 })],
+  plugins: [new ExpirationPlugin({ maxEntries: config.maxEntries, maxAgeSeconds: config.maxAge && config.maxAge / 1000 })],
 })`
   },
   "network-first": {
@@ -200,29 +202,29 @@ new NetworkFirst({
 })`
   }
 };
-function v(e, s, a) {
-  const t = C[e], r = s ?? "eidos-resources-v1";
+function p(e, a, s) {
+  const t = b[e], r = a ?? "eidos-resources-v1";
   return {
-    name: x[e],
+    name: A[e],
     swStrategy: e,
-    cacheName: a !== void 0 ? `${r}-v${a}` : r,
+    cacheName: s !== void 0 ? `${r}-v${s}` : r,
     reasoning: t.reasoning,
     behavior: t.behavior,
     equivalentCode: ""
   };
 }
 async function O(e) {
-  const s = await Promise.allSettled(e.map((t) => t.prefetch())), a = s.filter((t) => t.status === "rejected").map((t) => t.reason);
+  const a = await Promise.allSettled(e.map((t) => t.prefetch())), s = a.filter((t) => t.status === "rejected").map((t) => t.reason);
   return {
-    warmed: s.filter((t) => t.status === "fulfilled").length,
-    failed: a.length,
-    errors: a
+    warmed: a.filter((t) => t.status === "fulfilled").length,
+    failed: s.length,
+    errors: s
   };
 }
 export {
-  A as resource,
+  _ as resource,
   $ as resourcePattern,
-  _ as setQueryInvalidator,
+  q as setQueryInvalidator,
   O as warmCache
 };
 

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,50 +1,58 @@
-import { useEidosStore as a } from "./store.js";
-import { registerBgSyncHandler as c, registerServiceWorker as m } from "./sw-bridge.js";
-import { idbGetQueue as y, idbQueueStorage as d } from "./idb.js";
-import { _getQueueStorage as p } from "./queue-storage.js";
-import { subscribeQueueSync as l } from "./queue-sync.js";
-import { replayQueue as f } from "./action.js";
-import { subscribeReplayOnReconnect as g } from "./replay.js";
-async function h(e) {
+import { useEidosStore as n } from "./store.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 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 = {
     ...e,
     schemaVersion: 2,
     idempotencyKey: e.idempotencyKey ?? crypto.randomUUID()
   };
-  return await (p() ?? d).update(t.id, {
+  return await (b() ?? d).update(t.id, {
     schemaVersion: t.schemaVersion,
     idempotencyKey: t.idempotencyKey
   }).catch(() => {
   }), t;
 }
-var r = !1, i = null, o = null;
-async function R(e = {}) {
-  if (typeof window > "u" || r) return;
-  r = !0;
-  const t = e.swPath ?? "/eidos-sw.js", s = e.autoReplay ?? !0;
+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, c = e.skipWaiting ?? !0;
   try {
-    const n = await y();
-    if (n.length > 0) {
-      const u = await Promise.all(n.map(h));
-      a.getState().hydrateQueue(u);
+    const i = await m();
+    if (i.length > 0) {
+      const a = await Promise.all(i.map(R));
+      n.getState().hydrateQueue(a);
     }
   } catch {
   }
   try {
-    await m(t);
+    await y(t, {
+      skipWaiting: c,
+      onUpdateAvailable: e.onUpdateAvailable
+    });
   } catch {
   }
-  c(() => {
-    a.getState().isOnline && setTimeout(f, 200);
-  }), s && (i = g()), o = l();
+  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);
+    }, i);
+  }
 }
 function V() {
-  i?.(), i = null, o?.(), o = null, r = !1;
+  s?.(), s = null, u?.(), u = null, r && clearInterval(r), r = null, o = !1;
 }
 export {
   V as _resetEidos,
-  R 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 } 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\nlet _initialized = false;\nlet _unsubscribe: (() => void) | null = null;\nlet _unsubscribeQueueSync: (() => void) | 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 (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  _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;AASA,IAAI,IAAe,IACf,IAAoC,MACpC,IAA6C;AAEjD,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;AAKA,EAAA,EAAA,MAA4B;AAC1B,IAAI,EAAc,SAAS,EAAE,YAC3B,WAAW,GAAa,GAAG;AAAA,EAE/B,CAAC,GAEG,MACF,IAAe,EAA2B,IAK5C,IAAwB,EAAmB;AAU7C;AAEA,SAAgB,IAAc;AAC5B,EAAA,IAAe,GACf,IAAe,MACf,IAAwB,GACxB,IAAwB,MACxB,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 {};