strata-storage 1.5.0 → 2.0.0

package/Readme.md

@@ -23,21 +23,56 @@ Zero-dependency universal storage plugin providing a unified API for all storage
 npm install strata-storage
 ```
 
+### Provider-less Usage (Zero Setup)
 ```typescript
-import { Strata } from 'strata-storage';
+import { storage } from 'strata-storage';
 
-const storage = new Strata();
-await storage.initialize();
-
-// Works everywhere - web, iOS, Android
+// Works immediately - no setup, no providers, no initialization!
 await storage.set('user', { name: 'John', age: 30 });
 const user = await storage.get('user');
 ```
 
+### 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 external packages, pure implementation
+- ✅ **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
@@ -67,22 +102,23 @@ const user = await storage.get('user');
 ## 📖 Basic Usage
 
 ```typescript
-// Initialize with configuration
-const storage = new Strata({
-  defaultStorages: ['indexedDB', 'localStorage', 'memory'],
-  encryption: { enabled: true },
-  compression: { enabled: true },
-  ttl: { defaultTTL: 3600000 } // 1 hour
-});
+import { storage } from 'strata-storage';
+
+// No initialization needed - works immediately!
 
-await storage.initialize();
+// Simple usage
+await storage.set('key', 'value');
+const value = await storage.get('key');
+await storage.remove('key');
+await storage.clear();
 
-// Store with options
+// Advanced options
 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
+  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
@@ -97,13 +133,23 @@ storage.subscribe((change) => {
 });
 ```
 
+## 🎯 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
+- ✅ Capacitor plugin structure (now optional)
 - ✅ Advanced features (encryption, compression, sync, query, TTL)
+- ✅ Provider-less architecture
 - 🚧 Native implementations (iOS/Android)
 - 🚧 Testing and documentation
 

package/dist/README.md

@@ -0,0 +1,162 @@
+# 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');
+```
+
+### 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

package/dist/adapters/capacitor/FilesystemAdapter.js

@@ -2,10 +2,10 @@
  * Filesystem Adapter - Native file system storage
  * Direct file access on iOS and Android
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import { StrataStorage } from '@/plugin';
-import { StorageError } from '@/utils/errors';
-import { isCapacitor } from '@/utils';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import { StrataStorage } from "../../plugin/index.js";
+import { StorageError } from "../../utils/errors.js";
+import { isCapacitor } from "../../utils/index.js";
 /**
  * Native filesystem adapter using Capacitor plugin
  */

package/dist/adapters/capacitor/PreferencesAdapter.js

@@ -2,10 +2,10 @@
  * Preferences Adapter - Native preferences storage
  * iOS: UserDefaults, Android: SharedPreferences
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import { StrataStorage } from '@/plugin';
-import { StorageError } from '@/utils/errors';
-import { isCapacitor } from '@/utils';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import { StrataStorage } from "../../plugin/index.js";
+import { StorageError } from "../../utils/errors.js";
+import { isCapacitor } from "../../utils/index.js";
 /**
  * Native preferences adapter using Capacitor plugin
  */

package/dist/adapters/capacitor/SecureAdapter.js

@@ -2,10 +2,10 @@
  * Secure Adapter - Native secure storage
  * iOS: Keychain, Android: EncryptedSharedPreferences
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import { StrataStorage } from '@/plugin';
-import { StorageError } from '@/utils/errors';
-import { isCapacitor } from '@/utils';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import { StrataStorage } from "../../plugin/index.js";
+import { StorageError } from "../../utils/errors.js";
+import { isCapacitor } from "../../utils/index.js";
 /**
  * Native secure storage adapter using Capacitor plugin
  */

package/dist/adapters/capacitor/SqliteAdapter.js

@@ -2,10 +2,10 @@
  * SQLite Adapter - Native SQLite database storage
  * Available on iOS and Android
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import { StrataStorage } from '@/plugin';
-import { StorageError, TransactionError } from '@/utils/errors';
-import { isCapacitor } from '@/utils';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import { StrataStorage } from "../../plugin/index.js";
+import { StorageError, TransactionError } from "../../utils/errors.js";
+import { isCapacitor } from "../../utils/index.js";
 /**
  * Native SQLite adapter using Capacitor plugin
  */

package/dist/adapters/capacitor/index.js

@@ -2,7 +2,7 @@
  * Capacitor Native Storage Adapters
  * Export all native platform storage implementations
  */
-export { PreferencesAdapter } from './PreferencesAdapter';
-export { SqliteAdapter } from './SqliteAdapter';
-export { SecureAdapter } from './SecureAdapter';
-export { FilesystemAdapter } from './FilesystemAdapter';
+export { PreferencesAdapter } from "./PreferencesAdapter.js";
+export { SqliteAdapter } from "./SqliteAdapter.js";
+export { SecureAdapter } from "./SecureAdapter.js";
+export { FilesystemAdapter } from "./FilesystemAdapter.js";

package/dist/adapters/web/CacheAdapter.js

@@ -2,9 +2,9 @@
  * Cache Adapter - Service Worker Cache API implementation
  * Provides network-aware storage for offline support
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import { getObjectSize } from '@/utils';
-import { StorageError, QuotaExceededError, NotSupportedError } from '@/utils/errors';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import { getObjectSize } from "../../utils/index.js";
+import { StorageError, QuotaExceededError, NotSupportedError } from "../../utils/errors.js";
 /**
  * Cache API adapter for Service Worker environments
  */

package/dist/adapters/web/CookieAdapter.js

