@3fv/electron-utility-process-manager 1.0.7 → 1.1.0

package/lib/mjs/node/UPMNodeProcess.d.ts

@@ -1,15 +1,38 @@
 import * as UPM from "../common/index.js";
+/**
+ * `clientId` of the main process, which is
+ * reached through `process.parentPort`
+ */
+export declare const MainClientId = "main";
 export declare class UPMNodeProcess {
     readonly processPort: Electron.ParentPort;
     private readonly clientPorts_;
     private readonly requestHandlers_;
     private readonly eventHandlers_;
+    private messageIdSeq_;
     private onServiceClientPort;
     private onServiceMessage;
     private onMessage;
     private constructor();
     addRequestHandler<ReqMap extends UPM.MessageRequestMap = any, Type extends UPM.MessageRequestNames<ReqMap> = UPM.MessageRequestNames<ReqMap>>(type: Type, handler: UPM.RequestHandler<ReqMap, Type>): void;
     addEventHandler(handler: UPM.EventHandler): void;
+    /**
+     * The `clientId` of every client which can currently
+     * be pushed an event: the main process (`MainClientId`)
+     * and each client with an open port
+     */
+    get clientIds(): string[];
+    /**
+     * Push an event from the `utilityProcess` to its clients
+     * as `fire-and-forget`; a client receives it through
+     * the handlers it registered with `addEventHandler`.
+     *
+     * @param data any structured-cloneable value
+     * @param clientIds the clients to push to, every client
+     *   (the main process included) when none are given
+     * @returns the `clientId` of each client the event was posted to
+     */
+    sendEvent(data: any, ...clientIds: string[]): string[];
     /**
      * Singleton instance
      *

package/lib/mjs/node/UPMNodeProcess.js

@@ -3,26 +3,40 @@ import { match } from "ts-pattern";
 import * as UPM from "../common/index.js";
 import Tracer from "tracer";
 import { Future } from "@3fv/prelude-ts";
-const log = Tracer.colorConsole();
+const log = Tracer.colorConsole({ level: "info" });
+/**
+ * `clientId` of the main process, which is
+ * reached through `process.parentPort`
+ */
+export const MainClientId = "main";
 export class UPMNodeProcess {
     onServiceClientPort(clientId, port) {
         log.info(`Received new client port for clientId (${clientId})`);
-        assert(!this.clientPorts_.has(clientId), `port already registered for clientId(${clientId})`);
+        // A CLIENT WHICH RECONNECTS (i.e. A RELOADED RENDERER) REPLACES ITS PORT
+        const existingPort = this.clientPorts_.get(clientId);
+        if (existingPort) {
+            log.warn(`Replacing the port registered for clientId (${clientId})`);
+            this.clientPorts_.delete(clientId);
+            existingPort.close();
+        }
+        this.clientPorts_.set(clientId, port);
         port.on("message", (ev) => {
             var _a, _b;
             const envelope = ((_b = (_a = ev.data) === null || _a === void 0 ? void 0 : _a.message) !== null && _b !== void 0 ? _b : ev.data), { channel, payload } = envelope;
-            log.info(`Message received on client port (${clientId})`, envelope);
+            log.debug(`Message received on client port (${clientId})`, envelope);
             assert(channel === UPM.IPCChannel.UPMServiceMessage, `Only IPCChannel.UPMServiceMessage are allowed on client ports: ${channel}`);
             Future.of(this.onServiceMessage(clientId, port, payload))
                 .onFailure(err => log.error(`Unable to handle message`, err));
         });
         port.on("close", () => {
-            this.clientPorts_.delete(clientId);
+            if (this.clientPorts_.get(clientId) === port) {
+                this.clientPorts_.delete(clientId);
+            }
         });
         port.start();
     }
     async onServiceMessage(clientId, port, payload) {
-        log.info(`onServiceMessage from (clientId=${clientId})`, payload);
+        log.debug(`onServiceMessage from (clientId=${clientId})`, payload);
         const { messageId, kind, args, eventData, type } = payload;
         await match(kind)
             .with(UPM.MessageKind.Request, async () => {
@@ -65,7 +79,7 @@ export class UPMNodeProcess {
                         res = await resPromise;
                     }
                     if (res === true) {
-                        log.info(`Successfully handled (${messageId}) event`);
+                        log.debug(`Successfully handled (${messageId}) event`);
                         return;
                     }
                 }
@@ -80,10 +94,10 @@ export class UPMNodeProcess {
     }
     onMessage(port, message) {
         var _a, _b;
-        log.info(`Message received on utilityProcess`, message.data);
+        log.debug(`Message received on utilityProcess`, message.data);
         const { channel, payload } = ((_b = (_a = message.data) === null || _a === void 0 ? void 0 : _a.message) !== null && _b !== void 0 ? _b : message.data);
         match(channel)
-            .when(c => c === UPM.IPCChannel.UPMServiceMessage, () => this.onServiceMessage("main", port, payload))
+            .when(c => c === UPM.IPCChannel.UPMServiceMessage, () => this.onServiceMessage(MainClientId, port, payload))
             .when(c => c === UPM.IPCChannel.UPMServiceNewClient, () => this.onServiceClientPort(payload.clientId, message.ports[0]))
             .otherwise(c => {
             log.error(`Unknown channel (${c})`);
@@ -94,6 +108,7 @@ export class UPMNodeProcess {
         this.clientPorts_ = new Map();
         this.requestHandlers_ = new Map();
         this.eventHandlers_ = Array();
+        this.messageIdSeq_ = 0;
         this.processPort.on("message", (message) => this.onMessage(this.processPort, message));
     }
     addRequestHandler(type, handler) {
@@ -104,6 +119,46 @@ export class UPMNodeProcess {
         log.info(`Registering event handler`);
         this.eventHandlers_.push(handler);
     }
+    /**
+     * The `clientId` of every client which can currently
+     * be pushed an event: the main process (`MainClientId`)
+     * and each client with an open port
+     */
+    get clientIds() {
+        return [MainClientId, ...this.clientPorts_.keys()];
+    }
+    /**
+     * Push an event from the `utilityProcess` to its clients
+     * as `fire-and-forget`; a client receives it through
+     * the handlers it registered with `addEventHandler`.
+     *
+     * @param data any structured-cloneable value
+     * @param clientIds the clients to push to, every client
+     *   (the main process included) when none are given
+     * @returns the `clientId` of each client the event was posted to
+     */
+    sendEvent(data, ...clientIds) {
+        const messageId = this.messageIdSeq_++, envelope = {
+            channel: UPM.IPCChannel.UPMServiceMessage,
+            payload: { messageId, eventData: data, kind: UPM.MessageKind.Event }
+        }, targetIds = clientIds.length ? [...new Set(clientIds)] : this.clientIds, sentIds = Array();
+        for (const clientId of targetIds) {
+            const port = clientId === MainClientId ? this.processPort : this.clientPorts_.get(clientId);
+            if (!port) {
+                log.warn(`Unable to send event (${messageId}), no port for clientId (${clientId})`);
+                continue;
+            }
+            try {
+                port.postMessage(envelope);
+                sentIds.push(clientId);
+            }
+            catch (err) {
+                log.error(`Unable to send event (${messageId}) to clientId (${clientId})`, err);
+            }
+        }
+        log.debug(`Sent event (${messageId}) to clients`, sentIds);
+        return sentIds;
+    }
     /**
      * Get singleton instance
      */

package/lib/mjs/node/UPMNodeProcess.js.map

@@ -1 +1 @@
-{"version":3,"file":"UPMNodeProcess.js","sourceRoot":"","sources":["../../../src/node/UPMNodeProcess.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"UPMNodeProcess.js","sourceRoot":"","sources":["../../../src/node/UPMNodeProcess.ts"],"names":[],"mappings":"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"}

package/lib/mjs/renderer/UPMRendererClientFactory.js

@@ -3,7 +3,7 @@ import { Deferred } from "@3fv/deferred";
 import { ipcRenderer } from "electron";
 import { assert } from "@3fv/guard";
 import Tracer from "tracer";
-const log = Tracer.colorConsole();
+const log = Tracer.colorConsole({ level: "info" });
 export class UPMRendererClientFactory {
     static async createClient(serviceName, clientId = "renderer") {
         const deferred = new Deferred();

package/lib/mjs/renderer/UPMRendererClientFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"UPMRendererClientFactory.js","sourceRoot":"","sources":["../../../src/renderer/UPMRendererClientFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,oBAAoB,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACnC,OAAO,MAAM,MAAM,QAAQ,CAAA;AAE3B,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,EAAE,CAAA;AAEjC,MAAM,OAAO,wBAAwB;IAEnC,MAAM,CAAC,KAAK,CAAC,YAAY,CAGvB,WAAmB,EAAE,WAAmB,UAAU;QAClD,MAAM,QAAQ,GAAI,IAAI,QAAQ,EAAuC,CAAA;QAErE,MAAM,WAAW,GAAG,CAAC,EAA6B,EAAE,IAA4C,EAAE,EAAE;YAClG,IAAI,CAAC;gBACH,MAAM,EAAC,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAC,GAAG,IAAI,CAAA;gBAEnE,GAAG,CAAC,IAAI,CAAC,2CAA2C,WAAW,oBAAoB,eAAe,aAAa,QAAQ,iBAAiB,YAAY,GAAG,CAAC,CAAA;gBAGxJ,IAAI,WAAW,KAAK,eAAe,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;oBACjE,GAAG,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;oBACpC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAC1B,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAA;oBAC9D,CAAC;yBAAM,CAAC;wBACN,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;wBACxB,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;oBAC7D,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAA;gBACnC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACtB,CAAC;QACH,CAAC,CAAA;QAED,IAAI,CAAC;YACH,WAAW,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAA;YAC/D,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,mBAAmB,EAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;YAE1E,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAA;YAC5C,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,+CAA+C,CAAC,CAAA;QAC/E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACpB,MAAM,GAAG,CAAA;QACX,CAAC;gBAAS,CAAC;YACT,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAA;QAClE,CAAC;QAED,OAAO,QAAQ,CAAC,OAAO,CAAA;IACzB,CAAC;CAEF;AAED,eAAe,wBAAwB,CAAA"}
+{"version":3,"file":"UPMRendererClientFactory.js","sourceRoot":"","sources":["../../../src/renderer/UPMRendererClientFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,oBAAoB,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACnC,OAAO,MAAM,MAAM,QAAQ,CAAA;AAE3B,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;AAElD,MAAM,OAAO,wBAAwB;IAEnC,MAAM,CAAC,KAAK,CAAC,YAAY,CAGvB,WAAmB,EAAE,WAAmB,UAAU;QAClD,MAAM,QAAQ,GAAI,IAAI,QAAQ,EAAuC,CAAA;QAErE,MAAM,WAAW,GAAG,CAAC,EAA6B,EAAE,IAA4C,EAAE,EAAE;YAClG,IAAI,CAAC;gBACH,MAAM,EAAC,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAC,GAAG,IAAI,CAAA;gBAEnE,GAAG,CAAC,IAAI,CAAC,2CAA2C,WAAW,oBAAoB,eAAe,aAAa,QAAQ,iBAAiB,YAAY,GAAG,CAAC,CAAA;gBAGxJ,IAAI,WAAW,KAAK,eAAe,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;oBACjE,GAAG,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;oBACpC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAC1B,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAA;oBAC9D,CAAC;yBAAM,CAAC;wBACN,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;wBACxB,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;oBAC7D,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAA;gBACnC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACtB,CAAC;QACH,CAAC,CAAA;QAED,IAAI,CAAC;YACH,WAAW,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAA;YAC/D,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,mBAAmB,EAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;YAE1E,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAA;YAC5C,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,+CAA+C,CAAC,CAAA;QAC/E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACpB,MAAM,GAAG,CAAA;QACX,CAAC;gBAAS,CAAC;YACT,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAA;QAClE,CAAC;QAED,OAAO,QAAQ,CAAC,OAAO,CAAA;IACzB,CAAC;CAEF;AAED,eAAe,wBAAwB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@3fv/electron-utility-process-manager",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "packageManager": "pnpm@12.15.0",
   "description": "electron-utility-process-manager",
   "author": "Jonathan Glanz",
@@ -84,11 +84,10 @@
     "build:watch": "pnpm run build --watch",
     "build:examples": "pnpm --filter @3fv/electron-utility-process-manager-examples run build",
     "example": "node ./scripts/run-example.mjs",
-    "test": "jest --passWithNoTests",
+    "test": "jest",
     "test:watch": "jest --watchAll --no-cache",
     "test:dev": "run-s build && run-p test:watch build:watch",
-    "preversion": "pnpm build",
-    "preversion::with-tests": "pnpm build && pnpm test",
+    "preversion": "pnpm build && pnpm test",
     "release": "gh workflow run release.yml --ref master -f bump=patch"
   },
   "publishConfig": {
@@ -105,8 +104,10 @@
   ],
   "files": [
     "lib",
+    "!lib/**/*.spec.*",
     "!lib/**/*.tsbuildinfo",
     "src",
+    "!src/**/*.spec.ts",
     "README.md"
   ],
   "dependencies": {
@@ -120,7 +121,7 @@
     "ts-pattern": "^5.5.0"
   },
   "peerDependencies": {
-    "electron": "^31"
+    "electron": ">=31"
   },
   "devDependencies": {
     "@faker-js/faker": "^8.4.1",
@@ -131,7 +132,7 @@
     "@types/node": "^22.9.0",
     "@types/shelljs": "^0.8.15",
     "cross-env": "^7.0.3",
-    "electron": "31.3.0",
+    "electron": "45.3.2",
     "electronmon": "^2.0.3",
     "jest": "^30.5.2",
     "lodash": "^4.17.21",

package/src/common/clients.ts

@@ -1,7 +1,9 @@
 import { isDefined, isFunction } from "@3fv/guard"
 import { isMessagePort, isUtilityProcess } from "./guards.js"
 import Tracer from "tracer"
+import { ClientEventHandlers } from "./events.js"
 import {
+  ClientEventHandler,
   Defaults,
   IPCChannel,
   Message, MessageKind, MessageRequestFn,
@@ -13,7 +15,7 @@ import {
 } from "./types.js"
 import { Deferred } from "@3fv/deferred"
 
-const log = Tracer.colorConsole()
+const log = Tracer.colorConsole({ level: "info" })
 
 /**
  * Service client interface maps a `MessageRequestMap`
@@ -46,6 +48,22 @@ export interface IMessageClient<
    */
   sendEvent(data: any): void
   
+  /**
+   * Register a handler for events pushed by the
+   * `utilityProcess` (`UPMNodeProcess.sendEvent`)
+   *
+   * @param handler
+   * @returns a function which removes the handler
+   */
+  addEventHandler(handler: ClientEventHandler): () => void
+  
+  /**
+   * Remove a handler registered with `addEventHandler`
+   *
+   * @param handler
+   */
+  removeEventHandler(handler: ClientEventHandler): void
+  
   /**
    * Execute a request, with a response expected
    *
@@ -105,6 +123,13 @@ export class MessagePortClient<
    */
   private readonly pendingMessages_ = new Map<number, PendingRequestMessage>()
   
+  /**
+   * Handlers for events pushed by the `utilityProcess`
+   *
+   * @private
+   */
+  private readonly eventHandlers_ = new ClientEventHandlers()
+  
   /**
    * Get the next `messageId`
    *
@@ -159,10 +184,17 @@ export class MessagePortClient<
         ) as [string, Message<ReqMap, Type>],
       { messageId, result, error } = payload
     
+    // EVENT PUSHED BY THE `utilityProcess`
+    if (payload?.kind === MessageKind.Event) {
+      log.debug(`Event received (clientId=${this.clientId},messageId=${messageId})`)
+      this.eventHandlers_.dispatch(payload.eventData)
+      return
+    }
+    
     try {
       const pending = this.pendingMessages_.get(messageId)
       if (!pending) {
-        log.info(`Unable to find pending record ${messageId}`)
+        log.debug(`Unable to find pending record ${messageId}`)
         return
       }
       
@@ -194,6 +226,14 @@ export class MessagePortClient<
     this.port.postMessage(payload)
   }
   
+  addEventHandler(handler: ClientEventHandler): () => void {
+    return this.eventHandlers_.add(handler)
+  }
+  
+  removeEventHandler(handler: ClientEventHandler): void {
+    this.eventHandlers_.remove(handler)
+  }
+  
   async executeRequest<
     Type extends MType,
     R extends MessageRequestReturnType<ReqMap, Type> = MessageRequestReturnType<ReqMap, Type>

package/src/common/events.ts

@@ -0,0 +1,43 @@
+import Tracer from "tracer"
+import type { ClientEventHandler } from "./types.js"
+
+const log = Tracer.colorConsole({ level: "info" })
+
+/**
+ * Holds the handlers a client registered for
+ * events pushed by the `utilityProcess`
+ */
+export class ClientEventHandlers {
+  private readonly handlers_ = new Set<ClientEventHandler>()
+  
+  /**
+   * Register a handler
+   *
+   * @param handler
+   * @returns a function which removes the handler
+   */
+  add(handler: ClientEventHandler): () => void {
+    this.handlers_.add(handler)
+    return () => this.remove(handler)
+  }
+  
+  remove(handler: ClientEventHandler): void {
+    this.handlers_.delete(handler)
+  }
+  
+  /**
+   * Call every handler with the event data, a handler
+   * which throws does not stop the others
+   *
+   * @param data
+   */
+  dispatch(data: any): void {
+    for (const handler of [...this.handlers_]) {
+      try {
+        handler(data)
+      } catch (err) {
+        log.error(`Event handler failed`, err)
+      }
+    }
+  }
+}

package/src/common/index.ts

@@ -1,3 +1,4 @@
 export * from "./types.js"
 export * from "./guards.js"
+export * from "./events.js"
 export * from "./clients.js"

package/src/common/types.ts

@@ -78,6 +78,12 @@ export interface PendingRequestMessage<
  */
 export type EventHandler = (clientId: string, port: Port, payload: any) => boolean
 
+/**
+ * Handles an event pushed by the `utilityProcess`
+ * to a client (`UPMNodeProcess.sendEvent`)
+ */
+export type ClientEventHandler = (data: any) => void
+
 /**
  * Port of any kind
  */

package/src/main/UPMMainService.ts

@@ -1,7 +1,7 @@
 import {
   app, MessageChannelMain, MessagePortMain, utilityProcess, UtilityProcess
 } from "electron"
-import { assert, getValue, isNumber, isString } from "@3fv/guard"
+import { assert, getValue, isDefined, isNumber, isString } from "@3fv/guard"
 import Fs from "fs"
 import { Deferred } from "@3fv/deferred"
 import * as UPM from "../common/index.js"
@@ -12,7 +12,7 @@ import Tracer from "tracer"
 import { asOption } from "@3fv/prelude-ts"
 import { match } from "ts-pattern"
 
-const log = Tracer.colorConsole()
+const log = Tracer.colorConsole({ level: "info" })
 const isNotEmpty = negate(isEmpty)
 
 /**
@@ -46,6 +46,26 @@ export class UPMMainService<ReqMap extends UPM.MessageRequestMap = any, MType ex
     port.postMessage(payload)
   }
   
+  /**
+   * Register a handler for events the service pushes to
+   * the main process (`UPMNodeProcess.sendEvent`)
+   *
+   * @param handler
+   * @returns a function which removes the handler
+   */
+  addEventHandler(handler:UPM.ClientEventHandler):() => void {
+    return this.eventHandlers_.add(handler)
+  }
+  
+  /**
+   * Remove a handler registered with `addEventHandler`
+   *
+   * @param handler
+   */
+  removeEventHandler(handler:UPM.ClientEventHandler):void {
+    this.eventHandlers_.remove(handler)
+  }
+  
   /**
    * Send request
    *
@@ -130,6 +150,8 @@ export class UPMMainService<ReqMap extends UPM.MessageRequestMap = any, MType ex
   
   private pendingMessages_ = new Map<number, UPM.PendingRequestMessage>()
   
+  private eventHandlers_ = new UPM.ClientEventHandlers()
+  
   private messageChannels_ = new Map<string, MessageChannelMain>()
   
   private onServiceExit(code:number) {
@@ -271,20 +293,30 @@ export class UPMMainService<ReqMap extends UPM.MessageRequestMap = any, MType ex
   }
   
   /**
-   * OnMessage really only handles `results` from
-   * `executeRequest(...)`; this may be expanded in
-   * the future
+   * Handles what the service posts on its parent port:
+   * `results` of `executeRequest(...)` & events pushed
+   * with `UPMNodeProcess.sendEvent(...)`
    *
-   * @param payload
+   * @param payloadOrEnvelope the service posts a `NodeEnvelope`
    * @private
    */
-  private onMessage<Type extends MType = any>(payload:UPM.Message<ReqMap, Type>) {
-    const { messageId, result, error } = payload
+  private onMessage<Type extends MType = any>(payloadOrEnvelope:UPM.Message<ReqMap, Type> | UPM.NodeMessage<ReqMap, Type>) {
+    const payload = (
+            isDefined(payloadOrEnvelope?.["payload"]) ? payloadOrEnvelope["payload"] : payloadOrEnvelope
+        ) as UPM.Message<ReqMap, Type>,
+        { messageId, result, error } = payload
+    
+    // EVENT PUSHED BY THE SERVICE
+    if (payload?.kind === UPM.MessageKind.Event) {
+      log.debug(`Event received from service (${this.serviceName},messageId=${messageId})`)
+      this.eventHandlers_.dispatch(payload.eventData)
+      return
+    }
     
     try {
       const pending = this.pendingMessages_.get(messageId)
       if (!pending) {
-        log.info(`Unable to find pending record ${messageId}`)
+        log.debug(`Unable to find pending record ${messageId}`)
         return
       }
       

package/src/main/UPMMainServiceManager.ts

@@ -6,7 +6,7 @@ import UPMMainService from "./UPMMainService.js"
 
 import Tracer from "tracer"
 
-const log = Tracer.colorConsole()
+const log = Tracer.colorConsole({ level: "info" })
 
 
 

package/src/node/UPMNodeProcess.ts

@@ -4,7 +4,13 @@ import * as UPM from "../common/index.js"
 import Tracer from "tracer"
 import { Future } from "@3fv/prelude-ts"
 
-const log = Tracer.colorConsole()
+const log = Tracer.colorConsole({ level: "info" })
+
+/**
+ * `clientId` of the main process, which is
+ * reached through `process.parentPort`
+ */
+export const MainClientId = "main"
 
 export class UPMNodeProcess
 {
@@ -16,16 +22,26 @@ export class UPMNodeProcess
   
   private readonly eventHandlers_ = Array<UPM.EventHandler>()
   
+  private messageIdSeq_ = 0
+  
   private onServiceClientPort(clientId: string, port: Electron.MessagePortMain) {
     log.info(`Received new client port for clientId (${clientId})`)
-    assert(!this.clientPorts_.has(clientId), `port already registered for clientId(${clientId})`)
+    
+    // A CLIENT WHICH RECONNECTS (i.e. A RELOADED RENDERER) REPLACES ITS PORT
+    const existingPort = this.clientPorts_.get(clientId)
+    if (existingPort) {
+      log.warn(`Replacing the port registered for clientId (${clientId})`)
+      this.clientPorts_.delete(clientId)
+      existingPort.close()
+    }
+    this.clientPorts_.set(clientId, port)
     
     port.on("message", (ev: Electron.MessageEvent) => {
       const envelope = (
           ev.data?.message ?? ev.data
         ) as UPM.NodeEnvelope,
         { channel, payload } = envelope
-      log.info(`Message received on client port (${clientId})`, envelope)
+      log.debug(`Message received on client port (${clientId})`, envelope)
       
       assert(
         channel === UPM.IPCChannel.UPMServiceMessage,
@@ -36,14 +52,16 @@ export class UPMNodeProcess
     })
     
     port.on("close", () => {
-      this.clientPorts_.delete(clientId)
+      if (this.clientPorts_.get(clientId) === port) {
+        this.clientPorts_.delete(clientId)
+      }
     })
     
     port.start()
   }
   
   private async onServiceMessage(clientId: string, port: UPM.Port, payload: UPM.Message<any, any>) {
-    log.info(`onServiceMessage from (clientId=${clientId})`, payload)
+    log.debug(`onServiceMessage from (clientId=${clientId})`, payload)
     const { messageId, kind, args, eventData, type } = payload
     await match(kind)
       .with(UPM.MessageKind.Request, async () => {
@@ -92,7 +110,7 @@ export class UPMNodeProcess
             }
             
             if (res === true) {
-              log.info(`Successfully handled (${messageId}) event`)
+              log.debug(`Successfully handled (${messageId}) event`)
               return
             }
           }
@@ -107,12 +125,12 @@ export class UPMNodeProcess
   }
   
   private onMessage(port: UPM.Port, message: Electron.MessageEvent) {
-    log.info(`Message received on utilityProcess`, message.data)
+    log.debug(`Message received on utilityProcess`, message.data)
     const { channel, payload } = (
       message.data?.message ?? message.data
     ) as UPM.NodeEnvelope
     match(channel)
-      .when(c => c === UPM.IPCChannel.UPMServiceMessage, () => this.onServiceMessage("main", port, payload))
+      .when(c => c === UPM.IPCChannel.UPMServiceMessage, () => this.onServiceMessage(MainClientId, port, payload))
       .when(
         c => c === UPM.IPCChannel.UPMServiceNewClient,
         () => this.onServiceClientPort(payload.clientId, message.ports[0])
@@ -140,6 +158,53 @@ export class UPMNodeProcess
     this.eventHandlers_.push(handler)
   }
   
+  /**
+   * The `clientId` of every client which can currently
+   * be pushed an event: the main process (`MainClientId`)
+   * and each client with an open port
+   */
+  get clientIds(): string[] {
+    return [MainClientId, ...this.clientPorts_.keys()]
+  }
+  
+  /**
+   * Push an event from the `utilityProcess` to its clients
+   * as `fire-and-forget`; a client receives it through
+   * the handlers it registered with `addEventHandler`.
+   *
+   * @param data any structured-cloneable value
+   * @param clientIds the clients to push to, every client
+   *   (the main process included) when none are given
+   * @returns the `clientId` of each client the event was posted to
+   */
+  sendEvent(data: any, ...clientIds: string[]): string[] {
+    const messageId = this.messageIdSeq_++,
+      envelope: UPM.NodeEnvelope = {
+        channel: UPM.IPCChannel.UPMServiceMessage,
+        payload: { messageId, eventData: data, kind: UPM.MessageKind.Event }
+      },
+      targetIds = clientIds.length ? [...new Set(clientIds)] : this.clientIds,
+      sentIds = Array<string>()
+    
+    for (const clientId of targetIds) {
+      const port = clientId === MainClientId ? this.processPort : this.clientPorts_.get(clientId)
+      if (!port) {
+        log.warn(`Unable to send event (${messageId}), no port for clientId (${clientId})`)
+        continue
+      }
+      
+      try {
+        port.postMessage(envelope)
+        sentIds.push(clientId)
+      } catch (err) {
+        log.error(`Unable to send event (${messageId}) to clientId (${clientId})`, err)
+      }
+    }
+    
+    log.debug(`Sent event (${messageId}) to clients`, sentIds)
+    return sentIds
+  }
+  
   /**
    * Singleton instance
    *

package/src/renderer/UPMRendererClientFactory.ts

@@ -4,7 +4,7 @@ import { ipcRenderer } from "electron"
 import { assert } from "@3fv/guard"
 import Tracer from "tracer"
 
-const log = Tracer.colorConsole()
+const log = Tracer.colorConsole({ level: "info" })
 
 export class UPMRendererClientFactory {