mvc-kit 2.12.4 → 2.13.0

package/dist/web/WebStorageCollection.cjs

@@ -1,85 +1,83 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const PersistentCollection = require("../PersistentCollection.cjs");
-const __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
-class WebStorageCollection extends PersistentCollection.PersistentCollection {
-  /** Which Web Storage backend to use. Override to 'session' for sessionStorage. */
-  static STORAGE = "local";
-  _autoHydrated = false;
-  get _storage() {
-    return this.constructor.STORAGE === "session" ? sessionStorage : localStorage;
-  }
-  _ensureHydrated() {
-    if (this._autoHydrated) return;
-    this._autoHydrated = true;
-    this._hydrateSync();
-  }
-  // ── Override access points to trigger lazy hydration ──
-  get items() {
-    this._ensureHydrated();
-    return super.items;
-  }
-  get state() {
-    return this.items;
-  }
-  get length() {
-    this._ensureHydrated();
-    return super.length;
-  }
-  get(id) {
-    this._ensureHydrated();
-    return super.get(id);
-  }
-  has(id) {
-    this._ensureHydrated();
-    return super.has(id);
-  }
-  // ── Persist interface (blob strategy) ──
-  persistGetAll() {
-    const raw = this._storage.getItem(this.storageKey);
-    if (!raw) return [];
-    try {
-      return this.deserialize(raw);
-    } catch {
-      if (__DEV__) {
-        console.warn(
-          `[mvc-kit] Corrupted data in storage key "${this.storageKey}". Ignoring stored data.`
-        );
-      }
-      return [];
-    }
-  }
-  persistGet(id) {
-    const all = this.persistGetAll();
-    return all.find((i) => i.id === id) ?? null;
-  }
-  persistSet(_items) {
-    try {
-      this._storage.setItem(this.storageKey, this.serialize([...this.items]));
-    } catch (err) {
-      if (__DEV__ && err instanceof DOMException && err.name === "QuotaExceededError") {
-        console.warn(
-          `[mvc-kit] QuotaExceededError writing to "${this.storageKey}". Consider using IndexedDBCollection for larger datasets.`
-        );
-      }
-      throw err;
-    }
-  }
-  persistRemove(_ids) {
-    try {
-      this._storage.setItem(this.storageKey, this.serialize([...this.items]));
-    } catch (err) {
-      if (__DEV__ && err instanceof DOMException && err.name === "QuotaExceededError") {
-        console.warn(
-          `[mvc-kit] QuotaExceededError writing to "${this.storageKey}". Consider using IndexedDBCollection for larger datasets.`
-        );
-      }
-      throw err;
-    }
-  }
-  persistClear() {
-    this._storage.removeItem(this.storageKey);
-  }
-}
+const require_PersistentCollection = require("../PersistentCollection.cjs");
+//#region src/web/WebStorageCollection.ts
+var __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
+/**
+* PersistentCollection backed by localStorage or sessionStorage.
+* Auto-hydrates on first access (sync storage — no need for manual `hydrate()` call).
+*
+* Uses blob strategy: all items stored as a single JSON string under `storageKey`.
+*
+* ```ts
+* class CartCollection extends WebStorageCollection<CartItem> {
+*   protected readonly storageKey = 'cart';
+* }
+* ```
+*/
+var WebStorageCollection = class extends require_PersistentCollection.PersistentCollection {
+	/** Which Web Storage backend to use. Override to 'session' for sessionStorage. */
+	static STORAGE = "local";
+	_autoHydrated = false;
+	get _storage() {
+		return this.constructor.STORAGE === "session" ? sessionStorage : localStorage;
+	}
+	_ensureHydrated() {
+		if (this._autoHydrated) return;
+		this._autoHydrated = true;
+		this._hydrateSync();
+	}
+	get items() {
+		this._ensureHydrated();
+		return super.items;
+	}
+	get state() {
+		return this.items;
+	}
+	get length() {
+		this._ensureHydrated();
+		return super.length;
+	}
+	get(id) {
+		this._ensureHydrated();
+		return super.get(id);
+	}
+	has(id) {
+		this._ensureHydrated();
+		return super.has(id);
+	}
+	persistGetAll() {
+		const raw = this._storage.getItem(this.storageKey);
+		if (!raw) return [];
+		try {
+			return this.deserialize(raw);
+		} catch {
+			if (__DEV__) console.warn(`[mvc-kit] Corrupted data in storage key "${this.storageKey}". Ignoring stored data.`);
+			return [];
+		}
+	}
+	persistGet(id) {
+		return this.persistGetAll().find((i) => i.id === id) ?? null;
+	}
+	persistSet(_items) {
+		try {
+			this._storage.setItem(this.storageKey, this.serialize([...this.items]));
+		} catch (err) {
+			if (__DEV__ && err instanceof DOMException && err.name === "QuotaExceededError") console.warn(`[mvc-kit] QuotaExceededError writing to "${this.storageKey}". Consider using IndexedDBCollection for larger datasets.`);
+			throw err;
+		}
+	}
+	persistRemove(_ids) {
+		try {
+			this._storage.setItem(this.storageKey, this.serialize([...this.items]));
+		} catch (err) {
+			if (__DEV__ && err instanceof DOMException && err.name === "QuotaExceededError") console.warn(`[mvc-kit] QuotaExceededError writing to "${this.storageKey}". Consider using IndexedDBCollection for larger datasets.`);
+			throw err;
+		}
+	}
+	persistClear() {
+		this._storage.removeItem(this.storageKey);
+	}
+};
+//#endregion
 exports.WebStorageCollection = WebStorageCollection;
-//# sourceMappingURL=WebStorageCollection.cjs.map
+
+//# sourceMappingURL=WebStorageCollection.cjs.map

