strata-storage 2.8.0 → 2.8.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.7.1**.
+Quick reference for AI development agents (Claude Code, Cursor, Copilot, etc.) to integrate `strata-storage` into web and mobile projects. Current version: **2.8.1**.
 
 ## Installation
 
@@ -209,9 +209,16 @@ const storage = defineStorage();
 
 ### Capacitor (native)
 
+`strata-storage` ships as a Capacitor plugin (native iOS + Android). In a Capacitor
+app, after installing run **`npx cap sync`** so the native module is copied into the
+iOS/Android projects — the native adapters (`secure`, `sqlite`, `preferences`,
+`filesystem`) **do not work on-device without it**. No manual plugin registration in
+JS is needed; Capacitor auto-discovers the `StrataStorage` plugin.
+
 ```typescript
 import { defineStorage } from 'strata-storage';
 import {
+  registerCapacitorAdapters,
   PreferencesAdapter,
   SecureAdapter,
   SqliteAdapter,
@@ -219,10 +226,15 @@ import {
 } from 'strata-storage/capacitor';
 
 const storage = defineStorage();
-storage.registerAdapter(new PreferencesAdapter());
-storage.registerAdapter(new SecureAdapter());
-storage.registerAdapter(new SqliteAdapter());       // 2.6.0 — multi-store (database + table)
-storage.registerAdapter(new FilesystemAdapter());   // 2.6.0 — file-per-key, atomic writes
+
+// Easiest — register all four native adapters at once (also refreshes the active set):
+await registerCapacitorAdapters(storage);
+
+// …or register individually for fine-grained control / custom adapter config:
+// storage.registerAdapter(new SecureAdapter());
+// 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' });
 ```
 
