strata-storage 1.5.0 → 2.0.0

package/dist/index.d.ts

@@ -1,56 +1,22 @@
-/**
- * Strata Storage - Zero-dependency universal storage plugin
- *
- * @packageDocumentation
- */
 export { Strata } from './core/Strata';
-import { Strata } from './core/Strata';
-export type { Platform, StorageType, StorageStrategy, StorageOptions, StorageValue, StorageChange, StorageCapabilities, StrataConfig, StorageAdapter, Transaction, ClearOptions, SizeInfo, ExportOptions, ImportOptions, QueryCondition, QueryOperators, SubscriptionCallback, UnsubscribeFunction, Migration, ExportFormat, } from './types';
-export { StrataError, StorageError, NotFoundError, QuotaExceededError, AdapterNotAvailableError, NotSupportedError, EncryptionError, CompressionError, SerializationError, ValidationError, TransactionError, MigrationError, SyncError, isStrataError, isQuotaError, } from './utils/errors';
-export { serialize, deserialize, deepClone, deepMerge, formatBytes, parseSize, EventEmitter, } from './utils';
 export { BaseAdapter } from './core/BaseAdapter';
 export { AdapterRegistry } from './core/AdapterRegistry';
-export { EncryptionManager } from './features/encryption';
-export type { EncryptionConfig, EncryptedData } from './features/encryption';
-export { CompressionManager } from './features/compression';
-export type { CompressionConfig, CompressedData } from './features/compression';
-export { SyncManager, createSyncManager } from './features/sync';
-export type { SyncConfig, SyncMessage } from './features/sync';
-export { QueryEngine, createQueryEngine } from './features/query';
-export { TTLManager, createTTLManager } from './features/ttl';
-export type { TTLConfig, TTLOptions, ExpiredItem } from './features/ttl';
-export { MigrationManager } from './features/migration';
-export type { Migration as MigrationDefinition } from './features/migration';
-export * from './plugin/definitions';
-export { StrataStorage } from './plugin';
-export { MemoryAdapter } from './adapters/web/MemoryAdapter';
 export { LocalStorageAdapter } from './adapters/web/LocalStorageAdapter';
 export { SessionStorageAdapter } from './adapters/web/SessionStorageAdapter';
 export { IndexedDBAdapter } from './adapters/web/IndexedDBAdapter';
 export { CookieAdapter } from './adapters/web/CookieAdapter';
 export { CacheAdapter } from './adapters/web/CacheAdapter';
-export { PreferencesAdapter } from './adapters/capacitor/PreferencesAdapter';
-export { SqliteAdapter } from './adapters/capacitor/SqliteAdapter';
-export type { SqliteConfig } from './adapters/capacitor/SqliteAdapter';
-export { SecureAdapter } from './adapters/capacitor/SecureAdapter';
-export { FilesystemAdapter } from './adapters/capacitor/FilesystemAdapter';
-/**
- * Create a new Strata instance with optional configuration
- *
- * @example
- * ```typescript
- * import { Strata } from 'strata-storage';
- *
- * const storage = new Strata({
- *   defaultStorages: ['indexedDB', 'localStorage', 'memory'],
- *   encryption: { enabled: true },
- *   compression: { enabled: true }
- * });
- *
- * await storage.initialize();
- * await storage.set('key', 'value');
- * const value = await storage.get('key');
- * ```
- */
-export declare function createStrata(config?: import('./types').StrataConfig): InstanceType<typeof Strata>;
+export { MemoryAdapter } from './adapters/web/MemoryAdapter';
+export { EncryptionManager } from './features/encryption';
+export { CompressionManager } from './features/compression';
+export { TTLManager } from './features/ttl';
+export { QueryEngine } from './features/query';
+export { SyncManager } from './features/sync';
+export { StorageObserver } from './features/observer';
+export type { StorageType, StorageOptions, StorageValue, StorageAdapter, AdapterConfig, QueryOptions, SyncConfig, EncryptionConfig, CompressionConfig, ObserverCallback, StorageEvent, StorageError, StorageCapabilities, StorageMetadata, TTLConfig, } from './types';
+export { isValidKey, isValidValue, serializeValue, deserializeValue, generateId, createError, retry, debounce, throttle, } from './utils';
+import { Strata } from './core/Strata';
+declare const storage: Strata;
+export { storage };
+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":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvC,YAAY,EAEV,QAAQ,EACR,WAAW,EACX,eAAe,EACf,cAAc,EACd,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,YAAY,EAGZ,cAAc,EACd,WAAW,EAGX,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EAGd,oBAAoB,EACpB,mBAAmB,EAGnB,SAAS,EACT,YAAY,GACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,SAAS,EACT,WAAW,EACX,SAAS,EACT,SAAS,EACT,WAAW,EACX,SAAS,EACT,YAAY,GACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACjE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,SAAS,IAAI,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG7E,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,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;AAG3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAE3E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,SAAS,EAAE,YAAY,GAAG,YAAY,CAAC,OAAO,MAAM,CAAC,CAEjG"}
+{"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"}

