strata-storage 2.6.0 → 2.6.1

package/AI-INTEGRATION-GUIDE.md

@@ -1,6 +1,6 @@
 # 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. Current version: **2.5.0**.
+Quick reference for AI development agents (Claude Code, Cursor, Copilot, etc.) to integrate `strata-storage` into web and mobile projects. Current version: **2.6.1**.
 
 ## Installation
 
@@ -160,15 +160,24 @@ const storage = defineStorage();
 
 ```typescript
 import { defineStorage } from 'strata-storage';
-import { PreferencesAdapter, SecureStorageAdapter } from 'strata-storage/capacitor';
+import {
+  PreferencesAdapter,
+  SecureStorageAdapter,
+  SqliteAdapter,
+  FilesystemAdapter,
+} from 'strata-storage/capacitor';
 
 const storage = defineStorage();
 storage.registerAdapter(new PreferencesAdapter());
 storage.registerAdapter(new SecureStorageAdapter());
+storage.registerAdapter(new SqliteAdapter());       // 2.6.0 — multi-store (database + table)
+storage.registerAdapter(new FilesystemAdapter());   // 2.6.0 — file-per-key, atomic writes
 await storage.set('secret', token, { storage: 'secure' });
 ```
 
-Native adapters depend on the downstream Capacitor project setup; verify behavior on-device.
+**SQLite multi-store** (2.6.0): each `new SqliteAdapter({ database, table })` is an isolated store — distinct `(database, table)` pairs map to distinct physical `.db` files / tables natively and cannot collide. **Filesystem** (2.6.0): one JSON file per key under the app's documents/files directory; `isAvailable()` now returns `true` on iOS and Android.
+
+Native adapters depend on the downstream Capacitor project setup; follow `docs/guides/platforms/device-verification.md` to verify on a real iOS + Android device.
 
 ## Strata API (most-used methods)
 

package/README.md

@@ -9,7 +9,7 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-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)
 
-- **Version:** `2.5.0`
+- **Version:** `2.6.1`
 - **License:** Apache-2.0
 - **Node.js:** `>= 24.13.0`
 - **Module format:** ESM only