@@ -315,6 +327,8 @@ const storage = defineStorage({
 | Issue | Solution |
 |-------|----------|
 | Framework import fails | Ensure `strata-storage >= 2.5.0` (earlier versions never shipped the built entry points). |
+| TS can't find types for `strata-storage/react` \| `/vue` \| `/angular` \| `/capacitor` \| `/firebase` | Set `"moduleResolution": "bundler"` (or `"nodenext"`) in `tsconfig.json`. The package is ESM-only and exposes typed `exports` subpaths; classic `"node"` resolution can't see them. Modern Vite / Angular / Vue templates already use `bundler`/`nodenext`. |
+| Native adapters do nothing on device | Run `npx cap sync` after install so the native iOS/Android module is wired in, then register the Capacitor adapters (`registerCapacitorAdapters(storage)`). |
 | "does not support synchronous operations" | The targeted adapter is async-only; use the async API or a sync-capable adapter. |
 | Sync set throws on encrypt/compress | Encryption/compression are async — use `await storage.set(...)`. |
 | `useStrata must be used within <StrataProvider>` | Use `createStrataHooks(instance)` for provider-free code. |
@@ -334,6 +348,8 @@ Full documentation lives at **https://stratastorage-docs.aoneahsan.com**:
 - [Changelog](https://stratastorage-docs.aoneahsan.com/reference/changelog)
 - Machine-readable: [`/llms.txt`](https://stratastorage-docs.aoneahsan.com/llms.txt) · [`/llms-full.txt`](https://stratastorage-docs.aoneahsan.com/llms-full.txt)
 
+Project: [npm](https://www.npmjs.com/package/strata-storage) · [GitHub](https://github.com/aoneahsan/strata-storage) · [Report an issue](https://github.com/aoneahsan/strata-storage/issues)
+
 ---
 
 Developed with ❤️ by the **Strata Storage Team** — maintained by [Ahsan Mahmood](https://aoneahsan.com). Questions or integration help: **aoneahsan@gmail.com**.

package/README.md

@@ -390,11 +390,14 @@ const active = await storage.query({
 
 ### iOS and Android (via Capacitor)
 
+Strata ships as a Capacitor plugin (native iOS + Android). In a Capacitor app, after `yarn add strata-storage` run **`npx cap sync`** so the native module is copied into your iOS/Android projects — the native adapters (`secure`, `sqlite`, `preferences`, `filesystem`) won't work on-device without it.
+
 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 {
+  registerCapacitorAdapters,
   PreferencesAdapter,
   SecureAdapter,
   SqliteAdapter,
@@ -402,10 +405,15 @@ import {
 } from 'strata-storage/capacitor';
 
 const storage = defineStorage();
-storage.registerAdapter(new PreferencesAdapter());   // UserDefaults / SharedPreferences
-storage.registerAdapter(new SecureAdapter()); // Keychain / EncryptedSharedPreferences
-storage.registerAdapter(new SqliteAdapter());        // native SQLite
-storage.registerAdapter(new FilesystemAdapter());    // native files
+
+// Easiest: register all native adapters at once (also refreshes the active set).
+await registerCapacitorAdapters(storage);
+
+// …or register individually for fine-grained control / custom adapter config:
+// storage.registerAdapter(new PreferencesAdapter()); // UserDefaults / SharedPreferences
+// storage.registerAdapter(new SecureAdapter());      // Keychain / EncryptedSharedPreferences
+// storage.registerAdapter(new SqliteAdapter());      // native SQLite
+// storage.registerAdapter(new FilesystemAdapter());  // native files
 
 await storage.set('secret', token, { storage: 'secure' });
 ```
@@ -518,26 +526,18 @@ MIT License — see [LICENSE](LICENSE). Free for commercial and non-commercial u
 ## Links
 
 - **NPM Package:** https://www.npmjs.com/package/strata-storage
+- **GitHub Repo:** https://github.com/aoneahsan/strata-storage
 - **Documentation:** https://stratastorage-docs.aoneahsan.com
 - **Website:** https://stratastorage.aoneahsan.com
 
 ## Support
 
-1. Check the [FAQ](https://stratastorage-docs.aoneahsan.com/reference/faq) and [Troubleshooting](https://stratastorage-docs.aoneahsan.com/reference/troubleshooting)
-2. Browse the [documentation](https://stratastorage-docs.aoneahsan.com)
-3. [Contact us / report an issue](https://stratastorage.aoneahsan.com/contact)
+- 🐛 **Found a bug or have a feature request?** [Open a GitHub issue](https://github.com/aoneahsan/strata-storage/issues).
+- 📖 Read the [FAQ](https://stratastorage-docs.aoneahsan.com/reference/faq) and [Troubleshooting](https://stratastorage-docs.aoneahsan.com/reference/troubleshooting), or browse the full [documentation](https://stratastorage-docs.aoneahsan.com).
+- 💬 Anything else? [Contact us](https://stratastorage.aoneahsan.com/contact).
 
 ---
 
 Developed with ❤️ by the **Strata Storage Team** — maintained by [Ahsan Mahmood](https://aoneahsan.com) · aoneahsan@gmail.com.
 
 **One API. Every Storage. Everywhere.**
-
-<!-- project-links:start -->
-## Links
-
-- Live: https://www.npmjs.com/package/strata-storage
-- NPM: https://www.npmjs.com/package/strata-storage
-
-_URL source of truth: `01-code/projects/project-live-urls.json` (auto-generated — do not hand-edit between these markers)._
-<!-- project-links:end -->

package/dist/README.md

@@ -390,11 +390,14 @@ const active = await storage.query({
 
 ### iOS and Android (via Capacitor)
 
+Strata ships as a Capacitor plugin (native iOS + Android). In a Capacitor app, after `yarn add strata-storage` run **`npx cap sync`** so the native module is copied into your iOS/Android projects — the native adapters (`secure`, `sqlite`, `preferences`, `filesystem`) won't work on-device without it.
+
 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 {
+  registerCapacitorAdapters,
   PreferencesAdapter,
   SecureAdapter,
   SqliteAdapter,
@@ -402,10 +405,15 @@ import {
 } from 'strata-storage/capacitor';
 
 const storage = defineStorage();
-storage.registerAdapter(new PreferencesAdapter());   // UserDefaults / SharedPreferences
-storage.registerAdapter(new SecureAdapter()); // Keychain / EncryptedSharedPreferences
-storage.registerAdapter(new SqliteAdapter());        // native SQLite
-storage.registerAdapter(new FilesystemAdapter());    // native files
+
+// Easiest: register all native adapters at once (also refreshes the active set).
+await registerCapacitorAdapters(storage);
+
+// …or register individually for fine-grained control / custom adapter config:
+// storage.registerAdapter(new PreferencesAdapter()); // UserDefaults / SharedPreferences
+// storage.registerAdapter(new SecureAdapter());      // Keychain / EncryptedSharedPreferences
+// storage.registerAdapter(new SqliteAdapter());      // native SQLite
+// storage.registerAdapter(new FilesystemAdapter());  // native files
 
 await storage.set('secret', token, { storage: 'secure' });
 ```
@@ -518,26 +526,18 @@ MIT License — see [LICENSE](LICENSE). Free for commercial and non-commercial u
 ## Links
 
 - **NPM Package:** https://www.npmjs.com/package/strata-storage
+- **GitHub Repo:** https://github.com/aoneahsan/strata-storage
 - **Documentation:** https://stratastorage-docs.aoneahsan.com
 - **Website:** https://stratastorage.aoneahsan.com
 
 ## Support
 
-1. Check the [FAQ](https://stratastorage-docs.aoneahsan.com/reference/faq) and [Troubleshooting](https://stratastorage-docs.aoneahsan.com/reference/troubleshooting)
-2. Browse the [documentation](https://stratastorage-docs.aoneahsan.com)
-3. [Contact us / report an issue](https://stratastorage.aoneahsan.com/contact)
+- 🐛 **Found a bug or have a feature request?** [Open a GitHub issue](https://github.com/aoneahsan/strata-storage/issues).
+- 📖 Read the [FAQ](https://stratastorage-docs.aoneahsan.com/reference/faq) and [Troubleshooting](https://stratastorage-docs.aoneahsan.com/reference/troubleshooting), or browse the full [documentation](https://stratastorage-docs.aoneahsan.com).
+- 💬 Anything else? [Contact us](https://stratastorage.aoneahsan.com/contact).
 
 ---
 
 Developed with ❤️ by the **Strata Storage Team** — maintained by [Ahsan Mahmood](https://aoneahsan.com) · aoneahsan@gmail.com.
 
 **One API. Every Storage. Everywhere.**
-
-<!-- project-links:start -->
-## Links
-
-- Live: https://www.npmjs.com/package/strata-storage
-- NPM: https://www.npmjs.com/package/strata-storage
-
-_URL source of truth: `01-code/projects/project-live-urls.json` (auto-generated — do not hand-edit between these markers)._
-<!-- project-links:end -->

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strata-storage",
-  "version": "2.8.0",
+  "version": "2.8.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",
@@ -43,7 +43,7 @@
     "url": "https://github.com/aoneahsan/strata-storage.git"
   },
   "bugs": {
-    "url": "https://stratastorage.aoneahsan.com/contact",
+    "url": "https://github.com/aoneahsan/strata-storage/issues",
     "email": "aoneahsan@gmail.com"
   },
   "homepage": "https://stratastorage.aoneahsan.com",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strata-storage",
-  "version": "2.8.0",
+  "version": "2.8.1",
   "description": "Zero-dependency universal storage plugin providing a unified API for all storage operations across web, Android, and iOS platforms",
   "type": "module",
   "packageManager": "yarn@4.17.0",
@@ -87,7 +87,7 @@
     "url": "https://github.com/aoneahsan/strata-storage.git"
   },
   "bugs": {
-    "url": "https://stratastorage.aoneahsan.com/contact",
+    "url": "https://github.com/aoneahsan/strata-storage/issues",
     "email": "aoneahsan@gmail.com"
   },
   "homepage": "https://stratastorage.aoneahsan.com",