npm - strata-storage - Versions diffs - 2.8.1 → 2.8.2 - Mend

strata-storage 2.8.1 → 2.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/AI-INTEGRATION-GUIDE.md CHANGED Viewed

@@ -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.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.2**.
 ## Installation
@@ -209,16 +209,9 @@ 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,
@@ -226,15 +219,10 @@ import {
 } from 'strata-storage/capacitor';
 const storage = defineStorage();
-// 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
+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
 await storage.set('secret', token, { storage: 'secure' });
 ```
@@ -327,8 +315,6 @@ 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. |
@@ -348,8 +334,6 @@ 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 CHANGED Viewed

@@ -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.0`
+- **Version:** `2.8.2`
 - **License:** MIT
 - **Node.js:** `>= 24.13.0`
 - **Module format:** ESM only
@@ -390,14 +390,11 @@ 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,
@@ -405,15 +402,10 @@ import {
 } from 'strata-storage/capacitor';
 const storage = defineStorage();
-// 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
+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' });
 ```
@@ -486,24 +478,24 @@ Optional peer dependencies (install only the ones you use): `react >= 19.2.3`, `
 ## Documentation
-📚 **Docs:** browse in-repo in [`./docs`](./docs/intro.md) · hosted at [stratastorage-docs.aoneahsan.com](https://stratastorage-docs.aoneahsan.com)
-🤖 **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)
+📚 **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))
 ### Getting Started
