strata-storage 2.0.4 → 2.1.0

package/Readme.md

@@ -2,14 +2,64 @@
 
 ## 📚 Documentation
 
-- **[Getting Started](./docs/getting-started/installation.md)** - Installation and setup
+### Getting Started
+- **[Installation](./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
+
+### Core Documentation
+- **[API Reference](./docs/api/README.md)** - Complete API documentation
+- **[Core API](./docs/api/core/strata.md)** - Main Strata class
+- **[Type Definitions](./docs/api/core/types.md)** - TypeScript types
+- **[Error Handling](./docs/api/core/errors.md)** - Error types and handling
+
+### Storage Adapters
+- **[Web Adapters](./docs/api/adapters/README.md#web-adapters)** - Browser storage
+  - [localStorage](./docs/api/adapters/web/localstorage.md)
+  - [sessionStorage](./docs/api/adapters/web/sessionstorage.md)
+  - [IndexedDB](./docs/api/adapters/web/indexeddb.md)
+  - [Cookies](./docs/api/adapters/web/cookies.md)
+  - [Cache API](./docs/api/adapters/web/cache.md)
+  - [Memory](./docs/api/adapters/web/memory.md)
+- **[Capacitor Adapters](./docs/api/adapters/README.md#capacitor-adapters)** - Native storage
+  - [Preferences](./docs/api/adapters/capacitor/preferences.md)
+  - [Secure Storage](./docs/api/adapters/capacitor/secure.md)
+  - [SQLite](./docs/api/adapters/capacitor/sqlite.md)
+  - [Filesystem](./docs/api/adapters/capacitor/filesystem.md)
+
+### Advanced Features
+- **[Encryption](./docs/guides/features/encryption.md)** - Data encryption guide
+- **[Compression](./docs/guides/features/compression.md)** - Data compression
+- **[TTL Management](./docs/api/features/ttl.md)** - Auto-expiration
+- **[Cross-Tab Sync](./docs/guides/features/sync.md)** - Real-time synchronization
+- **[Query Engine](./docs/guides/features/queries.md)** - MongoDB-like queries
+- **[Migrations](./docs/guides/features/migrations.md)** - Data migration system
+
+### Platform Guides
+- **[Web Platform](./docs/guides/platforms/web.md)** - Browser-specific features
+- **[iOS Platform](./docs/guides/platforms/ios.md)** - iOS implementation
+- **[Android Platform](./docs/guides/platforms/android.md)** - Android implementation
+- **[Capacitor](./docs/guides/platforms/capacitor.md)** - Capacitor integration
+
+### Common Patterns
+- **[Caching Strategies](./docs/guides/patterns/caching.md)** - Caching best practices
+- **[Session Management](./docs/guides/patterns/sessions.md)** - User session handling
+
+### Examples
+- **[Basic Usage](./docs/examples/basic-usage.md)** - Simple examples
+- **[React Integration](./docs/examples/frameworks/react.md)** - React hooks and providers
+- **[Vue Integration](./docs/examples/frameworks/vue.md)** - Vue composables
+- **[Angular Integration](./docs/examples/frameworks/angular.md)** - Angular services
+- **[Authentication](./docs/examples/user-auth.md)** - User authentication
+- **[Shopping Cart](./docs/examples/shopping-cart.md)** - E-commerce example
+- **[Form Persistence](./docs/examples/form-persistence.md)** - Form data saving
+- **[Offline Support](./docs/examples/offline-support.md)** - Offline-first apps
+- **[All Examples](./docs/examples/README.md)** - Complete examples list
+
+### Resources
 - **[GitHub](https://github.com/aoneahsan/strata-storage)** - Source code
 - **[NPM](https://www.npmjs.com/package/strata-storage)** - Package registry
+- **[Example App](./examples/react-capacitor-app)** - Full demo application
 
 ---
 
@@ -108,13 +158,13 @@ await storage.set('data', value, { storage: 'firestore' });
 - ✅ **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)
+- ✅ **[Encryption](./docs/guides/features/encryption.md)** - AES-GCM encryption with Web Crypto API
+- ✅ **[Compression](./docs/guides/features/compression.md)** - LZ-string compression algorithm
+- ✅ **[Cross-Tab Sync](./docs/guides/features/sync.md)** - Real-time synchronization across tabs
+- ✅ **[Query Engine](./docs/guides/features/queries.md)** - MongoDB-like queries for filtering data
+- ✅ **[TTL Support](./docs/api/features/ttl.md)** - Automatic expiration with sliding TTL
+- ✅ **[Migration System](./docs/guides/features/migrations.md)** - Version-based data migrations
+- ✅ **Framework Integrations** - [React](./docs/examples/frameworks/react.md), [Vue](./docs/examples/frameworks/vue.md), [Angular](./docs/examples/frameworks/angular.md)
 
 ## 📖 Basic Usage
 
@@ -135,40 +185,72 @@ 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
+  tags: ['user-data'],  // Tag for grouping
+  metadata: {           // Attach metadata
+    version: 1,
+    source: 'api'
+  }
 });
 
-// Query data
+// Query data with MongoDB-like syntax
 const results = await storage.query({
   tags: { $in: ['user-data'] },
-  'value.age': { $gte: 18 }
+  'value.age': { $gte: 18 },
+  'metadata.version': 1
 });
 
 // Subscribe to changes
 storage.subscribe((change) => {
   console.log(`${change.key} changed from ${change.oldValue} to ${change.newValue}`);
 });
+
+// Check storage size
+const size = await storage.size();
+console.log(`Using ${size.total} bytes for ${size.count} items`);
 ```
 
-## 🎯 Provider-less Architecture
+## 🎯 Why Strata Storage?
+
+### Provider-less Architecture
+Like Zustand, Strata Storage works without providers, contexts, or wrappers. Just import and use - no setup required.
+
+### Zero Dependencies
+Truly zero runtime dependencies. Everything is implemented from scratch for maximum control and minimal bundle size.
+
+### Universal Compatibility
+- **One API** - Same code works on Web, iOS, and Android
+- **Any Framework** - Works with React, Vue, Angular, or vanilla JavaScript
+- **TypeScript First** - Full type safety and excellent IntelliSense
+- **Tree-Shakeable** - Only bundle what you use
 
-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.
+### Intelligent Storage Selection
+Automatically selects the best available storage based on:
+- Platform capabilities
+- Data size and type
+- Performance requirements
+- Persistence needs
 
-- **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
+### Enterprise Ready
+- **Encryption** - Built-in AES-GCM encryption
+- **Compression** - Automatic data compression
+- **TTL/Expiration** - Auto-cleanup of expired data
+- **Sync** - Real-time cross-tab/device synchronization
+- **Migrations** - Version-based data migrations
+- **Querying** - MongoDB-like query engine
 
 ## 🏗 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)
+**Production Ready** - All major features implemented:
+- ✅ Zero-dependency architecture
+- ✅ Provider-less design (like Zustand)
+- ✅ All web storage adapters (localStorage, IndexedDB, etc.)
+- ✅ Complete Capacitor integration (iOS/Android)
+- ✅ Native implementations (iOS Swift, Android Java)
 - ✅ Advanced features (encryption, compression, sync, query, TTL)
-- ✅ Provider-less architecture
-- 🚧 Native implementations (iOS/Android)
-- 🚧 Testing and documentation
+- ✅ Framework integrations (React, Vue, Angular)
+- ✅ Comprehensive documentation
+- ✅ Full TypeScript support
+- ✅ Example application with all features
 
 ## 📄 License
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strata-storage",
-  "version": "2.0.4",
+  "version": "2.1.0",
   "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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strata-storage",
-  "version": "2.0.4",
+  "version": "2.1.0",
   "description": "Zero-dependency universal storage plugin providing a unified API for all storage operations across web, Android, and iOS platforms",
   "type": "module",
   "main": "dist/index.js",