@moltendb-web/core 1.0.0-rc.4 → 1.0.0-rc.5

package/dist/index.d.ts

@@ -13,6 +13,7 @@ export declare class MoltenDb {
     readonly dbName: string;
     readonly workerUrl?: string | URL;
     worker: Worker | null;
+    private initPromise;
     private pendingRequests;
     isLeader: boolean;
     private bc;
@@ -28,7 +29,6 @@ export declare class MoltenDb {
     /** Manually remove a specific listener */
     unsubscribe(listener: (event: DbEvent) => void): void;
     private dispatchEvent;
-    private initialized;
     init(): Promise<void>;
     private startAsLeader;
     private startAsFollower;

package/dist/index.js

@@ -3,6 +3,7 @@ export class MoltenDb {
     dbName;
     workerUrl;
     worker = null;
+    initPromise = null;
     pendingRequests = new Map();
     // Multi-tab Sync State
     isLeader = false;
@@ -39,13 +40,13 @@ export class MoltenDb {
         }
     }
     // ───────────────────────────────────────────────────────────────────────────
-    initialized = false;
-    async init() {
-        if (this.initialized)
-            return;
-        this.initialized = true;
-        this.bc = new BroadcastChannel(`moltendb_channel_${this.dbName}`);
-        return new Promise((resolveInit, rejectInit) => {
+    init() {
+        // 1. If initialization has already started or finished, return the existing promise
+        if (this.initPromise)
+            return this.initPromise;
+        // 2. Otherwise, start the initialization and store the promise
+        this.initPromise = new Promise((resolveInit, rejectInit) => {
+            this.bc = new BroadcastChannel(`moltendb_channel_${this.dbName}`);
             navigator.locks.request(`moltendb_lock_${this.dbName}`, { ifAvailable: true }, async (lock) => {
                 if (lock) {
                     try {
@@ -60,6 +61,7 @@ export class MoltenDb {
                 else {
                     this.startAsFollower();
                     resolveInit();
+                    // Wait in the background to become leader if the current leader dies
                     navigator.locks.request(`moltendb_lock_${this.dbName}`, async () => {
                         console.log(`[MoltenDb] Promoting this tab to Leader.`);
                         await this.startAsLeader();
@@ -68,6 +70,7 @@ export class MoltenDb {
                 }
             });
         });
+        return this.initPromise;
     }
     async startAsLeader() {
         // Guard: OPFS is required
@@ -139,21 +142,33 @@ export class MoltenDb {
         };
     }
     async sendMessage(action, payload) {
-        // Generate a unique ID (random fallback for test environments without crypto.randomUUID)
+        //  Wait for the engine to boot before routing the message.
+        // If the DB is already initialized, this resolves instantly.
+        if (action !== 'init') {
+            if (this.initPromise) {
+                await this.initPromise;
+            }
+            else {
+                throw new Error('[MoltenDb] You must call db.init() before querying the database.');
+            }
+        }
+        // 2. Generate a unique ID
         const id = (typeof crypto !== 'undefined' && crypto.randomUUID)
             ? crypto.randomUUID()
             : Math.random().toString(36).substring(2, 9);
         return new Promise((resolve, reject) => {
             const successHandler = (res) => resolve(mapToObj(res));
+            // 3. We are now GUARANTEED that isLeader, worker, and bc are accurately set
             if (this.isLeader && this.worker) {
                 this.pendingRequests.set(id, { resolve: successHandler, reject });
                 this.worker.postMessage({ id, action, ...payload });
             }
             else {
+                // Follower routing via BroadcastChannel
                 const timer = setTimeout(() => {
                     if (this.pendingRequests.has(id)) {
                         this.pendingRequests.delete(id);
-                        reject(new Error(`[MoltenDb] Request "${action}" timed out.`));
+                        reject(new Error(`[MoltenDb] Request "${action}" timed out after 10s.`));
                     }
                 }, 10000);
                 this.pendingRequests.set(id, {
@@ -163,8 +178,7 @@ export class MoltenDb {
                 this.bc.postMessage({ type: 'query', id, action, payload });
             }
         });
-    }
-    // ── Convenience CRUD helpers ───────────────────────────────────────────────
+    } // ── Convenience CRUD helpers ───────────────────────────────────────────────
     async set(collection, key, value) {
         await this.sendMessage('set', { collection, data: { [key]: value } });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moltendb-web/core",
-  "version": "1.0.0-rc.4",
+  "version": "1.0.0-rc.5",
   "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>",