-- [Introduction](./docs/intro.md) · [Installation](./docs/installation.md) · [Quick Start](./docs/quick-start.md) · [Configuration](./docs/configuration.md)
+- [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](./docs/api/README.md) · [Core (`Strata`)](./docs/api/core/strata.md) · [Types](./docs/api/core/types.md) · [Errors](./docs/api/core/errors.md)
-- [All adapters](./docs/api/adapters/README.md) — web (localStorage, IndexedDB, cookies, Cache, URL, …) + Capacitor (Preferences, Secure, SQLite, Filesystem) + remote (Firebase)
+- [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)
+- [All adapters](https://stratastorage-docs.aoneahsan.com/api/adapters) — web (localStorage, IndexedDB, cookies, Cache, URL, …) + Capacitor (Preferences, Secure, SQLite, Filesystem) + remote (Firebase)
 ### Features
-- [Encryption](./docs/guides/features/encryption.md) · [Compression](./docs/guides/features/compression.md) · [TTL](./docs/api/features/ttl.md) · [Sync](./docs/guides/features/sync.md) · [Queries](./docs/guides/features/queries.md) · [Migrations](./docs/guides/features/migrations.md) · [Recovery & Integrity](./docs/api/features/recovery.md)
+- [Encryption](https://stratastorage-docs.aoneahsan.com/guides/features/encryption) · [Compression](https://stratastorage-docs.aoneahsan.com/guides/features/compression) · [TTL](https://stratastorage-docs.aoneahsan.com/api/features/ttl) · [Sync](https://stratastorage-docs.aoneahsan.com/guides/features/sync) · [Queries](https://stratastorage-docs.aoneahsan.com/guides/features/queries) · [Migrations](https://stratastorage-docs.aoneahsan.com/guides/features/migrations) · [Recovery & Integrity](https://stratastorage-docs.aoneahsan.com/api/features/recovery)
 ### Platforms
-- [Web](./docs/guides/platforms/web.md) · [iOS](./docs/guides/platforms/ios.md) · [Android](./docs/guides/platforms/android.md) · [Capacitor](./docs/guides/platforms/capacitor.md) · [Firebase](./docs/guides/platforms/firebase.md)
+- [Web](https://stratastorage-docs.aoneahsan.com/guides/platforms/web) · [iOS](https://stratastorage-docs.aoneahsan.com/guides/platforms/ios) · [Android](https://stratastorage-docs.aoneahsan.com/guides/platforms/android) · [Capacitor](https://stratastorage-docs.aoneahsan.com/guides/platforms/capacitor) · [Firebase](https://stratastorage-docs.aoneahsan.com/guides/platforms/firebase)
 ### Examples & Reference
-- [Examples](./docs/examples/README.md) · [Changelog](./docs/reference/changelog.md) · [FAQ](./docs/reference/faq.md) · [Troubleshooting](./docs/reference/troubleshooting.md) · [Migration](./docs/migration.md)
+- [Examples](https://stratastorage-docs.aoneahsan.com/examples) · [Changelog](https://stratastorage-docs.aoneahsan.com/reference/changelog) · [FAQ](https://stratastorage-docs.aoneahsan.com/reference/faq) · [Troubleshooting](https://stratastorage-docs.aoneahsan.com/reference/troubleshooting) · [Migration](https://stratastorage-docs.aoneahsan.com/migration)
 ## Contributing
@@ -526,18 +518,26 @@ 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
-- 🐛 **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).
+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)
 ---
 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 CHANGED Viewed

@@ -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.0`
+- **Version:** `2.8.2`
 - **License:** MIT
 - **Node.js:** `>= 24.13.0`
 - **Module format:** ESM only
@@ -390,14 +390,11 @@ 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,
@@ -405,15 +402,10 @@ import {
 } from 'strata-storage/capacitor';
 const storage = defineStorage();
-// 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
+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' });
 ```
@@ -486,24 +478,24 @@ Optional peer dependencies (install only the ones you use): `react >= 19.2.3`, `
 ## Documentation
-📚 **Docs:** browse in-repo in [`./docs`](./docs/intro.md) · hosted at [stratastorage-docs.aoneahsan.com](https://stratastorage-docs.aoneahsan.com)
-🤖 **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)
+📚 **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))
 ### Getting Started
-- [Introduction](./docs/intro.md) · [Installation](./docs/installation.md) · [Quick Start](./docs/quick-start.md) · [Configuration](./docs/configuration.md)
+- [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](./docs/api/README.md) · [Core (`Strata`)](./docs/api/core/strata.md) · [Types](./docs/api/core/types.md) · [Errors](./docs/api/core/errors.md)
-- [All adapters](./docs/api/adapters/README.md) — web (localStorage, IndexedDB, cookies, Cache, URL, …) + Capacitor (Preferences, Secure, SQLite, Filesystem) + remote (Firebase)
+- [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)
+- [All adapters](https://stratastorage-docs.aoneahsan.com/api/adapters) — web (localStorage, IndexedDB, cookies, Cache, URL, …) + Capacitor (Preferences, Secure, SQLite, Filesystem) + remote (Firebase)
 ### Features
-- [Encryption](./docs/guides/features/encryption.md) · [Compression](./docs/guides/features/compression.md) · [TTL](./docs/api/features/ttl.md) · [Sync](./docs/guides/features/sync.md) · [Queries](./docs/guides/features/queries.md) · [Migrations](./docs/guides/features/migrations.md) · [Recovery & Integrity](./docs/api/features/recovery.md)
+- [Encryption](https://stratastorage-docs.aoneahsan.com/guides/features/encryption) · [Compression](https://stratastorage-docs.aoneahsan.com/guides/features/compression) · [TTL](https://stratastorage-docs.aoneahsan.com/api/features/ttl) · [Sync](https://stratastorage-docs.aoneahsan.com/guides/features/sync) · [Queries](https://stratastorage-docs.aoneahsan.com/guides/features/queries) · [Migrations](https://stratastorage-docs.aoneahsan.com/guides/features/migrations) · [Recovery & Integrity](https://stratastorage-docs.aoneahsan.com/api/features/recovery)
 ### Platforms
-- [Web](./docs/guides/platforms/web.md) · [iOS](./docs/guides/platforms/ios.md) · [Android](./docs/guides/platforms/android.md) · [Capacitor](./docs/guides/platforms/capacitor.md) · [Firebase](./docs/guides/platforms/firebase.md)
+- [Web](https://stratastorage-docs.aoneahsan.com/guides/platforms/web) · [iOS](https://stratastorage-docs.aoneahsan.com/guides/platforms/ios) · [Android](https://stratastorage-docs.aoneahsan.com/guides/platforms/android) · [Capacitor](https://stratastorage-docs.aoneahsan.com/guides/platforms/capacitor) · [Firebase](https://stratastorage-docs.aoneahsan.com/guides/platforms/firebase)
 ### Examples & Reference
-- [Examples](./docs/examples/README.md) · [Changelog](./docs/reference/changelog.md) · [FAQ](./docs/reference/faq.md) · [Troubleshooting](./docs/reference/troubleshooting.md) · [Migration](./docs/migration.md)
+- [Examples](https://stratastorage-docs.aoneahsan.com/examples) · [Changelog](https://stratastorage-docs.aoneahsan.com/reference/changelog) · [FAQ](https://stratastorage-docs.aoneahsan.com/reference/faq) · [Troubleshooting](https://stratastorage-docs.aoneahsan.com/reference/troubleshooting) · [Migration](https://stratastorage-docs.aoneahsan.com/migration)
 ## Contributing
@@ -526,18 +518,26 @@ 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
-- 🐛 **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).
+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)
 ---
 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 CHANGED Viewed

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

package/package.json CHANGED Viewed

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