@quereus/plugin-react-native-leveldb 0.1.1

package/README.md

@@ -0,0 +1,194 @@
+# @quereus/plugin-react-native-leveldb
+
+LevelDB storage plugin for Quereus on React Native. Provides fast, persistent storage for mobile iOS and Android applications using the [`@quereus/store`](../quereus-store/) module.
+
+## Features
+
+- **Fast**: LevelDB offers excellent read/write performance, significantly faster than AsyncStorage
+- **Synchronous API**: Uses rn-leveldb's synchronous, blocking APIs
+- **Binary data**: Full support for binary keys and values via ArrayBuffers
+- **Sorted keys**: Efficient range queries with ordered iteration
+- **Persistent**: Data survives app restarts
+- **Atomic batch writes**: Uses native LevelDB WriteBatch for atomic multi-key operations
+
+## Installation
+
+```bash
+npm install @quereus/plugin-react-native-leveldb @quereus/store rn-leveldb
+
+# Don't forget to link native modules
+cd ios && pod install
+```
+
+## Quick Start
+
+### With registerPlugin (Recommended)
+
+```typescript
+import { LevelDB, LevelDBWriteBatch } from 'rn-leveldb';
+import { Database, registerPlugin } from '@quereus/quereus';
+import leveldbPlugin from '@quereus/plugin-react-native-leveldb/plugin';
+
+const db = new Database();
+await registerPlugin(db, leveldbPlugin, {
+  openFn: (name, createIfMissing, errorIfExists) => new LevelDB(name, createIfMissing, errorIfExists),
+  WriteBatch: LevelDBWriteBatch,
+});
+
+await db.exec(`
+  create table users (id integer primary key, name text)
+  using store
+`);
+
+await db.exec(`insert into users (id, name) values (1, 'Alice')`);
+
+const users = await db.all('select * from users');
+console.log(users);
+```
+
+### Direct Usage with Provider
+
+```typescript
+import { LevelDB, LevelDBWriteBatch } from 'rn-leveldb';
+import { Database } from '@quereus/quereus';
+import { createReactNativeLevelDBProvider } from '@quereus/plugin-react-native-leveldb';
+import { StoreModule } from '@quereus/store';
+
+const db = new Database();
+const provider = createReactNativeLevelDBProvider({
+  openFn: (name, createIfMissing, errorIfExists) => new LevelDB(name, createIfMissing, errorIfExists),
+  WriteBatch: LevelDBWriteBatch,
+});
+const storeModule = new StoreModule(provider);
+db.registerVtabModule('store', storeModule);
+
+await db.exec(`
+  create table users (id integer primary key, name text)
+  using store
+`);
+```
+
+## API
+
+### ReactNativeLevelDBStore
+
+Low-level KVStore implementation:
+
+```typescript
+import { LevelDB, LevelDBWriteBatch } from 'rn-leveldb';
+import { ReactNativeLevelDBStore } from '@quereus/plugin-react-native-leveldb';
+
+// Open using the factory function
+const openFn = (name, createIfMissing, errorIfExists) => new LevelDB(name, createIfMissing, errorIfExists);
+const store = ReactNativeLevelDBStore.open(openFn, LevelDBWriteBatch, 'mystore');
+
+await store.put(key, value);
+const data = await store.get(key);
+await store.delete(key);
+
+// Range iteration
+for await (const { key, value } of store.iterate({ gte: startKey, lt: endKey })) {
+  console.log(key, value);
+}
+
+// Atomic batch writes (uses native LevelDB WriteBatch)
+const batch = store.batch();
+batch.put(key1, value1);
+batch.put(key2, value2);
+batch.delete(key3);
+await batch.write();
+
+await store.close();
+```
+
+### ReactNativeLevelDBProvider
+
+Factory for managing multiple stores:
+
+```typescript
+import { LevelDB, LevelDBWriteBatch } from 'rn-leveldb';
+import { createReactNativeLevelDBProvider } from '@quereus/plugin-react-native-leveldb';
+
+const provider = createReactNativeLevelDBProvider({
+  openFn: (name, createIfMissing, errorIfExists) => new LevelDB(name, createIfMissing, errorIfExists),
+  WriteBatch: LevelDBWriteBatch,
+  databaseName: 'myapp',
+});
+
+const userStore = await provider.getStore('main', 'users');
+const catalogStore = await provider.getCatalogStore();
+
+await provider.closeStore('main', 'users');
+await provider.closeAll();
+```
+
+## Configuration
+
+### Plugin Settings
+
+| Setting | Type | Default | Description |
+|---------|------|---------|-------------|
+| `openFn` | function | **required** | Factory function: `(name, createIfMissing, errorIfExists) => LevelDB` |
+| `WriteBatch` | constructor | **required** | LevelDBWriteBatch constructor from rn-leveldb |
+| `databaseName` | string | `'quereus'` | Base name prefix for all LevelDB databases |
+| `createIfMissing` | boolean | `true` | Create databases if they don't exist |
+| `moduleName` | string | `'store'` | Name to register the virtual table module under |
+
+## Example with Transactions
+
+```typescript
+import { LevelDB, LevelDBWriteBatch } from 'rn-leveldb';
+import { Database, registerPlugin } from '@quereus/quereus';
+import leveldbPlugin from '@quereus/plugin-react-native-leveldb/plugin';
+
+const db = new Database();
+await registerPlugin(db, leveldbPlugin, {
+  openFn: (name, createIfMissing, errorIfExists) => new LevelDB(name, createIfMissing, errorIfExists),
+  WriteBatch: LevelDBWriteBatch,
+});
+
+await db.exec(`create table accounts (id integer primary key, balance real) using store`);
+
+await db.exec('begin');
+try {
+  await db.exec(`update accounts set balance = balance - 100 where id = 1`);
+  await db.exec(`update accounts set balance = balance + 100 where id = 2`);
+  await db.exec('commit');
+} catch (e) {
+  await db.exec('rollback');
+  throw e;
+}
+```
+
+## Why LevelDB?
+
+rn-leveldb provides significant performance advantages over other React Native storage options:
+
+| Storage Solution | Operations/sec | Notes |
+|------------------|----------------|-------|
+| rn-leveldb | ~50,000 | Synchronous, blocking API |
+| AsyncStorage | ~2,000 | JSON serialization overhead |
+| react-native-sqlite-storage | ~5,000 | Full SQL parsing overhead |
+
+LevelDB is ideal for Quereus because:
+- **Sorted keys**: Natural fit for the StoreModule's index-organized storage
+- **Binary support**: No JSON serialization needed for keys/values
+- **Range scans**: Efficient ordered iteration for query execution
+
+## Peer Dependencies
+
+This plugin requires:
+- `@quereus/quereus` ^0.24.0
+- `@quereus/store` ^0.3.5
+- `rn-leveldb` ^3.11.0
+
+## Related Packages
+
+- [`@quereus/store`](../quereus-store/) - Core storage module (StoreModule, StoreTable)
+- [`@quereus/plugin-leveldb`](../quereus-plugin-leveldb/) - LevelDB plugin for Node.js
+- [`@quereus/plugin-indexeddb`](../quereus-plugin-indexeddb/) - IndexedDB plugin for browsers
+
+## License
+
+MIT
+

