strata-storage 2.0.3 → 2.0.4

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":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAQpD;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,iBAAiB,CAAC,CAAoB;IAC9C,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAChD,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,YAAY,CAAkB;gBAE1B,MAAM,GAAE,YAAiB;IAMrC;;OAEG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmDjC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IA2DhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAwDtF;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAelE;;;;;;;;;;;;;;;;;OAiBG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlE;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBlF;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmBjD;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,mBAAmB;IAuBxF;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EACrB,SAAS,EAAE,cAAc,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IAU5C;;OAEG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBtD;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BlE;;OAEG;IACH,wBAAwB,IAAI,WAAW,EAAE;IAIzC;;OAEG;IACH,eAAe,CACb,OAAO,CAAC,EAAE,WAAW,GACpB,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAc5D;;OAEG;IACH,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAOzC;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOzC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAU3E;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBxF;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnE;;OAEG;IACG,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAWrD;;OAEG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAa/D;;;;;;;;;OASG;IACH,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAI9C;;;OAGG;IACH,WAAW,IAAI,eAAe;IAI9B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B5B,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,kBAAkB;YAgBZ,oBAAoB;YAsCpB,kBAAkB;YAKlB,aAAa;CA2B5B"}

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

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/ios/Plugin/KeychainStorage.swift

@@ -40,16 +40,29 @@ import Security
         return status == errSecSuccess
     }
     
