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

package/README.md

@@ -365,7 +365,7 @@ This monorepo contains the following packages:
 - [x] **Automatic Compaction:** Log compacts automatically at 500 entries or 5 MB — **stabilised in RC1**.
 - [x] **Rich Test Suite:** 50 unit, integration, and stress tests via Vitest — **stabilised in RC1**.
 - [ ] **React Adapter:** Official `@moltendb-web/react` package with `useQuery` hooks and real-time context providers.
-- [ ] **Angular Adapter:** Official `@moltendb-web/angular` package featuring RxJS observables and Signal-based data fetching.
+- [x] **Angular Adapter:** Official `@moltendb-web/angular` package featuring Signal-based data fetching.
 - [ ] **Delta Sync:** Automatic two-way sync with the MoltenDb Rust server.
 - [ ] **Data Encryption:** Transparent encryption-at-rest using hardware-backed keys (Web Crypto API).
 - [ ] **Analytics Functionality:** Run complex analytics queries straight in the browser without blocking the UI.

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.6",
   "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>",