@zappzarapp/browser-utils 1.0.0

package/dist/session/SessionStorageManager.d.ts

@@ -0,0 +1,11 @@
+import { BaseStorageManager, type BaseStorageStats, StorageConfig, type StorageConfigOptions } from '../storage';
+export type SessionStorageStats = BaseStorageStats;
+export declare class SessionStorageManager<T = unknown> extends BaseStorageManager<T> {
+    private constructor();
+    protected getNativeStorage(): Storage;
+    static create<T>(options?: StorageConfigOptions): SessionStorageManager<T>;
+    static fromConfig<T>(config: StorageConfig): SessionStorageManager<T>;
+    static withDebugLogging<T>(prefix: string): SessionStorageManager<T>;
+    static isSessionStorageAvailable(): boolean;
+}
+//# sourceMappingURL=SessionStorageManager.d.ts.map

package/dist/session/SessionStorageManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionStorageManager.d.ts","sourceRoot":"","sources":["../../src/session/SessionStorageManager.ts"],"names":[],"mappings":"AA4BA,OAAO,EACL,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,aAAa,EACb,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AAKpB,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAEnD,qBAAa,qBAAqB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,kBAAkB,CAAC,CAAC,CAAC;IAC3E,OAAO;IAQP,SAAS,CAAC,gBAAgB,IAAI,OAAO;IAWrC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,GAAE,oBAAyB,GAAG,qBAAqB,CAAC,CAAC,CAAC;IAY9E,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,GAAG,qBAAqB,CAAC,CAAC,CAAC;IAYrE,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAAC,CAAC,CAAC;IAOpE,MAAM,CAAC,yBAAyB,IAAI,OAAO;CAG5C"}

package/dist/session/SessionStorageManager.js

@@ -0,0 +1,22 @@
+import { BaseStorageManager, StorageConfig, } from '../storage';
+export class SessionStorageManager extends BaseStorageManager {
+    constructor(config, useMemory) {
+        super(config, useMemory);
+    }
+    getNativeStorage() {
+        return sessionStorage;
+    }
+    static create(options = {}) {
+        return BaseStorageManager.initStorage(StorageConfig.create(options), () => SessionStorageManager.isSessionStorageAvailable(), 'sessionStorage', (config, useMemory) => new SessionStorageManager(config, useMemory));
+    }
+    static fromConfig(config) {
+        return BaseStorageManager.initStorage(config, () => SessionStorageManager.isSessionStorageAvailable(), 'sessionStorage', (c, useMemory) => new SessionStorageManager(c, useMemory));
+    }
+    static withDebugLogging(prefix) {
+        return SessionStorageManager.fromConfig(StorageConfig.withDebugLogging(prefix));
+    }
+    static isSessionStorageAvailable() {
+        return BaseStorageManager.checkStorageAvailable(() => sessionStorage, '__session_test__');
+    }
+}
+//# sourceMappingURL=SessionStorageManager.js.map

package/dist/session/SessionStorageManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionStorageManager.js","sourceRoot":"","sources":["../../src/session/SessionStorageManager.ts"],"names":[],"mappings":"AA4BA,OAAO,EACL,kBAAkB,EAElB,aAAa,GAEd,MAAM,YAAY,CAAC;AAOpB,MAAM,OAAO,qBAAmC,SAAQ,kBAAqB;IAC3E,YAAoB,MAAqB,EAAE,SAAkB;QAC3D,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3B,CAAC;IAMS,gBAAgB;QACxB,OAAO,cAAc,CAAC;IACxB,CAAC;IASD,MAAM,CAAC,MAAM,CAAI,UAAgC,EAAE;QACjD,OAAO,kBAAkB,CAAC,WAAW,CACnC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,EAC7B,GAAG,EAAE,CAAC,qBAAqB,CAAC,yBAAyB,EAAE,EACvD,gBAAgB,EAChB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,IAAI,qBAAqB,CAAI,MAAM,EAAE,SAAS,CAAC,CACvE,CAAC;IACJ,CAAC;IAKD,MAAM,CAAC,UAAU,CAAI,MAAqB;QACxC,OAAO,kBAAkB,CAAC,WAAW,CACnC,MAAM,EACN,GAAG,EAAE,CAAC,qBAAqB,CAAC,yBAAyB,EAAE,EACvD,gBAAgB,EAChB,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC,IAAI,qBAAqB,CAAI,CAAC,EAAE,SAAS,CAAC,CAC7D,CAAC;IACJ,CAAC;IAKD,MAAM,CAAC,gBAAgB,CAAI,MAAc;QACvC,OAAO,qBAAqB,CAAC,UAAU,CAAI,aAAa,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IACrF,CAAC;IAKD,MAAM,CAAC,yBAAyB;QAC9B,OAAO,kBAAkB,CAAC,qBAAqB,CAAC,GAAG,EAAE,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IAC5F,CAAC;CACF"}

