strata-storage 2.0.1 → 2.0.4

package/dist/capacitor.js

@@ -17,7 +17,7 @@ export async function registerCapacitorAdapters(storage) {
     // Check if Capacitor is available
     const hasCapacitor = typeof window !== 'undefined' &&
         window.Capacitor &&
-        window.Capacitor.isNativePlatform();
+        window.Capacitor?.isNativePlatform?.();
     if (!hasCapacitor) {
         console.warn('Capacitor not detected. Capacitor adapters will not be registered.');
         return;
@@ -36,9 +36,10 @@ export async function registerCapacitorAdapters(storage) {
  * Helper to check if running in Capacitor environment
  */
 export function isCapacitorEnvironment() {
-    return (typeof window !== 'undefined' &&
+    return ((typeof window !== 'undefined' &&
         window.Capacitor &&
-        window.Capacitor.isNativePlatform());
+        window.Capacitor?.isNativePlatform?.()) ??
+        false);
 }
 /**
  * Get Capacitor-specific storage types

package/dist/core/AdapterRegistry.d.ts

@@ -31,7 +31,7 @@ export declare class AdapterRegistry {
     /**
      * Get all registered adapters
      */
-    getAll(): StorageAdapter[];
+    getAll(): Map<StorageType, StorageAdapter>;
     /**
      * Get available adapters for current platform
      */

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

@@ -1 +1 @@
-{"version":3,"file":"AdapterRegistry.d.ts","sourceRoot":"","sources":["../../src/core/AdapterRegistry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3D;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,WAAW,CAA+B;IAElD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIvC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,GAAG,SAAS;IAIlD;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAwBlF;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAI/B;;OAEG;IACH,QAAQ,IAAI,WAAW,EAAE;IAIzB;;OAEG;IACH,MAAM,IAAI,cAAc,EAAE;IAI1B;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAY/C;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAKtC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAYhC"}
+{"version":3,"file":"AdapterRegistry.d.ts","sourceRoot":"","sources":["../../src/core/AdapterRegistry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3D;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,WAAW,CAA+B;IAElD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIvC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,GAAG,SAAS;IAIlD;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IA8BlF;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAI/B;;OAEG;IACH,QAAQ,IAAI,WAAW,EAAE;IAIzB;;OAEG;IACH,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,cAAc,CAAC;IAI1C;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAY/C;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAKtC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAYhC"}

package/dist/core/AdapterRegistry.js

@@ -37,8 +37,15 @@ export class AdapterRegistry {
         }
         // Initialize if not already done
         if (!this.initialized.has(name)) {
-            await adapter.initialize(config);
-            this.initialized.add(name);
+            try {
+                await adapter.initialize(config);
+                this.initialized.add(name);
+            }
+            catch (error) {
+                throw new AdapterNotAvailableError(name, {
+                    reason: `Initialization failed: ${error instanceof Error ? error.message : String(error)}`,
+                });
+            }
         }
         return adapter;
     }
@@ -58,7 +65,7 @@ export class AdapterRegistry {
      * Get all registered adapters
      */
     getAll() {
-        return Array.from(this.adapters.values());
+        return this.adapters;
     }
     /**
      * Get available adapters for current platform

package/dist/core/BaseAdapter.d.ts

@@ -53,7 +53,7 @@ export declare abstract class BaseAdapter implements StorageAdapter {
     /**
      * Subscribe to changes (if supported)
      */
-    subscribe?(callback: SubscriptionCallback): UnsubscribeFunction;
+    subscribe(callback: SubscriptionCallback): UnsubscribeFunction;
     /**
      * Emit change event
      */
@@ -68,7 +68,7 @@ export declare abstract class BaseAdapter implements StorageAdapter {
     /**
      * Close adapter (cleanup)
      */
-    close?(): Promise<void>;
+    close(): Promise<void>;
     abstract isAvailable(): Promise<boolean>;
     abstract initialize(config?: unknown): Promise<void>;
     abstract get<T = unknown>(key: string): Promise<StorageValue<T> | null>;

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/Strata.d.ts

@@ -33,26 +33,157 @@ export declare class Strata {
     initialize(): Promise<void>;
     /**
      * Get a value from storage
+     *
+     * @param key - The key to retrieve
+     * @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)
+     * @returns The stored value or null if not found
+     * @throws {StorageError} If the storage adapter is not available
+     * @throws {EncryptionError} If decryption fails
+     *
+     * @example
+     * ```typescript
+     * // Simple get
+     * const value = await storage.get('myKey');
+     *
+     * // Get from specific storage
+     * const value = await storage.get('myKey', { storage: 'indexedDB' });
+     *
+     * // Get encrypted value
+     * const value = await storage.get('secure-key', {
+     *   decryptionPassword: 'myPassword'
+     * });
+     * ```
      */
     get<T = unknown>(key: string, options?: StorageOptions): Promise<T | null>;
     /**
      * Set a value in storage
+     *
+     * @param key - The key to store under
+     * @param value - The value to store (can be any serializable type)
+     * @param options - Storage options
+     * @param options.storage - Specific storage type to use
+     * @param options.encrypt - Whether to encrypt the value
+     * @param options.encryptionPassword - Password for encryption
+     * @param options.compress - Whether to compress the value
+     * @param options.ttl - Time-to-live in milliseconds
+     * @param options.tags - Tags for categorization
+     * @param options.metadata - Additional metadata to store
+     * @throws {StorageError} If the storage adapter is not available
+     * @throws {EncryptionError} If encryption fails
+     *
+     * @example
+     * ```typescript
+     * // Simple set
+     * await storage.set('myKey', 'myValue');
+     *
+     * // Set with TTL (expires in 1 hour)
+     * await storage.set('tempKey', data, { ttl: 3600000 });
+     *
+     * // Set with encryption and compression
+     * await storage.set('secure-key', sensitiveData, {
+     *   encrypt: true,
+     *   compress: true,
+     *   encryptionPassword: 'myPassword'
+     * });
+     *
+     * // Set with metadata
+     * await storage.set('user-123', userData, {
+     *   tags: ['user', 'active'],
+     *   metadata: { version: 2, source: 'api' }
+     * });
+     * ```
      */
     set<T = unknown>(key: string, value: T, options?: StorageOptions): Promise<void>;
     /**
      * Remove a value from storage
+     *
+     * @param key - The key to remove
+     * @param options - Storage options
+     * @param options.storage - Specific storage type to use
+     * @throws {StorageError} If the storage adapter is not available
+     *
+     * @example
+     * ```typescript
+     * // Remove from default storage
+     * await storage.remove('myKey');
+     *
+     * // Remove from specific storage
+     * await storage.remove('myKey', { storage: 'cookies' });
+     * ```
      */
     remove(key: string, options?: StorageOptions): Promise<void>;
     /**
-     * Check if a key exists
+     * Check if a key exists in storage
+     *
+     * @param key - The key to check
+     * @param options - Storage options
+     * @param options.storage - Specific storage type to check
+     * @returns True if the key exists, false otherwise
+     * @throws {StorageError} If the storage adapter is not available
+     *
+     * @example
+     * ```typescript
+     * // Check in default storage
+     * const exists = await storage.has('myKey');
+     *
+     * // Check in specific storage
+     * const exists = await storage.has('myKey', { storage: 'sessionStorage' });
+     * ```
      */
     has(key: string, options?: StorageOptions): Promise<boolean>;
     /**
      * Clear storage
+     *
+     * @param options - Clear options
+     * @param options.storage - Specific storage to clear (clears all if not specified)
+     * @param options.prefix - Only clear keys with this prefix
+     * @param options.tags - Only clear items with these tags
+     * @param options.olderThan - Only clear items older than this date
+     * @throws {StorageError} If the storage adapter is not available
+     *
+     * @example
+     * ```typescript
+     * // Clear all storage
+     * await storage.clear();
+     *
+     * // Clear specific storage
+     * await storage.clear({ storage: 'localStorage' });
+     *
+     * // Clear by prefix
+     * await storage.clear({ prefix: 'temp-' });
+     *
+     * // Clear old items
+     * const yesterday = Date.now() - 86400000;
+     * await storage.clear({ olderThan: yesterday });
+     * ```
      */
     clear(options?: ClearOptions & StorageOptions): Promise<void>;
     /**
-     * Get all keys
+     * Get all keys from storage
+     *
+     * @param pattern - Optional pattern to filter keys (string prefix or RegExp)
+     * @param options - Storage options
+     * @param options.storage - Specific storage to get keys from (gets from all if not specified)
+     * @returns Array of matching keys
+     * @throws {StorageError} If the storage adapter is not available
+     *
+     * @example
+     * ```typescript
+     * // Get all keys
+     * const keys = await storage.keys();
+     *
+     * // Get keys with prefix
+     * const userKeys = await storage.keys('user-');
+     *
+     * // Get keys with regex pattern
+     * const tempKeys = await storage.keys(/^temp-.*$/);
+     *
+     * // Get keys from specific storage
+     * const localKeys = await storage.keys(null, { storage: 'localStorage' });
+     * ```
      */
     keys(pattern?: string | RegExp, options?: StorageOptions): Promise<string[]>;
     /**

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

package/dist/core/Strata.js

@@ -82,6 +82,29 @@ export class Strata {
     }
     /**
      * Get a value from storage
+     *
+     * @param key - The key to retrieve
+     * @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)
+     * @returns The stored value or null if not found
+     * @throws {StorageError} If the storage adapter is not available
+     * @throws {EncryptionError} If decryption fails
+     *
+     * @example
+     * ```typescript
+     * // Simple get
+     * const value = await storage.get('myKey');
+     *
+     * // Get from specific storage
+     * const value = await storage.get('myKey', { storage: 'indexedDB' });
+     *
+     * // Get encrypted value
+     * const value = await storage.get('secure-key', {
+     *   decryptionPassword: 'myPassword'
+     * });
+     * ```
      */
     async get(key, options) {
         const adapter = await this.selectAdapter(options?.storage);
@@ -135,6 +158,41 @@ export class Strata {
     }
     /**
      * Set a value in storage
+     *
+     * @param key - The key to store under
+     * @param value - The value to store (can be any serializable type)
+     * @param options - Storage options
+     * @param options.storage - Specific storage type to use
+     * @param options.encrypt - Whether to encrypt the value
+     * @param options.encryptionPassword - Password for encryption
+     * @param options.compress - Whether to compress the value
+     * @param options.ttl - Time-to-live in milliseconds
+     * @param options.tags - Tags for categorization
+     * @param options.metadata - Additional metadata to store
+     * @throws {StorageError} If the storage adapter is not available
+     * @throws {EncryptionError} If encryption fails
+     *
+     * @example
+     * ```typescript
+     * // Simple set
+     * await storage.set('myKey', 'myValue');
+     *
+     * // Set with TTL (expires in 1 hour)
+     * await storage.set('tempKey', data, { ttl: 3600000 });
+     *
+     * // Set with encryption and compression
+     * await storage.set('secure-key', sensitiveData, {
+     *   encrypt: true,
+     *   compress: true,
+     *   encryptionPassword: 'myPassword'
+     * });
+     *
+     * // Set with metadata
+     * await storage.set('user-123', userData, {
+     *   tags: ['user', 'active'],
+     *   metadata: { version: 2, source: 'api' }
+     * });
+     * ```
      */
     async set(key, value, options) {
         const adapter = await this.selectAdapter(options?.storage);
@@ -185,6 +243,20 @@ export class Strata {
     }
     /**
      * Remove a value from storage
+     *
+     * @param key - The key to remove
+     * @param options - Storage options
+     * @param options.storage - Specific storage type to use
+     * @throws {StorageError} If the storage adapter is not available
+     *
+     * @example
+     * ```typescript
+     * // Remove from default storage
+     * await storage.remove('myKey');
+     *
+     * // Remove from specific storage
+     * await storage.remove('myKey', { storage: 'cookies' });
+     * ```
      */
     async remove(key, options) {
         const adapter = await this.selectAdapter(options?.storage);
@@ -200,7 +272,22 @@ export class Strata {
         }
     }
     /**
-     * Check if a key exists
+     * Check if a key exists in storage
+     *
+     * @param key - The key to check
+     * @param options - Storage options
+     * @param options.storage - Specific storage type to check
+     * @returns True if the key exists, false otherwise
+     * @throws {StorageError} If the storage adapter is not available
+     *
+     * @example
+     * ```typescript
+     * // Check in default storage
+     * const exists = await storage.has('myKey');
+     *
+     * // Check in specific storage
+     * const exists = await storage.has('myKey', { storage: 'sessionStorage' });
+     * ```
      */
     async has(key, options) {
         const adapter = await this.selectAdapter(options?.storage);
@@ -208,6 +295,29 @@ export class Strata {
     }
     /**
      * Clear storage
+     *
+     * @param options - Clear options
+     * @param options.storage - Specific storage to clear (clears all if not specified)
+     * @param options.prefix - Only clear keys with this prefix
+     * @param options.tags - Only clear items with these tags
+     * @param options.olderThan - Only clear items older than this date
+     * @throws {StorageError} If the storage adapter is not available
+     *
+     * @example
+     * ```typescript
+     * // Clear all storage
+     * await storage.clear();
+     *
+     * // Clear specific storage
+     * await storage.clear({ storage: 'localStorage' });
+     *
+     * // Clear by prefix
+     * await storage.clear({ prefix: 'temp-' });
+     *
+     * // Clear old items
+     * const yesterday = Date.now() - 86400000;
+     * await storage.clear({ olderThan: yesterday });
+     * ```
      */
     async clear(options) {
         if (options?.storage) {
@@ -222,7 +332,28 @@ export class Strata {
         }
     }
     /**
-     * Get all keys
+     * Get all keys from storage
+     *
+     * @param pattern - Optional pattern to filter keys (string prefix or RegExp)
+     * @param options - Storage options
+     * @param options.storage - Specific storage to get keys from (gets from all if not specified)
+     * @returns Array of matching keys
+     * @throws {StorageError} If the storage adapter is not available
+     *
+     * @example
+     * ```typescript
+     * // Get all keys
+     * const keys = await storage.keys();
+     *
+     * // Get keys with prefix
+     * const userKeys = await storage.keys('user-');
+     *
+     * // Get keys with regex pattern
+     * const tempKeys = await storage.keys(/^temp-.*$/);
+     *
+     * // Get keys from specific storage
+     * const localKeys = await storage.keys(null, { storage: 'localStorage' });
+     * ```
      */
     async keys(pattern, options) {
         if (options?.storage) {
@@ -516,29 +647,37 @@ export class Strata {
     }
     async selectDefaultAdapter() {
         const storages = this.config.defaultStorages || this.getDefaultStorages();
+        if (storages.length === 0) {
+            throw new StorageError('No storage adapters registered or configured');
+        }
         for (const storage of storages) {
             try {
-                const adapter = await this.registry.getInitialized(storage, this.config.adapters?.[storage]);
+                const adapter = this.registry.get(storage);
+                if (!adapter) {
+                    continue;
+                }
+                const isAvailable = await adapter.isAvailable();
+                if (!isAvailable) {
+                    continue;
+                }
+                // Initialize adapter with config if provided
+                const config = this.config.adapters?.[storage];
+                await adapter.initialize(config);
                 this.defaultAdapter = adapter;
                 this.adapters.set(storage, adapter);
                 return;
             }
-            catch {
+            catch (error) {
+                console.warn(`Failed to initialize ${storage} adapter:`, error);
                 // Continue to next adapter
             }
         }
-        throw new StorageError('No available storage adapters found');
+        throw new StorageError(`No available storage adapters found. Tried: ${storages.join(', ')}. ` +
+            `Registered adapters: ${Array.from(this.registry.getAll().keys()).join(', ')}`);
     }
     async initializeAdapters() {
-        for (const [type, adapter] of this.adapters.entries()) {
-            const config = this.config.adapters?.[type];
-            if (config && typeof config === 'object') {
-                await adapter.initialize(config);
-            }
-            else {
-                await adapter.initialize();
-            }
-        }
+        // Adapters are already initialized in selectDefaultAdapter
+        // This method is kept for compatibility but doesn't re-initialize
     }
     async selectAdapter(storage) {
         if (!storage) {

package/dist/firebase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"firebase.d.ts","sourceRoot":"","sources":["../src/firebase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,IAAI,CAAC,CA2If;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO5D"}
+{"version":3,"file":"firebase.d.ts","sourceRoot":"","sources":["../src/firebase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAG5C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,IAAI,CAAC,CA8Jf;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAQ5D"}

package/dist/firebase.js

@@ -5,6 +5,7 @@
 export async function enableFirebaseSync(storage, config) {
     // Dynamically import Firebase only when this function is called
     try {
+        // @ts-expect-error - Firebase is an optional peer dependency
         const { initializeApp, getApps } = await import('firebase/app');
         // Initialize Firebase if not already initialized
         if (!getApps().length) {
@@ -18,6 +19,7 @@ export async function enableFirebaseSync(storage, config) {
             });
         }
         if (config.firestore) {
+            // @ts-expect-error - Firebase is an optional peer dependency
             const { getFirestore, doc, setDoc, getDoc, deleteDoc } = await import('firebase/firestore');
             const db = getFirestore();
             const collectionName = config.collectionName || 'strata-storage';
@@ -70,11 +72,20 @@ export async function enableFirebaseSync(storage, config) {
                 async isAvailable() {
                     return true;
                 },
+                subscribe() {
+                    // Not implemented for Firebase adapter
+                    return () => { };
+                },
+                async close() {
+                    // No cleanup needed
+                },
             };
             // Register the Firestore adapter
+            // Cast to unknown first to bypass type checking for custom adapter
             storage.registerAdapter(firestoreAdapter);
         }
         if (config.realtimeDatabase) {
+            // @ts-expect-error - Firebase is an optional peer dependency
             const { getDatabase, ref, set, get, remove } = await import('firebase/database');
             const db = getDatabase();
             // Create custom adapter for Realtime Database
@@ -123,11 +134,19 @@ export async function enableFirebaseSync(storage, config) {
                 async isAvailable() {
                     return true;
                 },
+                subscribe() {
+                    // Not implemented for Firebase adapter
+                    return () => { };
+                },
+                async close() {
+                    // No cleanup needed
+                },
             };
             // Register the Realtime Database adapter
+            // Cast to unknown first to bypass type checking for custom adapter
             storage.registerAdapter(realtimeAdapter);
         }
-        console.log('Firebase sync enabled successfully');
+        // Firebase sync enabled successfully
     }
     catch (error) {
         throw new Error(`Failed to enable Firebase sync: ${error instanceof Error ? error.message : 'Unknown error'}`);
@@ -138,6 +157,7 @@ export async function enableFirebaseSync(storage, config) {
  */
 export async function isFirebaseAvailable() {
     try {
+        // @ts-expect-error - Firebase is an optional peer dependency
         await import('firebase/app');
         return true;
     }

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export type { StorageType, StorageOptions, StorageValue, StorageAdapter, Adapter
 export { isValidKey, isValidValue, serializeValue, deserializeValue, generateId, createError, retry, debounce, throttle, } from './utils';
 import { Strata } from './core/Strata';
 declare const storage: Strata;
-export { storage };
+declare const ensureInitialized: () => Promise<void>;
+export { storage, ensureInitialized };
 export default storage;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,YAAY,EACV,WAAW,EACX,cAAc,EACd,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,SAAS,GACV,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,KAAK,EACL,QAAQ,EACR,QAAQ,GACT,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AASvC,QAAA,MAAM,OAAO,QAGX,CAAC;AAqBH,OAAO,EAAE,OAAO,EAAE,CAAC;AAGnB,eAAe,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,YAAY,EACV,WAAW,EACX,cAAc,EACd,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,SAAS,GACV,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,KAAK,EACL,QAAQ,EACR,QAAQ,GACT,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AASvC,QAAA,MAAM,OAAO,QAGX,CAAC;AAoBH,QAAA,MAAM,iBAAiB,qBAQtB,CAAC;AAMF,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAGtC,eAAe,OAAO,CAAC"}

package/dist/index.js

@@ -28,27 +28,37 @@ import { CacheAdapter } from "./adapters/web/CacheAdapter.js";
 import { MemoryAdapter } from "./adapters/web/MemoryAdapter.js";
 // Create a singleton instance with web adapters pre-registered
 const storage = new Strata({
-    defaultStorage: 'memory', // Always available fallback
+    defaultStorages: ['memory', 'localStorage', 'sessionStorage', 'indexedDB'], // Order of preference
     autoInitialize: false, // We'll initialize it ourselves
 });
 // Register only web adapters by default
-storage.registerAdapter(new MemoryAdapter());
-storage.registerAdapter(new LocalStorageAdapter());
-storage.registerAdapter(new SessionStorageAdapter());
-storage.registerAdapter(new IndexedDBAdapter());
-storage.registerAdapter(new CookieAdapter());
-storage.registerAdapter(new CacheAdapter());
+try {
+    // Memory adapter should always be available as fallback
+    storage.registerAdapter(new MemoryAdapter());
+    // Browser storage adapters
+    storage.registerAdapter(new LocalStorageAdapter());
+    storage.registerAdapter(new SessionStorageAdapter());
+    storage.registerAdapter(new IndexedDBAdapter());
+    storage.registerAdapter(new CookieAdapter());
+    storage.registerAdapter(new CacheAdapter());
+}
+catch (error) {
+    console.warn('Strata Storage adapter registration warning:', error);
+}
 // Initialize the storage instance
-(async () => {
-    try {
-        await storage.initialize();
+let initializationPromise = null;
+const ensureInitialized = async () => {
+    if (!initializationPromise) {
+        initializationPromise = storage.initialize().catch((error) => {
+            console.warn('Strata Storage initialization warning:', error);
+            // Continue working even if some adapters fail
+        });
     }
-    catch (error) {
-        console.warn('Strata Storage initialization warning:', error);
-        // Continue working even if some adapters fail
-    }
-})();
+    return initializationPromise;
+};
+// Start initialization immediately but don't block module loading
+ensureInitialized();
 // Export the ready-to-use storage instance
-export { storage };
+export { storage, ensureInitialized };
 // Default export for convenience
 export default storage;