strata-storage 2.8.2 → 2.8.3

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.8.2**.
+Quick reference for AI development agents (Claude Code, Cursor, Copilot, etc.) to integrate `strata-storage` into web and mobile projects. Current version: **2.8.3**.
 
 ## 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

@@ -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://stratastorage.aoneahsan.com)
 
-- **Version:** `2.8.2`
+- **Version:** `2.8.3`
 - **License:** MIT
 - **Node.js:** `>= 24.13.0`
 - **Module format:** ESM only
@@ -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' });
 ```
@@ -478,11 +486,11 @@ Optional peer dependencies (install only the ones you use): `react >= 19.2.3`, `
 
 ## Documentation
 
-📚 **Full documentation: [stratastorage-docs.aoneahsan.com](https://stratastorage-docs.aoneahsan.com)**
-🤖 **For AI agents: [stratastorage-docs.aoneahsan.com/ai](https://stratastorage-docs.aoneahsan.com/ai)** (plus [`/llms.txt`](https://stratastorage-docs.aoneahsan.com/llms.txt) and [`/llms-full.txt`](https://stratastorage-docs.aoneahsan.com/llms-full.txt))
+📚 **Docs:** [stratastorage-docs.aoneahsan.com](https://stratastorage-docs.aoneahsan.com) · site source in [aoneahsan/strata-storage-docs](https://github.com/aoneahsan/strata-storage-docs)
+🤖 **For AI agents:** [`AI-INTEGRATION-GUIDE.md`](./AI-INTEGRATION-GUIDE.md) · hosted [/ai](https://stratastorage-docs.aoneahsan.com/ai) · [`/llms.txt`](https://stratastorage-docs.aoneahsan.com/llms.txt)
 
 ### Getting Started
-- [Installation](https://stratastorage-docs.aoneahsan.com/installation) · [Quick Start](https://stratastorage-docs.aoneahsan.com/quick-start) · [Configuration](https://stratastorage-docs.aoneahsan.com/configuration)
+- [Introduction](https://stratastorage-docs.aoneahsan.com/) · [Installation](https://stratastorage-docs.aoneahsan.com/installation) · [Quick Start](https://stratastorage-docs.aoneahsan.com/quick-start) · [Configuration](https://stratastorage-docs.aoneahsan.com/configuration)
 
 ### API
 - [API Reference](https://stratastorage-docs.aoneahsan.com/api) · [Core (`Strata`)](https://stratastorage-docs.aoneahsan.com/api/core/strata) · [Types](https://stratastorage-docs.aoneahsan.com/api/core/types) · [Errors](https://stratastorage-docs.aoneahsan.com/api/core/errors)
@@ -499,7 +507,7 @@ Optional peer dependencies (install only the ones you use): `react >= 19.2.3`, `
 
 ## Contributing
 
-Contributions are welcome — please read the [Contributing Guide](./.github/CONTRIBUTING.md).
+Contributions are welcome — please read the [Contributing Guide](./CONTRIBUTING.md). `main` is protected: changes land through an approved pull request (the maintainer is the only direct-push), and you can [request contributor access](./CONTRIBUTING.md#becoming-a-contributor) if you'd like to help regularly.
 
 ## License
 
@@ -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

@@ -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://stratastorage.aoneahsan.com)
 
-- **Version:** `2.8.2`
+- **Version:** `2.8.3`
 - **License:** MIT
 - **Node.js:** `>= 24.13.0`
 - **Module format:** ESM only
@@ -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' });
 ```
@@ -478,11 +486,11 @@ Optional peer dependencies (install only the ones you use): `react >= 19.2.3`, `
 
 ## Documentation
 
-📚 **Full documentation: [stratastorage-docs.aoneahsan.com](https://stratastorage-docs.aoneahsan.com)**
-🤖 **For AI agents: [stratastorage-docs.aoneahsan.com/ai](https://stratastorage-docs.aoneahsan.com/ai)** (plus [`/llms.txt`](https://stratastorage-docs.aoneahsan.com/llms.txt) and [`/llms-full.txt`](https://stratastorage-docs.aoneahsan.com/llms-full.txt))
+📚 **Docs:** [stratastorage-docs.aoneahsan.com](https://stratastorage-docs.aoneahsan.com) · site source in [aoneahsan/strata-storage-docs](https://github.com/aoneahsan/strata-storage-docs)
+🤖 **For AI agents:** [`AI-INTEGRATION-GUIDE.md`](./AI-INTEGRATION-GUIDE.md) · hosted [/ai](https://stratastorage-docs.aoneahsan.com/ai) · [`/llms.txt`](https://stratastorage-docs.aoneahsan.com/llms.txt)
 
 ### Getting Started
-- [Installation](https://stratastorage-docs.aoneahsan.com/installation) · [Quick Start](https://stratastorage-docs.aoneahsan.com/quick-start) · [Configuration](https://stratastorage-docs.aoneahsan.com/configuration)
+- [Introduction](https://stratastorage-docs.aoneahsan.com/) · [Installation](https://stratastorage-docs.aoneahsan.com/installation) · [Quick Start](https://stratastorage-docs.aoneahsan.com/quick-start) · [Configuration](https://stratastorage-docs.aoneahsan.com/configuration)
 
 ### API
 - [API Reference](https://stratastorage-docs.aoneahsan.com/api) · [Core (`Strata`)](https://stratastorage-docs.aoneahsan.com/api/core/strata) · [Types](https://stratastorage-docs.aoneahsan.com/api/core/types) · [Errors](https://stratastorage-docs.aoneahsan.com/api/core/errors)
@@ -499,7 +507,7 @@ Optional peer dependencies (install only the ones you use): `react >= 19.2.3`, `
 
 ## Contributing
 
-Contributions are welcome — please read the [Contributing Guide](./.github/CONTRIBUTING.md).
+Contributions are welcome — please read the [Contributing Guide](./CONTRIBUTING.md). `main` is protected: changes land through an approved pull request (the maintainer is the only direct-push), and you can [request contributor access](./CONTRIBUTING.md#becoming-a-contributor) if you'd like to help regularly.
 
 ## License
 
@@ -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.2",
+  "version": "2.8.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",
@@ -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.2",
+  "version": "2.8.3",
   "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",