-    @objc public func clear() -> Bool {
-        let query: [String: Any] = [
-            kSecClass as String: kSecClassGenericPassword,
-            kSecAttrService as String: service
-        ]
-        let status = SecItemDelete(query as CFDictionary)
-        return status == errSecSuccess || status == errSecItemNotFound
+    @objc public func clear(prefix: String? = nil) -> Bool {
+        if let prefix = prefix {
+            // Clear only keys with the given prefix
+            let keysToRemove = keys(pattern: prefix)
+            var allSuccess = true
+            for key in keysToRemove {
+                if !remove(key: key) {
+                    allSuccess = false
+                }
+            }
+            return allSuccess
+        } else {
+            // Clear all keys
+            let query: [String: Any] = [
+                kSecClass as String: kSecClassGenericPassword,
+                kSecAttrService as String: service
+            ]
+            let status = SecItemDelete(query as CFDictionary)
+            return status == errSecSuccess || status == errSecItemNotFound
+        }
     }
     
-    @objc public func keys() -> [String] {
+    @objc public func keys(pattern: String? = nil) -> [String] {
         var query: [String: Any] = [
             kSecClass as String: kSecClassGenericPassword,
             kSecAttrService as String: service,
@@ -67,7 +80,16 @@ import Security
         guard status == errSecSuccess,
               let items = result as? [[String: Any]] else { return [] }
         
-        return items.compactMap { $0[kSecAttrAccount as String] as? String }
+        let allKeys = items.compactMap { $0[kSecAttrAccount as String] as? String }
+        
+        guard let pattern = pattern else {
+            return allKeys
+        }
+        
+        // Filter keys by pattern (simple prefix matching)
+        return allKeys.filter { key in
+            key.hasPrefix(pattern) || key.contains(pattern)
+        }
     }
     
     private func createQuery(key: String) -> [String: Any] {

package/dist/ios/Plugin/SQLiteStorage.swift

@@ -137,23 +137,46 @@ import SQLite3
         return result
     }
     
-    @objc public func clear() -> Bool {
-        let deleteSQL = "DELETE FROM \(tableName)"
+    @objc public func clear(prefix: String? = nil) -> Bool {
+        let deleteSQL: String
+        if let prefix = prefix {
+            deleteSQL = "DELETE FROM \(tableName) WHERE key LIKE ?"
+        } else {
+            deleteSQL = "DELETE FROM \(tableName)"
+        }
+        
         var statement: OpaquePointer?
+        var result = sqlite3_prepare_v2(db, deleteSQL, -1, &statement, nil) == SQLITE_OK
         
-        let result = sqlite3_prepare_v2(db, deleteSQL, -1, &statement, nil) == SQLITE_OK &&
-            sqlite3_step(statement) == SQLITE_DONE
+        if result && prefix != nil {
+            result = sqlite3_bind_text(statement, 1, "\(prefix!)%", -1, nil) == SQLITE_OK
+        }
+        
+        if result {
+            result = sqlite3_step(statement) == SQLITE_DONE
+        }
         
         sqlite3_finalize(statement)
         return result
     }
     
-    @objc public func keys() -> [String] {
-        let querySQL = "SELECT key FROM \(tableName)"
+    @objc public func keys(pattern: String? = nil) -> [String] {
+        let querySQL: String
+        if let pattern = pattern {
+            querySQL = "SELECT key FROM \(tableName) WHERE key LIKE ?"
+        } else {
+            querySQL = "SELECT key FROM \(tableName)"
+        }
+        
         var statement: OpaquePointer?
         var keys: [String] = []
         
         if sqlite3_prepare_v2(db, querySQL, -1, &statement, nil) == SQLITE_OK {
+            if let pattern = pattern {
+                // Use % wildcard for SQL LIKE pattern matching
+                sqlite3_bind_text(statement, 1, "%\(pattern)%", -1, nil)
+            }
+            
             while sqlite3_step(statement) == SQLITE_ROW {
                 if let key = sqlite3_column_text(statement, 0) {
                     keys.append(String(cString: key))

package/dist/ios/Plugin/UserDefaultsStorage.swift

@@ -24,18 +24,36 @@ import Foundation
         return userDefaults.synchronize()
     }
     
-    @objc public func clear() -> Bool {
-        if let suiteName = suiteName {
-            UserDefaults(suiteName: suiteName)?.removePersistentDomain(forName: suiteName)
+    @objc public func clear(prefix: String? = nil) -> Bool {
+        if let prefix = prefix {
+            // Clear only keys with the given prefix
+            let keysToRemove = keys(pattern: prefix)
+            for key in keysToRemove {
+                userDefaults.removeObject(forKey: key)
+            }
         } else {
-            let domain = Bundle.main.bundleIdentifier!
-            userDefaults.removePersistentDomain(forName: domain)
+            // Clear all keys
+            if let suiteName = suiteName {
+                UserDefaults(suiteName: suiteName)?.removePersistentDomain(forName: suiteName)
+            } else {
+                let domain = Bundle.main.bundleIdentifier!
+                userDefaults.removePersistentDomain(forName: domain)
+            }
         }
         return userDefaults.synchronize()
     }
     
-    @objc public func keys() -> [String] {
-        return Array(userDefaults.dictionaryRepresentation().keys)
+    @objc public func keys(pattern: String? = nil) -> [String] {
+        let allKeys = Array(userDefaults.dictionaryRepresentation().keys)
+        
+        guard let pattern = pattern else {
+            return allKeys
+        }
+        
+        // Filter keys by pattern (simple prefix matching)
+        return allKeys.filter { key in
+            key.hasPrefix(pattern) || key.contains(pattern)
+        }
     }
     
     @objc public func has(key: String) -> Bool {

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strata-storage",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "Zero-dependency universal storage plugin providing a unified API for all storage operations across web, Android, and iOS platforms",
   "type": "module",
   "main": "./index.js",
@@ -44,10 +44,10 @@
     "android"
   ],
   "peerDependencies": {
-    "@angular/core": ">=12.0.0",
-    "@capacitor/core": "^5.0.0 || ^6.0.0",
-    "react": ">=16.8.0",
-    "vue": ">=3.0.0"
+    "@angular/core": ">=20.3.0",
+    "@capacitor/core": ">=7.4.0",
+    "react": ">=19.1.0",
+    "vue": ">=3.6.0"
   },
   "peerDependenciesMeta": {
     "@capacitor/core": {

package/dist/plugin/web.d.ts

@@ -10,15 +10,19 @@ export declare class StrataStorageWeb implements StrataStoragePlugin {
     }): Promise<{
         available: boolean;
     }>;
-    get(_options: NativeGetOptions): Promise<{
+    get(options: NativeGetOptions): Promise<{
         value: StorageValue | null;
     }>;
-    set(_options: NativeSetOptions): Promise<void>;
-    remove(_options: NativeRemoveOptions): Promise<void>;
-    clear(_options: NativeClearOptions): Promise<void>;
-    keys(_options: NativeKeysOptions): Promise<{
+    set(options: NativeSetOptions): Promise<void>;
+    remove(options: NativeRemoveOptions): Promise<void>;
+    clear(options: NativeClearOptions): Promise<void>;
+    keys(options: NativeKeysOptions): Promise<{
         keys: string[];
     }>;
-    size(_options: NativeSizeOptions): Promise<NativeSizeResult>;
+    size(options: NativeSizeOptions): Promise<NativeSizeResult>;
+    /**
+     * Get suggestion for web alternative based on native storage type
+     */
+    private getSuggestion;
 }
 //# sourceMappingURL=web.d.ts.map

package/dist/plugin/web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/plugin/web.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,qBAAa,gBAAiB,YAAW,mBAAmB;IACpD,WAAW,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,iBAAiB,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAMtF,GAAG,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;KAAE,CAAC;IAKxE,GAAG,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,MAAM,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD,KAAK,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAK9D,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAInE"}
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/plugin/web.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,qBAAa,gBAAiB,YAAW,mBAAmB;IACpD,WAAW,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,iBAAiB,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAWtF,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;KAAE,CAAC;IAOvE,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7C,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjD,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAO7D,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOjE;;OAEG;IACH,OAAO,CAAC,aAAa;CAatB"}

package/dist/plugin/web.js

@@ -6,30 +6,59 @@ export class StrataStorageWeb {
     async isAvailable(_options) {
         // Web platform doesn't support native storage types
         // This is handled by the web adapters instead
-        return { available: false };
+        return {
+            available: false,
+            platform: 'web',
+            message: 'Native storage not available on web. Use web adapters: localStorage, sessionStorage, indexedDB, cookies, or cache instead.',
+        };
     }
-    async get(_options) {
+    async get(options) {
         // Not implemented for web - use web adapters instead
-        throw new Error('Native storage not available on web platform');
+        const storageType = options.storage || 'preferences';
+        const suggestion = this.getSuggestion(storageType);
+        throw new Error(`Native storage '${storageType}' not available on web platform. ${suggestion}`);
     }
-    async set(_options) {
+    async set(options) {
         // Not implemented for web - use web adapters instead
-        throw new Error('Native storage not available on web platform');
+        const storageType = options.storage || 'preferences';
+        const suggestion = this.getSuggestion(storageType);
+        throw new Error(`Native storage '${storageType}' not available on web platform. ${suggestion}`);
     }
-    async remove(_options) {
+    async remove(options) {
         // Not implemented for web - use web adapters instead
-        throw new Error('Native storage not available on web platform');
+        const storageType = options.storage || 'preferences';
+        const suggestion = this.getSuggestion(storageType);
+        throw new Error(`Native storage '${storageType}' not available on web platform. ${suggestion}`);
     }
-    async clear(_options) {
+    async clear(options) {
         // Not implemented for web - use web adapters instead
-        throw new Error('Native storage not available on web platform');
+        const storageType = options.storage || 'preferences';
+        const suggestion = this.getSuggestion(storageType);
+        throw new Error(`Native storage '${storageType}' not available on web platform. ${suggestion}`);
     }
-    async keys(_options) {
+    async keys(options) {
         // Not implemented for web - use web adapters instead
-        throw new Error('Native storage not available on web platform');
+        const storageType = options.storage || 'preferences';
+        const suggestion = this.getSuggestion(storageType);
+        throw new Error(`Native storage '${storageType}' not available on web platform. ${suggestion}`);
     }
-    async size(_options) {
+    async size(options) {
         // Not implemented for web - use web adapters instead
-        throw new Error('Native storage not available on web platform');
+        const storageType = options.storage || 'preferences';
+        const suggestion = this.getSuggestion(storageType);
+        throw new Error(`Native storage '${storageType}' not available on web platform. ${suggestion}`);
+    }
+    /**
+     * Get suggestion for web alternative based on native storage type
+     */
+    getSuggestion(storageType) {
+        const suggestions = {
+            preferences: 'Use localStorage adapter for persistent key-value storage.',
+            secure: 'Use indexedDB adapter with encryption enabled for secure storage.',
+            sqlite: 'Use indexedDB adapter for database-like storage.',
+            filesystem: 'Use Cache API adapter or indexedDB for file storage.',
+        };
+        return (suggestions[storageType] ||
+            'Use one of the web adapters: localStorage, sessionStorage, indexedDB, cookies, or cache.');
     }
 }

package/dist/utils/index.d.ts

@@ -118,8 +118,5 @@ export declare function serializeValue(value: unknown): string;
  * Deserialize a value from storage
  */
 export declare function deserializeValue(value: string): unknown;
-/**
- * Create an error with additional context
- */
 export declare function createError(message: string, code?: string, details?: unknown): Error;
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/utils/index.js

@@ -352,9 +352,6 @@ export function serializeValue(value) {
 export function deserializeValue(value) {
     return deserialize(value);
 }
-/**
- * Create an error with additional context
- */
 export function createError(message, code, details) {
     const error = new Error(message);
     error.code = code;

package/ios/Plugin/KeychainStorage.swift

@@ -40,16 +40,29 @@ import Security
         return status == errSecSuccess
     }
     
-    @objc public func clear() -> Bool {
-        let query: [String: Any] = [
-            kSecClass as String: kSecClassGenericPassword,
-            kSecAttrService as String: service
-        ]
-        let status = SecItemDelete(query as CFDictionary)
-        return status == errSecSuccess || status == errSecItemNotFound
+    @objc public func clear(prefix: String? = nil) -> Bool {
+        if let prefix = prefix {
+            // Clear only keys with the given prefix
+            let keysToRemove = keys(pattern: prefix)
+            var allSuccess = true
+            for key in keysToRemove {
+                if !remove(key: key) {
+                    allSuccess = false
+                }
+            }
+            return allSuccess
+        } else {
+            // Clear all keys
+            let query: [String: Any] = [
+                kSecClass as String: kSecClassGenericPassword,
+                kSecAttrService as String: service
+            ]
+            let status = SecItemDelete(query as CFDictionary)
+            return status == errSecSuccess || status == errSecItemNotFound
+        }
     }
     
-    @objc public func keys() -> [String] {
+    @objc public func keys(pattern: String? = nil) -> [String] {
         var query: [String: Any] = [
             kSecClass as String: kSecClassGenericPassword,
             kSecAttrService as String: service,
@@ -67,7 +80,16 @@ import Security
         guard status == errSecSuccess,
               let items = result as? [[String: Any]] else { return [] }
         
-        return items.compactMap { $0[kSecAttrAccount as String] as? String }
+        let allKeys = items.compactMap { $0[kSecAttrAccount as String] as? String }
+        
+        guard let pattern = pattern else {
+            return allKeys
+        }
+        
+        // Filter keys by pattern (simple prefix matching)
+        return allKeys.filter { key in
+            key.hasPrefix(pattern) || key.contains(pattern)
+        }
     }
     
     private func createQuery(key: String) -> [String: Any] {