mvc-kit 2.5.2 → 2.5.4

package/dist/web/IndexedDBCollection.cjs

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const PersistentCollection = require("../PersistentCollection.cjs");
+const idb = require("./idb.cjs");
+class IndexedDBCollection extends PersistentCollection.PersistentCollection {
+  /** IndexedDB database name. Override to use a separate database. */
+  static DB_NAME = "mvc-kit";
+  get _dbName() {
+    return this.constructor.DB_NAME;
+  }
+  _getStore(mode) {
+    return idb.getStore(this._dbName, this.storageKey, mode);
+  }
+  // ── Persist interface (per-item strategy) ──
+  async persistGetAll() {
+    const store = await this._getStore("readonly");
+    return idb.idbGetAll(store);
+  }
+  async persistGet(id) {
+    const store = await this._getStore("readonly");
+    return idb.idbGet(store, id);
+  }
+  async persistSet(items) {
+    const store = await this._getStore("readwrite");
+    return idb.idbPut(store, items);
+  }
+  async persistRemove(ids) {
+    const store = await this._getStore("readwrite");
+    return idb.idbDelete(store, ids);
+  }
+  async persistClear() {
+    const store = await this._getStore("readwrite");
+    return idb.idbClear(store);
+  }
+}
+exports.IndexedDBCollection = IndexedDBCollection;
+//# sourceMappingURL=IndexedDBCollection.cjs.map

