strata-storage 2.6.1 → 2.7.0

package/dist/ios/Plugin/StrataStoragePlugin.swift

@@ -1,411 +0,0 @@
-import Foundation
-import Capacitor
-
-/**
- * Main Capacitor plugin for Strata Storage
- * Coordinates between different storage types on iOS.
- *
- * NOTE: Method registration with the Capacitor bridge lives in
- * StrataStoragePlugin.m (CAP_PLUGIN / CAP_PLUGIN_METHOD). Keep the two in
- * sync when adding or renaming methods.
- */
-@objc(StrataStoragePlugin)
-public class StrataStoragePlugin: CAPPlugin {
-    private let userDefaultsStorage = UserDefaultsStorage()
-    private let keychainStorage = KeychainStorage()
-    private let filesystemStorage = FilesystemStorage()
-
-    /// Storage types that have a real native backend on iOS.
-    private let supportedStorageTypes: Set<String> = ["preferences", "secure", "sqlite", "filesystem"]
-
-    // MARK: - SQLite multi-store helpers
-
-    /// Default database name (→ file `strata_storage.db`) and table.
-    private static let defaultDatabase = "strata_storage"
-    private static let defaultTable = "storage"
-
-    /// Sanitizes a database name into a safe `.db` filename. Strips everything
-    /// outside `[A-Za-z0-9_]` (which also blocks path separators / traversal),
-    /// then appends `.db`. Empty input falls back to the default. The filename
-    /// CANNOT be a bound parameter, so it must be sanitized before use.
-    private func sqliteFileName(from database: String?) -> String {
-        let raw = database ?? StrataStoragePlugin.defaultDatabase
-        let cleaned = String(raw.unicodeScalars.filter { CharacterSet(charactersIn: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_").contains($0) })
-        let safe = cleaned.isEmpty ? StrataStoragePlugin.defaultDatabase : cleaned
-        return "\(safe).db"
-    }
-
-    /// Sanitizes a table name to a safe SQL identifier matching `^[A-Za-z0-9_]+$`.
-    /// Disallowed characters are removed; empty input falls back to the default.
-    /// The table name is interpolated into SQL (it cannot be bound), so this is
-    /// the single point that guarantees injection-safety for the identifier.
-    private func sqliteTableName(from table: String?) -> String {
-        let raw = table ?? StrataStoragePlugin.defaultTable
-        let cleaned = String(raw.unicodeScalars.filter { CharacterSet(charactersIn: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_").contains($0) })
-        return cleaned.isEmpty ? StrataStoragePlugin.defaultTable : cleaned
-    }
-
-    /// Returns the cached SQLite store for the call's `database` option.
-    private func sqliteStore(for call: CAPPluginCall) -> SQLiteStorage {
-        return SQLiteStorageManager.shared.store(forFile: sqliteFileName(from: call.getString("database")))
-    }
-
-    /**
-     * Check if a specific storage type is available.
-     * Matches the JS contract: resolves `{ available: boolean }`.
-     */
-    @objc func isAvailable(_ call: CAPPluginCall) {
-        let storage = call.getString("storage") ?? "preferences"
-        call.resolve([
-            "available": supportedStorageTypes.contains(storage)
-        ])
-    }
-
-    /**
-     * Get value from storage.
-     * For sqlite/filesystem the resolved `value` is the full StorageValue
-     * wrapper object (or NSNull on a miss).
-     */
-    @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 = sqliteStore(for: call).get(table: sqliteTableName(from: call.getString("table")), key: key)
-            case "filesystem":
-                value = filesystemStorage.get(key: key)
-            case "preferences":
-                fallthrough
-            default:
-                value = userDefaultsStorage.get(key: key)
-            }
-
-            call.resolve([
-                "value": value ?? NSNull()
-            ])
-        } catch {
-            call.reject("Failed to get value", nil, error)
-        }
-    }
-
-    /**
-     * Set value in storage.
-     * For sqlite/filesystem the `value` option is the full StorageValue
-     * wrapper object and is stored verbatim (JSON) for a perfect round-trip.
-     */
-    @objc func set(_ 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":
-                let value = call.getValue("value") ?? NSNull()
-                _ = try keychainStorage.set(key: key, value: value)
-            case "sqlite":
-                // getObject returns JSObject ([String: JSValue]); upcast each
-                // value to Any (the canonical Capacitor pattern) so the bridged
-                // Foundation values are JSONSerialization-compatible.
-                guard let jsObject = call.getObject("value") else {
-                    call.reject("SQLite value must be a StorageValue object")
-                    return
-                }
-                let ok = try sqliteStore(for: call).set(
-                    table: sqliteTableName(from: call.getString("table")),
-                    key: key,
-                    wrapper: jsObject as [String: Any]
-                )
-                if !ok {
-                    call.reject("Failed to write value to SQLite")
-                    return
-                }
-            case "filesystem":
-                guard let jsObject = call.getObject("value") else {
-                    call.reject("Filesystem value must be a StorageValue object")
-                    return
-                }
-                let ok = try filesystemStorage.set(key: key, wrapper: jsObject as [String: Any])
-                if !ok {
-                    call.reject("Failed to write value to filesystem")
-                    return
-                }
-            case "preferences":
-                fallthrough
-            default:
-                let value = call.getValue("value") ?? NSNull()
-                userDefaultsStorage.set(key: key, value: value)
-            }
-
-            call.resolve()
-        } catch {
-            call.reject("Failed to set value", nil, error)
-        }
-    }
-
-    /**
-     * 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":
-                _ = sqliteStore(for: call).remove(table: sqliteTableName(from: call.getString("table")), key: key)
-            case "filesystem":
-                _ = filesystemStorage.remove(key: key)
-            case "preferences":
-                fallthrough
-            default:
-                userDefaultsStorage.remove(key: key)
-            }
-
-            call.resolve()
-        } catch {
-            call.reject("Failed to remove value", nil, error)
-        }
-    }
-
-    /**
-     * Clear storage.
-     * The JS contract sends an optional `pattern`. The native backends accept
-     * a prefix; we use `pattern` as that prefix (prefix/contains matching).
-     */
-    @objc func clear(_ call: CAPPluginCall) {
-        let storage = call.getString("storage") ?? "preferences"
-        // Accept both `pattern` (JS contract) and legacy `prefix`.
-        let prefix = call.getString("pattern") ?? call.getString("prefix")
-
-        do {
-            switch storage {
-            case "secure":
-                _ = try keychainStorage.clear(prefix: prefix)
-            case "sqlite":
-                _ = sqliteStore(for: call).clear(table: sqliteTableName(from: call.getString("table")), prefix: prefix)
-            case "filesystem":
-                _ = filesystemStorage.clear(prefix: prefix)
-            case "preferences":
-                fallthrough
-            default:
-                userDefaultsStorage.clear(prefix: prefix)
-            }
-
-            call.resolve()
-        } catch {
-            call.reject("Failed to clear storage", nil, error)
-        }
-    }
-
-    /**
-     * 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 = sqliteStore(for: call).keys(table: sqliteTableName(from: call.getString("table")), pattern: pattern)
-            case "filesystem":
-                keys = filesystemStorage.keys(pattern: pattern)
-            case "preferences":
-                fallthrough
-            default:
-                keys = userDefaultsStorage.keys(pattern: pattern)
-            }
-
-            call.resolve([
-                "keys": keys
-            ])
-        } catch {
-            call.reject("Failed to get keys", nil, error)
-        }
-    }
-
-    /**
-     * Get storage size information.
-     * When `detailed` is true, resolves `{ total, count, detailed: { keys,
-     * values, metadata } }`; otherwise `{ total, count }`.
-     */
-    @objc func size(_ call: CAPPluginCall) {
-        let storage = call.getString("storage") ?? "preferences"
-        let detailed = call.getBool("detailed") ?? false
-
-        do {
-            // segments carries total/count/keys/values/metadata in bytes.
-            let segments: [String: Int]
-
-            switch storage {
-            case "secure":
-                let info = try keychainStorage.size()
-                segments = ["total": info.total, "count": info.count, "keys": 0, "values": info.total, "metadata": 0]
-            case "sqlite":
-                segments = try sqliteStore(for: call).size(table: sqliteTableName(from: call.getString("table")))
-            case "filesystem":
-                segments = filesystemStorage.size()
-            case "preferences":
-                fallthrough
-            default:
-                let info = userDefaultsStorage.size()
-                segments = ["total": info.total, "count": info.count, "keys": 0, "values": info.total, "metadata": 0]
-            }
-
-            var result: [String: Any] = [
-                "total": segments["total"] ?? 0,
-                "count": segments["count"] ?? 0
-            ]
-            if detailed {
-                result["detailed"] = [
-                    "keys": segments["keys"] ?? 0,
-                    "values": segments["values"] ?? 0,
-                    "metadata": segments["metadata"] ?? 0
-                ]
-            }
-            call.resolve(result)
-        } catch {
-            call.reject("Failed to get size", nil, error)
-        }
-    }
-
-    /**
-     * Query SQLite-backed storage.
-     * Matches the optional `query` method in the JS contract:
-     * resolves `{ results: [{ key }] }` (JS re-fetches each value via get).
-     */
-    @objc func query(_ call: CAPPluginCall) {
-        let storage = call.getString("storage") ?? "sqlite"
-
-        guard storage == "sqlite" else {
-            call.reject("Query is only supported for the 'sqlite' storage type")
-            return
-        }
-
-        let condition = call.getObject("condition") ?? [:]
-        let results = sqliteStore(for: call).query(
-            table: sqliteTableName(from: call.getString("table")),
-            condition: condition
-        )
-        call.resolve([
-            "results": results
-        ])
-    }
-
-    /**
-     * iOS-specific: read a UserDefaults value.
-     * Resolves `{ value: unknown }`.
-     */
-    @objc func getUserDefaults(_ call: CAPPluginCall) {
-        guard let key = call.getString("key") else {
-            call.reject("Key is required")
-            return
-        }
-        let suiteName = call.getString("suiteName")
-        let store = suiteName != nil ? UserDefaultsStorage(suiteName: suiteName) : userDefaultsStorage
-        call.resolve([
-            "value": store.get(key: key) ?? NSNull()
-        ])
-    }
-
-    /**
-     * iOS-specific: write a UserDefaults value.
-     */
-    @objc func setUserDefaults(_ call: CAPPluginCall) {
-        guard let key = call.getString("key") else {
-            call.reject("Key is required")
-            return
-        }
-        let value = call.getValue("value") ?? NSNull()
-        let suiteName = call.getString("suiteName")
-        let store = suiteName != nil ? UserDefaultsStorage(suiteName: suiteName) : userDefaultsStorage
-        _ = store.set(key: key, value: value)
-        call.resolve()
-    }
-
-    /**
-     * iOS-specific: read a Keychain value. Resolves `{ value: string | null }`.
-     */
-    @objc func getKeychain(_ call: CAPPluginCall) {
-        guard let key = call.getString("key") else {
-            call.reject("Key is required")
-            return
-        }
-        let service = call.getString("service")
-        let accessGroup = call.getString("accessGroup")
-        let store = (service != nil || accessGroup != nil)
-            ? KeychainStorage(service: service, accessGroup: accessGroup)
-            : keychainStorage
-
-        do {
-            let value = try store.get(key: key)
-            // The JS contract types this as `string | null`. Serialize
-            // non-string values to a JSON string so the bridge stays typed.
-            if let value = value {
-                if let str = value as? String {
-                    call.resolve(["value": str])
-                } else if let data = try? JSONSerialization.data(withJSONObject: value, options: []),
-                          let str = String(data: data, encoding: .utf8) {
-                    call.resolve(["value": str])
-                } else {
-                    call.resolve(["value": NSNull()])
-                }
-            } else {
-                call.resolve(["value": NSNull()])
-            }
-        } catch {
-            call.reject("Failed to read keychain item", nil, error)
-        }
-    }
-
-    /**
-     * iOS-specific: write a Keychain value, honoring the `accessible` option.
-     */
-    @objc func setKeychain(_ call: CAPPluginCall) {
-        guard let key = call.getString("key") else {
-            call.reject("Key is required")
-            return
-        }
-        guard let value = call.getString("value") else {
-            call.reject("Value is required and must be a string")
-            return
-        }
-        let service = call.getString("service")
-        let accessGroup = call.getString("accessGroup")
-        let accessible = call.getString("accessible")
-        let store = (service != nil || accessGroup != nil)
-            ? KeychainStorage(service: service, accessGroup: accessGroup)
-            : keychainStorage
-
-        do {
-            _ = try store.set(key: key, value: value, accessible: accessible)
-            call.resolve()
-        } catch {
-            call.reject("Failed to write keychain item", nil, error)
-        }
-    }
-}

package/dist/ios/Plugin/UserDefaultsStorage.swift

@@ -1,87 +0,0 @@
-import Foundation
-
-@objc public class UserDefaultsStorage: NSObject {
-    private let suiteName: String?
-    private var userDefaults: UserDefaults
-    
-    @objc public init(suiteName: String? = nil) {
-        self.suiteName = suiteName
-        if let suiteName = suiteName, let customDefaults = UserDefaults(suiteName: suiteName) {
-            self.userDefaults = customDefaults
-        } else {
-            self.userDefaults = UserDefaults.standard
-        }
-        super.init()
-    }
-    
-    @objc public func set(key: String, value: Any) -> Bool {
-        userDefaults.set(value, forKey: key)
-        return userDefaults.synchronize()
-    }
-    
-    @objc public func get(key: String) -> Any? {
-        return userDefaults.object(forKey: key)
-    }
-    
-    @objc public func remove(key: String) -> Bool {
-        userDefaults.removeObject(forKey: key)
-        return userDefaults.synchronize()
-    }
-    
-    @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 {
-            // Clear all keys
-            if let suiteName = suiteName {
-                UserDefaults(suiteName: suiteName)?.removePersistentDomain(forName: suiteName)
-            } else {
-                guard let domain = Bundle.main.bundleIdentifier else {
-                    // Fallback: manually clear all keys
-                    let keys = Array(userDefaults.dictionaryRepresentation().keys)
-                    for key in keys {
-                        userDefaults.removeObject(forKey: key)
-                    }
-                    return userDefaults.synchronize()
-                }
-                userDefaults.removePersistentDomain(forName: domain)
-            }
-        }
-        return userDefaults.synchronize()
-    }
-    
-    @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 {
-        return userDefaults.object(forKey: key) != nil
-    }
-    
-    @objc public func size() -> (total: Int, count: Int) {
-        let all = userDefaults.dictionaryRepresentation()
-        var totalSize = 0
-        let count = all.count
-        
-        for (key, value) in all {
-            // Estimate size (key + value in bytes)
-            totalSize += key.data(using: .utf8)?.count ?? 0
-            totalSize += "\(value)".data(using: .utf8)?.count ?? 0
-        }
-        
-        return (total: totalSize, count: count)
-    }
-}