package/dist/src/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * React Native LevelDB storage plugin for Quereus.
+ *
+ * Provides LevelDB-based persistent storage for React Native mobile environments
+ * (iOS and Android). Uses rn-leveldb for native LevelDB bindings.
+ *
+ * @example Using as a plugin (recommended)
+ * ```typescript
+ * import { LevelDB, LevelDBWriteBatch } from 'rn-leveldb';
+ * import { Database, registerPlugin } from '@quereus/quereus';
+ * import leveldbPlugin from '@quereus/plugin-react-native-leveldb/plugin';
+ *
+ * const db = new Database();
+ * await registerPlugin(db, leveldbPlugin, {
+ *   openFn: (name, createIfMissing, errorIfExists) => new LevelDB(name, createIfMissing, errorIfExists),
+ *   WriteBatch: LevelDBWriteBatch,
+ * });
+ *
+ * await db.exec(`
+ *   create table users (id integer primary key, name text)
+ *   using store
+ * `);
+ * ```
+ *
+ * @example Using the provider directly
+ * ```typescript
+ * import { LevelDB, LevelDBWriteBatch } from 'rn-leveldb';
+ * import { createReactNativeLevelDBProvider } from '@quereus/plugin-react-native-leveldb';
+ * import { StoreModule } from '@quereus/store';
+ *
+ * const provider = createReactNativeLevelDBProvider({
+ *   openFn: (name, createIfMissing, errorIfExists) => new LevelDB(name, createIfMissing, errorIfExists),
+ *   WriteBatch: LevelDBWriteBatch,
+ * });
+ * const storeModule = new StoreModule(provider);
+ * db.registerVtabModule('store', storeModule);
+ * ```
+ */
+export { ReactNativeLevelDBStore, type LevelDB, type LevelDBIterator, type LevelDBOpenFn, type LevelDBWriteBatch, type LevelDBWriteBatchConstructor } from './store.js';
+export { ReactNativeLevelDBProvider, createReactNativeLevelDBProvider, type ReactNativeLevelDBProviderOptions } from './provider.js';
+export { default as plugin, type ReactNativeLevelDBPluginConfig } from './plugin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,uBAAuB,EAAE,KAAK,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,KAAK,4BAA4B,EAAE,MAAM,YAAY,CAAC;AACxK,OAAO,EAAE,0BAA0B,EAAE,gCAAgC,EAAE,KAAK,iCAAiC,EAAE,MAAM,eAAe,CAAC;AACrI,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,KAAK,8BAA8B,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,42 @@
+/**
+ * React Native LevelDB storage plugin for Quereus.
+ *
+ * Provides LevelDB-based persistent storage for React Native mobile environments
+ * (iOS and Android). Uses rn-leveldb for native LevelDB bindings.
+ *
+ * @example Using as a plugin (recommended)
+ * ```typescript
+ * import { LevelDB, LevelDBWriteBatch } from 'rn-leveldb';
+ * import { Database, registerPlugin } from '@quereus/quereus';
+ * import leveldbPlugin from '@quereus/plugin-react-native-leveldb/plugin';
+ *
+ * const db = new Database();
+ * await registerPlugin(db, leveldbPlugin, {
+ *   openFn: (name, createIfMissing, errorIfExists) => new LevelDB(name, createIfMissing, errorIfExists),
+ *   WriteBatch: LevelDBWriteBatch,
+ * });
+ *
+ * await db.exec(`
+ *   create table users (id integer primary key, name text)
+ *   using store
+ * `);
+ * ```
+ *
+ * @example Using the provider directly
+ * ```typescript
+ * import { LevelDB, LevelDBWriteBatch } from 'rn-leveldb';
+ * import { createReactNativeLevelDBProvider } from '@quereus/plugin-react-native-leveldb';
+ * import { StoreModule } from '@quereus/store';
+ *
+ * const provider = createReactNativeLevelDBProvider({
+ *   openFn: (name, createIfMissing, errorIfExists) => new LevelDB(name, createIfMissing, errorIfExists),
+ *   WriteBatch: LevelDBWriteBatch,
+ * });
+ * const storeModule = new StoreModule(provider);
+ * db.registerVtabModule('store', storeModule);
+ * ```
+ */
+export { ReactNativeLevelDBStore } from './store.js';
+export { ReactNativeLevelDBProvider, createReactNativeLevelDBProvider } from './provider.js';
+export { default as plugin } from './plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,uBAAuB,EAAqH,MAAM,YAAY,CAAC;AACxK,OAAO,EAAE,0BAA0B,EAAE,gCAAgC,EAA0C,MAAM,eAAe,CAAC;AACrI,OAAO,EAAE,OAAO,IAAI,MAAM,EAAuC,MAAM,aAAa,CAAC"}

