strata-storage 2.3.0 → 2.4.1

package/dist/firebase.js

@@ -1,3 +1,4 @@
+import { StorageError } from "./utils/errors.js";
 /**
  * Enable Firebase sync for Strata Storage
  * This dynamically imports Firebase SDK only when needed
@@ -19,8 +20,9 @@ export async function enableFirebaseSync(storage, config) {
             });
         }
         if (config.firestore) {
+            const { getFirestore, doc, setDoc, getDoc, deleteDoc, collection, getDocs, onSnapshot } = 
             // @ts-expect-error - Firebase is an optional peer dependency
-            const { getFirestore, doc, setDoc, getDoc, deleteDoc } = await import('firebase/firestore');
+            await import('firebase/firestore');
             const db = getFirestore();
             const collectionName = config.collectionName || 'strata-storage';
             // Create custom adapter for Firestore
@@ -56,12 +58,31 @@ export async function enableFirebaseSync(storage, config) {
                     return docSnap.exists();
                 },
                 async clear() {
-                    // Firestore doesn't have a direct clear method
-                    console.warn('Clear operation not supported for Firestore adapter');
+                    try {
+                        const collectionRef = collection(db, collectionName);
+                        const snapshot = await getDocs(collectionRef);
+                        const deletePromises = snapshot.docs.map((docSnapshot) => deleteDoc(doc(db, collectionName, docSnapshot.id)));
+                        await Promise.all(deletePromises);
+                    }
+                    catch (error) {
+                        throw new StorageError('Failed to clear Firestore collection', {
+                            collectionName,
+                            originalError: error,
+                        });
+                    }
                 },
                 async keys() {
-                    // Would need to implement with queries
-                    return [];
+                    try {
+                        const collectionRef = collection(db, collectionName);
+                        const snapshot = await getDocs(collectionRef);
+                        return snapshot.docs.map((docSnapshot) => docSnapshot.id);
+                    }
+                    catch (error) {
+                        throw new StorageError('Failed to retrieve keys from Firestore', {
+                            collectionName,
+                            originalError: error,
+                        });
+                    }
                 },
                 async size() {
                     return { total: 0, count: 0 };
@@ -72,9 +93,24 @@ export async function enableFirebaseSync(storage, config) {
                 async isAvailable() {
                     return true;
                 },
-                subscribe() {
-                    // Not implemented for Firebase adapter
-                    return () => { };
+                subscribe(callback) {
+                    const collectionRef = collection(db, collectionName);
+                    const unsubscribe = onSnapshot(collectionRef, (snapshot) => {
+                        snapshot
+                            .docChanges()
+                            .forEach((change) => {
+                            const docData = change.doc.data();
+                            callback({
+                                key: change.doc.id,
+                                oldValue: change.type === 'removed' ? docData.value : undefined,
+                                newValue: change.type !== 'removed' ? docData.value : undefined,
+                                source: 'remote',
+                                storage: 'firestore',
+                                timestamp: Date.now(),
+                            });
+                        });
+                    });
+                    return unsubscribe;
                 },
                 async close() {
                     // No cleanup needed
@@ -86,7 +122,7 @@ export async function enableFirebaseSync(storage, config) {
         }
         if (config.realtimeDatabase) {
             // @ts-expect-error - Firebase is an optional peer dependency
-            const { getDatabase, ref, set, get, remove } = await import('firebase/database');
+            const { getDatabase, ref, set, get, remove, onValue } = await import('firebase/database');
             const db = getDatabase();
             // Create custom adapter for Realtime Database
             const realtimeAdapter = {
@@ -134,9 +170,32 @@ export async function enableFirebaseSync(storage, config) {
                 async isAvailable() {
                     return true;
                 },
-                subscribe() {
-                    // Not implemented for Firebase adapter
-                    return () => { };
+                subscribe(callback) {
+                    const dbRef = ref(db, 'strata-storage');
+                    let previousData = {};
+                    const unsubscribe = onValue(dbRef, (snapshot) => {
+                        const snapshotTyped = snapshot;
+                        const currentData = snapshotTyped.exists()
+                            ? snapshotTyped.val()
+                            : {};
+                        const allKeys = new Set([...Object.keys(previousData), ...Object.keys(currentData)]);
+                        allKeys.forEach((key) => {
+                            const oldValue = previousData[key];
+                            const newValue = currentData[key];
+                            if (oldValue !== newValue) {
+                                callback({
+                                    key,
+                                    oldValue,
+                                    newValue,
+                                    source: 'remote',
+                                    storage: 'realtime',
+                                    timestamp: Date.now(),
+                                });
+                            }
+                        });
+                        previousData = { ...currentData };
+                    });
+                    return unsubscribe;
                 },
                 async close() {
                     // No cleanup needed
@@ -149,7 +208,10 @@ export async function enableFirebaseSync(storage, config) {
         // Firebase sync enabled successfully
     }
     catch (error) {
-        throw new Error(`Failed to enable Firebase sync: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        throw new StorageError('Failed to enable Firebase sync', {
+            originalError: error,
+            config,
+        });
     }
 }
 /**

package/dist/ios/Plugin/SQLiteStorage.swift

@@ -1,29 +1,47 @@
 import Foundation
 import SQLite3
+import os.log
 
 @objc public class SQLiteStorage: NSObject {
     private var db: OpaquePointer?
     private let dbName: String
     private let tableName = "strata_storage"
+    private let logger = OSLog(subsystem: "com.strata.storage", category: "SQLiteStorage")
     
     @objc public init(dbName: String = "strata.db") {
         self.dbName = dbName
         super.init()
-        openDatabase()
-        createTable()
+        do {
+            try openDatabase()
+            try createTable()
+        } catch {
+            os_log("Failed to initialize SQLite storage: %{public}@", log: logger, type: .error, error.localizedDescription)
+        }
     }
     
     deinit {
         closeDatabase()
     }
     
-    private func openDatabase() {
-        let fileURL = try! FileManager.default
+    private func openDatabase() throws {
+        guard 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")
+            .appendingPathComponent(dbName) else {
+            throw NSError(
+                domain: "StrataStorage.SQLiteStorage",
+                code: 1001,
+                userInfo: [NSLocalizedDescriptionKey: "Unable to access document directory"]
+            )
+        }
+
+        guard sqlite3_open(fileURL.path, &db) == SQLITE_OK else {
+            let errorMessage = String(cString: sqlite3_errmsg(db))
+            sqlite3_close(db)
+            throw NSError(
+                domain: "StrataStorage.SQLiteStorage",
+                code: 1002,
+                userInfo: [NSLocalizedDescriptionKey: "Unable to open database: \(errorMessage)"]
+            )
         }
     }
     
@@ -31,7 +49,7 @@ import SQLite3
         sqlite3_close(db)
     }
     
-    private func createTable() {
+    private func createTable() throws {
         let createTableString = """
             CREATE TABLE IF NOT EXISTS \(tableName) (
                 key TEXT PRIMARY KEY NOT NULL,
@@ -43,19 +61,43 @@ import SQLite3
                 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.")
-            }
+
+        guard sqlite3_prepare_v2(db, createTableString, -1, &createTableStatement, nil) == SQLITE_OK else {
+            let errorMessage = String(cString: sqlite3_errmsg(db))
+            throw NSError(
+                domain: "StrataStorage.SQLiteStorage",
+                code: 1003,
+                userInfo: [NSLocalizedDescriptionKey: "Failed to prepare CREATE TABLE: \(errorMessage)"]
+            )
+        }
+
+        defer {
+            sqlite3_finalize(createTableStatement)
+        }
+
+        guard sqlite3_step(createTableStatement) == SQLITE_DONE else {
+            let errorMessage = String(cString: sqlite3_errmsg(db))
+            throw NSError(
+                domain: "StrataStorage.SQLiteStorage",
+                code: 1004,
+                userInfo: [NSLocalizedDescriptionKey: "Failed to create table: \(errorMessage)"]
+            )
         }
-        sqlite3_finalize(createTableStatement)
     }
     
     @objc public func set(key: String, value: Any, expires: Int64? = nil, tags: [String]? = nil, metadata: [String: Any]? = nil) throws -> Bool {
+        guard let db = db else {
+            throw NSError(
+                domain: "StrataStorage.SQLiteStorage",
+                code: 1000,
+                userInfo: [NSLocalizedDescriptionKey: "Database not initialized"]
+            )
+        }
+
         let data: Data
-        
+
         if let dataValue = value as? Data {
             data = dataValue
         } else if let stringValue = value as? String {
@@ -96,9 +138,14 @@ import SQLite3
     }
     
     @objc public func get(key: String) -> [String: Any]? {
+        guard db != nil else {
+            os_log("Database not initialized", log: logger, type: .error)
+            return nil
+        }
+
         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)
@@ -142,82 +189,105 @@ import SQLite3
     }
     
     @objc public func remove(key: String) -> Bool {
+        guard db != nil else {
+            os_log("Database not initialized", log: logger, type: .error)
+            return false
+        }
+
         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(prefix: String? = nil) -> Bool {
+        guard db != nil else {
+            os_log("Database not initialized", log: logger, type: .error)
+            return false
+        }
+
         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
-        
+
         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(pattern: String? = nil) -> [String] {
+        guard db != nil else {
+            os_log("Database not initialized", log: logger, type: .error)
+            return []
+        }
+
         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))
                 }
             }
         }
-        
+
         sqlite3_finalize(statement)
         return keys
     }
     
     @objc public func size() throws -> (total: Int, count: Int) {
+        guard db != nil else {
+            throw NSError(
+                domain: "StrataStorage.SQLiteStorage",
+                code: 1000,
+                userInfo: [NSLocalizedDescriptionKey: "Database not initialized"]
+            )
+        }
+
         let querySQL = "SELECT COUNT(*), SUM(LENGTH(value)) FROM \(tableName)"
         var statement: OpaquePointer?
-        
+
         var totalSize = 0
         var count = 0
-        
+
         if sqlite3_prepare_v2(db, querySQL, -1, &statement, nil) == SQLITE_OK {
             if sqlite3_step(statement) == SQLITE_ROW {
                 count = Int(sqlite3_column_int(statement, 0))
                 totalSize = Int(sqlite3_column_int64(statement, 1))
             }
         }
-        
+
         sqlite3_finalize(statement)
         return (total: totalSize, count: count)
     }

package/dist/ios/Plugin/UserDefaultsStorage.swift

@@ -6,7 +6,11 @@ import Foundation
     
     @objc public init(suiteName: String? = nil) {
         self.suiteName = suiteName
-        self.userDefaults = suiteName != nil ? UserDefaults(suiteName: suiteName)! : UserDefaults.standard
+        if let suiteName = suiteName, let customDefaults = UserDefaults(suiteName: suiteName) {
+            self.userDefaults = customDefaults
+        } else {
+            self.userDefaults = UserDefaults.standard
+        }
         super.init()
     }
     
@@ -36,7 +40,14 @@ import Foundation
             if let suiteName = suiteName {
                 UserDefaults(suiteName: suiteName)?.removePersistentDomain(forName: suiteName)
             } else {
-                let domain = Bundle.main.bundleIdentifier!
+                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)
             }
         }

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strata-storage",
-  "version": "2.3.0",
+  "version": "2.4.1",
   "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": ">=20.3.0",
-    "@capacitor/core": ">=7.4.0",
-    "react": ">=19.1.0",
-    "vue": ">=3.6.0"
+    "@angular/core": ">=21.0.6",
+    "@capacitor/core": ">=8.0.0",
+    "react": ">=19.2.3",
+    "vue": ">=3.5.26"
   },
   "peerDependenciesMeta": {
     "@capacitor/core": {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,mBAAmB,EASpB,MAAM,eAAe,CAAC;AA+GvB,eAAO,MAAM,aAAa,EAAE,mBAAmD,CAAC;AAEhF,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,mBAAmB,EASpB,MAAM,eAAe,CAAC;AA8IvB,eAAO,MAAM,aAAa,EAAE,mBAAmD,CAAC;AAEhF,cAAc,eAAe,CAAC"}

package/dist/plugin/index.js

@@ -3,15 +3,40 @@
  * Main plugin registration and web implementation
  * This is now optional and only loaded when Capacitor adapters are used
  */
