strata-storage 2.6.1 → 2.7.1

package/dist/adapters/web/CacheAdapter.js

@@ -3,7 +3,7 @@
  * Provides network-aware storage for offline support
  */
 import { BaseAdapter } from "../../core/BaseAdapter.js";
-import { getObjectSize } from "../../utils/index.js";
+import { getObjectSize, serialize, deserialize } from "../../utils/index.js";
 import { StorageError, QuotaExceededError, NotSupportedError } from "../../utils/errors.js";
 import { logger } from "../../utils/logger.js";
 /**
@@ -84,7 +84,7 @@ export class CacheAdapter extends BaseAdapter {
             const response = await cache.match(url);
             if (!response)
                 return null;
-            const data = (await response.json());
+            const data = deserialize(await response.text());
             // Check TTL
             if (this.isExpired(data)) {
                 await this.remove(key);
@@ -105,8 +105,9 @@ export class CacheAdapter extends BaseAdapter {
         const url = this.keyToUrl(key);
         const oldValue = await this.get(key);
         try {
-            // Create Response with the data
-            const response = new Response(JSON.stringify(value), {
+            // Create Response with the data (shared serialize preserves Date/Map/Set
+            // etc., matching the other adapters instead of raw JSON).
+            const response = new Response(serialize(value), {
                 headers: {
                     'Content-Type': 'application/json',
                     'X-Strata-Created': value.created.toString(),
@@ -130,7 +131,21 @@ export class CacheAdapter extends BaseAdapter {
     async remove(key) {
         const cache = await this.openCache();
         const url = this.keyToUrl(key);
-        const oldValue = await this.get(key);
+        // Read raw via cache.match — NOT via get(), which deletes an expired entry
+        // by awaiting remove(), recursing here and never resolving. Only read when
+        // a listener needs the old value.
+        let oldValue = null;
+        if (this.hasChangeListeners()) {
+            const response = await cache.match(url);
+            if (response) {
+                try {
+                    oldValue = deserialize(await response.text());
+                }
+                catch {
+                    oldValue = null;
+                }
+            }
+        }
         const deleted = await cache.delete(url);
         if (deleted && oldValue) {
             this.emitChange(key, oldValue.value, undefined, 'local');

package/dist/adapters/web/CookieAdapter.d.ts

@@ -2,8 +2,8 @@
  * Cookie Adapter - Browser cookie implementation
  * Provides limited storage with 4KB per cookie limit
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo } from '@/types';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo } from "../../types/index.js";
 /**
  * Cookie options.
  *

package/dist/adapters/web/CookieAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CookieAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/web/CookieAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACT,MAAM,SAAS,CAAC;AAIjB;;;;;;;;;GASG;AACH,UAAU,aAAa;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAa;IACvC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,aAAa,CAAQ;gBAEjB,MAAM,SAAY,EAAE,OAAO,GAAE,aAAkB;IAY3D;;;OAGG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBrC;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAIpE;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAuBzD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAqC/D;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAW7B;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IA4CvC;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIxD;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE;IAmB7C;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK7B;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmCjD;;OAEG;IACH,OAAO,CAAC,SAAS;IAgBjB;;OAEG;IACH,OAAO,CAAC,SAAS;IAiCjB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,aAAa;CAmBtB"}
+{"version":3,"file":"CookieAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/web/CookieAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACT,MAAM,SAAS,CAAC;AAKjB;;;;;;;;;GASG;AACH,UAAU,aAAa;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAa;IACvC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,aAAa,CAAQ;gBAEjB,MAAM,SAAY,EAAE,OAAO,GAAE,aAAkB;IAY3D;;;OAGG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBrC;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAIpE;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAuBzD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAqC/D;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAwB7B;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IA4CvC;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIxD;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE;IAmB7C;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK7B;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmCjD;;OAEG;IACH,OAAO,CAAC,SAAS;IAgBjB;;OAEG;IACH,OAAO,CAAC,SAAS;IA4CjB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,aAAa;CAmBtB"}

package/dist/adapters/web/CookieAdapter.js

@@ -3,6 +3,7 @@
  * Provides limited storage with 4KB per cookie limit
  */
 import { BaseAdapter } from "../../core/BaseAdapter.js";
