@sweidos/eidos 1.0.31 → 1.0.33

package/dist/resource.js

@@ -1,14 +1,14 @@
 import { useEidosStore as h } from "./store.js";
 import { sendToWorker as g } from "./sw-bridge.js";
-const p = /* @__PURE__ */ new Map(), y = /* @__PURE__ */ new Map();
+const p = /* @__PURE__ */ new Map(), v = /* @__PURE__ */ new Map();
 let m = null;
-function N(e) {
+function q(e) {
   m = e;
 }
 function l(e) {
   return e.includes("*") || /:[^/]+/.test(e);
 }
-function k(e) {
+function E(e) {
   return "^" + e.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, ".+").replace(/\*/g, "[^/]+").replace(/:[^/]+/g, "[^/]+") + "$";
 }
 function w(e, a) {
@@ -16,10 +16,10 @@ function w(e, a) {
     `[eidos] resource('${e}') is a URL pattern — ${a}() is not supported on pattern handles. The SW intercepts matching requests automatically; call fetch(specificUrl) directly in your app code.`
   );
 }
-function q(e, a) {
+function A(e, a) {
   if (p.has(e))
     return p.get(e);
-  const s = E(e, a), t = l(e) ? k(e) : void 0, o = {
+  const s = S(e, a), t = l(e) ? E(e) : void 0, o = {
     url: e,
     config: a,
     strategy: s,
@@ -40,10 +40,10 @@ function q(e, a) {
     strategy: s,
     fetch: async () => {
       if (l(e)) throw w(e, "fetch");
-      const r = y.get(e);
+      const r = v.get(e);
       if (r) return r.then((n) => n.clone());
-      const i = S(e, a, s);
-      return y.set(e, i), i.finally(() => y.delete(e)).catch(() => {
+      const i = k(e, a, s);
+      return v.set(e, i), i.finally(() => v.delete(e)).catch(() => {
       }), i.then((n) => n.clone());
     },
     json: async () => {
@@ -68,8 +68,8 @@ function q(e, a) {
         const i = await r.keys(), n = t ? new RegExp(t) : null, u = e.startsWith("http");
         await Promise.all(
           i.filter((f) => {
-            const d = f.url, v = new URL(d).pathname;
-            return n ? n.test(u ? d : v) : u ? d === e : d === e || v === e;
+            const d = f.url, y = new URL(d).pathname;
+            return n ? n.test(u ? d : y) : u ? d === e : d === e || y === e;
           }).map((f) => r.delete(f))
         );
       }
@@ -87,7 +87,7 @@ function q(e, a) {
   };
   return p.set(e, c), c;
 }
-async function S(e, a, s) {
+async function k(e, a, s) {
   const t = h.getState();
   t.updateResource(e, { status: "fetching", fetchedAt: Date.now() });
   const o = await caches.open(s.cacheName).catch(() => null);
@@ -136,13 +136,16 @@ async function S(e, a, s) {
     throw t.updateResource(e, { status: "error" }), c;
   }
 }
-function E(e, a) {
+function S(e, a) {
   const s = a.strategy;
   return a.offline ? R(s ?? "stale-while-revalidate", e, a.cacheName) : R(s ?? "network-first", e, a.cacheName);
 }
-const x = {
+const b = {
+  "stale-while-revalidate": "StaleWhileRevalidate",
+  "cache-first": "CacheFirst",
+  "network-first": "NetworkFirst"
+}, x = {
   "stale-while-revalidate": {
-    name: "StaleWhileRevalidate",
     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: [
       "Cache hit → return immediately, kick off background revalidation",
@@ -157,7 +160,6 @@ new StaleWhileRevalidate({
 })`
   },
   "cache-first": {
-    name: "CacheFirst",
     reasoning: "cache-first maximises speed and offline availability. Network is consulted only on cache miss. Best for static or infrequently-updated data.",
     behavior: [
       "Cache hit → return immediately, no network request made",
@@ -172,7 +174,6 @@ new CacheFirst({
 })`
   },
   "network-first": {
-    name: "NetworkFirst",
     reasoning: "network-first prioritises fresh data. Cache acts as a safety net when offline. Best for frequently-updated resources where stale data causes problems.",
     behavior: [
       "Always try network first",
@@ -188,13 +189,19 @@ new NetworkFirst({
   }
 };
 function R(e, a, s) {
+  const t = x[e];
   return {
-    ...x[e],
+    name: b[e],
     swStrategy: e,
-    cacheName: s ?? "eidos-resources-v1"
+    cacheName: s ?? "eidos-resources-v1",
+    // reasoning + behavior are rendered by the playground UI from live ResourceEntry objects —
+    // keep them in all builds. equivalentCode is a static code block only used in DEV tools.
+    reasoning: t.reasoning,
+    behavior: t.behavior,
+    equivalentCode: ""
   };
 }
-async function A(e) {
+async function _(e) {
   const a = await Promise.allSettled(e.map((t) => t.prefetch())), s = a.filter((t) => t.status === "rejected").map((t) => t.reason);
   return {
     warmed: a.filter((t) => t.status === "fulfilled").length,
@@ -203,8 +210,8 @@ async function A(e) {
   };
 }
 export {
-  q as resource,
-  N as setQueryInvalidator,
-  A as warmCache
+  A as resource,
+  q as setQueryInvalidator,
+  _ as warmCache
 };
 //# sourceMappingURL=resource.js.map

package/dist/resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource.js","sources":["../src/resource.ts"],"sourcesContent":["import { useEidosStore } from './store'\nimport { sendToWorker } from './sw-bridge'\nimport type {\n  ResourceConfig,\n  ResourceHandle,\n  ResourceEntry,\n  GeneratedStrategy,\n  CacheStrategy,\n  WarmCacheResult,\n} from './types'\n\nconst _registry = new Map<string, ResourceHandle>()\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\nfunction _patternError(url: string, method: string): Error {\n  return new Error(\n    `[eidos] resource('${url}') is a URL pattern — ${method}() is not supported on pattern handles. ` +\n    `The SW intercepts matching requests automatically; call fetch(specificUrl) directly in your app code.`,\n  )\n}\n\n// ── resource() ────────────────────────────────────────────────────────────────\n\nexport function resource<T = unknown>(\n  url: string,\n  config: ResourceConfig,\n): ResourceHandle<T> {\n  if (_registry.has(url)) {\n    if (import.meta.env.DEV) {\n      const existing = _registry.get(url)!\n      const existingCfg = existing.config\n      if (\n        existingCfg.offline !== config.offline ||\n        existingCfg.strategy !== config.strategy ||\n        existingCfg.cacheName !== config.cacheName\n      ) {\n        console.warn(\n          `[eidos] resource('${url}') already registered with a different config — returning cached handle. Call resource.unregister() first to re-register.`,\n          { registered: existingCfg, ignored: config },\n        )\n      }\n    }\n    return _registry.get(url) as ResourceHandle<T>\n  }\n\n  const strategy = deriveStrategy(url, 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  const handle: ResourceHandle<T> = {\n    url,\n    config,\n    strategy,\n\n    fetch: async () => {\n      if (isPattern(url)) throw _patternError(url, 'fetch')\n\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      if (isPattern(url)) throw _patternError(url, 'json')\n      const res = await handle.fetch()\n      return res.json() as Promise<T>\n    },\n\n    query: () => {\n      if (isPattern(url)) throw _patternError(url, 'query')\n      return {\n        queryKey: ['eidos', url] as [string, string],\n        queryFn: () => handle.json(),\n      }\n    },\n\n    prefetch: async () => {\n      if (isPattern(url)) throw _patternError(url, 'prefetch')\n      await handle.fetch()\n    },\n\n    invalidate: 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    unregister: () => {\n      _registry.delete(url)\n      sendToWorker({ type: 'EIDOS_UNREGISTER_RESOURCE', url })\n      useEidosStore.getState().unregisterResource(url)\n    },\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 ? `offline: no cached response for ${url}` : `${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(url: string, config: ResourceConfig): GeneratedStrategy {\n  const explicit = config.strategy\n  if (config.offline) return buildStrategy(explicit ?? 'stale-while-revalidate', url, config.cacheName)\n  return buildStrategy(explicit ?? 'network-first', url, config.cacheName)\n}\n\nconst STRATEGY_META: Record<CacheStrategy, Omit<GeneratedStrategy, 'swStrategy' | 'cacheName'>> = {\n  'stale-while-revalidate': {\n    name: 'StaleWhileRevalidate',\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    name: 'CacheFirst',\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    name: 'NetworkFirst',\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(swStrategy: CacheStrategy, _url: string, cacheName?: string): GeneratedStrategy {\n  return {\n    ...STRATEGY_META[swStrategy],\n    swStrategy,\n    cacheName: cacheName ?? 'eidos-resources-v1',\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"],"names":["_registry","_inflightRequests","_queryInvalidator","setQueryInvalidator","fn","isPattern","url","patternToRegexStr","pattern","_patternError","method","resource","config","strategy","deriveStrategy","regexStr","entry","useEidosStore","sendToWorker","handle","existing","r","task","_fetchResource","cache","keys","patternRe","isCrossOrigin","rUrl","p","store","cached","current","expired","resp","storeEntry","response","isOffline","err","fallback","explicit","buildStrategy","STRATEGY_META","swStrategy","_url","cacheName","warmCache","handles","results","h","errors"],"mappings":"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"}
+{"version":3,"file":"resource.js","sources":["../src/resource.ts"],"sourcesContent":["import { useEidosStore } from './store'\nimport { sendToWorker } from './sw-bridge'\nimport type {\n  ResourceConfig,\n  ResourceHandle,\n  ResourceEntry,\n  GeneratedStrategy,\n  CacheStrategy,\n  WarmCacheResult,\n} from './types'\n\nconst _registry = new Map<string, ResourceHandle>()\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\nfunction _patternError(url: string, method: string): Error {\n  return new Error(\n    `[eidos] resource('${url}') is a URL pattern — ${method}() is not supported on pattern handles. ` +\n    `The SW intercepts matching requests automatically; call fetch(specificUrl) directly in your app code.`,\n  )\n}\n\n// ── resource() ────────────────────────────────────────────────────────────────\n\nexport function resource<T = unknown>(\n  url: string,\n  config: ResourceConfig,\n): ResourceHandle<T> {\n  if (_registry.has(url)) {\n    if (import.meta.env.DEV) {\n      const existing = _registry.get(url)!\n      const existingCfg = existing.config\n      if (\n        existingCfg.offline !== config.offline ||\n        existingCfg.strategy !== config.strategy ||\n        existingCfg.cacheName !== config.cacheName\n      ) {\n        console.warn(\n          `[eidos] resource('${url}') already registered with a different config — returning cached handle. Call resource.unregister() first to re-register.`,\n          { registered: existingCfg, ignored: config },\n        )\n      }\n    }\n    return _registry.get(url) as ResourceHandle<T>\n  }\n\n  const strategy = deriveStrategy(url, 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  const handle: ResourceHandle<T> = {\n    url,\n    config,\n    strategy,\n\n    fetch: async () => {\n      if (isPattern(url)) throw _patternError(url, 'fetch')\n\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      if (isPattern(url)) throw _patternError(url, 'json')\n      const res = await handle.fetch()\n      return res.json() as Promise<T>\n    },\n\n    query: () => {\n      if (isPattern(url)) throw _patternError(url, 'query')\n      return {\n        queryKey: ['eidos', url] as [string, string],\n        queryFn: () => handle.json(),\n      }\n    },\n\n    prefetch: async () => {\n      if (isPattern(url)) throw _patternError(url, 'prefetch')\n      await handle.fetch()\n    },\n\n    invalidate: 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    unregister: () => {\n      _registry.delete(url)\n      sendToWorker({ type: 'EIDOS_UNREGISTER_RESOURCE', url })\n      useEidosStore.getState().unregisterResource(url)\n    },\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 ? `offline: no cached response for ${url}` : `${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(url: string, config: ResourceConfig): GeneratedStrategy {\n  const explicit = config.strategy\n  if (config.offline) return buildStrategy(explicit ?? 'stale-while-revalidate', url, config.cacheName)\n  return buildStrategy(explicit ?? 'network-first', url, config.cacheName)\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(swStrategy: CacheStrategy, _url: string, cacheName?: string): GeneratedStrategy {\n  const meta = _STRATEGY_DEV_META[swStrategy]\n  return {\n    name: STRATEGY_NAMES[swStrategy],\n    swStrategy,\n    cacheName: cacheName ?? 'eidos-resources-v1',\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"],"names":["_registry","_inflightRequests","_queryInvalidator","setQueryInvalidator","fn","isPattern","url","patternToRegexStr","pattern","_patternError","method","resource","config","strategy","deriveStrategy","regexStr","entry","useEidosStore","sendToWorker","handle","existing","r","task","_fetchResource","cache","keys","patternRe","isCrossOrigin","rUrl","p","store","cached","current","expired","resp","storeEntry","response","isOffline","err","fallback","explicit","buildStrategy","STRATEGY_NAMES","_STRATEGY_DEV_META","swStrategy","_url","cacheName","meta","warmCache","handles","results","h","errors"],"mappings":"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"}

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sources":["../src/runtime.ts"],"sourcesContent":["import { registerServiceWorker, registerBgSyncHandler } from './sw-bridge'\nimport { replayQueue } from './action'\nimport { useEidosStore } from './store'\nimport { idbGetQueue } from './idb'\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\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      useEidosStore.getState().hydrateQueue(persisted)\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    // ── Subscribe to the store instead of window.addEventListener('online')\n    //\n    // WHY: setOfflineSimulation() updates the store directly but never fires a\n    // real browser `online` event. Watching the store catches both:\n    //   • Real network reconnects (sw-bridge updates store on window.online)\n    //   • Simulation toggled off (setOfflineSimulation(false) → store.setOnline(true))\n    //\n    let prevIsOnline = useEidosStore.getState().isOnline\n\n    _unsubscribe = useEidosStore.subscribe(() => {\n      const { isOnline } = useEidosStore.getState()\n      const justCameOnline = isOnline && !prevIsOnline\n      prevIsOnline = isOnline\n\n      if (justCameOnline) {\n        // Small delay so the connection (or simulation reset) settles first\n        setTimeout(replayQueue, 600)\n      }\n    })\n\n    // Replay any pending items that survived a page reload\n    const store = useEidosStore.getState()\n    const hasPending = store.queue.some((q) => q.status === 'pending' || q.status === 'failed')\n    if (store.isOnline && hasPending) {\n      setTimeout(replayQueue, 1200)\n    }\n  }\n\n  if (import.meta.env.DEV) {\n    const store = useEidosStore.getState()\n    console.groupCollapsed('%c⚡ Eidos', 'color:#38bdf8;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  _initialized = false\n}\n"],"names":["_initialized","_unsubscribe","initEidos","config","swPath","autoReplay","persisted","idbGetQueue","useEidosStore","registerServiceWorker","registerBgSyncHandler","replayQueue","prevIsOnline","isOnline","justCameOnline","store","hasPending","q","_resetEidos"],"mappings":";;;;AAYA,IAAIA,IAAe,IACfC,IAAoC;AAExC,eAAsBC,EAAUC,IAAsB,IAAmB;AAGvE,MADI,OAAO,SAAW,OAClBH,EAAc;AAClB,EAAAA,IAAe;AAEf,QAAMI,IAASD,EAAO,UAAU,gBAC1BE,IAAaF,EAAO,cAAc;AAGxC,MAAI;AACF,UAAMG,IAAY,MAAMC,EAAA;AACxB,IAAID,EAAU,SAAS,KACrBE,EAAc,SAAA,EAAW,aAAaF,CAAS;AAAA,EAEnD,QAAQ;AAAA,EAER;AAEA,MAAI;AACF,UAAMG,EAAsBL,CAAM;AAAA,EACpC,QAAQ;AAAA,EAER;AAWA,MANAM,EAAsB,MAAM;AAC1B,IAAIF,EAAc,SAAA,EAAW,YAC3B,WAAWG,GAAa,GAAG;AAAA,EAE/B,CAAC,GAEGN,GAAY;AAQd,QAAIO,IAAeJ,EAAc,SAAA,EAAW;AAE5C,IAAAP,IAAeO,EAAc,UAAU,MAAM;AAC3C,YAAM,EAAE,UAAAK,EAAA,IAAaL,EAAc,SAAA,GAC7BM,IAAiBD,KAAY,CAACD;AACpC,MAAAA,IAAeC,GAEXC,KAEF,WAAWH,GAAa,GAAG;AAAA,IAE/B,CAAC;AAGD,UAAMI,IAAQP,EAAc,SAAA,GACtBQ,IAAaD,EAAM,MAAM,KAAK,CAACE,MAAMA,EAAE,WAAW,aAAaA,EAAE,WAAW,QAAQ;AAC1F,IAAIF,EAAM,YAAYC,KACpB,WAAWL,GAAa,IAAI;AAAA,EAEhC;AAUF;AAEO,SAASO,IAAc;AAC5B,EAAAjB,KAAA,QAAAA,KACAA,IAAe,MACfD,IAAe;AACjB;"}
+{"version":3,"file":"runtime.js","sources":["../src/runtime.ts"],"sourcesContent":["import { registerServiceWorker, registerBgSyncHandler } from './sw-bridge'\nimport { replayQueue } from './action'\nimport { useEidosStore } from './store'\nimport { idbGetQueue } from './idb'\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\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      useEidosStore.getState().hydrateQueue(persisted)\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    // ── Subscribe to the store instead of window.addEventListener('online')\n    //\n    // WHY: setOfflineSimulation() updates the store directly but never fires a\n    // real browser `online` event. Watching the store catches both:\n    //   • Real network reconnects (sw-bridge updates store on window.online)\n    //   • Simulation toggled off (setOfflineSimulation(false) → store.setOnline(true))\n    //\n    let prevIsOnline = useEidosStore.getState().isOnline\n\n    _unsubscribe = useEidosStore.subscribe(() => {\n      const { isOnline } = useEidosStore.getState()\n      const justCameOnline = isOnline && !prevIsOnline\n      prevIsOnline = isOnline\n\n      if (justCameOnline) {\n        // Small delay so the connection (or simulation reset) settles first\n        setTimeout(replayQueue, 600)\n      }\n    })\n\n    // Replay any pending items that survived a page reload\n    const store = useEidosStore.getState()\n    const hasPending = store.queue.some((q) => q.status === 'pending' || q.status === 'failed')\n    if (store.isOnline && hasPending) {\n      setTimeout(replayQueue, 1200)\n    }\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  _initialized = false\n}\n"],"names":["_initialized","_unsubscribe","initEidos","config","swPath","autoReplay","persisted","idbGetQueue","useEidosStore","registerServiceWorker","registerBgSyncHandler","replayQueue","prevIsOnline","isOnline","justCameOnline","store","hasPending","q","_resetEidos"],"mappings":";;;;AAYA,IAAIA,IAAe,IACfC,IAAoC;AAExC,eAAsBC,EAAUC,IAAsB,IAAmB;AAGvE,MADI,OAAO,SAAW,OAClBH,EAAc;AAClB,EAAAA,IAAe;AAEf,QAAMI,IAASD,EAAO,UAAU,gBAC1BE,IAAaF,EAAO,cAAc;AAGxC,MAAI;AACF,UAAMG,IAAY,MAAMC,EAAA;AACxB,IAAID,EAAU,SAAS,KACrBE,EAAc,SAAA,EAAW,aAAaF,CAAS;AAAA,EAEnD,QAAQ;AAAA,EAER;AAEA,MAAI;AACF,UAAMG,EAAsBL,CAAM;AAAA,EACpC,QAAQ;AAAA,EAER;AAWA,MANAM,EAAsB,MAAM;AAC1B,IAAIF,EAAc,SAAA,EAAW,YAC3B,WAAWG,GAAa,GAAG;AAAA,EAE/B,CAAC,GAEGN,GAAY;AAQd,QAAIO,IAAeJ,EAAc,SAAA,EAAW;AAE5C,IAAAP,IAAeO,EAAc,UAAU,MAAM;AAC3C,YAAM,EAAE,UAAAK,EAAA,IAAaL,EAAc,SAAA,GAC7BM,IAAiBD,KAAY,CAACD;AACpC,MAAAA,IAAeC,GAEXC,KAEF,WAAWH,GAAa,GAAG;AAAA,IAE/B,CAAC;AAGD,UAAMI,IAAQP,EAAc,SAAA,GACtBQ,IAAaD,EAAM,MAAM,KAAK,CAACE,MAAMA,EAAE,WAAW,aAAaA,EAAE,WAAW,QAAQ;AAC1F,IAAIF,EAAM,YAAYC,KACpB,WAAWL,GAAa,IAAI;AAAA,EAEhC;AAUF;AAEO,SAASO,IAAc;AAC5B,EAAAjB,KAAA,QAAAA,KACAA,IAAe,MACfD,IAAe;AACjB;"}

package/dist/store.js

@@ -22,10 +22,11 @@ o = {
       [e]: t.resources[e] ? { ...t.resources[e], ...u } : t.resources[e]
     }
   })),
-  unregisterResource: (e) => r((u) => {
-    const { [e]: t, ...s } = u.resources;
-    return { resources: s };
-  }),
+  unregisterResource: (e) => r((u) => ({
+    resources: Object.fromEntries(
+      Object.entries(u.resources).filter(([t]) => t !== e)
+    )
+  })),
   addQueueItem: (e) => r((u) => ({ queue: [...u.queue, e] })),
   updateQueueItem: (e, u) => r((t) => ({
     queue: t.queue.map((s) => s.id === e ? { ...s, ...u } : s)
@@ -42,17 +43,17 @@ o = {
   removeQueueItem: (e) => r((u) => ({ queue: u.queue.filter((t) => t.id !== e) })),
   hydrateQueue: (e) => r(() => ({ queue: e }))
 };
-function d() {
+function i() {
   return o;
 }
-function i(e) {
+function d(e) {
   return n.add(e), () => {
     n.delete(e);
   };
 }
 const f = {
-  getState: d,
-  subscribe: i,
+  getState: i,
+  subscribe: d,
   // Test/devtools helper — merges partial state, preserves action methods.
   setState: (e) => {
     const u = typeof e == "function" ? e(o) : e;

package/dist/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sources":["../src/store.ts"],"sourcesContent":["import type { EidosState, ResourceEntry, ActionQueueItem } from './types'\n\nexport interface EidosStore extends EidosState {\n  // Online\n  setOnline: (online: boolean) => void\n  // SW\n  setSwStatus: (status: EidosState['swStatus'], error?: string) => void\n  // Resources\n  registerResource: (url: string, entry: ResourceEntry) => void\n  updateResource: (url: string, update: Partial<ResourceEntry>) => void\n  unregisterResource: (url: string) => void\n  // Queue\n  addQueueItem: (item: ActionQueueItem) => void\n  updateQueueItem: (id: string, update: Partial<ActionQueueItem>) => void\n  batchUpdateQueueItems: (updates: Array<{ id: string; update: Partial<ActionQueueItem> }>) => void\n  removeQueueItem: (id: string) => void\n  hydrateQueue: (items: ActionQueueItem[]) => void\n}\n\ntype Listener = () => void\n\nlet _state: EidosStore\nconst _listeners = new Set<Listener>()\n\nfunction _notify() {\n  _listeners.forEach((fn) => fn())\n}\n\nfunction _set(updater: (prev: EidosStore) => Partial<EidosStore>) {\n  _state = { ..._state, ...updater(_state) }\n  _notify()\n}\n\n_state = {\n  // navigator.onLine is undefined in React Native — default to true unless explicitly false\n  isOnline: typeof navigator === 'undefined' || navigator.onLine !== false,\n  swStatus: 'idle',\n  swError: undefined,\n  resources: {},\n  queue: [],\n\n  setOnline: (isOnline) => _set(() => ({ isOnline })),\n\n  setSwStatus: (swStatus, swError) => _set(() => ({ swStatus, swError })),\n\n  registerResource: (url, entry) =>\n    _set((s) => ({ resources: { ...s.resources, [url]: entry } })),\n\n  updateResource: (url, update) =>\n    _set((s) => ({\n      resources: {\n        ...s.resources,\n        [url]: s.resources[url] ? { ...s.resources[url], ...update } : s.resources[url],\n      },\n    })),\n\n  unregisterResource: (url) =>\n    _set((s) => {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { [url]: _removed, ...rest } = s.resources\n      return { resources: rest }\n    }),\n\n  addQueueItem: (item) => _set((s) => ({ queue: [...s.queue, item] })),\n\n  updateQueueItem: (id, update) =>\n    _set((s) => ({\n      queue: s.queue.map((item) => (item.id === id ? { ...item, ...update } : item)),\n    })),\n\n  batchUpdateQueueItems: (updates) =>\n    _set((s) => {\n      const map = new Map(updates.map((u) => [u.id, u.update]))\n      return {\n        queue: s.queue.map((item) => {\n          const u = map.get(item.id)\n          return u ? { ...item, ...u } : item\n        }),\n      }\n    }),\n\n  removeQueueItem: (id) => _set((s) => ({ queue: s.queue.filter((item) => item.id !== id) })),\n\n  hydrateQueue: (items) => _set(() => ({ queue: items })),\n}\n\nfunction _getState() {\n  return _state\n}\n\nfunction _subscribe(listener: Listener) {\n  _listeners.add(listener)\n  return () => { _listeners.delete(listener) }\n}\n\nexport const useEidosStore = {\n  getState: _getState,\n  subscribe: _subscribe,\n  // Test/devtools helper — merges partial state, preserves action methods.\n  setState: (partial: Partial<EidosStore> | ((s: EidosStore) => Partial<EidosStore>)) => {\n    const update = typeof partial === 'function' ? partial(_state) : partial\n    _state = { ..._state, ...update }\n    _notify()\n  },\n}\n"],"names":["_state","_listeners","_notify","fn","_set","updater","isOnline","swStatus","swError","url","entry","s","update","_removed","rest","item","id","updates","map","u","items","_getState","_subscribe","listener","useEidosStore","partial"],"mappings":"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"}
+{"version":3,"file":"store.js","sources":["../src/store.ts"],"sourcesContent":["import type { EidosState, ResourceEntry, ActionQueueItem } from './types'\n\nexport interface EidosStore extends EidosState {\n  // Online\n  setOnline: (online: boolean) => void\n  // SW\n  setSwStatus: (status: EidosState['swStatus'], error?: string) => void\n  // Resources\n  registerResource: (url: string, entry: ResourceEntry) => void\n  updateResource: (url: string, update: Partial<ResourceEntry>) => void\n  unregisterResource: (url: string) => void\n  // Queue\n  addQueueItem: (item: ActionQueueItem) => void\n  updateQueueItem: (id: string, update: Partial<ActionQueueItem>) => void\n  batchUpdateQueueItems: (updates: Array<{ id: string; update: Partial<ActionQueueItem> }>) => void\n  removeQueueItem: (id: string) => void\n  hydrateQueue: (items: ActionQueueItem[]) => void\n}\n\ntype Listener = () => void\n\nlet _state: EidosStore\nconst _listeners = new Set<Listener>()\n\nfunction _notify() {\n  _listeners.forEach((fn) => fn())\n}\n\nfunction _set(updater: (prev: EidosStore) => Partial<EidosStore>) {\n  _state = { ..._state, ...updater(_state) }\n  _notify()\n}\n\n_state = {\n  // navigator.onLine is undefined in React Native — default to true unless explicitly false\n  isOnline: typeof navigator === 'undefined' || navigator.onLine !== false,\n  swStatus: 'idle',\n  swError: undefined,\n  resources: {},\n  queue: [],\n\n  setOnline: (isOnline) => _set(() => ({ isOnline })),\n\n  setSwStatus: (swStatus, swError) => _set(() => ({ swStatus, swError })),\n\n  registerResource: (url, entry) =>\n    _set((s) => ({ resources: { ...s.resources, [url]: entry } })),\n\n  updateResource: (url, update) =>\n    _set((s) => ({\n      resources: {\n        ...s.resources,\n        [url]: s.resources[url] ? { ...s.resources[url], ...update } : s.resources[url],\n      },\n    })),\n\n  unregisterResource: (url) =>\n    _set((s) => ({\n      resources: Object.fromEntries(\n        Object.entries(s.resources).filter(([k]) => k !== url),\n      ),\n    })),\n\n  addQueueItem: (item) => _set((s) => ({ queue: [...s.queue, item] })),\n\n  updateQueueItem: (id, update) =>\n    _set((s) => ({\n      queue: s.queue.map((item) => (item.id === id ? { ...item, ...update } : item)),\n    })),\n\n  batchUpdateQueueItems: (updates) =>\n    _set((s) => {\n      const map = new Map(updates.map((u) => [u.id, u.update]))\n      return {\n        queue: s.queue.map((item) => {\n          const u = map.get(item.id)\n          return u ? { ...item, ...u } : item\n        }),\n      }\n    }),\n\n  removeQueueItem: (id) => _set((s) => ({ queue: s.queue.filter((item) => item.id !== id) })),\n\n  hydrateQueue: (items) => _set(() => ({ queue: items })),\n}\n\nfunction _getState() {\n  return _state\n}\n\nfunction _subscribe(listener: Listener) {\n  _listeners.add(listener)\n  return () => { _listeners.delete(listener) }\n}\n\nexport const useEidosStore = {\n  getState: _getState,\n  subscribe: _subscribe,\n  // Test/devtools helper — merges partial state, preserves action methods.\n  setState: (partial: Partial<EidosStore> | ((s: EidosStore) => Partial<EidosStore>)) => {\n    const update = typeof partial === 'function' ? partial(_state) : partial\n    _state = { ..._state, ...update }\n    _notify()\n  },\n}\n"],"names":["_state","_listeners","_notify","fn","_set","updater","isOnline","swStatus","swError","url","entry","s","update","k","item","id","updates","map","u","items","_getState","_subscribe","listener","useEidosStore","partial"],"mappings":"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"}

package/dist/stores.js

@@ -1,11 +1,13 @@
 import { useEidosStore as i } from "./store.js";
-function o(e, t) {
+function a(e, t) {
   const s = Object.keys(e);
   if (s.length !== Object.keys(t).length) return !1;
-  for (const n of s)
-    if (e[n] !== t[n]) return !1;
+  for (const n of s) if (e[n] !== t[n]) return !1;
   return !0;
 }
+function o(e, t) {
+  return a(e, t);
+}
 function u(e, t = Object.is) {
   return {
     subscribe(s) {
@@ -20,10 +22,10 @@ function u(e, t = Object.is) {
     }
   };
 }
-const f = u((e) => e), l = u((e) => e.queue), c = u(
+const l = u((e) => e), c = u((e) => e.queue), d = u(
   (e) => ({ isOnline: e.isOnline, swStatus: e.swStatus, swError: e.swError }),
   o
-), d = u(
+), g = u(
   (e) => {
     let t = 0, s = 0, n = 0;
     for (const r of e.queue)
@@ -32,18 +34,18 @@ const f = u((e) => e), l = u((e) => e.queue), c = u(
   },
   o
 );
-function g(e) {
+function S(e) {
   return u((t) => t.resources[e]);
 }
-function S(e) {
+function b(e) {
   return u((t) => t.queue.find((s) => s.id === e));
 }
 export {
-  S as eidosAction,
-  l as eidosQueue,
-  d as eidosQueueStats,
-  g as eidosResource,
-  c as eidosStatus,
-  f as eidosStore
+  b as eidosAction,
+  c as eidosQueue,
+  g as eidosQueueStats,
+  S as eidosResource,
+  d as eidosStatus,
+  l as eidosStore
 };
 //# sourceMappingURL=stores.js.map

package/dist/stores.js.map

@@ -1 +1 @@
-{"version":3,"file":"stores.js","sources":["../src/stores.ts"],"sourcesContent":["/**\n * Framework-agnostic reactive stores — compatible with Svelte's store protocol,\n * Vue's watchEffect, RxJS, and vanilla JS. Zero framework dependencies.\n *\n * Svelte: use the `$` prefix — `$eidosQueue`, `$eidosStatus`, etc.\n * Vue:    call `.subscribe()` inside a composable with `onUnmounted` cleanup.\n * Vanilla: call `.subscribe(run)` directly; the return value unsubscribes.\n *\n * Each store calls its subscriber whenever any part of the Eidos state changes.\n * For fine-grained subscriptions, use `.getState()` to read the current snapshot\n * and compare manually in the subscriber callback.\n */\n\nimport { useEidosStore } from './store'\nimport type { EidosStore } from './store'\nimport type { ActionQueueItem, ResourceEntry } from './types'\n\n// ── Readable<T> — compatible with Svelte's Readable interface ─────────────────\n\nexport interface EidosReadable<T> {\n  /** Subscribe to value changes. Returns an unsubscribe function. */\n  subscribe(run: (value: T) => void): () => void\n  /** Read the current value synchronously without subscribing. */\n  getState(): T\n}\n\nfunction shallowEqual<T extends Record<string, unknown>>(a: T, b: T): boolean {\n  const keys = Object.keys(a) as (keyof T)[]\n  if (keys.length !== Object.keys(b).length) return false\n  for (const k of keys) {\n    if (a[k] !== b[k]) return false\n  }\n  return true\n}\n\nfunction readable<T>(\n  selector: (s: EidosStore) => T,\n  equal: (a: T, b: T) => boolean = Object.is,\n): EidosReadable<T> {\n  return {\n    subscribe(run) {\n      // Emit current value immediately (Svelte store contract)\n      let last = selector(useEidosStore.getState())\n      run(last)\n      return useEidosStore.subscribe(() => {\n        const next = selector(useEidosStore.getState())\n        if (!equal(last, next)) {\n          last = next\n          run(next)\n        }\n      })\n    },\n    getState() {\n      return selector(useEidosStore.getState())\n    },\n  }\n}\n\n// ── Static stores (created once at module scope) ──────────────────────────────\n\n/** Full Eidos state snapshot. Prefer the narrower stores below. */\nexport const eidosStore: EidosReadable<EidosStore> = readable((s) => s)\n\n/** The action queue. Re-notifies on every queue mutation. */\nexport const eidosQueue: EidosReadable<ActionQueueItem[]> = readable((s) => s.queue)\n\n/**\n * Online status + SW lifecycle.\n * Only re-emits when isOnline, swStatus, or swError actually changes.\n */\nexport const eidosStatus: EidosReadable<{\n  isOnline: boolean\n  swStatus: EidosStore['swStatus']\n  swError: string | undefined\n}> = readable(\n  (s) => ({ isOnline: s.isOnline, swStatus: s.swStatus, swError: s.swError }),\n  shallowEqual as (a: { isOnline: boolean; swStatus: EidosStore['swStatus']; swError: string | undefined }, b: { isOnline: boolean; swStatus: EidosStore['swStatus']; swError: string | undefined }) => boolean,\n)\n\n/**\n * Queue counts. Re-emits only when a count actually changes, not on every\n * queue mutation (e.g. a status transition that doesn't change counts is skipped).\n */\nexport const eidosQueueStats: EidosReadable<{\n  pending: number\n  failed: number\n  replaying: number\n  total: number\n}> = readable(\n  (s) => {\n    // Single pass over the queue — avoids three separate .filter() calls.\n    let pending = 0, failed = 0, replaying = 0\n    for (const q of s.queue) {\n      if (q.status === 'pending') pending++\n      else if (q.status === 'failed') failed++\n      else if (q.status === 'replaying') replaying++\n    }\n    return { pending, failed, replaying, total: s.queue.length }\n  },\n  shallowEqual as (a: { pending: number; failed: number; replaying: number; total: number }, b: { pending: number; failed: number; replaying: number; total: number }) => boolean,\n)\n\n// ── Dynamic stores (created per URL / ID) ─────────────────────────────────────\n\n/**\n * Live cache state for a single registered resource URL.\n * @example\n *   // Svelte\n *   const entry = eidosResource('/api/products')\n *   $: hits = $entry?.cacheHits ?? 0\n */\nexport function eidosResource(url: string): EidosReadable<ResourceEntry | undefined> {\n  return readable((s) => s.resources[url])\n}\n\n/**\n * Live state for a single queue item by ID. Returns `undefined` once the item\n * is removed from the queue (after a successful replay or `clearQueue()`).\n * @example\n *   // Svelte\n *   const item = eidosAction(queuedResult.id)\n *   $: status = $item?.status  // 'pending' | 'replaying' | 'succeeded' | 'failed' | undefined\n */\nexport function eidosAction(id: string): EidosReadable<ActionQueueItem | undefined> {\n  return readable((s) => s.queue.find((item) => item.id === id))\n}\n"],"names":["shallowEqual","a","b","keys","k","readable","selector","equal","run","last","useEidosStore","next","eidosStore","s","eidosQueue","eidosStatus","eidosQueueStats","pending","failed","replaying","q","eidosResource","url","eidosAction","id","item"],"mappings":";AA0BA,SAASA,EAAgDC,GAAMC,GAAe;AAC5E,QAAMC,IAAO,OAAO,KAAKF,CAAC;AAC1B,MAAIE,EAAK,WAAW,OAAO,KAAKD,CAAC,EAAE,OAAQ,QAAO;AAClD,aAAWE,KAAKD;AACd,QAAIF,EAAEG,CAAC,MAAMF,EAAEE,CAAC,EAAG,QAAO;AAE5B,SAAO;AACT;AAEA,SAASC,EACPC,GACAC,IAAiC,OAAO,IACtB;AAClB,SAAO;AAAA,IACL,UAAUC,GAAK;AAEb,UAAIC,IAAOH,EAASI,EAAc,SAAA,CAAU;AAC5C,aAAAF,EAAIC,CAAI,GACDC,EAAc,UAAU,MAAM;AACnC,cAAMC,IAAOL,EAASI,EAAc,SAAA,CAAU;AAC9C,QAAKH,EAAME,GAAME,CAAI,MACnBF,IAAOE,GACPH,EAAIG,CAAI;AAAA,MAEZ,CAAC;AAAA,IACH;AAAA,IACA,WAAW;AACT,aAAOL,EAASI,EAAc,UAAU;AAAA,IAC1C;AAAA,EAAA;AAEJ;AAKO,MAAME,IAAwCP,EAAS,CAACQ,MAAMA,CAAC,GAGzDC,IAA+CT,EAAS,CAACQ,MAAMA,EAAE,KAAK,GAMtEE,IAIRV;AAAA,EACH,CAACQ,OAAO,EAAE,UAAUA,EAAE,UAAU,UAAUA,EAAE,UAAU,SAASA,EAAE,QAAA;AAAA,EACjEb;AACF,GAMagB,IAKRX;AAAA,EACH,CAACQ,MAAM;AAEL,QAAII,IAAU,GAAGC,IAAS,GAAGC,IAAY;AACzC,eAAWC,KAAKP,EAAE;AAChB,MAAIO,EAAE,WAAW,YAAWH,MACnBG,EAAE,WAAW,WAAUF,MACvBE,EAAE,WAAW,eAAaD;AAErC,WAAO,EAAE,SAAAF,GAAS,QAAAC,GAAQ,WAAAC,GAAW,OAAON,EAAE,MAAM,OAAA;AAAA,EACtD;AAAA,EACAb;AACF;AAWO,SAASqB,EAAcC,GAAuD;AACnF,SAAOjB,EAAS,CAACQ,MAAMA,EAAE,UAAUS,CAAG,CAAC;AACzC;AAUO,SAASC,EAAYC,GAAwD;AAClF,SAAOnB,EAAS,CAACQ,MAAMA,EAAE,MAAM,KAAK,CAACY,MAASA,EAAK,OAAOD,CAAE,CAAC;AAC/D;"}
+{"version":3,"file":"stores.js","sources":["../src/stores.ts"],"sourcesContent":["/**\n * Framework-agnostic reactive stores — compatible with Svelte's store protocol,\n * Vue's watchEffect, RxJS, and vanilla JS. Zero framework dependencies.\n *\n * Svelte: use the `$` prefix — `$eidosQueue`, `$eidosStatus`, etc.\n * Vue:    call `.subscribe()` inside a composable with `onUnmounted` cleanup.\n * Vanilla: call `.subscribe(run)` directly; the return value unsubscribes.\n *\n * Each store calls its subscriber whenever any part of the Eidos state changes.\n * For fine-grained subscriptions, use `.getState()` to read the current snapshot\n * and compare manually in the subscriber callback.\n */\n\nimport { useEidosStore } from './store'\nimport type { EidosStore } from './store'\nimport type { ActionQueueItem, ResourceEntry } from './types'\n\n// ── Readable<T> — compatible with Svelte's Readable interface ─────────────────\n\nexport interface EidosReadable<T> {\n  /** Subscribe to value changes. Returns an unsubscribe function. */\n  subscribe(run: (value: T) => void): () => void\n  /** Read the current value synchronously without subscribing. */\n  getState(): T\n}\n\nfunction shallowEqual<T extends Record<string, unknown>>(a: T, b: T): boolean {\n  const keys = Object.keys(a) as (keyof T)[]\n  if (keys.length !== Object.keys(b).length) return false\n  for (const k of keys) if (a[k] !== b[k]) return false\n  return true\n}\n\n// Typed comparator alias so call sites don't need inline casts.\nfunction shallowEq<T extends Record<string, unknown>>(a: T, b: T): boolean {\n  return shallowEqual(a, b)\n}\n\nfunction readable<T>(\n  selector: (s: EidosStore) => T,\n  equal: (a: T, b: T) => boolean = Object.is,\n): EidosReadable<T> {\n  return {\n    subscribe(run) {\n      // Emit current value immediately (Svelte store contract)\n      let last = selector(useEidosStore.getState())\n      run(last)\n      return useEidosStore.subscribe(() => {\n        const next = selector(useEidosStore.getState())\n        if (!equal(last, next)) {\n          last = next\n          run(next)\n        }\n      })\n    },\n    getState() {\n      return selector(useEidosStore.getState())\n    },\n  }\n}\n\n// ── Static stores (created once at module scope) ──────────────────────────────\n\n/** Full Eidos state snapshot. Prefer the narrower stores below. */\nexport const eidosStore: EidosReadable<EidosStore> = readable((s) => s)\n\n/** The action queue. Re-notifies on every queue mutation. */\nexport const eidosQueue: EidosReadable<ActionQueueItem[]> = readable((s) => s.queue)\n\n/**\n * Online status + SW lifecycle.\n * Only re-emits when isOnline, swStatus, or swError actually changes.\n */\nexport const eidosStatus: EidosReadable<{\n  isOnline: boolean\n  swStatus: EidosStore['swStatus']\n  swError: string | undefined\n}> = readable(\n  (s) => ({ isOnline: s.isOnline, swStatus: s.swStatus, swError: s.swError }),\n  shallowEq,\n)\n\n/**\n * Queue counts. Re-emits only when a count actually changes, not on every\n * queue mutation (e.g. a status transition that doesn't change counts is skipped).\n */\nexport const eidosQueueStats: EidosReadable<{\n  pending: number\n  failed: number\n  replaying: number\n  total: number\n}> = readable(\n  (s) => {\n    // Single pass over the queue — avoids three separate .filter() calls.\n    let pending = 0, failed = 0, replaying = 0\n    for (const q of s.queue) {\n      if (q.status === 'pending') pending++\n      else if (q.status === 'failed') failed++\n      else if (q.status === 'replaying') replaying++\n    }\n    return { pending, failed, replaying, total: s.queue.length }\n  },\n  shallowEq,\n)\n\n// ── Dynamic stores (created per URL / ID) ─────────────────────────────────────\n\n/**\n * Live cache state for a single registered resource URL.\n * @example\n *   // Svelte\n *   const entry = eidosResource('/api/products')\n *   $: hits = $entry?.cacheHits ?? 0\n */\nexport function eidosResource(url: string): EidosReadable<ResourceEntry | undefined> {\n  return readable((s) => s.resources[url])\n}\n\n/**\n * Live state for a single queue item by ID. Returns `undefined` once the item\n * is removed from the queue (after a successful replay or `clearQueue()`).\n * @example\n *   // Svelte\n *   const item = eidosAction(queuedResult.id)\n *   $: status = $item?.status  // 'pending' | 'replaying' | 'succeeded' | 'failed' | undefined\n */\nexport function eidosAction(id: string): EidosReadable<ActionQueueItem | undefined> {\n  return readable((s) => s.queue.find((item) => item.id === id))\n}\n"],"names":["shallowEqual","a","b","keys","k","shallowEq","readable","selector","equal","run","last","useEidosStore","next","eidosStore","s","eidosQueue","eidosStatus","eidosQueueStats","pending","failed","replaying","q","eidosResource","url","eidosAction","id","item"],"mappings":";AA0BA,SAASA,EAAgDC,GAAMC,GAAe;AAC5E,QAAMC,IAAO,OAAO,KAAKF,CAAC;AAC1B,MAAIE,EAAK,WAAW,OAAO,KAAKD,CAAC,EAAE,OAAQ,QAAO;AAClD,aAAWE,KAAKD,EAAM,KAAIF,EAAEG,CAAC,MAAMF,EAAEE,CAAC,EAAG,QAAO;AAChD,SAAO;AACT;AAGA,SAASC,EAA6CJ,GAAMC,GAAe;AACzE,SAAOF,EAAaC,GAAGC,CAAC;AAC1B;AAEA,SAASI,EACPC,GACAC,IAAiC,OAAO,IACtB;AAClB,SAAO;AAAA,IACL,UAAUC,GAAK;AAEb,UAAIC,IAAOH,EAASI,EAAc,SAAA,CAAU;AAC5C,aAAAF,EAAIC,CAAI,GACDC,EAAc,UAAU,MAAM;AACnC,cAAMC,IAAOL,EAASI,EAAc,SAAA,CAAU;AAC9C,QAAKH,EAAME,GAAME,CAAI,MACnBF,IAAOE,GACPH,EAAIG,CAAI;AAAA,MAEZ,CAAC;AAAA,IACH;AAAA,IACA,WAAW;AACT,aAAOL,EAASI,EAAc,UAAU;AAAA,IAC1C;AAAA,EAAA;AAEJ;AAKO,MAAME,IAAwCP,EAAS,CAACQ,MAAMA,CAAC,GAGzDC,IAA+CT,EAAS,CAACQ,MAAMA,EAAE,KAAK,GAMtEE,IAIRV;AAAA,EACH,CAACQ,OAAO,EAAE,UAAUA,EAAE,UAAU,UAAUA,EAAE,UAAU,SAASA,EAAE,QAAA;AAAA,EACjET;AACF,GAMaY,IAKRX;AAAA,EACH,CAACQ,MAAM;AAEL,QAAII,IAAU,GAAGC,IAAS,GAAGC,IAAY;AACzC,eAAWC,KAAKP,EAAE;AAChB,MAAIO,EAAE,WAAW,YAAWH,MACnBG,EAAE,WAAW,WAAUF,MACvBE,EAAE,WAAW,eAAaD;AAErC,WAAO,EAAE,SAAAF,GAAS,QAAAC,GAAQ,WAAAC,GAAW,OAAON,EAAE,MAAM,OAAA;AAAA,EACtD;AAAA,EACAT;AACF;AAWO,SAASiB,EAAcC,GAAuD;AACnF,SAAOjB,EAAS,CAACQ,MAAMA,EAAE,UAAUS,CAAG,CAAC;AACzC;AAUO,SAASC,EAAYC,GAAwD;AAClF,SAAOnB,EAAS,CAACQ,MAAMA,EAAE,MAAM,KAAK,CAACY,MAASA,EAAK,OAAOD,CAAE,CAAC;AAC/D;"}

package/dist/version.js

@@ -1,4 +1,4 @@
-const o = "1.0.31";
+const o = "1.0.33";
 export {
   o as VERSION
 };

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sources":["../src/version.ts"],"sourcesContent":["export const VERSION = '1.0.31'\n"],"names":["VERSION"],"mappings":"AAAO,MAAMA,IAAU;"}
+{"version":3,"file":"version.js","sources":["../src/version.ts"],"sourcesContent":["export const VERSION = '1.0.33'\n"],"names":["VERSION"],"mappings":"AAAO,MAAMA,IAAU;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sweidos/eidos",
-  "version": "1.0.31",
+  "version": "1.0.33",
   "description": "Describe intent. The runtime figures out how. An abstraction layer for offline-first web apps.",
   "author": "Aditya Raj",
   "license": "MIT",
@@ -9,14 +9,31 @@
   "keywords": [
     "service-worker",
     "offline",
+    "offline-first",
     "pwa",
     "cache",
+    "cache-api",
     "indexeddb",
     "background-sync",
-    "offline-first",
-    "react"
+    "react",
+    "svelte",
+    "vue",
+    "react-native",
+    "queue",
+    "optimistic-ui",
+    "network-resilience"
   ],
-  "homepage": "https://github.com/iamadi11/eidos",
+  "homepage": "https://sweidos.vercel.app/overview",
+  "bugs": {
+    "url": "https://github.com/iamadi11/eidos/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/iamadi11"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/iamadi11/eidos.git",