bare-stow 0.1.8 → 0.1.9

package/README.md

@@ -91,7 +91,7 @@ The `ipc` handle exposes the lifecycle as events and methods on the same duplex:
 
 - `ipc.ready`: A promise that resolves once the worker has signaled ready. Rejects if the worker errors before ready.
 - `ipc.on('exit', code)`: Emitted when the worker signals exit. `code` carries the exit code.
-- `ipc.on('error', err)`: Emitted when the worker reports a fault, or when the underlying transport errors. Either way the `ipc` is destroyed.
+- `ipc.on('error', err)`: Emitted when the worker reports a fault, when it exits without saying why, such as through `Bare.exit()`, a signal, or a crash, or when the underlying transport errors. Either way the `ipc` is destroyed. For a worker that exited without saying why, `err.exitCode` and `err.signalCode` carry the reason.
 - `ipc.on('close')`: Emitted when the underlying transport closes.
 - `ipc.destroy()`: Standard stream destroy. Sends a `terminate` control frame to the worker and waits for the underlying transport to close.
 - `ipc.terminate()`: Like `destroy()` but resolves with the worker's exit code.

package/lib/host.d.ts

@@ -32,6 +32,14 @@ interface IPC extends Protocol {
    * @returns The worker's exit `code`, or `undefined` if it closed without signaling one.
    */
   terminate(): Promise<number | undefined>
+  /**
+   * Report that the worker has exited, as observed by the transport. If the worker exited without
+   * saying why and was not asked to, the handle is destroyed with an error carrying the reason as
+   * `exitCode` and `signalCode`.
+   * @param code - The exit code of the worker, or `null` if it was killed by a signal.
+   * @param signal - The signal that killed the worker, or `null` (default `null`).
+   */
+  exited(code: number | null, signal?: string | null): void
 }
 
 declare class IPC {

package/lib/host.js

@@ -9,6 +9,11 @@ class IPC extends Protocol {
     this._kill = kill
     this._grace = grace
     this._terminating = null
+    this._exitReported = false
+
+    this.once('exit', () => {
+      this._exitReported = true
+    })
 
     this.send('configure', { grace })
 
@@ -64,6 +69,20 @@ class IPC extends Protocol {
     })
   }
 
+  exited(code, signal = null) {
+    // The worker either said why it exited or was asked to.
+    if (this._exitReported || this._terminating !== null || this.destroying) return
+
+    const err = new Error(
+      signal === null ? `Worker exited with code ${code}` : `Worker was killed by ${signal}`
+    )
+
+    err.exitCode = code
+    err.signalCode = signal
+
+    this.destroy(err)
+  }
+
   _destroy(err, cb) {
     if (this._stream.destroyed) return cb(null)
 

package/lib/target/bare-sidecar.js

@@ -34,7 +34,9 @@ const bundle = new URL(import.meta.resolve(${JSON.stringify(bundleSpecifier)}))
 export async function start({ timeout, grace, ...opts } = {}) {
   const sidecar = new Sidecar(bundle, { stdio: 'inherit', ...opts })
 
-  const ${ipc} = stow.wrap(sidecar, { timeout, grace })
+  const ${ipc} = stow.wrap(sidecar, { kill: () => sidecar.kill('SIGKILL'), timeout, grace })
+
+  sidecar.on('exit', (code, signal) => ${ipc}.exited(code, signal))
 ${client ? '\n' + indent(client.source, 2) : ''}
   await ${ipc}.ready
 
@@ -51,7 +53,9 @@ module.exports = {
   async start({ timeout, grace, ...opts } = {}) {
     const sidecar = new Sidecar(bundle, { stdio: 'inherit', ...opts })
 
-    const ${ipc} = stow.wrap(sidecar, { timeout, grace })
+    const ${ipc} = stow.wrap(sidecar, { kill: () => sidecar.kill('SIGKILL'), timeout, grace })
+
+    sidecar.on('exit', (code, signal) => ${ipc}.exited(code, signal))
 ${client ? '\n' + indent(client.source, 4) : ''}
     await ${ipc}.ready
 

package/lib/target/bare-worker.js

@@ -38,6 +38,8 @@ export async function start({ timeout, grace, ...opts } = {}) {
 
   // The IPC stream of a worker ends, but never closes, when its thread exits.
   worker.IPC.on('end', () => worker.IPC.destroy())
+
+  worker.on('exit', (code) => ${ipc}.exited(code))
 ${client ? '\n' + indent(client.source, 2) : ''}
   await ${ipc}.ready
 
@@ -58,6 +60,8 @@ module.exports = {
 
     // The IPC stream of a worker ends, but never closes, when its thread exits.
     worker.IPC.on('end', () => worker.IPC.destroy())
+
+    worker.on('exit', (code) => ${ipc}.exited(code))
 ${client ? '\n' + indent(client.source, 4) : ''}
     await ${ipc}.ready
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bare-stow",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Module bundling and harness generation for Bare",
   "exports": {
     "./package": "./package.json",
@@ -80,8 +80,9 @@
     "paparam": "^1.5.0"
   },
   "devDependencies": {
+    "bare-os": "^3.0.0",
     "bare-rpc": "^1.3.2",
-    "bare-sidecar": "^0.5.9",
+    "bare-sidecar": "^0.5.11",
     "bare-worker": "^4.3.0",
     "brittle": "^4.0.2",
     "lunte": "^1.7.0",