package/dist/session/index.d.ts

@@ -0,0 +1,3 @@
+export { SessionStorageManager } from './SessionStorageManager.js';
+export type { SessionStorageStats } from './SessionStorageManager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/session/index.js

@@ -0,0 +1,2 @@
+export { SessionStorageManager } from './SessionStorageManager.js';
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/storage/BaseStorageManager.d.ts

@@ -0,0 +1,37 @@
+import { Result, StorageError, ValidationError } from '../core';
+import { MemoryStorage, type StorageEntry } from './MemoryStorage';
+import { StorageConfig } from './StorageConfig';
+export declare function isStorageEntry<T>(value: unknown): value is StorageEntry<T>;
+export interface BaseStorageStats {
+    readonly count: number;
+    readonly isMemoryFallback: boolean;
+    readonly prefix: string;
+    readonly maxEntries: number;
+}
+export declare abstract class BaseStorageManager<T = unknown> {
+    protected readonly config: StorageConfig;
+    protected readonly memoryStorage: MemoryStorage<T>;
+    protected readonly isMemoryMode: boolean;
+    protected abstract getNativeStorage(): Storage;
+    protected static initStorage<M>(config: StorageConfig, isAvailable: () => boolean, storageName: string, construct: (config: StorageConfig, useMemory: boolean) => M): M;
+    protected static checkStorageAvailable(getStorage: () => Storage, testKey: string): boolean;
+    protected constructor(config: StorageConfig, useMemory: boolean);
+    set(key: string, value: T): void;
+    get(key: string): T | null;
+    getResult(key: string): Result<T | null, ValidationError | StorageError>;
+    has(key: string): boolean;
+    remove(key: string): void;
+    keys(): string[];
+    entries(): Array<{
+        key: string;
+        value: T;
+        timestamp: number;
+    }>;
+    clear(): void;
+    stats(): BaseStorageStats;
+    protected getFullKey(key: string): string;
+    protected isQuotaError(e: unknown): boolean;
+    protected enforceLimits(): void;
+    protected evictOldest(): void;
+}
+//# sourceMappingURL=BaseStorageManager.d.ts.map

package/dist/storage/BaseStorageManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseStorageManager.d.ts","sourceRoot":"","sources":["../../src/storage/BaseStorageManager.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAa,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAYhD,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC,CAAC,CAAC,CAQ1E;AAKD,MAAM,WAAW,gBAAgB;IAE/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAEnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAYD,8BAAsB,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAClD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IACzC,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACnD,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAKzC,SAAS,CAAC,QAAQ,CAAC,gBAAgB,IAAI,OAAO;IAM9C,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,EAC5B,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,OAAO,EAC1B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,KAAK,CAAC,GAC1D,CAAC;IAgBJ,SAAS,CAAC,MAAM,CAAC,qBAAqB,CAAC,UAAU,EAAE,MAAM,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAW3F,SAAS,aAAa,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO;IAe/D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IA6ChC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAiC1B,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,GAAG,IAAI,EAAE,eAAe,GAAG,YAAY,CAAC;IAmCxE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAazB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAgBzB,IAAI,IAAI,MAAM,EAAE;IAsBhB,OAAO,IAAI,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAoC9D,KAAK,IAAI,IAAI;IAmBb,KAAK,IAAI,gBAAgB;IAazB,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIzC,SAAS,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO;IAS3C,SAAS,CAAC,aAAa,IAAI,IAAI;IAkB/B,SAAS,CAAC,WAAW,IAAI,IAAI;CAuB9B"}

package/dist/storage/BaseStorageManager.js

