@lite-fsm/persist 1.0.2 → 1.0.4

package/README.md

@@ -22,7 +22,7 @@ npm install @lite-fsm/react @lite-fsm/persist
 import { createJsonStorage, persistManager } from "@lite-fsm/persist";
 import type { PersistController, PersistStorage, PersistStatus } from "@lite-fsm/persist";
 
-import { useIsPersistRestoring, usePersistStatus } from "@lite-fsm/persist/react";
+import { useIsPersistRestoring, usePersistStatuses } from "@lite-fsm/persist/react";
 ```
 
 ## Quick Example
@@ -56,7 +56,7 @@ const manager = MachineManager<typeof machines>(machines, { schemaVersion: 1 });
 const persist = persistManager(manager, {
   storage: createJsonStorage<typeof machines>({
     key: "app:state:v1",
-    storage: window.localStorage,
+    storage: () => window.localStorage,
   }),
   storageVersion: 1,
   machines: ["counter"],
@@ -72,6 +72,8 @@ await persist.flush();
 stop();
 ```
 
+`createJsonStorage` expects a lazy `storage` factory. The factory is not called when the adapter is created; it is called again for every `get`, `set`, and `remove`. `persistManager` does not check whether it runs in a browser or on a server, so Next.js stores can reference `window.localStorage` inside the factory without a manual `typeof window` guard. Add `subscribe` manually by extending the returned `PersistStorage` when you need tab or external storage notifications.
+
 ## React Integration
 
 `FSMContextProvider` can start and stop a persist controller for you:
@@ -81,7 +83,7 @@ import { FSMContextProvider } from "@lite-fsm/react";
 
 export function App() {
   return (
-    <FSMContextProvider machineManager={manager} persist={persist}>
+    <FSMContextProvider machineManager={manager} persist={[persist]}>
       <Page />
     </FSMContextProvider>
   );
@@ -91,16 +93,19 @@ export function App() {
 Read restore status from React with `@lite-fsm/persist/react`:
 
 ```tsx
-import { usePersistStatus } from "@lite-fsm/persist/react";
+import { usePersistStatuses } from "@lite-fsm/persist/react";
 
 function PersistStatusView() {
-  const status = usePersistStatus();
-  return <span>{status.phase}</span>;
+  const [status] = usePersistStatuses();
+  return <span>{status?.phase ?? "none"}</span>;
 }
 ```
 
-You can still pass a controller explicitly when the component is outside
-`FSMContextProvider` or when several persist controllers are active.
+`usePersistStatuses()` returns an array with the same length and order as the
+provider `persist` array. Entries without `getStatus()` and `subscribeStatus()`
+are returned as `null`. `useIsPersistRestoring()` returns `true` when any
+non-null status has `phase === "restoring"`; blocking UI until the first restore
+settles should also treat the `"idle"` phase as loading.
 
 ## Documentation
 

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";var x=Object.defineProperty;var G=Object.getOwnPropertyDescriptor;var q=Object.getOwnPropertyNames;var z=Object.prototype.hasOwnProperty;var Q=(r,t)=>{for(var i in t)x(r,i,{get:t[i],enumerable:!0})},X=(r,t,i,d)=>{if(t&&typeof t=="object"||typeof t=="function")for(let a of q(t))!z.call(r,a)&&a!==i&&x(r,a,{get:()=>t[a],enumerable:!(d=G(t,a))||d.enumerable});return r};var Z=r=>X(x({},"__esModule",{value:!0}),r);var ie={};Q(ie,{createJsonStorage:()=>oe,persistManager:()=>ae});module.exports=Z(ie);var O=Symbol("lite-fsm.taskCancelled"),$=()=>Object.assign(new Error("[lite-fsm] task was cancelled."),{[O]:!0}),L=r=>r instanceof Error&&O in r,B=()=>{let r=0,t=new Set;return{latest:()=>{let d=0,a=-1,u=-1;t.add(()=>{a=-1,u=-1});let p=()=>a===r&&u===d,k=(l,o)=>{a=l,u=o},P=(l,o)=>{a!==l||u!==o||(a=-1,u=-1)};return{run:async l=>{let o=r,S=++d,y=()=>o===r&&S===d,h=()=>{if(!y())throw $()},w=async g=>{h();let M=await g();return h(),M};k(o,S);try{return await l({isCurrent:y,checkpoint:h,step:w})}finally{P(o,S)}},isActive:p}},cancelAll:()=>{r+=1;for(let d of t)d()}}};var ee="@@lite-fsm/HYDRATE",N={phase:"idle"},te={phase:"restoring"},_=r=>r!==null&&typeof r=="object"&&!Array.isArray(r),re=r=>_(r)&&typeof r.timestamp=="number"&&_(r.snapshot),se=()=>new Error("[@lite-fsm/persist] restore: persisted record must be an object with numeric timestamp and object snapshot."),ne=(r,t)=>r.phase!==t.phase?!1:r.phase==="ready"&&t.phase==="ready"?r.restored===t.restored:r.phase==="error"&&t.phase==="error"?r.error===t.error:!0,ae=(r,t)=>{let i=t.throttleMs??0,d=t.strategy??"merge",a=N,u=[],p=0,k,P,f,l=!1,o,S=!1,y=B(),h=y.latest(),w=y.latest(),g=(e,s)=>{try{t.onError?.(e,s)}catch{}},M=e=>{try{t.onRestoreSettled?.(e)}catch{}},m=e=>{if(!ne(a,e)){a=e;for(let s of u)s()}},E=(e,s,n,c)=>{if(L(e))return;let T=s.isCurrent();if(!(!T&&n==="background")){if(T){let b={phase:"error",error:e};m(b),c==="restore"&&M(b)}if(g(e,c),n==="direct")throw e}},R=()=>{l=!1,f&&(clearTimeout(f),f=void 0)},V=()=>{y.cancelAll(),S=!1,o=void 0,R()},j=e=>w.run(async s=>{try{s.checkpoint();let n={timestamp:Date.now(),storageVersion:t.storageVersion,snapshot:r.dehydrate({machines:t.machines})};s.checkpoint(),await s.step(()=>t.storage.set(n))}catch(n){E(n,s,e,"save")}}),v=e=>{R();let s=j(e).finally(()=>{o===s&&(o=void 0)});return o=s,s},J=()=>{if(l=!0,i===0){v("background");return}f||(f=setTimeout(()=>{v("background")},i))},H=async(e,s,n)=>{let c=e||S;S=!1,!(!c||!s.isCurrent())&&await v(n)},Y=(e,s)=>{let n={phase:"ready",restored:e};return s.isCurrent()&&(m(n),M(n)),n},K=async e=>{if(e===void 0)return{kind:"skip"};if(!re(e))return{kind:"remove",error:se()};if(t.maxAge!==void 0&&Date.now()-e.timestamp>t.maxAge)return{kind:"remove"};if(e.storageVersion===t.storageVersion)return{kind:"hydrate",snapshot:e.snapshot,writeBack:!1};if(!t.migrate)return{kind:"remove"};let s=await t.migrate(e);return s?{kind:"hydrate",snapshot:s,writeBack:!0}:{kind:"remove"}},U=async e=>e.kind==="skip"?!1:e.kind==="remove"?(e.error!==void 0&&g(e.error,"restore"),await t.storage.remove(),!1):(r.hydrate(e.snapshot,{strategy:d}),!0),I=async e=>{let s=h.isActive();return h.run(async n=>{s||(S=!1),m(te);let c=!1,T=!1;try{let A=await n.step(()=>t.storage.get()),C=await n.step(()=>K(A));c=await n.step(()=>U(C)),T=C.kind==="hydrate"&&C.writeBack}catch(A){return E(A,n,e,"restore"),a}let b=Y(c,n);return await H(T,n,e),b})},D=()=>{I("background")},W=(e,s,n)=>{try{return t.shouldSave?.({prevState:e,currentState:s,action:n})??!0}catch(c){return m({phase:"error",error:c}),g(c,"save"),!1}},F=(e,s,n)=>{if(n.type!==ee&&W(e,s,n)){if(h.isActive()){S=!0;return}J()}};return{start:()=>{p+=1,p===1&&(k=r.onTransition((s,n,c)=>{F(s,n,c)}),P=t.storage.subscribe?.(D),D());let e=!1;return()=>{e||(e=!0,p-=1,!(p>0)&&(V(),k?.(),P?.(),k=void 0,P=void 0,m(N)))}},restore:()=>I("direct"),save:async()=>{R(),await v("direct")},flush:async()=>{if(l){await v("direct");return}await o},clear:async()=>{let e=o;V();try{await e?.catch(()=>{}),await t.storage.remove(),m({phase:"ready",restored:!1})}catch(s){throw m({phase:"error",error:s}),g(s,"clear"),s}},getStatus:()=>a,subscribeStatus:e=>(u.push(e),()=>{u=u.filter(s=>s!==e)})}},oe=({key:r,storage:t})=>({get:()=>{let i=t.getItem(r);return i==null?void 0:JSON.parse(i)},set:i=>{t.setItem(r,JSON.stringify(i))},remove:()=>{t.removeItem(r)}});0&&(module.exports={createJsonStorage,persistManager});
+"use strict";var x=Object.defineProperty;var G=Object.getOwnPropertyDescriptor;var q=Object.getOwnPropertyNames;var z=Object.prototype.hasOwnProperty;var Q=(r,t)=>{for(var i in t)x(r,i,{get:t[i],enumerable:!0})},X=(r,t,i,d)=>{if(t&&typeof t=="object"||typeof t=="function")for(let a of q(t))!z.call(r,a)&&a!==i&&x(r,a,{get:()=>t[a],enumerable:!(d=G(t,a))||d.enumerable});return r};var Z=r=>X(x({},"__esModule",{value:!0}),r);var ie={};Q(ie,{createJsonStorage:()=>oe,persistManager:()=>ae});module.exports=Z(ie);var O=Symbol("lite-fsm.taskCancelled"),$=()=>Object.assign(new Error("[lite-fsm] task was cancelled."),{[O]:!0}),L=r=>r instanceof Error&&O in r,J=()=>{let r=0,t=new Set;return{latest:()=>{let d=0,a=-1,u=-1;t.add(()=>{a=-1,u=-1});let p=()=>a===r&&u===d,k=(l,o)=>{a=l,u=o},P=(l,o)=>{a!==l||u!==o||(a=-1,u=-1)};return{run:async l=>{let o=r,S=++d,y=()=>o===r&&S===d,h=()=>{if(!y())throw $()},w=async g=>{h();let M=await g();return h(),M};k(o,S);try{return await l({isCurrent:y,checkpoint:h,step:w})}finally{P(o,S)}},isActive:p}},cancelAll:()=>{r+=1;for(let d of t)d()}}};var ee="@@lite-fsm/HYDRATE",B={phase:"idle"},te={phase:"restoring"},N=r=>r!==null&&typeof r=="object"&&!Array.isArray(r),re=r=>N(r)&&typeof r.timestamp=="number"&&N(r.snapshot),se=()=>new Error("[@lite-fsm/persist] restore: persisted record must be an object with numeric timestamp and object snapshot."),ne=(r,t)=>r.phase!==t.phase?!1:r.phase==="ready"&&t.phase==="ready"?r.restored===t.restored:r.phase==="error"&&t.phase==="error"?r.error===t.error:!0,ae=(r,t)=>{let i=t.throttleMs??0,d=t.strategy??"merge",a=B,u=[],p=0,k,P,f,l=!1,o,S=!1,y=J(),h=y.latest(),w=y.latest(),g=(e,s)=>{try{t.onError?.(e,s)}catch{}},M=e=>{try{t.onRestoreSettled?.(e)}catch{}},m=e=>{if(!ne(a,e)){a=e;for(let s of u)s()}},E=(e,s,n,c)=>{if(L(e))return;let T=s.isCurrent();if(!(!T&&n==="background")){if(T){let b={phase:"error",error:e};m(b),c==="restore"&&M(b)}if(g(e,c),n==="direct")throw e}},R=()=>{l=!1,f&&(clearTimeout(f),f=void 0)},V=()=>{y.cancelAll(),S=!1,o=void 0,R()},_=e=>w.run(async s=>{try{s.checkpoint();let n={timestamp:Date.now(),storageVersion:t.storageVersion,snapshot:r.dehydrate({machines:t.machines})};s.checkpoint(),await s.step(()=>t.storage.set(n))}catch(n){E(n,s,e,"save")}}),v=e=>{R();let s=_(e).finally(()=>{o===s&&(o=void 0)});return o=s,s},j=()=>{if(l=!0,i===0){v("background");return}f||(f=setTimeout(()=>{v("background")},i))},H=async(e,s,n)=>{let c=e||S;S=!1,!(!c||!s.isCurrent())&&await v(n)},Y=(e,s)=>{let n={phase:"ready",restored:e};return s.isCurrent()&&(m(n),M(n)),n},K=async e=>{if(e===void 0)return{kind:"skip"};if(!re(e))return{kind:"remove",error:se()};if(t.maxAge!==void 0&&Date.now()-e.timestamp>t.maxAge)return{kind:"remove"};if(e.storageVersion===t.storageVersion)return{kind:"hydrate",snapshot:e.snapshot,writeBack:!1};if(!t.migrate)return{kind:"remove"};let s=await t.migrate(e);return s?{kind:"hydrate",snapshot:s,writeBack:!0}:{kind:"remove"}},U=async e=>e.kind==="skip"?!1:e.kind==="remove"?(e.error!==void 0&&g(e.error,"restore"),await t.storage.remove(),!1):(r.hydrate(e.snapshot,{strategy:d}),!0),I=async e=>{let s=h.isActive();return h.run(async n=>{s||(S=!1),m(te);let c=!1,T=!1;try{let A=await n.step(()=>t.storage.get()),C=await n.step(()=>K(A));c=await n.step(()=>U(C)),T=C.kind==="hydrate"&&C.writeBack}catch(A){return E(A,n,e,"restore"),a}let b=Y(c,n);return await H(T,n,e),b})},D=()=>{I("background")},W=(e,s,n)=>{try{return t.shouldSave?.({prevState:e,currentState:s,action:n})??!0}catch(c){return m({phase:"error",error:c}),g(c,"save"),!1}},F=(e,s,n)=>{if(n.type!==ee&&W(e,s,n)){if(h.isActive()){S=!0;return}j()}};return{start:()=>{p+=1,p===1&&(k=r.onTransition((s,n,c)=>{F(s,n,c)}),P=t.storage.subscribe?.(D),D());let e=!1;return()=>{e||(e=!0,p-=1,!(p>0)&&(V(),k?.(),P?.(),k=void 0,P=void 0,m(B)))}},restore:()=>I("direct"),save:async()=>{R(),await v("direct")},flush:async()=>{if(l){await v("direct");return}await o},clear:async()=>{let e=o;V();try{await e?.catch(()=>{}),await t.storage.remove(),m({phase:"ready",restored:!1})}catch(s){throw m({phase:"error",error:s}),g(s,"clear"),s}},getStatus:()=>a,subscribeStatus:e=>(u.push(e),()=>{u=u.filter(s=>s!==e)})}},oe=({key:r,storage:t})=>({get:()=>{let i=t().getItem(r);return i==null?void 0:JSON.parse(i)},set:i=>{t().setItem(r,JSON.stringify(i))},remove:()=>{t().removeItem(r)}});0&&(module.exports={createJsonStorage,persistManager});

package/dist/index.d.cts

@@ -60,9 +60,10 @@ type JsonStorageLike = {
     setItem(key: string, value: string): void;
     removeItem(key: string): void;
 };
+type JsonStorageSource = () => JsonStorageLike;
 export declare const persistManager: <S extends MachineStore>(manager: PersistManagerTarget<S>, options: PersistManagerOptions<S>) => PersistController;
-export declare const createJsonStorage: <S extends MachineStore>({ key, storage, }: {
+export declare const createJsonStorage: <S extends MachineStore>({ key, storage: storageSource, }: {
     key: string;
-    storage: JsonStorageLike;
+    storage: JsonStorageSource;
 }) => PersistStorage<S>;
 export {};

package/dist/index.d.ts

@@ -60,9 +60,10 @@ type JsonStorageLike = {
     setItem(key: string, value: string): void;
     removeItem(key: string): void;
 };
+type JsonStorageSource = () => JsonStorageLike;
 export declare const persistManager: <S extends MachineStore>(manager: PersistManagerTarget<S>, options: PersistManagerOptions<S>) => PersistController;
-export declare const createJsonStorage: <S extends MachineStore>({ key, storage, }: {
+export declare const createJsonStorage: <S extends MachineStore>({ key, storage: storageSource, }: {
     key: string;
-    storage: JsonStorageLike;
+    storage: JsonStorageSource;
 }) => PersistStorage<S>;
 export {};

package/dist/index.js

@@ -1 +1 @@
-var D=Symbol("lite-fsm.taskCancelled"),F=()=>Object.assign(new Error("[lite-fsm] task was cancelled."),{[D]:!0}),O=s=>s instanceof Error&&D in s,L=()=>{let s=0,r=new Set;return{latest:()=>{let S=0,i=-1,c=-1;r.add(()=>{i=-1,c=-1});let p=()=>i===s&&c===S,k=(d,a)=>{i=d,c=a},P=(d,a)=>{i!==d||c!==a||(i=-1,c=-1)};return{run:async d=>{let a=s,u=++S,y=()=>a===s&&u===S,h=()=>{if(!y())throw F()},w=async g=>{h();let M=await g();return h(),M};k(a,u);try{return await d({isCurrent:y,checkpoint:h,step:w})}finally{P(a,u)}},isActive:p}},cancelAll:()=>{s+=1;for(let S of r)S()}}};var G="@@lite-fsm/HYDRATE",B={phase:"idle"},q={phase:"restoring"},N=s=>s!==null&&typeof s=="object"&&!Array.isArray(s),z=s=>N(s)&&typeof s.timestamp=="number"&&N(s.snapshot),Q=()=>new Error("[@lite-fsm/persist] restore: persisted record must be an object with numeric timestamp and object snapshot."),X=(s,r)=>s.phase!==r.phase?!1:s.phase==="ready"&&r.phase==="ready"?s.restored===r.restored:s.phase==="error"&&r.phase==="error"?s.error===r.error:!0,ae=(s,r)=>{let l=r.throttleMs??0,S=r.strategy??"merge",i=B,c=[],p=0,k,P,f,d=!1,a,u=!1,y=L(),h=y.latest(),w=y.latest(),g=(e,t)=>{try{r.onError?.(e,t)}catch{}},M=e=>{try{r.onRestoreSettled?.(e)}catch{}},m=e=>{if(!X(i,e)){i=e;for(let t of c)t()}},x=(e,t,n,o)=>{if(O(e))return;let T=t.isCurrent();if(!(!T&&n==="background")){if(T){let b={phase:"error",error:e};m(b),o==="restore"&&M(b)}if(g(e,o),n==="direct")throw e}},R=()=>{d=!1,f&&(clearTimeout(f),f=void 0)},E=()=>{y.cancelAll(),u=!1,a=void 0,R()},_=e=>w.run(async t=>{try{t.checkpoint();let n={timestamp:Date.now(),storageVersion:r.storageVersion,snapshot:s.dehydrate({machines:r.machines})};t.checkpoint(),await t.step(()=>r.storage.set(n))}catch(n){x(n,t,e,"save")}}),v=e=>{R();let t=_(e).finally(()=>{a===t&&(a=void 0)});return a=t,t},j=()=>{if(d=!0,l===0){v("background");return}f||(f=setTimeout(()=>{v("background")},l))},J=async(e,t,n)=>{let o=e||u;u=!1,!(!o||!t.isCurrent())&&await v(n)},H=(e,t)=>{let n={phase:"ready",restored:e};return t.isCurrent()&&(m(n),M(n)),n},Y=async e=>{if(e===void 0)return{kind:"skip"};if(!z(e))return{kind:"remove",error:Q()};if(r.maxAge!==void 0&&Date.now()-e.timestamp>r.maxAge)return{kind:"remove"};if(e.storageVersion===r.storageVersion)return{kind:"hydrate",snapshot:e.snapshot,writeBack:!1};if(!r.migrate)return{kind:"remove"};let t=await r.migrate(e);return t?{kind:"hydrate",snapshot:t,writeBack:!0}:{kind:"remove"}},K=async e=>e.kind==="skip"?!1:e.kind==="remove"?(e.error!==void 0&&g(e.error,"restore"),await r.storage.remove(),!1):(s.hydrate(e.snapshot,{strategy:S}),!0),V=async e=>{let t=h.isActive();return h.run(async n=>{t||(u=!1),m(q);let o=!1,T=!1;try{let A=await n.step(()=>r.storage.get()),C=await n.step(()=>Y(A));o=await n.step(()=>K(C)),T=C.kind==="hydrate"&&C.writeBack}catch(A){return x(A,n,e,"restore"),i}let b=H(o,n);return await J(T,n,e),b})},I=()=>{V("background")},U=(e,t,n)=>{try{return r.shouldSave?.({prevState:e,currentState:t,action:n})??!0}catch(o){return m({phase:"error",error:o}),g(o,"save"),!1}},W=(e,t,n)=>{if(n.type!==G&&U(e,t,n)){if(h.isActive()){u=!0;return}j()}};return{start:()=>{p+=1,p===1&&(k=s.onTransition((t,n,o)=>{W(t,n,o)}),P=r.storage.subscribe?.(I),I());let e=!1;return()=>{e||(e=!0,p-=1,!(p>0)&&(E(),k?.(),P?.(),k=void 0,P=void 0,m(B)))}},restore:()=>V("direct"),save:async()=>{R(),await v("direct")},flush:async()=>{if(d){await v("direct");return}await a},clear:async()=>{let e=a;E();try{await e?.catch(()=>{}),await r.storage.remove(),m({phase:"ready",restored:!1})}catch(t){throw m({phase:"error",error:t}),g(t,"clear"),t}},getStatus:()=>i,subscribeStatus:e=>(c.push(e),()=>{c=c.filter(t=>t!==e)})}},oe=({key:s,storage:r})=>({get:()=>{let l=r.getItem(s);return l==null?void 0:JSON.parse(l)},set:l=>{r.setItem(s,JSON.stringify(l))},remove:()=>{r.removeItem(s)}});export{oe as createJsonStorage,ae as persistManager};
+var D=Symbol("lite-fsm.taskCancelled"),F=()=>Object.assign(new Error("[lite-fsm] task was cancelled."),{[D]:!0}),O=s=>s instanceof Error&&D in s,L=()=>{let s=0,r=new Set;return{latest:()=>{let S=0,i=-1,c=-1;r.add(()=>{i=-1,c=-1});let p=()=>i===s&&c===S,k=(d,a)=>{i=d,c=a},P=(d,a)=>{i!==d||c!==a||(i=-1,c=-1)};return{run:async d=>{let a=s,u=++S,y=()=>a===s&&u===S,h=()=>{if(!y())throw F()},w=async g=>{h();let M=await g();return h(),M};k(a,u);try{return await d({isCurrent:y,checkpoint:h,step:w})}finally{P(a,u)}},isActive:p}},cancelAll:()=>{s+=1;for(let S of r)S()}}};var G="@@lite-fsm/HYDRATE",J={phase:"idle"},q={phase:"restoring"},B=s=>s!==null&&typeof s=="object"&&!Array.isArray(s),z=s=>B(s)&&typeof s.timestamp=="number"&&B(s.snapshot),Q=()=>new Error("[@lite-fsm/persist] restore: persisted record must be an object with numeric timestamp and object snapshot."),X=(s,r)=>s.phase!==r.phase?!1:s.phase==="ready"&&r.phase==="ready"?s.restored===r.restored:s.phase==="error"&&r.phase==="error"?s.error===r.error:!0,ae=(s,r)=>{let l=r.throttleMs??0,S=r.strategy??"merge",i=J,c=[],p=0,k,P,f,d=!1,a,u=!1,y=L(),h=y.latest(),w=y.latest(),g=(e,t)=>{try{r.onError?.(e,t)}catch{}},M=e=>{try{r.onRestoreSettled?.(e)}catch{}},m=e=>{if(!X(i,e)){i=e;for(let t of c)t()}},x=(e,t,n,o)=>{if(O(e))return;let T=t.isCurrent();if(!(!T&&n==="background")){if(T){let b={phase:"error",error:e};m(b),o==="restore"&&M(b)}if(g(e,o),n==="direct")throw e}},R=()=>{d=!1,f&&(clearTimeout(f),f=void 0)},E=()=>{y.cancelAll(),u=!1,a=void 0,R()},N=e=>w.run(async t=>{try{t.checkpoint();let n={timestamp:Date.now(),storageVersion:r.storageVersion,snapshot:s.dehydrate({machines:r.machines})};t.checkpoint(),await t.step(()=>r.storage.set(n))}catch(n){x(n,t,e,"save")}}),v=e=>{R();let t=N(e).finally(()=>{a===t&&(a=void 0)});return a=t,t},_=()=>{if(d=!0,l===0){v("background");return}f||(f=setTimeout(()=>{v("background")},l))},j=async(e,t,n)=>{let o=e||u;u=!1,!(!o||!t.isCurrent())&&await v(n)},H=(e,t)=>{let n={phase:"ready",restored:e};return t.isCurrent()&&(m(n),M(n)),n},Y=async e=>{if(e===void 0)return{kind:"skip"};if(!z(e))return{kind:"remove",error:Q()};if(r.maxAge!==void 0&&Date.now()-e.timestamp>r.maxAge)return{kind:"remove"};if(e.storageVersion===r.storageVersion)return{kind:"hydrate",snapshot:e.snapshot,writeBack:!1};if(!r.migrate)return{kind:"remove"};let t=await r.migrate(e);return t?{kind:"hydrate",snapshot:t,writeBack:!0}:{kind:"remove"}},K=async e=>e.kind==="skip"?!1:e.kind==="remove"?(e.error!==void 0&&g(e.error,"restore"),await r.storage.remove(),!1):(s.hydrate(e.snapshot,{strategy:S}),!0),V=async e=>{let t=h.isActive();return h.run(async n=>{t||(u=!1),m(q);let o=!1,T=!1;try{let A=await n.step(()=>r.storage.get()),C=await n.step(()=>Y(A));o=await n.step(()=>K(C)),T=C.kind==="hydrate"&&C.writeBack}catch(A){return x(A,n,e,"restore"),i}let b=H(o,n);return await j(T,n,e),b})},I=()=>{V("background")},U=(e,t,n)=>{try{return r.shouldSave?.({prevState:e,currentState:t,action:n})??!0}catch(o){return m({phase:"error",error:o}),g(o,"save"),!1}},W=(e,t,n)=>{if(n.type!==G&&U(e,t,n)){if(h.isActive()){u=!0;return}_()}};return{start:()=>{p+=1,p===1&&(k=s.onTransition((t,n,o)=>{W(t,n,o)}),P=r.storage.subscribe?.(I),I());let e=!1;return()=>{e||(e=!0,p-=1,!(p>0)&&(E(),k?.(),P?.(),k=void 0,P=void 0,m(J)))}},restore:()=>V("direct"),save:async()=>{R(),await v("direct")},flush:async()=>{if(d){await v("direct");return}await a},clear:async()=>{let e=a;E();try{await e?.catch(()=>{}),await r.storage.remove(),m({phase:"ready",restored:!1})}catch(t){throw m({phase:"error",error:t}),g(t,"clear"),t}},getStatus:()=>i,subscribeStatus:e=>(c.push(e),()=>{c=c.filter(t=>t!==e)})}},oe=({key:s,storage:r})=>({get:()=>{let l=r().getItem(s);return l==null?void 0:JSON.parse(l)},set:l=>{r().setItem(s,JSON.stringify(l))},remove:()=>{r().removeItem(s)}});export{oe as createJsonStorage,ae as persistManager};

package/dist/react.cjs

@@ -1 +1 @@
-"use strict";"use client";var P=Object.create;var o=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var x=Object.getPrototypeOf,m=Object.prototype.hasOwnProperty;var f=(t,s)=>{for(var e in s)o(t,e,{get:s[e],enumerable:!0})},u=(t,s,e,i)=>{if(s&&typeof s=="object"||typeof s=="function")for(let r of p(s))!m.call(t,r)&&r!==e&&o(t,r,{get:()=>s[r],enumerable:!(i=C(s,r))||i.enumerable});return t};var R=(t,s,e)=>(e=t!=null?P(x(t)):{},u(s||!t||!t.__esModule?o(e,"default",{value:t,enumerable:!0}):e,t)),b=t=>u(o({},"__esModule",{value:!0}),t);var T={};f(T,{useIsPersistRestoring:()=>d,usePersistStatus:()=>a});module.exports=b(T);var n=R(require("react"),1),S=require("use-sync-external-store/shim"),l=Symbol.for("@lite-fsm/react.persistContext"),g="Hooks from @lite-fsm/persist/react require a PersistController argument or FSMContextProvider persist context.",c=globalThis,E=c[l]??(c[l]=n.default.createContext(null)),y=t=>{let s=n.default.useContext(E),e=t??s;if(!e)throw new Error(g);return e},a=t=>{let s=y(t);return(0,S.useSyncExternalStore)(s.subscribeStatus,s.getStatus,s.getStatus)},d=t=>a(t).phase==="restoring";0&&(module.exports={useIsPersistRestoring,usePersistStatus});
+"use strict";"use client";var P=Object.create;var u=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var E=Object.getPrototypeOf,b=Object.prototype.hasOwnProperty;var d=(t,s)=>{for(var e in s)u(t,e,{get:s[e],enumerable:!0})},S=(t,s,e,o)=>{if(s&&typeof s=="object"||typeof s=="function")for(let r of y(s))!b.call(t,r)&&r!==e&&u(t,r,{get:()=>s[r],enumerable:!(o=h(s,r))||o.enumerable});return t};var m=(t,s,e)=>(e=t!=null?P(E(t)):{},S(s||!t||!t.__esModule?u(e,"default",{value:t,enumerable:!0}):e,t)),g=t=>S(u({},"__esModule",{value:!0}),t);var I={};d(I,{useIsPersistRestoring:()=>v,usePersistStatuses:()=>p});module.exports=g(I);var a=m(require("react"),1),f=require("use-sync-external-store/shim"),i=Symbol.for("@lite-fsm/react.persistStatusesContext"),x="Hooks from @lite-fsm/persist/react require FSMContextProvider from @lite-fsm/react.",T=[],l=globalThis,R=l[i]??(l[i]=a.default.createContext(null)),c=t=>{if(t.length===0)return T;let s=[];for(let e of t)s.push(e===null?null:e.getStatus());return s},C=(t,s)=>{if(t.length!==s.length)return!1;for(let e=0;e<t.length;e+=1)if(!Object.is(t[e],s[e]))return!1;return!0},_=t=>{let s=c(t),e=()=>{let o=c(t);return C(s,o)?!1:(s=o,!0)};return{getSnapshot:()=>s,getServerSnapshot:()=>s,subscribe:o=>{let r=[];for(let n of t)n!==null&&r.push(n.subscribeStatus(()=>{e()&&o()}));return()=>{for(let n of r)n()}}}},p=()=>{let t=a.default.useContext(R);if(t===null)throw new Error(x);let s=a.default.useMemo(()=>_(t),[t]);return(0,f.useSyncExternalStore)(s.subscribe,s.getSnapshot,s.getServerSnapshot)},v=()=>p().some(s=>s?.phase==="restoring");0&&(module.exports={useIsPersistRestoring,usePersistStatuses});

package/dist/react.d.cts

@@ -1,3 +1,5 @@
-import type { PersistController, PersistStatus } from "./index";
-export declare const usePersistStatus: (controller?: PersistController) => PersistStatus;
-export declare const useIsPersistRestoring: (controller?: PersistController) => boolean;
+import type { PersistStatus } from "./index";
+type PersistStatusesSnapshot = readonly (PersistStatus | null)[];
+export declare const usePersistStatuses: () => PersistStatusesSnapshot;
+export declare const useIsPersistRestoring: () => boolean;
+export {};

package/dist/react.d.ts

@@ -1,3 +1,5 @@
-import type { PersistController, PersistStatus } from "./index";
-export declare const usePersistStatus: (controller?: PersistController) => PersistStatus;
-export declare const useIsPersistRestoring: (controller?: PersistController) => boolean;
+import type { PersistStatus } from "./index";
+type PersistStatusesSnapshot = readonly (PersistStatus | null)[];
+export declare const usePersistStatuses: () => PersistStatusesSnapshot;
+export declare const useIsPersistRestoring: () => boolean;
+export {};

package/dist/react.js

@@ -1 +1 @@
-"use client";import n from"react";import{useSyncExternalStore as i}from"use-sync-external-store/shim";var r=Symbol.for("@lite-fsm/react.persistContext"),u="Hooks from @lite-fsm/persist/react require a PersistController argument or FSMContextProvider persist context.",o=globalThis,l=o[r]??(o[r]=n.createContext(null)),c=t=>{let s=n.useContext(l),e=t??s;if(!e)throw new Error(u);return e},S=t=>{let s=c(t);return i(s.subscribeStatus,s.getStatus,s.getStatus)},C=t=>S(t).phase==="restoring";export{C as useIsPersistRestoring,S as usePersistStatus};
+"use client";import n from"react";import{useSyncExternalStore as l}from"use-sync-external-store/shim";var a=Symbol.for("@lite-fsm/react.persistStatusesContext"),c="Hooks from @lite-fsm/persist/react require FSMContextProvider from @lite-fsm/react.",f=[],S=globalThis,p=S[a]??(S[a]=n.createContext(null)),i=s=>{if(s.length===0)return f;let t=[];for(let e of s)t.push(e===null?null:e.getStatus());return t},P=(s,t)=>{if(s.length!==t.length)return!1;for(let e=0;e<s.length;e+=1)if(!Object.is(s[e],t[e]))return!1;return!0},h=s=>{let t=i(s),e=()=>{let r=i(s);return P(t,r)?!1:(t=r,!0)};return{getSnapshot:()=>t,getServerSnapshot:()=>t,subscribe:r=>{let u=[];for(let o of s)o!==null&&u.push(o.subscribeStatus(()=>{e()&&r()}));return()=>{for(let o of u)o()}}}},y=()=>{let s=n.useContext(p);if(s===null)throw new Error(c);let t=n.useMemo(()=>h(s),[s]);return l(t.subscribe,t.getSnapshot,t.getServerSnapshot)},d=()=>y().some(t=>t?.phase==="restoring");export{d as useIsPersistRestoring,y as usePersistStatuses};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lite-fsm/persist",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "type": "module",
   "description": "Persistence helpers for lite-fsm",
   "license": "MIT",
@@ -70,7 +70,7 @@
   },
   "dependencies": {
     "use-sync-external-store": ">=1.2.0",
-    "@lite-fsm/core": "2.0.2"
+    "@lite-fsm/core": "2.0.4"
   },
   "peerDependencies": {
     "react": ">=18.0.0"