package/dist/src/plugin.d.ts

@@ -0,0 +1,68 @@
+/**
+ * React Native LevelDB plugin for Quereus.
+ *
+ * Registers a StoreModule backed by LevelDB for React Native mobile environments.
+ * Uses rn-leveldb for native LevelDB bindings.
+ */
+import type { Database, SqlValue } from '@quereus/quereus';
+import { StoreModule } from '@quereus/store';
+import type { LevelDBOpenFn, LevelDBWriteBatchConstructor } from './store.js';
+/**
+ * Plugin configuration options.
+ */
+export interface ReactNativeLevelDBPluginConfig {
+    /**
+     * The LevelDB open function from rn-leveldb.
+     * Obtain this from: import { LevelDB } from 'rn-leveldb';
+     * Then pass: (name, createIfMissing, errorIfExists) => new LevelDB(name, createIfMissing, errorIfExists)
+     */
+    openFn: LevelDBOpenFn;
+    /**
+     * The LevelDBWriteBatch constructor from rn-leveldb.
+     * Obtain this from: import { LevelDBWriteBatch } from 'rn-leveldb';
+     */
+    WriteBatch: LevelDBWriteBatchConstructor;
+    /**
+     * Base name prefix for all LevelDB databases.
+     * @default 'quereus'
+     */
+    databaseName?: string;
+    /**
+     * Create databases if they don't exist.
+     * @default true
+     */
+    createIfMissing?: boolean;
+    /**
+     * Module name to register. Tables are created with `USING <moduleName>`.
+     * @default 'store'
+     */
+    moduleName?: string;
+}
+/**
+ * Register the React Native LevelDB plugin with a database.
+ *
+ * @example
+ * ```typescript
+ * import { LevelDB, LevelDBWriteBatch } from 'rn-leveldb';
+ * import { Database, registerPlugin } from '@quereus/quereus';
+ * import leveldbPlugin from '@quereus/plugin-react-native-leveldb/plugin';
+ *
+ * const db = new Database();
+ * await registerPlugin(db, leveldbPlugin, {
+ *   openFn: (name, createIfMissing, errorIfExists) => new LevelDB(name, createIfMissing, errorIfExists),
+ *   WriteBatch: LevelDBWriteBatch,
+ * });
+ *
+ * await db.exec(`
+ *   create table users (id integer primary key, name text)
+ *   using store
+ * `);
+ * ```
+ */
+export default function register(_db: Database, config?: Record<string, SqlValue>): {
+    vtables: {
+        name: string;
+        module: StoreModule;
+    }[];
+};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/src/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,aAAa,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC9C;;;;OAIG;IACH,MAAM,EAAE,aAAa,CAAC;IAEtB;;;OAGG;IACH,UAAU,EAAE,4BAA4B,CAAC;IAEzC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC/B,GAAG,EAAE,QAAQ,EACb,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAM;;;;;EAyCrC"}

package/dist/src/plugin.js