package/dist/web/IndexedDBCollection.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDBCollection.cjs","sources":["../../src/web/IndexedDBCollection.ts"],"sourcesContent":["import { PersistentCollection } from '../PersistentCollection';\nimport { getStore, idbGetAll, idbGet, idbPut, idbDelete, idbClear } from './idb';\n\n/**\n * PersistentCollection backed by IndexedDB. Stores items individually by `id`\n * in a dedicated object store (named by `storageKey`).\n *\n * **Requires manual `hydrate()` call** (async storage).\n * Typically called in ViewModel's `onInit()`.\n *\n * Uses per-item strategy: each item is stored as a separate entry in the object store.\n * No JSON serialization needed — IndexedDB uses structured cloning.\n *\n * ```ts\n * class MessagesCollection extends IndexedDBCollection<Message> {\n *   protected readonly storageKey = 'messages';\n * }\n *\n * // In ViewModel:\n * async onInit() {\n *   await this.collection.hydrate();\n *   if (this.collection.length === 0) this.load();\n * }\n * ```\n */\nexport abstract class IndexedDBCollection<\n  T extends { id: string | number },\n> extends PersistentCollection<T> {\n  /** IndexedDB database name. Override to use a separate database. */\n  static DB_NAME = 'mvc-kit';\n\n  private get _dbName(): string {\n    return (this.constructor as typeof IndexedDBCollection).DB_NAME;\n  }\n\n  private _getStore(mode: IDBTransactionMode) {\n    return getStore(this._dbName, this.storageKey, mode);\n  }\n\n  // ── Persist interface (per-item strategy) ──\n\n  protected async persistGetAll(): Promise<T[]> {\n    const store = await this._getStore('readonly');\n    return idbGetAll<T>(store);\n  }\n\n  protected async persistGet(id: T['id']): Promise<T | null> {\n    const store = await this._getStore('readonly');\n    return idbGet<T>(store, id as IDBValidKey);\n  }\n\n  protected async persistSet(items: T[]): Promise<void> {\n    const store = await this._getStore('readwrite');\n    return idbPut(store, items);\n  }\n\n  protected async persistRemove(ids: T['id'][]): Promise<void> {\n    const store = await this._getStore('readwrite');\n    return idbDelete(store, ids as IDBValidKey[]);\n  }\n\n  protected async persistClear(): Promise<void> {\n    const store = await this._getStore('readwrite');\n    return idbClear(store);\n  }\n}\n"],"names":["PersistentCollection","getStore","idbGetAll","idbGet","idbPut","idbDelete","idbClear"],"mappings":";;;;AAyBO,MAAe,4BAEZA,qBAAAA,qBAAwB;AAAA;AAAA,EAEhC,OAAO,UAAU;AAAA,EAEjB,IAAY,UAAkB;AAC5B,WAAQ,KAAK,YAA2C;AAAA,EAC1D;AAAA,EAEQ,UAAU,MAA0B;AAC1C,WAAOC,IAAAA,SAAS,KAAK,SAAS,KAAK,YAAY,IAAI;AAAA,EACrD;AAAA;AAAA,EAIA,MAAgB,gBAA8B;AAC5C,UAAM,QAAQ,MAAM,KAAK,UAAU,UAAU;AAC7C,WAAOC,IAAAA,UAAa,KAAK;AAAA,EAC3B;AAAA,EAEA,MAAgB,WAAW,IAAgC;AACzD,UAAM,QAAQ,MAAM,KAAK,UAAU,UAAU;AAC7C,WAAOC,IAAAA,OAAU,OAAO,EAAiB;AAAA,EAC3C;AAAA,EAEA,MAAgB,WAAW,OAA2B;AACpD,UAAM,QAAQ,MAAM,KAAK,UAAU,WAAW;AAC9C,WAAOC,IAAAA,OAAO,OAAO,KAAK;AAAA,EAC5B;AAAA,EAEA,MAAgB,cAAc,KAA+B;AAC3D,UAAM,QAAQ,MAAM,KAAK,UAAU,WAAW;AAC9C,WAAOC,IAAAA,UAAU,OAAO,GAAoB;AAAA,EAC9C;AAAA,EAEA,MAAgB,eAA8B;AAC5C,UAAM,QAAQ,MAAM,KAAK,UAAU,WAAW;AAC9C,WAAOC,IAAAA,SAAS,KAAK;AAAA,EACvB;AACF;;"}

package/dist/web/IndexedDBCollection.js

@@ -0,0 +1,37 @@
+import { PersistentCollection } from "../PersistentCollection.js";
+import { getStore, idbGetAll, idbGet, idbPut, idbDelete, idbClear } from "./idb.js";
+class IndexedDBCollection extends PersistentCollection {
+  /** IndexedDB database name. Override to use a separate database. */
+  static DB_NAME = "mvc-kit";
+  get _dbName() {
+    return this.constructor.DB_NAME;
+  }
+  _getStore(mode) {
+    return getStore(this._dbName, this.storageKey, mode);
+  }
+  // ── Persist interface (per-item strategy) ──
+  async persistGetAll() {
+    const store = await this._getStore("readonly");
+    return idbGetAll(store);
+  }
+  async persistGet(id) {
+    const store = await this._getStore("readonly");
+    return idbGet(store, id);
+  }
+  async persistSet(items) {
+    const store = await this._getStore("readwrite");
+    return idbPut(store, items);
+  }
+  async persistRemove(ids) {
+    const store = await this._getStore("readwrite");
+    return idbDelete(store, ids);
+  }
+  async persistClear() {
+    const store = await this._getStore("readwrite");
+    return idbClear(store);
+  }
+}
+export {
+  IndexedDBCollection
+};
+//# sourceMappingURL=IndexedDBCollection.js.map

package/dist/web/IndexedDBCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDBCollection.js","sources":["../../src/web/IndexedDBCollection.ts"],"sourcesContent":["import { PersistentCollection } from '../PersistentCollection';\nimport { getStore, idbGetAll, idbGet, idbPut, idbDelete, idbClear } from './idb';\n\n/**\n * PersistentCollection backed by IndexedDB. Stores items individually by `id`\n * in a dedicated object store (named by `storageKey`).\n *\n * **Requires manual `hydrate()` call** (async storage).\n * Typically called in ViewModel's `onInit()`.\n *\n * Uses per-item strategy: each item is stored as a separate entry in the object store.\n * No JSON serialization needed — IndexedDB uses structured cloning.\n *\n * ```ts\n * class MessagesCollection extends IndexedDBCollection<Message> {\n *   protected readonly storageKey = 'messages';\n * }\n *\n * // In ViewModel:\n * async onInit() {\n *   await this.collection.hydrate();\n *   if (this.collection.length === 0) this.load();\n * }\n * ```\n */\nexport abstract class IndexedDBCollection<\n  T extends { id: string | number },\n> extends PersistentCollection<T> {\n  /** IndexedDB database name. Override to use a separate database. */\n  static DB_NAME = 'mvc-kit';\n\n  private get _dbName(): string {\n    return (this.constructor as typeof IndexedDBCollection).DB_NAME;\n  }\n\n  private _getStore(mode: IDBTransactionMode) {\n    return getStore(this._dbName, this.storageKey, mode);\n  }\n\n  // ── Persist interface (per-item strategy) ──\n\n  protected async persistGetAll(): Promise<T[]> {\n    const store = await this._getStore('readonly');\n    return idbGetAll<T>(store);\n  }\n\n  protected async persistGet(id: T['id']): Promise<T | null> {\n    const store = await this._getStore('readonly');\n    return idbGet<T>(store, id as IDBValidKey);\n  }\n\n  protected async persistSet(items: T[]): Promise<void> {\n    const store = await this._getStore('readwrite');\n    return idbPut(store, items);\n  }\n\n  protected async persistRemove(ids: T['id'][]): Promise<void> {\n    const store = await this._getStore('readwrite');\n    return idbDelete(store, ids as IDBValidKey[]);\n  }\n\n  protected async persistClear(): Promise<void> {\n    const store = await this._getStore('readwrite');\n    return idbClear(store);\n  }\n}\n"],"names":[],"mappings":";;AAyBO,MAAe,4BAEZ,qBAAwB;AAAA;AAAA,EAEhC,OAAO,UAAU;AAAA,EAEjB,IAAY,UAAkB;AAC5B,WAAQ,KAAK,YAA2C;AAAA,EAC1D;AAAA,EAEQ,UAAU,MAA0B;AAC1C,WAAO,SAAS,KAAK,SAAS,KAAK,YAAY,IAAI;AAAA,EACrD;AAAA;AAAA,EAIA,MAAgB,gBAA8B;AAC5C,UAAM,QAAQ,MAAM,KAAK,UAAU,UAAU;AAC7C,WAAO,UAAa,KAAK;AAAA,EAC3B;AAAA,EAEA,MAAgB,WAAW,IAAgC;AACzD,UAAM,QAAQ,MAAM,KAAK,UAAU,UAAU;AAC7C,WAAO,OAAU,OAAO,EAAiB;AAAA,EAC3C;AAAA,EAEA,MAAgB,WAAW,OAA2B;AACpD,UAAM,QAAQ,MAAM,KAAK,UAAU,WAAW;AAC9C,WAAO,OAAO,OAAO,KAAK;AAAA,EAC5B;AAAA,EAEA,MAAgB,cAAc,KAA+B;AAC3D,UAAM,QAAQ,MAAM,KAAK,UAAU,WAAW;AAC9C,WAAO,UAAU,OAAO,GAAoB;AAAA,EAC9C;AAAA,EAEA,MAAgB,eAA8B;AAC5C,UAAM,QAAQ,MAAM,KAAK,UAAU,WAAW;AAC9C,WAAO,SAAS,KAAK;AAAA,EACvB;AACF;"}

package/dist/web/WebStorageCollection.cjs

@@ -0,0 +1,85 @@
+"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);
+  }
+}
+exports.WebStorageCollection = WebStorageCollection;
+//# sourceMappingURL=WebStorageCollection.cjs.map

