strata-storage 2.0.3 → 2.0.4

package/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/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/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": "dist/index.js",
@@ -69,10 +69,10 @@
   "homepage": "https://github.com/aoneahsan/strata-storage#readme",
   "dependencies": {},
   "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": {
@@ -90,22 +90,22 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.0",
-    "@types/node": "^24.2.0",
-    "@types/react": "^19.1.9",
-    "@typescript-eslint/eslint-plugin": "^8.39.0",
-    "@typescript-eslint/parser": "^8.39.0",
+    "@types/node": "^24.6.0",
+    "@types/react": "^19.1.16",
+    "@typescript-eslint/eslint-plugin": "^8.45.0",
+    "@typescript-eslint/parser": "^8.45.0",
     "@vitest/coverage-v8": "^3.2.4",
-    "eslint": "^9.32.0",
+    "eslint": "^9.36.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.3",
-    "jsdom": "^26.1.0",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jsdom": "^27.0.0",
     "prettier": "^3.6.2",
-    "typescript": "^5.9.2",
-    "typescript-eslint": "^8.39.0",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.45.0",
     "vitest": "^3.2.4"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=24.2.0"
   },
   "capacitor": {
     "ios": {

package/dist/README.md

@@ -1,179 +0,0 @@
-# Strata Storage
-
-## 📚 Documentation
-
-- **[Getting Started](./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
-- **[GitHub](https://github.com/aoneahsan/strata-storage)** - Source code
-- **[NPM](https://www.npmjs.com/package/strata-storage)** - Package registry
-
----
-
-**One API. Every Storage. Everywhere.**
-
-Zero-dependency universal storage plugin providing a unified API for all storage operations across web, Android, and iOS platforms.
-
-## 🚀 Quick Start
-
-```bash
-npm install strata-storage
-```
-
-### Provider-less Usage (Zero Setup)
-```typescript
-import { storage } from 'strata-storage';
-
-// Works immediately - no setup, no providers, no initialization!
-await storage.set('user', { name: 'John', age: 30 });
-const user = await storage.get('user');
-```
-
-### Complete Example App
-
-Check out our [React + Capacitor example app](./examples/react-capacitor-app) that demonstrates all features:
-- All storage adapters working correctly
-- Web, Android, and iOS platform support
-- Real-time testing interface
-- Complete error handling
-
-Run the example:
-```bash
-cd examples/react-capacitor-app
-yarn install
-yarn start  # For web
-npx cap run android  # For Android
-npx cap run ios  # For iOS
-```
-
-### With Capacitor (Optional)
-```typescript
-import { storage } from 'strata-storage';
-import { registerCapacitorAdapters } from 'strata-storage/capacitor';
-
-// Only if you need native features
-if (window.Capacitor) {
-  await registerCapacitorAdapters(storage);
-}
-
-// Use native storage when available
-await storage.set('secure-data', 'secret', { storage: 'secure' });
-```
-
-### With Firebase (Optional)
-```typescript
-import { storage } from 'strata-storage';
-import { enableFirebaseSync } from 'strata-storage/firebase';
-
-// Only if you need cloud sync
-if (needCloudSync) {
-  await enableFirebaseSync(storage, {
-    apiKey: 'your-api-key',
-    projectId: 'your-project-id',
-    firestore: true
-  });
-}
-
-// Works offline-first, syncs when online
-await storage.set('data', value, { storage: 'firestore' });
-```
-
-## ✨ Features
-
-### Core Features
-- ✅ **Zero Dependencies** - No runtime dependencies, pure implementation
-- ✅ **Provider-less Architecture** - No providers, contexts, or wrappers needed (like zustand)
-- ✅ **Works Everywhere** - React, Vue, Angular, Vanilla JS, Node.js - same API
-- ✅ **Zero Configuration** - Import and use immediately, no setup required
-- ✅ **Opt-in Complexity** - Start simple, add features only when needed
-- ✅ **Dynamic Provider Loading** - Providers load only when used, keeping bundle small
-- ✅ **Universal API** - Single interface for all storage types
-- ✅ **Cross-Platform** - Web, iOS, Android support
-- ✅ **TypeScript** - Full type safety and IntelliSense
-- ✅ **Auto Fallback** - Intelligent storage selection
-
-### Storage Adapters
-- ✅ **Memory** - Fast in-memory storage
-- ✅ **LocalStorage** - Persistent browser storage
-- ✅ **SessionStorage** - Session-based browser storage
-- ✅ **IndexedDB** - Large-scale browser database
-- ✅ **Cookies** - HTTP cookie storage
-- ✅ **Cache API** - Service worker cache storage
-- ✅ **Capacitor Preferences** - Native mobile preferences
-- ✅ **SQLite** - Mobile SQL database
-- ✅ **Secure Storage** - Keychain (iOS) / Encrypted SharedPreferences (Android)
-- ✅ **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)
-
-## 📖 Basic Usage
-
-```typescript
-import { storage } from 'strata-storage';
-
-// No initialization needed - works immediately!
-
-// Simple usage
-await storage.set('key', 'value');
-const value = await storage.get('key');
-await storage.remove('key');
-await storage.clear();
-
-// Advanced options
-await storage.set('key', value, {
-  storage: 'indexedDB',  // Choose specific storage
-  ttl: 3600000,         // Expire in 1 hour
-  encrypt: true,        // Encrypt this value
-  compress: true,       // Compress if beneficial
-  tags: ['user-data']   // Tag for grouping
-});
-
-// Query data
-const results = await storage.query({
-  tags: { $in: ['user-data'] },
-  'value.age': { $gte: 18 }
-});
-
-// Subscribe to changes
-storage.subscribe((change) => {
-  console.log(`${change.key} changed from ${change.oldValue} to ${change.newValue}`);
-});
-```
-
-## 🎯 Provider-less Architecture
-
-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.
-
-- **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
-
-## 🏗 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)
-- ✅ Advanced features (encryption, compression, sync, query, TTL)
-- ✅ Provider-less architecture
-- 🚧 Native implementations (iOS/Android)
-- 🚧 Testing and documentation
-
-## 📄 License
-
-MIT
-
----
-
-Created by Ahsan Mahmood