@aztec/wsdb 0.0.1-commit.031e54b → 0.0.1-commit.189eedb3

package/dest/index.d.ts

@@ -1,6 +1,7 @@
 import { AsyncApi, type IpcErrorFactory } from './generated/async.js';
 export * from './generated/api_types.js';
 export { AsyncApi } from './generated/async.js';
+export { SyncApi } from './generated/sync.js';
 export type WsdbTransport = 'uds' | 'shm';
 export interface WsdbServiceOptions {
     binaryPath?: string;
@@ -18,5 +19,6 @@ export declare class WsdbService extends AsyncApi {
     private constructor();
     static spawn(options?: WsdbServiceOptions): Promise<WsdbService>;
     getIpcPath(): string;
+    sendProcessSignal(signal: NodeJS.Signals): void;
 }
 //# sourceMappingURL=index.d.ts.map

package/dest/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGtE,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAkID,qBAAa,WAAY,SAAQ,QAAQ;IACnB,OAAO,CAAC,cAAc;IAA1C,OAAO;WAIM,KAAK,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;IAK1E,UAAU,IAAI,MAAM;CAGrB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGtE,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAmLD,qBAAa,WAAY,SAAQ,QAAQ;IACnB,OAAO,CAAC,cAAc;IAA1C,OAAO;WAIM,KAAK,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;IAK1E,UAAU,IAAI,MAAM;IAIpB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI;CAGhD"}

package/dest/index.js

@@ -1,5 +1,5 @@
 import { spawn } from 'node:child_process';
-import { existsSync, unlinkSync } from 'node:fs';
+import { closeSync, existsSync, openSync, unlinkSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { threadId } from 'node:worker_threads';
@@ -8,6 +8,7 @@ import { AsyncApi } from './generated/async.js';
 import { findWsdbBinary } from './platform.js';
 export * from './generated/api_types.js';
 export { AsyncApi } from './generated/async.js';
+export { SyncApi } from './generated/sync.js';
 let instanceCounter = 0;
 const DEFAULT_CONNECT_TIMEOUT_MS = 30_000;
 class SpawnedBackend {
@@ -16,12 +17,28 @@ class SpawnedBackend {
     ipcPath;
     transport;
     exitPromise;
-    constructor(child, client, ipcPath, transport, exitPromise) {
+    logPath;
+    destroying = false;
+    exitError;
+    constructor(child, client, ipcPath, transport, exitPromise, logPath) {
         this.child = child;
         this.client = client;
         this.ipcPath = ipcPath;
         this.transport = transport;
         this.exitPromise = exitPromise;
+        this.logPath = logPath;
+        // Detect unexpected server death. Over SHM there is no connection to break,
+        // so without this an in-flight call waits forever for a reply that will
+        // never arrive. Reject in-flight calls and point at the log file.
+        this.child.on('exit', (code, signal) => {
+            if (this.destroying) {
+                return;
+            }
+            this.exitError = new Error('aztec-wsdb exited unexpectedly (code=' + code + ', signal=' + signal + ')' +
+                (this.logPath ? '; see logs: ' + this.logPath : ''));
+            console.error(this.exitError.message);
+            void this.client.destroy();
+        });
     }
     static async spawn(options = {}) {
         const binaryPath = findWsdbBinary(options.binaryPath);
@@ -36,11 +53,25 @@ class SpawnedBackend {
         if (transport === 'uds' && existsSync(ipcPath)) {
             unlinkSync(ipcPath);
         }
+        // Without a live logger, capture the child's stdout/stderr to a temp file
+        // (a plain fd, not a pipe — a pipe would keep the libuv loop referenced and
+        // break clean process exit). The path is surfaced if the child dies, so its
+        // errors are recoverable instead of vanishing into an ignored stream.
+        const logPath = options.logger ? undefined : join(tmpdir(), instanceId + '.log');
+        const logFd = logPath !== undefined ? openSync(logPath, 'a') : undefined;
         const ipcPathArgs = ["msgpack", "run", "--input", "{path}"].map((arg) => arg === '{path}' ? ipcPath : arg);
         const child = spawn(binaryPath, [...ipcPathArgs, ...(options.extraArgs ?? [])], {
-            stdio: ['ignore', options.logger ? 'pipe' : 'ignore', options.logger ? 'pipe' : 'ignore'],
+            stdio: [
+                'ignore',
+                options.logger ? 'pipe' : logFd,
+                options.logger ? 'pipe' : logFd,
+            ],
             env: { ...process.env, ...(options.env ?? {}) },
         });
+        if (logFd !== undefined) {
+            // The child holds its own dup of the fd; the parent's copy isn't needed.
+            closeSync(logFd);
+        }
         if (options.logger) {
             child.stdout?.on('data', (data) => options.logger?.('[aztec-wsdb stdout] ' + data.toString().trimEnd()));
             child.stderr?.on('data', (data) => options.logger?.('[aztec-wsdb stderr] ' + data.toString().trimEnd()));
@@ -55,15 +86,26 @@ class SpawnedBackend {
             });
         });
         const client = await Promise.race([connectClient(child, ipcPath, transport, options), childReadyFailure]);
-        return new SpawnedBackend(child, client, ipcPath, transport, exitPromise);
+        return new SpawnedBackend(child, client, ipcPath, transport, exitPromise, logPath);
     }
     getIpcPath() {
         return this.ipcPath;
     }
     call(input) {
+        if (this.exitError) {
+            return Promise.reject(this.exitError);
+        }
         return this.client.call(input);
     }
+    sendProcessSignal(signal) {
+        if (this.child.exitCode === null) {
+            this.child.kill(signal);
+        }
+    }
     async destroy() {
+        // Mark intentional teardown so the exit handler doesn't report it as an
+        // unexpected death.
+        this.destroying = true;
         await this.client.destroy();
         if (this.child.exitCode === null) {
             this.child.kill('SIGTERM');
@@ -89,7 +131,9 @@ async function connectClient(child, ipcPath, transport, options) {
             }
             if (transport === 'shm') {
                 return createNapiShmAsyncClient(ipcPath.replace(/\.shm$/, ''), {
-                    clientId: options.clientId ?? 0,
+                    // Pass clientId through as-is: when unset, the client self-allocates a
+                    // free producer slot (don't default to 0, which aliases every client).
+                    clientId: options.clientId,
                     customAddonPath: options.napiPath,
                 });
             }
@@ -132,4 +176,7 @@ export class WsdbService extends AsyncApi {
     getIpcPath() {
         return this.spawnedBackend.getIpcPath();
     }
+    sendProcessSignal(signal) {
+        this.spawnedBackend.sendProcessSignal(signal);
+    }
 }

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@aztec/wsdb",
-  "version": "0.0.1-commit.031e54b",
+  "version": "0.0.1-commit.189eedb3",
   "type": "module",
+  "bin": {
+    "aztec-wsdb": "./dest/bin.js"
+  },
   "exports": {
     ".": {
       "types": "./dest/index.d.ts",
@@ -18,15 +21,15 @@
     "prepare_arch_packages": "./scripts/prepare_arch_packages.sh"
   },
   "dependencies": {
-    "@aztec/ipc-runtime": "0.0.1-commit.031e54b",
+    "@aztec/ipc-runtime": "0.0.1-commit.189eedb3",
     "msgpackr": "^1.11.2",
     "tslib": "^2.4.0"
   },
   "optionalDependencies": {
-    "@aztec/wsdb-linux-x64": "0.0.1-commit.031e54b",
-    "@aztec/wsdb-darwin-x64": "0.0.1-commit.031e54b",
-    "@aztec/wsdb-linux-arm64": "0.0.1-commit.031e54b",
-    "@aztec/wsdb-darwin-arm64": "0.0.1-commit.031e54b"
+    "@aztec/wsdb-linux-x64": "0.0.1-commit.189eedb3",
+    "@aztec/wsdb-darwin-x64": "0.0.1-commit.189eedb3",
+    "@aztec/wsdb-linux-arm64": "0.0.1-commit.189eedb3",
+    "@aztec/wsdb-darwin-arm64": "0.0.1-commit.189eedb3"
   },
   "devDependencies": {
     "@types/node": "^22.15.17",