+import { serialize, deserialize } from "../../utils/index.js";
 import { StorageError, QuotaExceededError } from "../../utils/errors.js";
 import { logger } from "../../utils/logger.js";
 /**
@@ -92,7 +93,7 @@ export class CookieAdapter extends BaseAdapter {
             return null;
         try {
             const decoded = decodeURIComponent(value);
-            const parsed = JSON.parse(decoded);
+            const parsed = deserialize(decoded);
             // Check TTL
             if (this.isExpired(parsed)) {
                 this.removeSync(key);
@@ -118,7 +119,7 @@ export class CookieAdapter extends BaseAdapter {
         const cookieKey = this.prefix + key;
         const oldValue = this.getSync(key);
         try {
-            const serialized = JSON.stringify(value);
+            const serialized = serialize(value);
             const encoded = encodeURIComponent(serialized);
             // Check size limit
             if (encoded.length > this.maxCookieSize) {
@@ -153,8 +154,21 @@ export class CookieAdapter extends BaseAdapter {
      * Remove a value from cookies (synchronous)
      */
     removeSync(key) {
-        const oldValue = this.getSync(key);
         const cookieKey = this.prefix + key;
+        // Read raw — NOT via getSync(), which deletes expired cookies by calling
+        // removeSync() and would recurse here forever. Only read with a listener.
+        let oldValue = null;
+        if (this.hasChangeListeners()) {
+            const raw = this.getCookie(cookieKey);
+            if (raw) {
+                try {
+                    oldValue = deserialize(decodeURIComponent(raw));
+                }
+                catch {
+                    oldValue = null;
+                }
+            }
+        }
         this.deleteCookie(cookieKey);
         if (oldValue) {
             this.emitChange(key, oldValue.value, undefined, 'local');
@@ -289,6 +303,16 @@ export class CookieAdapter extends BaseAdapter {
     setCookie(name, value, options = {}) {
         if (typeof document === 'undefined')
             return;
+        // The value is percent-encoded by the caller, but the NAME is written raw —
+        // reject cookie-control characters in it so a crafted key cannot inject
+        // extra attributes (`; Path=/`) or additional cookies (`; evil=1`).
+        const hasControlChar = [...name].some((ch) => {
+            const code = ch.charCodeAt(0);
+            return code < 0x20 || code === 0x7f;
+        });
+        if (/[;=,\s]/.test(name) || hasControlChar) {
+            throw new StorageError(`Invalid cookie name "${name}": contains forbidden characters`);
+        }
         let cookie = `${name}=${value}`;
         if (options.maxAge !== undefined) {
             cookie += `; max-age=${options.maxAge}`;

package/dist/adapters/web/IndexedDBAdapter.d.ts

@@ -2,8 +2,8 @@
  * IndexedDB Adapter - Browser IndexedDB implementation
  * Provides large-scale persistent storage with advanced features
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo, QueryCondition, Transaction } from '@/types';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo, QueryCondition, Transaction } from "../../types/index.js";
 /**
  * Browser IndexedDB adapter
  */
@@ -63,7 +63,14 @@ export declare class IndexedDBAdapter extends BaseAdapter {
      */
     size(detailed?: boolean): Promise<SizeInfo>;
     /**
-     * Begin a transaction
+     * Begin a transaction.
+     *
+     * IMPORTANT — IndexedDB transactions auto-commit as soon as control returns to
+     * the event loop with no pending requests. Issue all `set`/`remove`/`get`
+     * calls back-to-back and `await` them together (e.g. `Promise.all([...])`)
+     * BEFORE awaiting anything unrelated. Awaiting a non-IndexedDB promise between
+     * operations lets the transaction close, after which further calls fail with
+     * `TransactionInactiveError`. For most multi-write needs prefer `setMany()`.
      */
     transaction(): Promise<Transaction>;
     /**

package/dist/adapters/web/IndexedDBAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IndexedDBAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/web/IndexedDBAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,WAAW,EACZ,MAAM,SAAS,CAAC;AAKjB;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAe;IACzC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,EAAE,CAAC,CAAc;gBAEb,MAAM,SAAkB,EAAE,SAAS,SAAY,EAAE,OAAO,SAAI;IAOxE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC;IASjB;;OAEG;YACW,YAAY;IAgC1B;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAiCpE;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B1E;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBxC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBlD;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA4BxD;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IA2C9F;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAwDjD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAQzC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;OAEG;IACH,OAAO,CAAC,YAAY;CAMrB"}
+{"version":3,"file":"IndexedDBAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/web/IndexedDBAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,WAAW,EACZ,MAAM,SAAS,CAAC;AAKjB;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAe;IACzC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,EAAE,CAAC,CAAc;gBAEb,MAAM,SAAkB,EAAE,SAAS,SAAY,EAAE,OAAO,SAAI;IAOxE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC;IASjB;;OAEG;YACW,YAAY;IAgC1B;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAiCpE;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B1E;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BxC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBlD;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA4BxD;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IA2C9F;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAwDjD;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAQzC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;OAEG;IACH,OAAO,CAAC,YAAY;CAMrB"}

package/dist/adapters/web/IndexedDBAdapter.js

@@ -139,7 +139,11 @@ export class IndexedDBAdapter extends BaseAdapter {
      */
     async remove(key) {
         const db = await this.openDatabase();
-        const oldValue = await this.get(key);
+        // Only read the old value when a listener needs it. get() on an expired key
+        // fire-and-forgets remove(), so an unconditional read here spawns redundant
+        // remove→get cycles; gating also drops the read for this observable:false
+        // adapter.
+        const oldValue = this.hasChangeListeners() ? await this.get(key) : null;
         const { promise, resolve, reject } = createDeferred();
         const transaction = db.transaction([this.storeName], 'readwrite');
         const store = transaction.objectStore(this.storeName);
@@ -281,7 +285,14 @@ export class IndexedDBAdapter extends BaseAdapter {
         return promise;
     }
     /**
-     * Begin a transaction
+     * Begin a transaction.
+     *
+     * IMPORTANT — IndexedDB transactions auto-commit as soon as control returns to
+     * the event loop with no pending requests. Issue all `set`/`remove`/`get`
+     * calls back-to-back and `await` them together (e.g. `Promise.all([...])`)
+     * BEFORE awaiting anything unrelated. Awaiting a non-IndexedDB promise between
+     * operations lets the transaction close, after which further calls fail with
+     * `TransactionInactiveError`. For most multi-write needs prefer `setMany()`.
      */
     async transaction() {
         const db = await this.openDatabase();
@@ -328,7 +339,7 @@ class IndexedDBTransaction {
         const request = this.store.get(key);
         request.onsuccess = () => {
             const result = request.result;
-            resolve(result ? result.value : null);
+            resolve(result ? (result.value?.value ?? result.value) : null);
         };
         request.onerror = () => reject(new StorageError(`Transaction get failed: ${request.error}`));
         return promise;
@@ -340,7 +351,11 @@ class IndexedDBTransaction {
         const now = Date.now();
         const record = {
             key,
-            value,
+            value: {
+                value,
+                created: now,
+                updated: now,
+            },
             created: now,
             updated: now,
         };

package/dist/adapters/web/LocalStorageAdapter.d.ts

@@ -2,8 +2,8 @@
  * LocalStorage Adapter - Browser localStorage implementation
  * Provides persistent storage with 5-10MB limit
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo, SubscriptionCallback, UnsubscribeFunction } from '@/types';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo, SubscriptionCallback, UnsubscribeFunction } from "../../types/index.js";
 /**
  * Browser localStorage adapter
  */

package/dist/adapters/web/LocalStorageAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocalStorageAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/web/LocalStorageAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAKjB;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;IAClD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAkB;IAC5C,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,CAAa;gBAE9E,MAAM,SAAK;IAKvB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7D;;;;;OAKG;IACH,SAAS,CAAC,UAAU,IAAI,OAAO;IAO/B;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAIpE;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAoBzD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAqB/D;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAS7B;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAiDvC;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIxD;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE;IAoB7C;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK7B;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAwCjD;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,mBAAmB;IAuC9D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAUhD"}
+{"version":3,"file":"LocalStorageAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/web/LocalStorageAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAKjB;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;IAClD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAkB;IAC5C,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,CAAa;gBAE9E,MAAM,SAAK;IAKvB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7D;;;;;OAKG;IACH,SAAS,CAAC,UAAU,IAAI,OAAO;IAO/B;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAIpE;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAoBzD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAqB/D;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAuB7B;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAiDvC;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIxD;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE;IAoB7C;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK7B;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAwCjD;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,mBAAmB;IAuC9D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAUhD"}

package/dist/adapters/web/LocalStorageAdapter.js

@@ -132,7 +132,21 @@ export class LocalStorageAdapter extends BaseAdapter {
      * Remove a value from localStorage (synchronous)
      */
     removeSync(key) {
-        const oldValue = this.getSync(key);
+        // Read the raw stored value directly — NOT via getSync(), which deletes an
+        // expired entry by calling removeSync(), recursing here forever (stack
+        // overflow). Only read when a listener actually needs the old value.
+        let oldValue = null;
+        if (this.hasChangeListeners()) {
+            const item = this.getStorage().getItem(this.prefix + key);
+            if (item) {
+                try {
+                    oldValue = deserialize(item);
+                }
+                catch {
+                    oldValue = null;
+                }
+            }
+        }
         this.getStorage().removeItem(this.prefix + key);
         if (oldValue) {
             this.emitChange(key, oldValue.value, undefined, 'local');

package/dist/adapters/web/MemoryAdapter.d.ts

@@ -2,8 +2,8 @@
  * Memory Adapter - In-memory storage implementation
  * Provides fast, non-persistent storage using Map
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, QueryCondition } from '@/types';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, QueryCondition } from "../../types/index.js";
 /**
  * In-memory storage adapter using Map
  */
@@ -27,6 +27,13 @@ export declare class MemoryAdapter extends BaseAdapter {
      * Get a value from memory
      */
     get<T = unknown>(key: string): Promise<StorageValue<T> | null>;
+    /**
+     * Clone a stored value to isolate it from external mutation. Prefers
+     * structuredClone (preserves Map/Set/Date/TypedArray/ArrayBuffer — so the
+     * advertised `binary: true` capability holds), falling back to deepClone where
+     * structuredClone is unavailable or the value isn't structured-cloneable.
+     */
+    private clone;
     /**
      * Get a value from memory (synchronous)
      */

package/dist/adapters/web/MemoryAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MemoryAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/web/MemoryAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,cAAc,EACf,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAY;IACtC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,WAAW,CAAK;IAExB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAIpE;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAezD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAiC/D;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAW7B;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IA+CvC;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK7B;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIxD;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE;IAkB7C;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IAyB9F;;OAEG;IACH,cAAc,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAOlD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}
+{"version":3,"file":"MemoryAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/web/MemoryAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,cAAc,EACf,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAY;IACtC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,WAAW,CAAK;IAExB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAIpE;;;;;OAKG;IACH,OAAO,CAAC,KAAK;IAWb;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAezD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAiC/D;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAW7B;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IA+CvC;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK7B;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIxD;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE;IAkB7C;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IAyB9F;;OAEG;IACH,cAAc,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAOlD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/adapters/web/MemoryAdapter.js

@@ -43,6 +43,23 @@ export class MemoryAdapter extends BaseAdapter {
     async get(key) {
         return this.getSync(key);
     }
+    /**
+     * Clone a stored value to isolate it from external mutation. Prefers
+     * structuredClone (preserves Map/Set/Date/TypedArray/ArrayBuffer — so the
+     * advertised `binary: true` capability holds), falling back to deepClone where
+     * structuredClone is unavailable or the value isn't structured-cloneable.
+     */
+    clone(value) {
+        if (typeof structuredClone === 'function') {
+            try {
+                return structuredClone(value);
+            }
+            catch {
+                // Fall through to deepClone (e.g. value carries a non-cloneable field).
+            }
+        }
+        return deepClone(value);
+    }
     /**
      * Get a value from memory (synchronous)
      */
@@ -55,8 +72,8 @@ export class MemoryAdapter extends BaseAdapter {
             this.removeSync(key);
             return null;
         }
-        // Return a deep clone to prevent external modifications
-        return deepClone(value);
+        // Return a clone to prevent external modifications
+        return this.clone(value);
     }
     /**
      * Set a value in memory
@@ -83,8 +100,8 @@ export class MemoryAdapter extends BaseAdapter {
                 });
             }
         }
-        // Store a deep clone to prevent external modifications
-        const clonedValue = deepClone(value);
+        // Store a clone to prevent external modifications
+        const clonedValue = this.clone(value);
         this.storage.set(key, clonedValue);
         // Update size tracking
         if (oldValue) {
@@ -214,7 +231,7 @@ export class MemoryAdapter extends BaseAdapter {
                 if (matches) {
                     results.push({
                         key,
-                        value: deepClone(item.value),
+                        value: this.clone(item.value),
                     });
                 }
             }

package/dist/adapters/web/SessionStorageAdapter.d.ts

@@ -2,8 +2,8 @@
  * SessionStorage Adapter - Browser sessionStorage implementation
  * Provides session-scoped storage with 5-10MB limit
  */
-import { LocalStorageAdapter } from './LocalStorageAdapter';
-import type { StorageType, StorageCapabilities } from '@/types';
+import { LocalStorageAdapter } from "./LocalStorageAdapter.js";
+import type { StorageType, StorageCapabilities } from "../../types/index.js";
 /**
  * Browser sessionStorage adapter
  * Extends LocalStorageAdapter as the API is identical
@@ -23,19 +23,19 @@ export declare class SessionStorageAdapter extends LocalStorageAdapter {
     /**
      * Get a value from sessionStorage
      */
-    get<T = unknown>(key: string): Promise<import('@/types').StorageValue<T> | null>;
+    get<T = unknown>(key: string): Promise<import("../../types/index.js").StorageValue<T> | null>;
     /**
      * Get a value from sessionStorage (synchronous)
      */
-    getSync<T = unknown>(key: string): import('@/types').StorageValue<T> | null;
+    getSync<T = unknown>(key: string): import("../../types/index.js").StorageValue<T> | null;
     /**
      * Set a value in sessionStorage
      */
-    set<T = unknown>(key: string, value: import('@/types').StorageValue<T>): Promise<void>;
+    set<T = unknown>(key: string, value: import("../../types/index.js").StorageValue<T>): Promise<void>;
     /**
      * Set a value in sessionStorage (synchronous)
      */
-    setSync<T = unknown>(key: string, value: import('@/types').StorageValue<T>): void;
+    setSync<T = unknown>(key: string, value: import("../../types/index.js").StorageValue<T>): void;
     /**
      * Remove a value from sessionStorage
      */
@@ -47,11 +47,11 @@ export declare class SessionStorageAdapter extends LocalStorageAdapter {
     /**
      * Clear sessionStorage
      */
-    clear(options?: import('@/types').ClearOptions): Promise<void>;
+    clear(options?: import("../../types/index.js").ClearOptions): Promise<void>;
     /**
      * Clear sessionStorage (synchronous)
      */
-    clearSync(options?: import('@/types').ClearOptions): void;
+    clearSync(options?: import("../../types/index.js").ClearOptions): void;
     /**
      * Get all keys
      */
@@ -67,11 +67,11 @@ export declare class SessionStorageAdapter extends LocalStorageAdapter {
     /**
      * Get storage size
      */
-    size(detailed?: boolean): Promise<import('@/types').SizeInfo>;
+    size(detailed?: boolean): Promise<import("../../types/index.js").SizeInfo>;
     /**
      * Subscribe to storage changes
      * Note: sessionStorage doesn't fire storage events in the same tab
      */
-    subscribe(callback: import('@/types').SubscriptionCallback): import('@/types').UnsubscribeFunction;
+    subscribe(callback: import("../../types/index.js").SubscriptionCallback): import("../../types/index.js").UnsubscribeFunction;
 }
 //# sourceMappingURL=SessionStorageAdapter.d.ts.map

package/dist/adapters/web/SessionStorageAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionStorageAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/web/SessionStorageAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEhE;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,mBAAmB;IAC5D,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAoB;IAC9C,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;gBAEU,MAAM,SAAK;IAIvB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;OAEG;IACH,SAAS,CAAC,UAAU,IAAI,OAAO;IAO/B;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAItF;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAoB3E;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5F;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAkBjF;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAS7B;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,SAAS,EAAE,YAAY,GAAG,IAAI;IAgDzD;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIxD;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE;IAmB7C;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK7B;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,SAAS,EAAE,QAAQ,CAAC;IAwCnE;;;OAGG;IACH,SAAS,CACP,QAAQ,EAAE,OAAO,SAAS,EAAE,oBAAoB,GAC/C,OAAO,SAAS,EAAE,mBAAmB;CAKzC"}
+{"version":3,"file":"SessionStorageAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/web/SessionStorageAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAI5D,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEhE;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,mBAAmB;IAC5D,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAoB;IAC9C,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;gBAEU,MAAM,SAAK;IAIvB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;OAEG;IACH,SAAS,CAAC,UAAU,IAAI,OAAO;IAO/B;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAItF;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAoB3E;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5F;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAkBjF;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAsB7B;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,SAAS,EAAE,YAAY,GAAG,IAAI;IAgDzD;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIxD;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE;IAmB7C;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK7B;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,SAAS,EAAE,QAAQ,CAAC;IAwCnE;;;OAGG;IACH,SAAS,CACP,QAAQ,EAAE,OAAO,SAAS,EAAE,oBAAoB,GAC/C,OAAO,SAAS,EAAE,mBAAmB;CAKzC"}

package/dist/adapters/web/SessionStorageAdapter.js

@@ -3,6 +3,7 @@
  * Provides session-scoped storage with 5-10MB limit
  */
 import { LocalStorageAdapter } from "./LocalStorageAdapter.js";
+import { serialize, deserialize } from "../../utils/index.js";
 import { QuotaExceededError, SerializationError, StorageError } from "../../utils/errors.js";
 import { logger } from "../../utils/logger.js";
 /**
@@ -66,7 +67,7 @@ export class SessionStorageAdapter extends LocalStorageAdapter {
             const item = window.sessionStorage.getItem(this.prefix + key);
             if (!item)
                 return null;
-            const value = JSON.parse(item);
+            const value = deserialize(item);
             // Check TTL
             if (this.isExpired(value)) {
                 this.removeSync(key);
@@ -92,7 +93,7 @@ export class SessionStorageAdapter extends LocalStorageAdapter {
         const fullKey = this.prefix + key;
         const oldValue = this.getSync(key);
         try {
-            const serialized = JSON.stringify(value);
+            const serialized = serialize(value);
             window.sessionStorage.setItem(fullKey, serialized);
         }
         catch (error) {
@@ -114,7 +115,20 @@ export class SessionStorageAdapter extends LocalStorageAdapter {
      * Remove a value from sessionStorage (synchronous)
      */
     removeSync(key) {
-        const oldValue = this.getSync(key);
+        // Read raw — NOT via getSync(), which deletes expired entries by calling
+        // removeSync() and would recurse here forever. Only read with a listener.
+        let oldValue = null;
+        if (this.hasChangeListeners()) {
+            const item = window.sessionStorage.getItem(this.prefix + key);
+            if (item) {
+                try {
+                    oldValue = deserialize(item);
+                }
+                catch {
+                    oldValue = null;
+                }
+            }
+        }
         window.sessionStorage.removeItem(this.prefix + key);
         if (oldValue) {
             this.emitChange(key, oldValue.value, undefined, 'local');

package/dist/adapters/web/URLAdapter.d.ts

@@ -12,8 +12,8 @@
  * - Query mode is visible to the server on navigation; hash mode is client-only.
  * - Not available outside a browser (SSR/Node) — `isAvailable()` returns false.
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import type { StorageType, StorageCapabilities, StorageValue, ClearOptions } from '@/types';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import type { StorageType, StorageCapabilities, StorageValue, ClearOptions } from "../../types/index.js";
 /** Configuration for the URL adapter. */
 export interface URLAdapterConfig {
     /** Where to store params: query string (default) or hash fragment. */

package/dist/adapters/web/index.d.ts

@@ -1,11 +1,11 @@
 /**
  * Web storage adapters
  */
-export { MemoryAdapter } from './MemoryAdapter';
-export { LocalStorageAdapter } from './LocalStorageAdapter';
-export { SessionStorageAdapter } from './SessionStorageAdapter';
-export { IndexedDBAdapter } from './IndexedDBAdapter';
-export { CookieAdapter } from './CookieAdapter';
-export { CacheAdapter } from './CacheAdapter';
-export { URLAdapter, type URLAdapterConfig } from './URLAdapter';
+export { MemoryAdapter } from "./MemoryAdapter.js";
+export { LocalStorageAdapter } from "./LocalStorageAdapter.js";
+export { SessionStorageAdapter } from "./SessionStorageAdapter.js";
+export { IndexedDBAdapter } from "./IndexedDBAdapter.js";
+export { CookieAdapter } from "./CookieAdapter.js";
+export { CacheAdapter } from "./CacheAdapter.js";
+export { URLAdapter, type URLAdapterConfig } from "./URLAdapter.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/capacitor.d.ts

@@ -1,9 +1,9 @@
-import type { Strata } from './core/Strata';
-export { PreferencesAdapter } from './adapters/capacitor/PreferencesAdapter';
-export { SqliteAdapter } from './adapters/capacitor/SqliteAdapter';
-export { SecureAdapter } from './adapters/capacitor/SecureAdapter';
-export { FilesystemAdapter } from './adapters/capacitor/FilesystemAdapter';
-export { StrataStorage } from './plugin';
+import type { Strata } from "./core/Strata.js";
+export { PreferencesAdapter } from "./adapters/capacitor/PreferencesAdapter.js";
+export { SqliteAdapter } from "./adapters/capacitor/SqliteAdapter.js";
+export { SecureAdapter } from "./adapters/capacitor/SecureAdapter.js";
+export { FilesystemAdapter } from "./adapters/capacitor/FilesystemAdapter.js";
+export { StrataStorage } from "./plugin/index.js";
 /**
  * Register Capacitor adapters with a Strata instance
  * This is completely optional and only needed for Capacitor apps

package/dist/capacitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capacitor.d.ts","sourceRoot":"","sources":["../src/capacitor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAQ5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAG3E,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB9E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAShD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAEnD"}
+{"version":3,"file":"capacitor.d.ts","sourceRoot":"","sources":["../src/capacitor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAQ5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAG3E,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB9E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAShD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAEnD"}

package/dist/capacitor.js

@@ -28,10 +28,11 @@ export async function registerCapacitorAdapters(storage) {
     storage.registerAdapter(new SqliteAdapter());
     storage.registerAdapter(new SecureAdapter());
     storage.registerAdapter(new FilesystemAdapter());
-    // Re-initialize to make new adapters available
-    if (storage.isInitialized) {
-        await storage.initialize();
-    }
+    // Attach the newly registered adapters. initialize() is idempotent and would
+    // NOT pick up adapters registered after first init, so refreshAdapters()
+    // initializes + attaches them (and re-selects the default) whether or not the
+    // instance was already initialized.
+    await storage.refreshAdapters();
 }
 /**
  * Helper to check if running in Capacitor environment

package/dist/core/AdapterRegistry.d.ts

@@ -1,7 +1,7 @@
 /**
  * Registry for managing storage adapters
  */
-import type { StorageAdapter, StorageType } from '@/types';
+import type { StorageAdapter, StorageType } from "../types/index.js";
 /**
  * Adapter registry for managing storage adapters
  */

package/dist/core/BaseAdapter.d.ts

@@ -1,9 +1,9 @@
 /**
  * Base adapter implementation with common functionality
  */
-import type { StorageAdapter, StorageValue, StorageType, StorageCapabilities, ClearOptions, SizeInfo, SubscriptionCallback, UnsubscribeFunction, QueryCondition } from '@/types';
-import { EventEmitter } from '@/utils';
-import { QueryEngine } from '@/features/query';
+import type { StorageAdapter, StorageValue, StorageType, StorageCapabilities, ClearOptions, SizeInfo, SubscriptionCallback, UnsubscribeFunction, QueryCondition } from "../types/index.js";
+import { EventEmitter } from "../utils/index.js";
+import { QueryEngine } from "../features/query.js";
 /**
  * Abstract base adapter that implements common functionality
  */
@@ -23,9 +23,16 @@ export declare abstract class BaseAdapter implements StorageAdapter {
      */
     protected stopTTLCleanup(): void;
     /**
-     * Clean up expired items
+     * Clean up expired items, returning how many were removed.
+     *
+     * Default implementation is a per-key sweep (enumerate keys, drop the expired
+     * ones). Backends that can filter expired rows in the storage engine itself
+     * (e.g. SQLite) override this with a single bulk delete — and because such a
+     * backend's `keys()` no longer surfaces expired entries, this per-key sweep
+     * would not see them anyway. Called by the automatic TTL tick and by
+     * `Strata.cleanupExpired()`.
      */
-    protected cleanupExpired(): Promise<void>;
+    cleanupExpired(): Promise<number>;
     /**
      * Check if value is expired
      */
@@ -62,6 +69,15 @@ export declare abstract class BaseAdapter implements StorageAdapter {
      * Subscribe to changes (if supported)
      */
     subscribe(callback: SubscriptionCallback): UnsubscribeFunction;
+    /**
+     * Whether any subscriber is currently attached to this adapter's change
+     * stream. Adapters that talk to a slow backend (native bridge, network) use
+     * this to avoid a wasted read-before-write: fetching the previous value just
+     * to populate a change event is pointless when nobody is listening. When a
+     * subscriber IS attached, callers must still capture the old value so the
+     * emitted change is complete. See `SqliteAdapter.set`/`remove`.
+     */
+    protected hasChangeListeners(): boolean;
     /**
      * Emit change event
      */