@@ -2,8 +2,8 @@
  * Cookie Adapter - Browser cookie implementation
  * Provides limited storage with 4KB per cookie limit
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import { StorageError, QuotaExceededError } from '@/utils/errors';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import { StorageError, QuotaExceededError } from "../../utils/errors.js";
 /**
  * Browser cookie adapter
  */

package/dist/adapters/web/IndexedDBAdapter.js

@@ -2,9 +2,9 @@
  * IndexedDB Adapter - Browser IndexedDB implementation
  * Provides large-scale persistent storage with advanced features
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import { createDeferred, getObjectSize } from '@/utils';
-import { StorageError, QuotaExceededError, TransactionError } from '@/utils/errors';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import { createDeferred, getObjectSize } from "../../utils/index.js";
+import { StorageError, QuotaExceededError, TransactionError } from "../../utils/errors.js";
 /**
  * Browser IndexedDB adapter
  */

package/dist/adapters/web/LocalStorageAdapter.js

@@ -2,9 +2,9 @@
  * LocalStorage Adapter - Browser localStorage implementation
  * Provides persistent storage with 5-10MB limit
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import { serialize, deserialize, getObjectSize } from '@/utils';
-import { QuotaExceededError, SerializationError } from '@/utils/errors';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import { serialize, deserialize, getObjectSize } from "../../utils/index.js";
+import { QuotaExceededError, SerializationError } from "../../utils/errors.js";
 /**
  * Browser localStorage adapter
  */

package/dist/adapters/web/MemoryAdapter.js

@@ -2,8 +2,8 @@
  * Memory Adapter - In-memory storage implementation
  * Provides fast, non-persistent storage using Map
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import { deepClone } from '@/utils';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import { deepClone } from "../../utils/index.js";
 /**
  * In-memory storage adapter using Map
  */
@@ -134,7 +134,7 @@ export class MemoryAdapter extends BaseAdapter {
     async query(condition) {
         const results = [];
         for (const [key, item] of this.storage.entries()) {
-            if (!this.isExpired(item) && this.queryEngine.matches(item.value, condition)) {
+            if (!this.isExpired(item) && this.queryEngine.matches(item, condition)) {
                 results.push({
                     key,
                     value: deepClone(item.value),

package/dist/adapters/web/SessionStorageAdapter.js

@@ -2,7 +2,7 @@
  * SessionStorage Adapter - Browser sessionStorage implementation
  * Provides session-scoped storage with 5-10MB limit
  */
-import { LocalStorageAdapter } from './LocalStorageAdapter';
+import { LocalStorageAdapter } from "./LocalStorageAdapter.js";
 /**
  * Browser sessionStorage adapter
  * Extends LocalStorageAdapter as the API is identical

package/dist/adapters/web/index.js

@@ -1,9 +1,9 @@
 /**
  * Web storage adapters
  */
-export { MemoryAdapter } from './MemoryAdapter';
-export { LocalStorageAdapter } from './LocalStorageAdapter';
-export { SessionStorageAdapter } from './SessionStorageAdapter';
-export { IndexedDBAdapter } from './IndexedDBAdapter';
-export { CookieAdapter } from './CookieAdapter';
-export { CacheAdapter } from './CacheAdapter';
+export { MemoryAdapter } from "./MemoryAdapter.js";
+export { LocalStorageAdapter } from "./LocalStorageAdapter.js";
+export { SessionStorageAdapter } from "./SessionStorageAdapter.js";
+export { IndexedDBAdapter } from "./IndexedDBAdapter.js";
+export { CookieAdapter } from "./CookieAdapter.js";
+export { CacheAdapter } from "./CacheAdapter.js";

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

@@ -0,0 +1,65 @@
+package com.strata.storage;
+
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.os.Build;
+import androidx.security.crypto.EncryptedSharedPreferences;
+import androidx.security.crypto.MasterKey;
+import java.util.Set;
+import java.util.Map;
+
+public class EncryptedStorage {
+    private SharedPreferences encryptedPrefs;
+    private SharedPreferences.Editor editor;
+    
+    public EncryptedStorage(Context context, String name) throws Exception {
+        String fileName = name != null ? name : "StrataSecureStorage";
+        
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+            MasterKey masterKey = new MasterKey.Builder(context)
+                .setKeyScheme(MasterKey.KeyScheme.AES256_GCM)
+                .build();
+                
+            encryptedPrefs = EncryptedSharedPreferences.create(
+                context,
+                fileName,
+                masterKey,
+                EncryptedSharedPreferences.PrefKeyEncryptionScheme.AES256_SIV,
+                EncryptedSharedPreferences.PrefValueEncryptionScheme.AES256_GCM
+            );
+            
+            editor = encryptedPrefs.edit();
+        } else {
+            // Fallback to regular SharedPreferences for older devices
+            encryptedPrefs = context.getSharedPreferences(fileName, Context.MODE_PRIVATE);
+            editor = encryptedPrefs.edit();
+        }
+    }
+    
+    public boolean set(String key, String value) {
+        editor.putString(key, value);
+        return editor.commit();
+    }
+    
+    public String get(String key) {
+        return encryptedPrefs.getString(key, null);
+    }
+    
+    public boolean remove(String key) {
+        editor.remove(key);
+        return editor.commit();
+    }
+    
+    public boolean clear() {
+        editor.clear();
+        return editor.commit();
+    }
+    
+    public Set<String> keys() {
+        return encryptedPrefs.getAll().keySet();
+    }
+    
+    public boolean has(String key) {
+        return encryptedPrefs.contains(key);
+    }
+}