strata-storage 2.4.3 → 2.5.0

package/dist/adapters/web/LocalStorageAdapter.js

@@ -4,7 +4,8 @@
  */
 import { BaseAdapter } from "../../core/BaseAdapter.js";
 import { serialize, deserialize, getObjectSize } from "../../utils/index.js";
-import { QuotaExceededError, SerializationError } from "../../utils/errors.js";
+import { QuotaExceededError, SerializationError, StorageError } from "../../utils/errors.js";
+import { logger } from "../../utils/logger.js";
 /**
  * Browser localStorage adapter
  */
@@ -12,7 +13,7 @@ export class LocalStorageAdapter extends BaseAdapter {
     name = 'localStorage';
     capabilities = {
         persistent: true,
-        synchronous: false, // We use async for consistency
+        synchronous: true, // window.localStorage backend is synchronous
         observable: true, // Via storage events
         transactional: false,
         queryable: true,
@@ -54,24 +55,42 @@ export class LocalStorageAdapter extends BaseAdapter {
         }
         this.startTTLCleanup();
     }
+    /**
+     * Get the backing Storage object.
+     * Subclasses (e.g. SessionStorageAdapter) override this to target a
+     * different Storage. All sync/async methods route through it so the
+     * subclass inherits correct behavior.
+     */
+    getStorage() {
+        if (typeof window === 'undefined' || !window.localStorage) {
+            throw new StorageError(`${this.name} is not available in this environment (no window).`);
+        }
+        return window.localStorage;
+    }
     /**
      * Get a value from localStorage
      */
     async get(key) {
+        return this.getSync(key);
+    }
+    /**
+     * Get a value from localStorage (synchronous)
+     */
+    getSync(key) {
         try {
-            const item = window.localStorage.getItem(this.prefix + key);
+            const item = this.getStorage().getItem(this.prefix + key);
             if (!item)
                 return null;
             const value = deserialize(item);
             // Check TTL
             if (this.isExpired(value)) {
-                await this.remove(key);
+                this.removeSync(key);
                 return null;
             }
             return value;
         }
         catch (error) {
-            console.error(`Failed to get key ${key} from localStorage:`, error);
+            logger.error(`Failed to get key ${key} from ${this.name}:`, error);
             return null;
         }
     }
@@ -79,20 +98,26 @@ export class LocalStorageAdapter extends BaseAdapter {
      * Set a value in localStorage
      */
     async set(key, value) {
+        this.setSync(key, value);
+    }
+    /**
+     * Set a value in localStorage (synchronous)
+     */
+    setSync(key, value) {
         const fullKey = this.prefix + key;
-        const oldValue = await this.get(key);
+        const oldValue = this.getSync(key);
         try {
             const serialized = serialize(value);
-            window.localStorage.setItem(fullKey, serialized);
+            this.getStorage().setItem(fullKey, serialized);
         }
         catch (error) {
             if (this.isQuotaError(error)) {
-                throw new QuotaExceededError('LocalStorage quota exceeded', {
+                throw new QuotaExceededError(`${this.name} quota exceeded`, {
                     key,
                     size: getObjectSize(value),
                 });
             }
-            throw new SerializationError(`Failed to store key ${key} in localStorage`, error);
+            throw new SerializationError(`Failed to store key ${key} in ${this.name}`, error);
         }
         // Emit change event (storage events don't fire in same window)
         this.emitChange(key, oldValue?.value, value.value, 'local');
@@ -101,8 +126,14 @@ export class LocalStorageAdapter extends BaseAdapter {
      * Remove a value from localStorage
      */
     async remove(key) {
-        const oldValue = await this.get(key);
-        window.localStorage.removeItem(this.prefix + key);
+        this.removeSync(key);
+    }
+    /**
+     * Remove a value from localStorage (synchronous)
+     */
+    removeSync(key) {
+        const oldValue = this.getSync(key);
+        this.getStorage().removeItem(this.prefix + key);
         if (oldValue) {
             this.emitChange(key, oldValue.value, undefined, 'local');
         }
@@ -111,34 +142,69 @@ export class LocalStorageAdapter extends BaseAdapter {
      * Clear localStorage
      */
     async clear(options) {
+        this.clearSync(options);
+    }
+    /**
+     * Clear localStorage (synchronous)
+     */
+    clearSync(options) {
         if (!options ||
             (!options.pattern && !options.prefix && !options.tags && !options.expiredOnly)) {
             // Clear all with our prefix
+            const storage = this.getStorage();
             const keysToRemove = [];
-            for (let i = 0; i < window.localStorage.length; i++) {
-                const key = window.localStorage.key(i);
+            for (let i = 0; i < storage.length; i++) {
+                const key = storage.key(i);
                 if (key?.startsWith(this.prefix)) {
                     keysToRemove.push(key);
                 }
             }
-            keysToRemove.forEach((key) => window.localStorage.removeItem(key));
+            keysToRemove.forEach((key) => storage.removeItem(key));
             this.emitChange('*', undefined, undefined, 'local');
             return;
         }
-        // Use base implementation for filtered clear
-        await super.clear(options);
+        // Synchronous filtered clear (mirrors BaseAdapter.clear logic)
+        for (const key of this.keysSync()) {
+            let shouldDelete = true;
+            const pattern = options.pattern || options.prefix;
+            if (pattern) {
+                shouldDelete = this.filterKeys([key], pattern).length > 0;
+            }
+            if (shouldDelete && options.tags) {
+                const value = this.getSync(key);
+                if (!value?.tags || !options.tags.some((tag) => value.tags?.includes(tag))) {
+                    shouldDelete = false;
+                }
+            }
+            if (shouldDelete && options.expiredOnly) {
+                const value = this.getSync(key);
+                if (!value || !this.isExpired(value)) {
+                    shouldDelete = false;
+                }
+            }
+            if (shouldDelete) {
+                this.removeSync(key);
+            }
+        }
     }
     /**
      * Get all keys
      */
     async keys(pattern) {
+        return this.keysSync(pattern);
+    }
+    /**
+     * Get all keys (synchronous)
+     */
+    keysSync(pattern) {
+        const storage = this.getStorage();
         const keys = [];
-        for (let i = 0; i < window.localStorage.length; i++) {
-            const fullKey = window.localStorage.key(i);
+        for (let i = 0; i < storage.length; i++) {
+            const fullKey = storage.key(i);
             if (fullKey?.startsWith(this.prefix)) {
                 const key = fullKey.substring(this.prefix.length);
                 // Check if not expired
-                const value = await this.get(key);
+                const value = this.getSync(key);
                 if (value) {
                     keys.push(key);
                 }
@@ -146,6 +212,13 @@ export class LocalStorageAdapter extends BaseAdapter {
         }
         return this.filterKeys(keys, pattern);
     }
+    /**
+     * Check if key exists (synchronous)
+     */
+    hasSync(key) {
+        const value = this.getSync(key);
+        return value !== null && !this.isExpired(value);
+    }
     /**
      * Get storage size
      */

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

@@ -27,26 +27,50 @@ export declare class MemoryAdapter extends BaseAdapter {
      * Get a value from memory
      */
     get<T = unknown>(key: string): Promise<StorageValue<T> | null>;
+    /**
+     * Get a value from memory (synchronous)
+     */
+    getSync<T = unknown>(key: string): StorageValue<T> | null;
     /**
      * Set a value in memory
      */
     set<T = unknown>(key: string, value: StorageValue<T>): Promise<void>;
+    /**
+     * Set a value in memory (synchronous)
+     */
+    setSync<T = unknown>(key: string, value: StorageValue<T>): void;
     /**
      * Remove a value from memory
      */
     remove(key: string): Promise<void>;
+    /**
+     * Remove a value from memory (synchronous)
+     */
+    removeSync(key: string): void;
     /**
      * Clear memory storage
      */
     clear(options?: ClearOptions): Promise<void>;
+    /**
+     * Clear memory storage (synchronous)
+     */
+    clearSync(options?: ClearOptions): void;
     /**
      * Check if key exists
      */
     has(key: string): Promise<boolean>;
+    /**
+     * Check if key exists (synchronous)
+     */
+    hasSync(key: string): boolean;
     /**
      * Get all keys
      */
     keys(pattern?: string | RegExp): Promise<string[]>;
+    /**
+     * Get all keys (synchronous)
+     */
+    keysSync(pattern?: string | RegExp): string[];
     /**
      * Query implementation for memory adapter
      */

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;IAepE;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC1E;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBlD;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxC;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBxD;;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;IAgC9F;;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;;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

@@ -12,7 +12,7 @@ export class MemoryAdapter extends BaseAdapter {
     name = 'memory';
     capabilities = {
         persistent: false,
-        synchronous: false, // We use async for consistency
+        synchronous: true, // Map backend is synchronous
         observable: true,
         transactional: false,
         queryable: true,
@@ -41,12 +41,18 @@ export class MemoryAdapter extends BaseAdapter {
      * Get a value from memory
      */
     async get(key) {
+        return this.getSync(key);
+    }
+    /**
+     * Get a value from memory (synchronous)
+     */
+    getSync(key) {
         const value = this.storage.get(key);
         if (!value)
             return null;
         // Check TTL
         if (this.isExpired(value)) {
-            await this.remove(key);
+            this.removeSync(key);
             return null;
         }
         // Return a deep clone to prevent external modifications
@@ -56,6 +62,12 @@ export class MemoryAdapter extends BaseAdapter {
      * Set a value in memory
      */
     async set(key, value) {
+        this.setSync(key, value);
+    }
+    /**
+     * Set a value in memory (synchronous)
+     */
+    setSync(key, value) {
         const oldValue = this.storage.get(key);
         const newSize = this.calculateSize(value);
         // Check size limit if configured
@@ -86,6 +98,12 @@ export class MemoryAdapter extends BaseAdapter {
      * Remove a value from memory
      */
     async remove(key) {
+        this.removeSync(key);
+    }
+    /**
+     * Remove a value from memory (synchronous)
+     */
+    removeSync(key) {
         const value = this.storage.get(key);
         if (!value)
             return;
@@ -98,6 +116,12 @@ export class MemoryAdapter extends BaseAdapter {
      * Clear memory storage
      */
     async clear(options) {
+        this.clearSync(options);
+    }
+    /**
+     * Clear memory storage (synchronous)
+     */
+    clearSync(options) {
         if (!options ||
             (!options.pattern && !options.prefix && !options.tags && !options.expiredOnly)) {
             // Clear everything
@@ -106,8 +130,29 @@ export class MemoryAdapter extends BaseAdapter {
             this.emitChange('*', undefined, undefined, 'local');
             return;
         }
-        // Use base implementation for filtered clear
-        await super.clear(options);
+        // Synchronous filtered clear (mirrors BaseAdapter.clear logic)
+        for (const key of this.keysSync()) {
+            let shouldDelete = true;
+            const pattern = options.pattern || options.prefix;
+            if (pattern) {
+                shouldDelete = this.filterKeys([key], pattern).length > 0;
+            }
+            if (shouldDelete && options.tags) {
+                const value = this.getSync(key);
+                if (!value?.tags || !options.tags.some((tag) => value.tags?.includes(tag))) {
+                    shouldDelete = false;
+                }
+            }
+            if (shouldDelete && options.expiredOnly) {
+                const value = this.storage.get(key);
+                if (!value || !this.isExpired(value)) {
+                    shouldDelete = false;
+                }
+            }
+            if (shouldDelete) {
+                this.removeSync(key);
+            }
+        }
         // Recalculate size after filtered clear
         this.currentSize = 0;
         for (const value of this.storage.values()) {
@@ -118,6 +163,12 @@ export class MemoryAdapter extends BaseAdapter {
      * Check if key exists
      */
     async has(key) {
+        return this.hasSync(key);
+    }
+    /**
+     * Check if key exists (synchronous)
+     */
+    hasSync(key) {
         const value = this.storage.get(key);
         return value !== undefined && !this.isExpired(value);
     }
@@ -125,6 +176,12 @@ export class MemoryAdapter extends BaseAdapter {
      * Get all keys
      */
     async keys(pattern) {
+        return this.keysSync(pattern);
+    }
+    /**
+     * Get all keys (synchronous)
+     */
+    keysSync(pattern) {
         const allKeys = Array.from(this.storage.keys());
         // Remove expired entries
         const validKeys = [];
@@ -135,7 +192,7 @@ export class MemoryAdapter extends BaseAdapter {
             }
             else if (value) {
                 // Clean up expired entry
-                await this.remove(key);
+                this.removeSync(key);
             }
         }
         return this.filterKeys(validKeys, pattern);
@@ -147,19 +204,13 @@ export class MemoryAdapter extends BaseAdapter {
         const results = [];
         for (const [key, item] of this.storage.entries()) {
             if (!this.isExpired(item)) {
-                // Check if querying storage metadata (tags, metadata, etc) or the actual value
-                let matches = false;
-                // Check for storage-level properties
-                const storageProps = ['tags', 'metadata', 'created', 'updated', 'expires'];
-                const isStorageQuery = Object.keys(condition).some((k) => storageProps.includes(k));
-                if (isStorageQuery) {
-                    // Query against the storage wrapper
-                    matches = this.queryEngine.matches(item, condition);
-                }
-                else {
-                    // Query against the stored value
-                    matches = this.queryEngine.matches(item.value, condition);
-                }
+                const isStorageQuery = this.isStorageMetadataQuery(condition);
+                const normalizedCondition = isStorageQuery
+                    ? condition
+                    : this.normalizeValueQueryCondition(condition);
+                const matches = isStorageQuery
+                    ? this.queryEngine.matches(item, normalizedCondition)
+                    : this.queryEngine.matches(item.value, normalizedCondition);
                 if (matches) {
                     results.push({
                         key,

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

@@ -24,22 +24,46 @@ export declare class SessionStorageAdapter extends LocalStorageAdapter {
      * Get a value from sessionStorage
      */
     get<T = unknown>(key: string): Promise<import('@/types').StorageValue<T> | null>;
+    /**
+     * Get a value from sessionStorage (synchronous)
+     */
+    getSync<T = unknown>(key: string): import('@/types').StorageValue<T> | null;
     /**
      * Set a value in sessionStorage
      */
     set<T = unknown>(key: string, value: import('@/types').StorageValue<T>): Promise<void>;
+    /**
+     * Set a value in sessionStorage (synchronous)
+     */
+    setSync<T = unknown>(key: string, value: import('@/types').StorageValue<T>): void;
     /**
      * Remove a value from sessionStorage
      */
     remove(key: string): Promise<void>;
+    /**
+     * Remove a value from sessionStorage (synchronous)
+     */
+    removeSync(key: string): void;
     /**
      * Clear sessionStorage
      */
     clear(options?: import('@/types').ClearOptions): Promise<void>;
+    /**
+     * Clear sessionStorage (synchronous)
+     */
+    clearSync(options?: import('@/types').ClearOptions): void;
     /**
      * Get all keys
      */
     keys(pattern?: string | RegExp): Promise<string[]>;
+    /**
+     * Get all keys (synchronous)
+     */
+    keysSync(pattern?: string | RegExp): string[];
+    /**
+     * Check if key exists (synchronous)
+     */
+    hasSync(key: string): boolean;
     /**
      * Get storage size
      */

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;AAE5D,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;IAI/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;IAoBtF;;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;IAkB5F;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBpE;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmBxD;;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;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"}

package/dist/adapters/web/SessionStorageAdapter.js

@@ -3,7 +3,8 @@
  * Provides session-scoped storage with 5-10MB limit
  */
 import { LocalStorageAdapter } from "./LocalStorageAdapter.js";
-import { QuotaExceededError, SerializationError } from "../../utils/errors.js";
+import { QuotaExceededError, SerializationError, StorageError } from "../../utils/errors.js";
+import { logger } from "../../utils/logger.js";
 /**
  * Browser sessionStorage adapter
  * Extends LocalStorageAdapter as the API is identical
@@ -12,7 +13,7 @@ export class SessionStorageAdapter extends LocalStorageAdapter {
     name = 'sessionStorage';
     capabilities = {
         persistent: false, // Only for session
-        synchronous: false,
+        synchronous: true, // window.sessionStorage backend is synchronous
         observable: true,
         transactional: false,
         queryable: true,
@@ -46,12 +47,21 @@ export class SessionStorageAdapter extends LocalStorageAdapter {
      * Override all methods to use sessionStorage instead of localStorage
      */
     getStorage() {
+        if (typeof window === 'undefined' || !window.sessionStorage) {
+            throw new StorageError(`${this.name} is not available in this environment (no window).`);
+        }
         return window.sessionStorage;
     }
     /**
      * Get a value from sessionStorage
      */
     async get(key) {
+        return this.getSync(key);
+    }
+    /**
+     * Get a value from sessionStorage (synchronous)
+     */
+    getSync(key) {
         try {
             const item = window.sessionStorage.getItem(this.prefix + key);
             if (!item)
@@ -59,13 +69,13 @@ export class SessionStorageAdapter extends LocalStorageAdapter {
             const value = JSON.parse(item);
             // Check TTL
             if (this.isExpired(value)) {
-                await this.remove(key);
+                this.removeSync(key);
                 return null;
             }
             return value;
         }
         catch (error) {
-            console.error(`Failed to get key ${key} from sessionStorage:`, error);
+            logger.error(`Failed to get key ${key} from sessionStorage:`, error);
             return null;
         }
     }
@@ -73,8 +83,14 @@ export class SessionStorageAdapter extends LocalStorageAdapter {
      * Set a value in sessionStorage
      */
     async set(key, value) {
+        this.setSync(key, value);
+    }
+    /**
+     * Set a value in sessionStorage (synchronous)
+     */
+    setSync(key, value) {
         const fullKey = this.prefix + key;
-        const oldValue = await this.get(key);
+        const oldValue = this.getSync(key);
         try {
             const serialized = JSON.stringify(value);
             window.sessionStorage.setItem(fullKey, serialized);
@@ -92,7 +108,13 @@ export class SessionStorageAdapter extends LocalStorageAdapter {
      * Remove a value from sessionStorage
      */
     async remove(key) {
-        const oldValue = await this.get(key);
+        this.removeSync(key);
+    }
+    /**
+     * Remove a value from sessionStorage (synchronous)
+     */
+    removeSync(key) {
+        const oldValue = this.getSync(key);
         window.sessionStorage.removeItem(this.prefix + key);
         if (oldValue) {
             this.emitChange(key, oldValue.value, undefined, 'local');
@@ -102,6 +124,12 @@ export class SessionStorageAdapter extends LocalStorageAdapter {
      * Clear sessionStorage
      */
     async clear(options) {
+        this.clearSync(options);
+    }
+    /**
+     * Clear sessionStorage (synchronous)
+     */
+    clearSync(options) {
         if (!options ||
             (!options.pattern && !options.prefix && !options.tags && !options.expiredOnly)) {
             // Clear all with our prefix
@@ -116,20 +144,47 @@ export class SessionStorageAdapter extends LocalStorageAdapter {
             this.emitChange('*', undefined, undefined, 'local');
             return;
         }
-        // Use base implementation for filtered clear
-        await super.clear(options);
+        // Synchronous filtered clear (mirrors BaseAdapter.clear logic)
+        for (const key of this.keysSync()) {
+            let shouldDelete = true;
+            const pattern = options.pattern || options.prefix;
+            if (pattern) {
+                shouldDelete = this.filterKeys([key], pattern).length > 0;
+            }
+            if (shouldDelete && options.tags) {
+                const value = this.getSync(key);
+                if (!value?.tags || !options.tags.some((tag) => value.tags?.includes(tag))) {
+                    shouldDelete = false;
+                }
+            }
+            if (shouldDelete && options.expiredOnly) {
+                const value = this.getSync(key);
+                if (!value || !this.isExpired(value)) {
+                    shouldDelete = false;
+                }
+            }
+            if (shouldDelete) {
+                this.removeSync(key);
+            }
+        }
     }
     /**
      * Get all keys
      */
     async keys(pattern) {
+        return this.keysSync(pattern);
+    }
+    /**
+     * Get all keys (synchronous)
+     */
+    keysSync(pattern) {
         const keys = [];
         for (let i = 0; i < window.sessionStorage.length; i++) {
             const fullKey = window.sessionStorage.key(i);
             if (fullKey?.startsWith(this.prefix)) {
                 const key = fullKey.substring(this.prefix.length);
                 // Check if not expired
-                const value = await this.get(key);
+                const value = this.getSync(key);
                 if (value) {
                     keys.push(key);
                 }
@@ -137,6 +192,13 @@ export class SessionStorageAdapter extends LocalStorageAdapter {
         }
         return this.filterKeys(keys, pattern);
     }
+    /**
+     * Check if key exists (synchronous)
+     */
+    hasSync(key) {
+        const value = this.getSync(key);
+        return value !== null && !this.isExpired(value);
+    }
     /**
      * Get storage size
      */