strata-storage 2.7.1 → 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.0**.
+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. |
@@ -333,3 +347,9 @@ Full documentation lives at **https://stratastorage-docs.aoneahsan.com**:
 - [Recovery & Integrity](https://stratastorage-docs.aoneahsan.com/api/features/recovery)
 - [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/LICENSE

@@ -1,35 +1,21 @@
-Copyright 2024 Ahsan Mahmood
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-
-================================================================================
-
-Full Apache License 2.0 text: https://www.apache.org/licenses/LICENSE-2.0.txt
-
-================================================================================
-
-Additional Terms:
-
-1. Attribution Requirement:
-   You must retain all copyright notices and this license in any distribution.
-
-2. Contribution Agreement:
-   Any contributions submitted for inclusion shall be under the same license.
-
-3. Name and Trademark:
-   "Strata Storage" name may not be used for derivative works without permission.
-
-4. Patent Grant:
-   This license includes express patent grants from contributors.
-
-For the complete license terms and plain English explanation, see LICENSE.md
+MIT License
+
+Copyright (c) 2024-2026 Ahsan Mahmood
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -5,12 +5,12 @@
 - **[AI Integration Guide](./AI-INTEGRATION-GUIDE.md)** — quick reference for AI development agents (Claude Code, Cursor, Copilot).
 
 [![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)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![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.7.1`
-- **License:** Apache-2.0
+- **Version:** `2.8.0`
+- **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,24 +486,24 @@ 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:** 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)
 
 ### 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](./docs/intro.md) · [Installation](./docs/installation.md) · [Quick Start](./docs/quick-start.md) · [Configuration](./docs/configuration.md)
 
 ### 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)
-- [All adapters](https://stratastorage-docs.aoneahsan.com/api/adapters) — web (localStorage, IndexedDB, cookies, Cache, URL, …) + Capacitor (Preferences, Secure, SQLite, Filesystem) + remote (Firebase)
+- [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)
 
 ### Features
-- [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)
+- [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)
 
 ### Platforms
-- [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)
+- [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)
 
 ### Examples & Reference
-- [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)
+- [Examples](./docs/examples/README.md) · [Changelog](./docs/reference/changelog.md) · [FAQ](./docs/reference/faq.md) · [Troubleshooting](./docs/reference/troubleshooting.md) · [Migration](./docs/migration.md)
 
 ## Contributing
 
@@ -503,7 +511,7 @@ Contributions are welcome — please read the [Contributing Guide](./.github/CON
 
 ## License
 
-Apache License 2.0 — see [LICENSE](LICENSE). Free for commercial use, modification, and distribution with patent protection; attribution required; provided without warranty.
+MIT License — see [LICENSE](LICENSE). Free for commercial and non-commercial use, modification, distribution, and sublicensing; the only condition is keeping the copyright and license notice; provided without warranty.
 
 ## Author
 
@@ -518,24 +526,18 @@ Apache License 2.0 — see [LICENSE](LICENSE). Free for commercial use, modifica
 ## 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).
 
 ---
 
-Made by [Ahsan Mahmood](https://aoneahsan.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
+Developed with ❤️ by the **Strata Storage Team** — maintained by [Ahsan Mahmood](https://aoneahsan.com) · aoneahsan@gmail.com.
 
-_URL source of truth: `01-code/projects/project-live-urls.json` (auto-generated — do not hand-edit between these markers)._
-<!-- project-links:end -->
+**One API. Every Storage. Everywhere.**

package/dist/LICENSE

@@ -1,35 +1,21 @@
-Copyright 2024 Ahsan Mahmood
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-
-================================================================================
-
-Full Apache License 2.0 text: https://www.apache.org/licenses/LICENSE-2.0.txt
-
-================================================================================
-
-Additional Terms:
-
-1. Attribution Requirement:
-   You must retain all copyright notices and this license in any distribution.
-
-2. Contribution Agreement:
-   Any contributions submitted for inclusion shall be under the same license.
-
-3. Name and Trademark:
-   "Strata Storage" name may not be used for derivative works without permission.
-
-4. Patent Grant:
-   This license includes express patent grants from contributors.
-
-For the complete license terms and plain English explanation, see LICENSE.md
+MIT License
+
+Copyright (c) 2024-2026 Ahsan Mahmood
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/README.md

@@ -5,12 +5,12 @@
 - **[AI Integration Guide](./AI-INTEGRATION-GUIDE.md)** — quick reference for AI development agents (Claude Code, Cursor, Copilot).
 
 [![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)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![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.7.1`
-- **License:** Apache-2.0
+- **Version:** `2.8.0`
+- **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,24 +486,24 @@ 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:** 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)
 
 ### 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](./docs/intro.md) · [Installation](./docs/installation.md) · [Quick Start](./docs/quick-start.md) · [Configuration](./docs/configuration.md)
 
 ### 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)
-- [All adapters](https://stratastorage-docs.aoneahsan.com/api/adapters) — web (localStorage, IndexedDB, cookies, Cache, URL, …) + Capacitor (Preferences, Secure, SQLite, Filesystem) + remote (Firebase)
+- [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)
 
 ### Features
-- [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)
+- [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)
 
 ### Platforms
-- [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)
+- [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)
 
 ### Examples & Reference
-- [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)
+- [Examples](./docs/examples/README.md) · [Changelog](./docs/reference/changelog.md) · [FAQ](./docs/reference/faq.md) · [Troubleshooting](./docs/reference/troubleshooting.md) · [Migration](./docs/migration.md)
 
 ## Contributing
 
@@ -503,7 +511,7 @@ Contributions are welcome — please read the [Contributing Guide](./.github/CON
 
 ## License
 
-Apache License 2.0 — see [LICENSE](LICENSE). Free for commercial use, modification, and distribution with patent protection; attribution required; provided without warranty.
+MIT License — see [LICENSE](LICENSE). Free for commercial and non-commercial use, modification, distribution, and sublicensing; the only condition is keeping the copyright and license notice; provided without warranty.
 
 ## Author
 
@@ -518,24 +526,18 @@ Apache License 2.0 — see [LICENSE](LICENSE). Free for commercial use, modifica
 ## 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).
 
 ---
 
-Made by [Ahsan Mahmood](https://aoneahsan.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
+Developed with ❤️ by the **Strata Storage Team** — maintained by [Ahsan Mahmood](https://aoneahsan.com) · aoneahsan@gmail.com.
 
-_URL source of truth: `01-code/projects/project-live-urls.json` (auto-generated — do not hand-edit between these markers)._
-<!-- project-links:end -->
+**One API. Every Storage. Everywhere.**

package/dist/adapters/capacitor/FilesystemAdapter.d.ts

@@ -43,4 +43,3 @@ export declare class FilesystemAdapter extends BaseAdapter {
      */
     size(detailed?: boolean): Promise<SizeInfo>;
 }
-//# sourceMappingURL=FilesystemAdapter.d.ts.map

package/dist/adapters/capacitor/PreferencesAdapter.d.ts

@@ -43,4 +43,3 @@ export declare class PreferencesAdapter extends BaseAdapter {
      */
     size(detailed?: boolean): Promise<SizeInfo>;
 }
-//# sourceMappingURL=PreferencesAdapter.d.ts.map

package/dist/adapters/capacitor/SecureAdapter.d.ts

@@ -66,4 +66,3 @@ export declare class SecureAdapter extends BaseAdapter {
      */
     getEncryptedPreference(key: string, fileName?: string): Promise<unknown>;
 }
-//# sourceMappingURL=SecureAdapter.d.ts.map

package/dist/adapters/capacitor/SqliteAdapter.d.ts

@@ -86,4 +86,3 @@ export declare class SqliteAdapter extends BaseAdapter {
      */
     transaction(): Promise<Transaction>;
 }
-//# sourceMappingURL=SqliteAdapter.d.ts.map

package/dist/adapters/capacitor/index.d.ts

@@ -6,4 +6,3 @@ export { PreferencesAdapter } from "./PreferencesAdapter.js";
 export { SqliteAdapter } from "./SqliteAdapter.js";
 export { SecureAdapter } from "./SecureAdapter.js";
 export { FilesystemAdapter } from "./FilesystemAdapter.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/adapters/web/CacheAdapter.d.ts

@@ -88,4 +88,3 @@ export declare class CacheAdapter extends BaseAdapter {
      */
     private isQuotaError;
 }
-//# sourceMappingURL=CacheAdapter.d.ts.map

package/dist/adapters/web/CookieAdapter.d.ts

@@ -110,4 +110,3 @@ export declare class CookieAdapter extends BaseAdapter {
     private getAllCookies;
 }
 export {};
-//# sourceMappingURL=CookieAdapter.d.ts.map

package/dist/adapters/web/IndexedDBAdapter.d.ts

@@ -82,4 +82,3 @@ export declare class IndexedDBAdapter extends BaseAdapter {
      */
     private isQuotaError;
 }
-//# sourceMappingURL=IndexedDBAdapter.d.ts.map

package/dist/adapters/web/LocalStorageAdapter.d.ts

@@ -91,4 +91,3 @@ export declare class LocalStorageAdapter extends BaseAdapter {
      */
     protected isQuotaError(error: unknown): boolean;
 }
-//# sourceMappingURL=LocalStorageAdapter.d.ts.map

package/dist/adapters/web/MemoryAdapter.d.ts

@@ -97,4 +97,3 @@ export declare class MemoryAdapter extends BaseAdapter {
      */
     close(): Promise<void>;
 }
-//# sourceMappingURL=MemoryAdapter.d.ts.map

package/dist/adapters/web/SessionStorageAdapter.d.ts

@@ -74,4 +74,3 @@ export declare class SessionStorageAdapter extends LocalStorageAdapter {
      */
     subscribe(callback: import("../../types/index.js").SubscriptionCallback): import("../../types/index.js").UnsubscribeFunction;
 }
-//# sourceMappingURL=SessionStorageAdapter.d.ts.map

package/dist/adapters/web/URLAdapter.d.ts

@@ -56,4 +56,3 @@ export declare class URLAdapter extends BaseAdapter {
     private snapshotParams;
     private handleExternalChange;
 }
-//# sourceMappingURL=URLAdapter.d.ts.map

package/dist/adapters/web/index.d.ts

@@ -8,4 +8,3 @@ export { IndexedDBAdapter } from "./IndexedDBAdapter.js";
 export { CookieAdapter } from "./CookieAdapter.js";
 export { CacheAdapter } from "./CacheAdapter.js";
 export { URLAdapter, type URLAdapterConfig } from "./URLAdapter.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/capacitor.d.ts

@@ -17,4 +17,3 @@ export declare function isCapacitorEnvironment(): boolean;
  * Get Capacitor-specific storage types
  */
 export declare function getCapacitorStorageTypes(): string[];
-//# sourceMappingURL=capacitor.d.ts.map

package/dist/config/support.d.ts

@@ -7,4 +7,3 @@ export declare const SUPPORT_CONFIG: {
     readonly label: "Support the Project";
     readonly description: "Help us keep strata-storage free and improving";
 };
-//# sourceMappingURL=support.d.ts.map

package/dist/core/AdapterRegistry.d.ts

@@ -49,4 +49,3 @@ export declare class AdapterRegistry {
      */
     closeAll(): Promise<void>;
 }
-//# sourceMappingURL=AdapterRegistry.d.ts.map

package/dist/core/BaseAdapter.d.ts

@@ -100,4 +100,3 @@ export declare abstract class BaseAdapter implements StorageAdapter {
     abstract remove(key: string): Promise<void>;
     abstract keys(pattern?: string | RegExp): Promise<string[]>;
 }
-//# sourceMappingURL=BaseAdapter.d.ts.map

package/dist/core/Strata.d.ts

@@ -375,4 +375,3 @@ export declare class Strata {
     private startAutoBackup;
     private selectAdapter;
 }
-//# sourceMappingURL=Strata.d.ts.map

package/dist/features/compression/index.d.ts

@@ -1,2 +1 @@
 export * from "../compression.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/features/compression.d.ts

@@ -81,4 +81,3 @@ export declare class CompressionManager {
      */
     getSavingsPercentage(compressedData: CompressedData): number;
 }
-//# sourceMappingURL=compression.d.ts.map

package/dist/features/encryption/index.d.ts

@@ -1,2 +1 @@
 export * from "../encryption.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/features/encryption.d.ts

@@ -118,4 +118,3 @@ export declare class EncryptionManager {
      */
     hash(data: string): Promise<string>;
 }
-//# sourceMappingURL=encryption.d.ts.map

package/dist/features/integrity.d.ts

@@ -13,4 +13,3 @@ export declare function computeChecksum(value: unknown): string;
  * stored (nothing to verify) so this is safe to call unconditionally.
  */
 export declare function verifyChecksum(value: unknown, expected: string | undefined): boolean;
-//# sourceMappingURL=integrity.d.ts.map

package/dist/features/migration.d.ts

@@ -14,4 +14,3 @@ export declare class MigrationManager {
     private getCurrentVersion;
     private setVersion;
 }
-//# sourceMappingURL=migration.d.ts.map

package/dist/features/observer/index.d.ts

@@ -1,2 +1 @@
 export * from "../observer.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/features/observer.d.ts

@@ -17,4 +17,3 @@ export declare class StorageObserver {
      */
     clear(): void;
 }
-//# sourceMappingURL=observer.d.ts.map

package/dist/features/query/index.d.ts

@@ -1,2 +1 @@
 export * from "../query.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/features/query.d.ts

@@ -79,4 +79,3 @@ export declare class QueryEngine {
  * Create a query engine instance
  */
 export declare function createQueryEngine(): QueryEngine;
-//# sourceMappingURL=query.d.ts.map

package/dist/features/sync/index.d.ts

@@ -1,2 +1 @@
 export * from "../sync.js";
-//# sourceMappingURL=index.d.ts.map