@moltendb-web/core 0.1.0-beta.1 → 0.1.0-beta.2

package/README.md

@@ -50,7 +50,30 @@ npm install @moltendb-web/core
 # Install the chainable query builder
 npm install @moltendb-web/query
 ```
+📦 **Bundler Setup**
 
+MoltenDB handles its own Web Workers and WASM loading automatically. However, depending on your build tool, you may need a tiny config tweak to ensure it serves the static files correctly.
+
+**For Vite:**
+Exclude the core package from pre-bundling in your vite.config.js:
+
+```js
+// vite.config.js`
+export default defineConfig({
+  optimizeDeps: { exclude: ['@moltendb-web/core'] }
+});
+```
+
+**For Webpack 5 (Next.js, Create React App):**
+Ensure Webpack treats the `.wasm` binary as a static resource in `webpack.config.js`:
+
+```js
+module.exports = {
+  module: {
+    rules: [{ test: /\.wasm$/, type: 'asset/resource' }]
+  }
+};
+```
 ---
 
 # Quick Start
@@ -62,12 +85,11 @@ TypeScript
 import { MoltenDB } from '@moltendb-web/core';
 import { MoltenDBClient, WorkerTransport } from '@moltendb-web/query';
 
-const workerUrl = new URL('@moltendb-web/core/worker', import.meta.url).href;
-const db = new MoltenDB('moltendb_demo', { syncEnabled: false, workerUrl });
+const db = new MoltenDB('moltendb_demo');
 await db.init();
 
 // Connect the query builder to the WASM worker
-const client = new MoltenDBClient(new WorkerTransport(db.worker));
+const client = new MoltenDBClient(db);
 
 // 2. Insert and Query
 

package/dist/index.d.ts

@@ -18,7 +18,7 @@ export type SyncCallback = (update: {
 }) => void;
 export declare class MoltenDB {
     readonly dbName: string;
-    readonly workerUrl: string | URL;
+    readonly workerUrl?: string | URL;
     worker: Worker | null;
     private messageId;
     private pendingRequests;

package/dist/index.js

@@ -20,8 +20,7 @@ export class MoltenDB {
     onEvent;
     constructor(dbName = 'moltendb', options = {}) {
         this.dbName = dbName;
-        // Zero-config default worker resolution
-        this.workerUrl = options.workerUrl ?? new URL('./moltendb-worker.js', import.meta.url).href;
+        this.workerUrl = options.workerUrl;
         this.syncEnabled = options.syncEnabled ?? false;
         this.serverUrl = options.serverUrl ?? 'wss://localhost:3000/ws';
         this.syncIntervalMs = options.syncIntervalMs ?? 5000;
@@ -57,7 +56,13 @@ export class MoltenDB {
         this.isLeader = true;
         if (this.worker)
             this.worker.terminate(); // Clean slate if promoted
-        this.worker = new Worker(this.workerUrl, { type: 'module', name: `moltendb-${this.dbName}-leader` });
+        // We must inline `new URL` directly inside `new Worker` so bundlers catch it!
+        if (this.workerUrl) {
+            this.worker = new Worker(this.workerUrl, { type: 'module', name: `moltendb-${this.dbName}-leader` });
+        }
+        else {
+            this.worker = new Worker(new URL('./moltendb-worker.js', import.meta.url), { type: 'module', name: `moltendb-${this.dbName}-leader` });
+        }
         // Handle messages strictly from our local Worker
         this.worker.onmessage = (e) => {
             const data = e.data;
@@ -83,7 +88,7 @@ export class MoltenDB {
         await new Promise((resolve, reject) => {
             const id = this.messageId++;
             this.pendingRequests.set(id, { resolve, reject });
-            this.worker.postMessage({ id, action: 'init', dbName: this.dbName, workerUrl: this.workerUrl });
+            this.worker.postMessage({ id, action: 'init', dbName: this.dbName });
         });
         // Listen to the BroadcastChannel for queries coming from Follower tabs
         this.bc.onmessage = async (e) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moltendb-web/core",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.2",
   "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>",
@@ -31,7 +31,7 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "typescript": "^6.0.1-rc"
+    "typescript": "^6.0.2"
   },
   "keywords": [
     "database",