package/dist/web/WebStorageCollection.cjs.map

@@ -0,0 +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;;"}

package/dist/web/WebStorageCollection.d.ts

@@ -19,8 +19,8 @@ export declare abstract class WebStorageCollection<T extends {
     private _autoHydrated;
     private get _storage();
     private _ensureHydrated;
-    get items(): readonly T[];
-    get state(): readonly T[];
+    get items(): T[];
+    get state(): T[];
     get length(): number;
     get(id: T['id']): T | undefined;
     has(id: T['id']): boolean;

package/dist/web/WebStorageCollection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebStorageCollection.d.ts","sourceRoot":"","sources":["../../src/web/WebStorageCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAI/D;;;;;;;;;;;GAWG;AACH,8BAAsB,oBAAoB,CACxC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CACjC,SAAQ,oBAAoB,CAAC,CAAC,CAAC;IAC/B,kFAAkF;IAClF,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAW;IAE9C,OAAO,CAAC,aAAa,CAAS;IAE9B,OAAO,KAAK,QAAQ,GAInB;IAED,OAAO,CAAC,eAAe;IAQvB,IAAI,KAAK,IAAI,SAAS,CAAC,EAAE,CAGxB;IAED,IAAI,KAAK,IAAI,SAAS,CAAC,EAAE,CAExB;IAED,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS;IAK/B,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO;IAOzB,SAAS,CAAC,aAAa,IAAI,CAAC,EAAE;IAe9B,SAAS,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI;IAK3C,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI;IAcvC,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI;IAc9C,SAAS,CAAC,YAAY,IAAI,IAAI;CAG/B"}
+{"version":3,"file":"WebStorageCollection.d.ts","sourceRoot":"","sources":["../../src/web/WebStorageCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAI/D;;;;;;;;;;;GAWG;AACH,8BAAsB,oBAAoB,CACxC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CACjC,SAAQ,oBAAoB,CAAC,CAAC,CAAC;IAC/B,kFAAkF;IAClF,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAW;IAE9C,OAAO,CAAC,aAAa,CAAS;IAE9B,OAAO,KAAK,QAAQ,GAInB;IAED,OAAO,CAAC,eAAe;IAQvB,IAAI,KAAK,IAAI,CAAC,EAAE,CAGf;IAED,IAAI,KAAK,IAAI,CAAC,EAAE,CAEf;IAED,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS;IAK/B,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO;IAOzB,SAAS,CAAC,aAAa,IAAI,CAAC,EAAE;IAe9B,SAAS,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI;IAK3C,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI;IAcvC,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI;IAc9C,SAAS,CAAC,YAAY,IAAI,IAAI;CAG/B"}

package/dist/web/WebStorageCollection.js

@@ -0,0 +1,85 @@
+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
+};
+//# sourceMappingURL=WebStorageCollection.js.map

package/dist/web/WebStorageCollection.js.map

@@ -0,0 +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;"}

package/dist/web/idb.cjs

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const _connections = /* @__PURE__ */ new Map();
+const _stores = /* @__PURE__ */ new Map();
+let _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;
+}
+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);
+  });
+}
+function getStore(dbName, storeName, mode) {
+  return openDB(dbName, storeName).then((db) => {
+    const tx = db.transaction(storeName, mode);
+    return tx.objectStore(storeName);
+  });
+}
+function idbGetAll(store) {
+  return new Promise((resolve, reject) => {
+    const request = store.getAll();
+    request.onsuccess = () => resolve(request.result);
+    request.onerror = () => reject(request.error);
+  });
+}
+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);
+  });
+}
+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);
+  });
+}
+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);
+  });
+}
+function idbClear(store) {
+  return new Promise((resolve, reject) => {
+    const tx = store.transaction;
+    store.clear();
+    tx.oncomplete = () => resolve();
+    tx.onerror = () => reject(tx.error);
+  });
+}
+exports.getStore = getStore;
+exports.idbClear = idbClear;
+exports.idbDelete = idbDelete;
+exports.idbGet = idbGet;
+exports.idbGetAll = idbGetAll;
+exports.idbPut = idbPut;
+//# sourceMappingURL=idb.cjs.map