+import { NotSupportedError } from "../utils/errors.js";
 // Mock implementation for when Capacitor is not available
 const mockPlugin = {
     isAvailable: async () => ({ available: false }),
-    get: async () => ({ value: null }),
-    set: async () => { },
-    remove: async () => { },
-    clear: async () => { },
-    keys: async () => ({ keys: [] }),
-    size: async () => ({ total: 0, count: 0 }),
+    get: async () => {
+        throw new NotSupportedError('Native storage', 'web platform without Capacitor', {
+            suggestion: 'Use web adapters: localStorage, sessionStorage, indexedDB, cookies, or cache instead',
+        });
+    },
+    set: async () => {
+        throw new NotSupportedError('Native storage', 'web platform without Capacitor', {
+            suggestion: 'Use web adapters: localStorage, sessionStorage, indexedDB, cookies, or cache instead',
+        });
+    },
+    remove: async () => {
+        throw new NotSupportedError('Native storage', 'web platform without Capacitor', {
+            suggestion: 'Use web adapters: localStorage, sessionStorage, indexedDB, cookies, or cache instead',
+        });
+    },
+    clear: async () => {
+        throw new NotSupportedError('Native storage', 'web platform without Capacitor', {
+            suggestion: 'Use web adapters: localStorage, sessionStorage, indexedDB, cookies, or cache instead',
+        });
+    },
+    keys: async () => {
+        throw new NotSupportedError('Native storage', 'web platform without Capacitor', {
+            suggestion: 'Use web adapters: localStorage, sessionStorage, indexedDB, cookies, or cache instead',
+        });
+    },
+    size: async () => {
+        throw new NotSupportedError('Native storage', 'web platform without Capacitor', {
+            suggestion: 'Use web adapters: localStorage, sessionStorage, indexedDB, cookies, or cache instead',
+        });
+    },
 };
 // Create a lazy-loading wrapper that only attempts to load Capacitor when actually used
 class LazyStrataStoragePlugin {

package/dist/plugin/web.d.ts

@@ -5,7 +5,11 @@
 import type { StrataStoragePlugin, NativeStorageType, NativeGetOptions, NativeSetOptions, NativeRemoveOptions, NativeClearOptions, NativeKeysOptions, NativeSizeOptions, NativeSizeResult } from './definitions';
 import type { StorageValue } from '@/types';
 export declare class StrataStorageWeb implements StrataStoragePlugin {
-    isAvailable(_options: {
+    private adapters;
+    private initialized;
+    private initializeAdapters;
+    private getAdapter;
+    isAvailable(options: {
         storage: NativeStorageType;
     }): Promise<{
         available: boolean;

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;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"}
+{"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,EAAkB,MAAM,SAAS,CAAC;AAM5D,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,OAAO,CAAC,QAAQ,CAAqD;IACrE,OAAO,CAAC,WAAW,CAAS;YAEd,kBAAkB;IAahC,OAAO,CAAC,UAAU;IAUZ,WAAW,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,iBAAiB,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAUrF,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;IAM7C,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnD,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD,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

@@ -2,51 +2,74 @@
  * Strata Storage Web Implementation
  * Web platform implementation of the Capacitor plugin
  */
+import { LocalStorageAdapter } from "../adapters/web/LocalStorageAdapter.js";
+import { IndexedDBAdapter } from "../adapters/web/IndexedDBAdapter.js";
+import { CacheAdapter } from "../adapters/web/CacheAdapter.js";
+import { NotSupportedError } from "../utils/errors.js";
 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,
-            platform: 'web',
-            message: 'Native storage not available on web. Use web adapters: localStorage, sessionStorage, indexedDB, cookies, or cache instead.',
-        };
+    adapters = new Map();
+    initialized = false;
+    async initializeAdapters() {
+        if (this.initialized)
+            return;
+        this.adapters.set('preferences', new LocalStorageAdapter('strata_prefs_'));
+        this.adapters.set('secure', new IndexedDBAdapter('strata-secure'));
+        this.adapters.set('sqlite', new IndexedDBAdapter('strata-db'));
+        this.adapters.set('filesystem', new CacheAdapter('strata-files'));
+        await Promise.all(Array.from(this.adapters.values()).map((adapter) => adapter.initialize()));
+        this.initialized = true;
+    }
+    getAdapter(storageType) {
+        const adapter = this.adapters.get(storageType);
+        if (!adapter) {
+            throw new NotSupportedError(`Storage type '${storageType}'`, 'web plugin', {
+                availableTypes: Array.from(this.adapters.keys()),
+                suggestion: this.getSuggestion(storageType),
+            });
+        }
+        return adapter;
+    }
+    async isAvailable(options) {
+        await this.initializeAdapters();
+        const adapter = this.adapters.get(options.storage);
+        if (!adapter) {
+            return { available: false };
+        }
+        const available = await adapter.isAvailable();
+        return { available };
     }
     async get(options) {
-        // Not implemented for web - use web adapters instead
-        const storageType = options.storage || 'preferences';
-        const suggestion = this.getSuggestion(storageType);
-        throw new Error(`Native storage '${storageType}' not available on web platform. ${suggestion}`);
+        await this.initializeAdapters();
+        const adapter = this.getAdapter(options.storage || 'preferences');
+        const value = await adapter.get(options.key);
+        return { value };
     }
     async set(options) {
-        // Not implemented for web - use web adapters instead
-        const storageType = options.storage || 'preferences';
-        const suggestion = this.getSuggestion(storageType);
-        throw new Error(`Native storage '${storageType}' not available on web platform. ${suggestion}`);
+        await this.initializeAdapters();
+        const adapter = this.getAdapter(options.storage || 'preferences');
+        await adapter.set(options.key, options.value);
     }
     async remove(options) {
-        // Not implemented for web - use web adapters instead
-        const storageType = options.storage || 'preferences';
-        const suggestion = this.getSuggestion(storageType);
-        throw new Error(`Native storage '${storageType}' not available on web platform. ${suggestion}`);
+        await this.initializeAdapters();
+        const adapter = this.getAdapter(options.storage || 'preferences');
+        await adapter.remove(options.key);
     }
     async clear(options) {
-        // Not implemented for web - use web adapters instead
-        const storageType = options.storage || 'preferences';
-        const suggestion = this.getSuggestion(storageType);
-        throw new Error(`Native storage '${storageType}' not available on web platform. ${suggestion}`);
+        await this.initializeAdapters();
+        const adapter = this.getAdapter(options.storage || 'preferences');
+        await adapter.clear();
     }
     async keys(options) {
-        // Not implemented for web - use web adapters instead
-        const storageType = options.storage || 'preferences';
-        const suggestion = this.getSuggestion(storageType);
-        throw new Error(`Native storage '${storageType}' not available on web platform. ${suggestion}`);
+        await this.initializeAdapters();
+        const adapter = this.getAdapter(options.storage || 'preferences');
+        const keys = await adapter.keys();
+        return { keys };
     }
     async size(options) {
-        // Not implemented for web - use web adapters instead
-        const storageType = options.storage || 'preferences';
-        const suggestion = this.getSuggestion(storageType);
-        throw new Error(`Native storage '${storageType}' not available on web platform. ${suggestion}`);
+        await this.initializeAdapters();
+        const adapter = this.getAdapter(options.storage || 'preferences');
+        const sizeInfo = await adapter.size();
+        return { total: sizeInfo.total, count: sizeInfo.count };
     }
     /**
      * Get suggestion for web alternative based on native storage type

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

@@ -2,6 +2,7 @@
  * Utility functions for Strata Storage
  * Zero dependencies - all utilities implemented from scratch
  */
+import { ValidationError } from "./errors.js";
 /**
  * Check if code is running in a browser environment
  */
@@ -122,8 +123,12 @@ export function parseSize(size) {
         tb: 1024 * 1024 * 1024 * 1024,
     };
     const match = size.toLowerCase().match(/^(\d+(?:\.\d+)?)\s*([a-z]+)?$/);
-    if (!match)
-        throw new Error(`Invalid size format: ${size}`);
+    if (!match) {
+        throw new ValidationError('Invalid size format', {
+            provided: size,
+            expected: 'Number with unit (e.g., 5MB, 1GB)',
+        });
+    }
     const [, num, unit = 'b'] = match;
     const multiplier = units[unit] || 1;
     return parseFloat(num) * multiplier;