strata-storage 2.0.3 → 2.1.0

package/Readme.md

@@ -2,14 +2,64 @@
 
 ## 📚 Documentation
 
-- **[Getting Started](./docs/getting-started/installation.md)** - Installation and setup
+### Getting Started
+- **[Installation](./docs/getting-started/installation.md)** - Installation and setup
 - **[Quick Start Guide](./docs/getting-started/quick-start.md)** - Get running in minutes
-- **[API Reference](./docs/api/README.md)** - Complete API documentation
 - **[Configuration](./docs/getting-started/configuration.md)** - Configuration options
-- **[Platform Guides](./docs/guides/platforms/web.md)** - Platform-specific guides
-- **[Examples](./docs/examples/README.md)** - Code examples and recipes
+
+### Core Documentation
+- **[API Reference](./docs/api/README.md)** - Complete API documentation
+- **[Core API](./docs/api/core/strata.md)** - Main Strata class
+- **[Type Definitions](./docs/api/core/types.md)** - TypeScript types
+- **[Error Handling](./docs/api/core/errors.md)** - Error types and handling
+
+### Storage Adapters
+- **[Web Adapters](./docs/api/adapters/README.md#web-adapters)** - Browser storage
+  - [localStorage](./docs/api/adapters/web/localstorage.md)
+  - [sessionStorage](./docs/api/adapters/web/sessionstorage.md)
+  - [IndexedDB](./docs/api/adapters/web/indexeddb.md)
+  - [Cookies](./docs/api/adapters/web/cookies.md)
+  - [Cache API](./docs/api/adapters/web/cache.md)
+  - [Memory](./docs/api/adapters/web/memory.md)
+- **[Capacitor Adapters](./docs/api/adapters/README.md#capacitor-adapters)** - Native storage
+  - [Preferences](./docs/api/adapters/capacitor/preferences.md)
+  - [Secure Storage](./docs/api/adapters/capacitor/secure.md)
+  - [SQLite](./docs/api/adapters/capacitor/sqlite.md)
+  - [Filesystem](./docs/api/adapters/capacitor/filesystem.md)
+
+### Advanced Features
+- **[Encryption](./docs/guides/features/encryption.md)** - Data encryption guide
+- **[Compression](./docs/guides/features/compression.md)** - Data compression
+- **[TTL Management](./docs/api/features/ttl.md)** - Auto-expiration
+- **[Cross-Tab Sync](./docs/guides/features/sync.md)** - Real-time synchronization
+- **[Query Engine](./docs/guides/features/queries.md)** - MongoDB-like queries
+- **[Migrations](./docs/guides/features/migrations.md)** - Data migration system
+
+### Platform Guides
+- **[Web Platform](./docs/guides/platforms/web.md)** - Browser-specific features
+- **[iOS Platform](./docs/guides/platforms/ios.md)** - iOS implementation
+- **[Android Platform](./docs/guides/platforms/android.md)** - Android implementation
+- **[Capacitor](./docs/guides/platforms/capacitor.md)** - Capacitor integration
+
+### Common Patterns
+- **[Caching Strategies](./docs/guides/patterns/caching.md)** - Caching best practices
+- **[Session Management](./docs/guides/patterns/sessions.md)** - User session handling
+
+### Examples
+- **[Basic Usage](./docs/examples/basic-usage.md)** - Simple examples
+- **[React Integration](./docs/examples/frameworks/react.md)** - React hooks and providers
+- **[Vue Integration](./docs/examples/frameworks/vue.md)** - Vue composables
+- **[Angular Integration](./docs/examples/frameworks/angular.md)** - Angular services
+- **[Authentication](./docs/examples/user-auth.md)** - User authentication
+- **[Shopping Cart](./docs/examples/shopping-cart.md)** - E-commerce example
+- **[Form Persistence](./docs/examples/form-persistence.md)** - Form data saving
+- **[Offline Support](./docs/examples/offline-support.md)** - Offline-first apps
+- **[All Examples](./docs/examples/README.md)** - Complete examples list
+
+### Resources
 - **[GitHub](https://github.com/aoneahsan/strata-storage)** - Source code
 - **[NPM](https://www.npmjs.com/package/strata-storage)** - Package registry
+- **[Example App](./examples/react-capacitor-app)** - Full demo application
 
 ---
 
@@ -108,13 +158,13 @@ await storage.set('data', value, { storage: 'firestore' });
 - ✅ **Filesystem** - File-based storage
 
 ### Advanced Features
-- ✅ **Encryption** - AES-GCM encryption with Web Crypto API
-- ✅ **Compression** - LZ-string compression algorithm
-- ✅ **Cross-Tab Sync** - Real-time synchronization across tabs
-- ✅ **Query Engine** - MongoDB-like queries for filtering data
-- ✅ **TTL Support** - Automatic expiration with sliding TTL
-- ✅ **Migration System** - Version-based data migrations
-- 🚧 **Framework Integrations** - React, Vue, Angular (coming soon)
+- ✅ **[Encryption](./docs/guides/features/encryption.md)** - AES-GCM encryption with Web Crypto API
+- ✅ **[Compression](./docs/guides/features/compression.md)** - LZ-string compression algorithm
+- ✅ **[Cross-Tab Sync](./docs/guides/features/sync.md)** - Real-time synchronization across tabs
+- ✅ **[Query Engine](./docs/guides/features/queries.md)** - MongoDB-like queries for filtering data
+- ✅ **[TTL Support](./docs/api/features/ttl.md)** - Automatic expiration with sliding TTL
+- ✅ **[Migration System](./docs/guides/features/migrations.md)** - Version-based data migrations
+- ✅ **Framework Integrations** - [React](./docs/examples/frameworks/react.md), [Vue](./docs/examples/frameworks/vue.md), [Angular](./docs/examples/frameworks/angular.md)
 
 ## 📖 Basic Usage
 
@@ -135,40 +185,72 @@ await storage.set('key', value, {
   ttl: 3600000,         // Expire in 1 hour
   encrypt: true,        // Encrypt this value
   compress: true,       // Compress if beneficial
-  tags: ['user-data']   // Tag for grouping
+  tags: ['user-data'],  // Tag for grouping
+  metadata: {           // Attach metadata
+    version: 1,
+    source: 'api'
+  }
 });
 
-// Query data
+// Query data with MongoDB-like syntax
 const results = await storage.query({
   tags: { $in: ['user-data'] },
-  'value.age': { $gte: 18 }
+  'value.age': { $gte: 18 },
+  'metadata.version': 1
 });
 
 // Subscribe to changes
 storage.subscribe((change) => {
   console.log(`${change.key} changed from ${change.oldValue} to ${change.newValue}`);
 });
+
+// Check storage size
+const size = await storage.size();
+console.log(`Using ${size.total} bytes for ${size.count} items`);
 ```
 
-## 🎯 Provider-less Architecture
+## 🎯 Why Strata Storage?
+
+### Provider-less Architecture
+Like Zustand, Strata Storage works without providers, contexts, or wrappers. Just import and use - no setup required.
+
+### Zero Dependencies
+Truly zero runtime dependencies. Everything is implemented from scratch for maximum control and minimal bundle size.
+
+### Universal Compatibility
+- **One API** - Same code works on Web, iOS, and Android
+- **Any Framework** - Works with React, Vue, Angular, or vanilla JavaScript
+- **TypeScript First** - Full type safety and excellent IntelliSense
+- **Tree-Shakeable** - Only bundle what you use
 
-Strata Storage follows a provider-less architecture similar to Zustand. The core library works everywhere with zero dependencies, and platform-specific features (like Capacitor) are completely optional.
+### Intelligent Storage Selection
+Automatically selects the best available storage based on:
+- Platform capabilities
+- Data size and type
+- Performance requirements
+- Persistence needs
 
-- **Minimal by default** - Only includes web storage adapters
-- **Opt-in native features** - Explicitly add Capacitor support when needed
-- **Better tree-shaking** - Unused adapters are eliminated by bundlers
-- **Smaller bundle size** - Web-only projects don't include native code
+### Enterprise Ready
+- **Encryption** - Built-in AES-GCM encryption
+- **Compression** - Automatic data compression
+- **TTL/Expiration** - Auto-cleanup of expired data
+- **Sync** - Real-time cross-tab/device synchronization
+- **Migrations** - Version-based data migrations
+- **Querying** - MongoDB-like query engine
 
 ## 🏗 Project Status
 
-Currently in active development. Phase 1-5 completed:
-- ✅ Project setup and core architecture
-- ✅ Memory and web storage adapters
-- ✅ Capacitor plugin structure (now optional)
+**Production Ready** - All major features implemented:
+- ✅ Zero-dependency architecture
+- ✅ Provider-less design (like Zustand)
+- ✅ All web storage adapters (localStorage, IndexedDB, etc.)
+- ✅ Complete Capacitor integration (iOS/Android)
+- ✅ Native implementations (iOS Swift, Android Java)
 - ✅ Advanced features (encryption, compression, sync, query, TTL)
-- ✅ Provider-less architecture
-- 🚧 Native implementations (iOS/Android)
-- 🚧 Testing and documentation
+- ✅ Framework integrations (React, Vue, Angular)
+- ✅ Comprehensive documentation
+- ✅ Full TypeScript support
+- ✅ Example application with all features
 
 ## 📄 License
 

package/android/src/main/java/com/strata/storage/EncryptedStorage.java

@@ -6,14 +6,20 @@ import android.os.Build;
 import androidx.security.crypto.EncryptedSharedPreferences;
 import androidx.security.crypto.MasterKey;
 import java.util.Set;
+import java.util.HashSet;
 import java.util.Map;
 
 public class EncryptedStorage {
     private SharedPreferences encryptedPrefs;
     private SharedPreferences.Editor editor;
+    private static final String DEFAULT_NAME = "StrataSecureStorage";
+    
+    public EncryptedStorage(Context context) throws Exception {
+        this(context, DEFAULT_NAME);
+    }
     
     public EncryptedStorage(Context context, String name) throws Exception {
-        String fileName = name != null ? name : "StrataSecureStorage";
+        String fileName = name != null ? name : DEFAULT_NAME;
         
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
             MasterKey masterKey = new MasterKey.Builder(context)
@@ -51,12 +57,47 @@ public class EncryptedStorage {
     }
     
     public boolean clear() {
-        editor.clear();
+        return clear(null);
+    }
+    
+    public boolean clear(String prefix) {
+        if (prefix != null) {
+            // Clear only keys with the given prefix
+            Set<String> keysToRemove = new HashSet<>();
+            for (String key : encryptedPrefs.getAll().keySet()) {
+                if (key.startsWith(prefix) || key.contains(prefix)) {
+                    keysToRemove.add(key);
+                }
+            }
+            for (String key : keysToRemove) {
+                editor.remove(key);
+            }
+        } else {
+            // Clear all keys
+            editor.clear();
+        }
         return editor.commit();
     }
     
     public Set<String> keys() {
-        return encryptedPrefs.getAll().keySet();
+        return keys(null);
+    }
+    
+    public Set<String> keys(String pattern) {
+        Set<String> allKeys = encryptedPrefs.getAll().keySet();
+        
+        if (pattern == null) {
+            return allKeys;
+        }
+        
+        // Filter keys by pattern
+        Set<String> filteredKeys = new HashSet<>();
+        for (String key : allKeys) {
+            if (key.startsWith(pattern) || key.contains(pattern)) {
+                filteredKeys.add(key);
+            }
+        }
+        return filteredKeys;
     }
     
     public boolean has(String key) {

package/android/src/main/java/com/strata/storage/SQLiteStorage.java

@@ -13,6 +13,7 @@ import java.util.Map;
 public class SQLiteStorage extends SQLiteOpenHelper {
     private static final int DATABASE_VERSION = 1;
     private static final String TABLE_NAME = "strata_storage";
+    private static final String DEFAULT_DB_NAME = "strata.db";
     
     private static final String KEY_ID = "key";
     private static final String KEY_VALUE = "value";
@@ -22,8 +23,12 @@ public class SQLiteStorage extends SQLiteOpenHelper {
     private static final String KEY_TAGS = "tags";
     private static final String KEY_METADATA = "metadata";
     
+    public SQLiteStorage(Context context) {
+        this(context, DEFAULT_DB_NAME);
+    }
+    
     public SQLiteStorage(Context context, String dbName) {
-        super(context, dbName != null ? dbName : "strata.db", null, DATABASE_VERSION);
+        super(context, dbName != null ? dbName : DEFAULT_DB_NAME, null, DATABASE_VERSION);
     }
     
     @Override
@@ -112,18 +117,43 @@ public class SQLiteStorage extends SQLiteOpenHelper {
     }
     
     public boolean clear() {
+        return clear(null);
+    }
+    
+    public boolean clear(String prefix) {
         SQLiteDatabase db = this.getWritableDatabase();
-        db.delete(TABLE_NAME, null, null);
+        int result;
+        
+        if (prefix != null) {
+            // Clear only keys with the given prefix
+            result = db.delete(TABLE_NAME, KEY_ID + " LIKE ?", new String[]{prefix + "%"});
+        } else {
+            // Clear all keys
+            result = db.delete(TABLE_NAME, null, null);
+        }
+        
         db.close();
-        return true;
+        return result >= 0;
     }
     
     public List<String> keys() {
+        return keys(null);
+    }
+    
+    public List<String> keys(String pattern) {
         List<String> keys = new ArrayList<>();
-        String selectQuery = "SELECT " + KEY_ID + " FROM " + TABLE_NAME;
+        String selectQuery;
+        String[] selectionArgs = null;
+        
+        if (pattern != null) {
+            selectQuery = "SELECT " + KEY_ID + " FROM " + TABLE_NAME + " WHERE " + KEY_ID + " LIKE ?";
+            selectionArgs = new String[]{"% " + pattern + "%"};
+        } else {
+            selectQuery = "SELECT " + KEY_ID + " FROM " + TABLE_NAME;
+        }
         
         SQLiteDatabase db = this.getReadableDatabase();
-        Cursor cursor = db.rawQuery(selectQuery, null);
+        Cursor cursor = db.rawQuery(selectQuery, selectionArgs);
         
         if (cursor.moveToFirst()) {
             do {

package/android/src/main/java/com/strata/storage/SharedPreferencesStorage.java

@@ -11,9 +11,14 @@ import org.json.JSONArray;
 public class SharedPreferencesStorage {
     private final SharedPreferences prefs;
     private final SharedPreferences.Editor editor;
+    private static final String DEFAULT_NAME = "StrataStorage";
+    
+    public SharedPreferencesStorage(Context context) {
+        this(context, DEFAULT_NAME);
+    }
     
     public SharedPreferencesStorage(Context context, String name) {
-        this.prefs = context.getSharedPreferences(name != null ? name : "StrataStorage", Context.MODE_PRIVATE);
+        this.prefs = context.getSharedPreferences(name != null ? name : DEFAULT_NAME, Context.MODE_PRIVATE);
         this.editor = prefs.edit();
     }
     
@@ -56,12 +61,47 @@ public class SharedPreferencesStorage {
     }
     
     public boolean clear() {
-        editor.clear();
+        return clear(null);
+    }
+    
+    public boolean clear(String prefix) {
+        if (prefix != null) {
+            // Clear only keys with the given prefix
+            Set<String> keysToRemove = new HashSet<>();
+            for (String key : prefs.getAll().keySet()) {
+                if (key.startsWith(prefix) || key.contains(prefix)) {
+                    keysToRemove.add(key);
+                }
+            }
+            for (String key : keysToRemove) {
+                editor.remove(key);
+            }
+        } else {
+            // Clear all keys
+            editor.clear();
+        }
         return editor.commit();
     }
     
     public Set<String> keys() {
-        return prefs.getAll().keySet();
+        return keys(null);
+    }
+    
+    public Set<String> keys(String pattern) {
+        Set<String> allKeys = prefs.getAll().keySet();
+        
+        if (pattern == null) {
+            return allKeys;
+        }
+        
+        // Filter keys by pattern
+        Set<String> filteredKeys = new HashSet<>();
+        for (String key : allKeys) {
+            if (key.startsWith(pattern) || key.contains(pattern)) {
+                filteredKeys.add(key);
+            }
+        }
+        return filteredKeys;
     }
     
     public boolean has(String key) {

package/android/src/main/java/com/stratastorage/StrataStoragePlugin.java

@@ -5,9 +5,13 @@ import com.getcapacitor.Plugin;
 import com.getcapacitor.PluginCall;
 import com.getcapacitor.PluginMethod;
 import com.getcapacitor.annotation.CapacitorPlugin;
+import com.strata.storage.SharedPreferencesStorage;
+import com.strata.storage.EncryptedStorage;
+import com.strata.storage.SQLiteStorage;
 import org.json.JSONArray;
 import org.json.JSONException;
 import java.util.List;
+import java.util.Set;
 
 /**
  * Main Capacitor plugin for Strata Storage
@@ -21,9 +25,14 @@ public class StrataStoragePlugin extends Plugin {
 
     @Override
     public void load() {
-        sharedPrefsStorage = new SharedPreferencesStorage(getContext());
-        encryptedStorage = new EncryptedStorage(getContext());
-        sqliteStorage = new SQLiteStorage(getContext());
+        try {
+            sharedPrefsStorage = new SharedPreferencesStorage(getContext());
+            encryptedStorage = new EncryptedStorage(getContext());
+            sqliteStorage = new SQLiteStorage(getContext());
+        } catch (Exception e) {
+            // Log error but don't crash - some storage types may not be available
+            e.printStackTrace();
+        }
     }
 
     /**

package/dist/android/src/main/java/com/strata/storage/EncryptedStorage.java

@@ -6,14 +6,20 @@ import android.os.Build;
 import androidx.security.crypto.EncryptedSharedPreferences;
 import androidx.security.crypto.MasterKey;
 import java.util.Set;
+import java.util.HashSet;
 import java.util.Map;
 
 public class EncryptedStorage {
     private SharedPreferences encryptedPrefs;
     private SharedPreferences.Editor editor;
+    private static final String DEFAULT_NAME = "StrataSecureStorage";
+    
+    public EncryptedStorage(Context context) throws Exception {
+        this(context, DEFAULT_NAME);
+    }
     
     public EncryptedStorage(Context context, String name) throws Exception {
-        String fileName = name != null ? name : "StrataSecureStorage";
+        String fileName = name != null ? name : DEFAULT_NAME;
         
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
             MasterKey masterKey = new MasterKey.Builder(context)
@@ -51,12 +57,47 @@ public class EncryptedStorage {
     }
     
     public boolean clear() {
-        editor.clear();
+        return clear(null);
+    }
+    
+    public boolean clear(String prefix) {
+        if (prefix != null) {
+            // Clear only keys with the given prefix
+            Set<String> keysToRemove = new HashSet<>();
+            for (String key : encryptedPrefs.getAll().keySet()) {
+                if (key.startsWith(prefix) || key.contains(prefix)) {
+                    keysToRemove.add(key);
+                }
+            }
+            for (String key : keysToRemove) {
+                editor.remove(key);
+            }
+        } else {
+            // Clear all keys
+            editor.clear();
+        }
         return editor.commit();
     }
     
     public Set<String> keys() {
-        return encryptedPrefs.getAll().keySet();
+        return keys(null);
+    }
+    
+    public Set<String> keys(String pattern) {
+        Set<String> allKeys = encryptedPrefs.getAll().keySet();
+        
+        if (pattern == null) {
+            return allKeys;
+        }
+        
+        // Filter keys by pattern
+        Set<String> filteredKeys = new HashSet<>();
+        for (String key : allKeys) {
+            if (key.startsWith(pattern) || key.contains(pattern)) {
+                filteredKeys.add(key);
+            }
+        }
+        return filteredKeys;
     }
     
     public boolean has(String key) {

package/dist/android/src/main/java/com/strata/storage/SQLiteStorage.java

@@ -13,6 +13,7 @@ import java.util.Map;
 public class SQLiteStorage extends SQLiteOpenHelper {
     private static final int DATABASE_VERSION = 1;
     private static final String TABLE_NAME = "strata_storage";
+    private static final String DEFAULT_DB_NAME = "strata.db";
     
     private static final String KEY_ID = "key";
     private static final String KEY_VALUE = "value";
@@ -22,8 +23,12 @@ public class SQLiteStorage extends SQLiteOpenHelper {
     private static final String KEY_TAGS = "tags";
     private static final String KEY_METADATA = "metadata";
     
+    public SQLiteStorage(Context context) {
+        this(context, DEFAULT_DB_NAME);
+    }
+    
     public SQLiteStorage(Context context, String dbName) {
-        super(context, dbName != null ? dbName : "strata.db", null, DATABASE_VERSION);
+        super(context, dbName != null ? dbName : DEFAULT_DB_NAME, null, DATABASE_VERSION);
     }
     
     @Override
@@ -112,18 +117,43 @@ public class SQLiteStorage extends SQLiteOpenHelper {
     }
     
     public boolean clear() {
+        return clear(null);
+    }
+    
+    public boolean clear(String prefix) {
         SQLiteDatabase db = this.getWritableDatabase();
-        db.delete(TABLE_NAME, null, null);
+        int result;
+        
+        if (prefix != null) {
+            // Clear only keys with the given prefix
+            result = db.delete(TABLE_NAME, KEY_ID + " LIKE ?", new String[]{prefix + "%"});
+        } else {
+            // Clear all keys
+            result = db.delete(TABLE_NAME, null, null);
+        }
+        
         db.close();
-        return true;
+        return result >= 0;
     }
     
     public List<String> keys() {
+        return keys(null);
+    }
+    
+    public List<String> keys(String pattern) {
         List<String> keys = new ArrayList<>();
-        String selectQuery = "SELECT " + KEY_ID + " FROM " + TABLE_NAME;
+        String selectQuery;
+        String[] selectionArgs = null;
+        
+        if (pattern != null) {
+            selectQuery = "SELECT " + KEY_ID + " FROM " + TABLE_NAME + " WHERE " + KEY_ID + " LIKE ?";
+            selectionArgs = new String[]{"% " + pattern + "%"};
+        } else {
+            selectQuery = "SELECT " + KEY_ID + " FROM " + TABLE_NAME;
+        }
         
         SQLiteDatabase db = this.getReadableDatabase();
-        Cursor cursor = db.rawQuery(selectQuery, null);
+        Cursor cursor = db.rawQuery(selectQuery, selectionArgs);
         
         if (cursor.moveToFirst()) {
             do {

package/dist/android/src/main/java/com/strata/storage/SharedPreferencesStorage.java

@@ -11,9 +11,14 @@ import org.json.JSONArray;
 public class SharedPreferencesStorage {
     private final SharedPreferences prefs;
     private final SharedPreferences.Editor editor;
+    private static final String DEFAULT_NAME = "StrataStorage";
+    
+    public SharedPreferencesStorage(Context context) {
+        this(context, DEFAULT_NAME);
+    }
     
     public SharedPreferencesStorage(Context context, String name) {
-        this.prefs = context.getSharedPreferences(name != null ? name : "StrataStorage", Context.MODE_PRIVATE);
+        this.prefs = context.getSharedPreferences(name != null ? name : DEFAULT_NAME, Context.MODE_PRIVATE);
         this.editor = prefs.edit();
     }
     
@@ -56,12 +61,47 @@ public class SharedPreferencesStorage {
     }
     
     public boolean clear() {
-        editor.clear();
+        return clear(null);
+    }
+    
+    public boolean clear(String prefix) {
+        if (prefix != null) {
+            // Clear only keys with the given prefix
+            Set<String> keysToRemove = new HashSet<>();
+            for (String key : prefs.getAll().keySet()) {
+                if (key.startsWith(prefix) || key.contains(prefix)) {
+                    keysToRemove.add(key);
+                }
+            }
+            for (String key : keysToRemove) {
+                editor.remove(key);
+            }
+        } else {
+            // Clear all keys
+            editor.clear();
+        }
         return editor.commit();
     }
     
     public Set<String> keys() {
-        return prefs.getAll().keySet();
+        return keys(null);
+    }
+    
+    public Set<String> keys(String pattern) {
+        Set<String> allKeys = prefs.getAll().keySet();
+        
+        if (pattern == null) {
+            return allKeys;
+        }
+        
+        // Filter keys by pattern
+        Set<String> filteredKeys = new HashSet<>();
+        for (String key : allKeys) {
+            if (key.startsWith(pattern) || key.contains(pattern)) {
+                filteredKeys.add(key);
+            }
+        }
+        return filteredKeys;
     }
     
     public boolean has(String key) {

package/dist/android/src/main/java/com/stratastorage/StrataStoragePlugin.java

@@ -5,9 +5,13 @@ import com.getcapacitor.Plugin;
 import com.getcapacitor.PluginCall;
 import com.getcapacitor.PluginMethod;
 import com.getcapacitor.annotation.CapacitorPlugin;
+import com.strata.storage.SharedPreferencesStorage;
+import com.strata.storage.EncryptedStorage;
+import com.strata.storage.SQLiteStorage;
 import org.json.JSONArray;
 import org.json.JSONException;
 import java.util.List;
+import java.util.Set;
 
 /**
  * Main Capacitor plugin for Strata Storage
@@ -21,9 +25,14 @@ public class StrataStoragePlugin extends Plugin {
 
     @Override
     public void load() {
-        sharedPrefsStorage = new SharedPreferencesStorage(getContext());
-        encryptedStorage = new EncryptedStorage(getContext());
-        sqliteStorage = new SQLiteStorage(getContext());
+        try {
+            sharedPrefsStorage = new SharedPreferencesStorage(getContext());
+            encryptedStorage = new EncryptedStorage(getContext());
+            sqliteStorage = new SQLiteStorage(getContext());
+        } catch (Exception e) {
+            // Log error but don't crash - some storage types may not be available
+            e.printStackTrace();
+        }
     }
 
     /**

package/dist/capacitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capacitor.d.ts","sourceRoot":"","sources":["../src/capacitor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAO5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAG3E,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB9E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAMhD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAEnD"}
+{"version":3,"file":"capacitor.d.ts","sourceRoot":"","sources":["../src/capacitor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAO5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAG3E,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB9E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAShD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAEnD"}