package/dist/web/idb.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb.cjs","sources":["../../src/web/idb.ts"],"sourcesContent":["/**\n * Shared IndexedDB connection manager.\n * Deduplicates indexedDB.open() calls and handles dynamic object store creation\n * by bumping the DB version when a new storageKey is encountered.\n */\n\nconst _connections = new Map<string, IDBDatabase>();\nconst _stores = new Map<string, Set<string>>(); // dbName → known store names\nlet _openQueue: Promise<void> = Promise.resolve(); // Sequential open queue\n\nfunction openDB(dbName: string, storeName: string): Promise<IDBDatabase> {\n  // If we already have a connection with the required store, reuse it\n  const existing = _connections.get(dbName);\n  if (existing) {\n    if (existing.objectStoreNames.contains(storeName)) {\n      return Promise.resolve(existing);\n    }\n    // Need to add a new store — close and reopen with bumped version\n    existing.close();\n    _connections.delete(dbName);\n  }\n\n  // Track known stores\n  let stores = _stores.get(dbName);\n  if (!stores) {\n    stores = new Set();\n    _stores.set(dbName, stores);\n  }\n  stores.add(storeName);\n\n  // Serialize opens to prevent version conflicts\n  const result = _openQueue.then(() => doOpen(dbName, stores!));\n  _openQueue = result.then(() => {}, () => {}); // Absorb errors for the queue\n  return result;\n}\n\nfunction doOpen(dbName: string, stores: Set<string>): Promise<IDBDatabase> {\n  // Close existing cached connection if any (may have been opened by queued op)\n  const existingDb = _connections.get(dbName);\n  existingDb?.close();\n  _connections.delete(dbName);\n\n  // Probe current DB version (version-less open never triggers upgrade)\n  return new Promise<IDBDatabase>((resolve, reject) => {\n    const probe = indexedDB.open(dbName);\n    probe.onsuccess = () => {\n      const db = probe.result;\n      const version = db.version;\n\n      // Check if all required stores already exist\n      let needsUpgrade = false;\n      for (const name of stores) {\n        if (!db.objectStoreNames.contains(name)) {\n          needsUpgrade = true;\n          break;\n        }\n      }\n\n      if (!needsUpgrade) {\n        _connections.set(dbName, db);\n        resolve(db);\n        return;\n      }\n\n      // Need new stores — close and reopen with bumped version\n      db.close();\n      const upgrade = indexedDB.open(dbName, version + 1);\n      upgrade.onupgradeneeded = () => {\n        const udb = upgrade.result;\n        for (const name of stores) {\n          if (!udb.objectStoreNames.contains(name)) {\n            udb.createObjectStore(name, { keyPath: 'id' });\n          }\n        }\n      };\n      upgrade.onsuccess = () => {\n        _connections.set(dbName, upgrade.result);\n        resolve(upgrade.result);\n      };\n      upgrade.onerror = () => reject(upgrade.error);\n    };\n    probe.onerror = () => reject(probe.error);\n  });\n}\n\nexport function getStore(\n  dbName: string,\n  storeName: string,\n  mode: IDBTransactionMode,\n): Promise<IDBObjectStore> {\n  return openDB(dbName, storeName).then((db) => {\n    const tx = db.transaction(storeName, mode);\n    return tx.objectStore(storeName);\n  });\n}\n\nexport function idbGetAll<T>(store: IDBObjectStore): Promise<T[]> {\n  return new Promise((resolve, reject) => {\n    const request = store.getAll();\n    request.onsuccess = () => resolve(request.result);\n    request.onerror = () => reject(request.error);\n  });\n}\n\nexport function idbGet<T>(store: IDBObjectStore, id: IDBValidKey): Promise<T | null> {\n  return new Promise((resolve, reject) => {\n    const request = store.get(id);\n    request.onsuccess = () => resolve(request.result ?? null);\n    request.onerror = () => reject(request.error);\n  });\n}\n\nexport function idbPut<T>(store: IDBObjectStore, items: T[]): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const tx = store.transaction;\n    for (const item of items) {\n      store.put(item);\n    }\n    tx.oncomplete = () => resolve();\n    tx.onerror = () => reject(tx.error);\n  });\n}\n\nexport function idbDelete(store: IDBObjectStore, ids: IDBValidKey[]): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const tx = store.transaction;\n    for (const id of ids) {\n      store.delete(id);\n    }\n    tx.oncomplete = () => resolve();\n    tx.onerror = () => reject(tx.error);\n  });\n}\n\nexport function idbClear(store: IDBObjectStore): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const tx = store.transaction;\n    store.clear();\n    tx.oncomplete = () => resolve();\n    tx.onerror = () => reject(tx.error);\n  });\n}\n\n/** Close all cached connections and delete all known databases. Used in test cleanup. */\nexport function closeAllConnections(): void {\n  for (const db of _connections.values()) {\n    db.close();\n  }\n  _connections.clear();\n  _stores.clear();\n  _openQueue = Promise.resolve();\n}\n\n/** Delete a database by name. Returns a promise that resolves when deleted. */\nexport function deleteDatabase(dbName: string): Promise<void> {\n  const existing = _connections.get(dbName);\n  existing?.close();\n  _connections.delete(dbName);\n  _stores.delete(dbName);\n\n  return new Promise((resolve, reject) => {\n    const request = indexedDB.deleteDatabase(dbName);\n    request.onsuccess = () => resolve();\n    request.onerror = () => reject(request.error);\n  });\n}\n"],"names":[],"mappings":"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"}

