@moltendb-web/core 1.6.0 → 1.8.0

package/README.md

@@ -95,7 +95,6 @@ import { MoltenDb } from '@moltendb-web/core';
 import { MoltenDbClient, WorkerTransport } from '@moltendb-web/query';
 
 const db = new MoltenDb('moltendb_demo', {
-  hotThreshold: 25000,          // Keep 25k docs in RAM per collection
   encryptionKey: 'my-secret',    // Enable transparent at-rest encryption
   writeMode: 'sync'             // Ensure every write is flushed to OPFS
 });
@@ -259,7 +258,6 @@ You can customise the database behavior by passing an options object to the `Mol
 
 ```ts
 const db = new MoltenDb('my-app', {
-  hotThreshold: 25000,           // Page to disk after 25k docs
   encryptionKey: 'user-secret',  // Secure at-rest storage in OPFS
   writeMode: 'sync'              // Ensure durability on every write
 });
@@ -270,7 +268,6 @@ await db.init();
 
 | Property | Type | Default | Description                                                                                                                                                                                                                                                      |
 | :--- | :--- | :--- |:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `hotThreshold` | `number` | `50000` | **Hybrid Bitcask Limit:** Maximum documents per collection to keep in RAM. When exceeded, the oldest documents are paged out to OPFS to save memory.                                                                                                             |
 | `encryptionKey` | `string` | `undefined` | **At-Rest Encryption:** If provided, all data written to OPFS is encrypted using XChaCha20-Poly1305. If omitted, data is stored as plain JSON.                                                                                                                   |
 | `writeMode` | `'async' \| 'sync'` | `'async'` | **Durability vs Speed:** `'async'` is blazing fast (high throughput), while `'sync'` ensures every write is flushed to disk before returning (safer but slower). **Note:** `async` is recommended for most web apps to avoid blocking during heavy write bursts. |
 | `workerUrl` | `string \| URL` | `undefined` | Custom path to the Web Worker script.                                                                                                                                                                                                                            |

package/dist/index.d.ts