package/dist/index.js

@@ -1,58 +1,54 @@
-/**
- * Strata Storage - Zero-dependency universal storage plugin
- *
- * @packageDocumentation
- */
-// Main export
-export { Strata } from './core/Strata';
-import { Strata } from './core/Strata';
-// Errors
-export { StrataError, StorageError, NotFoundError, QuotaExceededError, AdapterNotAvailableError, NotSupportedError, EncryptionError, CompressionError, SerializationError, ValidationError, TransactionError, MigrationError, SyncError, isStrataError, isQuotaError, } from './utils/errors';
-// Utilities (selected exports for advanced users)
-export { serialize, deserialize, deepClone, deepMerge, formatBytes, parseSize, EventEmitter, } from './utils';
-// Base classes for custom adapters
-export { BaseAdapter } from './core/BaseAdapter';
-export { AdapterRegistry } from './core/AdapterRegistry';
-// Features
-export { EncryptionManager } from './features/encryption';
-export { CompressionManager } from './features/compression';
-export { SyncManager, createSyncManager } from './features/sync';
-export { QueryEngine, createQueryEngine } from './features/query';
-export { TTLManager, createTTLManager } from './features/ttl';
-export { MigrationManager } from './features/migration';
-// Plugin definitions and main plugin
-export * from './plugin/definitions';
-export { StrataStorage } from './plugin';
-// Web Storage Adapters (for advanced users who want direct adapter access)
-export { MemoryAdapter } from './adapters/web/MemoryAdapter';
-export { LocalStorageAdapter } from './adapters/web/LocalStorageAdapter';
-export { SessionStorageAdapter } from './adapters/web/SessionStorageAdapter';
-export { IndexedDBAdapter } from './adapters/web/IndexedDBAdapter';
-export { CookieAdapter } from './adapters/web/CookieAdapter';
-export { CacheAdapter } from './adapters/web/CacheAdapter';
-// Capacitor Storage Adapters
-export { PreferencesAdapter } from './adapters/capacitor/PreferencesAdapter';
-export { SqliteAdapter } from './adapters/capacitor/SqliteAdapter';
-export { SecureAdapter } from './adapters/capacitor/SecureAdapter';
-export { FilesystemAdapter } from './adapters/capacitor/FilesystemAdapter';
-/**
- * Create a new Strata instance with optional configuration
- *
- * @example
- * ```typescript
- * import { Strata } from 'strata-storage';
- *
- * const storage = new Strata({
- *   defaultStorages: ['indexedDB', 'localStorage', 'memory'],
- *   encryption: { enabled: true },
- *   compression: { enabled: true }
- * });
- *
- * await storage.initialize();
- * await storage.set('key', 'value');
- * const value = await storage.get('key');
- * ```
- */
-export function createStrata(config) {
-    return new Strata(config);
-}
+// Core exports - zero dependencies, works everywhere
+export { Strata } from "./core/Strata.js";
+export { BaseAdapter } from "./core/BaseAdapter.js";
+export { AdapterRegistry } from "./core/AdapterRegistry.js";
+// Web adapters - work in any JavaScript environment
+export { LocalStorageAdapter } from "./adapters/web/LocalStorageAdapter.js";
+export { SessionStorageAdapter } from "./adapters/web/SessionStorageAdapter.js";
+export { IndexedDBAdapter } from "./adapters/web/IndexedDBAdapter.js";
+export { CookieAdapter } from "./adapters/web/CookieAdapter.js";
+export { CacheAdapter } from "./adapters/web/CacheAdapter.js";
+export { MemoryAdapter } from "./adapters/web/MemoryAdapter.js";
+// Core features
+export { EncryptionManager } from "./features/encryption.js";
+export { CompressionManager } from "./features/compression.js";
+export { TTLManager } from "./features/ttl.js";
+export { QueryEngine } from "./features/query.js";
+export { SyncManager } from "./features/sync.js";
+export { StorageObserver } from "./features/observer.js";
+// Utils
+export { isValidKey, isValidValue, serializeValue, deserializeValue, generateId, createError, retry, debounce, throttle, } from "./utils/index.js";
+// Create and export a default storage instance that works immediately
+import { Strata } from "./core/Strata.js";
+import { LocalStorageAdapter } from "./adapters/web/LocalStorageAdapter.js";
+import { SessionStorageAdapter } from "./adapters/web/SessionStorageAdapter.js";
+import { IndexedDBAdapter } from "./adapters/web/IndexedDBAdapter.js";
+import { CookieAdapter } from "./adapters/web/CookieAdapter.js";
+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
+    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());
+// Initialize the storage instance
+(async () => {
+    try {
+        await storage.initialize();
+    }
+    catch (error) {
+        console.warn('Strata Storage initialization warning:', error);
+        // Continue working even if some adapters fail
+    }
+})();
+// Export the ready-to-use storage instance
+export { storage };
+// Default export for convenience
+export default storage;