package/dist/web/idb.js

@@ -0,0 +1,121 @@
+const _connections = /* @__PURE__ */ new Map();
+const _stores = /* @__PURE__ */ new Map();
+let _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;
+}
+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);
+  });
+}
+function getStore(dbName, storeName, mode) {
+  return openDB(dbName, storeName).then((db) => {
+    const tx = db.transaction(storeName, mode);
+    return tx.objectStore(storeName);
+  });
+}
+function idbGetAll(store) {
+  return new Promise((resolve, reject) => {
+    const request = store.getAll();
+    request.onsuccess = () => resolve(request.result);
+    request.onerror = () => reject(request.error);
+  });
+}
+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);
+  });
+}
+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);
+  });
+}
+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);
+  });
+}
+function idbClear(store) {
+  return new Promise((resolve, reject) => {
+    const tx = store.transaction;
+    store.clear();
+    tx.oncomplete = () => resolve();
+    tx.onerror = () => reject(tx.error);
+  });
+}
+export {
+  getStore,
+  idbClear,
+  idbDelete,
+  idbGet,
+  idbGetAll,
+  idbPut
+};
+//# sourceMappingURL=idb.js.map

package/dist/web/idb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb.js","sources":["../../src/web/idb.ts"],"sourcesContent":["/**\n * Shared IndexedDB connection manager.\n * Deduplicates indexedDB.open() calls and handles dynamic object store creation\n * by bumping the DB version when a new storageKey is encountered.\n */\n\nconst _connections = new Map<string, IDBDatabase>();\nconst _stores = new Map<string, Set<string>>(); // dbName → known store names\nlet _openQueue: Promise<void> = Promise.resolve(); // Sequential open queue\n\nfunction openDB(dbName: string, storeName: string): Promise<IDBDatabase> {\n  // If we already have a connection with the required store, reuse it\n  const existing = _connections.get(dbName);\n  if (existing) {\n    if (existing.objectStoreNames.contains(storeName)) {\n      return Promise.resolve(existing);\n    }\n    // Need to add a new store — close and reopen with bumped version\n    existing.close();\n    _connections.delete(dbName);\n  }\n\n  // Track known stores\n  let stores = _stores.get(dbName);\n  if (!stores) {\n    stores = new Set();\n    _stores.set(dbName, stores);\n  }\n  stores.add(storeName);\n\n  // Serialize opens to prevent version conflicts\n  const result = _openQueue.then(() => doOpen(dbName, stores!));\n  _openQueue = result.then(() => {}, () => {}); // Absorb errors for the queue\n  return result;\n}\n\nfunction doOpen(dbName: string, stores: Set<string>): Promise<IDBDatabase> {\n  // Close existing cached connection if any (may have been opened by queued op)\n  const existingDb = _connections.get(dbName);\n  existingDb?.close();\n  _connections.delete(dbName);\n\n  // Probe current DB version (version-less open never triggers upgrade)\n  return new Promise<IDBDatabase>((resolve, reject) => {\n    const probe = indexedDB.open(dbName);\n    probe.onsuccess = () => {\n      const db = probe.result;\n      const version = db.version;\n\n      // Check if all required stores already exist\n      let needsUpgrade = false;\n      for (const name of stores) {\n        if (!db.objectStoreNames.contains(name)) {\n          needsUpgrade = true;\n          break;\n        }\n      }\n\n      if (!needsUpgrade) {\n        _connections.set(dbName, db);\n        resolve(db);\n        return;\n      }\n\n      // Need new stores — close and reopen with bumped version\n      db.close();\n      const upgrade = indexedDB.open(dbName, version + 1);\n      upgrade.onupgradeneeded = () => {\n        const udb = upgrade.result;\n        for (const name of stores) {\n          if (!udb.objectStoreNames.contains(name)) {\n            udb.createObjectStore(name, { keyPath: 'id' });\n          }\n        }\n      };\n      upgrade.onsuccess = () => {\n        _connections.set(dbName, upgrade.result);\n        resolve(upgrade.result);\n      };\n      upgrade.onerror = () => reject(upgrade.error);\n    };\n    probe.onerror = () => reject(probe.error);\n  });\n}\n\nexport function getStore(\n  dbName: string,\n  storeName: string,\n  mode: IDBTransactionMode,\n): Promise<IDBObjectStore> {\n  return openDB(dbName, storeName).then((db) => {\n    const tx = db.transaction(storeName, mode);\n    return tx.objectStore(storeName);\n  });\n}\n\nexport function idbGetAll<T>(store: IDBObjectStore): Promise<T[]> {\n  return new Promise((resolve, reject) => {\n    const request = store.getAll();\n    request.onsuccess = () => resolve(request.result);\n    request.onerror = () => reject(request.error);\n  });\n}\n\nexport function idbGet<T>(store: IDBObjectStore, id: IDBValidKey): Promise<T | null> {\n  return new Promise((resolve, reject) => {\n    const request = store.get(id);\n    request.onsuccess = () => resolve(request.result ?? null);\n    request.onerror = () => reject(request.error);\n  });\n}\n\nexport function idbPut<T>(store: IDBObjectStore, items: T[]): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const tx = store.transaction;\n    for (const item of items) {\n      store.put(item);\n    }\n    tx.oncomplete = () => resolve();\n    tx.onerror = () => reject(tx.error);\n  });\n}\n\nexport function idbDelete(store: IDBObjectStore, ids: IDBValidKey[]): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const tx = store.transaction;\n    for (const id of ids) {\n      store.delete(id);\n    }\n    tx.oncomplete = () => resolve();\n    tx.onerror = () => reject(tx.error);\n  });\n}\n\nexport function idbClear(store: IDBObjectStore): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const tx = store.transaction;\n    store.clear();\n    tx.oncomplete = () => resolve();\n    tx.onerror = () => reject(tx.error);\n  });\n}\n\n/** Close all cached connections and delete all known databases. Used in test cleanup. */\nexport function closeAllConnections(): void {\n  for (const db of _connections.values()) {\n    db.close();\n  }\n  _connections.clear();\n  _stores.clear();\n  _openQueue = Promise.resolve();\n}\n\n/** Delete a database by name. Returns a promise that resolves when deleted. */\nexport function deleteDatabase(dbName: string): Promise<void> {\n  const existing = _connections.get(dbName);\n  existing?.close();\n  _connections.delete(dbName);\n  _stores.delete(dbName);\n\n  return new Promise((resolve, reject) => {\n    const request = indexedDB.deleteDatabase(dbName);\n    request.onsuccess = () => resolve();\n    request.onerror = () => reject(request.error);\n  });\n}\n"],"names":[],"mappings":"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"}