@@ -390,15 +390,22 @@ const active = await storage.query({
 
 ### iOS and Android (via Capacitor)
 
-Register native adapters yourself when running under Capacitor:
+Register the native adapters you need when running under Capacitor. All four are zero-runtime-dependency: SQLite is hand-rolled (no plugin dependency) and filesystem uses the platform's native `FileManager` / `java.io.File`.
 
 ```typescript
 import { defineStorage } from 'strata-storage';
-import { PreferencesAdapter, SecureStorageAdapter } from 'strata-storage/capacitor';
+import {
+  PreferencesAdapter,
+  SecureStorageAdapter,
+  SqliteAdapter,
+  FilesystemAdapter,
+} from 'strata-storage/capacitor';
 
 const storage = defineStorage();
-storage.registerAdapter(new PreferencesAdapter());  // UserDefaults / SharedPreferences
+storage.registerAdapter(new PreferencesAdapter());   // UserDefaults / SharedPreferences
 storage.registerAdapter(new SecureStorageAdapter()); // Keychain / EncryptedSharedPreferences
+storage.registerAdapter(new SqliteAdapter());        // native SQLite
+storage.registerAdapter(new FilesystemAdapter());    // native files
 
 await storage.set('secret', token, { storage: 'secure' });
 ```
@@ -407,10 +414,25 @@ await storage.set('secret', token, { storage: 'secure' });
 |---------|-------------|-----------------|
 | `preferences` | UserDefaults | SharedPreferences |
 | `secure` | Keychain | EncryptedSharedPreferences |
-| `sqlite` | SQLite | SQLite |
-| `filesystem` | FileManager | Filesystem |
+| `sqlite` | SQLite (multi-store) | SQLite (multi-store) |
+| `filesystem` | FileManager | java.io.File |
 
-> **Honest note:** the native iOS/Android adapters depend on your downstream Capacitor project setup and platform configuration. Behavior on a real device should be verified on-device — native storage cannot be exercised by the web/Node test suite.
+**SQLite multi-store** (2.6.0+): each `SqliteAdapter` instance binds to a `(database, table)` pair, so distinct logical stores map to distinct physical SQLite files / tables and cannot collide.
+
+```typescript
+import { SqliteAdapter } from 'strata-storage/capacitor';
+
+const analytics = defineStorage();
+analytics.registerAdapter(new SqliteAdapter({ database: 'analytics', table: 'events' }));
+
+const audit = defineStorage();
+audit.registerAdapter(new SqliteAdapter({ database: 'audit', table: 'rows' }));
+// → separate physical .db files; writes to `analytics` can never bleed into `audit`.
+```
+
+`await storage.size(true)` aggregates `{ total, count, byStorage, ... }`; native SQLite and filesystem additionally report a per-column byte breakdown (keys / values / metadata) when called on those adapters directly.
+
+> **Honest note:** the native iOS/Android adapters depend on your downstream Capacitor project setup and platform configuration, and native behavior cannot be exercised by the web/Node test suite. Follow [`docs/guides/platforms/device-verification.md`](./docs/guides/platforms/device-verification.md) to verify on a real iOS and Android device after integrating.
 
 ### Firebase (optional cloud sync)
 
@@ -436,8 +458,8 @@ await storage.set('data', value, { storage: 'firestore' });
 | `url` | Web | ✅ | async only | Shareable UI state, length-limited |
 | `preferences` | Mobile | ❌ | async only | UserDefaults / SharedPreferences |
 | `secure` | Mobile | ❌ | async only | Keychain / EncryptedSharedPreferences |
-| `sqlite` | Mobile | ❌ | async only | Native SQLite |
-| `filesystem` | Mobile | ❌ | async only | Native files |
+| `sqlite` | Mobile | ❌ | async only | Native SQLite — multi-store via `(database, table)` (2.6.0+) |
+| `filesystem` | Mobile | ❌ | async only | Native files — file-per-key with atomic writes (2.6.0+) |
 
 "async only" means encryption and compression require the `await storage.set(...)` path — the synchronous API cannot encrypt or compress.
 

package/dist/README.md

@@ -9,7 +9,7 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-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)
 
-- **Version:** `2.5.0`
+- **Version:** `2.6.1`
 - **License:** Apache-2.0
 - **Node.js:** `>= 24.13.0`
 - **Module format:** ESM only
@@ -390,15 +390,22 @@ const active = await storage.query({
 
 ### iOS and Android (via Capacitor)
 
-Register native adapters yourself when running under Capacitor:
+Register the native adapters you need when running under Capacitor. All four are zero-runtime-dependency: SQLite is hand-rolled (no plugin dependency) and filesystem uses the platform's native `FileManager` / `java.io.File`.
 
 ```typescript
 import { defineStorage } from 'strata-storage';
-import { PreferencesAdapter, SecureStorageAdapter } from 'strata-storage/capacitor';
+import {
+  PreferencesAdapter,
+  SecureStorageAdapter,
+  SqliteAdapter,
+  FilesystemAdapter,
+} from 'strata-storage/capacitor';
 
 const storage = defineStorage();
-storage.registerAdapter(new PreferencesAdapter());  // UserDefaults / SharedPreferences
+storage.registerAdapter(new PreferencesAdapter());   // UserDefaults / SharedPreferences
 storage.registerAdapter(new SecureStorageAdapter()); // Keychain / EncryptedSharedPreferences
+storage.registerAdapter(new SqliteAdapter());        // native SQLite
+storage.registerAdapter(new FilesystemAdapter());    // native files
 
 await storage.set('secret', token, { storage: 'secure' });
 ```
@@ -407,10 +414,25 @@ await storage.set('secret', token, { storage: 'secure' });
 |---------|-------------|-----------------|
 | `preferences` | UserDefaults | SharedPreferences |
 | `secure` | Keychain | EncryptedSharedPreferences |
-| `sqlite` | SQLite | SQLite |
-| `filesystem` | FileManager | Filesystem |
+| `sqlite` | SQLite (multi-store) | SQLite (multi-store) |
+| `filesystem` | FileManager | java.io.File |
 
-> **Honest note:** the native iOS/Android adapters depend on your downstream Capacitor project setup and platform configuration. Behavior on a real device should be verified on-device — native storage cannot be exercised by the web/Node test suite.
+**SQLite multi-store** (2.6.0+): each `SqliteAdapter` instance binds to a `(database, table)` pair, so distinct logical stores map to distinct physical SQLite files / tables and cannot collide.
+
+```typescript
+import { SqliteAdapter } from 'strata-storage/capacitor';
+
+const analytics = defineStorage();
+analytics.registerAdapter(new SqliteAdapter({ database: 'analytics', table: 'events' }));
+
+const audit = defineStorage();
+audit.registerAdapter(new SqliteAdapter({ database: 'audit', table: 'rows' }));
+// → separate physical .db files; writes to `analytics` can never bleed into `audit`.
+```
+
+`await storage.size(true)` aggregates `{ total, count, byStorage, ... }`; native SQLite and filesystem additionally report a per-column byte breakdown (keys / values / metadata) when called on those adapters directly.
+
+> **Honest note:** the native iOS/Android adapters depend on your downstream Capacitor project setup and platform configuration, and native behavior cannot be exercised by the web/Node test suite. Follow [`docs/guides/platforms/device-verification.md`](./docs/guides/platforms/device-verification.md) to verify on a real iOS and Android device after integrating.
 
 ### Firebase (optional cloud sync)
 
@@ -436,8 +458,8 @@ await storage.set('data', value, { storage: 'firestore' });
 | `url` | Web | ✅ | async only | Shareable UI state, length-limited |
 | `preferences` | Mobile | ❌ | async only | UserDefaults / SharedPreferences |
 | `secure` | Mobile | ❌ | async only | Keychain / EncryptedSharedPreferences |
-| `sqlite` | Mobile | ❌ | async only | Native SQLite |
-| `filesystem` | Mobile | ❌ | async only | Native files |
+| `sqlite` | Mobile | ❌ | async only | Native SQLite — multi-store via `(database, table)` (2.6.0+) |
+| `filesystem` | Mobile | ❌ | async only | Native files — file-per-key with atomic writes (2.6.0+) |
 
 "async only" means encryption and compression require the `await storage.set(...)` path — the synchronous API cannot encrypt or compress.
 

package/dist/package.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strata-storage",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "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",
@@ -103,9 +103,9 @@
     }
   },
   "devDependencies": {
-    "@angular/common": "^21.2.14",
-    "@angular/core": "^21.2.14",
-    "@angular/forms": "^21.2.14",
+    "@angular/common": "^21.2.15",
+    "@angular/core": "^21.2.15",
+    "@angular/forms": "^21.2.15",
     "@capacitor/core": "^8.3.4",
     "@types/node": "^25.9.1",
     "@types/react": "^19.2.15",
@@ -114,7 +114,7 @@
     "@vitest/coverage-v8": "^4.1.7",
     "eslint": "^10.4.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.5",
+    "eslint-plugin-prettier": "^5.5.6",
     "jsdom": "^29.1.1",
     "prettier": "^3.8.3",
     "react": "^19.2.6",
@@ -122,7 +122,7 @@
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.60.0",
     "vitest": "^4.1.7",
-    "vue": "^3.5.34",
+    "vue": "^3.5.35",
     "zone.js": "~0.16.0"
   },
   "engines": {