@storix-js/persist 0.2.1 → 0.3.0

package/README.md

@@ -22,3 +22,5 @@ const storix = createStorix({
 ```
 
 Use `storage: 'indexedDB'` for larger or more durable client-side state.
+
+The plugin writes complete namespace-aware snapshots, including nested modules. If a local mutation occurs while asynchronous hydration is pending, the local state wins; disposed stores are not hydrated later. IndexedDB dispose flush remains best effort because plugin disposal is synchronous.

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const T=require("@storix-js/core");function j(s={}){var D,I;const m=s.keyPrefix??"storix",y=new Set(s.include??[]),g=s.storage??"localStorage",b=s.serialize??JSON.stringify,x=s.deserialize??(e=>JSON.parse(e)),S=s.debounce??100,B=((D=s.indexedDB)==null?void 0:D.dbName)??`${m}-persist`,c=((I=s.indexedDB)==null?void 0:I.storeName)??"stores",a=new Map,d=new Map;let u=null;const w=e=>{const t=[e.$id,e.$scopeId];return!(y.size>0&&!t.some(n=>y.has(n)))},l=e=>`${m}:${e.$namespace}:${e.$id}`,h=()=>u||(u=new Promise((e,t)=>{const n=window.indexedDB.open(B,1);n.onupgradeneeded=()=>{const r=n.result;r.objectStoreNames.contains(c)||r.createObjectStore(c)},n.onsuccess=()=>e(n.result),n.onerror=()=>t(n.error??new Error("IndexedDB open failed"))}),u),P=async e=>{const t=await h(),n=l(e);return new Promise((r,p)=>{const i=t.transaction(c,"readonly").objectStore(c).get(n);i.onsuccess=()=>{const o=i.result;if(typeof o!="string"){r(null);return}try{r(x(o))}catch{r(null)}},i.onerror=()=>p(i.error??new Error("IndexedDB read failed"))})},N=async(e,t)=>{const n=await h(),r=l(e),p=b(t);return new Promise(($,i)=>{const o=n.transaction(c,"readwrite");o.objectStore(c).put(p,r),o.oncomplete=()=>$(),o.onerror=()=>i(o.error??new Error("IndexedDB write failed")),o.onabort=()=>i(o.error??new Error("IndexedDB write aborted"))})},k=async e=>{if(typeof window>"u")return null;if(g==="indexedDB"&&"indexedDB"in window)try{return await P(e)}catch{return null}try{const t=window.localStorage.getItem(l(e));return t?x(t):null}catch{return null}},f=e=>{if(typeof window>"u")return;const t=a.get(e.$scopeId);if(t){if(g==="indexedDB"&&"indexedDB"in window){N(e,t).catch(()=>{});return}try{window.localStorage.setItem(l(e),b(t))}catch{}}},z=e=>{const t=e.$scopeId,n=d.get(t);if(n&&(clearTimeout(n),d.delete(t)),S<=0){f(e);return}const r=setTimeout(()=>{d.delete(t),f(e)},S);d.set(t,r)},M=e=>{const t=e.$scopeId,n=d.get(t);n&&(clearTimeout(n),d.delete(t)),f(e)};return T.definePlugin({name:"persist",onInit(e){const t=e;typeof window>"u"||w(t)&&(async()=>{const n=await k(t);n&&(a.set(t.$scopeId,n),t.$patch(n,"remote"))})()},onMutation(e,t){const n=e;if(typeof window>"u"||!w(n))return;const r=a.get(n.$scopeId)??{};r[t.key]=t.newValue,a.set(n.$scopeId,r),z(n)},onDispose(e){const t=e;w(t)&&M(t)}})}exports.persistPlugin=j;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@storix-js/core");function t(t={}){let n=t.keyPrefix??`storix`,r=new Set(t.include??[]),i=t.storage??`localStorage`,a=t.serialize??JSON.stringify,o=t.deserialize??(e=>JSON.parse(e)),s=t.debounce??100,c=t.indexedDB?.dbName??`${n}-persist`,l=t.indexedDB?.storeName??`stores`,u=new Map,d=new Map,f=new Set,p=new Set,m=new Set,h=new Set,g=null,_=e=>{let t=[e.$id,e.$scopeId];return!(r.size>0&&!t.some(e=>r.has(e)))},v=e=>`${n}:${e.$namespace}:${e.$id}`,y=()=>g||(g=new Promise((e,t)=>{let n=window.indexedDB.open(c,1);n.onupgradeneeded=()=>{let e=n.result;e.objectStoreNames.contains(l)||e.createObjectStore(l)},n.onsuccess=()=>e(n.result),n.onerror=()=>t(n.error??Error(`IndexedDB open failed`))}),g),b=async e=>{let t=await y(),n=v(e);return new Promise((e,r)=>{let i=t.transaction(l,`readonly`).objectStore(l).get(n);i.onsuccess=()=>{let t=i.result;if(typeof t!=`string`){e(null);return}try{e(o(t))}catch{e(null)}},i.onerror=()=>r(i.error??Error(`IndexedDB read failed`))})},x=async(e,t)=>{let n=await y(),r=v(e),i=a(t);return new Promise((e,t)=>{let a=n.transaction(l,`readwrite`);a.objectStore(l).put(i,r),a.oncomplete=()=>e(),a.onerror=()=>t(a.error??Error(`IndexedDB write failed`)),a.onabort=()=>t(a.error??Error(`IndexedDB write aborted`))})},S=async e=>{if(typeof window>`u`)return null;if(i===`indexedDB`&&`indexedDB`in window)try{return await b(e)}catch{return null}try{let t=window.localStorage.getItem(v(e));return t?o(t):null}catch{return null}},C=e=>{if(typeof window>`u`)return;let t=u.get(e.$scopeId);if(t){if(i===`indexedDB`&&`indexedDB`in window){x(e,t).catch(()=>{});return}try{window.localStorage.setItem(v(e),a(t))}catch{}}},w=e=>{let t=e.$scopeId,n=d.get(t);if(n&&(clearTimeout(n),d.delete(t)),s<=0){C(e);return}let r=setTimeout(()=>{d.delete(t),C(e)},s);d.set(t,r)},T=e=>{let t=e.$scopeId,n=d.get(t);n&&(clearTimeout(n),d.delete(t)),C(e)};return(0,e.definePlugin)({name:`persist`,onInit(e){let t=e;typeof window>`u`||_(t)&&(h.delete(t.$scopeId),f.add(t.$scopeId),(async()=>{let e=await S(t);if(!h.has(t.$scopeId)){if(f.delete(t.$scopeId),p.delete(t.$scopeId)){u.set(t.$scopeId,t.$snapshot());return}if(!e){u.set(t.$scopeId,t.$snapshot());return}m.add(t.$scopeId);try{t.$patch(e,`remote`),u.set(t.$scopeId,t.$snapshot())}finally{m.delete(t.$scopeId)}}})())},onMutation(e){let t=e;typeof window>`u`||_(t)&&(m.has(t.$scopeId)||(f.has(t.$scopeId)&&p.add(t.$scopeId),u.set(t.$scopeId,t.$snapshot()),w(t)))},onDispose(e){let t=e;_(t)&&(h.add(t.$scopeId),f.delete(t.$scopeId),p.delete(t.$scopeId),m.delete(t.$scopeId),T(t),u.delete(t.$scopeId))}})}exports.persistPlugin=t;

package/dist/index.d.ts

@@ -12,6 +12,11 @@ export interface PersistPluginOptions {
     debounce?: number;
     indexedDB?: IndexedDBPersistOptions;
 }
-export declare function persistPlugin(options?: PersistPluginOptions): import("@storix-js/core").StorePlugin;
+export declare function persistPlugin(options?: PersistPluginOptions): {
+    name: string;
+    onInit(store: import("@storix-js/core").StoreInstance<{}, {}, {}, {}>): void;
+    onMutation(store: import("@storix-js/core").StoreInstance<{}, {}, {}, {}>): void;
+    onDispose(store: import("@storix-js/core").StoreInstance<{}, {}, {}, {}>): void;
+};
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,KAAK,cAAc,GAAG,cAAc,GAAG,WAAW,CAAC;AAEnD,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;IACvD,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,uBAAuB,CAAC;CACrC;AASD,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,yCAuL/D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,KAAK,cAAc,GAAG,cAAc,GAAG,WAAW,CAAC;AAEnD,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;IACvD,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,uBAAuB,CAAC;CACrC;AAUD,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB;;;;;EAwN/D"}

package/dist/index.js

@@ -1,103 +1,110 @@
-import { definePlugin as M } from "@storix-js/core";
-function j(s = {}) {
-  var D, I;
-  const m = s.keyPrefix ?? "storix", y = new Set(s.include ?? []), x = s.storage ?? "localStorage", b = s.serialize ?? JSON.stringify, g = s.deserialize ?? ((e) => JSON.parse(e)), S = s.debounce ?? 100, B = ((D = s.indexedDB) == null ? void 0 : D.dbName) ?? `${m}-persist`, c = ((I = s.indexedDB) == null ? void 0 : I.storeName) ?? "stores", a = /* @__PURE__ */ new Map(), d = /* @__PURE__ */ new Map();
-  let u = null;
-  const w = (e) => {
-    const t = [e.$id, e.$scopeId];
-    return !(y.size > 0 && !t.some((n) => y.has(n)));
-  }, l = (e) => `${m}:${e.$namespace}:${e.$id}`, h = () => u || (u = new Promise((e, t) => {
-    const n = window.indexedDB.open(B, 1);
-    n.onupgradeneeded = () => {
-      const r = n.result;
-      r.objectStoreNames.contains(c) || r.createObjectStore(c);
-    }, n.onsuccess = () => e(n.result), n.onerror = () => t(n.error ?? new Error("IndexedDB open failed"));
-  }), u), P = async (e) => {
-    const t = await h(), n = l(e);
-    return new Promise((r, p) => {
-      const i = t.transaction(c, "readonly").objectStore(c).get(n);
-      i.onsuccess = () => {
-        const o = i.result;
-        if (typeof o != "string") {
-          r(null);
-          return;
-        }
-        try {
-          r(g(o));
-        } catch {
-          r(null);
-        }
-      }, i.onerror = () => p(i.error ?? new Error("IndexedDB read failed"));
-    });
-  }, N = async (e, t) => {
-    const n = await h(), r = l(e), p = b(t);
-    return new Promise(($, i) => {
-      const o = n.transaction(c, "readwrite");
-      o.objectStore(c).put(p, r), o.oncomplete = () => $(), o.onerror = () => i(o.error ?? new Error("IndexedDB write failed")), o.onabort = () => i(o.error ?? new Error("IndexedDB write aborted"));
-    });
-  }, k = async (e) => {
-    if (typeof window > "u") return null;
-    if (x === "indexedDB" && "indexedDB" in window)
-      try {
-        return await P(e);
-      } catch {
-        return null;
-      }
-    try {
-      const t = window.localStorage.getItem(l(e));
-      return t ? g(t) : null;
-    } catch {
-      return null;
-    }
-  }, f = (e) => {
-    if (typeof window > "u") return;
-    const t = a.get(e.$scopeId);
-    if (t) {
-      if (x === "indexedDB" && "indexedDB" in window) {
-        N(e, t).catch(() => {
-        });
-        return;
-      }
-      try {
-        window.localStorage.setItem(l(e), b(t));
-      } catch {
-      }
-    }
-  }, z = (e) => {
-    const t = e.$scopeId, n = d.get(t);
-    if (n && (clearTimeout(n), d.delete(t)), S <= 0) {
-      f(e);
-      return;
-    }
-    const r = setTimeout(() => {
-      d.delete(t), f(e);
-    }, S);
-    d.set(t, r);
-  }, E = (e) => {
-    const t = e.$scopeId, n = d.get(t);
-    n && (clearTimeout(n), d.delete(t)), f(e);
-  };
-  return M({
-    name: "persist",
-    onInit(e) {
-      const t = e;
-      typeof window > "u" || w(t) && (async () => {
-        const n = await k(t);
-        n && (a.set(t.$scopeId, n), t.$patch(n, "remote"));
-      })();
-    },
-    onMutation(e, t) {
-      const n = e;
-      if (typeof window > "u" || !w(n)) return;
-      const r = a.get(n.$scopeId) ?? {};
-      r[t.key] = t.newValue, a.set(n.$scopeId, r), z(n);
-    },
-    onDispose(e) {
-      const t = e;
-      w(t) && E(t);
-    }
-  });
+import { definePlugin as e } from "@storix-js/core";
+//#region src/index.ts
+function t(t = {}) {
+	let n = t.keyPrefix ?? "storix", r = new Set(t.include ?? []), i = t.storage ?? "localStorage", a = t.serialize ?? JSON.stringify, o = t.deserialize ?? ((e) => JSON.parse(e)), s = t.debounce ?? 100, c = t.indexedDB?.dbName ?? `${n}-persist`, l = t.indexedDB?.storeName ?? "stores", u = /* @__PURE__ */ new Map(), d = /* @__PURE__ */ new Map(), f = /* @__PURE__ */ new Set(), p = /* @__PURE__ */ new Set(), m = /* @__PURE__ */ new Set(), h = /* @__PURE__ */ new Set(), g = null, _ = (e) => {
+		let t = [e.$id, e.$scopeId];
+		return !(r.size > 0 && !t.some((e) => r.has(e)));
+	}, v = (e) => `${n}:${e.$namespace}:${e.$id}`, y = () => g || (g = new Promise((e, t) => {
+		let n = window.indexedDB.open(c, 1);
+		n.onupgradeneeded = () => {
+			let e = n.result;
+			e.objectStoreNames.contains(l) || e.createObjectStore(l);
+		}, n.onsuccess = () => e(n.result), n.onerror = () => t(n.error ?? /* @__PURE__ */ Error("IndexedDB open failed"));
+	}), g), b = async (e) => {
+		let t = await y(), n = v(e);
+		return new Promise((e, r) => {
+			let i = t.transaction(l, "readonly").objectStore(l).get(n);
+			i.onsuccess = () => {
+				let t = i.result;
+				if (typeof t != "string") {
+					e(null);
+					return;
+				}
+				try {
+					e(o(t));
+				} catch {
+					e(null);
+				}
+			}, i.onerror = () => r(i.error ?? /* @__PURE__ */ Error("IndexedDB read failed"));
+		});
+	}, x = async (e, t) => {
+		let n = await y(), r = v(e), i = a(t);
+		return new Promise((e, t) => {
+			let a = n.transaction(l, "readwrite");
+			a.objectStore(l).put(i, r), a.oncomplete = () => e(), a.onerror = () => t(a.error ?? /* @__PURE__ */ Error("IndexedDB write failed")), a.onabort = () => t(a.error ?? /* @__PURE__ */ Error("IndexedDB write aborted"));
+		});
+	}, S = async (e) => {
+		if (typeof window > "u") return null;
+		if (i === "indexedDB" && "indexedDB" in window) try {
+			return await b(e);
+		} catch {
+			return null;
+		}
+		try {
+			let t = window.localStorage.getItem(v(e));
+			return t ? o(t) : null;
+		} catch {
+			return null;
+		}
+	}, C = (e) => {
+		if (typeof window > "u") return;
+		let t = u.get(e.$scopeId);
+		if (t) {
+			if (i === "indexedDB" && "indexedDB" in window) {
+				x(e, t).catch(() => {});
+				return;
+			}
+			try {
+				window.localStorage.setItem(v(e), a(t));
+			} catch {}
+		}
+	}, w = (e) => {
+		let t = e.$scopeId, n = d.get(t);
+		if (n && (clearTimeout(n), d.delete(t)), s <= 0) {
+			C(e);
+			return;
+		}
+		let r = setTimeout(() => {
+			d.delete(t), C(e);
+		}, s);
+		d.set(t, r);
+	}, T = (e) => {
+		let t = e.$scopeId, n = d.get(t);
+		n && (clearTimeout(n), d.delete(t)), C(e);
+	};
+	return e({
+		name: "persist",
+		onInit(e) {
+			let t = e;
+			typeof window > "u" || _(t) && (h.delete(t.$scopeId), f.add(t.$scopeId), (async () => {
+				let e = await S(t);
+				if (!h.has(t.$scopeId)) {
+					if (f.delete(t.$scopeId), p.delete(t.$scopeId)) {
+						u.set(t.$scopeId, t.$snapshot());
+						return;
+					}
+					if (!e) {
+						u.set(t.$scopeId, t.$snapshot());
+						return;
+					}
+					m.add(t.$scopeId);
+					try {
+						t.$patch(e, "remote"), u.set(t.$scopeId, t.$snapshot());
+					} finally {
+						m.delete(t.$scopeId);
+					}
+				}
+			})());
+		},
+		onMutation(e) {
+			let t = e;
+			typeof window > "u" || _(t) && (m.has(t.$scopeId) || (f.has(t.$scopeId) && p.add(t.$scopeId), u.set(t.$scopeId, t.$snapshot()), w(t)));
+		},
+		onDispose(e) {
+			let t = e;
+			_(t) && (h.add(t.$scopeId), f.delete(t.$scopeId), p.delete(t.$scopeId), m.delete(t.$scopeId), T(t), u.delete(t.$scopeId));
+		}
+	});
 }
-export {
-  j as persistPlugin
-};
+//#endregion
+export { t as persistPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storix-js/persist",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -19,13 +19,13 @@
       "require": "./dist/index.cjs"
     }
   },
+  "dependencies": {
+    "@storix-js/core": "0.3.0"
+  },
   "scripts": {
     "build": "vite build && tsc -p tsconfig.build.json --emitDeclarationOnly",
     "dev": "vite build --watch",
     "test": "vitest run --passWithNoTests",
     "typecheck": "tsc -p tsconfig.json --noEmit"
-  },
-  "dependencies": {
-    "@storix-js/core": "workspace:*"
   }
-}
+}