package/dist/web.cjs

@@ -1,2 +1,7 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("./PersistentCollection-B8kNECDj.cjs"),l=typeof __MVC_KIT_DEV__<"u"&&__MVC_KIT_DEV__;class y extends f.PersistentCollection{static STORAGE="local";_autoHydrated=!1;get _storage(){return this.constructor.STORAGE==="session"?sessionStorage:localStorage}_ensureHydrated(){this._autoHydrated||(this._autoHydrated=!0,this._hydrateSync())}get items(){return this._ensureHydrated(),super.items}get state(){return this.items}get length(){return this._ensureHydrated(),super.length}get(e){return this._ensureHydrated(),super.get(e)}has(e){return this._ensureHydrated(),super.has(e)}persistGetAll(){const e=this._storage.getItem(this.storageKey);if(!e)return[];try{return this.deserialize(e)}catch{return l&&console.warn(`[mvc-kit] Corrupted data in storage key "${this.storageKey}". Ignoring stored data.`),[]}}persistGet(e){return this.persistGetAll().find(s=>s.id===e)??null}persistSet(e){try{this._storage.setItem(this.storageKey,this.serialize([...this.items]))}catch(t){throw l&&t instanceof DOMException&&t.name==="QuotaExceededError"&&console.warn(`[mvc-kit] QuotaExceededError writing to "${this.storageKey}". Consider using IndexedDBCollection for larger datasets.`),t}}persistRemove(e){try{this._storage.setItem(this.storageKey,this.serialize([...this.items]))}catch(t){throw l&&t instanceof DOMException&&t.name==="QuotaExceededError"&&console.warn(`[mvc-kit] QuotaExceededError writing to "${this.storageKey}". Consider using IndexedDBCollection for larger datasets.`),t}}persistClear(){this._storage.removeItem(this.storageKey)}}const c=new Map,h=new Map;let _=Promise.resolve();function m(r,e){const t=c.get(r);if(t){if(t.objectStoreNames.contains(e))return Promise.resolve(t);t.close(),c.delete(r)}let s=h.get(r);s||(s=new Set,h.set(r,s)),s.add(e);const o=_.then(()=>w(r,s));return _=o.then(()=>{},()=>{}),o}function w(r,e){return c.get(r)?.close(),c.delete(r),new Promise((s,o)=>{const n=indexedDB.open(r);n.onsuccess=()=>{const a=n.result,p=a.version;let d=!1;for(const u of e)if(!a.objectStoreNames.contains(u)){d=!0;break}if(!d){c.set(r,a),s(a);return}a.close();const i=indexedDB.open(r,p+1);i.onupgradeneeded=()=>{const u=i.result;for(const g of e)u.objectStoreNames.contains(g)||u.createObjectStore(g,{keyPath:"id"})},i.onsuccess=()=>{c.set(r,i.result),s(i.result)},i.onerror=()=>o(i.error)},n.onerror=()=>o(n.error)})}function S(r,e,t){return m(r,e).then(s=>s.transaction(e,t).objectStore(e))}function x(r){return new Promise((e,t)=>{const s=r.getAll();s.onsuccess=()=>e(s.result),s.onerror=()=>t(s.error)})}function C(r,e){return new Promise((t,s)=>{const o=r.get(e);o.onsuccess=()=>t(o.result??null),o.onerror=()=>s(o.error)})}function D(r,e){return new Promise((t,s)=>{const o=r.transaction;for(const n of e)r.put(n);o.oncomplete=()=>t(),o.onerror=()=>s(o.error)})}function E(r,e){return new Promise((t,s)=>{const o=r.transaction;for(const n of e)r.delete(n);o.oncomplete=()=>t(),o.onerror=()=>s(o.error)})}function P(r){return new Promise((e,t)=>{const s=r.transaction;r.clear(),s.oncomplete=()=>e(),s.onerror=()=>t(s.error)})}class b extends f.PersistentCollection{static DB_NAME="mvc-kit";get _dbName(){return this.constructor.DB_NAME}_getStore(e){return S(this._dbName,this.storageKey,e)}async persistGetAll(){const e=await this._getStore("readonly");return x(e)}async persistGet(e){const t=await this._getStore("readonly");return C(t,e)}async persistSet(e){const t=await this._getStore("readwrite");return D(t,e)}async persistRemove(e){const t=await this._getStore("readwrite");return E(t,e)}async persistClear(){const e=await this._getStore("readwrite");return P(e)}}exports.IndexedDBCollection=b;exports.WebStorageCollection=y;
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const WebStorageCollection = require("./web/WebStorageCollection.cjs");
+const IndexedDBCollection = require("./web/IndexedDBCollection.cjs");
+exports.WebStorageCollection = WebStorageCollection.WebStorageCollection;
+exports.IndexedDBCollection = IndexedDBCollection.IndexedDBCollection;
 //# sourceMappingURL=web.cjs.map

