strata-storage 2.6.1 → 2.7.0

package/dist/README.md

@@ -7,9 +7,9 @@
 [![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)
 [![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)
+[![Platform](https://img.shields.io/badge/platform-Web%20%7C%20iOS%20%7C%20Android-lightgrey.svg)](https://stratastorage.aoneahsan.com)
 
-- **Version:** `2.6.1`
+- **Version:** `2.7.0`
 - **License:** Apache-2.0
 - **Node.js:** `>= 24.13.0`
 - **Module format:** ESM only
@@ -71,7 +71,7 @@ await storage.set('token', '...', { encrypt: true });
 
 ## Provider-Free Usage
 
-The recommended pattern across all frameworks: create one instance and bind to it. No Provider, plugin, or module is required. The Provider-based styles remain available and are documented in [docs/examples/frameworks](./docs/examples/frameworks).
+The recommended pattern across all frameworks: create one instance and bind to it. No Provider, plugin, or module is required. The Provider-based styles remain available and are documented in the [examples](https://stratastorage-docs.aoneahsan.com/examples).
 
 ### Vanilla JavaScript / TypeScript
 
@@ -396,14 +396,14 @@ Register the native adapters you need when running under Capacitor. All four are
 import { defineStorage } from 'strata-storage';
 import {
   PreferencesAdapter,
-  SecureStorageAdapter,
+  SecureAdapter,
   SqliteAdapter,
   FilesystemAdapter,
 } from 'strata-storage/capacitor';
 
 const storage = defineStorage();
 storage.registerAdapter(new PreferencesAdapter());   // UserDefaults / SharedPreferences
-storage.registerAdapter(new SecureStorageAdapter()); // Keychain / EncryptedSharedPreferences
+storage.registerAdapter(new SecureAdapter()); // Keychain / EncryptedSharedPreferences
 storage.registerAdapter(new SqliteAdapter());        // native SQLite
 storage.registerAdapter(new FilesystemAdapter());    // native files
 
@@ -432,7 +432,7 @@ audit.registerAdapter(new SqliteAdapter({ database: 'audit', table: 'rows' }));
 
 `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.
+> **Honest note:** the native iOS/Android adapters depend on your downstream Capacitor project setup and platform configuration, and native behavior cannot be exercised in a web/Node environment. Follow the [device-verification guide](https://stratastorage-docs.aoneahsan.com/guides/platforms/device-verification) to verify on a real iOS and Android device after integrating.
 
 ### Firebase (optional cloud sync)
 
@@ -441,7 +441,12 @@ import { defineStorage } from 'strata-storage';
 import { enableFirebaseSync } from 'strata-storage/firebase';
 
 const storage = defineStorage();
-await enableFirebaseSync(storage, { apiKey: '…', projectId: '…', firestore: true });
+await enableFirebaseSync(storage, {
+  apiKey: '…', authDomain: '…', projectId: '…', appId: '…',
+  firestore: true,
+});
+// 'firestore' / 'realtime' are runtime adapter names (not in the StorageType
+// union, so strict TS may need a cast on the options object).
 await storage.set('data', value, { storage: 'firestore' });
 ```
 
@@ -473,59 +478,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))
+
 ### Getting Started
-- [Installation](./docs/getting-started/installation.md) — install and set up
-- [Quick Start](./docs/getting-started/quick-start.md) — running in minutes
-- [Configuration](./docs/getting-started/configuration.md) — configuration options
-
-### Core
-- [API Reference](./docs/api/README.md) — complete API
-- [Core API (`Strata`)](./docs/api/core/strata.md) — the main class
-- [Type Definitions](./docs/api/core/types.md) — TypeScript types
-- [Error Handling](./docs/api/core/errors.md) — error classes
-
-### Storage Adapters
-- [Web Adapters](./docs/api/adapters/README.md#web-adapters)
-  - [localStorage](./docs/api/adapters/web/localstorage.md)
-  - [sessionStorage](./docs/api/adapters/web/sessionstorage.md)
-  - [IndexedDB](./docs/api/adapters/web/indexeddb.md)
-  - [Cookies](./docs/api/adapters/web/cookies.md)
-  - [Cache API](./docs/api/adapters/web/cache.md)
-  - [Memory](./docs/api/adapters/web/memory.md)
-  - [URL](./docs/api/adapters/web/url.md)
-- [Capacitor Adapters](./docs/api/adapters/README.md#capacitor-adapters)
-  - [Preferences](./docs/api/adapters/capacitor/preferences.md)
-  - [Secure Storage](./docs/api/adapters/capacitor/secure.md)
-  - [SQLite](./docs/api/adapters/capacitor/sqlite.md)
-  - [Filesystem](./docs/api/adapters/capacitor/filesystem.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](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 Management](./docs/api/features/ttl.md)
-- [Cross-Tab Sync](./docs/guides/features/sync.md)
-- [Query Engine](./docs/guides/features/queries.md)
-- [Migrations](./docs/guides/features/migrations.md)
-- [Recovery & Integrity](./docs/api/features/recovery.md)
-
-### Platform Guides
-- [Web](./docs/guides/platforms/web.md)
-- [iOS](./docs/guides/platforms/ios.md)
-- [Android](./docs/guides/platforms/android.md)
-- [Capacitor](./docs/guides/platforms/capacitor.md)
-
-### Examples
-- [Basic Usage](./docs/examples/basic-usage.md)
-- [React Integration](./docs/examples/frameworks/react.md)
-- [Vue Integration](./docs/examples/frameworks/vue.md)
-- [Angular Integration](./docs/examples/frameworks/angular.md)
-- [All Examples](./docs/examples/README.md)
-
-### Reference
-- [Changelog](./docs/reference/changelog.md)
-- [FAQ](./docs/reference/faq.md)
-- [Troubleshooting](./docs/reference/troubleshooting.md)
-- [Migration Guide](./docs/MIGRATION.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](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](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
 
@@ -547,17 +517,25 @@ Apache License 2.0 — see [LICENSE](LICENSE). Free for commercial use, modifica
 
 ## Links
 
-- **NPM Package:** [npmjs.com/package/strata-storage](https://www.npmjs.com/package/strata-storage)
-- **GitHub Repository:** [github.com/aoneahsan/strata-storage](https://github.com/aoneahsan/strata-storage)
-- **Issue Tracker:** [github.com/aoneahsan/strata-storage/issues](https://github.com/aoneahsan/strata-storage/issues)
-- **Documentation:** [github.com/aoneahsan/strata-storage/tree/main/docs](https://github.com/aoneahsan/strata-storage/tree/main/docs)
+- **NPM Package:** https://www.npmjs.com/package/strata-storage
+- **Documentation:** https://stratastorage-docs.aoneahsan.com
+- **Website:** https://stratastorage.aoneahsan.com
 
 ## Support
 
-1. Check the [FAQ](./docs/reference/faq.md)
-2. Search [existing issues](https://github.com/aoneahsan/strata-storage/issues)
-3. Open a [new issue](https://github.com/aoneahsan/strata-storage/issues/new)
+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)
 
 ---
 
 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
+
+_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/adapters/capacitor/FilesystemAdapter.d.ts

@@ -2,8 +2,8 @@
  * Filesystem Adapter - Native file system storage
  * Direct file access on iOS and Android
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo } from '@/types';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo } from "../../types/index.js";
 /**
  * Native filesystem adapter using Capacitor plugin
  */

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

@@ -1 +1 @@
-{"version":3,"file":"FilesystemAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/capacitor/FilesystemAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACT,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAgB;IAC1C,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAWrC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAwBpE;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB1E;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlD;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwBxD;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;CAYlD"}
+{"version":3,"file":"FilesystemAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/capacitor/FilesystemAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACT,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAgB;IAC1C,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAWrC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAwBpE;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB1E;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBxC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlD;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwBxD;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;CAYlD"}

package/dist/adapters/capacitor/FilesystemAdapter.js

@@ -71,7 +71,9 @@ export class FilesystemAdapter extends BaseAdapter {
      * Set a value in filesystem
      */
     async set(key, value) {
-        const oldValue = await this.get(key);
+        // Only pay for a read-before-write (a native bridge round-trip) when a
+        // subscriber actually needs the previous value for the change event.
+        const oldValue = this.hasChangeListeners() ? await this.get(key) : null;
         try {
             await StrataStorage.set({
                 key,
@@ -88,7 +90,9 @@ export class FilesystemAdapter extends BaseAdapter {
      * Remove a value from filesystem
      */
     async remove(key) {
-        const oldValue = await this.get(key);
+        // Only pay for a read-before-write (a native bridge round-trip) when a
+        // subscriber actually needs the previous value for the change event.
+        const oldValue = this.hasChangeListeners() ? await this.get(key) : null;
         try {
             await StrataStorage.remove({
                 key,

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

@@ -2,8 +2,8 @@
  * Preferences Adapter - Native preferences storage
  * iOS: UserDefaults, Android: SharedPreferences
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo } from '@/types';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo } from "../../types/index.js";
 /**
  * Native preferences adapter using Capacitor plugin
  */

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

@@ -1 +1 @@
-{"version":3,"file":"PreferencesAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/capacitor/PreferencesAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACT,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAiB;IAC3C,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAWrC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAwBpE;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB1E;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlD;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwBxD;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;CAYlD"}
+{"version":3,"file":"PreferencesAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/capacitor/PreferencesAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACT,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAiB;IAC3C,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAWrC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAwBpE;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB1E;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBxC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlD;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwBxD;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;CAYlD"}

package/dist/adapters/capacitor/PreferencesAdapter.js

@@ -71,7 +71,9 @@ export class PreferencesAdapter extends BaseAdapter {
      * Set a value in preferences
      */
     async set(key, value) {
-        const oldValue = await this.get(key);
+        // Only pay for a read-before-write (a native bridge round-trip) when a
+        // subscriber actually needs the previous value for the change event.
+        const oldValue = this.hasChangeListeners() ? await this.get(key) : null;
         try {
             await StrataStorage.set({
                 key,
@@ -88,7 +90,9 @@ export class PreferencesAdapter extends BaseAdapter {
      * Remove a value from preferences
      */
     async remove(key) {
-        const oldValue = await this.get(key);
+        // Only pay for a read-before-write (a native bridge round-trip) when a
+        // subscriber actually needs the previous value for the change event.
+        const oldValue = this.hasChangeListeners() ? await this.get(key) : null;
         try {
             await StrataStorage.remove({
                 key,

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

@@ -2,8 +2,8 @@
  * Secure Adapter - Native secure storage
  * iOS: Keychain, Android: EncryptedSharedPreferences
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo } from '@/types';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo } from "../../types/index.js";
 /**
  * Native secure storage adapter using Capacitor plugin
  */
@@ -48,7 +48,7 @@ export declare class SecureAdapter extends BaseAdapter {
     setKeychainItem(key: string, value: string, options?: {
         service?: string;
         accessGroup?: string;
-        accessible?: import('@/plugin/definitions').KeychainAccessible;
+        accessible?: import("../../plugin/definitions.js").KeychainAccessible;
     }): Promise<void>;
     /**
      * iOS-specific: Get from Keychain

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

@@ -1 +1 @@
-{"version":3,"file":"SecureAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/capacitor/SecureAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACT,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAY;IACtC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAWrC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAwBpE;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB1E;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlD;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwBxD;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAajD;;OAEG;IACG,eAAe,CACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,sBAAsB,EAAE,kBAAkB,CAAC;KAChE,GACA,OAAO,CAAC,IAAI,CAAC;IAYhB;;OAEG;IACG,eAAe,CACnB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GACA,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAazB;;OAEG;IACG,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3F;;OAEG;IACG,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAY/E"}
+{"version":3,"file":"SecureAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/capacitor/SecureAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACT,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAY;IACtC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAWrC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAwBpE;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB1E;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBxC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlD;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwBxD;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAajD;;OAEG;IACG,eAAe,CACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,sBAAsB,EAAE,kBAAkB,CAAC;KAChE,GACA,OAAO,CAAC,IAAI,CAAC;IAYhB;;OAEG;IACG,eAAe,CACnB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GACA,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAazB;;OAEG;IACG,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3F;;OAEG;IACG,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAY/E"}

package/dist/adapters/capacitor/SecureAdapter.js

@@ -71,7 +71,9 @@ export class SecureAdapter extends BaseAdapter {
      * Set a value in secure storage
      */
     async set(key, value) {
-        const oldValue = await this.get(key);
+        // Only pay for a read-before-write (a native bridge round-trip) when a
+        // subscriber actually needs the previous value for the change event.
+        const oldValue = this.hasChangeListeners() ? await this.get(key) : null;
         try {
             await StrataStorage.set({
                 key,
@@ -88,7 +90,9 @@ export class SecureAdapter extends BaseAdapter {
      * Remove a value from secure storage
      */
     async remove(key) {
-        const oldValue = await this.get(key);
+        // Only pay for a read-before-write (a native bridge round-trip) when a
+        // subscriber actually needs the previous value for the change event.
+        const oldValue = this.hasChangeListeners() ? await this.get(key) : null;
         try {
             await StrataStorage.remove({
                 key,

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

@@ -2,8 +2,8 @@
  * SQLite Adapter - Native SQLite database storage
  * Available on iOS and Android
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo, QueryCondition, Transaction } from '@/types';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo, QueryCondition, Transaction } from "../../types/index.js";
 /**
  * Configuration options for SQLite adapter
  */
@@ -61,7 +61,28 @@ export declare class SqliteAdapter extends BaseAdapter {
      */
     size(detailed?: boolean): Promise<SizeInfo>;
     /**
-     * Begin a transaction
+     * Reclaim expired rows in a single native round-trip and return the count.
+     *
+     * Because `keys()` and `query()` now exclude expired rows in SQL (there is no
+     * lazy per-key deletion on read anymore), this is what physically deletes
+     * them — driven by both the automatic TTL tick and `Strata.cleanupExpired()`.
+     *
+     * If the native bulk delete is present but fails at runtime, we log and return
+     * 0 (reads stay correct — expired rows are filtered — and the next tick
+     * retries); we deliberately do NOT fall back to the base per-key sweep, which
+     * cannot see expired rows on a build whose `keys()` already filters them. The
+     * base sweep is used only when no native bulk delete exists at all (an older
+     * native build whose `keys()` still surfaces expired rows).
+     */
+    cleanupExpired(): Promise<number>;
+    /**
+     * Begin a transaction.
+     *
+     * NOTE: this is a best-effort batch, not an atomic native SQLite transaction.
+     * Operations are queued and executed sequentially on commit(); there is no
+     * native BEGIN/COMMIT/ROLLBACK across the connection, so a failure midway
+     * cannot roll back already-applied writes. `capabilities.transactional` is
+     * therefore reported as `false`.
      */
     transaction(): Promise<Transaction>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"SqliteAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/capacitor/SqliteAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,WAAW,EACZ,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAY;IACtC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,GAAE,YAAiB;IAMrC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAWrC;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IA0BpE;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB1E;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBxC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBlD;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BxD;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IA4B9F;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAejD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;CAK1C"}
+{"version":3,"file":"SqliteAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/capacitor/SqliteAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,WAAW,EACZ,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAyBD;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAY;IACtC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAcxC;IAEF,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,GAAE,YAAiB;IAQrC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAWrC;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAatD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IA0BpE;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB1E;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBxC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBlD;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmBxD;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IA0C9F;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAejD;;;;;;;;;;;;;OAaG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAiBvC;;;;;;;;OAQG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;CAG1C"}

package/dist/adapters/capacitor/SqliteAdapter.js

@@ -7,6 +7,25 @@ import { StrataStorage } from "../../plugin/index.js";
 import { StorageError, TransactionError } from "../../utils/errors.js";
 import { isCapacitor } from "../../utils/index.js";
 import { logger } from "../../utils/logger.js";
+/**
+ * Strict SQL-identifier allow-list for the `database` (file stem) and `table`
+ * names. These two cannot be bound as parameters, so they are the only place a
+ * SQL injection could occur; everything else (keys, values) is bound.
+ */
+const SQLITE_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/**
+ * Reject — loudly — any `database`/`table` that is not a strict SQL identifier,
+ * instead of silently stripping illegal characters (which could let two
+ * distinct logical stores collapse into one physical table). This is the
+ * authoritative guard: hostile identifiers never reach the native layer, which
+ * also applies the same allow-list as defense-in-depth.
+ */
+function assertValidIdentifier(kind, value) {
+    if (!SQLITE_IDENTIFIER.test(value)) {
+        throw new StorageError(`Invalid SQLite ${kind} name "${value}": must match ${SQLITE_IDENTIFIER.source} ` +
+            '(letters, digits and underscore only, not starting with a digit).');
+    }
+}
 /**
  * Native SQLite adapter using Capacitor plugin
  */
@@ -16,7 +35,11 @@ export class SqliteAdapter extends BaseAdapter {
         persistent: true,
         synchronous: false,
         observable: false,
-        transactional: true,
+        // `transaction()` queues operations and runs them sequentially on commit();
+        // it is NOT a single atomic native SQLite transaction (no BEGIN/COMMIT/
+        // ROLLBACK across the connection), so we report this honestly. See the
+        // SqliteTransaction note below.
+        transactional: false,
         queryable: true,
         maxSize: -1, // Limited by device storage
         binary: true,
@@ -29,6 +52,8 @@ export class SqliteAdapter extends BaseAdapter {
         super();
         this.database = config.database || 'strata_storage';
         this.table = config.table || 'storage';
+        assertValidIdentifier('database', this.database);
+        assertValidIdentifier('table', this.table);
     }
     /**
      * Check if SQLite is available
@@ -48,10 +73,14 @@ export class SqliteAdapter extends BaseAdapter {
      * Initialize the adapter
      */
     async initialize(config) {
-        if (config?.database)
+        if (config?.database) {
+            assertValidIdentifier('database', config.database);
             this.database = config.database;
-        if (config?.table)
+        }
+        if (config?.table) {
+            assertValidIdentifier('table', config.table);
             this.table = config.table;
+        }
         this.startTTLCleanup();
     }
     /**
@@ -84,7 +113,9 @@ export class SqliteAdapter extends BaseAdapter {
      * Set a value in SQLite
      */
     async set(key, value) {
-        const oldValue = await this.get(key);
+        // Only pay for a read-before-write (a native bridge round-trip) when a
+        // subscriber actually needs the previous value for the change event.
+        const oldValue = this.hasChangeListeners() ? await this.get(key) : null;
         try {
             await StrataStorage.set({
                 key,
@@ -103,7 +134,9 @@ export class SqliteAdapter extends BaseAdapter {
      * Remove a value from SQLite
      */
     async remove(key) {
-        const oldValue = await this.get(key);
+        // Only pay for a read-before-write (a native bridge round-trip) when a
+        // subscriber actually needs the previous value for the change event.
+        const oldValue = this.hasChangeListeners() ? await this.get(key) : null;
         try {
             await StrataStorage.remove({
                 key,
@@ -151,16 +184,11 @@ export class SqliteAdapter extends BaseAdapter {
                 table: this.table,
                 pattern: pattern instanceof RegExp ? pattern.source : pattern,
             });
-            const keys = result.keys;
-            // Check for expired keys
-            const validKeys = [];
-            for (const key of keys) {
-                const value = await this.get(key);
-                if (value) {
-                    validKeys.push(key);
-                }
-            }
-            return this.filterKeys(validKeys, pattern);
+            // The native layer excludes expired rows in SQL (a single round-trip),
+            // so there is no per-key `get()` loop here. We still run `filterKeys`
+            // for the adapter's exact prefix/glob/RegExp semantics — native `LIKE`
+            // is only a coarse pre-filter.
+            return this.filterKeys(result.keys, pattern);
         }
         catch (error) {
             throw new StorageError(`Failed to get keys from SQLite: ${error}`);
@@ -180,12 +208,27 @@ export class SqliteAdapter extends BaseAdapter {
                 table: this.table,
                 condition,
             });
-            // Filter expired entries
+            // The native layer returns the full non-expired wrapper for every
+            // candidate row in ONE round-trip, so the real query filter runs here in
+            // JS (mirroring BaseAdapter.query) without an N+1 `get()` per key.
+            const isStorageQuery = this.isStorageMetadataQuery(condition);
+            const normalizedCondition = isStorageQuery
+                ? condition
+                : this.normalizeValueQueryCondition(condition);
             const validResults = [];
             for (const item of result.results) {
-                const value = await this.get(item.key);
-                if (value) {
-                    validResults.push({ key: item.key, value: value.value });
+                // Use the batched wrapper; fall back to a per-key `get()` only for
+                // older native builds that surface keys alone (item.value undefined).
+                const stored = item.value ?? (await this.get(item.key));
+                if (!stored)
+                    continue; // missing
+                if (this.isExpired(stored))
+                    continue; // defensive: native already filters
+                const matches = isStorageQuery
+                    ? this.queryEngine.matches(stored, normalizedCondition)
+                    : this.queryEngine.matches(stored.value, normalizedCondition);
+                if (matches) {
+                    validResults.push({ key: item.key, value: stored.value });
                 }
             }
             return validResults;
@@ -212,16 +255,55 @@ export class SqliteAdapter extends BaseAdapter {
         }
     }
     /**
-     * Begin a transaction
+     * Reclaim expired rows in a single native round-trip and return the count.
+     *
+     * Because `keys()` and `query()` now exclude expired rows in SQL (there is no
+     * lazy per-key deletion on read anymore), this is what physically deletes
+     * them — driven by both the automatic TTL tick and `Strata.cleanupExpired()`.
+     *
+     * If the native bulk delete is present but fails at runtime, we log and return
+     * 0 (reads stay correct — expired rows are filtered — and the next tick
+     * retries); we deliberately do NOT fall back to the base per-key sweep, which
+     * cannot see expired rows on a build whose `keys()` already filters them. The
+     * base sweep is used only when no native bulk delete exists at all (an older
+     * native build whose `keys()` still surfaces expired rows).
+     */
+    async cleanupExpired() {
+        if (StrataStorage.cleanupExpired) {
+            try {
+                const result = await StrataStorage.cleanupExpired({
+                    storage: 'sqlite',
+                    database: this.database,
+                    table: this.table,
+                });
+                return result.removed;
+            }
+            catch (error) {
+                logger.error('Native SQLite cleanupExpired failed; will retry next tick:', error);
+                return 0;
+            }
+        }
+        return super.cleanupExpired();
+    }
+    /**
+     * Begin a transaction.
+     *
+     * NOTE: this is a best-effort batch, not an atomic native SQLite transaction.
+     * Operations are queued and executed sequentially on commit(); there is no
+     * native BEGIN/COMMIT/ROLLBACK across the connection, so a failure midway
+     * cannot roll back already-applied writes. `capabilities.transactional` is
+     * therefore reported as `false`.
      */
     async transaction() {
-        // Transactions are handled natively
-        // For now, return a simple implementation
         return new SqliteTransaction(this);
     }
 }
 /**
- * SQLite transaction implementation
+ * SQLite transaction implementation.
+ *
+ * Best-effort sequential batch (see SqliteAdapter.transaction): rollback() only
+ * discards queued-but-not-yet-committed operations; it cannot undo writes that
+ * commit() has already applied. Do not rely on this for atomic multi-key writes.
  */
 class SqliteTransaction {
     adapter;

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

@@ -2,8 +2,8 @@
  * Capacitor Native Storage Adapters
  * Export all native platform storage implementations
  */
-export { PreferencesAdapter } from './PreferencesAdapter';
-export { SqliteAdapter } from './SqliteAdapter';
-export { SecureAdapter } from './SecureAdapter';
-export { FilesystemAdapter } from './FilesystemAdapter';
+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

@@ -2,8 +2,8 @@
  * Cache Adapter - Service Worker Cache API implementation
  * Provides network-aware storage for offline support
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo, QueryCondition } from '@/types';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo, QueryCondition } from "../../types/index.js";
 /**
  * Cache API adapter for Service Worker environments
  */

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

@@ -2,8 +2,8 @@
  * Cookie Adapter - Browser cookie implementation
  * Provides limited storage with 4KB per cookie limit
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo } from '@/types';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo } from "../../types/index.js";
 /**
  * Cookie options.
  *

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

@@ -2,8 +2,8 @@
  * IndexedDB Adapter - Browser IndexedDB implementation
  * Provides large-scale persistent storage with advanced features
  */
-import { BaseAdapter } from '@/core/BaseAdapter';
-import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo, QueryCondition, Transaction } from '@/types';
+import { BaseAdapter } from "../../core/BaseAdapter.js";
+import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo, QueryCondition, Transaction } from "../../types/index.js";
 /**
  * Browser IndexedDB adapter
  */
@@ -63,7 +63,14 @@ export declare class IndexedDBAdapter extends BaseAdapter {
      */
     size(detailed?: boolean): Promise<SizeInfo>;
     /**
-     * Begin a transaction
+     * Begin a transaction.
+     *
+     * IMPORTANT — IndexedDB transactions auto-commit as soon as control returns to
+     * the event loop with no pending requests. Issue all `set`/`remove`/`get`
+     * calls back-to-back and `await` them together (e.g. `Promise.all([...])`)
+     * BEFORE awaiting anything unrelated. Awaiting a non-IndexedDB promise between
+     * operations lets the transaction close, after which further calls fail with
+     * `TransactionInactiveError`. For most multi-write needs prefer `setMany()`.
      */
     transaction(): Promise<Transaction>;
     /**