@sweidos/eidos 1.1.0 → 1.2.0

package/dist/eidos.cjs

@@ -1,4 +1,4 @@
-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
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});let m=require("react"),H=require("react/jsx-runtime");function ce(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 ue(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 w,D=new Set;function V(){D.forEach(e=>e())}function k(e){w={...w,...e(w)},V()}w={isOnline:typeof navigator>"u"||navigator.onLine!==!1,swStatus:"idle",swError:void 0,resources:{},queue:[],setOnline:e=>k(()=>({isOnline:e})),setSwStatus:(e,t)=>k(()=>({swStatus:e,swError:t})),...ce(k),...ue(k)};function de(){return w}function le(e){return D.add(e),()=>{D.delete(e)}}var u={getState:de,subscribe:le,setState:e=>{const t=typeof e=="function"?e(w):e;w={...w,...t},V()}},v=null,N=[];function G(){return v}async function fe(e){if(typeof navigator>"u"||!("serviceWorker"in navigator)){u.getState().setSwStatus("unsupported");return}const t=u.getState();t.setSwStatus("registering");try{v=await navigator.serviceWorker.register(e,{scope:"/"}),await pe(v),t.setSwStatus("active"),navigator.serviceWorker.addEventListener("message",we),window.addEventListener("online",()=>t.setOnline(!0)),window.addEventListener("offline",()=>t.setOnline(!1)),Se()}catch(n){t.setSwStatus("error",String(n))}}function pe(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 R(e){const t=v?.active;t?t.postMessage(e):N.push(e)}var Y=null;function he(e){Y=e}function ye(){try{return typeof navigator<"u"&&"serviceWorker"in navigator&&v!==null&&"sync"in v}catch{return!1}}var T={};function ge(e){T=e}function we(e){const t=e.data;if(!t?.type)return;const n=u.getState(),{type:r,url:s}=t;if(r==="EIDOS_BACKGROUND_SYNC"){Y?.();return}if(r==="EIDOS_NOTIFICATION_CLICK"){T.onNotificationClick?.(t.data);return}if(r==="EIDOS_SUBSCRIPTION_EXPIRED"){T.onSubscriptionExpired?.(t.subscription);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 ve(e){R({type:"EIDOS_SIMULATE_OFFLINE",enabled:e}),u.getState().setOnline(!e)}function Se(){const e=v?.active;if(e){for(const t of N)e.postMessage(t);N=[]}}var I=new Map,C=new Map,J=null;function me(e){J=e}function S(e){return e.includes("*")||/:[^/]+/.test(e)}function be(e){return"^"+e.replace(/[.+?^${}()|[\]\\]/g,"\\$&").replace(/\*\*/g,".+").replace(/\*/g,"[^/]+").replace(/:[^/]+/g,"[^/]+")+"$"}function _(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 Ee(e,t){if(I.has(e))return I.get(e);const n=Oe(t),r=S(e)?be(e):void 0,s={url:e,config:t,strategy:n,status:"idle",cacheHits:0,cacheMisses:0};u.getState().registerResource(e,s),R({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 _(e,"fetch");const i=C.get(e);if(i)return i.then(c=>c.clone());const o=Re(e,t,n);return C.set(e,o),o.finally(()=>C.delete(e)).catch(()=>{}),o.then(c=>c.clone())},json:async()=>{if(S(e))throw _(e,"json");return(await a.fetch()).json()},query:()=>{if(S(e))throw _(e,"query");return{queryKey:["eidos",e],queryFn:()=>a.json()}},prefetch:async()=>{if(S(e))throw _(e,"prefetch");await a.fetch()},invalidate:async()=>{R({type:"EIDOS_CLEAR_CACHE",url:e});const i=await caches.open(n.cacheName).catch(()=>null);if(i){const o=await i.keys(),c=r?new RegExp(r):null,d=e.startsWith("http");await Promise.all(o.filter(l=>{const f=l.url,y=new URL(f).pathname;return c?c.test(d?f:y):d?f===e:f===e||y===e}).map(l=>i.delete(l)))}S(e)||u.getState().updateResource(e,{status:"stale",cachedAt:void 0,lastEvent:"cache-cleared",cacheHits:0,cacheMisses:0}),J?.(["eidos",e])},unregister:()=>{I.delete(e),R({type:"EIDOS_UNREGISTER_RESOURCE",url:e}),u.getState().unregisterResource(e)}};return I.set(e,a),a}async function Re(e,t,n){const r=u.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 o=s?await s.match(e).catch(()=>null):null,c=u.getState().resources[e],d=t.maxAge!==void 0&&c?.cachedAt!==void 0&&Date.now()-c.cachedAt>t.maxAge;if(o&&!d)return r.updateResource(e,{status:"fresh",lastEvent:"cache-hit",cacheHits:(c?.cacheHits??0)+1}),n.swStrategy==="stale-while-revalidate"&&fetch(e,{signal:AbortSignal.timeout(5e3)}).then(async f=>{f.ok&&s&&(await s.put(e,f.clone()),u.getState().updateResource(e,{cachedAt:Date.now(),lastEvent:"cache-updated"}))}).catch(()=>{}),o;const l=u.getState().resources[e];r.updateResource(e,{cacheMisses:(l?.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 o=u.getState().resources[e];return r.updateResource(e,{status:"fresh",lastEvent:"cache-hit",cacheHits:(o?.cacheHits??0)+1}),i}throw r.updateResource(e,{status:"error"}),a}}function Oe(e){const t=e.strategy;return e.offline?$(t??"stale-while-revalidate",e.cacheName):$(t??"network-first",e.cacheName)}var ke={"stale-while-revalidate":"StaleWhileRevalidate","cache-first":"CacheFirst","network-first":"NetworkFirst"},Ie={"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 })],
@@ -10,6 +10,6 @@ new CacheFirst({
 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;
+})`}};function $(e,t){const n=Ie[e];return{name:ke[e],swStrategy:e,cacheName:t??"eidos-resources-v1",reasoning:n.reasoning,behavior:n.behavior,equivalentCode:""}}async function _e(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 Ae="eidos",qe=1,p="action-queue",x=null;function b(){return x?Promise.resolve(x):new Promise((e,t)=>{const n=indexedDB.open(Ae,qe);n.onupgradeneeded=r=>{const s=r.target.result;if(!s.objectStoreNames.contains(p)){const a=s.createObjectStore(p,{keyPath:"id"});a.createIndex("status","status",{unique:!1}),a.createIndex("actionId","actionId",{unique:!1})}},n.onsuccess=()=>{x=n.result,e(n.result)},n.onerror=()=>t(n.error)})}async function Ce(e){const t=await b();return new Promise((n,r)=>{const s=t.transaction(p,"readwrite");s.objectStore(p).add(e),s.oncomplete=()=>n(),s.onerror=()=>r(s.error)})}async function X(){const e=await b();return new Promise((t,n)=>{const r=e.transaction(p,"readonly").objectStore(p).getAll();r.onsuccess=()=>t(r.result),r.onerror=()=>n(r.error)})}async function xe(e,t){const n=await b();return new Promise((r,s)=>{const a=n.transaction(p,"readwrite"),i=a.objectStore(p),o=i.get(e);o.onsuccess=()=>{o.result&&i.put({...o.result,...t})},a.oncomplete=()=>r(),a.onerror=()=>s(a.error)})}async function Qe(e){const t=await b();return new Promise((n,r)=>{const s=t.transaction(p,"readwrite");s.objectStore(p).delete(e),s.oncomplete=()=>n(),s.onerror=()=>r(s.error)})}async function Pe(){const e=await b();function t(s){return new Promise((a,i)=>{const o=e.transaction(p,"readonly").objectStore(p).index("status"),c=[],d=o.openCursor(IDBKeyRange.only(s));d.onsuccess=l=>{const f=l.target.result;f?(c.push(f.value),f.continue()):a(c)},d.onerror=()=>i(d.error)})}const[n,r]=await Promise.all([t("pending"),t("failed")]);return[...n,...r]}async function De(){const e=await b();return new Promise((t,n)=>{const r=e.transaction(p,"readwrite");r.objectStore(p).clear(),r.oncomplete=()=>t(),r.onerror=()=>n(r.error)})}var z={add:Ce,getAll:X,getPending:Pe,update:xe,remove:Qe,clear:De},Z=null;function Ne(e){Z=e}function K(){return Z}var L=new Map,ee=new Map,te=new Map,ne=new Map,re=new Map,O=new Map;function h(){return K()??z}function j(){return crypto.randomUUID()}function M(e,t,n){return e(...t,n)}function Te(e,t){const n=t.name||e.name||j(),r=t.namespace?`${t.namespace}::${n}`:n;L.set(r,e),re.set(r,t),t.onRollback&&ee.set(r,t.onRollback),t.onConflict&&te.set(r,t.onConflict),t.conflict&&ne.set(r,t.conflict);const s=async(...i)=>{const{isOnline:o}=u.getState(),c=t.reliability==="neverLose"||t.cancellable,d=c?j():"";let l;if(t.cancellable){const y=new AbortController;O.set(d,y),l=y.signal}const f={idempotencyKey:d,attempt:0,signal:l};t.onOptimistic?.(...i,f);try{if(t.reliability==="neverLose"){if(!o)return B(r,r,i,t,d);try{return await M(e,i,f)}catch(y){if(se(y))throw y;return B(r,r,i,t,d)}}try{return c?await M(e,i,f):await e(...i)}catch(y){throw t.onRollback?.(...i),y}}finally{t.cancellable&&O.delete(d)}},a=async i=>{const o=O.get(i);if(o)return o.abort(),!0;const c=(await h().getAll()).find(d=>d.idempotencyKey===i&&d.status==="pending");return c?(u.getState().removeQueueItem(c.id),await h().remove(c.id),!0):!1};return Object.defineProperty(s,"id",{value:r,writable:!1}),Object.defineProperty(s,"config",{value:t,writable:!1}),Object.defineProperty(s,"cancel",{value:a,writable:!1}),s}async function B(e,t,n,r,s){const a=j(),i={schemaVersion:2,id:a,actionId:e,actionName:t,idempotencyKey:s,args:n,queuedAt:Date.now(),retryCount:0,maxRetries:r.maxRetries??3,status:"pending",priority:r.priority??"normal"};await h().add(i),u.getState().addQueueItem(i);try{const o=G();o&&"sync"in o&&await o.sync.register("eidos-queue-replay")}catch{}return{queued:!0,id:a,message:`"${t}" queued — will execute when online`}}function se(e){return e instanceof DOMException&&e.name==="AbortError"}function je(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 Me(e){return Math.min(2e3*2**e,3e5)*(.8+Math.random()*.4)}function A(){return{attempted:0,succeeded:0,failed:0,retrying:0,skipped:0,conflicted:0,cancelled:0}}var Q=!1,Ue="eidos-queue-replay";async function q(){const e=u.getState();if(!e.isOnline)return A();if(typeof navigator<"u"&&navigator.locks)return navigator.locks.request(Ue,{ifAvailable:!0},async t=>t?F(e):A());if(Q)return A();Q=!0;try{return await F(e)}finally{Q=!1}}async function We(e,t){const n=L.get(e.actionId);if(!n)return"skipped";const r=re.get(e.actionId)?.cancellable;let s;if(r){const i=new AbortController;O.set(e.idempotencyKey,i),s=i.signal}const a={idempotencyKey:e.idempotencyKey,attempt:e.retryCount,signal:s};try{await M(n,e.args,a);const i=Date.now();return t.updateQueueItem(e.id,{status:"succeeded",completedAt:i}),await h().update(e.id,{status:"succeeded",completedAt:i}),setTimeout(()=>{t.removeQueueItem(e.id),h().remove(e.id)},3e3),"succeeded"}catch(i){if(se(i))return t.removeQueueItem(e.id),await h().remove(e.id),"cancelled";if(je(i)){const c=ne.get(e.actionId);let d;if(c)switch(c.strategy){case"serverWins":d="skip";break;case"clientWins":case"lastWriteWins":d="retry";break;case"merge":case"custom":{const l={error:i,args:e.args,attempt:e.retryCount,idempotencyKey:e.idempotencyKey};d=c.resolve?.(l)??"retry";break}}else{const l=te.get(e.actionId);l&&(d=l(i,e.args))}if(d==="skip")return t.removeQueueItem(e.id),await h().remove(e.id),"conflicted";d&&typeof d=="object"&&(e.args=d.resolved,t.updateQueueItem(e.id,{args:d.resolved}),await h().update(e.id,{args:d.resolved}))}const o=e.retryCount+1;if(o>=e.maxRetries)return t.updateQueueItem(e.id,{status:"failed",error:String(i),retryCount:o}),await h().update(e.id,{status:"failed",error:String(i),retryCount:o}),ee.get(e.actionId)?.(...e.args),"failed";{const c=Date.now()+Me(o);return t.updateQueueItem(e.id,{status:"pending",retryCount:o,nextRetryAt:c}),await h().update(e.id,{status:"pending",retryCount:o,nextRetryAt:c}),"retrying"}}finally{r&&O.delete(e.idempotencyKey)}}async function Ke(e,t,n){if(e.length===0)return;const r=e.filter(a=>L.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=>We(a,t)));for(const a of s){const i=a.status==="fulfilled"?a.value:"failed";i==="skipped"?n.skipped++:i==="conflicted"?n.conflicted++:i==="cancelled"?n.cancelled++:(n.attempted++,n[i]++)}}async function F(e){const t=await h().getPending(),n=Date.now(),r=t.filter(a=>a.retryCount<a.maxRetries&&(!a.nextRetryAt||a.nextRetryAt<=n)),s=A();for(const a of["high","normal","low"])await Ke(r.filter(i=>(i.priority??"normal")===a),e,s);return s}async function Le(){await h().clear(),u.getState().hydrateQueue([])}function ae(){let e=u.getState().isOnline;const t=u.subscribe(()=>{const{isOnline:s}=u.getState(),a=s&&!e;e=s,a&&setTimeout(q,600)}),n=u.getState(),r=n.queue.some(s=>s.status==="pending");return n.isOnline&&r&&setTimeout(q,1200),t}async function He(e){if(e.schemaVersion===2&&e.idempotencyKey)return e;const t={...e,schemaVersion:2,idempotencyKey:e.idempotencyKey??crypto.randomUUID()};return await(K()??z).update(t.id,{schemaVersion:t.schemaVersion,idempotencyKey:t.idempotencyKey}).catch(()=>{}),t}var U=!1,W=null;async function ie(e={}){if(typeof window>"u"||U)return;U=!0;const t=e.swPath??"/eidos-sw.js",n=e.autoReplay??!0;try{const r=await X();if(r.length>0){const s=await Promise.all(r.map(He));u.getState().hydrateQueue(s)}}catch{}try{await fe(t)}catch{}he(()=>{u.getState().isOnline&&setTimeout(q,200)}),n&&(W=ae())}function $e(){W?.(),W=null,U=!1}var P="@eidos:queue",Be=class{constructor(e){this.storage=e}async readAll(){try{const e=await this.storage.getItem(P);return e?JSON.parse(e):[]}catch{return[]}}async writeAll(e){await this.storage.setItem(P,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(P)}};function Fe({children:e,swPath:t,autoReplay:n}){return(0,m.useEffect)(()=>{ie({swPath:t,autoReplay:n})},[]),(0,H.jsx)(H.Fragment,{children:e})}function g(e){const t=e??(n=>n);return(0,m.useSyncExternalStore)(u.subscribe,()=>t(u.getState()))}function Ve(){return g()}function Ge(){return g(e=>e.resources)}function Ye(e){return g(t=>t.resources[e])}function Je(){return g(e=>e.queue)}function Xe(e){return g(t=>t.queue.find(n=>n.id===e))}function ze(){return{isOnline:g(e=>e.isOnline),swStatus:g(e=>e.swStatus),swError:g(e=>e.swError)}}function Ze(){const[e,t,n,r]=g(s=>{let a=0,i=0,o=0;for(const c of s.queue)c.status==="pending"?a++:c.status==="failed"?i++:c.status==="replaying"&&o++;return`${a},${i},${o},${s.queue.length}`}).split(",");return{pending:+e,failed:+t,replaying:+n,total:+r}}function et(e){const t=g(s=>s.queue.length),n=(0,m.useRef)(0),r=(0,m.useRef)(e);(0,m.useEffect)(()=>{r.current=e}),(0,m.useEffect)(()=>{n.current>0&&t===0&&r.current(),n.current=t},[t])}var tt="1.2.0";function nt(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 oe(e,t){return nt(e,t)}function E(e,t=Object.is){return{subscribe(n){let r=e(u.getState());return n(r),u.subscribe(()=>{const s=e(u.getState());t(r,s)||(r=s,n(s))})},getState(){return e(u.getState())}}}var rt=E(e=>e),st=E(e=>e.queue),at=E(e=>({isOnline:e.isOnline,swStatus:e.swStatus,swError:e.swError}),oe),it=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}},oe);function ot(e){return E(t=>t.resources[e])}function ct(e){return E(t=>t.queue.find(n=>n.id===e))}exports.AsyncStorageQueueStorage=Be;exports.EidosProvider=Fe;exports.VERSION=tt;exports._getQueueStorage=K;exports._resetEidos=$e;exports.action=Te;exports.clearQueue=Le;exports.eidosAction=ct;exports.eidosQueue=st;exports.eidosQueueStats=it;exports.eidosResource=ot;exports.eidosStatus=at;exports.eidosStore=rt;exports.getSwRegistration=G;exports.initEidos=ie;exports.isBgSyncSupported=ye;exports.registerPushCallbacks=ge;exports.replayQueue=q;exports.resource=Ee;exports.sendToWorker=R;exports.setOfflineSimulation=ve;exports.setQueryInvalidator=me;exports.setQueueStorage=Ne;exports.subscribeReplayOnReconnect=ae;exports.useEidos=Ve;exports.useEidosAction=Xe;exports.useEidosOnDrain=et;exports.useEidosQueue=Je;exports.useEidosQueueStats=Ze;exports.useEidosResource=Ye;exports.useEidosResources=Ge;exports.useEidosStatus=ze;exports.useEidosStore=u;exports.warmCache=_e;
 
 //# sourceMappingURL=eidos.cjs.map

package/dist/index.d.ts

@@ -13,6 +13,13 @@ export declare interface ActionConfig {
     maxRetries?: number;
     /** Human-readable name for the action (used in devtools). */
     name?: string;
+    /**
+     * Prefixes the registered action id (`namespace::name`). Use to avoid
+     * collisions when two actions share a name (e.g. across micro-frontends,
+     * or two `createOrder` actions in different modules) — without a
+     * namespace, the second registration silently overwrites the first.
+     */
+    namespace?: string;
     /**
      * Replay order when multiple queued actions are pending.
      * `'high'` items replay before `'normal'`, which replay before `'low'`.
@@ -21,9 +28,11 @@ export declare interface ActionConfig {
      */
     priority?: 'high' | 'normal' | 'low';
     /**
-     * Called immediately before the async function executes, with the same args.
-     * Use to apply an optimistic UI update (add item, mark as pending, etc.).
-     * Called on every invocation — online, offline, and during queue replay.
+     * Called immediately before the async function executes, with the same args
+     * plus a trailing `ActionContext`. Use to apply an optimistic UI update (add
+     * item, mark as pending, etc.) and to capture `idempotencyKey` for later
+     * `handle.cancel(idempotencyKey)` calls. Called on every invocation —
+     * online, offline, and during queue replay.
      */
     onOptimistic?: (...args: any[]) => void;
     /**
@@ -46,7 +55,25 @@ export declare interface ActionConfig {
      * The `error` argument is whatever `fn` threw — typically a `Response` object
      * or a custom error with a `.status` property.
      */
+    /**
+     * @deprecated Use `conflict` instead. If both are set, `conflict` wins.
+     * Return `'retry'` to keep the item in the queue and retry per normal
+     * backoff, or `'skip'` to silently remove the item.
+     */
     onConflict?: (error: unknown, args: any[]) => 'retry' | 'skip';
+    /**
+     * Declarative conflict-resolution strategy used during queue replay when
+     * the server responds with a 4xx status (conflict, gone, unprocessable,
+     * etc.). Replaces `onConflict` for new code — see `ConflictConfig`.
+     */
+    conflict?: ConflictConfig;
+    /**
+     * When `true`, each invocation gets an `AbortController` whose `signal` is
+     * passed via `ActionContext.signal`. Forward it to `fetch`/etc. so
+     * `handle.cancel(idempotencyKey)` can abort an in-flight call, or remove a
+     * not-yet-replayed queued item.
+     */
+    cancellable?: boolean;
 }
 
 declare type ActionFn<TArgs extends any[], TReturn> = (...args: TArgs) => Promise<TReturn>;
@@ -55,13 +82,28 @@ export declare interface ActionHandle<TArgs extends any[], TReturn> {
     (...args: TArgs): Promise<TReturn | QueuedResult>;
     readonly id: string;
     readonly config: ActionConfig;
+    /**
+     * Cancel an invocation by its `idempotencyKey` (from `ActionContext` /
+     * `onOptimistic`). Aborts the in-flight call if `cancellable: true` and
+     * still running, otherwise removes a not-yet-replayed queued item.
+     * Returns `true` if something was cancelled/removed.
+     */
+    cancel: (idempotencyKey: string) => Promise<boolean>;
 }
 
 export declare interface ActionQueueItem {
+    /** Shape version this item was persisted with. Items from before v2 are migrated on load. */
+    schemaVersion: number;
     id: string;
     /** ID of the registered action (maps to the function in the registry). */
     actionId: string;
     actionName: string;
+    /**
+     * Stable per-invocation key, generated once and reused across every retry/replay
+     * of this item. Pass to your server as an idempotency key so retries that reach
+     * the server after a dropped response don't double-execute.
+     */
+    idempotencyKey: string;
     args: unknown[];
     queuedAt: number;
     retryCount: number;
@@ -105,6 +147,46 @@ export declare type CacheStrategy = 'cache-first' | 'stale-while-revalidate' | '
 /** Remove all items from the action queue (storage + in-memory store). */
 export declare function clearQueue(): Promise<void>;
 
+declare interface ConflictConfig {
+    /**
+     * - `'serverWins'`: drop the queued item, keeping the server's state.
+     * - `'clientWins'`: keep retrying — the client's write should eventually
+     *   be accepted (e.g. once the server-side conflict is cleared).
+     * - `'lastWriteWins'`: same as `'clientWins'` for now — requires a
+     *   server-supplied timestamp contract to compare against `queuedAt`
+     *   (see Phase 3 of the roadmap). Treated as `'clientWins'` until then.
+     * - `'merge'` / `'custom'`: call `resolve` to decide.
+     */
+    strategy: 'serverWins' | 'clientWins' | 'lastWriteWins' | 'merge' | 'custom';
+    /** Required for `'merge'` and `'custom'`. */
+    resolve?: (ctx: ConflictContext) => ConflictResolution;
+}
+
+/**
+ * Passed to `ConflictConfig.resolve` (for `'merge'`/`'custom'` strategies)
+ * when a queued action's replay receives a 4xx response.
+ */
+declare interface ConflictContext {
+    /** Whatever `fn` threw — typically a `Response` or an error with `.status`. */
+    error: unknown;
+    /** The original arguments the action was queued with. */
+    args: any[];
+    /** Number of replay attempts so far (0 on first replay). */
+    attempt: number;
+    idempotencyKey: string;
+}
+
+/**
+ * Outcome of `ConflictConfig.resolve`:
+ * - `'retry'`: keep the item queued, retry per normal backoff.
+ * - `'skip'`: silently remove the item (no `onRollback`).
+ * - `{ resolved: args }`: replace the queued args and retry immediately
+ *   on the next replay pass.
+ */
+declare type ConflictResolution = 'retry' | 'skip' | {
+    resolved: any[];
+};
+
 /**
  * Live state for a single queue item by ID. Returns `undefined` once the item
  * is removed from the queue (after a successful replay or `clearQueue()`).
@@ -209,12 +291,19 @@ export declare function _getQueueStorage(): QueueStorage | null;
 
 declare function _getState(): EidosStore;
 
+export declare function getSwRegistration(): ServiceWorkerRegistration | null;
+
 export declare function initEidos(config?: EidosConfig): Promise<void>;
 
 export declare function isBgSyncSupported(): boolean;
 
 declare type Listener = () => void;
 
+declare interface PushHandlers {
+    onNotificationClick?: (data: unknown) => void;
+    onSubscriptionExpired?: (sub: PushSubscriptionJSON) => void;
+}
+
 declare type QueryInvalidator = (queryKey: [string, string]) => void;
 
 declare interface QueueActions {
@@ -243,6 +332,8 @@ export declare interface QueueStorage {
     clear(): Promise<void>;
 }
 
+export declare function registerPushCallbacks(handlers: PushHandlers): void;
+
 export declare function replayQueue(): Promise<ReplayResult>;
 
 /** Summary returned by replayQueue(). */
@@ -259,6 +350,8 @@ export declare interface ReplayResult {
     skipped: number;
     /** Items that received a 4xx response and were dropped via `onConflict: () => 'skip'`. */
     conflicted: number;
+    /** Items removed via `handle.cancel(idempotencyKey)` before/during replay. */
+    cancelled: number;
 }
 
 export declare function _resetEidos(): void;
@@ -311,6 +404,8 @@ export declare interface ResourceHandle<T = unknown> {
     unregister: () => void;
 }
 
+export declare function sendToWorker(message: Record<string, unknown>): void;
+
 export declare function setOfflineSimulation(enabled: boolean): void;
 
 /* Excluded from this release type: setQueryInvalidator */
@@ -394,7 +489,7 @@ export declare const useEidosStore: {
     setState: (partial: Partial<EidosStore> | ((s: EidosStore) => Partial<EidosStore>)) => void;
 };
 
-export declare const VERSION = "1.1.0";
+export declare const VERSION = "1.2.0";
 
 /**
  * Bulk-prefetch an array of resource handles concurrently, warming the cache

package/dist/index.js

@@ -1,45 +1,48 @@
 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";
+import { getSwRegistration as s, isBgSyncSupported as i, registerPushCallbacks as t, sendToWorker as u, setOfflineSimulation as m } from "./sw-bridge.js";
+import { resource as a, setQueryInvalidator as p, warmCache as n } from "./resource.js";
+import { _getQueueStorage as S, setQueueStorage as f } from "./queue-storage.js";
+import { action as Q, clearQueue as g, replayQueue as l } from "./action.js";
+import { subscribeReplayOnReconnect as y } from "./replay.js";
+import { _resetEidos as b, initEidos as A } from "./runtime.js";
+import { AsyncStorageQueueStorage as k } from "./async-storage-adapter.js";
+import { EidosProvider as w } from "./react/Provider.js";
+import { useEidos as I, useEidosAction as P, useEidosOnDrain as _, useEidosQueue as x, useEidosQueueStats as B, useEidosResource as D, useEidosResources as N, useEidosStatus as T } from "./react/hooks.js";
+import { VERSION as W } from "./version.js";
+import { eidosAction as q, eidosQueue as z, eidosQueueStats as F, eidosResource as G, eidosStatus as H, eidosStore as J } from "./stores.js";
 export {
-  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,
-  g as subscribeReplayOnReconnect,
-  _ as useEidos,
-  h as useEidosAction,
-  w as useEidosOnDrain,
+  k as AsyncStorageQueueStorage,
+  w as EidosProvider,
+  W as VERSION,
+  S as _getQueueStorage,
+  b as _resetEidos,
+  Q as action,
+  g as clearQueue,
+  q as eidosAction,
+  z as eidosQueue,
+  F as eidosQueueStats,
+  G as eidosResource,
+  H as eidosStatus,
+  J as eidosStore,
+  s as getSwRegistration,
+  A as initEidos,
+  i as isBgSyncSupported,
+  t as registerPushCallbacks,
+  l as replayQueue,
+  a as resource,
+  u as sendToWorker,
+  m as setOfflineSimulation,
+  p as setQueryInvalidator,
+  f as setQueueStorage,
+  y as subscribeReplayOnReconnect,
+  I as useEidos,
+  P as useEidosAction,
+  _ as useEidosOnDrain,
   x as useEidosQueue,
   B as useEidosQueueStats,
-  C as useEidosResource,
-  D as useEidosResources,
-  N as useEidosStatus,
+  D as useEidosResource,
+  N as useEidosResources,
+  T as useEidosStatus,
   o as useEidosStore,
-  d as warmCache
+  n as warmCache
 };

package/dist/push.cjs

@@ -0,0 +1,120 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _sweidos_eidos = require("@sweidos/eidos");
+//#region src/push.ts
+/**
+* @sweidos/eidos/push
+*
+* Web Push integration. Framework-agnostic: register click/expiry handlers
+* once at app init (any tab), and trigger subscription from a user gesture.
+*
+* @example
+* ```ts
+* import { registerPushHandlers, subscribeToPush } from '@sweidos/eidos/push'
+*
+* // App init — every tab, no permission prompt
+* registerPushHandlers({
+*   onNotificationClick: (data) => router.push(data.url),
+*   onSubscriptionExpired: (sub) => fetch('/api/push-subscribe', { method: 'POST', body: JSON.stringify(sub) }),
+* })
+*
+* // User gesture (button click)
+* const result = await subscribeToPush({
+*   vapidPublicKey: import.meta.env.VITE_EIDOS_VAPID_PUBLIC_KEY,
+*   onSubscribe: (sub) => fetch('/api/push-subscribe', { method: 'POST', body: JSON.stringify(sub) }),
+* })
+* ```
+*/
+/** Why push is unavailable on this device, or null if it's supported. */
+function getPushUnsupportedReason() {
+	if (typeof window === "undefined") return "no-push-api";
+	if (/iPhone|iPad|iPod/.test(navigator.userAgent) && !navigator.standalone) return "ios-not-installed";
+	if (!("serviceWorker" in navigator) || !("PushManager" in window) || !("Notification" in window)) return "no-push-api";
+	return null;
+}
+function isPushSupported() {
+	return getPushUnsupportedReason() === null;
+}
+function getPushPermissionState() {
+	if (!isPushSupported()) return "unsupported";
+	return Notification.permission;
+}
+function registerPushHandlers(handlers) {
+	(0, _sweidos_eidos.registerPushCallbacks)(handlers);
+}
+async function subscribeToPush(config) {
+	if (!isPushSupported()) return { status: "unsupported" };
+	let permission;
+	try {
+		permission = await Notification.requestPermission();
+	} catch (error) {
+		return {
+			status: "error",
+			error
+		};
+	}
+	if (permission !== "granted") return { status: "denied" };
+	const registration = (0, _sweidos_eidos.getSwRegistration)();
+	if (!registration) return { status: "sw-not-ready" };
+	try {
+		const applicationServerKey = urlBase64ToUint8Array(config.vapidPublicKey);
+		let subscription = await registration.pushManager.getSubscription();
+		if (subscription && !subscriptionKeyMatches(subscription, config.vapidPublicKey)) {
+			await subscription.unsubscribe();
+			subscription = null;
+		}
+		if (!subscription) subscription = await registration.pushManager.subscribe({
+			userVisibleOnly: true,
+			applicationServerKey
+		});
+		(0, _sweidos_eidos.sendToWorker)({
+			type: "EIDOS_CACHE_VAPID_KEY",
+			key: config.vapidPublicKey
+		});
+		const json = subscription.toJSON();
+		config.onSubscribe?.(json);
+		return {
+			status: "subscribed",
+			subscription: json
+		};
+	} catch (error) {
+		return {
+			status: "error",
+			error
+		};
+	}
+}
+async function unsubscribeFromPush() {
+	const registration = (0, _sweidos_eidos.getSwRegistration)();
+	if (!registration) return;
+	await (await registration.pushManager.getSubscription())?.unsubscribe();
+}
+async function getCurrentPushSubscription() {
+	const registration = (0, _sweidos_eidos.getSwRegistration)();
+	if (!registration) return null;
+	const subscription = await registration.pushManager.getSubscription();
+	return subscription ? subscription.toJSON() : null;
+}
+function urlBase64ToUint8Array(base64Url) {
+	const base64 = (base64Url + "=".repeat((4 - base64Url.length % 4) % 4)).replace(/-/g, "+").replace(/_/g, "/");
+	const raw = atob(base64);
+	return Uint8Array.from(raw, (c) => c.charCodeAt(0));
+}
+function uint8ArrayToUrlBase64(bytes) {
+	let binary = "";
+	for (const byte of bytes) binary += String.fromCharCode(byte);
+	return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+/** Compares an existing subscription's key against the configured VAPID public key. */
+function subscriptionKeyMatches(subscription, vapidPublicKey) {
+	const key = subscription.options.applicationServerKey;
+	if (!key) return false;
+	return uint8ArrayToUrlBase64(new Uint8Array(key)) === uint8ArrayToUrlBase64(urlBase64ToUint8Array(vapidPublicKey));
+}
+//#endregion
+exports.getCurrentPushSubscription = getCurrentPushSubscription;
+exports.getPushPermissionState = getPushPermissionState;
+exports.getPushUnsupportedReason = getPushUnsupportedReason;
+exports.isPushSupported = isPushSupported;
+exports.registerPushHandlers = registerPushHandlers;
+exports.subscribeToPush = subscribeToPush;
+exports.unsubscribeFromPush = unsubscribeFromPush;

package/dist/push.d.ts

@@ -0,0 +1,28 @@
+export interface PushHandlers {
+    /** Fired when the user clicks a notification while a tab is open. */
+    onNotificationClick?: (data: unknown) => void;
+    /** Fired when the browser silently rotates the push subscription. Re-send to your backend. */
+    onSubscriptionExpired?: (sub: PushSubscriptionJSON) => void;
+}
+export interface PushConfig {
+    /** Base64url-encoded VAPID public key. Generate with `npx @sweidos/eidos generate-vapid-keys`. */
+    vapidPublicKey: string;
+    /** Called with the new subscription right after a successful subscribe. Send this to your backend. */
+    onSubscribe?: (sub: PushSubscriptionJSON) => void;
+}
+export type PushResult = {
+    status: 'subscribed';
+    subscription: PushSubscriptionJSON;
+} | {
+    status: 'denied' | 'unsupported' | 'sw-not-ready' | 'error';
+    error?: unknown;
+};
+export type PushUnsupportedReason = 'no-push-api' | 'ios-not-installed' | null;
+/** Why push is unavailable on this device, or null if it's supported. */
+export declare function getPushUnsupportedReason(): PushUnsupportedReason;
+export declare function isPushSupported(): boolean;
+export declare function getPushPermissionState(): NotificationPermission | 'unsupported';
+export declare function registerPushHandlers(handlers: PushHandlers): void;
+export declare function subscribeToPush(config: PushConfig): Promise<PushResult>;
+export declare function unsubscribeFromPush(): Promise<void>;
+export declare function getCurrentPushSubscription(): Promise<PushSubscriptionJSON | null>;

package/dist/push.js

@@ -0,0 +1,113 @@
+import { getSwRegistration, registerPushCallbacks, sendToWorker } from "@sweidos/eidos";
+//#region src/push.ts
+/**
+* @sweidos/eidos/push
+*
+* Web Push integration. Framework-agnostic: register click/expiry handlers
+* once at app init (any tab), and trigger subscription from a user gesture.
+*
+* @example
+* ```ts
+* import { registerPushHandlers, subscribeToPush } from '@sweidos/eidos/push'
+*
+* // App init — every tab, no permission prompt
+* registerPushHandlers({
+*   onNotificationClick: (data) => router.push(data.url),
+*   onSubscriptionExpired: (sub) => fetch('/api/push-subscribe', { method: 'POST', body: JSON.stringify(sub) }),
+* })
+*
+* // User gesture (button click)
+* const result = await subscribeToPush({
+*   vapidPublicKey: import.meta.env.VITE_EIDOS_VAPID_PUBLIC_KEY,
+*   onSubscribe: (sub) => fetch('/api/push-subscribe', { method: 'POST', body: JSON.stringify(sub) }),
+* })
+* ```
+*/
+/** Why push is unavailable on this device, or null if it's supported. */
+function getPushUnsupportedReason() {
+	if (typeof window === "undefined") return "no-push-api";
+	if (/iPhone|iPad|iPod/.test(navigator.userAgent) && !navigator.standalone) return "ios-not-installed";
+	if (!("serviceWorker" in navigator) || !("PushManager" in window) || !("Notification" in window)) return "no-push-api";
+	return null;
+}
+function isPushSupported() {
+	return getPushUnsupportedReason() === null;
+}
+function getPushPermissionState() {
+	if (!isPushSupported()) return "unsupported";
+	return Notification.permission;
+}
+function registerPushHandlers(handlers) {
+	registerPushCallbacks(handlers);
+}
+async function subscribeToPush(config) {
+	if (!isPushSupported()) return { status: "unsupported" };
+	let permission;
+	try {
+		permission = await Notification.requestPermission();
+	} catch (error) {
+		return {
+			status: "error",
+			error
+		};
+	}
+	if (permission !== "granted") return { status: "denied" };
+	const registration = getSwRegistration();
+	if (!registration) return { status: "sw-not-ready" };
+	try {
+		const applicationServerKey = urlBase64ToUint8Array(config.vapidPublicKey);
+		let subscription = await registration.pushManager.getSubscription();
+		if (subscription && !subscriptionKeyMatches(subscription, config.vapidPublicKey)) {
+			await subscription.unsubscribe();
+			subscription = null;
+		}
+		if (!subscription) subscription = await registration.pushManager.subscribe({
+			userVisibleOnly: true,
+			applicationServerKey
+		});
+		sendToWorker({
+			type: "EIDOS_CACHE_VAPID_KEY",
+			key: config.vapidPublicKey
+		});
+		const json = subscription.toJSON();
+		config.onSubscribe?.(json);
+		return {
+			status: "subscribed",
+			subscription: json
+		};
+	} catch (error) {
+		return {
+			status: "error",
+			error
+		};
+	}
+}
+async function unsubscribeFromPush() {
+	const registration = getSwRegistration();
+	if (!registration) return;
+	await (await registration.pushManager.getSubscription())?.unsubscribe();
+}
+async function getCurrentPushSubscription() {
+	const registration = getSwRegistration();
+	if (!registration) return null;
+	const subscription = await registration.pushManager.getSubscription();
+	return subscription ? subscription.toJSON() : null;
+}
+function urlBase64ToUint8Array(base64Url) {
+	const base64 = (base64Url + "=".repeat((4 - base64Url.length % 4) % 4)).replace(/-/g, "+").replace(/_/g, "/");
+	const raw = atob(base64);
+	return Uint8Array.from(raw, (c) => c.charCodeAt(0));
+}
+function uint8ArrayToUrlBase64(bytes) {
+	let binary = "";
+	for (const byte of bytes) binary += String.fromCharCode(byte);
+	return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+/** Compares an existing subscription's key against the configured VAPID public key. */
+function subscriptionKeyMatches(subscription, vapidPublicKey) {
+	const key = subscription.options.applicationServerKey;
+	if (!key) return false;
+	return uint8ArrayToUrlBase64(new Uint8Array(key)) === uint8ArrayToUrlBase64(urlBase64ToUint8Array(vapidPublicKey));
+}
+//#endregion
+export { getCurrentPushSubscription, getPushPermissionState, getPushUnsupportedReason, isPushSupported, registerPushHandlers, subscribeToPush, unsubscribeFromPush };