package/dist/web/WebStorageCollection.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"WebStorageCollection.cjs","sources":["../../src/web/WebStorageCollection.ts"],"sourcesContent":["import { PersistentCollection } from '../PersistentCollection';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n/**\n * PersistentCollection backed by localStorage or sessionStorage.\n * Auto-hydrates on first access (sync storage — no need for manual `hydrate()` call).\n *\n * Uses blob strategy: all items stored as a single JSON string under `storageKey`.\n *\n * ```ts\n * class CartCollection extends WebStorageCollection<CartItem> {\n *   protected readonly storageKey = 'cart';\n * }\n * ```\n */\nexport abstract class WebStorageCollection<\n  T extends { id: string | number },\n> extends PersistentCollection<T> {\n  /** Which Web Storage backend to use. Override to 'session' for sessionStorage. */\n  static STORAGE: 'local' | 'session' = 'local';\n\n  private _autoHydrated = false;\n\n  private get _storage(): Storage {\n    return (this.constructor as typeof WebStorageCollection).STORAGE === 'session'\n      ? sessionStorage\n      : localStorage;\n  }\n\n  private _ensureHydrated(): void {\n    if (this._autoHydrated) return;\n    this._autoHydrated = true;\n    this._hydrateSync();\n  }\n\n  // ── Override access points to trigger lazy hydration ──\n\n  get items(): T[] {\n    this._ensureHydrated();\n    return super.items;\n  }\n\n  get state(): T[] {\n    return this.items;\n  }\n\n  get length(): number {\n    this._ensureHydrated();\n    return super.length;\n  }\n\n  get(id: T['id']): T | undefined {\n    this._ensureHydrated();\n    return super.get(id);\n  }\n\n  has(id: T['id']): boolean {\n    this._ensureHydrated();\n    return super.has(id);\n  }\n\n  // ── Persist interface (blob strategy) ──\n\n  protected persistGetAll(): T[] {\n    const raw = this._storage.getItem(this.storageKey);\n    if (!raw) return [];\n    try {\n      return this.deserialize(raw);\n    } catch {\n      if (__DEV__) {\n        console.warn(\n          `[mvc-kit] Corrupted data in storage key \"${this.storageKey}\". Ignoring stored data.`,\n        );\n      }\n      return [];\n    }\n  }\n\n  protected persistGet(id: T['id']): T | null {\n    const all = this.persistGetAll();\n    return all.find((i) => i.id === id) ?? null;\n  }\n\n  protected persistSet(_items: T[]): void {\n    try {\n      this._storage.setItem(this.storageKey, this.serialize([...this.items]));\n    } catch (err) {\n      if (__DEV__ && err instanceof DOMException && err.name === 'QuotaExceededError') {\n        console.warn(\n          `[mvc-kit] QuotaExceededError writing to \"${this.storageKey}\". ` +\n            `Consider using IndexedDBCollection for larger datasets.`,\n        );\n      }\n      throw err;\n    }\n  }\n\n  protected persistRemove(_ids: T['id'][]): void {\n    try {\n      this._storage.setItem(this.storageKey, this.serialize([...this.items]));\n    } catch (err) {\n      if (__DEV__ && err instanceof DOMException && err.name === 'QuotaExceededError') {\n        console.warn(\n          `[mvc-kit] QuotaExceededError writing to \"${this.storageKey}\". ` +\n            `Consider using IndexedDBCollection for larger datasets.`,\n        );\n      }\n      throw err;\n    }\n  }\n\n  protected persistClear(): void {\n    this._storage.removeItem(this.storageKey);\n  }\n}\n"],"names":["PersistentCollection"],"mappings":";;;AAEA,MAAM,UAAU,OAAO,oBAAoB,eAAe;AAcnD,MAAe,6BAEZA,qBAAAA,qBAAwB;AAAA;AAAA,EAEhC,OAAO,UAA+B;AAAA,EAE9B,gBAAgB;AAAA,EAExB,IAAY,WAAoB;AAC9B,WAAQ,KAAK,YAA4C,YAAY,YACjE,iBACA;AAAA,EACN;AAAA,EAEQ,kBAAwB;AAC9B,QAAI,KAAK,cAAe;AACxB,SAAK,gBAAgB;AACrB,SAAK,aAAA;AAAA,EACP;AAAA;AAAA,EAIA,IAAI,QAAa;AACf,SAAK,gBAAA;AACL,WAAO,MAAM;AAAA,EACf;AAAA,EAEA,IAAI,QAAa;AACf,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,SAAiB;AACnB,SAAK,gBAAA;AACL,WAAO,MAAM;AAAA,EACf;AAAA,EAEA,IAAI,IAA4B;AAC9B,SAAK,gBAAA;AACL,WAAO,MAAM,IAAI,EAAE;AAAA,EACrB;AAAA,EAEA,IAAI,IAAsB;AACxB,SAAK,gBAAA;AACL,WAAO,MAAM,IAAI,EAAE;AAAA,EACrB;AAAA;AAAA,EAIU,gBAAqB;AAC7B,UAAM,MAAM,KAAK,SAAS,QAAQ,KAAK,UAAU;AACjD,QAAI,CAAC,IAAK,QAAO,CAAA;AACjB,QAAI;AACF,aAAO,KAAK,YAAY,GAAG;AAAA,IAC7B,QAAQ;AACN,UAAI,SAAS;AACX,gBAAQ;AAAA,UACN,4CAA4C,KAAK,UAAU;AAAA,QAAA;AAAA,MAE/D;AACA,aAAO,CAAA;AAAA,IACT;AAAA,EACF;AAAA,EAEU,WAAW,IAAuB;AAC1C,UAAM,MAAM,KAAK,cAAA;AACjB,WAAO,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK;AAAA,EACzC;AAAA,EAEU,WAAW,QAAmB;AACtC,QAAI;AACF,WAAK,SAAS,QAAQ,KAAK,YAAY,KAAK,UAAU,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;AAAA,IACxE,SAAS,KAAK;AACZ,UAAI,WAAW,eAAe,gBAAgB,IAAI,SAAS,sBAAsB;AAC/E,gBAAQ;AAAA,UACN,4CAA4C,KAAK,UAAU;AAAA,QAAA;AAAA,MAG/D;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEU,cAAc,MAAuB;AAC7C,QAAI;AACF,WAAK,SAAS,QAAQ,KAAK,YAAY,KAAK,UAAU,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;AAAA,IACxE,SAAS,KAAK;AACZ,UAAI,WAAW,eAAe,gBAAgB,IAAI,SAAS,sBAAsB;AAC/E,gBAAQ;AAAA,UACN,4CAA4C,KAAK,UAAU;AAAA,QAAA;AAAA,MAG/D;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEU,eAAqB;AAC7B,SAAK,SAAS,WAAW,KAAK,UAAU;AAAA,EAC1C;AACF;;"}
+{"version":3,"file":"WebStorageCollection.cjs","names":[],"sources":["../../src/web/WebStorageCollection.ts"],"sourcesContent":["import { PersistentCollection } from '../PersistentCollection';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n/**\n * PersistentCollection backed by localStorage or sessionStorage.\n * Auto-hydrates on first access (sync storage — no need for manual `hydrate()` call).\n *\n * Uses blob strategy: all items stored as a single JSON string under `storageKey`.\n *\n * ```ts\n * class CartCollection extends WebStorageCollection<CartItem> {\n *   protected readonly storageKey = 'cart';\n * }\n * ```\n */\nexport abstract class WebStorageCollection<\n  T extends { id: string | number },\n> extends PersistentCollection<T> {\n  /** Which Web Storage backend to use. Override to 'session' for sessionStorage. */\n  static STORAGE: 'local' | 'session' = 'local';\n\n  private _autoHydrated = false;\n\n  private get _storage(): Storage {\n    return (this.constructor as typeof WebStorageCollection).STORAGE === 'session'\n      ? sessionStorage\n      : localStorage;\n  }\n\n  private _ensureHydrated(): void {\n    if (this._autoHydrated) return;\n    this._autoHydrated = true;\n    this._hydrateSync();\n  }\n\n  // ── Override access points to trigger lazy hydration ──\n\n  get items(): T[] {\n    this._ensureHydrated();\n    return super.items;\n  }\n\n  get state(): T[] {\n    return this.items;\n  }\n\n  get length(): number {\n    this._ensureHydrated();\n    return super.length;\n  }\n\n  get(id: T['id']): T | undefined {\n    this._ensureHydrated();\n    return super.get(id);\n  }\n\n  has(id: T['id']): boolean {\n    this._ensureHydrated();\n    return super.has(id);\n  }\n\n  // ── Persist interface (blob strategy) ──\n\n  protected persistGetAll(): T[] {\n    const raw = this._storage.getItem(this.storageKey);\n    if (!raw) return [];\n    try {\n      return this.deserialize(raw);\n    } catch {\n      if (__DEV__) {\n        console.warn(\n          `[mvc-kit] Corrupted data in storage key \"${this.storageKey}\". Ignoring stored data.`,\n        );\n      }\n      return [];\n    }\n  }\n\n  protected persistGet(id: T['id']): T | null {\n    const all = this.persistGetAll();\n    return all.find((i) => i.id === id) ?? null;\n  }\n\n  protected persistSet(_items: T[]): void {\n    try {\n      this._storage.setItem(this.storageKey, this.serialize([...this.items]));\n    } catch (err) {\n      if (__DEV__ && err instanceof DOMException && err.name === 'QuotaExceededError') {\n        console.warn(\n          `[mvc-kit] QuotaExceededError writing to \"${this.storageKey}\". ` +\n            `Consider using IndexedDBCollection for larger datasets.`,\n        );\n      }\n      throw err;\n    }\n  }\n\n  protected persistRemove(_ids: T['id'][]): void {\n    try {\n      this._storage.setItem(this.storageKey, this.serialize([...this.items]));\n    } catch (err) {\n      if (__DEV__ && err instanceof DOMException && err.name === 'QuotaExceededError') {\n        console.warn(\n          `[mvc-kit] QuotaExceededError writing to \"${this.storageKey}\". ` +\n            `Consider using IndexedDBCollection for larger datasets.`,\n        );\n      }\n      throw err;\n    }\n  }\n\n  protected persistClear(): void {\n    this._storage.removeItem(this.storageKey);\n  }\n}\n"],"mappings":";;AAEA,IAAM,UAAU,OAAO,oBAAoB,eAAe;;;;;;;;;;;;;AAc1D,IAAsB,uBAAtB,cAEU,6BAAA,qBAAwB;;CAEhC,OAAO,UAA+B;CAEtC,gBAAwB;CAExB,IAAY,WAAoB;AAC9B,SAAQ,KAAK,YAA4C,YAAY,YACjE,iBACA;;CAGN,kBAAgC;AAC9B,MAAI,KAAK,cAAe;AACxB,OAAK,gBAAgB;AACrB,OAAK,cAAc;;CAKrB,IAAI,QAAa;AACf,OAAK,iBAAiB;AACtB,SAAO,MAAM;;CAGf,IAAI,QAAa;AACf,SAAO,KAAK;;CAGd,IAAI,SAAiB;AACnB,OAAK,iBAAiB;AACtB,SAAO,MAAM;;CAGf,IAAI,IAA4B;AAC9B,OAAK,iBAAiB;AACtB,SAAO,MAAM,IAAI,GAAG;;CAGtB,IAAI,IAAsB;AACxB,OAAK,iBAAiB;AACtB,SAAO,MAAM,IAAI,GAAG;;CAKtB,gBAA+B;EAC7B,MAAM,MAAM,KAAK,SAAS,QAAQ,KAAK,WAAW;AAClD,MAAI,CAAC,IAAK,QAAO,EAAE;AACnB,MAAI;AACF,UAAO,KAAK,YAAY,IAAI;UACtB;AACN,OAAI,QACF,SAAQ,KACN,4CAA4C,KAAK,WAAW,0BAC7D;AAEH,UAAO,EAAE;;;CAIb,WAAqB,IAAuB;AAE1C,SADY,KAAK,eAAe,CACrB,MAAM,MAAM,EAAE,OAAO,GAAG,IAAI;;CAGzC,WAAqB,QAAmB;AACtC,MAAI;AACF,QAAK,SAAS,QAAQ,KAAK,YAAY,KAAK,UAAU,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC;WAChE,KAAK;AACZ,OAAI,WAAW,eAAe,gBAAgB,IAAI,SAAS,qBACzD,SAAQ,KACN,4CAA4C,KAAK,WAAW,4DAE7D;AAEH,SAAM;;;CAIV,cAAwB,MAAuB;AAC7C,MAAI;AACF,QAAK,SAAS,QAAQ,KAAK,YAAY,KAAK,UAAU,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC;WAChE,KAAK;AACZ,OAAI,WAAW,eAAe,gBAAgB,IAAI,SAAS,qBACzD,SAAQ,KACN,4CAA4C,KAAK,WAAW,4DAE7D;AAEH,SAAM;;;CAIV,eAA+B;AAC7B,OAAK,SAAS,WAAW,KAAK,WAAW"}