package/dist/ios/Plugin/KeychainStorage.swift

@@ -0,0 +1,87 @@
+import Foundation
+import Security
+
+@objc public class KeychainStorage: NSObject {
+    private let service: String
+    private let accessGroup: String?
+    
+    @objc public init(service: String? = nil, accessGroup: String? = nil) {
+        self.service = service ?? Bundle.main.bundleIdentifier ?? "StrataStorage"
+        self.accessGroup = accessGroup
+        super.init()
+    }
+    
+    @objc public func set(key: String, value: Data) -> Bool {
+        let query = createQuery(key: key)
+        SecItemDelete(query as CFDictionary)
+        
+        var newItem = query
+        newItem[kSecValueData as String] = value
+        
+        let status = SecItemAdd(newItem as CFDictionary, nil)
+        return status == errSecSuccess
+    }
+    
+    @objc public func get(key: String) -> Data? {
+        var query = createQuery(key: key)
+        query[kSecReturnData as String] = true
+        query[kSecMatchLimit as String] = kSecMatchLimitOne
+        
+        var result: AnyObject?
+        let status = SecItemCopyMatching(query as CFDictionary, &result)
+        
+        guard status == errSecSuccess else { return nil }
+        return result as? Data
+    }
+    
+    @objc public func remove(key: String) -> Bool {
+        let query = createQuery(key: key)
+        let status = SecItemDelete(query as CFDictionary)
+        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 keys() -> [String] {
+        var query: [String: Any] = [
+            kSecClass as String: kSecClassGenericPassword,
+            kSecAttrService as String: service,
+            kSecReturnAttributes as String: true,
+            kSecMatchLimit as String: kSecMatchLimitAll
+        ]
+        
+        if let accessGroup = accessGroup {
+            query[kSecAttrAccessGroup as String] = accessGroup
+        }
+        
+        var result: AnyObject?
+        let status = SecItemCopyMatching(query as CFDictionary, &result)
+        
+        guard status == errSecSuccess,
+              let items = result as? [[String: Any]] else { return [] }
+        
+        return items.compactMap { $0[kSecAttrAccount as String] as? String }
+    }
+    
+    private func createQuery(key: String) -> [String: Any] {
+        var query: [String: Any] = [
+            kSecClass as String: kSecClassGenericPassword,
+            kSecAttrService as String: service,
+            kSecAttrAccount as String: key,
+            kSecAttrAccessible as String: kSecAttrAccessibleWhenUnlockedThisDeviceOnly
+        ]
+        
+        if let accessGroup = accessGroup {
+            query[kSecAttrAccessGroup as String] = accessGroup
+        }
+        
+        return query
+    }
+}

package/dist/ios/Plugin/SQLiteStorage.swift

@@ -0,0 +1,167 @@
+import Foundation
+import SQLite3
+
+@objc public class SQLiteStorage: NSObject {
+    private var db: OpaquePointer?
+    private let dbName: String
+    private let tableName = "strata_storage"
+    
+    @objc public init(dbName: String = "strata.db") {
+        self.dbName = dbName
+        super.init()
+        openDatabase()
+        createTable()
+    }
+    
+    deinit {
+        closeDatabase()
+    }
+    
+    private func openDatabase() {
+        let fileURL = try! FileManager.default
+            .url(for: .documentDirectory, in: .userDomainMask, appropriateFor: nil, create: false)
+            .appendingPathComponent(dbName)
+        
+        if sqlite3_open(fileURL.path, &db) != SQLITE_OK {
+            print("Unable to open database")
+        }
+    }
+    
+    private func closeDatabase() {
+        sqlite3_close(db)
+    }
+    
+    private func createTable() {
+        let createTableString = """
+            CREATE TABLE IF NOT EXISTS \(tableName) (
+                key TEXT PRIMARY KEY NOT NULL,
+                value BLOB NOT NULL,
+                created INTEGER NOT NULL,
+                updated INTEGER NOT NULL,
+                expires INTEGER,
+                tags TEXT,
+                metadata TEXT
+            );
+        """
+        
+        var createTableStatement: OpaquePointer?
+        if sqlite3_prepare_v2(db, createTableString, -1, &createTableStatement, nil) == SQLITE_OK {
+            if sqlite3_step(createTableStatement) == SQLITE_DONE {
+                print("Storage table created.")
+            }
+        }
+        sqlite3_finalize(createTableStatement)
+    }
+    
+    @objc public func set(key: String, value: Data, expires: Int64? = nil, tags: [String]? = nil, metadata: [String: Any]? = nil) -> Bool {
+        let now = Int64(Date().timeIntervalSince1970 * 1000)
+        let tagsJson = tags != nil ? try? JSONSerialization.data(withJSONObject: tags!, options: []) : nil
+        let metadataJson = metadata != nil ? try? JSONSerialization.data(withJSONObject: metadata!, options: []) : nil
+        
+        let insertSQL = """
+            INSERT OR REPLACE INTO \(tableName) 
+            (key, value, created, updated, expires, tags, metadata) 
+            VALUES (?, ?, ?, ?, ?, ?, ?)
+        """
+        
+        var statement: OpaquePointer?
+        let result = sqlite3_prepare_v2(db, insertSQL, -1, &statement, nil) == SQLITE_OK &&
+            sqlite3_bind_text(statement, 1, key, -1, nil) == SQLITE_OK &&
+            sqlite3_bind_blob(statement, 2, (value as NSData).bytes, Int32(value.count), nil) == SQLITE_OK &&
+            sqlite3_bind_int64(statement, 3, now) == SQLITE_OK &&
+            sqlite3_bind_int64(statement, 4, now) == SQLITE_OK &&
+            (expires != nil ? sqlite3_bind_int64(statement, 5, expires!) : sqlite3_bind_null(statement, 5)) == SQLITE_OK &&
+            (tagsJson != nil ? sqlite3_bind_blob(statement, 6, (tagsJson! as NSData).bytes, Int32(tagsJson!.count), nil) : sqlite3_bind_null(statement, 6)) == SQLITE_OK &&
+            (metadataJson != nil ? sqlite3_bind_blob(statement, 7, (metadataJson! as NSData).bytes, Int32(metadataJson!.count), nil) : sqlite3_bind_null(statement, 7)) == SQLITE_OK &&
+            sqlite3_step(statement) == SQLITE_DONE
+        
+        sqlite3_finalize(statement)
+        return result
+    }
+    
+    @objc public func get(key: String) -> [String: Any]? {
+        let querySQL = "SELECT * FROM \(tableName) WHERE key = ? LIMIT 1"
+        var statement: OpaquePointer?
+        
+        guard sqlite3_prepare_v2(db, querySQL, -1, &statement, nil) == SQLITE_OK,
+              sqlite3_bind_text(statement, 1, key, -1, nil) == SQLITE_OK else {
+            sqlite3_finalize(statement)
+            return nil
+        }
+        
+        var result: [String: Any]?
+        if sqlite3_step(statement) == SQLITE_ROW {
+            let valueData = Data(bytes: sqlite3_column_blob(statement, 1), count: Int(sqlite3_column_bytes(statement, 1)))
+            let created = sqlite3_column_int64(statement, 2)
+            let updated = sqlite3_column_int64(statement, 3)
+            
+            result = [
+                "key": key,
+                "value": valueData,
+                "created": created,
+                "updated": updated
+            ]
+            
+            if sqlite3_column_type(statement, 4) != SQLITE_NULL {
+                result!["expires"] = sqlite3_column_int64(statement, 4)
+            }
+            
+            if sqlite3_column_type(statement, 5) != SQLITE_NULL {
+                let tagsData = Data(bytes: sqlite3_column_blob(statement, 5), count: Int(sqlite3_column_bytes(statement, 5)))
+                if let tags = try? JSONSerialization.jsonObject(with: tagsData, options: []) {
+                    result!["tags"] = tags
+                }
+            }
+            
+            if sqlite3_column_type(statement, 6) != SQLITE_NULL {
+                let metadataData = Data(bytes: sqlite3_column_blob(statement, 6), count: Int(sqlite3_column_bytes(statement, 6)))
+                if let metadata = try? JSONSerialization.jsonObject(with: metadataData, options: []) {
+                    result!["metadata"] = metadata
+                }
+            }
+        }
+        
+        sqlite3_finalize(statement)
+        return result
+    }
+    
+    @objc public func remove(key: String) -> Bool {
+        let deleteSQL = "DELETE FROM \(tableName) WHERE key = ?"
+        var statement: OpaquePointer?
+        
+        let result = sqlite3_prepare_v2(db, deleteSQL, -1, &statement, nil) == SQLITE_OK &&
+            sqlite3_bind_text(statement, 1, key, -1, nil) == SQLITE_OK &&
+            sqlite3_step(statement) == SQLITE_DONE
+        
+        sqlite3_finalize(statement)
+        return result
+    }
+    
+    @objc public func clear() -> Bool {
+        let deleteSQL = "DELETE FROM \(tableName)"
+        var statement: OpaquePointer?
+        
+        let result = sqlite3_prepare_v2(db, deleteSQL, -1, &statement, nil) == SQLITE_OK &&
+            sqlite3_step(statement) == SQLITE_DONE
+        
+        sqlite3_finalize(statement)
+        return result
+    }
+    
+    @objc public func keys() -> [String] {
+        let querySQL = "SELECT key FROM \(tableName)"
+        var statement: OpaquePointer?
+        var keys: [String] = []
+        
+        if sqlite3_prepare_v2(db, querySQL, -1, &statement, nil) == SQLITE_OK {
+            while sqlite3_step(statement) == SQLITE_ROW {
+                if let key = sqlite3_column_text(statement, 0) {
+                    keys.append(String(cString: key))
+                }
+            }
+        }
+        
+        sqlite3_finalize(statement)
+        return keys
+    }
+}

package/dist/ios/Plugin/StrataStoragePlugin.swift

@@ -0,0 +1,204 @@
+import Foundation
+import Capacitor
+
+/**
+ * Main Capacitor plugin for Strata Storage
+ * Coordinates between different storage types on iOS
+ */
+@objc(StrataStoragePlugin)
+public class StrataStoragePlugin: CAPPlugin {
+    private let userDefaultsStorage = UserDefaultsStorage()
+    private let keychainStorage = KeychainStorage()
+    private let sqliteStorage = SQLiteStorage()
+    
+    /**
+     * Check if storage is available
+     */
+    @objc func isAvailable(_ call: CAPPluginCall) {
+        call.resolve([
+            "available": true,
+            "platform": "ios",
+            "adapters": [
+                "preferences": true,
+                "secure": true,
+                "sqlite": true,
+                "filesystem": true
+            ]
+        ])
+    }
+    
+    /**
+     * Get value from storage
+     */
+    @objc func get(_ call: CAPPluginCall) {
+        guard let key = call.getString("key") else {
+            call.reject("Key is required")
+            return
+        }
+        
+        let storage = call.getString("storage") ?? "preferences"
+        
+        do {
+            let value: Any?
+            
+            switch storage {
+            case "secure":
+                value = try keychainStorage.get(key: key)
+            case "sqlite":
+                value = try sqliteStorage.get(key: key)
+            case "preferences":
+                fallthrough
+            default:
+                value = userDefaultsStorage.get(key: key)
+            }
+            
+            call.resolve([
+                "value": value ?? NSNull()
+            ])
+        } catch {
+            call.reject("Failed to get value", error.localizedDescription)
+        }
+    }
+    
+    /**
+     * Set value in storage
+     */
+    @objc func set(_ call: CAPPluginCall) {
+        guard let key = call.getString("key") else {
+            call.reject("Key is required")
+            return
+        }
+        
+        let value = call.getValue("value") ?? NSNull()
+        let storage = call.getString("storage") ?? "preferences"
+        
+        do {
+            switch storage {
+            case "secure":
+                try keychainStorage.set(key: key, value: value)
+            case "sqlite":
+                try sqliteStorage.set(key: key, value: value)
+            case "preferences":
+                fallthrough
+            default:
+                userDefaultsStorage.set(key: key, value: value)
+            }
+            
+            call.resolve()
+        } catch {
+            call.reject("Failed to set value", error.localizedDescription)
+        }
+    }
+    
+    /**
+     * Remove value from storage
+     */
+    @objc func remove(_ call: CAPPluginCall) {
+        guard let key = call.getString("key") else {
+            call.reject("Key is required")
+            return
+        }
+        
+        let storage = call.getString("storage") ?? "preferences"
+        
+        do {
+            switch storage {
+            case "secure":
+                try keychainStorage.remove(key: key)
+            case "sqlite":
+                try sqliteStorage.remove(key: key)
+            case "preferences":
+                fallthrough
+            default:
+                userDefaultsStorage.remove(key: key)
+            }
+            
+            call.resolve()
+        } catch {
+            call.reject("Failed to remove value", error.localizedDescription)
+        }
+    }
+    
+    /**
+     * Clear storage
+     */
+    @objc func clear(_ call: CAPPluginCall) {
+        let storage = call.getString("storage") ?? "preferences"
+        let prefix = call.getString("prefix")
+        
+        do {
+            switch storage {
+            case "secure":
+                try keychainStorage.clear(prefix: prefix)
+            case "sqlite":
+                try sqliteStorage.clear(prefix: prefix)
+            case "preferences":
+                fallthrough
+            default:
+                userDefaultsStorage.clear(prefix: prefix)
+            }
+            
+            call.resolve()
+        } catch {
+            call.reject("Failed to clear storage", error.localizedDescription)
+        }
+    }
+    
+    /**
+     * Get all keys from storage
+     */
+    @objc func keys(_ call: CAPPluginCall) {
+        let storage = call.getString("storage") ?? "preferences"
+        let pattern = call.getString("pattern")
+        
+        do {
+            let keys: [String]
+            
+            switch storage {
+            case "secure":
+                keys = try keychainStorage.keys(pattern: pattern)
+            case "sqlite":
+                keys = try sqliteStorage.keys(pattern: pattern)
+            case "preferences":
+                fallthrough
+            default:
+                keys = userDefaultsStorage.keys(pattern: pattern)
+            }
+            
+            call.resolve([
+                "keys": keys
+            ])
+        } catch {
+            call.reject("Failed to get keys", error.localizedDescription)
+        }
+    }
+    
+    /**
+     * Get storage size information
+     */
+    @objc func size(_ call: CAPPluginCall) {
+        let storage = call.getString("storage") ?? "preferences"
+        
+        do {
+            let sizeInfo: (total: Int, count: Int)
+            
+            switch storage {
+            case "secure":
+                sizeInfo = try keychainStorage.size()
+            case "sqlite":
+                sizeInfo = try sqliteStorage.size()
+            case "preferences":
+                fallthrough
+            default:
+                sizeInfo = userDefaultsStorage.size()
+            }
+            
+            call.resolve([
+                "total": sizeInfo.total,
+                "count": sizeInfo.count
+            ])
+        } catch {
+            call.reject("Failed to get size", error.localizedDescription)
+        }
+    }
+}