@@ -1,8 +1,6 @@
 export interface MoltenDbOptions {
     /** URL or path to moltendb-worker.js. */
     workerUrl?: string | URL;
-    /** Maximum documents per collection to keep in RAM. Default: 50,000. */
-    hotThreshold?: number;
     /** Password for at-rest encryption. If not provided, data is stored as plain JSON. */
     encryptionKey?: string;
     /** Storage write mode: 'async' (default, high throughput) or 'sync' (durable). */
@@ -59,6 +57,20 @@ export declare class MoltenDb {
     getAll(collection: string): Promise<unknown[]>;
     delete(collection: string, key: string): Promise<void>;
     compact(): Promise<unknown>;
+    /**
+     * Truncate and close the OPFS file so the directory can be removed.
+     *
+     * Works from any tab — followers automatically route this through the leader
+     * via BroadcastChannel, so the leader worker (which holds the exclusive
+     * FileSystemSyncAccessHandle) is the one that actually closes the file.
+     *
+     * After this resolves, call:
+     *   `const root = await navigator.storage.getDirectory();`
+     *   `const root = await navigator.storage.getDirectory();`
+     *   `await root.removeEntry(dbName, { recursive: true });`
+     * then reload the page.
+     */
+    clearOpfs(): Promise<unknown>;
     disconnect(): void;
     terminate(): void;
 }

package/dist/index.js

@@ -120,7 +120,6 @@ export class MoltenDb {
         await this.sendMessage('init', {
             dbName: this.dbName,
             encryptionKey: this.options.encryptionKey,
-            hotThreshold: this.options.hotThreshold,
             inMemory: this.options.inMemory,
             maxBodySize: this.options.maxBodySize,
             maxKeysPerRequest: this.options.maxKeysPerRequest,
@@ -260,6 +259,22 @@ export class MoltenDb {
     compact() {
         return this.sendMessage('compact');
     }
+    /**
+     * Truncate and close the OPFS file so the directory can be removed.
+     *
+     * Works from any tab — followers automatically route this through the leader
+     * via BroadcastChannel, so the leader worker (which holds the exclusive
+     * FileSystemSyncAccessHandle) is the one that actually closes the file.
+     *
+     * After this resolves, call:
+     *   `const root = await navigator.storage.getDirectory();`
+     *   `const root = await navigator.storage.getDirectory();`
+     *   `await root.removeEntry(dbName, { recursive: true });`
+     * then reload the page.
+     */
+    clearOpfs() {
+        return this.sendMessage('clear_opfs');
+    }
     disconnect() {
         if (this.bc)
             this.bc.close();

package/dist/moltendb-worker.js

@@ -9,7 +9,7 @@ self.onmessage = async (e) => {
             initPromise = (async () => {
                 await init();
                 // Pass all config flags to Rust
-                const instance = await WorkerDb.create(payload.dbName, payload.hotThreshold, payload.encryptionKey, payload.writeMode, payload.maxBodySize, payload.maxKeysPerRequest, payload.inMemory);
+                const instance = await WorkerDb.create(payload.dbName, payload.encryptionKey, payload.writeMode, payload.maxBodySize, payload.maxKeysPerRequest, payload.inMemory);
                 // Listen to Rust and broadcast events
                 instance.subscribe((eventStr) => {
                     try {

package/dist/wasm/moltendb_core.d.ts

@@ -17,28 +17,6 @@ export class WorkerDb {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
-    /**
-     * Execute an analytics query and return the result as a JSON string.
-     *
-     * This is the method called by the dashboard's auto-refresh loop:
-     *   `const resultStr = db.analytics(JSON.stringify(query))`
-     *
-     * Takes a JSON string (not a JsValue) because the analytics query format
-     * is complex and easier to pass as a pre-serialized string from JavaScript.
-     *
-     * Returns a JSON string (not a JsValue) so JavaScript can parse it with
-     * `JSON.parse(resultStr)` and access `result` and `metadata`.
-     *
-     * Example input:
-     *   `'{"collection":"events","metric":{"type":"COUNT"},"where":{"event_type":"button_click"}}'`
-     *
-     * Example output:
-     *   `'{"result":42,"metadata":{"execution_time_ms":0,"rows_scanned":42}}'`
-     *
-     * `#[wasm_bindgen(js_name = analytics)]` sets the JavaScript method name to
-     * "analytics" (matching the call in analytics-worker.js).
-     */
-    analytics(query_json: string): string;
     /**
      * Initialize the database and open (or create) the OPFS storage file.
      *
@@ -56,7 +34,6 @@ export class WorkerDb {
      * # Arguments
      * * `db_name` — The name of the OPFS file to open (e.g. "click_analytics_db").
      *   Each unique name is a separate database file in the browser's OPFS storage.
-     * * `hot_threshold` — Optional maximum documents per collection to keep in RAM (default: 50,000).
      * * `encryption_key` — Optional password for at-rest encryption.
      * * `write_mode` — Optional write mode: "async" (default) or "sync".
      * * `max_body_size` — Optional maximum request body size in bytes (default: 10MB).
@@ -65,7 +42,7 @@ export class WorkerDb {
      *   When `true`, all data is lost when the worker is terminated — useful for ephemeral
      *   session caches or testing without touching OPFS storage.
      */
-    static create(db_name: string, hot_threshold?: number | null, encryption_key?: string | null, write_mode?: string | null, max_body_size?: number | null, max_keys_per_request?: number | null, in_memory?: boolean | null): Promise<WorkerDb>;
+    static create(db_name: string, encryption_key?: string | null, write_mode?: string | null, max_body_size?: number | null, max_keys_per_request?: number | null, in_memory?: boolean | null): Promise<WorkerDb>;
     /**
      * Route an incoming message from the JavaScript worker to the correct handler.
      *
@@ -100,12 +77,11 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly __wbg_workerdb_free: (a: number, b: number) => void;
-    readonly workerdb_analytics: (a: number, b: number, c: number, d: number) => void;
-    readonly workerdb_create: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => number;
+    readonly workerdb_create: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => number;
     readonly workerdb_handle_message: (a: number, b: number, c: number) => void;
     readonly workerdb_subscribe: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_4220: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_4230: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_3769: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_3781: (a: number, b: number, c: number, d: number) => void;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_export3: (a: number) => void;

package/dist/wasm/moltendb_core.js

@@ -30,47 +30,6 @@ export class WorkerDb {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_workerdb_free(ptr, 0);
     }
-    /**
-     * Execute an analytics query and return the result as a JSON string.
-     *
-     * This is the method called by the dashboard's auto-refresh loop:
-     *   `const resultStr = db.analytics(JSON.stringify(query))`
-     *
-     * Takes a JSON string (not a JsValue) because the analytics query format
-     * is complex and easier to pass as a pre-serialized string from JavaScript.
-     *
-     * Returns a JSON string (not a JsValue) so JavaScript can parse it with
-     * `JSON.parse(resultStr)` and access `result` and `metadata`.
-     *
-     * Example input:
-     *   `'{"collection":"events","metric":{"type":"COUNT"},"where":{"event_type":"button_click"}}'`
-     *
-     * Example output:
-     *   `'{"result":42,"metadata":{"execution_time_ms":0,"rows_scanned":42}}'`
-     *
-     * `#[wasm_bindgen(js_name = analytics)]` sets the JavaScript method name to
-     * "analytics" (matching the call in analytics-worker.js).
-     * @param {string} query_json
-     * @returns {string}
-     */
-    analytics(query_json) {
-        let deferred2_0;
-        let deferred2_1;
-        try {
-            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(query_json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-            const len0 = WASM_VECTOR_LEN;
-            wasm.workerdb_analytics(retptr, this.__wbg_ptr, ptr0, len0);
-            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
-            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-            deferred2_0 = r0;
-            deferred2_1 = r1;
-            return getStringFromWasm0(r0, r1);
-        } finally {
-            wasm.__wbindgen_add_to_stack_pointer(16);
-            wasm.__wbindgen_export4(deferred2_0, deferred2_1, 1);
-        }
-    }
     /**
      * Initialize the database and open (or create) the OPFS storage file.
      *
@@ -88,7 +47,6 @@ export class WorkerDb {
      * # Arguments
      * * `db_name` — The name of the OPFS file to open (e.g. "click_analytics_db").
      *   Each unique name is a separate database file in the browser's OPFS storage.
-     * * `hot_threshold` — Optional maximum documents per collection to keep in RAM (default: 50,000).
      * * `encryption_key` — Optional password for at-rest encryption.
      * * `write_mode` — Optional write mode: "async" (default) or "sync".
      * * `max_body_size` — Optional maximum request body size in bytes (default: 10MB).
@@ -97,7 +55,6 @@ export class WorkerDb {
      *   When `true`, all data is lost when the worker is terminated — useful for ephemeral
      *   session caches or testing without touching OPFS storage.
      * @param {string} db_name
-     * @param {number | null} [hot_threshold]
      * @param {string | null} [encryption_key]
      * @param {string | null} [write_mode]
      * @param {number | null} [max_body_size]
@@ -105,14 +62,14 @@ export class WorkerDb {
      * @param {boolean | null} [in_memory]
      * @returns {Promise<WorkerDb>}
      */
-    static create(db_name, hot_threshold, encryption_key, write_mode, max_body_size, max_keys_per_request, in_memory) {
+    static create(db_name, encryption_key, write_mode, max_body_size, max_keys_per_request, in_memory) {
         const ptr0 = passStringToWasm0(db_name, wasm.__wbindgen_export, wasm.__wbindgen_export2);
         const len0 = WASM_VECTOR_LEN;
         var ptr1 = isLikeNone(encryption_key) ? 0 : passStringToWasm0(encryption_key, wasm.__wbindgen_export, wasm.__wbindgen_export2);
         var len1 = WASM_VECTOR_LEN;
         var ptr2 = isLikeNone(write_mode) ? 0 : passStringToWasm0(write_mode, wasm.__wbindgen_export, wasm.__wbindgen_export2);
         var len2 = WASM_VECTOR_LEN;
-        const ret = wasm.workerdb_create(ptr0, len0, isLikeNone(hot_threshold) ? 0x100000001 : (hot_threshold) >>> 0, ptr1, len1, ptr2, len2, isLikeNone(max_body_size) ? 0x100000001 : (max_body_size) >>> 0, isLikeNone(max_keys_per_request) ? 0x100000001 : (max_keys_per_request) >>> 0, isLikeNone(in_memory) ? 0xFFFFFF : in_memory ? 1 : 0);
+        const ret = wasm.workerdb_create(ptr0, len0, ptr1, len1, ptr2, len2, isLikeNone(max_body_size) ? 0x100000001 : (max_body_size) >>> 0, isLikeNone(max_keys_per_request) ? 0x100000001 : (max_keys_per_request) >>> 0, isLikeNone(in_memory) ? 0xFFFFFF : in_memory ? 1 : 0);
         return takeObject(ret);
     }
     /**
@@ -420,7 +377,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return __wasm_bindgen_func_elem_4230(a, state0.b, arg0, arg1);
+                        return __wasm_bindgen_func_elem_3781(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -455,14 +412,6 @@ function __wbg_get_imports() {
             const ret = Date.now();
             return ret;
         },
-        __wbg_now_e7c6795a7f81e10f: function(arg0) {
-            const ret = getObject(arg0).now();
-            return ret;
-        },
-        __wbg_performance_3fcf6e32a7e1ed0a: function(arg0) {
-            const ret = getObject(arg0).performance;
-            return addHeapObject(ret);
-        },
         __wbg_process_44c7a14e11e9f69e: function(arg0) {
             const ret = getObject(arg0).process;
             return addHeapObject(ret);
@@ -567,8 +516,8 @@ function __wbg_get_imports() {
             return ret;
         }, arguments); },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 774, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_4220);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 724, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_3769);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000002: function(arg0) {
@@ -610,10 +559,10 @@ function __wbg_get_imports() {
     };
 }
 
-function __wasm_bindgen_func_elem_4220(arg0, arg1, arg2) {
+function __wasm_bindgen_func_elem_3769(arg0, arg1, arg2) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.__wasm_bindgen_func_elem_4220(retptr, arg0, arg1, addHeapObject(arg2));
+        wasm.__wasm_bindgen_func_elem_3769(retptr, arg0, arg1, addHeapObject(arg2));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         if (r1) {
@@ -624,8 +573,8 @@ function __wasm_bindgen_func_elem_4220(arg0, arg1, arg2) {
     }
 }
 
-function __wasm_bindgen_func_elem_4230(arg0, arg1, arg2, arg3) {
-    wasm.__wasm_bindgen_func_elem_4230(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_3781(arg0, arg1, arg2, arg3) {
+    wasm.__wasm_bindgen_func_elem_3781(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
 }
 
 const WorkerDbFinalization = (typeof FinalizationRegistry === 'undefined')

package/dist/wasm/moltendb_core_bg.wasm.d.ts

@@ -2,12 +2,11 @@
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
 export const __wbg_workerdb_free: (a: number, b: number) => void;
-export const workerdb_analytics: (a: number, b: number, c: number, d: number) => void;
-export const workerdb_create: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => number;
+export const workerdb_create: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => number;
 export const workerdb_handle_message: (a: number, b: number, c: number) => void;
 export const workerdb_subscribe: (a: number, b: number) => void;
-export const __wasm_bindgen_func_elem_4220: (a: number, b: number, c: number, d: number) => void;
-export const __wasm_bindgen_func_elem_4230: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_3769: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_3781: (a: number, b: number, c: number, d: number) => void;
 export const __wbindgen_export: (a: number, b: number) => number;
 export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_export3: (a: number) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moltendb-web/core",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "MoltenDb WASM runtime — the database engine, Web Worker, and main-thread client in one package.",
   "type": "module",
   "author": "Maximilian Both <maximilian.both27@outlook.com>",