@@ -0,0 +1,245 @@
+import { Result, StorageError, Validator } from '../core';
+import { MemoryStorage } from './MemoryStorage';
+export function isStorageEntry(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'data' in value &&
+        'timestamp' in value &&
+        typeof value['timestamp'] === 'number');
+}
+export class BaseStorageManager {
+    config;
+    memoryStorage;
+    isMemoryMode;
+    static initStorage(config, isAvailable, storageName, construct) {
+        const useMemory = !isAvailable();
+        if (useMemory && config.useMemoryFallback) {
+            config.logger.warn(`${storageName} unavailable, using in-memory storage`);
+        }
+        else if (useMemory && !config.useMemoryFallback) {
+            throw StorageError.unavailable(`${storageName} not available and memory fallback disabled`);
+        }
+        return construct(config, useMemory && config.useMemoryFallback);
+    }
+    static checkStorageAvailable(getStorage, testKey) {
+        try {
+            const storage = getStorage();
+            storage.setItem(testKey, '1');
+            storage.removeItem(testKey);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    constructor(config, useMemory) {
+        this.config = config;
+        this.memoryStorage = new MemoryStorage(config.maxEntries);
+        this.isMemoryMode = useMemory;
+    }
+    set(key, value) {
+        Validator.storageKey(key);
+        const entry = {
+            data: value,
+            timestamp: Date.now(),
+        };
+        if (this.isMemoryMode) {
+            this.memoryStorage.set(key, value);
+            this.config.logger.debug('Stored (memory):', key);
+            return;
+        }
+        const fullKey = this.getFullKey(key);
+        const storage = this.getNativeStorage();
+        try {
+            const serialized = JSON.stringify(entry);
+            storage.setItem(fullKey, serialized);
+            this.enforceLimits();
+            this.config.logger.debug('Stored:', key);
+        }
+        catch (e) {
+            if (this.isQuotaError(e)) {
+                this.config.logger.warn('Quota exceeded, evicting oldest entries');
+                this.evictOldest();
+                try {
+                    storage.setItem(fullKey, JSON.stringify(entry));
+                    this.config.logger.debug('Stored after eviction:', key);
+                }
+                catch (retryError) {
+                    throw StorageError.quotaExceeded(key, retryError);
+                }
+            }
+            else {
+                throw StorageError.serializationFailed(key, e);
+            }
+        }
+    }
+    get(key) {
+        Validator.storageKey(key);
+        if (this.isMemoryMode) {
+            const entry = this.memoryStorage.get(key);
+            return entry?.data ?? null;
+        }
+        const fullKey = this.getFullKey(key);
+        const raw = this.getNativeStorage().getItem(fullKey);
+        if (raw === null) {
+            return null;
+        }
+        try {
+            const parsed = JSON.parse(raw);
+            if (!isStorageEntry(parsed)) {
+                this.config.logger.error('Invalid storage entry structure:', key);
+                return null;
+            }
+            return parsed.data;
+        }
+        catch (e) {
+            this.config.logger.error('Failed to parse stored value:', key, e);
+            return null;
+        }
+    }
+    getResult(key) {
+        const keyResult = Validator.storageKeyResult(key);
+        if (Result.isErr(keyResult)) {
+            return keyResult;
+        }
+        if (this.isMemoryMode) {
+            const entry = this.memoryStorage.get(key);
+            return Result.ok(entry?.data ?? null);
+        }
+        const fullKey = this.getFullKey(key);
+        const raw = this.getNativeStorage().getItem(fullKey);
+        if (raw === null) {
+            return Result.ok(null);
+        }
+        try {
+            const parsed = JSON.parse(raw);
+            if (!isStorageEntry(parsed)) {
+                return Result.err(StorageError.corrupted(key, 'invalid storage entry structure'));
+            }
+            return Result.ok(parsed.data);
+        }
+        catch (e) {
+            return Result.err(StorageError.deserializationFailed(key, e));
+        }
+    }
+    has(key) {
+        Validator.storageKey(key);
+        if (this.isMemoryMode) {
+            return this.memoryStorage.has(key);
+        }
+        return this.getNativeStorage().getItem(this.getFullKey(key)) !== null;
+    }
+    remove(key) {
+        Validator.storageKey(key);
+        if (this.isMemoryMode) {
+            this.memoryStorage.delete(key);
+            this.config.logger.debug('Removed (memory):', key);
+            return;
+        }
+        this.getNativeStorage().removeItem(this.getFullKey(key));
+        this.config.logger.debug('Removed:', key);
+    }
+    keys() {
+        if (this.isMemoryMode) {
+            return this.memoryStorage.keys();
+        }
+        const keys = [];
+        const prefix = `${this.config.prefix}.`;
+        const storage = this.getNativeStorage();
+        for (let i = 0; i < storage.length; i++) {
+            const key = storage.key(i);
+            if (key?.startsWith(prefix) === true) {
+                keys.push(key.substring(prefix.length));
+            }
+        }
+        return keys;
+    }
+    entries() {
+        if (this.isMemoryMode) {
+            return this.memoryStorage.entries().map(({ key, entry }) => ({
+                key,
+                value: entry.data,
+                timestamp: entry.timestamp,
+            }));
+        }
+        const entries = [];
+        const storage = this.getNativeStorage();
+        for (const key of this.keys()) {
+            try {
+                const raw = storage.getItem(this.getFullKey(key));
+                if (raw !== null) {
+                    const parsed = JSON.parse(raw);
+                    if (!isStorageEntry(parsed)) {
+                        continue;
+                    }
+                    entries.push({ key, value: parsed.data, timestamp: parsed.timestamp });
+                }
+            }
+            catch {
+            }
+        }
+        return entries.sort((a, b) => b.timestamp - a.timestamp);
+    }
+    clear() {
+        if (this.isMemoryMode) {
+            this.memoryStorage.clear();
+            this.config.logger.debug('Cleared (memory)');
+            return;
+        }
+        const storage = this.getNativeStorage();
+        const keysToRemove = this.keys().map((k) => this.getFullKey(k));
+        for (const key of keysToRemove) {
+            storage.removeItem(key);
+        }
+        this.config.logger.debug(`Cleared ${keysToRemove.length} entries`);
+    }
+    stats() {
+        return {
+            count: this.isMemoryMode ? this.memoryStorage.size : this.keys().length,
+            isMemoryFallback: this.isMemoryMode,
+            prefix: this.config.prefix,
+            maxEntries: this.config.maxEntries,
+        };
+    }
+    getFullKey(key) {
+        return `${this.config.prefix}.${key}`;
+    }
+    isQuotaError(e) {
+        return (e instanceof Error &&
+            (e.name === 'QuotaExceededError' ||
+                e.name === 'NS_ERROR_DOM_QUOTA_REACHED' ||
+                e.message.includes('quota')));
+    }
+    enforceLimits() {
+        const entries = this.entries();
+        if (entries.length <= this.config.maxEntries) {
+            return;
+        }
+        const storage = this.getNativeStorage();
+        const toRemove = entries.slice(this.config.maxEntries);
+        for (const { key } of toRemove) {
+            storage.removeItem(this.getFullKey(key));
+        }
+        if (toRemove.length > 0) {
+            this.config.logger.debug(`Evicted ${toRemove.length} old entries (limit)`);
+        }
+    }
+    evictOldest() {
+        if (this.isMemoryMode) {
+            const evicted = this.memoryStorage.evictOldest(this.config.minSafeEntries);
+            this.config.logger.debug(`Emergency eviction (memory): ${evicted} entries`);
+            return;
+        }
+        const entries = this.entries();
+        if (entries.length <= this.config.minSafeEntries) {
+            return;
+        }
+        const storage = this.getNativeStorage();
+        const toRemove = entries.slice(this.config.minSafeEntries);
+        for (const { key } of toRemove) {
+            storage.removeItem(this.getFullKey(key));
+        }
+        this.config.logger.debug(`Emergency eviction: ${toRemove.length} entries`);
+    }
+}
+//# sourceMappingURL=BaseStorageManager.js.map

package/dist/storage/BaseStorageManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseStorageManager.js","sourceRoot":"","sources":["../../src/storage/BaseStorageManager.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAmB,SAAS,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAqB,MAAM,iBAAiB,CAAC;AAanE,MAAM,UAAU,cAAc,CAAI,KAAc;IAC9C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,WAAW,IAAI,KAAK;QACpB,OAAQ,KAAiC,CAAC,WAAW,CAAC,KAAK,QAAQ,CACpE,CAAC;AACJ,CAAC;AA0BD,MAAM,OAAgB,kBAAkB;IACnB,MAAM,CAAgB;IACtB,aAAa,CAAmB;IAChC,YAAY,CAAU;IAW/B,MAAM,CAAC,WAAW,CAC1B,MAAqB,EACrB,WAA0B,EAC1B,WAAmB,EACnB,SAA2D;QAE3D,MAAM,SAAS,GAAG,CAAC,WAAW,EAAE,CAAC;QAEjC,IAAI,SAAS,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,uCAAuC,CAAC,CAAC;QAC5E,CAAC;aAAM,IAAI,SAAS,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAClD,MAAM,YAAY,CAAC,WAAW,CAAC,GAAG,WAAW,6CAA6C,CAAC,CAAC;QAC9F,CAAC;QAED,OAAO,SAAS,CAAC,MAAM,EAAE,SAAS,IAAI,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAClE,CAAC;IAMS,MAAM,CAAC,qBAAqB,CAAC,UAAyB,EAAE,OAAe;QAC/E,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;YAC7B,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC9B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,YAAsB,MAAqB,EAAE,SAAkB;QAC7D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAI,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7D,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;IAChC,CAAC;IAWD,GAAG,CAAC,GAAW,EAAE,KAAQ;QACvB,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAE1B,MAAM,KAAK,GAAoB;YAC7B,IAAI,EAAE,KAAK;YACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QAEF,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAExC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACzC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YACrC,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;gBACnE,IAAI,CAAC,WAAW,EAAE,CAAC;gBAGnB,IAAI,CAAC;oBACH,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;oBAChD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;gBAC1D,CAAC;gBAAC,OAAO,UAAU,EAAE,CAAC;oBACpB,MAAM,YAAY,CAAC,aAAa,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,YAAY,CAAC,mBAAmB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC;IAOD,GAAG,CAAC,GAAW;QACb,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAE1B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC1C,OAAO,KAAK,EAAE,IAAI,IAAI,IAAI,CAAC;QAC7B,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAErD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAExC,IAAI,CAAC,cAAc,CAAI,MAAM,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;gBAClE,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAClE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAKD,SAAS,CAAC,GAAW;QACnB,MAAM,SAAS,GAAG,SAAS,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAE1C,OAAO,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,IAAyB,IAAI,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAErD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAExC,IAAI,CAAC,cAAc,CAAI,MAAM,CAAC,EAAE,CAAC;gBAC/B,OAAO,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,EAAE,iCAAiC,CAAC,CAAC,CAAC;YACpF,CAAC;YAED,OAAO,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,qBAAqB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAKD,GAAG,CAAC,GAAW;QACb,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAE1B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC;IACxE,CAAC;IAKD,MAAM,CAAC,GAAW;QAChB,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAE1B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,gBAAgB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC5C,CAAC;IAKD,IAAI;QACF,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QACnC,CAAC;QAED,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAExC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;gBACrC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,OAAO;QACL,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC3D,GAAG;gBACH,KAAK,EAAE,KAAK,CAAC,IAAI;gBACjB,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CAAC,CAAC;QACN,CAAC;QAED,MAAM,OAAO,GAAwD,EAAE,CAAC;QACxE,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAExC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;oBACjB,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBAExC,IAAI,CAAC,cAAc,CAAI,MAAM,CAAC,EAAE,CAAC;wBAE/B,SAAS;oBACX,CAAC;oBAED,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;gBACzE,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;YAET,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;IAKD,KAAK;QACH,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;YAC/B,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,YAAY,CAAC,MAAM,UAAU,CAAC,CAAC;IACrE,CAAC;IAKD,KAAK;QACH,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM;YACvE,gBAAgB,EAAE,IAAI,CAAC,YAAY;YACnC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC1B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;SACnC,CAAC;IACJ,CAAC;IAMS,UAAU,CAAC,GAAW;QAC9B,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;IACxC,CAAC;IAES,YAAY,CAAC,CAAU;QAC/B,OAAO,CACL,CAAC,YAAY,KAAK;YAClB,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB;gBAC9B,CAAC,CAAC,IAAI,KAAK,4BAA4B;gBACvC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAC/B,CAAC;IACJ,CAAC;IAES,aAAa;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAE/B,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACvD,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC/B,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,QAAQ,CAAC,MAAM,sBAAsB,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAES,WAAW;QAGnB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;YAC3E,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,OAAO,UAAU,CAAC,CAAC;YAC5E,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAE/B,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YACjD,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAC3D,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC/B,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,UAAU,CAAC,CAAC;IAC7E,CAAC;CACF"}

package/dist/storage/MemoryStorage.d.ts

@@ -0,0 +1,23 @@
+export interface StorageEntry<T> {
+    readonly data: T;
+    readonly timestamp: number;
+}
+export declare class MemoryStorage<T> {
+    private readonly store;
+    private readonly maxEntries;
+    constructor(maxEntries: number);
+    get(key: string): StorageEntry<T> | undefined;
+    set(key: string, data: T): void;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    keys(): string[];
+    entries(): Array<{
+        key: string;
+        entry: StorageEntry<T>;
+    }>;
+    get size(): number;
+    clear(): void;
+    private enforceLimit;
+    evictOldest(minKeep: number): number;
+}
+//# sourceMappingURL=MemoryStorage.d.ts.map

package/dist/storage/MemoryStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryStorage.d.ts","sourceRoot":"","sources":["../../src/storage/MemoryStorage.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,aAAa,CAAC,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,EAAE,MAAM;IAO9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS;IAO7C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAW/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAOzB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAO5B,IAAI,IAAI,MAAM,EAAE;IAOhB,OAAO,IAAI,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC;IASzD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAKD,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,YAAY;IAkBpB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAgBrC"}

package/dist/storage/MemoryStorage.js

@@ -0,0 +1,62 @@
+export class MemoryStorage {
+    store = new Map();
+    maxEntries;
+    constructor(maxEntries) {
+        this.maxEntries = maxEntries;
+    }
+    get(key) {
+        return this.store.get(key);
+    }
+    set(key, data) {
+        this.store.set(key, {
+            data,
+            timestamp: Date.now(),
+        });
+        this.enforceLimit();
+    }
+    has(key) {
+        return this.store.has(key);
+    }
+    delete(key) {
+        return this.store.delete(key);
+    }
+    keys() {
+        return Array.from(this.store.keys());
+    }
+    entries() {
+        return Array.from(this.store.entries())
+            .map(([key, entry]) => ({ key, entry }))
+            .sort((a, b) => b.entry.timestamp - a.entry.timestamp);
+    }
+    get size() {
+        return this.store.size;
+    }
+    clear() {
+        this.store.clear();
+    }
+    enforceLimit() {
+        if (this.store.size <= this.maxEntries) {
+            return;
+        }
+        const sorted = this.entries();
+        const toKeep = sorted.slice(0, this.maxEntries);
+        this.store.clear();
+        for (const { key, entry } of toKeep) {
+            this.store.set(key, entry);
+        }
+    }
+    evictOldest(minKeep) {
+        if (this.store.size <= minKeep) {
+            return 0;
+        }
+        const sorted = this.entries();
+        const toKeep = sorted.slice(0, minKeep);
+        const evictedCount = this.store.size - toKeep.length;
+        this.store.clear();
+        for (const { key, entry } of toKeep) {
+            this.store.set(key, entry);
+        }
+        return evictedCount;
+    }
+}
+//# sourceMappingURL=MemoryStorage.js.map

package/dist/storage/MemoryStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryStorage.js","sourceRoot":"","sources":["../../src/storage/MemoryStorage.ts"],"names":[],"mappings":"AAoBA,MAAM,OAAO,aAAa;IACP,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC3C,UAAU,CAAS;IAEpC,YAAY,UAAkB;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAKD,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAKD,GAAG,CAAC,GAAW,EAAE,IAAO;QACtB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAKD,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAKD,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAKD,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAKD,OAAO;QACL,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;aACpC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;aACvC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;IAKD,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAKD,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAKO,YAAY;QAClB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,OAAO;QACT,CAAC;QAGD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEhD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,MAAM,EAAE,CAAC;YACpC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAKD,WAAW,CAAC,OAAe;QACzB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;YAC/B,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACxC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC;QAErD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,MAAM,EAAE,CAAC;YACpC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;CACF"}

package/dist/storage/StorageConfig.d.ts

@@ -0,0 +1,25 @@
+import { type LoggerLike } from '../core';
+export interface StorageConfigOptions {
+    readonly prefix?: string;
+    readonly maxEntries?: number;
+    readonly minSafeEntries?: number;
+    readonly logger?: LoggerLike;
+    readonly useMemoryFallback?: boolean;
+}
+export declare class StorageConfig {
+    readonly prefix: string;
+    readonly maxEntries: number;
+    readonly minSafeEntries: number;
+    readonly logger: LoggerLike;
+    readonly useMemoryFallback: boolean;
+    private constructor();
+    static create(options?: StorageConfigOptions): StorageConfig;
+    static defaults(): StorageConfig;
+    static withDebugLogging(prefix: string): StorageConfig;
+    withPrefix(prefix: string): StorageConfig;
+    withMaxEntries(maxEntries: number): StorageConfig;
+    withMinSafeEntries(minSafeEntries: number): StorageConfig;
+    withLogger(logger: LoggerLike): StorageConfig;
+    withMemoryFallback(enabled: boolean): StorageConfig;
+}
+//# sourceMappingURL=StorageConfig.d.ts.map

package/dist/storage/StorageConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageConfig.d.ts","sourceRoot":"","sources":["../../src/storage/StorageConfig.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAKjE,MAAM,WAAW,oBAAoB;IAMnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAOzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAM7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAOjC,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAM7B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IAEpC,OAAO;IAsBP,MAAM,CAAC,MAAM,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa;IAoBhE,MAAM,CAAC,QAAQ,IAAI,aAAa;IAOhC,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAsBtD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAczC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;IAcjD,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,aAAa;IAczD,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa;IAa7C,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa;CASpD"}

package/dist/storage/StorageConfig.js

@@ -0,0 +1,60 @@
+import { Validator, noopLogger } from '../core';
+export class StorageConfig {
+    prefix;
+    maxEntries;
+    minSafeEntries;
+    logger;
+    useMemoryFallback;
+    constructor(prefix, maxEntries, minSafeEntries, logger, useMemoryFallback) {
+        this.prefix = prefix;
+        this.maxEntries = maxEntries;
+        this.minSafeEntries = minSafeEntries;
+        this.logger = logger;
+        this.useMemoryFallback = useMemoryFallback;
+    }
+    static create(options = {}) {
+        const prefix = options.prefix ?? 'storage';
+        Validator.storagePrefix(prefix);
+        const maxEntries = options.maxEntries ?? 50;
+        Validator.numberInRange('maxEntries', maxEntries, 1, 10000);
+        const minSafeEntries = options.minSafeEntries ?? 5;
+        Validator.numberInRange('minSafeEntries', minSafeEntries, 0, maxEntries);
+        const logger = options.logger ?? noopLogger;
+        const useMemoryFallback = options.useMemoryFallback ?? true;
+        return new StorageConfig(prefix, maxEntries, minSafeEntries, logger, useMemoryFallback);
+    }
+    static defaults() {
+        return StorageConfig.create();
+    }
+    static withDebugLogging(prefix) {
+        const tag = `[${prefix}]`;
+        return StorageConfig.create({
+            prefix,
+            logger: {
+                debug: (...args) => console.debug(tag, ...args),
+                info: (...args) => console.info(tag, ...args),
+                warn: (...args) => console.warn(tag, ...args),
+                error: (...args) => console.error(tag, ...args),
+            },
+        });
+    }
+    withPrefix(prefix) {
+        Validator.storagePrefix(prefix);
+        return new StorageConfig(prefix, this.maxEntries, this.minSafeEntries, this.logger, this.useMemoryFallback);
+    }
+    withMaxEntries(maxEntries) {
+        Validator.numberInRange('maxEntries', maxEntries, 1, 10000);
+        return new StorageConfig(this.prefix, maxEntries, Math.min(this.minSafeEntries, maxEntries), this.logger, this.useMemoryFallback);
+    }
+    withMinSafeEntries(minSafeEntries) {
+        Validator.numberInRange('minSafeEntries', minSafeEntries, 0, this.maxEntries);
+        return new StorageConfig(this.prefix, this.maxEntries, minSafeEntries, this.logger, this.useMemoryFallback);
+    }
+    withLogger(logger) {
+        return new StorageConfig(this.prefix, this.maxEntries, this.minSafeEntries, logger, this.useMemoryFallback);
+    }
+    withMemoryFallback(enabled) {
+        return new StorageConfig(this.prefix, this.maxEntries, this.minSafeEntries, this.logger, enabled);
+    }
+}
+//# sourceMappingURL=StorageConfig.js.map

package/dist/storage/StorageConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageConfig.js","sourceRoot":"","sources":["../../src/storage/StorageConfig.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAmB,MAAM,SAAS,CAAC;AAwCjE,MAAM,OAAO,aAAa;IACf,MAAM,CAAS;IACf,UAAU,CAAS;IACnB,cAAc,CAAS;IACvB,MAAM,CAAa;IACnB,iBAAiB,CAAU;IAEpC,YACE,MAAc,EACd,UAAkB,EAClB,cAAsB,EACtB,MAAkB,EAClB,iBAA0B;QAE1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;IAUD,MAAM,CAAC,MAAM,CAAC,UAAgC,EAAE;QAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC;QAC3C,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAEhC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;QAC5C,SAAS,CAAC,aAAa,CAAC,YAAY,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QAE5D,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,CAAC,CAAC;QACnD,SAAS,CAAC,aAAa,CAAC,gBAAgB,EAAE,cAAc,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;QAEzE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC;QAE5C,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,IAAI,CAAC;QAE5D,OAAO,IAAI,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC1F,CAAC;IAKD,MAAM,CAAC,QAAQ;QACb,OAAO,aAAa,CAAC,MAAM,EAAE,CAAC;IAChC,CAAC;IAKD,MAAM,CAAC,gBAAgB,CAAC,MAAc;QACpC,MAAM,GAAG,GAAG,IAAI,MAAM,GAAG,CAAC;QAC1B,OAAO,aAAa,CAAC,MAAM,CAAC;YAC1B,MAAM;YACN,MAAM,EAAE;gBAEN,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;gBAC1D,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;gBACxD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;gBACxD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;aAE3D;SACF,CAAC,CAAC;IACL,CAAC;IASD,UAAU,CAAC,MAAc;QACvB,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,IAAI,aAAa,CACtB,MAAM,EACN,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,iBAAiB,CACvB,CAAC;IACJ,CAAC;IAKD,cAAc,CAAC,UAAkB;QAC/B,SAAS,CAAC,aAAa,CAAC,YAAY,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5D,OAAO,IAAI,aAAa,CACtB,IAAI,CAAC,MAAM,EACX,UAAU,EACV,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,EACzC,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,iBAAiB,CACvB,CAAC;IACJ,CAAC;IAKD,kBAAkB,CAAC,cAAsB;QACvC,SAAS,CAAC,aAAa,CAAC,gBAAgB,EAAE,cAAc,EAAE,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9E,OAAO,IAAI,aAAa,CACtB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,UAAU,EACf,cAAc,EACd,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,iBAAiB,CACvB,CAAC;IACJ,CAAC;IAKD,UAAU,CAAC,MAAkB;QAC3B,OAAO,IAAI,aAAa,CACtB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,cAAc,EACnB,MAAM,EACN,IAAI,CAAC,iBAAiB,CACvB,CAAC;IACJ,CAAC;IAKD,kBAAkB,CAAC,OAAgB;QACjC,OAAO,IAAI,aAAa,CACtB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,MAAM,EACX,OAAO,CACR,CAAC;IACJ,CAAC;CACF"}

package/dist/storage/StorageManager.d.ts

@@ -0,0 +1,19 @@
+import type { CleanupFn } from '../core';
+import { BaseStorageManager, type BaseStorageStats } from './BaseStorageManager';
+import { StorageConfig, type StorageConfigOptions } from './StorageConfig';
+export type StorageStats = BaseStorageStats;
+export interface StorageChangeEvent<T> {
+    readonly key: string;
+    readonly newValue: T | null;
+    readonly oldValue: T | null;
+}
+export declare class StorageManager<T = unknown> extends BaseStorageManager<T> {
+    private constructor();
+    protected getNativeStorage(): Storage;
+    static create<T>(options?: StorageConfigOptions): StorageManager<T>;
+    static fromConfig<T>(config: StorageConfig): StorageManager<T>;
+    static withDebugLogging<T>(prefix: string): StorageManager<T>;
+    onExternalChange(handler: (event: StorageChangeEvent<T>) => void): CleanupFn;
+    static isLocalStorageAvailable(): boolean;
+}
+//# sourceMappingURL=StorageManager.d.ts.map

package/dist/storage/StorageManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageManager.d.ts","sourceRoot":"","sources":["../../src/storage/StorageManager.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAkB,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAK3E,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAK5C,MAAM,WAAW,kBAAkB,CAAC,CAAC;IAEnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC;IAE5B,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC;CAC7B;AAED,qBAAa,cAAc,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,kBAAkB,CAAC,CAAC,CAAC;IACpE,OAAO;IAQP,SAAS,CAAC,gBAAgB,IAAI,OAAO;IAWrC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,GAAE,oBAAyB,GAAG,cAAc,CAAC,CAAC,CAAC;IAYvE,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC;IAY9D,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC;IAiB7D,gBAAgB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,SAAS;IAgD5E,MAAM,CAAC,uBAAuB,IAAI,OAAO;CAG1C"}

package/dist/storage/StorageManager.js

@@ -0,0 +1,58 @@
+import { BaseStorageManager, isStorageEntry } from './BaseStorageManager';
+import { StorageConfig } from './StorageConfig';
+export class StorageManager extends BaseStorageManager {
+    constructor(config, useMemory) {
+        super(config, useMemory);
+    }
+    getNativeStorage() {
+        return localStorage;
+    }
+    static create(options = {}) {
+        return BaseStorageManager.initStorage(StorageConfig.create(options), () => StorageManager.isLocalStorageAvailable(), 'localStorage', (config, useMemory) => new StorageManager(config, useMemory));
+    }
+    static fromConfig(config) {
+        return BaseStorageManager.initStorage(config, () => StorageManager.isLocalStorageAvailable(), 'localStorage', (c, useMemory) => new StorageManager(c, useMemory));
+    }
+    static withDebugLogging(prefix) {
+        return StorageManager.fromConfig(StorageConfig.withDebugLogging(prefix));
+    }
+    onExternalChange(handler) {
+        if (this.isMemoryMode) {
+            this.config.logger.debug('Cross-tab sync unavailable in memory mode');
+            return () => { };
+        }
+        const prefix = `${this.config.prefix}.`;
+        const listener = (e) => {
+            if (e.key?.startsWith(prefix) !== true) {
+                return;
+            }
+            const key = e.key.substring(prefix.length);
+            const parseValue = (raw) => {
+                if (raw === null)
+                    return null;
+                try {
+                    const parsed = JSON.parse(raw);
+                    return isStorageEntry(parsed) ? parsed.data : null;
+                }
+                catch {
+                    return null;
+                }
+            };
+            handler({
+                key,
+                newValue: parseValue(e.newValue),
+                oldValue: parseValue(e.oldValue),
+            });
+        };
+        window.addEventListener('storage', listener);
+        this.config.logger.debug('Cross-tab sync listener registered');
+        return () => {
+            window.removeEventListener('storage', listener);
+            this.config.logger.debug('Cross-tab sync listener removed');
+        };
+    }
+    static isLocalStorageAvailable() {
+        return BaseStorageManager.checkStorageAvailable(() => localStorage, '__storage_test__');
+    }
+}
+//# sourceMappingURL=StorageManager.js.map