@@ -0,0 +1,62 @@
+/**
+ * React Native LevelDB plugin for Quereus.
+ *
+ * Registers a StoreModule backed by LevelDB for React Native mobile environments.
+ * Uses rn-leveldb for native LevelDB bindings.
+ */
+import { StoreModule } from '@quereus/store';
+import { ReactNativeLevelDBProvider } from './provider.js';
+/**
+ * Register the React Native LevelDB plugin with a database.
+ *
+ * @example
+ * ```typescript
+ * import { LevelDB, LevelDBWriteBatch } from 'rn-leveldb';
+ * import { Database, registerPlugin } from '@quereus/quereus';
+ * import leveldbPlugin from '@quereus/plugin-react-native-leveldb/plugin';
+ *
+ * const db = new Database();
+ * await registerPlugin(db, leveldbPlugin, {
+ *   openFn: (name, createIfMissing, errorIfExists) => new LevelDB(name, createIfMissing, errorIfExists),
+ *   WriteBatch: LevelDBWriteBatch,
+ * });
+ *
+ * await db.exec(`
+ *   create table users (id integer primary key, name text)
+ *   using store
+ * `);
+ * ```
+ */
+export default function register(_db, config = {}) {
+    // The LevelDB open function must be provided
+    const openFn = config.openFn;
+    if (!openFn) {
+        throw new Error('@quereus/plugin-react-native-leveldb requires an "openFn" option. ' +
+            'Import LevelDB from "rn-leveldb" and pass: (name, createIfMissing, errorIfExists) => new LevelDB(name, createIfMissing, errorIfExists)');
+    }
+    // The WriteBatch constructor must be provided
+    const WriteBatch = config.WriteBatch;
+    if (!WriteBatch) {
+        throw new Error('@quereus/plugin-react-native-leveldb requires a "WriteBatch" option. ' +
+            'Import LevelDBWriteBatch from "rn-leveldb" and pass it as WriteBatch.');
+    }
+    const databaseName = config.databaseName ?? 'quereus';
+    const createIfMissing = config.createIfMissing !== false;
+    const moduleName = config.moduleName ?? 'store';
+    const provider = new ReactNativeLevelDBProvider({
+        openFn,
+        WriteBatch,
+        databaseName,
+        createIfMissing,
+    });
+    const storeModule = new StoreModule(provider);
+    return {
+        vtables: [
+            {
+                name: moduleName,
+                module: storeModule,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/src/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAuC3D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC/B,GAAa,EACb,SAAmC,EAAE;IAErC,6CAA6C;IAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAkC,CAAC;IACzD,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACd,oEAAoE;YACpE,wIAAwI,CACxI,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAqD,CAAC;IAChF,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACd,uEAAuE;YACvE,uEAAuE,CACvE,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAI,MAAM,CAAC,YAAuB,IAAI,SAAS,CAAC;IAClE,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,KAAK,KAAK,CAAC;IACzD,MAAM,UAAU,GAAI,MAAM,CAAC,UAAqB,IAAI,OAAO,CAAC;IAE5D,MAAM,QAAQ,GAAG,IAAI,0BAA0B,CAAC;QAC/C,MAAM;QACN,UAAU;QACV,YAAY;QACZ,eAAe;KACf,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;IAE9C,OAAO;QACN,OAAO,EAAE;YACR;gBACC,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,WAAW;aACnB;SACD;KACD,CAAC;AACH,CAAC"}

package/dist/src/provider.d.ts

@@ -0,0 +1,67 @@
+/**
+ * React Native LevelDB KVStore provider implementation.
+ *
+ * Manages LevelDB stores for the StoreModule in React Native environments.
+ */
+import type { KVStore, KVStoreProvider } from '@quereus/store';
+import { type LevelDBOpenFn, type LevelDBWriteBatchConstructor } from './store.js';
+/**
+ * Options for creating a React Native LevelDB provider.
+ */
+export interface ReactNativeLevelDBProviderOptions {
+    /**
+     * The LevelDB open function from rn-leveldb.
+     * Obtain this from: import { LevelDB } from 'rn-leveldb';
+     * Then pass: (name, createIfMissing, errorIfExists) => new LevelDB(name, createIfMissing, errorIfExists)
+     */
+    openFn: LevelDBOpenFn;
+    /**
+     * The LevelDBWriteBatch constructor from rn-leveldb.
+     * Obtain this from: import { LevelDBWriteBatch } from 'rn-leveldb';
+     */
+    WriteBatch: LevelDBWriteBatchConstructor;
+    /**
+     * Base name prefix for all LevelDB databases.
+     * Each table gets a separate database with this prefix.
+     * @default 'quereus'
+     */
+    databaseName?: string;
+    /**
+     * Create databases if they don't exist.
+     * @default true
+     */
+    createIfMissing?: boolean;
+}
+/**
+ * React Native LevelDB implementation of KVStoreProvider.
+ *
+ * Creates separate LevelDB databases for each table. On mobile platforms,
+ * this provides efficient, persistent key-value storage with sorted keys.
+ */
+export declare class ReactNativeLevelDBProvider implements KVStoreProvider {
+    private openFn;
+    private WriteBatch;
+    private databaseName;
+    private createIfMissing;
+    private stores;
+    private catalogStore;
+    constructor(options: ReactNativeLevelDBProviderOptions);
+    /**
+     * Get the database name for a table.
+     * Uses dots as separators for a flat namespace.
+     */
+    private getDatabaseName;
+    /**
+     * Get the key for the store cache.
+     */
+    private getStoreKey;
+    getStore(schemaName: string, tableName: string, _options?: Record<string, unknown>): Promise<KVStore>;
+    getCatalogStore(): Promise<KVStore>;
+    closeStore(schemaName: string, tableName: string): Promise<void>;
+    closeAll(): Promise<void>;
+}
+/**
+ * Create a React Native LevelDB provider with the given options.
+ */
+export declare function createReactNativeLevelDBProvider(options: ReactNativeLevelDBProviderOptions): ReactNativeLevelDBProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/src/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAA2B,KAAK,aAAa,EAAE,KAAK,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE5G;;GAEG;AACH,MAAM,WAAW,iCAAiC;IACjD;;;;OAIG;IACH,MAAM,EAAE,aAAa,CAAC;IAEtB;;;OAGG;IACH,UAAU,EAAE,4BAA4B,CAAC;IAEzC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,0BAA2B,YAAW,eAAe;IACjE,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,MAAM,CAA8C;IAC5D,OAAO,CAAC,YAAY,CAAwC;gBAEhD,OAAO,EAAE,iCAAiC;IAOtD;;;OAGG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAIb,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAerG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAUnC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAShE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAW/B;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,iCAAiC,GAAG,0BAA0B,CAEvH"}

package/dist/src/provider.js

@@ -0,0 +1,85 @@
+/**
+ * React Native LevelDB KVStore provider implementation.
+ *
+ * Manages LevelDB stores for the StoreModule in React Native environments.
+ */
+import { ReactNativeLevelDBStore } from './store.js';
+/**
+ * React Native LevelDB implementation of KVStoreProvider.
+ *
+ * Creates separate LevelDB databases for each table. On mobile platforms,
+ * this provides efficient, persistent key-value storage with sorted keys.
+ */
+export class ReactNativeLevelDBProvider {
+    openFn;
+    WriteBatch;
+    databaseName;
+    createIfMissing;
+    stores = new Map();
+    catalogStore = null;
+    constructor(options) {
+        this.openFn = options.openFn;
+        this.WriteBatch = options.WriteBatch;
+        this.databaseName = options.databaseName ?? 'quereus';
+        this.createIfMissing = options.createIfMissing ?? true;
+    }
+    /**
+     * Get the database name for a table.
+     * Uses dots as separators for a flat namespace.
+     */
+    getDatabaseName(schemaName, tableName) {
+        return `${this.databaseName}.${schemaName}.${tableName}`.toLowerCase();
+    }
+    /**
+     * Get the key for the store cache.
+     */
+    getStoreKey(schemaName, tableName) {
+        return `${schemaName}.${tableName}`.toLowerCase();
+    }
+    async getStore(schemaName, tableName, _options) {
+        const key = this.getStoreKey(schemaName, tableName);
+        let store = this.stores.get(key);
+        if (!store) {
+            const dbName = this.getDatabaseName(schemaName, tableName);
+            store = ReactNativeLevelDBStore.open(this.openFn, this.WriteBatch, dbName, {
+                createIfMissing: this.createIfMissing,
+            });
+            this.stores.set(key, store);
+        }
+        return store;
+    }
+    async getCatalogStore() {
+        if (!this.catalogStore) {
+            const catalogDbName = `${this.databaseName}.__catalog__`;
+            this.catalogStore = ReactNativeLevelDBStore.open(this.openFn, this.WriteBatch, catalogDbName, {
+                createIfMissing: this.createIfMissing,
+            });
+        }
+        return this.catalogStore;
+    }
+    async closeStore(schemaName, tableName) {
+        const key = this.getStoreKey(schemaName, tableName);
+        const store = this.stores.get(key);
+        if (store) {
+            await store.close();
+            this.stores.delete(key);
+        }
+    }
+    async closeAll() {
+        for (const store of this.stores.values()) {
+            await store.close();
+        }
+        this.stores.clear();
+        if (this.catalogStore) {
+            await this.catalogStore.close();
+            this.catalogStore = null;
+        }
+    }
+}
+/**
+ * Create a React Native LevelDB provider with the given options.
+ */
+export function createReactNativeLevelDBProvider(options) {
+    return new ReactNativeLevelDBProvider(options);
+}
+//# sourceMappingURL=provider.js.map

package/dist/src/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,uBAAuB,EAAyD,MAAM,YAAY,CAAC;AAiC5G;;;;;GAKG;AACH,MAAM,OAAO,0BAA0B;IAC9B,MAAM,CAAgB;IACtB,UAAU,CAA+B;IACzC,YAAY,CAAS;IACrB,eAAe,CAAU;IACzB,MAAM,GAAG,IAAI,GAAG,EAAmC,CAAC;IACpD,YAAY,GAAmC,IAAI,CAAC;IAE5D,YAAY,OAA0C;QACrD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,SAAS,CAAC;QACtD,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;IACxD,CAAC;IAED;;;OAGG;IACK,eAAe,CAAC,UAAkB,EAAE,SAAiB;QAC5D,OAAO,GAAG,IAAI,CAAC,YAAY,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC,WAAW,EAAE,CAAC;IACxE,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,UAAkB,EAAE,SAAiB;QACxD,OAAO,GAAG,UAAU,IAAI,SAAS,EAAE,CAAC,WAAW,EAAE,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,UAAkB,EAAE,SAAiB,EAAE,QAAkC;QACvF,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACpD,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEjC,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YAC3D,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE;gBAC1E,eAAe,EAAE,IAAI,CAAC,eAAe;aACrC,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,KAAK,CAAC;IACd,CAAC;IAED,KAAK,CAAC,eAAe;QACpB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACxB,MAAM,aAAa,GAAG,GAAG,IAAI,CAAC,YAAY,cAAc,CAAC;YACzD,IAAI,CAAC,YAAY,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE;gBAC7F,eAAe,EAAE,IAAI,CAAC,eAAe;aACrC,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,UAAkB,EAAE,SAAiB;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,KAAK,EAAE,CAAC;YACX,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACF,CAAC;IAED,KAAK,CAAC,QAAQ;QACb,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAEpB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC1B,CAAC;IACF,CAAC;CACD;AAED;;GAEG;AACH,MAAM,UAAU,gCAAgC,CAAC,OAA0C;IAC1F,OAAO,IAAI,0BAA0B,CAAC,OAAO,CAAC,CAAC;AAChD,CAAC"}

package/dist/src/store.d.ts

@@ -0,0 +1,144 @@
+/**
+ * LevelDB-based KVStore implementation for React Native.
+ *
+ * Uses rn-leveldb for LevelDB bindings on iOS/Android.
+ * Keys and values are stored as binary ArrayBuffers.
+ */
+import type { KVStore, KVEntry, WriteBatch, IterateOptions } from '@quereus/store';
+/**
+ * Type definition for rn-leveldb write batch.
+ * Used internally for atomic batch writes.
+ */
+export interface LevelDBWriteBatch {
+    /**
+     * Add a put operation to the batch.
+     */
+    put(key: ArrayBuffer | string, value: ArrayBuffer | string): void;
+    /**
+     * Add a delete operation to the batch.
+     */
+    delete(key: ArrayBuffer | string): void;
+    /**
+     * Close the batch (releases native resources).
+     */
+    close(): void;
+}
+/**
+ * Constructor type for LevelDBWriteBatch.
+ * rn-leveldb exports this as a class that can be constructed without arguments.
+ */
+export type LevelDBWriteBatchConstructor = new () => LevelDBWriteBatch;
+/**
+ * Type definition for rn-leveldb database.
+ * We use a minimal interface to avoid hard dependency on the package types.
+ *
+ * rn-leveldb provides synchronous, blocking APIs which are
+ * significantly faster than alternatives like AsyncStorage.
+ */
+export interface LevelDB {
+    /**
+     * Put a key-value pair.
+     */
+    put(key: ArrayBuffer | string, value: ArrayBuffer | string): void;
+    /**
+     * Get a value by key as ArrayBuffer.
+     * @returns The value as ArrayBuffer, or null if not found.
+     */
+    getBuf(key: ArrayBuffer | string): ArrayBuffer | null;
+    /**
+     * Delete a key.
+     */
+    delete(key: ArrayBuffer | string): void;
+    /**
+     * Close the database.
+     */
+    close(): void;
+    /**
+     * Create a new iterator for range scans.
+     */
+    newIterator(): LevelDBIterator;
+    /**
+     * Atomically write a batch of operations.
+     */
+    write(batch: LevelDBWriteBatch): void;
+}
+/**
+ * Type definition for rn-leveldb iterator.
+ */
+export interface LevelDBIterator {
+    /**
+     * Check if the iterator points to a valid entry.
+     */
+    valid(): boolean;
+    /**
+     * Move to the first entry >= the given key.
+     */
+    seek(target: ArrayBuffer | string): LevelDBIterator;
+    /**
+     * Move to the first entry.
+     */
+    seekToFirst(): LevelDBIterator;
+    /**
+     * Move to the last entry.
+     */
+    seekLast(): LevelDBIterator;
+    /**
+     * Move to the next entry.
+     */
+    next(): void;
+    /**
+     * Move to the previous entry.
+     */
+    prev(): void;
+    /**
+     * Get the current key.
+     */
+    keyBuf(): ArrayBuffer;
+    /**
+     * Get the current value.
+     */
+    valueBuf(): ArrayBuffer;
+    /**
+     * Close the iterator.
+     */
+    close(): void;
+}
+/**
+ * Factory function type for opening a LevelDB database.
+ * Should be rn-leveldb's LevelDB constructor.
+ */
+export type LevelDBOpenFn = (name: string, createIfMissing: boolean, errorIfExists: boolean) => LevelDB;
+/**
+ * LevelDB implementation of KVStore for React Native.
+ *
+ * Keys and values are stored as ArrayBuffers. LevelDB provides correct
+ * lexicographic byte ordering for range scans.
+ */
+export declare class ReactNativeLevelDBStore implements KVStore {
+    private db;
+    private WriteBatchCtor;
+    private closed;
+    private constructor();
+    /**
+     * Create a store with the given LevelDB instance and WriteBatch constructor.
+     */
+    static create(db: LevelDB, WriteBatch: LevelDBWriteBatchConstructor): ReactNativeLevelDBStore;
+    /**
+     * Open a store using the provided open function.
+     */
+    static open(openFn: LevelDBOpenFn, WriteBatch: LevelDBWriteBatchConstructor, name: string, options?: {
+        createIfMissing?: boolean;
+        errorIfExists?: boolean;
+    }): ReactNativeLevelDBStore;
+    get(key: Uint8Array): Promise<Uint8Array | undefined>;
+    put(key: Uint8Array, value: Uint8Array): Promise<void>;
+    delete(key: Uint8Array): Promise<void>;
+    has(key: Uint8Array): Promise<boolean>;
+    iterate(options?: IterateOptions): AsyncIterable<KVEntry>;
+    private collectEntries;
+    batch(): WriteBatch;
+    close(): Promise<void>;
+    approximateCount(options?: IterateOptions): Promise<number>;
+    private checkOpen;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/src/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEnF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IAElE;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IAExC;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG,UAAU,iBAAiB,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACvB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IAElE;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IAEtD;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IAExC;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,WAAW,IAAI,eAAe,CAAC;IAE/B;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,eAAe,CAAC;IAEpD;;OAEG;IACH,WAAW,IAAI,eAAe,CAAC;IAE/B;;OAEG;IACH,QAAQ,IAAI,eAAe,CAAC;IAE5B;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;OAEG;IACH,MAAM,IAAI,WAAW,CAAC;IAEtB;;OAEG;IACH,QAAQ,IAAI,WAAW,CAAC;IAExB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,KAAK,OAAO,CAAC;AAExG;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,OAAO;IACtD,OAAO,CAAC,EAAE,CAAU;IACpB,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO;IAKP;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,4BAA4B,GAAG,uBAAuB;IAI7F;;OAEG;IACH,MAAM,CAAC,IAAI,CACV,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,4BAA4B,EACxC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAC9D,uBAAuB;IASpB,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAMrD,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtC,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAMrC,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC,OAAO,CAAC;IAchE,OAAO,CAAC,cAAc;IA6EtB,KAAK,IAAI,UAAU;IAKb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,gBAAgB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAUjE,OAAO,CAAC,SAAS;CAKjB"}

package/dist/src/store.js

@@ -0,0 +1,241 @@
+/**
+ * LevelDB-based KVStore implementation for React Native.
+ *
+ * Uses rn-leveldb for LevelDB bindings on iOS/Android.
+ * Keys and values are stored as binary ArrayBuffers.
+ */
+/**
+ * LevelDB implementation of KVStore for React Native.
+ *
+ * Keys and values are stored as ArrayBuffers. LevelDB provides correct
+ * lexicographic byte ordering for range scans.
+ */
+export class ReactNativeLevelDBStore {
+    db;
+    WriteBatchCtor;
+    closed = false;
+    constructor(db, WriteBatch) {
+        this.db = db;
+        this.WriteBatchCtor = WriteBatch;
+    }
+    /**
+     * Create a store with the given LevelDB instance and WriteBatch constructor.
+     */
+    static create(db, WriteBatch) {
+        return new ReactNativeLevelDBStore(db, WriteBatch);
+    }
+    /**
+     * Open a store using the provided open function.
+     */
+    static open(openFn, WriteBatch, name, options) {
+        const db = openFn(name, options?.createIfMissing ?? true, options?.errorIfExists ?? false);
+        return new ReactNativeLevelDBStore(db, WriteBatch);
+    }
+    async get(key) {
+        this.checkOpen();
+        const result = this.db.getBuf(toArrayBuffer(key));
+        return result === null ? undefined : toUint8Array(result);
+    }
+    async put(key, value) {
+        this.checkOpen();
+        this.db.put(toArrayBuffer(key), toArrayBuffer(value));
+    }
+    async delete(key) {
+        this.checkOpen();
+        this.db.delete(toArrayBuffer(key));
+    }
+    async has(key) {
+        this.checkOpen();
+        const result = this.db.getBuf(toArrayBuffer(key));
+        return result !== null;
+    }
+    async *iterate(options) {
+        this.checkOpen();
+        const iterator = this.db.newIterator();
+        try {
+            const entries = this.collectEntries(iterator, options);
+            for (const entry of entries) {
+                yield entry;
+            }
+        }
+        finally {
+            iterator.close();
+        }
+    }
+    collectEntries(iterator, options) {
+        const entries = [];
+        const limit = options?.limit;
+        const reverse = options?.reverse ?? false;
+        // Position the iterator at the start
+        if (reverse) {
+            if (options?.lte) {
+                iterator.seek(toArrayBuffer(options.lte));
+                // If we seeked past, go back
+                if (!iterator.valid()) {
+                    iterator.seekLast();
+                }
+                else {
+                    // Check if current key is > lte (need to go back)
+                    const currentKey = toUint8Array(iterator.keyBuf());
+                    if (compareBytes(currentKey, options.lte) > 0) {
+                        iterator.prev();
+                    }
+                }
+            }
+            else if (options?.lt) {
+                iterator.seek(toArrayBuffer(options.lt));
+                // Go to previous since lt is exclusive
+                if (iterator.valid()) {
+                    iterator.prev();
+                }
+                else {
+                    iterator.seekLast();
+                }
+            }
+            else {
+                iterator.seekLast();
+            }
+        }
+        else {
+            if (options?.gte) {
+                iterator.seek(toArrayBuffer(options.gte));
+            }
+            else if (options?.gt) {
+                iterator.seek(toArrayBuffer(options.gt));
+                // Skip if current key equals gt (exclusive)
+                if (iterator.valid()) {
+                    const currentKey = toUint8Array(iterator.keyBuf());
+                    if (compareBytes(currentKey, options.gt) === 0) {
+                        iterator.next();
+                    }
+                }
+            }
+            else {
+                iterator.seekToFirst();
+            }
+        }
+        // Collect entries
+        while (iterator.valid()) {
+            if (limit !== undefined && entries.length >= limit) {
+                break;
+            }
+            const key = toUint8Array(iterator.keyBuf());
+            const value = toUint8Array(iterator.valueBuf());
+            // Check bounds
+            if (!reverse) {
+                if (options?.lt && compareBytes(key, options.lt) >= 0)
+                    break;
+                if (options?.lte && compareBytes(key, options.lte) > 0)
+                    break;
+            }
+            else {
+                if (options?.gt && compareBytes(key, options.gt) <= 0)
+                    break;
+                if (options?.gte && compareBytes(key, options.gte) < 0)
+                    break;
+            }
+            entries.push({ key, value });
+            if (reverse) {
+                iterator.prev();
+            }
+            else {
+                iterator.next();
+            }
+        }
+        return entries;
+    }
+    batch() {
+        this.checkOpen();
+        return new ReactNativeLevelDBWriteBatch(this.db, this.WriteBatchCtor);
+    }
+    async close() {
+        if (!this.closed) {
+            this.closed = true;
+            this.db.close();
+        }
+    }
+    async approximateCount(options) {
+        this.checkOpen();
+        // LevelDB doesn't have a native count, so we iterate and count
+        let count = 0;
+        for await (const _ of this.iterate(options)) {
+            count++;
+        }
+        return count;
+    }
+    checkOpen() {
+        if (this.closed) {
+            throw new Error('ReactNativeLevelDBStore is closed');
+        }
+    }
+}
+/**
+ * WriteBatch implementation for React Native LevelDB.
+ * Uses native LevelDB WriteBatch for atomic multi-key writes.
+ */
+class ReactNativeLevelDBWriteBatch {
+    db;
+    WriteBatchCtor;
+    nativeBatch;
+    constructor(db, WriteBatch) {
+        this.db = db;
+        this.WriteBatchCtor = WriteBatch;
+        this.nativeBatch = new WriteBatch();
+    }
+    put(key, value) {
+        this.nativeBatch.put(toArrayBuffer(key), toArrayBuffer(value));
+    }
+    delete(key) {
+        this.nativeBatch.delete(toArrayBuffer(key));
+    }
+    async write() {
+        this.db.write(this.nativeBatch);
+        // Close the old batch and create a new one for potential reuse
+        this.nativeBatch.close();
+        this.nativeBatch = new this.WriteBatchCtor();
+    }
+    clear() {
+        // Close the old batch and create a new empty one
+        this.nativeBatch.close();
+        this.nativeBatch = new this.WriteBatchCtor();
+    }
+}
+// ============================================================================
+// Binary conversion utilities
+// ============================================================================
+/**
+ * Convert Uint8Array to ArrayBuffer.
+ */
+function toArrayBuffer(bytes) {
+    const buffer = bytes.buffer;
+    // Fast path: if the Uint8Array covers the full buffer and isn't shared, use directly
+    if (buffer instanceof ArrayBuffer &&
+        bytes.byteOffset === 0 &&
+        bytes.byteLength === buffer.byteLength) {
+        return buffer;
+    }
+    // Slow path: copy for views into larger buffers or SharedArrayBuffer
+    const copy = new ArrayBuffer(bytes.byteLength);
+    new Uint8Array(copy).set(bytes);
+    return copy;
+}
+/**
+ * Convert ArrayBuffer to Uint8Array.
+ */
+function toUint8Array(data) {
+    return new Uint8Array(data);
+}
+/**
+ * Compare two Uint8Arrays lexicographically.
+ * @returns Negative if a < b, 0 if equal, positive if a > b.
+ */
+function compareBytes(a, b) {
+    const minLength = Math.min(a.length, b.length);
+    for (let i = 0; i < minLength; i++) {
+        if (a[i] !== b[i]) {
+            return a[i] - b[i];
+        }
+    }
+    return a.length - b.length;
+}
+//# sourceMappingURL=store.js.map

package/dist/src/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@quereus/plugin-react-native-leveldb",
+  "version": "0.1.1",
+  "type": "module",
+  "description": "React Native LevelDB storage plugin for Quereus - mobile persistent storage",
+  "keywords": [
+    "quereus",
+    "quereus-plugin",
+    "sql",
+    "database",
+    "storage",
+    "leveldb",
+    "react-native",
+    "mobile",
+    "ios",
+    "android",
+    "kv-store",
+    "persistent"
+  ],
+  "publisher": "Got Choices Foundation",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gotchoices/quereus.git",
+    "directory": "packages/quereus-plugin-react-native-leveldb"
+  },
+  "license": "MIT",
+  "main": "dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/src/plugin.d.ts",
+      "import": "./dist/src/plugin.js"
+    }
+  },
+  "peerDependencies": {
+    "@quereus/quereus": "^0.24.0",
+    "@quereus/store": "^0.3.5",
+    "rn-leveldb": "^3.11.0"
+  },
+  "engines": {
+    "quereus": "^0.24.0"
+  },
+  "quereus": {
+    "provides": {
+      "vtables": [
+        "store"
+      ]
+    },
+    "settings": [
+      {
+        "key": "databaseName",
+        "label": "Database Name",
+        "type": "string",
+        "default": "quereus",
+        "help": "Base name for LevelDB databases"
+      },
+      {
+        "key": "moduleName",
+        "label": "Module Name",
+        "type": "string",
+        "default": "store",
+        "help": "Name to register the virtual table module under"
+      }
+    ]
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "cd ../.. && node --import ./packages/quereus-plugin-react-native-leveldb/register.mjs node_modules/mocha/bin/mocha.js \"packages/quereus-plugin-react-native-leveldb/test/**/*.spec.ts\" --colors"
+  },
+  "devDependencies": {
+    "@quereus/quereus": "*",
+    "@quereus/store": "*",
+    "@types/chai": "^5.2.2",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^22.15.29",
+    "chai": "^5.2.0",
+    "mocha": "^11.5.0",
+    "rimraf": "^6.1.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3"
+  }
+}