strata-storage 2.4.1 → 2.4.3

package/AI-INTEGRATION-GUIDE.md

@@ -0,0 +1,354 @@
+# AI Integration Guide - strata-storage
+
+Quick reference for AI development agents (Claude Code, Cursor, Copilot, etc.) to integrate strata-storage into web and mobile projects.
+
+## Installation
+
+```bash
+yarn add strata-storage
+# or
+npm install strata-storage
+```
+
+## Core Concepts
+
+strata-storage provides:
+- **Zero Dependencies** - Pure TypeScript, no runtime deps
+- **9 Storage Adapters** - Memory, LocalStorage, SessionStorage, IndexedDB, Cookies, Cache, Preferences, SQLite, Secure, Filesystem
+- **Advanced Features** - Encryption, compression, TTL, queries, cross-tab sync
+
+## Quick Start
+
+### Basic Usage
+
+```typescript
+import { Strata } from 'strata-storage';
+
+const storage = new Strata();
+await storage.initialize();
+
+// Set data
+await storage.set('username', 'john_doe');
+await storage.set('user', { id: 1, name: 'John' });
+
+// Get data
+const username = await storage.get('username');
+const user = await storage.get<{ id: number; name: string }>('user');
+
+// Remove data
+await storage.remove('username');
+
+// Clear all
+await storage.clear();
+```
+
+### With Encryption
+
+```typescript
+const storage = new Strata({
+  encryption: {
+    enabled: true,
+    password: 'your-secure-password',
+  },
+});
+await storage.initialize();
+
+// Data is automatically encrypted
+await storage.set('secret', { token: 'abc123' });
+```
+
+### With TTL (Time-To-Live)
+
+```typescript
+const storage = new Strata({
+  ttl: {
+    enabled: true,
+    defaultTTL: 3600000, // 1 hour in ms
+  },
+});
+await storage.initialize();
+
+// Expires after 1 hour (default)
+await storage.set('session', { token: '...' });
+
+// Custom TTL: expires in 5 minutes
+await storage.set('cache', data, { ttl: 300000 });
+```
+
+### With Compression
+
+```typescript
+const storage = new Strata({
+  compression: {
+    enabled: true,
+    threshold: 1024, // Compress data > 1KB
+  },
+});
+```
+
+## Storage Adapters
+
+### Web Adapters
+
+```typescript
+import {
+  MemoryAdapter,
+  LocalStorageAdapter,
+  SessionStorageAdapter,
+  IndexedDBAdapter,
+  CookieAdapter,
+  CacheAdapter,
+} from 'strata-storage';
+
+const storage = new Strata();
+storage.registerAdapter(new LocalStorageAdapter());
+storage.registerAdapter(new IndexedDBAdapter());
+await storage.initialize();
+```
+
+### Capacitor/Mobile Adapters
+
+```typescript
+import { Strata } from 'strata-storage';
+import {
+  PreferencesAdapter,
+  SQLiteAdapter,
+  SecureStorageAdapter,
+  FilesystemAdapter,
+} from 'strata-storage/capacitor';
+
+const storage = new Strata();
+storage.registerAdapter(new PreferencesAdapter());
+storage.registerAdapter(new SecureStorageAdapter()); // For sensitive data
+await storage.initialize();
+```
+
+### Adapter Selection
+
+```typescript
+// Use specific adapter
+await storage.set('key', 'value', { adapter: 'localStorage' });
+await storage.set('secure', 'secret', { adapter: 'secure' });
+
+// Get from specific adapter
+const value = await storage.get('key', { adapter: 'indexedDB' });
+```
+
+## Framework Integrations
+
+### React
+
+```typescript
+import { useStorage } from 'strata-storage/react';
+
+function MyComponent() {
+  const { value, setValue, remove, loading, error } = useStorage<string>('username');
+
+  if (loading) return <div>Loading...</div>;
+
+  return (
+    <div>
+      <p>Username: {value}</p>
+      <button onClick={() => setValue('new_user')}>Update</button>
+      <button onClick={remove}>Remove</button>
+    </div>
+  );
+}
+```
+
+### Vue
+
+```typescript
+import { useStorage } from 'strata-storage/vue';
+
+const { value, setValue, remove, loading, error } = useStorage<string>('username');
+```
+
+### Angular
+
+```typescript
+import { StorageService } from 'strata-storage/angular';
+
+@Component({ ... })
+export class MyComponent {
+  constructor(private storage: StorageService) {}
+
+  async ngOnInit() {
+    const value = await this.storage.get('key');
+  }
+}
+```
+
+## API Reference
+
+### Strata Class
+
+| Method | Description | Returns |
+|--------|-------------|---------|
+| `initialize()` | Initialize storage and adapters | `Promise<void>` |
+| `set(key, value, options?)` | Store a value | `Promise<void>` |
+| `get<T>(key, options?)` | Retrieve a value | `Promise<T \| null>` |
+| `remove(key, options?)` | Remove a value | `Promise<void>` |
+| `clear(options?)` | Clear all values | `Promise<void>` |
+| `has(key, options?)` | Check if key exists | `Promise<boolean>` |
+| `keys(options?)` | Get all keys | `Promise<string[]>` |
+| `registerAdapter(adapter)` | Register storage adapter | `void` |
+| `subscribe(callback)` | Subscribe to changes | `UnsubscribeFunction` |
+
+### Configuration Options
+
+```typescript
+interface StrataConfig {
+  defaultStorages?: StorageType[];  // Preferred adapter order
+  autoInitialize?: boolean;         // Auto-init on first operation
+  encryption?: {
+    enabled: boolean;
+    password: string;
+    algorithm?: 'AES-GCM';
+  };
+  compression?: {
+    enabled: boolean;
+    threshold?: number;  // Min bytes to compress
+  };
+  ttl?: {
+    enabled: boolean;
+    defaultTTL?: number; // Default expiration in ms
+    cleanupInterval?: number;
+  };
+  sync?: {
+    enabled: boolean;
+    channel?: string;    // BroadcastChannel name
+  };
+}
+```
+
+### Storage Options
+
+```typescript
+interface StorageOptions {
+  adapter?: string;     // Specific adapter to use
+  ttl?: number;         // Custom TTL for this operation
+  tags?: string[];      // Tags for querying
+  encrypt?: boolean;    // Override encryption setting
+  compress?: boolean;   // Override compression setting
+}
+```
+
+## Advanced Features
+
+### Tag-Based Queries
+
+```typescript
+// Store with tags
+await storage.set('user:1', userData, { tags: ['users', 'active'] });
+await storage.set('user:2', userData, { tags: ['users', 'inactive'] });
+
+// Query by tag
+const activeUsers = await storage.query({ tags: ['active'] });
+
+// Query with operators
+const results = await storage.query({
+  where: {
+    age: { $gte: 18 },
+    status: 'active',
+  },
+});
+```
+
+### Cross-Tab Sync
+
+```typescript
+const storage = new Strata({
+  sync: {
+    enabled: true,
+    channel: 'my-app-storage',
+  },
+});
+
+// Subscribe to changes (including from other tabs)
+storage.subscribe((event) => {
+  console.log('Storage changed:', event.key, event.newValue);
+});
+```
+
+### Observer Pattern
+
+```typescript
+import { StorageObserver } from 'strata-storage';
+
+const observer = new StorageObserver(storage);
+
+// Watch specific key
+observer.watch('user', (newValue, oldValue) => {
+  console.log('User changed:', newValue);
+});
+
+// Watch pattern
+observer.watchPattern(/^cache:/, (key, newValue) => {
+  console.log(`Cache key ${key} changed:`, newValue);
+});
+```
+
+## Common Patterns
+
+### Initialize Once in App Entry
+
+```typescript
+// src/storage.ts
+import { Strata } from 'strata-storage';
+
+export const storage = new Strata({
+  encryption: { enabled: true, password: import.meta.env.VITE_STORAGE_KEY },
+  ttl: { enabled: true, defaultTTL: 86400000 }, // 24 hours
+});
+
+// Initialize early in app lifecycle
+storage.initialize();
+
+export default storage;
+```
+
+### Use in Components
+
+```typescript
+import storage from '@/storage';
+
+async function saveSettings(settings: Settings) {
+  await storage.set('settings', settings);
+}
+
+async function loadSettings(): Promise<Settings | null> {
+  return await storage.get<Settings>('settings');
+}
+```
+
+### Capacitor Mobile Setup
+
+```typescript
+// capacitor.config.ts - register plugin
+import { registerPlugin } from '@capacitor/core';
+
+// In your app initialization
+import { Strata } from 'strata-storage';
+import { PreferencesAdapter, SecureStorageAdapter } from 'strata-storage/capacitor';
+
+const storage = new Strata();
+storage.registerAdapter(new PreferencesAdapter());
+storage.registerAdapter(new SecureStorageAdapter());
+await storage.initialize();
+```
+
+## Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| Data not persisting | Ensure `initialize()` is called before operations |
+| Encryption errors | Check password is consistent, use env vars |
+| Mobile storage not working | Register Capacitor adapters explicitly |
+| Cross-tab not syncing | Enable sync in config, use same channel name |
+
+## Links
+
+- [Full Documentation](./README.md)
+- [Changelog](./CHANGELOG.md)
+- [GitHub](https://github.com/aoneahsan/strata-storage)

package/README.md

@@ -0,0 +1,297 @@
+# Strata Storage
+
+- **[AI Integration Guide](./AI-INTEGRATION-GUIDE.md)** - Quick reference for AI development agents (Claude, Cursor, Copilot)
+
+> Zero-dependency universal storage plugin providing a unified API for all storage operations across web, Android, and iOS platforms.
+
+[![npm version](https://img.shields.io/npm/v/strata-storage.svg)](https://www.npmjs.com/package/strata-storage)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9+-blue.svg)](https://www.typescriptlang.org/)
+[![Platform](https://img.shields.io/badge/platform-Web%20%7C%20iOS%20%7C%20Android-lightgrey.svg)](https://github.com/aoneahsan/strata-storage)
+
+## Features
+
+- **🚀 Zero Dependencies** - No external runtime dependencies, pure TypeScript implementation
+- **🌐 Universal API** - Single consistent API across web, iOS, and Android
+- **🔒 Built-in Encryption** - Secure data storage using native crypto APIs
+- **📦 Compression** - Automatic data compression for large objects
+- **⏱️ TTL Support** - Automatic expiration with time-to-live
+- **🔄 Cross-Tab Sync** - Real-time synchronization across browser tabs
+- **🎯 Advanced Queries** - Tag-based querying and filtering
+- **📱 Mobile Ready** - Native iOS and Android storage with Capacitor
+- **💾 Multiple Adapters** - localStorage, IndexedDB, SQLite, Keychain, and more
+- **🎨 Framework Integrations** - React hooks, Vue composables, Angular services
+
+## Installation
+
+```bash
+npm install strata-storage
+```
+
+Or using yarn:
+
+```bash
+yarn add strata-storage
+```
+
+Or using pnpm:
+
+```bash
+pnpm add strata-storage
+```
+
+## Quick Start
+
+### Basic Usage
+
+```typescript
+import { Strata } from 'strata-storage';
+
+// Create and initialize storage
+const storage = new Strata();
+await storage.initialize();
+
+// Store data
+await storage.set('username', 'john_doe');
+await storage.set('user', {
+  id: 123,
+  name: 'John Doe',
+  email: 'john@example.com'
+});
+
+// Retrieve data
+const username = await storage.get('username');
+const user = await storage.get('user');
+
+// Remove data
+await storage.remove('username');
+
+// Clear all data
+await storage.clear();
+```
+
+### Advanced Features
+
+#### Encryption
+
+```typescript
+const storage = new Strata({
+  encryption: {
+    enabled: true,
+    password: 'your-secure-password'
+  }
+});
+
+await storage.initialize();
+await storage.set('sensitiveData', { token: 'secret' });
+```
+
+#### Time-To-Live (TTL)
+
+```typescript
+// Data expires in 1 hour
+await storage.set('sessionData', data, {
+  ttl: 60 * 60 * 1000
+});
+```
+
+#### Compression
+
+```typescript
+const storage = new Strata({
+  compression: {
+    enabled: true,
+    threshold: 1024 // Compress data larger than 1KB
+  }
+});
+
+await storage.initialize();
+await storage.set('largeData', bigObject);
+```
+
+#### Cross-Tab Sync
+
+```typescript
+const storage = new Strata({
+  sync: { enabled: true }
+});
+
+await storage.initialize();
+
+// Subscribe to changes from other tabs
+storage.subscribe((change) => {
+  console.log(`Key ${change.key} changed to:`, change.newValue);
+});
+```
+
+## Platform Support
+
+### Web Browsers
+- **localStorage** - Simple key-value storage
+- **sessionStorage** - Session-scoped storage
+- **IndexedDB** - Large structured data
+- **Cookies** - Cookie-based storage
+- **Cache API** - HTTP cache storage
+- **Memory** - In-memory storage
+
+### iOS (via Capacitor)
+- **UserDefaults** - User preferences
+- **Keychain** - Secure credential storage
+- **SQLite** - Database storage
+- **FileManager** - File-based storage
+
+### Android (via Capacitor)
+- **SharedPreferences** - Simple key-value storage
+- **EncryptedSharedPreferences** - Secure storage
+- **SQLite** - Database storage
+- **File Storage** - File-based storage
+
+## Framework Integrations
+
+### React
+
+```typescript
+import { useStrata } from 'strata-storage/react';
+
+function MyComponent() {
+  const { data, loading, set, remove } = useStrata('myKey');
+
+  return (
+    <div>
+      <p>{data}</p>
+      <button onClick={() => set('newValue')}>Update</button>
+    </div>
+  );
+}
+```
+
+### Vue
+
+```typescript
+import { useStrata } from 'strata-storage/vue';
+
+export default {
+  setup() {
+    const { data, loading, set, remove } = useStrata('myKey');
+
+    return { data, loading, set, remove };
+  }
+};
+```
+
+### Angular
+
+```typescript
+import { StrataService } from 'strata-storage/angular';
+
+@Component({ /* ... */ })
+export class MyComponent {
+  constructor(private storage: StrataService) {}
+
+  async saveData() {
+    await this.storage.set('key', 'value');
+  }
+}
+```
+
+## Documentation
+
+- **[Getting Started](docs/getting-started/installation.md)** - Installation and setup guide
+- **[Quick Start](docs/getting-started/quick-start.md)** - Get up and running in minutes
+- **[API Reference](docs/api/README.md)** - Complete API documentation
+- **[Platform Guides](docs/guides/platforms/web.md)** - Platform-specific information
+- **[Examples](docs/examples/README.md)** - Real-world usage examples
+- **[Migration Guide](docs/MIGRATION.md)** - Migrating from other storage solutions
+
+## Storage Adapters
+
+| Adapter | Platform | Use Case |
+|---------|----------|----------|
+| `localStorage` | Web | Simple key-value, persistent |
+| `sessionStorage` | Web | Session-scoped data |
+| `indexedDB` | Web | Large structured data |
+| `cookies` | Web | Cookie-based storage |
+| `cache` | Web | HTTP cache |
+| `memory` | All | Temporary in-memory |
+| `preferences` | Mobile | User preferences (UserDefaults/SharedPreferences) |
+| `secure` | Mobile | Encrypted storage (Keychain/EncryptedSharedPreferences) |
+| `sqlite` | Mobile | Database storage |
+| `filesystem` | Mobile | File-based storage |
+
+## Requirements
+
+- **Node.js**: 18.0.0 or higher
+- **TypeScript**: 5.0+ (optional, but recommended)
+- **Capacitor**: 5.x or 6.x (for mobile platforms)
+
+## Browser Support
+
+- Chrome/Edge: Latest 2 versions
+- Firefox: Latest 2 versions
+- Safari: Latest 2 versions
+- iOS Safari: iOS 13+
+- Android WebView: Android 8+
+
+## Why Strata Storage?
+
+### Zero Dependencies
+Unlike other storage solutions that depend on multiple packages, Strata Storage has **zero runtime dependencies**. Everything is built from scratch, ensuring:
+- Smaller bundle size
+- No dependency conflicts
+- Better security
+- Full control over implementation
+
+### Universal API
+One API works everywhere. No need to learn different APIs for web and mobile, or switch between libraries:
+
+```typescript
+// Same code works on web, iOS, and Android
+await storage.set('key', 'value');
+const value = await storage.get('key');
+```
+
+### Built-in Features
+Advanced features included out of the box:
+- Encryption (Web Crypto API / Native Crypto)
+- Compression (LZ-string algorithm)
+- TTL/Expiration
+- Cross-tab sync
+- Advanced queries
+- Data migrations
+
+## Contributing
+
+Contributions are welcome! Please read the [Contributing Guide](CONTRIBUTING.md) for details.
+
+## License
+
+Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
+
+## Author
+
+**Ahsan Mahmood**
+- Email: aoneahsan@gmail.com
+- LinkedIn: [linkedin.com/in/aoneahsan](https://linkedin.com/in/aoneahsan)
+- Portfolio: [aoneahsan.com](https://aoneahsan.com)
+- GitHub: [@aoneahsan](https://github.com/aoneahsan)
+- NPM: [npmjs.com/~aoneahsan](https://www.npmjs.com/~aoneahsan)
+- Phone/WhatsApp: +923046619706
+
+## Links
+
+- **NPM Package**: [npmjs.com/package/strata-storage](https://www.npmjs.com/package/strata-storage)
+- **GitHub Repository**: [github.com/aoneahsan/strata-storage](https://github.com/aoneahsan/strata-storage)
+- **Issue Tracker**: [github.com/aoneahsan/strata-storage/issues](https://github.com/aoneahsan/strata-storage/issues)
+- **Documentation**: [github.com/aoneahsan/strata-storage/tree/main/docs](https://github.com/aoneahsan/strata-storage/tree/main/docs)
+
+## Support
+
+If you encounter any issues or have questions:
+
+1. Check the [FAQ](docs/reference/faq.md)
+2. Search [existing issues](https://github.com/aoneahsan/strata-storage/issues)
+3. Create a [new issue](https://github.com/aoneahsan/strata-storage/issues/new)
+
+---
+
+Made with ❤️ by [Ahsan Mahmood](https://aoneahsan.com)

package/dist/README.md

@@ -0,0 +1,297 @@
+# Strata Storage
+
+- **[AI Integration Guide](./AI-INTEGRATION-GUIDE.md)** - Quick reference for AI development agents (Claude, Cursor, Copilot)
+
+> Zero-dependency universal storage plugin providing a unified API for all storage operations across web, Android, and iOS platforms.
+
+[![npm version](https://img.shields.io/npm/v/strata-storage.svg)](https://www.npmjs.com/package/strata-storage)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9+-blue.svg)](https://www.typescriptlang.org/)
+[![Platform](https://img.shields.io/badge/platform-Web%20%7C%20iOS%20%7C%20Android-lightgrey.svg)](https://github.com/aoneahsan/strata-storage)
+
+## Features
+
+- **🚀 Zero Dependencies** - No external runtime dependencies, pure TypeScript implementation
+- **🌐 Universal API** - Single consistent API across web, iOS, and Android
+- **🔒 Built-in Encryption** - Secure data storage using native crypto APIs
+- **📦 Compression** - Automatic data compression for large objects
+- **⏱️ TTL Support** - Automatic expiration with time-to-live
+- **🔄 Cross-Tab Sync** - Real-time synchronization across browser tabs
+- **🎯 Advanced Queries** - Tag-based querying and filtering
+- **📱 Mobile Ready** - Native iOS and Android storage with Capacitor
+- **💾 Multiple Adapters** - localStorage, IndexedDB, SQLite, Keychain, and more
+- **🎨 Framework Integrations** - React hooks, Vue composables, Angular services
+
+## Installation
+
+```bash
+npm install strata-storage
+```
+
+Or using yarn:
+
+```bash
+yarn add strata-storage
+```
+
+Or using pnpm:
+
+```bash
+pnpm add strata-storage
+```
+
+## Quick Start
+
+### Basic Usage
+
+```typescript
+import { Strata } from 'strata-storage';
+
+// Create and initialize storage
+const storage = new Strata();
+await storage.initialize();
+
+// Store data
+await storage.set('username', 'john_doe');
+await storage.set('user', {
+  id: 123,
+  name: 'John Doe',
+  email: 'john@example.com'
+});
+
+// Retrieve data
+const username = await storage.get('username');
+const user = await storage.get('user');
+
+// Remove data
+await storage.remove('username');
+
+// Clear all data
+await storage.clear();
+```
+
+### Advanced Features
+
+#### Encryption
+
+```typescript
+const storage = new Strata({
+  encryption: {
+    enabled: true,
+    password: 'your-secure-password'
+  }
+});
+
+await storage.initialize();
+await storage.set('sensitiveData', { token: 'secret' });
+```
+
+#### Time-To-Live (TTL)
+
+```typescript
+// Data expires in 1 hour
+await storage.set('sessionData', data, {
+  ttl: 60 * 60 * 1000
+});
+```
+
+#### Compression
+
+```typescript
+const storage = new Strata({
+  compression: {
+    enabled: true,
+    threshold: 1024 // Compress data larger than 1KB
+  }
+});
+
+await storage.initialize();
+await storage.set('largeData', bigObject);
+```
+
+#### Cross-Tab Sync
+
+```typescript
+const storage = new Strata({
+  sync: { enabled: true }
+});
+
+await storage.initialize();
+
+// Subscribe to changes from other tabs
+storage.subscribe((change) => {
+  console.log(`Key ${change.key} changed to:`, change.newValue);
+});
+```
+
+## Platform Support
+
+### Web Browsers
+- **localStorage** - Simple key-value storage
+- **sessionStorage** - Session-scoped storage
+- **IndexedDB** - Large structured data
+- **Cookies** - Cookie-based storage
+- **Cache API** - HTTP cache storage
+- **Memory** - In-memory storage
+
+### iOS (via Capacitor)
+- **UserDefaults** - User preferences
+- **Keychain** - Secure credential storage
+- **SQLite** - Database storage
+- **FileManager** - File-based storage
+
+### Android (via Capacitor)
+- **SharedPreferences** - Simple key-value storage
+- **EncryptedSharedPreferences** - Secure storage
+- **SQLite** - Database storage
+- **File Storage** - File-based storage
+
+## Framework Integrations
+
+### React
+
+```typescript
+import { useStrata } from 'strata-storage/react';
+
+function MyComponent() {
+  const { data, loading, set, remove } = useStrata('myKey');
+
+  return (
+    <div>
+      <p>{data}</p>
+      <button onClick={() => set('newValue')}>Update</button>
+    </div>
+  );
+}
+```
+
+### Vue
+
+```typescript
+import { useStrata } from 'strata-storage/vue';
+
+export default {
+  setup() {
+    const { data, loading, set, remove } = useStrata('myKey');
+
+    return { data, loading, set, remove };
+  }
+};
+```
+
+### Angular
+
+```typescript
+import { StrataService } from 'strata-storage/angular';
+
+@Component({ /* ... */ })
+export class MyComponent {
+  constructor(private storage: StrataService) {}
+
+  async saveData() {
+    await this.storage.set('key', 'value');
+  }
+}
+```
+
+## Documentation
+
+- **[Getting Started](docs/getting-started/installation.md)** - Installation and setup guide
+- **[Quick Start](docs/getting-started/quick-start.md)** - Get up and running in minutes
+- **[API Reference](docs/api/README.md)** - Complete API documentation
+- **[Platform Guides](docs/guides/platforms/web.md)** - Platform-specific information
+- **[Examples](docs/examples/README.md)** - Real-world usage examples
+- **[Migration Guide](docs/MIGRATION.md)** - Migrating from other storage solutions
+
+## Storage Adapters
+
+| Adapter | Platform | Use Case |
+|---------|----------|----------|
+| `localStorage` | Web | Simple key-value, persistent |
+| `sessionStorage` | Web | Session-scoped data |
+| `indexedDB` | Web | Large structured data |
+| `cookies` | Web | Cookie-based storage |
+| `cache` | Web | HTTP cache |
+| `memory` | All | Temporary in-memory |
+| `preferences` | Mobile | User preferences (UserDefaults/SharedPreferences) |
+| `secure` | Mobile | Encrypted storage (Keychain/EncryptedSharedPreferences) |
+| `sqlite` | Mobile | Database storage |
+| `filesystem` | Mobile | File-based storage |
+
+## Requirements
+
+- **Node.js**: 18.0.0 or higher
+- **TypeScript**: 5.0+ (optional, but recommended)
+- **Capacitor**: 5.x or 6.x (for mobile platforms)
+
+## Browser Support
+
+- Chrome/Edge: Latest 2 versions
+- Firefox: Latest 2 versions
+- Safari: Latest 2 versions
+- iOS Safari: iOS 13+
+- Android WebView: Android 8+
+
+## Why Strata Storage?
+
+### Zero Dependencies
+Unlike other storage solutions that depend on multiple packages, Strata Storage has **zero runtime dependencies**. Everything is built from scratch, ensuring:
+- Smaller bundle size
+- No dependency conflicts
+- Better security
+- Full control over implementation
+
+### Universal API
+One API works everywhere. No need to learn different APIs for web and mobile, or switch between libraries:
+
+```typescript
+// Same code works on web, iOS, and Android
+await storage.set('key', 'value');
+const value = await storage.get('key');
+```
+
+### Built-in Features
+Advanced features included out of the box:
+- Encryption (Web Crypto API / Native Crypto)
+- Compression (LZ-string algorithm)
+- TTL/Expiration
+- Cross-tab sync
+- Advanced queries
+- Data migrations
+
+## Contributing
+
+Contributions are welcome! Please read the [Contributing Guide](CONTRIBUTING.md) for details.
+
+## License
+
+Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
+
+## Author
+
+**Ahsan Mahmood**
+- Email: aoneahsan@gmail.com
+- LinkedIn: [linkedin.com/in/aoneahsan](https://linkedin.com/in/aoneahsan)
+- Portfolio: [aoneahsan.com](https://aoneahsan.com)
+- GitHub: [@aoneahsan](https://github.com/aoneahsan)
+- NPM: [npmjs.com/~aoneahsan](https://www.npmjs.com/~aoneahsan)
+- Phone/WhatsApp: +923046619706
+
+## Links
+
+- **NPM Package**: [npmjs.com/package/strata-storage](https://www.npmjs.com/package/strata-storage)
+- **GitHub Repository**: [github.com/aoneahsan/strata-storage](https://github.com/aoneahsan/strata-storage)
+- **Issue Tracker**: [github.com/aoneahsan/strata-storage/issues](https://github.com/aoneahsan/strata-storage/issues)
+- **Documentation**: [github.com/aoneahsan/strata-storage/tree/main/docs](https://github.com/aoneahsan/strata-storage/tree/main/docs)
+
+## Support
+
+If you encounter any issues or have questions:
+
+1. Check the [FAQ](docs/reference/faq.md)
+2. Search [existing issues](https://github.com/aoneahsan/strata-storage/issues)
+3. Create a [new issue](https://github.com/aoneahsan/strata-storage/issues/new)
+
+---
+
+Made with ❤️ by [Ahsan Mahmood](https://aoneahsan.com)

package/dist/config/support.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Support configuration for strata-storage package
+ * Help keep this package free and improving
+ */
+export declare const SUPPORT_CONFIG: {
+    readonly url: "https://aoneahsan.com/payment?project-id=strata-storage&project-identifier=strata-storage";
+    readonly label: "Support the Project";
+    readonly description: "Help us keep strata-storage free and improving";
+};
+//# sourceMappingURL=support.d.ts.map

package/dist/config/support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support.d.ts","sourceRoot":"","sources":["../../src/config/support.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;CAIjB,CAAC"}

package/dist/config/support.js

@@ -0,0 +1,9 @@
+/**
+ * Support configuration for strata-storage package
+ * Help keep this package free and improving
+ */
+export const SUPPORT_CONFIG = {
+    url: 'https://aoneahsan.com/payment?project-id=strata-storage&project-identifier=strata-storage',
+    label: 'Support the Project',
+    description: 'Help us keep strata-storage free and improving',
+};

package/dist/index.d.ts

@@ -13,7 +13,7 @@ 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 type { StorageType, StorageOptions, StorageValue, StorageAdapter, AdapterConfig, QueryOptions, SyncConfig, EncryptionConfig, CompressionConfig, ObserverCallback, StorageEvent, StorageError, StorageCapabilities, StorageMetadata, TTLConfig, StrataConfig, StorageChange, SubscriptionCallback, UnsubscribeFunction, } from './types';
 export { isValidKey, isValidValue, serializeValue, deserializeValue, generateId, createError, retry, debounce, throttle, } from './utils';
 import { Strata } from './core/Strata';
 declare const storage: Strata;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"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;AAoBH,QAAA,MAAM,iBAAiB,qBAQtB,CAAC;AAMF,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAGtC,eAAe,OAAO,CAAC"}
+{"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,EACT,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,mBAAmB,GACpB,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;AAoBH,QAAA,MAAM,iBAAiB,qBAQtB,CAAC;AAMF,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAGtC,eAAe,OAAO,CAAC"}

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strata-storage",
-  "version": "2.4.1",
+  "version": "2.4.3",
   "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.4.1",
+  "version": "2.4.3",
   "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",
@@ -10,7 +10,8 @@
     "ios/",
     "android/",
     "scripts/",
-    "StrataStorage.podspec"
+    "StrataStorage.podspec",
+    "AI-INTEGRATION-GUIDE.md"
   ],
   "bin": {
     "strata-storage": "./scripts/cli.js"
@@ -27,6 +28,18 @@
     "./firebase": {
       "types": "./dist/firebase.d.ts",
       "default": "./dist/firebase.js"
+    },
+    "./react": {
+      "types": "./dist/integrations/react/index.d.ts",
+      "default": "./dist/integrations/react/index.js"
+    },
+    "./vue": {
+      "types": "./dist/integrations/vue/index.d.ts",
+      "default": "./dist/integrations/vue/index.js"
+    },
+    "./angular": {
+      "types": "./dist/integrations/angular/index.d.ts",
+      "default": "./dist/integrations/angular/index.js"
     }
   },
   "scripts": {
@@ -36,7 +49,7 @@
     "typecheck": "tsc --noEmit",
     "test": "vitest",
     "test:coverage": "vitest --coverage",
-    "prepublishOnly": "pnpm build && pnpm lint && pnpm typecheck",
+    "prepublishOnly": "yarn build && yarn lint && yarn typecheck",
     "postinstall": "node scripts/postinstall.js || true"
   },
   "keywords": [
@@ -88,22 +101,22 @@
     }
   },
   "devDependencies": {
-    "@types/node": "^25.0.3",
-    "@types/react": "^19.2.7",
-    "@typescript-eslint/eslint-plugin": "^8.50.1",
-    "@typescript-eslint/parser": "^8.50.1",
-    "@vitest/coverage-v8": "^4.0.16",
+    "@types/node": "^25.0.9",
+    "@types/react": "^19.2.9",
+    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/parser": "^8.53.1",
+    "@vitest/coverage-v8": "^4.0.17",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-prettier": "^5.5.5",
     "jsdom": "^27.4.0",
-    "prettier": "^3.7.4",
+    "prettier": "^3.8.0",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.50.1",
-    "vitest": "^4.0.16"
+    "typescript-eslint": "^8.53.1",
+    "vitest": "^4.0.17"
   },
   "engines": {
-    "node": ">=25.0.3"
+    "node": ">=18.0.0"
   },
   "capacitor": {
     "ios": {