package/dist/web/WebStorageCollection.js

@@ -1,85 +1,83 @@
 import { PersistentCollection } from "../PersistentCollection.js";
-const __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
-class WebStorageCollection extends PersistentCollection {
-  /** Which Web Storage backend to use. Override to 'session' for sessionStorage. */
-  static STORAGE = "local";
-  _autoHydrated = false;
-  get _storage() {
-    return this.constructor.STORAGE === "session" ? sessionStorage : localStorage;
-  }
-  _ensureHydrated() {
-    if (this._autoHydrated) return;
-    this._autoHydrated = true;
-    this._hydrateSync();
-  }
-  // ── Override access points to trigger lazy hydration ──
-  get items() {
-    this._ensureHydrated();
-    return super.items;
-  }
-  get state() {
-    return this.items;
-  }
-  get length() {
-    this._ensureHydrated();
-    return super.length;
-  }
-  get(id) {
-    this._ensureHydrated();
-    return super.get(id);
-  }
-  has(id) {
-    this._ensureHydrated();
-    return super.has(id);
-  }
-  // ── Persist interface (blob strategy) ──
-  persistGetAll() {
-    const raw = this._storage.getItem(this.storageKey);
-    if (!raw) return [];
-    try {
-      return this.deserialize(raw);
-    } catch {
-      if (__DEV__) {
-        console.warn(
-          `[mvc-kit] Corrupted data in storage key "${this.storageKey}". Ignoring stored data.`
-        );
-      }
-      return [];
-    }
-  }
-  persistGet(id) {
-    const all = this.persistGetAll();
-    return all.find((i) => i.id === id) ?? null;
-  }
-  persistSet(_items) {
-    try {
-      this._storage.setItem(this.storageKey, this.serialize([...this.items]));
-    } catch (err) {
-      if (__DEV__ && err instanceof DOMException && err.name === "QuotaExceededError") {
-        console.warn(
-          `[mvc-kit] QuotaExceededError writing to "${this.storageKey}". Consider using IndexedDBCollection for larger datasets.`
-        );
-      }
-      throw err;
-    }
-  }
-  persistRemove(_ids) {
-    try {
-      this._storage.setItem(this.storageKey, this.serialize([...this.items]));
-    } catch (err) {
-      if (__DEV__ && err instanceof DOMException && err.name === "QuotaExceededError") {
-        console.warn(
-          `[mvc-kit] QuotaExceededError writing to "${this.storageKey}". Consider using IndexedDBCollection for larger datasets.`
-        );
-      }
-      throw err;
-    }
-  }
-  persistClear() {
-    this._storage.removeItem(this.storageKey);
-  }
-}
-export {
-  WebStorageCollection
+//#region src/web/WebStorageCollection.ts
+var __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
+/**
+* PersistentCollection backed by localStorage or sessionStorage.
+* Auto-hydrates on first access (sync storage — no need for manual `hydrate()` call).
+*
+* Uses blob strategy: all items stored as a single JSON string under `storageKey`.
+*
+* ```ts
+* class CartCollection extends WebStorageCollection<CartItem> {
+*   protected readonly storageKey = 'cart';
+* }
+* ```
+*/
+var WebStorageCollection = class extends PersistentCollection {
+	/** Which Web Storage backend to use. Override to 'session' for sessionStorage. */
+	static STORAGE = "local";
+	_autoHydrated = false;
+	get _storage() {
+		return this.constructor.STORAGE === "session" ? sessionStorage : localStorage;
+	}
+	_ensureHydrated() {
+		if (this._autoHydrated) return;
+		this._autoHydrated = true;
+		this._hydrateSync();
+	}
+	get items() {
+		this._ensureHydrated();
+		return super.items;
+	}
+	get state() {
+		return this.items;
+	}
+	get length() {
+		this._ensureHydrated();
+		return super.length;
+	}
+	get(id) {
+		this._ensureHydrated();
+		return super.get(id);
+	}
+	has(id) {
+		this._ensureHydrated();
+		return super.has(id);
+	}
+	persistGetAll() {
+		const raw = this._storage.getItem(this.storageKey);
+		if (!raw) return [];
+		try {
+			return this.deserialize(raw);
+		} catch {
+			if (__DEV__) console.warn(`[mvc-kit] Corrupted data in storage key "${this.storageKey}". Ignoring stored data.`);
+			return [];
+		}
+	}
+	persistGet(id) {
+		return this.persistGetAll().find((i) => i.id === id) ?? null;
+	}
+	persistSet(_items) {
+		try {
+			this._storage.setItem(this.storageKey, this.serialize([...this.items]));
+		} catch (err) {
+			if (__DEV__ && err instanceof DOMException && err.name === "QuotaExceededError") console.warn(`[mvc-kit] QuotaExceededError writing to "${this.storageKey}". Consider using IndexedDBCollection for larger datasets.`);
+			throw err;
+		}
+	}
+	persistRemove(_ids) {
+		try {
+			this._storage.setItem(this.storageKey, this.serialize([...this.items]));
+		} catch (err) {
+			if (__DEV__ && err instanceof DOMException && err.name === "QuotaExceededError") console.warn(`[mvc-kit] QuotaExceededError writing to "${this.storageKey}". Consider using IndexedDBCollection for larger datasets.`);
+			throw err;
+		}
+	}
+	persistClear() {
+		this._storage.removeItem(this.storageKey);
+	}
 };
-//# sourceMappingURL=WebStorageCollection.js.map
+//#endregion
+export { WebStorageCollection };
+
+//# sourceMappingURL=WebStorageCollection.js.map

package/dist/web/WebStorageCollection.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebStorageCollection.js","sources":["../../src/web/WebStorageCollection.ts"],"sourcesContent":["import { PersistentCollection } from '../PersistentCollection';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n/**\n * PersistentCollection backed by localStorage or sessionStorage.\n * Auto-hydrates on first access (sync storage — no need for manual `hydrate()` call).\n *\n * Uses blob strategy: all items stored as a single JSON string under `storageKey`.\n *\n * ```ts\n * class CartCollection extends WebStorageCollection<CartItem> {\n *   protected readonly storageKey = 'cart';\n * }\n * ```\n */\nexport abstract class WebStorageCollection<\n  T extends { id: string | number },\n> extends PersistentCollection<T> {\n  /** Which Web Storage backend to use. Override to 'session' for sessionStorage. */\n  static STORAGE: 'local' | 'session' = 'local';\n\n  private _autoHydrated = false;\n\n  private get _storage(): Storage {\n    return (this.constructor as typeof WebStorageCollection).STORAGE === 'session'\n      ? sessionStorage\n      : localStorage;\n  }\n\n  private _ensureHydrated(): void {\n    if (this._autoHydrated) return;\n    this._autoHydrated = true;\n    this._hydrateSync();\n  }\n\n  // ── Override access points to trigger lazy hydration ──\n\n  get items(): T[] {\n    this._ensureHydrated();\n    return super.items;\n  }\n\n  get state(): T[] {\n    return this.items;\n  }\n\n  get length(): number {\n    this._ensureHydrated();\n    return super.length;\n  }\n\n  get(id: T['id']): T | undefined {\n    this._ensureHydrated();\n    return super.get(id);\n  }\n\n  has(id: T['id']): boolean {\n    this._ensureHydrated();\n    return super.has(id);\n  }\n\n  // ── Persist interface (blob strategy) ──\n\n  protected persistGetAll(): T[] {\n    const raw = this._storage.getItem(this.storageKey);\n    if (!raw) return [];\n    try {\n      return this.deserialize(raw);\n    } catch {\n      if (__DEV__) {\n        console.warn(\n          `[mvc-kit] Corrupted data in storage key \"${this.storageKey}\". Ignoring stored data.`,\n        );\n      }\n      return [];\n    }\n  }\n\n  protected persistGet(id: T['id']): T | null {\n    const all = this.persistGetAll();\n    return all.find((i) => i.id === id) ?? null;\n  }\n\n  protected persistSet(_items: T[]): void {\n    try {\n      this._storage.setItem(this.storageKey, this.serialize([...this.items]));\n    } catch (err) {\n      if (__DEV__ && err instanceof DOMException && err.name === 'QuotaExceededError') {\n        console.warn(\n          `[mvc-kit] QuotaExceededError writing to \"${this.storageKey}\". ` +\n            `Consider using IndexedDBCollection for larger datasets.`,\n        );\n      }\n      throw err;\n    }\n  }\n\n  protected persistRemove(_ids: T['id'][]): void {\n    try {\n      this._storage.setItem(this.storageKey, this.serialize([...this.items]));\n    } catch (err) {\n      if (__DEV__ && err instanceof DOMException && err.name === 'QuotaExceededError') {\n        console.warn(\n          `[mvc-kit] QuotaExceededError writing to \"${this.storageKey}\". ` +\n            `Consider using IndexedDBCollection for larger datasets.`,\n        );\n      }\n      throw err;\n    }\n  }\n\n  protected persistClear(): void {\n    this._storage.removeItem(this.storageKey);\n  }\n}\n"],"names":[],"mappings":";AAEA,MAAM,UAAU,OAAO,oBAAoB,eAAe;AAcnD,MAAe,6BAEZ,qBAAwB;AAAA;AAAA,EAEhC,OAAO,UAA+B;AAAA,EAE9B,gBAAgB;AAAA,EAExB,IAAY,WAAoB;AAC9B,WAAQ,KAAK,YAA4C,YAAY,YACjE,iBACA;AAAA,EACN;AAAA,EAEQ,kBAAwB;AAC9B,QAAI,KAAK,cAAe;AACxB,SAAK,gBAAgB;AACrB,SAAK,aAAA;AAAA,EACP;AAAA;AAAA,EAIA,IAAI,QAAa;AACf,SAAK,gBAAA;AACL,WAAO,MAAM;AAAA,EACf;AAAA,EAEA,IAAI,QAAa;AACf,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,SAAiB;AACnB,SAAK,gBAAA;AACL,WAAO,MAAM;AAAA,EACf;AAAA,EAEA,IAAI,IAA4B;AAC9B,SAAK,gBAAA;AACL,WAAO,MAAM,IAAI,EAAE;AAAA,EACrB;AAAA,EAEA,IAAI,IAAsB;AACxB,SAAK,gBAAA;AACL,WAAO,MAAM,IAAI,EAAE;AAAA,EACrB;AAAA;AAAA,EAIU,gBAAqB;AAC7B,UAAM,MAAM,KAAK,SAAS,QAAQ,KAAK,UAAU;AACjD,QAAI,CAAC,IAAK,QAAO,CAAA;AACjB,QAAI;AACF,aAAO,KAAK,YAAY,GAAG;AAAA,IAC7B,QAAQ;AACN,UAAI,SAAS;AACX,gBAAQ;AAAA,UACN,4CAA4C,KAAK,UAAU;AAAA,QAAA;AAAA,MAE/D;AACA,aAAO,CAAA;AAAA,IACT;AAAA,EACF;AAAA,EAEU,WAAW,IAAuB;AAC1C,UAAM,MAAM,KAAK,cAAA;AACjB,WAAO,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK;AAAA,EACzC;AAAA,EAEU,WAAW,QAAmB;AACtC,QAAI;AACF,WAAK,SAAS,QAAQ,KAAK,YAAY,KAAK,UAAU,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;AAAA,IACxE,SAAS,KAAK;AACZ,UAAI,WAAW,eAAe,gBAAgB,IAAI,SAAS,sBAAsB;AAC/E,gBAAQ;AAAA,UACN,4CAA4C,KAAK,UAAU;AAAA,QAAA;AAAA,MAG/D;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEU,cAAc,MAAuB;AAC7C,QAAI;AACF,WAAK,SAAS,QAAQ,KAAK,YAAY,KAAK,UAAU,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;AAAA,IACxE,SAAS,KAAK;AACZ,UAAI,WAAW,eAAe,gBAAgB,IAAI,SAAS,sBAAsB;AAC/E,gBAAQ;AAAA,UACN,4CAA4C,KAAK,UAAU;AAAA,QAAA;AAAA,MAG/D;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEU,eAAqB;AAC7B,SAAK,SAAS,WAAW,KAAK,UAAU;AAAA,EAC1C;AACF;"}
+{"version":3,"file":"WebStorageCollection.js","names":[],"sources":["../../src/web/WebStorageCollection.ts"],"sourcesContent":["import { PersistentCollection } from '../PersistentCollection';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n/**\n * PersistentCollection backed by localStorage or sessionStorage.\n * Auto-hydrates on first access (sync storage — no need for manual `hydrate()` call).\n *\n * Uses blob strategy: all items stored as a single JSON string under `storageKey`.\n *\n * ```ts\n * class CartCollection extends WebStorageCollection<CartItem> {\n *   protected readonly storageKey = 'cart';\n * }\n * ```\n */\nexport abstract class WebStorageCollection<\n  T extends { id: string | number },\n> extends PersistentCollection<T> {\n  /** Which Web Storage backend to use. Override to 'session' for sessionStorage. */\n  static STORAGE: 'local' | 'session' = 'local';\n\n  private _autoHydrated = false;\n\n  private get _storage(): Storage {\n    return (this.constructor as typeof WebStorageCollection).STORAGE === 'session'\n      ? sessionStorage\n      : localStorage;\n  }\n\n  private _ensureHydrated(): void {\n    if (this._autoHydrated) return;\n    this._autoHydrated = true;\n    this._hydrateSync();\n  }\n\n  // ── Override access points to trigger lazy hydration ──\n\n  get items(): T[] {\n    this._ensureHydrated();\n    return super.items;\n  }\n\n  get state(): T[] {\n    return this.items;\n  }\n\n  get length(): number {\n    this._ensureHydrated();\n    return super.length;\n  }\n\n  get(id: T['id']): T | undefined {\n    this._ensureHydrated();\n    return super.get(id);\n  }\n\n  has(id: T['id']): boolean {\n    this._ensureHydrated();\n    return super.has(id);\n  }\n\n  // ── Persist interface (blob strategy) ──\n\n  protected persistGetAll(): T[] {\n    const raw = this._storage.getItem(this.storageKey);\n    if (!raw) return [];\n    try {\n      return this.deserialize(raw);\n    } catch {\n      if (__DEV__) {\n        console.warn(\n          `[mvc-kit] Corrupted data in storage key \"${this.storageKey}\". Ignoring stored data.`,\n        );\n      }\n      return [];\n    }\n  }\n\n  protected persistGet(id: T['id']): T | null {\n    const all = this.persistGetAll();\n    return all.find((i) => i.id === id) ?? null;\n  }\n\n  protected persistSet(_items: T[]): void {\n    try {\n      this._storage.setItem(this.storageKey, this.serialize([...this.items]));\n    } catch (err) {\n      if (__DEV__ && err instanceof DOMException && err.name === 'QuotaExceededError') {\n        console.warn(\n          `[mvc-kit] QuotaExceededError writing to \"${this.storageKey}\". ` +\n            `Consider using IndexedDBCollection for larger datasets.`,\n        );\n      }\n      throw err;\n    }\n  }\n\n  protected persistRemove(_ids: T['id'][]): void {\n    try {\n      this._storage.setItem(this.storageKey, this.serialize([...this.items]));\n    } catch (err) {\n      if (__DEV__ && err instanceof DOMException && err.name === 'QuotaExceededError') {\n        console.warn(\n          `[mvc-kit] QuotaExceededError writing to \"${this.storageKey}\". ` +\n            `Consider using IndexedDBCollection for larger datasets.`,\n        );\n      }\n      throw err;\n    }\n  }\n\n  protected persistClear(): void {\n    this._storage.removeItem(this.storageKey);\n  }\n}\n"],"mappings":";;AAEA,IAAM,UAAU,OAAO,oBAAoB,eAAe;;;;;;;;;;;;;AAc1D,IAAsB,uBAAtB,cAEU,qBAAwB;;CAEhC,OAAO,UAA+B;CAEtC,gBAAwB;CAExB,IAAY,WAAoB;AAC9B,SAAQ,KAAK,YAA4C,YAAY,YACjE,iBACA;;CAGN,kBAAgC;AAC9B,MAAI,KAAK,cAAe;AACxB,OAAK,gBAAgB;AACrB,OAAK,cAAc;;CAKrB,IAAI,QAAa;AACf,OAAK,iBAAiB;AACtB,SAAO,MAAM;;CAGf,IAAI,QAAa;AACf,SAAO,KAAK;;CAGd,IAAI,SAAiB;AACnB,OAAK,iBAAiB;AACtB,SAAO,MAAM;;CAGf,IAAI,IAA4B;AAC9B,OAAK,iBAAiB;AACtB,SAAO,MAAM,IAAI,GAAG;;CAGtB,IAAI,IAAsB;AACxB,OAAK,iBAAiB;AACtB,SAAO,MAAM,IAAI,GAAG;;CAKtB,gBAA+B;EAC7B,MAAM,MAAM,KAAK,SAAS,QAAQ,KAAK,WAAW;AAClD,MAAI,CAAC,IAAK,QAAO,EAAE;AACnB,MAAI;AACF,UAAO,KAAK,YAAY,IAAI;UACtB;AACN,OAAI,QACF,SAAQ,KACN,4CAA4C,KAAK,WAAW,0BAC7D;AAEH,UAAO,EAAE;;;CAIb,WAAqB,IAAuB;AAE1C,SADY,KAAK,eAAe,CACrB,MAAM,MAAM,EAAE,OAAO,GAAG,IAAI;;CAGzC,WAAqB,QAAmB;AACtC,MAAI;AACF,QAAK,SAAS,QAAQ,KAAK,YAAY,KAAK,UAAU,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC;WAChE,KAAK;AACZ,OAAI,WAAW,eAAe,gBAAgB,IAAI,SAAS,qBACzD,SAAQ,KACN,4CAA4C,KAAK,WAAW,4DAE7D;AAEH,SAAM;;;CAIV,cAAwB,MAAuB;AAC7C,MAAI;AACF,QAAK,SAAS,QAAQ,KAAK,YAAY,KAAK,UAAU,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC;WAChE,KAAK;AACZ,OAAI,WAAW,eAAe,gBAAgB,IAAI,SAAS,qBACzD,SAAQ,KACN,4CAA4C,KAAK,WAAW,4DAE7D;AAEH,SAAM;;;CAIV,eAA+B;AAC7B,OAAK,SAAS,WAAW,KAAK,WAAW"}

package/dist/web/idb.cjs

@@ -1,121 +1,129 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const _connections = /* @__PURE__ */ new Map();
-const _stores = /* @__PURE__ */ new Map();
-let _openQueue = Promise.resolve();
+//#region src/web/idb.ts
+/**
+* Shared IndexedDB connection manager.
+* Deduplicates indexedDB.open() calls and handles dynamic object store creation
+* by bumping the DB version when a new storageKey is encountered.
+*/
+var _connections = /* @__PURE__ */ new Map();
+var _stores = /* @__PURE__ */ new Map();
+var _openQueue = Promise.resolve();
 function openDB(dbName, storeName) {
-  const existing = _connections.get(dbName);
-  if (existing) {
-    if (existing.objectStoreNames.contains(storeName)) {
-      return Promise.resolve(existing);
-    }
-    existing.close();
-    _connections.delete(dbName);
-  }
-  let stores = _stores.get(dbName);
-  if (!stores) {
-    stores = /* @__PURE__ */ new Set();
-    _stores.set(dbName, stores);
-  }
-  stores.add(storeName);
-  const result = _openQueue.then(() => doOpen(dbName, stores));
-  _openQueue = result.then(() => {
-  }, () => {
-  });
-  return result;
+	const existing = _connections.get(dbName);
+	if (existing) {
+		if (existing.objectStoreNames.contains(storeName)) return Promise.resolve(existing);
+		existing.close();
+		_connections.delete(dbName);
+	}
+	let stores = _stores.get(dbName);
+	if (!stores) {
+		stores = /* @__PURE__ */ new Set();
+		_stores.set(dbName, stores);
+	}
+	stores.add(storeName);
+	const result = _openQueue.then(() => doOpen(dbName, stores));
+	_openQueue = result.then(() => {}, () => {});
+	return result;
 }
 function doOpen(dbName, stores) {
-  const existingDb = _connections.get(dbName);
-  existingDb?.close();
-  _connections.delete(dbName);
-  return new Promise((resolve, reject) => {
-    const probe = indexedDB.open(dbName);
-    probe.onsuccess = () => {
-      const db = probe.result;
-      const version = db.version;
-      let needsUpgrade = false;
-      for (const name of stores) {
-        if (!db.objectStoreNames.contains(name)) {
-          needsUpgrade = true;
-          break;
-        }
-      }
-      if (!needsUpgrade) {
-        _connections.set(dbName, db);
-        resolve(db);
-        return;
-      }
-      db.close();
-      const upgrade = indexedDB.open(dbName, version + 1);
-      upgrade.onupgradeneeded = () => {
-        const udb = upgrade.result;
-        for (const name of stores) {
-          if (!udb.objectStoreNames.contains(name)) {
-            udb.createObjectStore(name, { keyPath: "id" });
-          }
-        }
-      };
-      upgrade.onsuccess = () => {
-        _connections.set(dbName, upgrade.result);
-        resolve(upgrade.result);
-      };
-      upgrade.onerror = () => reject(upgrade.error);
-    };
-    probe.onerror = () => reject(probe.error);
-  });
+	_connections.get(dbName)?.close();
+	_connections.delete(dbName);
+	return new Promise((resolve, reject) => {
+		const probe = indexedDB.open(dbName);
+		probe.onsuccess = () => {
+			const db = probe.result;
+			const version = db.version;
+			let needsUpgrade = false;
+			for (const name of stores) if (!db.objectStoreNames.contains(name)) {
+				needsUpgrade = true;
+				break;
+			}
+			if (!needsUpgrade) {
+				_connections.set(dbName, db);
+				resolve(db);
+				return;
+			}
+			db.close();
+			const upgrade = indexedDB.open(dbName, version + 1);
+			upgrade.onupgradeneeded = () => {
+				const udb = upgrade.result;
+				for (const name of stores) if (!udb.objectStoreNames.contains(name)) udb.createObjectStore(name, { keyPath: "id" });
+			};
+			upgrade.onsuccess = () => {
+				_connections.set(dbName, upgrade.result);
+				resolve(upgrade.result);
+			};
+			upgrade.onerror = () => reject(upgrade.error);
+		};
+		probe.onerror = () => reject(probe.error);
+	});
 }
+/**
+* Open a transaction and return the object store for the given database and store name.
+*/
 function getStore(dbName, storeName, mode) {
-  return openDB(dbName, storeName).then((db) => {
-    const tx = db.transaction(storeName, mode);
-    return tx.objectStore(storeName);
-  });
+	return openDB(dbName, storeName).then((db) => {
+		return db.transaction(storeName, mode).objectStore(storeName);
+	});
 }
+/**
+* Retrieve all items from an IndexedDB object store.
+*/
 function idbGetAll(store) {
-  return new Promise((resolve, reject) => {
-    const request = store.getAll();
-    request.onsuccess = () => resolve(request.result);
-    request.onerror = () => reject(request.error);
-  });
+	return new Promise((resolve, reject) => {
+		const request = store.getAll();
+		request.onsuccess = () => resolve(request.result);
+		request.onerror = () => reject(request.error);
+	});
 }
+/**
+* Retrieve a single item by key from an IndexedDB object store.
+*/
 function idbGet(store, id) {
-  return new Promise((resolve, reject) => {
-    const request = store.get(id);
-    request.onsuccess = () => resolve(request.result ?? null);
-    request.onerror = () => reject(request.error);
-  });
+	return new Promise((resolve, reject) => {
+		const request = store.get(id);
+		request.onsuccess = () => resolve(request.result ?? null);
+		request.onerror = () => reject(request.error);
+	});
 }
+/**
+* Write (put) multiple items into an IndexedDB object store.
+*/
 function idbPut(store, items) {
-  return new Promise((resolve, reject) => {
-    const tx = store.transaction;
-    for (const item of items) {
-      store.put(item);
-    }
-    tx.oncomplete = () => resolve();
-    tx.onerror = () => reject(tx.error);
-  });
+	return new Promise((resolve, reject) => {
+		const tx = store.transaction;
+		for (const item of items) store.put(item);
+		tx.oncomplete = () => resolve();
+		tx.onerror = () => reject(tx.error);
+	});
 }
+/**
+* Delete multiple items by key from an IndexedDB object store.
+*/
 function idbDelete(store, ids) {
-  return new Promise((resolve, reject) => {
-    const tx = store.transaction;
-    for (const id of ids) {
-      store.delete(id);
-    }
-    tx.oncomplete = () => resolve();
-    tx.onerror = () => reject(tx.error);
-  });
+	return new Promise((resolve, reject) => {
+		const tx = store.transaction;
+		for (const id of ids) store.delete(id);
+		tx.oncomplete = () => resolve();
+		tx.onerror = () => reject(tx.error);
+	});
 }
+/**
+* Clear all items from an IndexedDB object store.
+*/
 function idbClear(store) {
-  return new Promise((resolve, reject) => {
-    const tx = store.transaction;
-    store.clear();
-    tx.oncomplete = () => resolve();
-    tx.onerror = () => reject(tx.error);
-  });
+	return new Promise((resolve, reject) => {
+		const tx = store.transaction;
+		store.clear();
+		tx.oncomplete = () => resolve();
+		tx.onerror = () => reject(tx.error);
+	});
 }
+//#endregion
 exports.getStore = getStore;
 exports.idbClear = idbClear;
 exports.idbDelete = idbDelete;
 exports.idbGet = idbGet;
 exports.idbGetAll = idbGetAll;
 exports.idbPut = idbPut;
-//# sourceMappingURL=idb.cjs.map
+
+//# sourceMappingURL=idb.cjs.map