strata-storage 2.6.0 → 2.7.0

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/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;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;;;;;;;;;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

@@ -281,7 +281,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 +335,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 +347,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/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
  */

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;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"}

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) {

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
      */

package/dist/core/BaseAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseAdapter.d.ts","sourceRoot":"","sources":["../../src/core/BaseAdapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BaseAdapter.d.ts","sourceRoot":"","sources":["../../src/core/BaseAdapter.ts"],"names":[],"mappings":"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"}

package/dist/core/BaseAdapter.js

@@ -38,17 +38,27 @@ export class BaseAdapter {
         }
     }
     /**
-     * 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()`.
      */
     async cleanupExpired() {
         const now = Date.now();
         const keys = await this.keys();
+        let removed = 0;
         for (const key of keys) {
             const item = await this.get(key);
             if (item?.expires && item.expires <= now) {
                 await this.remove(key);
+                removed++;
             }
         }
+        return removed;
     }
     /**
      * Check if value is expired
@@ -135,6 +145,13 @@ export class BaseAdapter {
                     shouldDelete = false;
                 }
             }
+            if (shouldDelete && options?.olderThan !== undefined) {
+                const value = await this.get(key);
+                const olderThan = options.olderThan instanceof Date ? options.olderThan.getTime() : options.olderThan;
+                if (!value || value.created >= olderThan) {
+                    shouldDelete = false;
+                }
+            }
             if (shouldDelete) {
                 await this.remove(key);
             }
@@ -194,6 +211,17 @@ export class BaseAdapter {
             this.eventEmitter.off('change', handler);
         };
     }
+    /**
+     * 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`.
+     */
+    hasChangeListeners() {
+        return this.eventEmitter.listenerCount('change') > 0;
+    }
     /**
      * Emit change event
      */

package/dist/core/Strata.d.ts

@@ -2,8 +2,8 @@
  * Strata Storage - Main entry point
  * Zero-dependency universal storage solution
  */
-import type { StrataConfig, StorageAdapter, StorageOptions, StorageType, Platform, SizeInfo, ClearOptions, ExportOptions, ImportOptions, SubscriptionCallback, UnsubscribeFunction, QueryCondition, StorageCapabilities } from '@/types';
-import { AdapterRegistry } from './AdapterRegistry';
+import type { StrataConfig, StorageAdapter, StorageOptions, StorageType, Platform, SizeInfo, ClearOptions, ExportOptions, ImportOptions, SubscriptionCallback, UnsubscribeFunction, QueryCondition, QueryOptions, StorageCapabilities } from "../types/index.js";
+import { AdapterRegistry } from "./AdapterRegistry.js";
 /**
  * Main Strata class - unified storage interface
  */
