@sweidos/eidos 1.0.34 → 1.1.0

package/dist/eidos.cjs

@@ -0,0 +1,15 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});let v=require("react"),j=require("react/jsx-runtime");function X(e){return{registerResource:(t,n)=>e(r=>({resources:{...r.resources,[t]:n}})),updateResource:(t,n)=>e(r=>({resources:{...r.resources,[t]:r.resources[t]?{...r.resources[t],...n}:r.resources[t]}})),unregisterResource:t=>e(n=>({resources:Object.fromEntries(Object.entries(n.resources).filter(([r])=>r!==t))}))}}function Z(e){return{addQueueItem:t=>e(n=>({queue:[...n.queue,t]})),updateQueueItem:(t,n)=>e(r=>({queue:r.queue.map(s=>s.id===t?{...s,...n}:s)})),batchUpdateQueueItems:t=>e(n=>{const r=new Map(t.map(s=>[s.id,s.update]));return{queue:n.queue.map(s=>{const a=r.get(s.id);return a?{...s,...a}:s})}}),removeQueueItem:t=>e(n=>({queue:n.queue.filter(r=>r.id!==t)})),hydrateQueue:t=>e(()=>({queue:t}))}}var g,x=new Set;function W(){x.forEach(e=>e())}function b(e){g={...g,...e(g)},W()}g={isOnline:typeof navigator>"u"||navigator.onLine!==!1,swStatus:"idle",swError:void 0,resources:{},queue:[],setOnline:e=>b(()=>({isOnline:e})),setSwStatus:(e,t)=>b(()=>({swStatus:e,swError:t})),...X(b),...Z(b)};function ee(){return g}function te(e){return x.add(e),()=>{x.delete(e)}}var o={getState:ee,subscribe:te,setState:e=>{const t=typeof e=="function"?e(g):e;g={...g,...t},W()}},y=null,C=[];function ne(){return y}async function re(e){if(typeof navigator>"u"||!("serviceWorker"in navigator)){o.getState().setSwStatus("unsupported");return}const t=o.getState();t.setSwStatus("registering");try{y=await navigator.serviceWorker.register(e,{scope:"/"}),await se(y),t.setSwStatus("active"),navigator.serviceWorker.addEventListener("message",oe),window.addEventListener("online",()=>t.setOnline(!0)),window.addEventListener("offline",()=>t.setOnline(!1)),ue()}catch(n){t.setSwStatus("error",String(n))}}function se(e){return new Promise(t=>{if(e.active){t();return}const n=e.installing??e.waiting;if(!n){t();return}const r=setTimeout(t,1e4);n.addEventListener("statechange",function s(){n.state==="activated"&&(clearTimeout(r),n.removeEventListener("statechange",s),t())})})}function k(e){const t=y?.active;t?t.postMessage(e):C.push(e)}var H=null;function ae(e){H=e}function ie(){try{return typeof navigator<"u"&&"serviceWorker"in navigator&&y!==null&&"sync"in y}catch{return!1}}function oe(e){const t=e.data;if(!t?.type)return;const n=o.getState(),{type:r,url:s}=t;if(r==="EIDOS_BACKGROUND_SYNC"){H?.();return}if(s)switch(r){case"EIDOS_CACHE_HIT":{const a=n.resources[s];n.updateResource(s,{status:"fresh",lastEvent:"cache-hit",cacheHits:(a?.cacheHits??0)+1});break}case"EIDOS_CACHE_UPDATED":n.updateResource(s,{status:"fresh",lastEvent:"cache-updated",cachedAt:Date.now()});break;case"EIDOS_NETWORK_ERROR":n.updateResource(s,{status:"error",lastEvent:"network-error"});break}}function ce(e){k({type:"EIDOS_SIMULATE_OFFLINE",enabled:e}),o.getState().setOnline(!e)}function ue(){const e=y?.active;if(e){for(const t of C)e.postMessage(t);C=[]}}var R=new Map,_=new Map,$=null;function de(e){$=e}function S(e){return e.includes("*")||/:[^/]+/.test(e)}function le(e){return"^"+e.replace(/[.+?^${}()|[\]\\]/g,"\\$&").replace(/\*\*/g,".+").replace(/\*/g,"[^/]+").replace(/:[^/]+/g,"[^/]+")+"$"}function O(e,t){return new Error(`[eidos] resource('${e}') is a URL pattern — ${t}() is not supported on pattern handles. The SW intercepts matching requests automatically; call fetch(specificUrl) directly in your app code.`)}function fe(e,t){if(R.has(e))return R.get(e);const n=pe(t),r=S(e)?le(e):void 0,s={url:e,config:t,strategy:n,status:"idle",cacheHits:0,cacheMisses:0};o.getState().registerResource(e,s),k({type:"EIDOS_REGISTER_RESOURCE",url:e,strategy:n.swStrategy,cacheName:n.cacheName,...r!==void 0&&{pattern:r}});const a={url:e,config:t,strategy:n,fetch:async()=>{if(S(e))throw O(e,"fetch");const i=_.get(e);if(i)return i.then(u=>u.clone());const c=he(e,t,n);return _.set(e,c),c.finally(()=>_.delete(e)).catch(()=>{}),c.then(u=>u.clone())},json:async()=>{if(S(e))throw O(e,"json");return(await a.fetch()).json()},query:()=>{if(S(e))throw O(e,"query");return{queryKey:["eidos",e],queryFn:()=>a.json()}},prefetch:async()=>{if(S(e))throw O(e,"prefetch");await a.fetch()},invalidate:async()=>{k({type:"EIDOS_CLEAR_CACHE",url:e});const i=await caches.open(n.cacheName).catch(()=>null);if(i){const c=await i.keys(),u=r?new RegExp(r):null,p=e.startsWith("http");await Promise.all(c.filter(w=>{const l=w.url,T=new URL(l).pathname;return u?u.test(p?l:T):p?l===e:l===e||T===e}).map(w=>i.delete(w)))}S(e)||o.getState().updateResource(e,{status:"stale",cachedAt:void 0,lastEvent:"cache-cleared",cacheHits:0,cacheMisses:0}),$?.(["eidos",e])},unregister:()=>{R.delete(e),k({type:"EIDOS_UNREGISTER_RESOURCE",url:e}),o.getState().unregisterResource(e)}};return R.set(e,a),a}async function he(e,t,n){const r=o.getState();r.updateResource(e,{status:"fetching",fetchedAt:Date.now()});const s=await caches.open(n.cacheName).catch(()=>null);try{if(n.swStrategy!=="network-first"){const c=s?await s.match(e).catch(()=>null):null,u=o.getState().resources[e],p=t.maxAge!==void 0&&u?.cachedAt!==void 0&&Date.now()-u.cachedAt>t.maxAge;if(c&&!p)return r.updateResource(e,{status:"fresh",lastEvent:"cache-hit",cacheHits:(u?.cacheHits??0)+1}),n.swStrategy==="stale-while-revalidate"&&fetch(e,{signal:AbortSignal.timeout(5e3)}).then(async l=>{l.ok&&s&&(await s.put(e,l.clone()),o.getState().updateResource(e,{cachedAt:Date.now(),lastEvent:"cache-updated"}))}).catch(()=>{}),c;const w=o.getState().resources[e];r.updateResource(e,{cacheMisses:(w?.cacheMisses??0)+1})}const a=await fetch(e);if(a.ok)return s&&await s.put(e,a.clone()),r.updateResource(e,{status:"fresh",cachedAt:Date.now(),lastEvent:"cache-updated"}),a;r.updateResource(e,{status:a.status===503?"offline":"error"});const i=a.headers.get("X-Eidos-Offline")==="true";throw new Error(i?`offline: no cached response for ${e}`:`${a.status} ${a.statusText}`)}catch(a){const i=s?await s.match(e).catch(()=>null):null;if(i){const c=o.getState().resources[e];return r.updateResource(e,{status:"fresh",lastEvent:"cache-hit",cacheHits:(c?.cacheHits??0)+1}),i}throw r.updateResource(e,{status:"error"}),a}}function pe(e){const t=e.strategy;return e.offline?M(t??"stale-while-revalidate",e.cacheName):M(t??"network-first",e.cacheName)}var ge={"stale-while-revalidate":"StaleWhileRevalidate","cache-first":"CacheFirst","network-first":"NetworkFirst"},we={"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:["Cache hit → return immediately, kick off background revalidation","Cache miss → fetch from network, cache the response, return it","Offline → return cached version if available, 503 if not","Reconnect → next request triggers a background refresh"],equivalentCode:`// Workbox equivalent
+new StaleWhileRevalidate({
+  cacheName: 'eidos-resources-v1',
+  plugins: [new ExpirationPlugin({ maxEntries: 60 })],
+})`},"cache-first":{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","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"],equivalentCode:`// Workbox equivalent
+new CacheFirst({
+  cacheName: 'eidos-resources-v1',
+  plugins: [new ExpirationPlugin({ maxEntries: 60 })],
+})`},"network-first":{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","Network success → update cache, return fresh response","Network failure → fall back to cached version","Offline with empty cache → return 503 error response"],equivalentCode:`// Workbox equivalent
+new NetworkFirst({
+  cacheName: 'eidos-resources-v1',
+  networkTimeoutSeconds: 3,
+})`}};function M(e,t){const n=we[e];return{name:ge[e],swStrategy:e,cacheName:t??"eidos-resources-v1",reasoning:n.reasoning,behavior:n.behavior,equivalentCode:""}}async function ye(e){const t=await Promise.allSettled(e.map(r=>r.prefetch())),n=t.filter(r=>r.status==="rejected").map(r=>r.reason);return{warmed:t.filter(r=>r.status==="fulfilled").length,failed:n.length,errors:n}}var Se="eidos",ve=1,d="action-queue",A=null;function m(){return A?Promise.resolve(A):new Promise((e,t)=>{const n=indexedDB.open(Se,ve);n.onupgradeneeded=r=>{const s=r.target.result;if(!s.objectStoreNames.contains(d)){const a=s.createObjectStore(d,{keyPath:"id"});a.createIndex("status","status",{unique:!1}),a.createIndex("actionId","actionId",{unique:!1})}},n.onsuccess=()=>{A=n.result,e(n.result)},n.onerror=()=>t(n.error)})}async function me(e){const t=await m();return new Promise((n,r)=>{const s=t.transaction(d,"readwrite");s.objectStore(d).add(e),s.oncomplete=()=>n(),s.onerror=()=>r(s.error)})}async function L(){const e=await m();return new Promise((t,n)=>{const r=e.transaction(d,"readonly").objectStore(d).getAll();r.onsuccess=()=>t(r.result),r.onerror=()=>n(r.error)})}async function Ee(e,t){const n=await m();return new Promise((r,s)=>{const a=n.transaction(d,"readwrite"),i=a.objectStore(d),c=i.get(e);c.onsuccess=()=>{c.result&&i.put({...c.result,...t})},a.oncomplete=()=>r(),a.onerror=()=>s(a.error)})}async function be(e){const t=await m();return new Promise((n,r)=>{const s=t.transaction(d,"readwrite");s.objectStore(d).delete(e),s.oncomplete=()=>n(),s.onerror=()=>r(s.error)})}async function Re(){const e=await m();function t(s){return new Promise((a,i)=>{const c=e.transaction(d,"readonly").objectStore(d).index("status"),u=[],p=c.openCursor(IDBKeyRange.only(s));p.onsuccess=w=>{const l=w.target.result;l?(u.push(l.value),l.continue()):a(u)},p.onerror=()=>i(p.error)})}const[n,r]=await Promise.all([t("pending"),t("failed")]);return[...n,...r]}async function Oe(){const e=await m();return new Promise((t,n)=>{const r=e.transaction(d,"readwrite");r.objectStore(d).clear(),r.oncomplete=()=>t(),r.onerror=()=>n(r.error)})}var ke={add:me,getAll:L,getPending:Re,update:Ee,remove:be,clear:Oe},B=null;function qe(e){B=e}function F(){return B}var N=new Map,G=new Map,K=new Map;function h(){return F()??ke}function V(){return crypto.randomUUID()}function _e(e,t){const n=t.name||e.name||V();N.set(n,e),t.onRollback&&G.set(n,t.onRollback),t.onConflict&&K.set(n,t.onConflict);const r=async(...s)=>{const{isOnline:a}=o.getState();if(t.onOptimistic?.(...s),t.reliability==="neverLose"){if(!a)return U(n,n,s,t);try{return await e(...s)}catch{return U(n,n,s,t)}}try{return await e(...s)}catch(i){throw t.onRollback?.(...s),i}};return Object.defineProperty(r,"id",{value:n,writable:!1}),Object.defineProperty(r,"config",{value:t,writable:!1}),r}async function U(e,t,n,r){const s=V(),a={id:s,actionId:e,actionName:t,args:n,queuedAt:Date.now(),retryCount:0,maxRetries:r.maxRetries??3,status:"pending",priority:r.priority??"normal"};await h().add(a),o.getState().addQueueItem(a);try{const i=ne();i&&"sync"in i&&await i.sync.register("eidos-queue-replay")}catch{}return{queued:!0,id:s,message:`"${t}" queued — will execute when online`}}function Ae(e){if(e instanceof Response)return e.status>=400&&e.status<500;if(typeof e=="object"&&e!==null){const t=e.status;if(typeof t=="number")return t>=400&&t<500}return!1}function Ie(e){return Math.min(2e3*2**e,3e5)*(.8+Math.random()*.4)}var I=!1;async function q(){const e=o.getState();if(!e.isOnline||I)return{attempted:0,succeeded:0,failed:0,retrying:0,skipped:0,conflicted:0};I=!0;try{return await Ce(e)}finally{I=!1}}async function Qe(e,t){const n=N.get(e.actionId);if(!n)return"skipped";try{await n(...e.args);const r=Date.now();return t.updateQueueItem(e.id,{status:"succeeded",completedAt:r}),await h().update(e.id,{status:"succeeded",completedAt:r}),setTimeout(()=>{t.removeQueueItem(e.id),h().remove(e.id)},3e3),"succeeded"}catch(r){if(Ae(r)){const a=K.get(e.actionId);if(a&&a(r,e.args)==="skip")return t.removeQueueItem(e.id),await h().remove(e.id),"conflicted"}const s=e.retryCount+1;if(s>=e.maxRetries)return t.updateQueueItem(e.id,{status:"failed",error:String(r),retryCount:s}),await h().update(e.id,{status:"failed",error:String(r),retryCount:s}),G.get(e.actionId)?.(...e.args),"failed";{const a=Date.now()+Ie(s);return t.updateQueueItem(e.id,{status:"pending",retryCount:s,nextRetryAt:a}),await h().update(e.id,{status:"pending",retryCount:s,nextRetryAt:a}),"retrying"}}}async function xe(e,t,n){if(e.length===0)return;const r=e.filter(a=>N.has(a.actionId));if(n.skipped+=e.length-r.length,r.length>0){t.batchUpdateQueueItems(r.map(a=>({id:a.id,update:{status:"replaying"}})));for(const a of r)h().update(a.id,{status:"replaying"})}const s=await Promise.allSettled(r.map(a=>Qe(a,t)));for(const a of s){const i=a.status==="fulfilled"?a.value:"failed";i==="skipped"?n.skipped++:i==="conflicted"?n.conflicted++:(n.attempted++,n[i]++)}}async function Ce(e){const t=await h().getPending(),n=Date.now(),r=t.filter(a=>a.retryCount<a.maxRetries&&(!a.nextRetryAt||a.nextRetryAt<=n)),s={attempted:0,succeeded:0,failed:0,retrying:0,skipped:0,conflicted:0};for(const a of["high","normal","low"])await xe(r.filter(i=>(i.priority??"normal")===a),e,s);return s}async function Pe(){await h().clear(),o.getState().hydrateQueue([])}function Y(){let e=o.getState().isOnline;const t=o.subscribe(()=>{const{isOnline:s}=o.getState(),a=s&&!e;e=s,a&&setTimeout(q,600)}),n=o.getState(),r=n.queue.some(s=>s.status==="pending");return n.isOnline&&r&&setTimeout(q,1200),t}var P=!1,D=null;async function J(e={}){if(typeof window>"u"||P)return;P=!0;const t=e.swPath??"/eidos-sw.js",n=e.autoReplay??!0;try{const r=await L();r.length>0&&o.getState().hydrateQueue(r)}catch{}try{await re(t)}catch{}ae(()=>{o.getState().isOnline&&setTimeout(q,200)}),n&&(D=Y())}function De(){D?.(),D=null,P=!1}var Q="@eidos:queue",Ne=class{constructor(e){this.storage=e}async readAll(){try{const e=await this.storage.getItem(Q);return e?JSON.parse(e):[]}catch{return[]}}async writeAll(e){await this.storage.setItem(Q,JSON.stringify(e))}async add(e){const t=await this.readAll();t.push(e),await this.writeAll(t)}async getAll(){return this.readAll()}async getPending(){return(await this.readAll()).filter(e=>e.status==="pending"||e.status==="failed")}async update(e,t){const n=await this.readAll(),r=n.findIndex(s=>s.id===e);r!==-1&&(n[r]={...n[r],...t}),await this.writeAll(n)}async remove(e){const t=await this.readAll();await this.writeAll(t.filter(n=>n.id!==e))}async clear(){await this.storage.removeItem(Q)}};function Te({children:e,swPath:t,autoReplay:n}){return(0,v.useEffect)(()=>{J({swPath:t,autoReplay:n})},[]),(0,j.jsx)(j.Fragment,{children:e})}function f(e){const t=e??(n=>n);return(0,v.useSyncExternalStore)(o.subscribe,()=>t(o.getState()))}function je(){return f()}function Me(){return f(e=>e.resources)}function Ue(e){return f(t=>t.resources[e])}function We(){return f(e=>e.queue)}function He(e){return f(t=>t.queue.find(n=>n.id===e))}function $e(){return{isOnline:f(e=>e.isOnline),swStatus:f(e=>e.swStatus),swError:f(e=>e.swError)}}function Le(){const[e,t,n,r]=f(s=>{let a=0,i=0,c=0;for(const u of s.queue)u.status==="pending"?a++:u.status==="failed"?i++:u.status==="replaying"&&c++;return`${a},${i},${c},${s.queue.length}`}).split(",");return{pending:+e,failed:+t,replaying:+n,total:+r}}function Be(e){const t=f(s=>s.queue.length),n=(0,v.useRef)(0),r=(0,v.useRef)(e);(0,v.useEffect)(()=>{r.current=e}),(0,v.useEffect)(()=>{n.current>0&&t===0&&r.current(),n.current=t},[t])}var Fe="1.1.0";function Ge(e,t){const n=Object.keys(e);if(n.length!==Object.keys(t).length)return!1;for(const r of n)if(e[r]!==t[r])return!1;return!0}function z(e,t){return Ge(e,t)}function E(e,t=Object.is){return{subscribe(n){let r=e(o.getState());return n(r),o.subscribe(()=>{const s=e(o.getState());t(r,s)||(r=s,n(s))})},getState(){return e(o.getState())}}}var Ke=E(e=>e),Ve=E(e=>e.queue),Ye=E(e=>({isOnline:e.isOnline,swStatus:e.swStatus,swError:e.swError}),z),Je=E(e=>{let t=0,n=0,r=0;for(const s of e.queue)s.status==="pending"?t++:s.status==="failed"?n++:s.status==="replaying"&&r++;return{pending:t,failed:n,replaying:r,total:e.queue.length}},z);function ze(e){return E(t=>t.resources[e])}function Xe(e){return E(t=>t.queue.find(n=>n.id===e))}exports.AsyncStorageQueueStorage=Ne;exports.EidosProvider=Te;exports.VERSION=Fe;exports._getQueueStorage=F;exports._resetEidos=De;exports.action=_e;exports.clearQueue=Pe;exports.eidosAction=Xe;exports.eidosQueue=Ve;exports.eidosQueueStats=Je;exports.eidosResource=ze;exports.eidosStatus=Ye;exports.eidosStore=Ke;exports.initEidos=J;exports.isBgSyncSupported=ie;exports.replayQueue=q;exports.resource=fe;exports.setOfflineSimulation=ce;exports.setQueryInvalidator=de;exports.setQueueStorage=qe;exports.subscribeReplayOnReconnect=Y;exports.useEidos=je;exports.useEidosAction=He;exports.useEidosOnDrain=Be;exports.useEidosQueue=We;exports.useEidosQueueStats=Le;exports.useEidosResource=Ue;exports.useEidosResources=Me;exports.useEidosStatus=$e;exports.useEidosStore=o;exports.warmCache=ye;
+
+//# sourceMappingURL=eidos.cjs.map

package/dist/idb.js

@@ -1,80 +1,83 @@
-const p = "eidos";
-const o = "action-queue";
-let b = null;
-function a() {
+var f = "eidos", p = 1, o = "action-queue", b = null;
+function c() {
   return b ? Promise.resolve(b) : new Promise((s, n) => {
-    const t = indexedDB.open(p, 1);
-    t.onupgradeneeded = (r) => {
-      const e = r.target.result;
-      if (!e.objectStoreNames.contains(o)) {
-        const c = e.createObjectStore(o, { keyPath: "id" });
-        c.createIndex("status", "status", { unique: !1 }), c.createIndex("actionId", "actionId", { unique: !1 });
+    const r = indexedDB.open(f, p);
+    r.onupgradeneeded = (e) => {
+      const t = e.target.result;
+      if (!t.objectStoreNames.contains(o)) {
+        const a = t.createObjectStore(o, { keyPath: "id" });
+        a.createIndex("status", "status", { unique: !1 }), a.createIndex("actionId", "actionId", { unique: !1 });
       }
-    }, t.onsuccess = () => {
-      b = t.result, s(t.result);
-    }, t.onerror = () => n(t.error);
+    }, r.onsuccess = () => {
+      b = r.result, s(r.result);
+    }, r.onerror = () => n(r.error);
   });
 }
-async function x(s) {
-  const n = await a();
-  return new Promise((t, r) => {
-    const e = n.transaction(o, "readwrite");
-    e.objectStore(o).add(s), e.oncomplete = () => t(), e.onerror = () => r(e.error);
+async function g(s) {
+  const n = await c();
+  return new Promise((r, e) => {
+    const t = n.transaction(o, "readwrite");
+    t.objectStore(o).add(s), t.oncomplete = () => r(), t.onerror = () => e(t.error);
   });
 }
 async function y() {
-  const s = await a();
-  return new Promise((n, t) => {
+  const s = await c();
+  return new Promise((n, r) => {
     const e = s.transaction(o, "readonly").objectStore(o).getAll();
-    e.onsuccess = () => n(e.result), e.onerror = () => t(e.error);
+    e.onsuccess = () => n(e.result), e.onerror = () => r(e.error);
   });
 }
 async function P(s, n) {
-  const t = await a();
-  return new Promise((r, e) => {
-    const c = t.transaction(o, "readwrite"), i = c.objectStore(o), u = i.get(s);
-    u.onsuccess = () => {
-      u.result && i.put({ ...u.result, ...n });
-    }, c.oncomplete = () => r(), c.onerror = () => e(c.error);
+  const r = await c();
+  return new Promise((e, t) => {
+    const a = r.transaction(o, "readwrite"), u = a.objectStore(o), i = u.get(s);
+    i.onsuccess = () => {
+      i.result && u.put({
+        ...i.result,
+        ...n
+      });
+    }, a.oncomplete = () => e(), a.onerror = () => t(a.error);
   });
 }
 async function S(s) {
-  const n = await a();
-  return new Promise((t, r) => {
-    const e = n.transaction(o, "readwrite");
-    e.objectStore(o).delete(s), e.oncomplete = () => t(), e.onerror = () => r(e.error);
+  const n = await c();
+  return new Promise((r, e) => {
+    const t = n.transaction(o, "readwrite");
+    t.objectStore(o).delete(s), t.oncomplete = () => r(), t.onerror = () => e(t.error);
   });
 }
-async function g() {
-  const s = await a();
-  function n(e) {
-    return new Promise((c, i) => {
-      const w = s.transaction(o, "readonly").objectStore(o).index("status"), m = [], d = w.openCursor(IDBKeyRange.only(e));
-      d.onsuccess = (f) => {
-        const l = f.target.result;
-        l ? (m.push(l.value), l.continue()) : c(m);
-      }, d.onerror = () => i(d.error);
+async function x() {
+  const s = await c();
+  function n(t) {
+    return new Promise((a, u) => {
+      const i = s.transaction(o, "readonly").objectStore(o).index("status"), m = [], d = i.openCursor(IDBKeyRange.only(t));
+      d.onsuccess = (w) => {
+        const l = w.target.result;
+        l ? (m.push(l.value), l.continue()) : a(m);
+      }, d.onerror = () => u(d.error);
     });
   }
-  const [t, r] = await Promise.all([
-    n("pending"),
-    n("failed")
-  ]);
-  return [...t, ...r];
+  const [r, e] = await Promise.all([n("pending"), n("failed")]);
+  return [...r, ...e];
 }
-async function I() {
-  const s = await a();
-  return new Promise((n, t) => {
-    const r = s.transaction(o, "readwrite");
-    r.objectStore(o).clear(), r.oncomplete = () => n(), r.onerror = () => t(r.error);
+async function v() {
+  const s = await c();
+  return new Promise((n, r) => {
+    const e = s.transaction(o, "readwrite");
+    e.objectStore(o).clear(), e.oncomplete = () => n(), e.onerror = () => r(e.error);
   });
 }
+var j = {
+  add: g,
+  getAll: y,
+  getPending: x,
+  update: P,
+  remove: S,
+  clear: v
+};
 export {
-  x as idbAddToQueue,
-  I as idbClearQueue,
-  g as idbGetPendingItems,
   y as idbGetQueue,
-  S as idbRemoveFromQueue,
-  P as idbUpdateQueueItem
+  j as idbQueueStorage
 };
-//# sourceMappingURL=idb.js.map
+
+//# sourceMappingURL=idb.js.map

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { JSX as JSX_2 } from 'react';
+import { JSX } from 'react';
 import { ReactNode } from 'react';
 
 export declare function action<TArgs extends any[], TReturn>(fn: ActionFn<TArgs, TReturn>, config: ActionConfig): ActionHandle<TArgs, TReturn>;
@@ -131,7 +131,7 @@ export declare interface EidosConfig {
  *   <App />
  * </EidosProvider>
  */
-export declare function EidosProvider({ children, swPath, autoReplay }: EidosProviderProps): JSX_2.Element;
+export declare function EidosProvider({ children, swPath, autoReplay }: EidosProviderProps): JSX.Element;
 
 declare interface EidosProviderProps extends EidosConfig {
     children: ReactNode;
@@ -185,20 +185,9 @@ export declare const eidosStatus: EidosReadable<{
     swError: string | undefined;
 }>;
 
-export declare interface EidosStore extends EidosState {
+export declare interface EidosStore extends EidosState, ResourceActions, QueueActions {
     setOnline: (online: boolean) => void;
     setSwStatus: (status: EidosState['swStatus'], error?: string) => void;
-    registerResource: (url: string, entry: ResourceEntry) => void;
-    updateResource: (url: string, update: Partial<ResourceEntry>) => void;
-    unregisterResource: (url: string) => void;
-    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;
 }
 
 /** Full Eidos state snapshot. Prefer the narrower stores below. */
@@ -228,6 +217,17 @@ declare type Listener = () => void;
 
 declare type QueryInvalidator = (queryKey: [string, string]) => void;
 
+declare 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 interface QueuedResult {
     readonly queued: true;
     readonly id: string;
@@ -265,6 +265,12 @@ export declare function _resetEidos(): void;
 
 export declare function resource<T = unknown>(url: string, config: ResourceConfig): ResourceHandle<T>;
 
+declare interface ResourceActions {
+    registerResource: (url: string, entry: ResourceEntry) => void;
+    updateResource: (url: string, update: Partial<ResourceEntry>) => void;
+    unregisterResource: (url: string) => void;
+}
+
 export declare interface ResourceConfig {
     /** Make this resource available when the device is offline. */
     offline: boolean;
@@ -314,6 +320,22 @@ export declare function setQueueStorage(s: QueueStorage): void;
 
 declare function _subscribe(listener: Listener): () => void;
 
+/**
+ * Subscribe to online/offline transitions and trigger replayQueue() on
+ * reconnect, plus replay any pending items left over from a previous session.
+ *
+ * Shared by the web (runtime.ts) and React Native (runtime-rn.ts) init paths.
+ *
+ * WHY subscribe to the store instead of window.addEventListener('online'):
+ * setOfflineSimulation() updates the store directly but never fires a real
+ * browser `online` event. Watching the store catches both:
+ *   • Real network reconnects (sw-bridge updates store on window.online)
+ *   • Simulation toggled off (setOfflineSimulation(false) → store.setOnline(true))
+ *
+ * Returns an unsubscribe function.
+ */
+export declare function subscribeReplayOnReconnect(): () => void;
+
 /** Full Eidos store — prefer the narrower hooks below for performance. */
 export declare function useEidos(): EidosStore;
 
@@ -372,7 +394,7 @@ export declare const useEidosStore: {
     setState: (partial: Partial<EidosStore> | ((s: EidosStore) => Partial<EidosStore>)) => void;
 };
 
-export declare const VERSION = "1.0.34";
+export declare const VERSION = "1.1.0";
 
 /**
  * Bulk-prefetch an array of resource handles concurrently, warming the cache

package/dist/index.js

@@ -1,44 +1,45 @@
-import { resource as r, setQueryInvalidator as s, warmCache as t } from "./resource.js";
-import { action as i, clearQueue as d, replayQueue as a } from "./action.js";
-import { _resetEidos as S, initEidos as f } from "./runtime.js";
-import { _getQueueStorage as E, setQueueStorage as c } from "./queue-storage.js";
-import { AsyncStorageQueueStorage as x } from "./async-storage-adapter.js";
-import { EidosProvider as g } from "./react/Provider.js";
-import { useEidos as y, useEidosAction as R, useEidosOnDrain as A, useEidosQueue as O, useEidosQueueStats as v, useEidosResource as I, useEidosResources as _, useEidosStatus as h } from "./react/hooks.js";
-import { VERSION as B } from "./version.js";
-import { isBgSyncSupported as D, setOfflineSimulation as N } from "./sw-bridge.js";
-import { useEidosStore as V } from "./store.js";
-import { eidosAction as j, eidosQueue as k, eidosQueueStats as q, eidosResource as z, eidosStatus as F, eidosStore as G } from "./stores.js";
+import { useEidosStore as o } from "./store.js";
+import { isBgSyncSupported as s, setOfflineSimulation as i } from "./sw-bridge.js";
+import { resource as u, setQueryInvalidator as m, warmCache as d } from "./resource.js";
+import { _getQueueStorage as p, setQueueStorage as c } from "./queue-storage.js";
+import { action as n, clearQueue as S, replayQueue as E } from "./action.js";
+import { subscribeReplayOnReconnect as g } from "./replay.js";
+import { _resetEidos as R, initEidos as y } from "./runtime.js";
+import { AsyncStorageQueueStorage as A } from "./async-storage-adapter.js";
+import { EidosProvider as v } from "./react/Provider.js";
+import { useEidos as _, useEidosAction as h, useEidosOnDrain as w, useEidosQueue as x, useEidosQueueStats as B, useEidosResource as C, useEidosResources as D, useEidosStatus as N } from "./react/hooks.js";
+import { VERSION as V } from "./version.js";
+import { eidosAction as k, eidosQueue as q, eidosQueueStats as z, eidosResource as F, eidosStatus as G, eidosStore as H } from "./stores.js";
 export {
-  x as AsyncStorageQueueStorage,
-  g as EidosProvider,
-  B as VERSION,
-  E as _getQueueStorage,
-  S as _resetEidos,
-  i as action,
-  d as clearQueue,
-  j as eidosAction,
-  k as eidosQueue,
-  q as eidosQueueStats,
-  z as eidosResource,
-  F as eidosStatus,
-  G as eidosStore,
-  f as initEidos,
-  D as isBgSyncSupported,
-  a as replayQueue,
-  r as resource,
-  N as setOfflineSimulation,
-  s as setQueryInvalidator,
+  A as AsyncStorageQueueStorage,
+  v as EidosProvider,
+  V as VERSION,
+  p as _getQueueStorage,
+  R as _resetEidos,
+  n as action,
+  S as clearQueue,
+  k as eidosAction,
+  q as eidosQueue,
+  z as eidosQueueStats,
+  F as eidosResource,
+  G as eidosStatus,
+  H as eidosStore,
+  y as initEidos,
+  s as isBgSyncSupported,
+  E as replayQueue,
+  u as resource,
+  i as setOfflineSimulation,
+  m as setQueryInvalidator,
   c as setQueueStorage,
-  y as useEidos,
-  R as useEidosAction,
-  A as useEidosOnDrain,
-  O as useEidosQueue,
-  v as useEidosQueueStats,
-  I as useEidosResource,
-  _ as useEidosResources,
-  h as useEidosStatus,
-  V as useEidosStore,
-  t as warmCache
+  g as subscribeReplayOnReconnect,
+  _ as useEidos,
+  h as useEidosAction,
+  w as useEidosOnDrain,
+  x as useEidosQueue,
+  B as useEidosQueueStats,
+  C as useEidosResource,
+  D as useEidosResources,
+  N as useEidosStatus,
+  o as useEidosStore,
+  d as warmCache
 };
-//# sourceMappingURL=index.js.map

package/dist/nextjs.js

@@ -1,12 +1,3 @@
 "use client";
 import { EidosProvider, useEidos, useEidosAction, useEidosOnDrain, useEidosQueue, useEidosQueueStats, useEidosResource, useEidosStatus } from "@sweidos/eidos";
-export {
-  EidosProvider,
-  useEidos,
-  useEidosAction,
-  useEidosOnDrain,
-  useEidosQueue,
-  useEidosQueueStats,
-  useEidosResource,
-  useEidosStatus
-};
+export { EidosProvider, useEidos, useEidosAction, useEidosOnDrain, useEidosQueue, useEidosQueueStats, useEidosResource, useEidosStatus };

package/dist/query.cjs

@@ -0,0 +1,131 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _tanstack_react_query = require("@tanstack/react-query");
+let _sweidos_eidos = require("@sweidos/eidos");
+//#region src/query.ts
+/**
+* @sweidos/eidos/query
+*
+* TanStack Query (React Query) integration for Eidos.
+*
+* @example
+* ```ts
+* // Register once (e.g. alongside new QueryClient())
+* import { withEidosQueryClient } from '@sweidos/eidos/query'
+* withEidosQueryClient(queryClient)
+*
+* // In components
+* import { useEidosQuery, useEidosMutation } from '@sweidos/eidos/query'
+*
+* const { data, isPending } = useEidosQuery(products)
+*
+* const mutation = useEidosMutation(createOrder, {
+*   invalidates: [products],
+* })
+* ```
+*/
+var _globalClient = null;
+/**
+* Register a QueryClient with Eidos.
+*
+* Once called, `handle.invalidate()` will also call
+* `queryClient.invalidateQueries({ queryKey: ['eidos', url] })`, keeping
+* TanStack Query's cache in sync with Eidos's Cache Storage.
+*
+* Call this once, before rendering — e.g. alongside `new QueryClient()`.
+*
+* @example
+* ```ts
+* const queryClient = new QueryClient()
+* withEidosQueryClient(queryClient)
+*
+* // Wrap your app as usual
+* <QueryClientProvider client={queryClient}>
+*   <App />
+* </QueryClientProvider>
+* ```
+*/
+function withEidosQueryClient(client) {
+	_globalClient = client;
+	(0, _sweidos_eidos.setQueryInvalidator)((queryKey) => {
+		client.invalidateQueries({ queryKey });
+	});
+}
+/**
+* Wraps `useQuery` with Eidos-smart defaults.
+*
+* Key differences from plain `useQuery`:
+* - `networkMode: 'always'` — Eidos owns offline logic; queries run even when
+*   `navigator.onLine` is false (the SW cache or IndexedDB serves the data).
+* - `retry: false` — Eidos handles retries at the SW / replay layer; TQ
+*   retrying on top would double-fire and fight Eidos's backoff.
+*
+* @example
+* ```ts
+* const products = resource('/api/products', { offline: true })
+*
+* // Automatically typed as UseQueryResult<Product[]>
+* const { data, isPending, isError } = useEidosQuery<Product[]>(products)
+*
+* // Override any TQ option
+* const { data } = useEidosQuery(products, { staleTime: 30_000 })
+* ```
+*/
+function useEidosQuery(handle, options) {
+	return (0, _tanstack_react_query.useQuery)({
+		networkMode: "always",
+		retry: false,
+		...options,
+		...handle.query()
+	});
+}
+/**
+* Wraps `useMutation` for a single-argument Eidos action handle.
+*
+* Key differences from plain `useMutation`:
+* - `networkMode: 'always'` — action executes (or queues) even when offline.
+* - `invalidates` — shorthand to clear resource caches on success. Triggers
+*   both Eidos Cache Storage and TanStack Query invalidation (requires
+*   `withEidosQueryClient` for the TQ half).
+* - Return type is `TData | QueuedResult`. Narrow with `'queued' in data` to
+*   detect the offline-queued case.
+*
+* @example
+* ```ts
+* const mutation = useEidosMutation(createOrder, {
+*   invalidates: [products],
+*   onSuccess(data) {
+*     if ('queued' in data) toast('Saved offline — will sync when back online')
+*     else toast(`Order #${data.id} created!`)
+*   },
+* })
+*
+* // Trigger
+* mutation.mutate({ productId: 1, qty: 2 })
+* ```
+*/
+function useEidosMutation(handle, options) {
+	let contextClient = null;
+	try {
+		contextClient = (0, _tanstack_react_query.useQueryClient)();
+	} catch {}
+	const { invalidates, onSuccess, ...rest } = options ?? {};
+	return (0, _tanstack_react_query.useMutation)({
+		networkMode: "always",
+		...rest,
+		mutationFn: (arg) => handle(arg),
+		onSuccess: async (...args) => {
+			const [data] = args;
+			if (invalidates?.length) {
+				await Promise.all(invalidates.map((h) => h.invalidate()));
+				if (!_globalClient && contextClient) invalidates.forEach((h) => {
+					contextClient.invalidateQueries({ queryKey: h.query().queryKey });
+				});
+			}
+			if (onSuccess) await onSuccess(...args);
+		}
+	});
+}
+//#endregion
+exports.useEidosMutation = useEidosMutation;
+exports.useEidosQuery = useEidosQuery;
+exports.withEidosQueryClient = withEidosQueryClient;