@quereus/plugin-leveldb 3.3.0 → 4.0.0

package/README.md

@@ -7,9 +7,34 @@ LevelDB storage plugin for Quereus. Provides persistent storage for Node.js envi
 - **Fast**: LevelDB offers excellent read/write performance for key-value workloads
 - **Transaction isolation**: Read-your-own-writes and snapshot isolation by default
 - **Sorted keys**: Efficient range queries with ordered iteration
-- **ACID batches**: Atomic writes across multiple keys
+- **Crash-safe commits**: A whole transaction's data + secondary-index writes commit in one atomic, durable LevelDB batch (see [Storage layout](#storage-layout))
 - **Compression**: Built-in Snappy compression for reduced disk usage
 
+## Storage layout
+
+All of a database's stores live inside **one physical LevelDB** at `basePath`,
+each as a [sublevel](https://github.com/Level/abstract-level#sublevel) keyed by
+its store name:
+
+| Logical store | Sublevel name |
+|---|---|
+| Table data | `{schema}.{table}` |
+| Secondary index | `{schema}.{table}_idx_{name}` |
+| Unified stats | `__stats__` |
+| Catalog (DDL) | `__catalog__` |
+
+Because every sublevel shares one physical store, a single chained batch commits
+across all of a table's sublevels (data + every secondary index) **atomically and
+durably** — closing the crash window where a per-store commit loop could leave a
+table's rows and its indexes divergent on disk. By default each commit is
+`fsync`'d so it survives power loss; see [`syncCommits`](#plugin-settings).
+
+> **Hard cutover (no on-disk migration).** This shared-root layout is the only
+> LevelDB layout. Databases written by the older per-directory layout
+> (`{basePath}/{schema}/{table}`, a separate LevelDB per table) are **not** read
+> by this version and must be re-created. Pre-1.0 dev data is expected to be
+> thrown away; there is no migration importer.
+
 ## Installation
 
 ```bash
@@ -74,7 +99,10 @@ await db.exec(`
 
 ### LevelDBStore
 
-Low-level KVStore implementation:
+Low-level KVStore implementation. `LevelDBStore.open()` opens a **standalone**
+single physical LevelDB database — useful for one-off key-value stores (e.g. sync
+metadata). The multi-table StoreModule backend does not use this directly; it
+opens one shared root and hands out sublevel-backed stores via `LevelDBProvider`.
 
 ```typescript
 import { LevelDBStore } from '@quereus/plugin-leveldb';
@@ -109,11 +137,12 @@ import { createLevelDBProvider } from '@quereus/plugin-leveldb';
 
 const provider = createLevelDBProvider({ basePath: './data' });
 
-const userStore = await provider.getStore('main', 'users');  // ./data/main/users
-const catalogStore = await provider.getCatalogStore();       // ./data/__catalog__
+// All stores are sublevels of the single LevelDB at ./data
+const userStore = await provider.getStore('main', 'users');  // sublevel main.users
+const catalogStore = await provider.getCatalogStore();       // sublevel __catalog__
 
-await provider.closeStore('main', 'users');
-await provider.closeAll();
+await provider.closeStore('main', 'users'); // drops the sublevel handle
+await provider.closeAll();                   // closes the shared root
 ```
 
 ## Configuration
@@ -122,11 +151,13 @@ await provider.closeAll();
 
 | Setting | Type | Default | Description |
 |---------|------|---------|-------------|
-| `basePath` | string | `'./data'` | Base directory for all stores |
-| `createIfMissing` | boolean | `true` | Create directories if they don't exist |
+| `basePath` | string | `'./data'` | Directory of the single shared LevelDB database |
+| `createIfMissing` | boolean | `true` | Create the database if it doesn't exist |
+| `syncCommits` | boolean | `true` | `fsync` each transaction commit so it survives power loss (slower commits when on) |
 | `moduleName` | string | `'store'` | Name to register the virtual table module under |
+| `isolation` | boolean | `true` | Wrap with the isolation layer (read-your-own-writes, snapshot isolation) |
 
-### LevelDBStore Options
+### LevelDBStore Options (standalone `open`)
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|

package/dist/src/plugin.d.ts

@@ -10,16 +10,23 @@ import { StoreModule } from '@quereus/store';
  */
 export interface LevelDBPluginConfig {
     /**
-     * Base path for all LevelDB stores.
-     * Each table gets a subdirectory under this path.
+     * Base path for the single shared LevelDB database. Every table, index, the
+     * catalog, and stats live as sublevels inside this one physical store.
      * @default './data'
      */
     basePath?: string;
     /**
-     * Create directories if they don't exist.
+     * Create the database if it doesn't exist.
      * @default true
      */
     createIfMissing?: boolean;
+    /**
+     * fsync each transaction commit before resolving, so a committed transaction
+     * survives power loss. The cost is one fsync per commit; set false to trade
+     * durability for lower commit latency.
+     * @default true
+     */
+    syncCommits?: boolean;
     /**
      * Module name to register. Tables are created with `USING <moduleName>`.
      * @default 'store'

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAA6B,MAAM,gBAAgB,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC/B,GAAG,EAAE,QAAQ,EACb,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAM;;;;;EAwBrC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAA6B,MAAM,gBAAgB,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC/B,GAAG,EAAE,QAAQ,EACb,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAM;;;;;EA0BrC"}

package/dist/src/plugin.js

@@ -13,9 +13,11 @@ export default function register(_db, config = {}) {
     const createIfMissing = config.createIfMissing !== false;
     const moduleName = config.moduleName ?? 'store';
     const isolation = config.isolation ?? true;
+    const syncCommits = config.syncCommits !== false;
     const provider = new LevelDBProvider({
         basePath,
         createIfMissing,
+        syncCommits,
     });
     const storeModule = isolation
         ? createIsolatedStoreModule({ provider })

package/dist/src/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAiChD;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC/B,GAAa,EACb,SAAmC,EAAE;IAErC,MAAM,QAAQ,GAAI,MAAM,CAAC,QAAmB,IAAI,QAAQ,CAAC;IACzD,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,KAAK,KAAK,CAAC;IACzD,MAAM,UAAU,GAAI,MAAM,CAAC,UAAqB,IAAI,OAAO,CAAC;IAC5D,MAAM,SAAS,GAAI,MAAM,CAAC,SAAqB,IAAI,IAAI,CAAC;IAExD,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC;QACpC,QAAQ;QACR,eAAe;KACf,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,SAAS;QAC5B,CAAC,CAAC,yBAAyB,CAAC,EAAE,QAAQ,EAAE,CAAC;QACzC,CAAC,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;IAE7B,OAAO;QACN,OAAO,EAAE;YACR;gBACC,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,WAAW;aACnB;SACD;KACD,CAAC;AACH,CAAC"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAyChD;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAC/B,GAAa,EACb,SAAmC,EAAE;IAErC,MAAM,QAAQ,GAAI,MAAM,CAAC,QAAmB,IAAI,QAAQ,CAAC;IACzD,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,KAAK,KAAK,CAAC;IACzD,MAAM,UAAU,GAAI,MAAM,CAAC,UAAqB,IAAI,OAAO,CAAC;IAC5D,MAAM,SAAS,GAAI,MAAM,CAAC,SAAqB,IAAI,IAAI,CAAC;IACxD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,KAAK,KAAK,CAAC;IAEjD,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC;QACpC,QAAQ;QACR,eAAe;QACf,WAAW;KACX,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,SAAS;QAC5B,CAAC,CAAC,yBAAyB,CAAC,EAAE,QAAQ,EAAE,CAAC;QACzC,CAAC,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;IAE7B,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

@@ -1,45 +1,73 @@
 /**
- * LevelDB KVStore provider implementation.
+ * LevelDB KVStoreProvider — shared-root layout.
  *
- * Manages LevelDB stores for the StoreModule.
+ * All of a database's stores live inside ONE physical LevelDB at `basePath`, each
+ * as a sublevel keyed by its store name:
  *
- * Storage naming convention:
- *   {basePath}/{schema}/{table}              - Data store (row data)
- *   {basePath}/{schema}/{table}_idx_{name}   - Index store (secondary indexes)
- *   {basePath}/__stats__                     - Unified stats store (row counts for all tables)
- *   {basePath}/__catalog__                   - Catalog store (DDL metadata)
+ *   {schema}.{table}            - table data       (buildDataStoreName)
+ *   {schema}.{table}_idx_{name} - secondary index  (buildIndexStoreName)
+ *   __stats__                   - unified stats     (STATS_STORE_NAME)
+ *   __catalog__                 - catalog / DDL     (CATALOG_STORE_NAME)
+ *
+ * Because every sublevel shares one physical store, a single chained batch
+ * (`root.batch()…write()`) commits across sublevels atomically and durably — see
+ * {@link LevelDBProvider.beginAtomicBatch}. This is the crash-safe single commit
+ * that the prior per-directory layout (a separate ClassicLevel per table) could
+ * not provide: separate physical databases cannot share a write batch.
+ *
+ * HARD CUTOVER: this is the only LevelDB layout. Databases written by the prior
+ * per-directory layout (`{basePath}/{schema}/{table}`) are NOT read here and must
+ * be re-created (pre-1.0 dev data). There is no on-disk migration. See README.
  */
-import type { KVStore, KVStoreProvider } from '@quereus/store';
+import type { AtomicBatch, KVStore, KVStoreProvider } from '@quereus/store';
 /**
  * Options for creating a LevelDB provider.
  */
 export interface LevelDBProviderOptions {
     /**
-     * Base path for all LevelDB stores.
-     * Each table gets a subdirectory under this path.
+     * Base path for the single shared LevelDB database. Every table, index, the
+     * catalog, and stats live as sublevels inside this one physical store.
      */
     basePath: string;
     /**
-     * Create directories if they don't exist.
+     * Create the database if it doesn't exist.
      * @default true
      */
     createIfMissing?: boolean;
+    /**
+     * fsync each atomic transaction commit (the chained batch issued by
+     * {@link LevelDBProvider.beginAtomicBatch}) before resolving. Default true —
+     * a committed transaction then survives power loss, which is the crash-safe
+     * guarantee this layout exists to provide. The cost is one fsync per commit;
+     * set false to trade durability for lower commit latency.
+     * @default true
+     */
+    syncCommits?: boolean;
 }
 /**
- * LevelDB implementation of KVStoreProvider.
- *
- * Creates separate LevelDB databases for each table, stored
- * in subdirectories under the configured base path.
+ * LevelDB implementation of KVStoreProvider over a single shared root with one
+ * sublevel per logical store.
  */
 export declare class LevelDBProvider implements KVStoreProvider {
     private basePath;
     private createIfMissing;
+    private syncCommits;
+    /** The shared physical root, once opened. */
+    private root;
+    /** Memoized in-flight root open so concurrent first-opens share one handle. */
+    private rootOpening;
+    /** Cached store handles, keyed by store (sublevel) name. */
     private stores;
-    private storePaths;
-    private catalogStore;
-    private statsStore;
+    /** In-flight sublevel opens, keyed by store name, so concurrent callers dedupe. */
+    private storeOpening;
+    /**
+     * Sublevel + ownership proof for every store this provider produced. Used by the
+     * atomic batch to map a {@link KVStore} handle back to its sublevel and to reject
+     * a foreign handle (a non-LevelDB store, or one from another provider, is absent).
+     */
+    private sublevelByStore;
     constructor(options: LevelDBProviderOptions);
-    getStore(schemaName: string, tableName: string, options?: Record<string, unknown>): Promise<KVStore>;
+    getStore(schemaName: string, tableName: string, _options?: Record<string, unknown>): Promise<KVStore>;
     getIndexStore(schemaName: string, tableName: string, indexName: string): Promise<KVStore>;
     getStatsStore(_schemaName: string, _tableName: string): Promise<KVStore>;
     getCatalogStore(): Promise<KVStore>;
@@ -47,10 +75,38 @@ export declare class LevelDBProvider implements KVStoreProvider {
     closeIndexStore(schemaName: string, tableName: string, indexName: string): Promise<void>;
     closeAll(): Promise<void>;
     deleteIndexStore(schemaName: string, tableName: string, indexName: string): Promise<void>;
-    renameTableStores(schemaName: string, oldName: string, newName: string): Promise<void>;
-    deleteTableStores(schemaName: string, tableName: string): Promise<void>;
+    renameTableStores(schemaName: string, oldName: string, newName: string, indexNames: readonly string[]): Promise<void>;
+    deleteTableStores(schemaName: string, tableName: string, indexNames: readonly string[]): Promise<void>;
+    /**
+     * Open an atomic batch across this provider's sublevels, or undefined when the
+     * shared root has not been opened yet (no stores exist → nothing to commit).
+     *
+     * All sublevels share one physical LevelDB, so a single chained batch
+     * (`root.batch()…write()`) with each op targeting its sublevel commits them
+     * atomically and durably. The transaction coordinator uses this to commit a
+     * table's data + secondary-index stores in one physical batch, closing the
+     * crash window where a per-store loop could leave them divergent.
+     *
+     * In practice the coordinator only calls this once it has pending ops — which
+     * means stores (hence the root) were already opened — so the undefined branch
+     * is defensive (the coordinator falls back to per-store `batch()`).
+     */
+    beginAtomicBatch(): AtomicBatch | undefined;
+    /**
+     * Map a {@link KVStore} handle this provider handed out back to its sublevel.
+     * A handle not produced by this provider (wrong type, or from another provider)
+     * is absent from the ownership map — a programming error.
+     */
+    private resolveSublevel;
+    /** Open (memoized) the shared physical root database. */
+    private getRoot;
+    /** Create a sublevel handle over the shared root, with the store's byte encodings. */
+    private openSublevel;
     private getOrCreateStore;
+    private openSublevelStore;
     private closeStoreByName;
+    /** Clear a store's keyspace (sublevel.clear) and drop its cached handle. */
+    private clearAndDropStore;
 }
 /**
  * Create a LevelDB provider with the given options.

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

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAI/D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,eAAe;IACtD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,UAAU,CAA6B;gBAEnC,OAAO,EAAE,sBAAsB;IAKrC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAMpG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMzF,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYxE,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAWnC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhE,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBzB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzF,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoDtF,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAuC/D,gBAAgB;YAehB,gBAAgB;CAU9B;AAeD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAEtF"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAuC5E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,eAAgB,YAAW,eAAe;IACtD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,WAAW,CAAU;IAE7B,6CAA6C;IAC7C,OAAO,CAAC,IAAI,CAA0B;IACtC,+EAA+E;IAC/E,OAAO,CAAC,WAAW,CAAmC;IAEtD,4DAA4D;IAC5D,OAAO,CAAC,MAAM,CAAmC;IACjD,mFAAmF;IACnF,OAAO,CAAC,YAAY,CAA4C;IAChE;;;;OAIG;IACH,OAAO,CAAC,eAAe,CAAoC;gBAE/C,OAAO,EAAE,sBAAsB;IAMrC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAOrG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzF,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxE,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAInC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBzB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzF,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0ErH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB5G;;;;;;;;;;;;;OAaG;IACH,gBAAgB,IAAI,WAAW,GAAG,SAAS;IAM3C;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAWvB,yDAAyD;YAC3C,OAAO;IAoBrB,sFAAsF;IACtF,OAAO,CAAC,YAAY;YAON,gBAAgB;YA2BhB,iBAAiB;YASjB,gBAAgB;IAU9B,4EAA4E;YAC9D,iBAAiB;CAK/B;AAqDD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAEtF"}

package/dist/src/provider.js

@@ -1,213 +1,363 @@
 /**
- * LevelDB KVStore provider implementation.
+ * LevelDB KVStoreProvider — shared-root layout.
  *
- * Manages LevelDB stores for the StoreModule.
+ * All of a database's stores live inside ONE physical LevelDB at `basePath`, each
+ * as a sublevel keyed by its store name:
  *
- * Storage naming convention:
- *   {basePath}/{schema}/{table}              - Data store (row data)
- *   {basePath}/{schema}/{table}_idx_{name}   - Index store (secondary indexes)
- *   {basePath}/__stats__                     - Unified stats store (row counts for all tables)
- *   {basePath}/__catalog__                   - Catalog store (DDL metadata)
+ *   {schema}.{table}            - table data       (buildDataStoreName)
+ *   {schema}.{table}_idx_{name} - secondary index  (buildIndexStoreName)
+ *   __stats__                   - unified stats     (STATS_STORE_NAME)
+ *   __catalog__                 - catalog / DDL     (CATALOG_STORE_NAME)
+ *
+ * Because every sublevel shares one physical store, a single chained batch
+ * (`root.batch()…write()`) commits across sublevels atomically and durably — see
+ * {@link LevelDBProvider.beginAtomicBatch}. This is the crash-safe single commit
+ * that the prior per-directory layout (a separate ClassicLevel per table) could
+ * not provide: separate physical databases cannot share a write batch.
+ *
+ * HARD CUTOVER: this is the only LevelDB layout. Databases written by the prior
+ * per-directory layout (`{basePath}/{schema}/{table}`) are NOT read here and must
+ * be re-created (pre-1.0 dev data). There is no on-disk migration. See README.
  */
-import path from 'node:path';
-import fs from 'node:fs';
-import { STORE_SUFFIX, CATALOG_STORE_NAME, STATS_STORE_NAME } from '@quereus/store';
+import { ClassicLevel } from 'classic-level';
+import { buildDataStoreName, buildIndexStoreName, CATALOG_STORE_NAME, STATS_STORE_NAME } from '@quereus/store';
+import { QuereusError, StatusCode } from '@quereus/quereus';
 import { LevelDBStore } from './store.js';
+const textEncoder = new TextEncoder();
 /**
- * LevelDB implementation of KVStoreProvider.
+ * Encode a logical store name into a sublevel-safe name.
  *
- * Creates separate LevelDB databases for each table, stored
- * in subdirectories under the configured base path.
+ * abstract-level requires every byte of a sublevel name to be in `(separator, 127)`
+ * — with the default `!` separator that is 35..126. Logical store names are
+ * `{schema}.{table}` identifiers that may contain spaces, punctuation, or non-ASCII
+ * (e.g. a quoted table name `"Table With Spaces"`), so any byte outside the safe set
+ * is percent-encoded. The mapping is deterministic and injective (distinct logical
+ * names → distinct sublevel names), which is all the provider's name-keyed caching
+ * and the StoreModule's collision checks require; the sublevel name is never decoded
+ * back. Common names (lowercase identifiers, `.`, `_`) pass through unchanged.
+ */
+function encodeSublevelName(name) {
+    let out = '';
+    for (const b of textEncoder.encode(name)) {
+        // Safe: printable ASCII in (34, 127) except '%' (0x25), which is reserved as
+        // the escape introducer so the encoding stays injective.
+        if (b > 34 && b < 127 && b !== 0x25) {
+            out += String.fromCharCode(b);
+        }
+        else {
+            out += '%' + b.toString(16).toUpperCase().padStart(2, '0');
+        }
+    }
+    return out;
+}
+/**
+ * LevelDB implementation of KVStoreProvider over a single shared root with one
+ * sublevel per logical store.
  */
 export class LevelDBProvider {
     basePath;
     createIfMissing;
+    syncCommits;
+    /** The shared physical root, once opened. */
+    root = null;
+    /** Memoized in-flight root open so concurrent first-opens share one handle. */
+    rootOpening = null;
+    /** Cached store handles, keyed by store (sublevel) name. */
     stores = new Map();
-    storePaths = new Map();
-    catalogStore = null;
-    statsStore = null;
+    /** In-flight sublevel opens, keyed by store name, so concurrent callers dedupe. */
+    storeOpening = new Map();
+    /**
+     * Sublevel + ownership proof for every store this provider produced. Used by the
+     * atomic batch to map a {@link KVStore} handle back to its sublevel and to reject
+     * a foreign handle (a non-LevelDB store, or one from another provider, is absent).
+     */
+    sublevelByStore = new WeakMap();
     constructor(options) {
         this.basePath = options.basePath;
         this.createIfMissing = options.createIfMissing ?? true;
+        this.syncCommits = options.syncCommits ?? true;
     }
-    async getStore(schemaName, tableName, options) {
-        const storeName = `${schemaName}.${tableName}`.toLowerCase();
-        const storePath = options?.path || path.join(this.basePath, schemaName, tableName);
-        return this.getOrCreateStore(storeName, storePath);
+    async getStore(schemaName, tableName, _options) {
+        // NOTE: the prior per-directory layout honored an `options.path` override to
+        // place a table's database elsewhere. With one shared root there is no
+        // per-table path, so the override is gone (the engine never passed it).
+        return this.getOrCreateStore(buildDataStoreName(schemaName, tableName));
     }
     async getIndexStore(schemaName, tableName, indexName) {
-        const storeName = `${schemaName}.${tableName}${STORE_SUFFIX.INDEX}${indexName}`.toLowerCase();
-        const storePath = path.join(this.basePath, schemaName, `${tableName}${STORE_SUFFIX.INDEX}${indexName}`);
-        return this.getOrCreateStore(storeName, storePath);
+        return this.getOrCreateStore(buildIndexStoreName(schemaName, tableName, indexName));
     }
     async getStatsStore(_schemaName, _tableName) {
-        // Use the unified __stats__ store for all tables
-        if (!this.statsStore) {
-            const statsPath = path.join(this.basePath, STATS_STORE_NAME);
-            this.statsStore = await LevelDBStore.open({
-                path: statsPath,
-                createIfMissing: this.createIfMissing,
-            });
-        }
-        return this.statsStore;
+        // Unified __stats__ store for all tables.
+        return this.getOrCreateStore(STATS_STORE_NAME);
     }
     async getCatalogStore() {
-        if (!this.catalogStore) {
-            const catalogPath = path.join(this.basePath, CATALOG_STORE_NAME);
-            this.catalogStore = await LevelDBStore.open({
-                path: catalogPath,
-                createIfMissing: this.createIfMissing,
-            });
-        }
-        return this.catalogStore;
+        return this.getOrCreateStore(CATALOG_STORE_NAME);
     }
     async closeStore(schemaName, tableName) {
-        const storeName = `${schemaName}.${tableName}`.toLowerCase();
-        await this.closeStoreByName(storeName);
+        await this.closeStoreByName(buildDataStoreName(schemaName, tableName));
     }
     async closeIndexStore(schemaName, tableName, indexName) {
-        const storeName = `${schemaName}.${tableName}${STORE_SUFFIX.INDEX}${indexName}`.toLowerCase();
-        await this.closeStoreByName(storeName);
+        await this.closeStoreByName(buildIndexStoreName(schemaName, tableName, indexName));
     }
     async closeAll() {
+        // Await any in-flight opens (stores + root) first so we don't strand a
+        // freshly-opened sublevel/root after clearing the caches and closing the root.
+        await Promise.allSettled([
+            ...this.storeOpening.values(),
+            this.rootOpening,
+        ].filter(Boolean));
+        // Close each cached sublevel handle, then close the root. Closing the root
+        // would itself cascade to attached sublevels, but closing handles first
+        // marks our store wrappers closed and keeps the close ordering explicit.
         for (const store of this.stores.values()) {
             await store.close();
         }
         this.stores.clear();
-        if (this.catalogStore) {
-            await this.catalogStore.close();
-            this.catalogStore = null;
-        }
-        if (this.statsStore) {
-            await this.statsStore.close();
-            this.statsStore = null;
+        this.storeOpening.clear();
+        if (this.root) {
+            await this.root.close();
+            this.root = null;
         }
+        this.rootOpening = null;
     }
     async deleteIndexStore(schemaName, tableName, indexName) {
-        const storeName = `${schemaName}.${tableName}${STORE_SUFFIX.INDEX}${indexName}`.toLowerCase();
-        const storePath = this.storePaths.get(storeName)
-            ?? path.join(this.basePath, schemaName, `${tableName}${STORE_SUFFIX.INDEX}${indexName}`);
-        await this.closeStoreByName(storeName);
-        await removeDir(storePath);
+        await this.clearAndDropStore(buildIndexStoreName(schemaName, tableName, indexName));
     }
-    async renameTableStores(schemaName, oldName, newName) {
-        const oldDataStoreName = `${schemaName}.${oldName}`.toLowerCase();
-        const newDataStoreName = `${schemaName}.${newName}`.toLowerCase();
+    async renameTableStores(schemaName, oldName, newName, indexNames) {
+        const root = await this.getRoot();
+        const oldDataStoreName = buildDataStoreName(schemaName, oldName);
+        const newDataStoreName = buildDataStoreName(schemaName, newName);
         if (this.stores.has(newDataStoreName)) {
             throw new Error(`Cannot rename '${oldName}' to '${newName}': store already open under the new name`);
         }
-        // Close all open handles for the old table (data + indexes) so LevelDB
-        // releases its file locks before we move the directories.
-        await this.closeStoreByName(oldDataStoreName);
-        const oldIndexPrefix = `${schemaName}.${oldName}${STORE_SUFFIX.INDEX}`.toLowerCase();
-        const indexStoreNames = [];
-        for (const name of this.stores.keys()) {
-            if (name.startsWith(oldIndexPrefix))
-                indexStoreNames.push(name);
-        }
-        for (const name of indexStoreNames) {
-            await this.closeStoreByName(name);
-        }
-        // Move data directory, if present.
-        const schemaDir = path.join(this.basePath, schemaName);
-        const oldDataPath = path.join(schemaDir, oldName);
-        const newDataPath = path.join(schemaDir, newName);
-        if (await pathExists(oldDataPath)) {
-            if (await pathExists(newDataPath)) {
-                throw new Error(`Cannot rename '${oldName}' to '${newName}': destination path '${newDataPath}' already exists`);
-            }
-            await fs.promises.rename(oldDataPath, newDataPath);
+        // (old → new) store-name pairs: data store + each schema index, built
+        // exact-by-name via buildIndexStoreName — never a `${oldName}_idx_` prefix
+        // scan, which would also match a sibling table literally named
+        // `${oldName}_idx_<x>` (its data store) and relocate its keys.
+        const pairs = [
+            { old: oldDataStoreName, new: newDataStoreName },
+        ];
+        for (const indexName of indexNames) {
+            pairs.push({
+                old: buildIndexStoreName(schemaName, oldName, indexName),
+                new: buildIndexStoreName(schemaName, newName, indexName),
+            });
         }
-        // Move each index directory under the new table name.
-        const oldIndexDirPrefix = `${oldName}${STORE_SUFFIX.INDEX}`;
+        // Open destination sublevels and assert each is empty BEFORE moving anything.
+        // A non-empty (or already-open) destination is a silent clobber/merge — this
+        // is the backstop equivalent of the prior fs "destination already exists"
+        // guard (e.g. an index relocating onto a sibling table's data store).
+        const destSublevels = new Map();
         try {
-            const entries = await fs.promises.readdir(schemaDir);
-            for (const entry of entries) {
-                if (!entry.startsWith(oldIndexDirPrefix))
-                    continue;
-                const indexSuffix = entry.substring(oldIndexDirPrefix.length);
-                const renamed = `${newName}${STORE_SUFFIX.INDEX}${indexSuffix}`;
-                await fs.promises.rename(path.join(schemaDir, entry), path.join(schemaDir, renamed));
+            for (const pair of pairs) {
+                if (this.stores.has(pair.new)) {
+                    throw new Error(`Cannot rename '${oldName}' to '${newName}': destination store '${pair.new}' already open`);
+                }
+                const dest = this.openSublevel(root, pair.new);
+                await dest.open();
+                if (await sublevelHasAnyKey(dest)) {
+                    throw new Error(`Cannot rename '${oldName}' to '${newName}': destination store '${pair.new}' already exists`);
+                }
+                destSublevels.set(pair.new, dest);
+            }
+            // Relocate every pair's keys in ONE chained batch over the shared root:
+            // put → new sublevel, del → old sublevel. A single write() is atomic and
+            // durable, so the rename is all-or-nothing across data + every index.
+            const batch = root.batch();
+            for (const pair of pairs) {
+                const oldStore = await this.getOrCreateStore(pair.old);
+                const oldSublevel = this.sublevelByStore.get(oldStore);
+                const dest = destSublevels.get(pair.new);
+                for await (const { key, value } of oldStore.iterate()) {
+                    batch.put(key, value, { sublevel: dest });
+                    batch.del(key, { sublevel: oldSublevel });
+                }
+            }
+            if (batch.length > 0) {
+                await batch.write({ sync: this.syncCommits });
+            }
+            else {
+                await batch.close();
+            }
+            // Drop old handles so subsequent getStore/getIndexStore open fresh
+            // sublevels under the new name (the old keyspaces are now empty).
+            for (const pair of pairs) {
+                await this.closeStoreByName(pair.old);
             }
         }
-        catch (e) {
-            // readdir can fail if the schema directory doesn't exist (pre-creation);
-            // that just means there's nothing to move.
-            if (e.code !== 'ENOENT')
-                throw e;
+        finally {
+            // Close the temporary destination handles; the next getStore(newName)
+            // opens and caches a fresh sublevel over the now-populated keyspace.
+            for (const dest of destSublevels.values()) {
+                await dest.close().catch(() => { });
+            }
         }
     }
-    async deleteTableStores(schemaName, tableName) {
-        // Close and remove data store directory
-        const dataStoreName = `${schemaName}.${tableName}`.toLowerCase();
-        const dataStorePath = this.storePaths.get(dataStoreName)
-            ?? path.join(this.basePath, schemaName, tableName);
-        await this.closeStoreByName(dataStoreName);
-        await removeDir(dataStorePath);
-        // Stats are in the unified __stats__ store, so no need to close a separate store
-        // The individual stats entry will be removed by the calling code if needed
-        // Close and remove all index store directories for this table
-        const indexPrefix = `${schemaName}.${tableName}${STORE_SUFFIX.INDEX}`.toLowerCase();
-        const indexStoreNames = [];
-        for (const name of this.stores.keys()) {
-            if (name.startsWith(indexPrefix))
-                indexStoreNames.push(name);
-        }
-        for (const name of indexStoreNames) {
-            const indexPath = this.storePaths.get(name);
-            await this.closeStoreByName(name);
-            if (indexPath)
-                await removeDir(indexPath);
-        }
-        // Also sweep any on-disk index directories for this table that were never opened
-        // in this session (e.g. after a process restart followed by a DROP).
-        const schemaDir = path.join(this.basePath, schemaName);
-        const indexDirPrefix = `${tableName}${STORE_SUFFIX.INDEX}`;
-        try {
-            const entries = await fs.promises.readdir(schemaDir);
-            for (const entry of entries) {
-                if (entry.startsWith(indexDirPrefix)) {
-                    await removeDir(path.join(schemaDir, entry));
-                }
-            }
+    async deleteTableStores(schemaName, tableName, indexNames) {
+        // Clear and drop the data store's keyspace.
+        await this.clearAndDropStore(buildDataStoreName(schemaName, tableName));
+        // Stats live in the unified __stats__ store; the individual stats entry is
+        // removed by the calling code (StoreModule), not by clearing a store.
+        // Clear exactly the table's index stores (by name). Built via
+        // buildIndexStoreName from the authoritative schema index list — never a
+        // `${tableName}_idx_` prefix scan, which would also match a sibling table
+        // literally named `${tableName}_idx_<x>` and destroy its data.
+        for (const indexName of indexNames) {
+            await this.clearAndDropStore(buildIndexStoreName(schemaName, tableName, indexName));
         }
-        catch {
-            // Schema directory may not exist; nothing to sweep.
+    }
+    /**
+     * Open an atomic batch across this provider's sublevels, or undefined when the
+     * shared root has not been opened yet (no stores exist → nothing to commit).
+     *
+     * All sublevels share one physical LevelDB, so a single chained batch
+     * (`root.batch()…write()`) with each op targeting its sublevel commits them
+     * atomically and durably. The transaction coordinator uses this to commit a
+     * table's data + secondary-index stores in one physical batch, closing the
+     * crash window where a per-store loop could leave them divergent.
+     *
+     * In practice the coordinator only calls this once it has pending ops — which
+     * means stores (hence the root) were already opened — so the undefined branch
+     * is defensive (the coordinator falls back to per-store `batch()`).
+     */
+    beginAtomicBatch() {
+        const root = this.root;
+        if (!root)
+            return undefined;
+        return new LevelDBAtomicBatch(root, (store) => this.resolveSublevel(store), this.syncCommits);
+    }
+    /**
+     * Map a {@link KVStore} handle this provider handed out back to its sublevel.
+     * A handle not produced by this provider (wrong type, or from another provider)
+     * is absent from the ownership map — a programming error.
+     */
+    resolveSublevel(store) {
+        const sublevel = this.sublevelByStore.get(store);
+        if (!sublevel) {
+            throw new QuereusError('AtomicBatch received a KVStore handle not produced by this provider', StatusCode.MISUSE);
         }
+        return sublevel;
     }
-    async getOrCreateStore(storeName, storePath) {
-        let store = this.stores.get(storeName);
-        if (!store) {
-            store = await LevelDBStore.open({
-                path: storePath,
+    /** Open (memoized) the shared physical root database. */
+    async getRoot() {
+        if (this.root)
+            return this.root;
+        if (!this.rootOpening) {
+            const db = new ClassicLevel(this.basePath, {
+                keyEncoding: 'view',
+                valueEncoding: 'view',
                 createIfMissing: this.createIfMissing,
             });
-            this.stores.set(storeName, store);
-            this.storePaths.set(storeName, storePath);
+            this.rootOpening = db.open().then(() => {
+                this.root = db;
+                this.rootOpening = null;
+                return db;
+            }).catch(err => {
+                this.rootOpening = null;
+                throw err;
+            });
+        }
+        return this.rootOpening;
+    }
+    /** Create a sublevel handle over the shared root, with the store's byte encodings. */
+    openSublevel(root, storeName) {
+        return root.sublevel(encodeSublevelName(storeName), {
+            keyEncoding: 'view',
+            valueEncoding: 'view',
+        });
+    }
+    async getOrCreateStore(storeName) {
+        const existing = this.stores.get(storeName);
+        if (existing && !existing.isClosed())
+            return existing;
+        if (existing) {
+            // A handle handed out earlier was closed out-of-band (e.g. the StoreTable's
+            // releaseIndexStore closes the index handle before dropIndex calls
+            // deleteIndexStore). Evict the stale entry and reopen a fresh sublevel.
+            this.stores.delete(storeName);
+        }
+        // Share a single in-flight open across concurrent callers for the same store
+        // name so we cache exactly one handle (and one sublevel) per name.
+        let opening = this.storeOpening.get(storeName);
+        if (!opening) {
+            opening = this.openSublevelStore(storeName).then(store => {
+                this.stores.set(storeName, store);
+                this.storeOpening.delete(storeName);
+                return store;
+            }).catch(err => {
+                this.storeOpening.delete(storeName);
+                throw err;
+            });
+            this.storeOpening.set(storeName, opening);
         }
+        return opening;
+    }
+    async openSublevelStore(storeName) {
+        const root = await this.getRoot();
+        const sublevel = this.openSublevel(root, storeName);
+        await sublevel.open();
+        const store = LevelDBStore.overSublevel(sublevel);
+        this.sublevelByStore.set(store, sublevel);
         return store;
     }
     async closeStoreByName(storeName) {
         const store = this.stores.get(storeName);
         if (store) {
-            // Remove from maps before awaiting close, so a concurrent
+            // Remove from the map before awaiting close, so a concurrent
             // getOrCreateStore cannot observe a store that is about to be closed.
             this.stores.delete(storeName);
-            this.storePaths.delete(storeName);
-            await store.close();
+            await store.close(); // drops the sublevel handle; the shared root stays open
         }
     }
+    /** Clear a store's keyspace (sublevel.clear) and drop its cached handle. */
+    async clearAndDropStore(storeName) {
+        const store = await this.getOrCreateStore(storeName);
+        await store.clear();
+        await this.closeStoreByName(storeName);
+    }
 }
-async function removeDir(dirPath) {
-    await fs.promises.rm(dirPath, { recursive: true, force: true });
-}
-async function pathExists(p) {
-    try {
-        await fs.promises.access(p);
+/** True if the sublevel has at least one key. */
+async function sublevelHasAnyKey(sublevel) {
+    for await (const _key of sublevel.keys({ limit: 1 })) {
         return true;
     }
-    catch {
-        return false;
+    return false;
+}
+/**
+ * {@link AtomicBatch} over the shared root's chained batch.
+ *
+ * Every op targets its store's sublevel via the chained-batch `{ sublevel }`
+ * option, so a single `write()` commits across all referenced sublevels in one
+ * atomic, durable physical commit. Handles are mapped to sublevels by the
+ * provider's `resolveSublevel`.
+ */
+class LevelDBAtomicBatch {
+    resolveSublevel;
+    sync;
+    batch;
+    constructor(root, resolveSublevel, sync) {
+        this.resolveSublevel = resolveSublevel;
+        this.sync = sync;
+        this.batch = root.batch();
+    }
+    put(store, key, value) {
+        this.batch.put(key, value, { sublevel: this.resolveSublevel(store) });
+    }
+    delete(store, key) {
+        this.batch.del(key, { sublevel: this.resolveSublevel(store) });
+    }
+    async write() {
+        if (this.batch.length === 0) {
+            // Free the chained batch's resources without a no-op commit.
+            await this.batch.close();
+            return;
+        }
+        // sync=true → fsync the commit so a committed transaction survives power loss
+        // (the crash-safe commit this layout exists to provide). One fsync per commit.
+        await this.batch.write({ sync: this.sync });
+    }
+    clear() {
+        this.batch.clear();
     }
 }
 /**

package/dist/src/provider.js.map

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

package/dist/src/store.d.ts

@@ -1,27 +1,67 @@
 /**
  * LevelDB-based KVStore implementation for Node.js.
  *
- * Uses classic-level for LevelDB bindings.
+ * Backed by classic-level. A store operates over an abstract-level handle
+ * ({@link ViewLevel}) which is EITHER:
+ *
+ *  - a standalone {@link ClassicLevel} this store owns (via {@link LevelDBStore.open}) —
+ *    a single physical key-value database used directly (e.g. sync metadata); or
+ *  - a sublevel of a shared root opened by `LevelDBProvider` (the StoreModule
+ *    backend), where every table, index, the catalog, and stats share ONE physical
+ *    LevelDB. See `provider.ts`.
+ *
+ * `close()` closes the handle. For a standalone store that closes the physical
+ * database; for a sublevel it drops the sublevel handle while the shared root
+ * stays open (the provider owns the root's lifecycle) — mirroring how
+ * `IndexedDBStore.close()` is a per-store handle drop over the shared database.
  */
-import type { KVStore, KVEntry, WriteBatch, IterateOptions, KVStoreOptions } from '@quereus/store';
+import type { AbstractLevel } from 'abstract-level';
+import type { KVStore, KVEntry, WriteBatch, IterateOptions, KVStoreOptions, WriteOptions } from '@quereus/store';
 /**
- * LevelDB implementation of KVStore.
+ * Operational handle: the subset of an abstract-level database this store drives.
+ * Both a root {@link ClassicLevel} and one of its sublevels satisfy it — both store
+ * raw `Uint8Array` keys/values under the `'view'` encoding.
+ */
+export type ViewLevel = AbstractLevel<string | Buffer | Uint8Array, Uint8Array, Uint8Array>;
+/**
+ * LevelDB implementation of KVStore over an abstract-level handle.
  */
 export declare class LevelDBStore implements KVStore {
-    private db;
+    private level;
     private closed;
     private constructor();
     /**
-     * Open a LevelDB store.
+     * Open a standalone LevelDB store as its own physical database at `options.path`.
+     *
+     * For single-database key-value use (e.g. sync metadata). The multi-table
+     * StoreModule backend does NOT use this — it opens one shared root and hands
+     * out sublevel-backed stores via `LevelDBProvider`.
      */
     static open(options: KVStoreOptions): Promise<LevelDBStore>;
+    /**
+     * Wrap a sublevel of a shared root as a store. The provider opens the sublevel
+     * (off its single root) and owns the root's lifecycle; this store's `close()`
+     * only drops the sublevel handle. The sublevel MUST be opened by the caller.
+     */
+    static overSublevel(sublevel: ViewLevel): LevelDBStore;
     get(key: Uint8Array): Promise<Uint8Array | undefined>;
-    put(key: Uint8Array, value: Uint8Array): Promise<void>;
-    delete(key: Uint8Array): Promise<void>;
+    put(key: Uint8Array, value: Uint8Array, options?: WriteOptions): Promise<void>;
+    delete(key: Uint8Array, options?: WriteOptions): Promise<void>;
     has(key: Uint8Array): Promise<boolean>;
     iterate(options?: IterateOptions): AsyncIterable<KVEntry>;
     batch(): WriteBatch;
+    /**
+     * Delete every entry in this store's keyspace. For a sublevel this clears only
+     * the sublevel's own prefix range — never a sibling sublevel of the shared root.
+     */
+    clear(): Promise<void>;
     close(): Promise<void>;
+    /**
+     * Whether this handle has been closed. The provider consults this to evict a
+     * cached handle that was closed out-of-band by a consumer (e.g. a StoreTable
+     * releasing an index store before a drop) and reopen a fresh one.
+     */
+    isClosed(): boolean;
     approximateCount(options?: IterateOptions): Promise<number>;
     private checkOpen;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEnG;;GAEG;AACH,qBAAa,YAAa,YAAW,OAAO;IAC1C,OAAO,CAAC,EAAE,CAAuC;IACjD,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO;IAIP;;OAEG;WACU,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAY3D,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;IAOrC,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC,OAAO,CAAC;IA0BhE,KAAK,IAAI,UAAU;IAKb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,gBAAgB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAWjE,OAAO,CAAC,SAAS;CAKlB"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EACX,aAAa,EAKb,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEjH;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,GAAG,MAAM,GAAG,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAa5F;;GAEG;AACH,qBAAa,YAAa,YAAW,OAAO;IAC3C,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO;IAIP;;;;;;OAMG;WACU,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAYjE;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,SAAS,GAAG,YAAY;IAIhD,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAMrD,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9E,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9D,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrC,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC,OAAO,CAAC;IA0BhE,KAAK,IAAI,UAAU;IAKnB;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;;;OAIG;IACH,QAAQ,IAAI,OAAO;IAIb,gBAAgB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAWjE,OAAO,CAAC,SAAS;CAKjB"}

package/dist/src/store.js

@@ -1,20 +1,36 @@
 /**
  * LevelDB-based KVStore implementation for Node.js.
  *
- * Uses classic-level for LevelDB bindings.
+ * Backed by classic-level. A store operates over an abstract-level handle
+ * ({@link ViewLevel}) which is EITHER:
+ *
+ *  - a standalone {@link ClassicLevel} this store owns (via {@link LevelDBStore.open}) —
+ *    a single physical key-value database used directly (e.g. sync metadata); or
+ *  - a sublevel of a shared root opened by `LevelDBProvider` (the StoreModule
+ *    backend), where every table, index, the catalog, and stats share ONE physical
+ *    LevelDB. See `provider.ts`.
+ *
+ * `close()` closes the handle. For a standalone store that closes the physical
+ * database; for a sublevel it drops the sublevel handle while the shared root
+ * stays open (the provider owns the root's lifecycle) — mirroring how
+ * `IndexedDBStore.close()` is a per-store handle drop over the shared database.
  */
 import { ClassicLevel } from 'classic-level';
 /**
- * LevelDB implementation of KVStore.
+ * LevelDB implementation of KVStore over an abstract-level handle.
  */
 export class LevelDBStore {
-    db;
+    level;
     closed = false;
-    constructor(db) {
-        this.db = db;
+    constructor(level) {
+        this.level = level;
     }
     /**
-     * Open a LevelDB store.
+     * Open a standalone LevelDB store as its own physical database at `options.path`.
+     *
+     * For single-database key-value use (e.g. sync metadata). The multi-table
+     * StoreModule backend does NOT use this — it opens one shared root and hands
+     * out sublevel-backed stores via `LevelDBProvider`.
      */
     static async open(options) {
         const db = new ClassicLevel(options.path, {
@@ -26,24 +42,34 @@ export class LevelDBStore {
         await db.open();
         return new LevelDBStore(db);
     }
+    /**
+     * Wrap a sublevel of a shared root as a store. The provider opens the sublevel
+     * (off its single root) and owns the root's lifecycle; this store's `close()`
+     * only drops the sublevel handle. The sublevel MUST be opened by the caller.
+     */
+    static overSublevel(sublevel) {
+        return new LevelDBStore(sublevel);
+    }
     async get(key) {
         this.checkOpen();
-        // classic-level returns undefined for missing keys (doesn't throw)
-        return await this.db.get(key);
+        // abstract-level returns undefined for missing keys (doesn't throw)
+        return await this.level.get(key);
     }
-    async put(key, value) {
+    async put(key, value, options) {
         this.checkOpen();
-        await this.db.put(key, value);
+        // classic-level forwards `sync` to the underlying LevelDB write, fsync'ing the
+        // log before resolving when requested; sublevels forward it to the root.
+        const opts = { sync: options?.sync };
+        await this.level.put(key, value, opts);
     }
-    async delete(key) {
+    async delete(key, options) {
         this.checkOpen();
-        await this.db.del(key);
+        const opts = { sync: options?.sync };
+        await this.level.del(key, opts);
     }
     async has(key) {
         this.checkOpen();
-        // classic-level returns undefined for missing keys
-        const value = await this.db.get(key);
-        return value !== undefined;
+        return await this.level.has(key);
     }
     async *iterate(options) {
         this.checkOpen();
@@ -63,7 +89,7 @@ export class LevelDBStore {
             iteratorOptions.reverse = true;
         if (options?.limit !== undefined)
             iteratorOptions.limit = options.limit;
-        const iterator = this.db.iterator(iteratorOptions);
+        const iterator = this.level.iterator(iteratorOptions);
         try {
             for await (const [key, value] of iterator) {
                 yield { key, value };
@@ -75,18 +101,36 @@ export class LevelDBStore {
     }
     batch() {
         this.checkOpen();
-        return new LevelDBWriteBatch(this.db);
+        return new LevelDBWriteBatch(this.level);
+    }
+    /**
+     * Delete every entry in this store's keyspace. For a sublevel this clears only
+     * the sublevel's own prefix range — never a sibling sublevel of the shared root.
+     */
+    async clear() {
+        this.checkOpen();
+        await this.level.clear();
     }
     async close() {
         if (!this.closed) {
             this.closed = true;
-            await this.db.close();
+            // Standalone: closes the physical database. Sublevel: drops the sublevel
+            // handle (detaches from the root); the shared root stays open.
+            await this.level.close();
         }
     }
+    /**
+     * Whether this handle has been closed. The provider consults this to evict a
+     * cached handle that was closed out-of-band by a consumer (e.g. a StoreTable
+     * releasing an index store before a drop) and reopen a fresh one.
+     */
+    isClosed() {
+        return this.closed;
+    }
     async approximateCount(options) {
         this.checkOpen();
-        // LevelDB doesn't have a native count, so we iterate and count
-        // For large datasets, this could be optimized with sampling
+        // LevelDB doesn't have a native count, so we iterate and count.
+        // For large datasets, this could be optimized with sampling.
         let count = 0;
         for await (const _ of this.iterate(options)) {
             count++;
@@ -100,13 +144,14 @@ export class LevelDBStore {
     }
 }
 /**
- * WriteBatch implementation for LevelDB.
+ * WriteBatch implementation over a single abstract-level handle (the array-form
+ * `batch()`, which commits atomically within that handle).
  */
 class LevelDBWriteBatch {
-    db;
+    level;
     ops = [];
-    constructor(db) {
-        this.db = db;
+    constructor(level) {
+        this.level = level;
     }
     put(key, value) {
         this.ops.push({ type: 'put', key, value });
@@ -116,7 +161,7 @@ class LevelDBWriteBatch {
     }
     async write() {
         if (this.ops.length > 0) {
-            await this.db.batch(this.ops);
+            await this.level.batch(this.ops);
             this.ops = [];
         }
     }

package/dist/src/store.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quereus/plugin-leveldb",
-  "version": "3.3.0",
+  "version": "4.0.0",
   "type": "module",
   "description": "LevelDB storage plugin for Quereus - Node.js persistent storage",
   "keywords": [
@@ -37,9 +37,9 @@
     }
   },
   "peerDependencies": {
-    "@quereus/isolation": "^3.3.0",
-    "@quereus/quereus": "^3.3.0",
-    "@quereus/store": "^3.3.0"
+    "@quereus/isolation": "^4.0.0",
+    "@quereus/quereus": "^4.0.0",
+    "@quereus/store": "^4.0.0"
   },
   "engines": {
     "quereus": "^0.24.0"
@@ -56,14 +56,21 @@
         "label": "Base Path",
         "type": "string",
         "default": "./data",
-        "help": "Base directory for all LevelDB stores"
+        "help": "Directory of the single shared LevelDB database"
       },
       {
         "key": "createIfMissing",
         "label": "Create If Missing",
         "type": "boolean",
         "default": true,
-        "help": "Create directories if they don't exist"
+        "help": "Create the database if it doesn't exist"
+      },
+      {
+        "key": "syncCommits",
+        "label": "Sync Commits",
+        "type": "boolean",
+        "default": true,
+        "help": "fsync each transaction commit so it survives power loss (slower commits when on)"
       },
       {
         "key": "moduleName",
@@ -88,8 +95,9 @@
     "test": "cd ../.. && node --import ./packages/quereus-plugin-leveldb/register.mjs node_modules/mocha/bin/mocha.js \"packages/quereus-plugin-leveldb/test/**/*.spec.ts\" --reporter min --colors"
   },
   "dependencies": {
-    "@quereus/quereus": "^3.3.0",
-    "@quereus/store": "^3.3.0",
+    "@quereus/quereus": "^4.0.0",
+    "@quereus/store": "^4.0.0",
+    "abstract-level": "^3.1.0",
     "classic-level": "^3.0.0"
   },
   "devDependencies": {