@@ -17,9 +17,11 @@ export declare class Strata {
     private compressionManager?;
     private syncManager?;
     private ttlManager?;
+    private readonly queryEngine;
     private _initialized;
     private _readyPromise?;
     private _autoBackupTimer?;
+    private _ttlCleanupTimer?;
     constructor(config?: StrataConfig);
     /**
      * Check if Strata has been initialized
@@ -49,7 +51,7 @@ export declare class Strata {
      * @param options - Storage options
      * @param options.storage - Specific storage type to use (e.g., 'localStorage', 'indexedDB')
      * @param options.decrypt - Whether to decrypt the value (default: auto-detect)
-     * @param options.decryptionPassword - Password for decryption (uses config password if not provided)
+     * @param options.encryptionPassword - Password for decryption (uses config password if not provided)
      * @returns The stored value or null if not found
      * @throws {StorageError} If the storage adapter is not available
      * @throws {EncryptionError} If decryption fails
@@ -64,11 +66,18 @@ export declare class Strata {
      *
      * // Get encrypted value
      * const value = await storage.get('secure-key', {
-     *   decryptionPassword: 'myPassword'
+     *   encryptionPassword: 'myPassword'
      * });
      * ```
      */
     get<T = unknown>(key: string, options?: StorageOptions): Promise<T | null>;
+    /**
+     * Reverse the write-time transform pipeline on a stored wrapper: decrypt (if
+     * encrypted) and then decompress (if compressed). Shared by get() and query()
+     * so query results are decoded identically to direct reads. Returns the raw
+     * encrypted payload when `skipDecryption` is set.
+     */
+    private decodeStoredValue;
     /**
      * Set a value in storage
      *
@@ -172,6 +181,8 @@ export declare class Strata {
      * ```
      */
     clear(options?: ClearOptions & StorageOptions): Promise<void>;
+    /** Expiry check that works before the TTL manager exists (e.g. pre-init). */
+    private isItemExpired;
     /**
      * Get all keys from storage
      *
@@ -216,7 +227,7 @@ export declare class Strata {
     /**
      * Get storage size information
      */
-    size(detailed?: boolean): Promise<SizeInfo>;
+    size(detailed?: boolean, options?: StorageOptions): Promise<SizeInfo>;
     /**
      * Subscribe to storage changes
      */
@@ -224,14 +235,18 @@ export declare class Strata {
     /**
      * Query storage (if supported)
      */
-    query<T = unknown>(condition: QueryCondition, options?: StorageOptions): Promise<Array<{
+    query<T = unknown>(condition: QueryCondition, options?: StorageOptions & QueryOptions): Promise<Array<{
         key: string;
         value: T;
     }>>;
+    /** Apply QueryOptions (sort → skip → limit → select) to decoded query results. */
+    private applyQueryOptions;
     /**
      * Export storage data
      */
     export(options?: ExportOptions): Promise<string>;
+    /** Detect a full StorageValue wrapper (e.g. from export({ includeMetadata })). */
+    private isStorageValueWrapper;
     /**
      * Import storage data
      */
@@ -294,11 +309,19 @@ export declare class Strata {
      *
      * @example
      * ```typescript
-     * import { MyCustomAdapter } from './my-adapter';
+     * import { MyCustomAdapter } from "./my-adapter.js";
      * storage.registerAdapter(new MyCustomAdapter());
      * ```
      */
     registerAdapter(adapter: StorageAdapter): void;
+    /**
+     * Initialize and attach any registered adapters that are not yet active, then
+     * re-pick the default adapter. Call this after `registerAdapter()` on an
+     * already-initialized instance (e.g. `registerCapacitorAdapters()`), so the
+     * newly registered adapters become available to multi-adapter operations
+     * (keys/clear/size/subscribe) — not just to explicit `{ storage }` calls.
+     */
+    refreshAdapters(): Promise<void>;
     /**
      * Get the adapter registry (for advanced use cases)
      * @internal
@@ -310,6 +333,16 @@ export declare class Strata {
     close(): Promise<void>;
     private normalizeConfig;
     private detectPlatform;
+    /** Effective namespace for an operation: a per-call value wins over the
+     * instance default (`config.namespace`). Empty strings are treated as none. */
+    private effectiveNamespace;
+    /** Map a logical key to the physical key actually stored (namespace-prefixed). */
+    private resolveKey;
+    /** Reduce physical keys to the logical keys owned by `ns`, then apply pattern. */
+    private scopeAndStripKeys;
+    /** Pattern matcher mirroring BaseAdapter.filterKeys (prefix / glob / RegExp). */
+    private filterKeysByPattern;
+    private static normalizeTimestamp;
     private getDefaultStorages;
     private initializeAdapters;
     private selectDefaultAdapter;
@@ -320,6 +353,7 @@ export declare class Strata {
      * natively via the `storage` event and sessionStorage is per-tab, so both are
      * skipped here to avoid redundant re-writes.
      */
+    private cleanupAllAdapters;
     private applyRemoteChange;
     private mirrorAdapters;
     private mirrorWrite;

package/dist/core/Strata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Strata.d.ts","sourceRoot":"","sources":["../../src/core/Strata.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Strata.d.ts","sourceRoot":"","sources":["../../src/core/Strata.ts"],"names":[],"mappings":"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"}