package/dist/web.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"web.cjs","sources":["../src/web/WebStorageCollection.ts","../src/web/idb.ts","../src/web/IndexedDBCollection.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(): readonly T[] {\n    this._ensureHydrated();\n    return super.items;\n  }\n\n  get state(): readonly 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","/**\n * Shared IndexedDB connection manager.\n * Deduplicates indexedDB.open() calls and handles dynamic object store creation\n * by bumping the DB version when a new storageKey is encountered.\n */\n\nconst _connections = new Map<string, IDBDatabase>();\nconst _stores = new Map<string, Set<string>>(); // dbName → known store names\nlet _openQueue: Promise<void> = Promise.resolve(); // Sequential open queue\n\nfunction openDB(dbName: string, storeName: string): Promise<IDBDatabase> {\n  // If we already have a connection with the required store, reuse it\n  const existing = _connections.get(dbName);\n  if (existing) {\n    if (existing.objectStoreNames.contains(storeName)) {\n      return Promise.resolve(existing);\n    }\n    // Need to add a new store — close and reopen with bumped version\n    existing.close();\n    _connections.delete(dbName);\n  }\n\n  // Track known stores\n  let stores = _stores.get(dbName);\n  if (!stores) {\n    stores = new Set();\n    _stores.set(dbName, stores);\n  }\n  stores.add(storeName);\n\n  // Serialize opens to prevent version conflicts\n  const result = _openQueue.then(() => doOpen(dbName, stores!));\n  _openQueue = result.then(() => {}, () => {}); // Absorb errors for the queue\n  return result;\n}\n\nfunction doOpen(dbName: string, stores: Set<string>): Promise<IDBDatabase> {\n  // Close existing cached connection if any (may have been opened by queued op)\n  const existingDb = _connections.get(dbName);\n  existingDb?.close();\n  _connections.delete(dbName);\n\n  // Probe current DB version (version-less open never triggers upgrade)\n  return new Promise<IDBDatabase>((resolve, reject) => {\n    const probe = indexedDB.open(dbName);\n    probe.onsuccess = () => {\n      const db = probe.result;\n      const version = db.version;\n\n      // Check if all required stores already exist\n      let needsUpgrade = false;\n      for (const name of stores) {\n        if (!db.objectStoreNames.contains(name)) {\n          needsUpgrade = true;\n          break;\n        }\n      }\n\n      if (!needsUpgrade) {\n        _connections.set(dbName, db);\n        resolve(db);\n        return;\n      }\n\n      // Need new stores — close and reopen with bumped version\n      db.close();\n      const upgrade = indexedDB.open(dbName, version + 1);\n      upgrade.onupgradeneeded = () => {\n        const udb = upgrade.result;\n        for (const name of stores) {\n          if (!udb.objectStoreNames.contains(name)) {\n            udb.createObjectStore(name, { keyPath: 'id' });\n          }\n        }\n      };\n      upgrade.onsuccess = () => {\n        _connections.set(dbName, upgrade.result);\n        resolve(upgrade.result);\n      };\n      upgrade.onerror = () => reject(upgrade.error);\n    };\n    probe.onerror = () => reject(probe.error);\n  });\n}\n\nexport function getStore(\n  dbName: string,\n  storeName: string,\n  mode: IDBTransactionMode,\n): Promise<IDBObjectStore> {\n  return openDB(dbName, storeName).then((db) => {\n    const tx = db.transaction(storeName, mode);\n    return tx.objectStore(storeName);\n  });\n}\n\nexport function idbGetAll<T>(store: IDBObjectStore): Promise<T[]> {\n  return new Promise((resolve, reject) => {\n    const request = store.getAll();\n    request.onsuccess = () => resolve(request.result);\n    request.onerror = () => reject(request.error);\n  });\n}\n\nexport function idbGet<T>(store: IDBObjectStore, id: IDBValidKey): Promise<T | null> {\n  return new Promise((resolve, reject) => {\n    const request = store.get(id);\n    request.onsuccess = () => resolve(request.result ?? null);\n    request.onerror = () => reject(request.error);\n  });\n}\n\nexport function idbPut<T>(store: IDBObjectStore, items: T[]): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const tx = store.transaction;\n    for (const item of items) {\n      store.put(item);\n    }\n    tx.oncomplete = () => resolve();\n    tx.onerror = () => reject(tx.error);\n  });\n}\n\nexport function idbDelete(store: IDBObjectStore, ids: IDBValidKey[]): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const tx = store.transaction;\n    for (const id of ids) {\n      store.delete(id);\n    }\n    tx.oncomplete = () => resolve();\n    tx.onerror = () => reject(tx.error);\n  });\n}\n\nexport function idbClear(store: IDBObjectStore): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const tx = store.transaction;\n    store.clear();\n    tx.oncomplete = () => resolve();\n    tx.onerror = () => reject(tx.error);\n  });\n}\n\n/** Close all cached connections and delete all known databases. Used in test cleanup. */\nexport function closeAllConnections(): void {\n  for (const db of _connections.values()) {\n    db.close();\n  }\n  _connections.clear();\n  _stores.clear();\n  _openQueue = Promise.resolve();\n}\n\n/** Delete a database by name. Returns a promise that resolves when deleted. */\nexport function deleteDatabase(dbName: string): Promise<void> {\n  const existing = _connections.get(dbName);\n  existing?.close();\n  _connections.delete(dbName);\n  _stores.delete(dbName);\n\n  return new Promise((resolve, reject) => {\n    const request = indexedDB.deleteDatabase(dbName);\n    request.onsuccess = () => resolve();\n    request.onerror = () => reject(request.error);\n  });\n}\n","import { PersistentCollection } from '../PersistentCollection';\nimport { getStore, idbGetAll, idbGet, idbPut, idbDelete, idbClear } from './idb';\n\n/**\n * PersistentCollection backed by IndexedDB. Stores items individually by `id`\n * in a dedicated object store (named by `storageKey`).\n *\n * **Requires manual `hydrate()` call** (async storage).\n * Typically called in ViewModel's `onInit()`.\n *\n * Uses per-item strategy: each item is stored as a separate entry in the object store.\n * No JSON serialization needed — IndexedDB uses structured cloning.\n *\n * ```ts\n * class MessagesCollection extends IndexedDBCollection<Message> {\n *   protected readonly storageKey = 'messages';\n * }\n *\n * // In ViewModel:\n * async onInit() {\n *   await this.collection.hydrate();\n *   if (this.collection.length === 0) this.load();\n * }\n * ```\n */\nexport abstract class IndexedDBCollection<\n  T extends { id: string | number },\n> extends PersistentCollection<T> {\n  /** IndexedDB database name. Override to use a separate database. */\n  static DB_NAME = 'mvc-kit';\n\n  private get _dbName(): string {\n    return (this.constructor as typeof IndexedDBCollection).DB_NAME;\n  }\n\n  private _getStore(mode: IDBTransactionMode) {\n    return getStore(this._dbName, this.storageKey, mode);\n  }\n\n  // ── Persist interface (per-item strategy) ──\n\n  protected async persistGetAll(): Promise<T[]> {\n    const store = await this._getStore('readonly');\n    return idbGetAll<T>(store);\n  }\n\n  protected async persistGet(id: T['id']): Promise<T | null> {\n    const store = await this._getStore('readonly');\n    return idbGet<T>(store, id as IDBValidKey);\n  }\n\n  protected async persistSet(items: T[]): Promise<void> {\n    const store = await this._getStore('readwrite');\n    return idbPut(store, items);\n  }\n\n  protected async persistRemove(ids: T['id'][]): Promise<void> {\n    const store = await this._getStore('readwrite');\n    return idbDelete(store, ids as IDBValidKey[]);\n  }\n\n  protected async persistClear(): Promise<void> {\n    const store = await this._getStore('readwrite');\n    return idbClear(store);\n  }\n}\n"],"names":["__DEV__","WebStorageCollection","PersistentCollection","id","raw","i","_items","err","_ids","_connections","_stores","_openQueue","openDB","dbName","storeName","existing","stores","result","doOpen","resolve","reject","probe","db","version","needsUpgrade","name","upgrade","udb","getStore","mode","idbGetAll","store","request","idbGet","idbPut","items","tx","item","idbDelete","ids","idbClear","IndexedDBCollection"],"mappings":"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"}
+{"version":3,"file":"web.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}