@3fv/electron-utility-process-manager 1.0.1 → 1.0.3

package/README.md

@@ -1,10 +1,9 @@
-# @3fv/electron-utility-process-manager
----
+# Electron UPM (Utility Process Manager)
 
 ## Overview
 
-`@3fv/electron-utility-process-manager` manages `1..n` `Electron.utilityProcess` instances/services/processes via a 
-single library & provides fully typed client facades automatically 
+`@3fv/electron-utility-process-manager` manages `1..n` `Electron.utilityProcess` instances/services/processes via a
+single library & provides fully typed client facades automatically
 
 ## Install
 
@@ -14,21 +13,42 @@ yarn add @3fv/electron-utility-process-manager
 
 ## Usage
 
-This library integrates into the `node`, `main` and `renderer` processes to provide 
+This library integrates into the `node`, `main` and `renderer` processes to provide
 transparent access from any process to a `node` (`Electron.utilityProcess`).
 
-### Possible Use-cases 
+### Possible Use-cases
 
 - main -> node
 - renderer -> node
 - node -> node
 
+
+### Debugging Config (Applies to all examples)
+
+In order to debug a service/utility process, simply add the following to
+the `options` argument passed to `createService`
+
+```typescript
+// ENABLE DEBUGGING (standard node.js inspect config)
+const options = {
+  inspect: {
+    break: true, 
+    port: 9449
+  }
+}
+upmMainServiceManager.createService("example-service", "/path/to/entry.js", options)
+```
+> NOTE: If `break` is `true` the utility/service process
+>  will not be paused until a debugger is attached.
+>  the process will print a chrome debugging url (i.e. `ws://`)
+
+
 ### Examples
 
 #### Simple Example
 
 > NOTE: The simple example uses the bare-bones approach
-> and basically avoids typing wherever possible.  For a 
+> and basically avoids typing wherever possible. For a
 > fully typed example, checkout the [complex example](#complex-example)
 
 ##### Node/Utility Process ([simple-node.ts](examples/simple/simple-node.ts))
@@ -41,13 +61,13 @@ upmNodeProcess.addEventHandler((clientId, port, payload) => {
   return true
 })
 
-upmNodeProcess.addRequestHandler("ping", async (type, messageId, what: string) => {
+upmNodeProcess.addRequestHandler("ping", async (type, messageId, what:string) => {
   console.info(`Ping request received (${messageId})`, what)
   return `pong: ${what}`
 })
 ```
 
-##### Main Process ([simple-main.ts](examples/simple/simple-main.ts)) 
+##### Main Process ([simple-main.ts](examples/simple/simple-main.ts))
 
 ```typescript
 import { app, BrowserWindow } from "electron"
@@ -55,15 +75,14 @@ import { UPM } from "@3fv/electron-utility-process-manager"
 import type { UPMMainService } from "@3fv/electron-utility-process-manager/main"
 import Path from "path"
 
-let upmService: UPMMainService = null
+let upmService:UPMMainService = null
 
 async function start() {
   const upm = await import("@3fv/electron-utility-process-manager/main")
   const upmManager = upm.upmMainServiceManager
   
   Object.assign(global, {
-    upm,
-    upmManager
+    upm, upmManager
   })
   
   console.info("UPM manager ready, now creating service", upmManager)
@@ -74,8 +93,7 @@ async function start() {
   
   const clientPort = upmManager.createMainChannel("simple", "main-channel-01")
   console.info("Start the client port")
-  if (UPM.isMessagePort(clientPort))
-    clientPort.start()
+  if (UPM.isMessagePort(clientPort)) clientPort.start()
   
   console.info("Post a message directly")
   clientPort.postMessage({
@@ -90,7 +108,7 @@ async function start() {
   const client = upmManager.createMainClient("simple", "main-client-01")
   console.info(`Send request/response: ping`)
   
-  const pongResult = await client.executeRequest("ping", ["main"])
+  const pongResult = await client.executeRequest("ping", "main")
   console.info(`Received pong response`, pongResult)
   
   await createWindow()
@@ -110,15 +128,10 @@ async function start() {
  *
  * @returns {Promise<void>}
  */
-async function createWindow(): Promise<void> {
+async function createWindow():Promise<void> {
   const mainWindow = new BrowserWindow({
-    width: 1000,
-    height: 1000,
-    webPreferences: {
-      contextIsolation: false,
-      nodeIntegration: true,
-      sandbox: false,
-      devTools: true
+    width: 1000, height: 1000, webPreferences: {
+      contextIsolation: false, nodeIntegration: true, sandbox: false, devTools: true
     }
   })
   
@@ -144,13 +157,13 @@ import UPMRendererClientFactory from "@3fv/electron-utility-process-manager/rend
 document.querySelector("#root").innerHTML = `simple-renderer-example`
 
 async function simpleExampleUPM() {
-  const client = await UPMRendererClientFactory.createClient("simple",`${process.type}-01`)
-  const result = await client.executeRequest("ping", [process.type])
+  const client = await UPMRendererClientFactory.createClient("simple", `${process.type}-01`)
+  const result = await client.executeRequest("ping", process.type)
   console.info(`Result: ${result}`)
 }
 
 simpleExampleUPM()
-  .catch(err => console.error(`renderer error: ${err.message}`, err))
+    .catch(err => console.error(`renderer error: ${err.message}`, err))
 
 export {}
 ```

package/examples/lib-examples/simple/simple-main.js

@@ -66,7 +66,14 @@ async function start() {
         upmManager
     });
     log.info("UPM manager ready, now creating service", upmManager);
-    upmService = await upmManager.createService("simple", path_1.default.join(__dirname, "simple-node.js"));
+    const entryFile = path_1.default.join(__dirname, "simple-node.js");
+    upmService = await upmManager.createService("simple", entryFile, {
+    // ENABLE DEBUGGING (standard node.js inspect config)
+    // inspect: {
+    //   break: true,
+    //   port: 9449
+    // }
+    });
     log.info("UPM service ready");
     upmService.sendEvent("test123");
     const clientPort = upmManager.createMainChannel("simple", "main-channel-01");
@@ -83,7 +90,7 @@ async function start() {
     log.info(`Creating port client`);
     const client = upmManager.createMainClient("simple", "main-client-01");
     log.info(`Send request/response: ping`);
-    const pongResult = await client.executeRequest("ping", ["main"]);
+    const pongResult = await client.executeRequest("ping", "main");
     log.info(`Received pong response`, pongResult);
     log.info(`Create the window/renderer`);
     await createWindow();

package/examples/lib-examples/simple/simple-main.js.map

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

package/examples/lib-examples/simple/simple-renderer.js

@@ -9,7 +9,7 @@ const log = tracer_1.default.colorConsole();
 document.querySelector("#root").innerHTML = `simple-renderer-example`;
 async function simpleExampleUPM() {
     const client = await renderer_1.default.createClient("simple", `${process.type}-01`);
-    const result = await client.executeRequest("ping", [process.type]);
+    const result = await client.executeRequest("ping", process.type);
     log.info(`Result: ${result}`);
 }
 simpleExampleUPM()

package/examples/lib-examples/simple/simple-renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"simple-renderer.js","sourceRoot":"","sources":["../../simple/simple-renderer.ts"],"names":[],"mappings":";;;;;AAAA,8FAAqF;AACrF,oDAA2B;AAE3B,MAAM,GAAG,GAAG,gBAAM,CAAC,YAAY,EAAE,CAAA;AAEjC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,SAAS,GAAG,yBAAyB,CAAA;AAErE,KAAK,UAAU,gBAAgB;IAC7B,MAAM,MAAM,GAAG,MAAM,kBAAwB,CAAC,YAAY,CAAC,QAAQ,EAAC,GAAG,OAAO,CAAC,IAAI,KAAK,CAAC,CAAA;IACzF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IAClE,GAAG,CAAC,IAAI,CAAC,WAAW,MAAM,EAAE,CAAC,CAAA;AAC/B,CAAC;AAED,gBAAgB,EAAE;KACf,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,mBAAmB,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC,CAAA"}
+{"version":3,"file":"simple-renderer.js","sourceRoot":"","sources":["../../simple/simple-renderer.ts"],"names":[],"mappings":";;;;;AAAA,8FAAqF;AACrF,oDAA2B;AAE3B,MAAM,GAAG,GAAG,gBAAM,CAAC,YAAY,EAAE,CAAA;AAEjC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,SAAS,GAAG,yBAAyB,CAAA;AAErE,KAAK,UAAU,gBAAgB;IAC7B,MAAM,MAAM,GAAG,MAAM,kBAAwB,CAAC,YAAY,CAAC,QAAQ,EAAC,GAAG,OAAO,CAAC,IAAI,KAAK,CAAC,CAAA;IACzF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE,GAAG,CAAC,IAAI,CAAC,WAAW,MAAM,EAAE,CAAC,CAAA;AAC/B,CAAC;AAED,gBAAgB,EAAE;KACf,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,mBAAmB,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC,CAAA"}

package/lib/cjs/common/clients.d.ts

@@ -1,4 +1,4 @@
-import { MessageRequestFn, MessageRequestMap, MessageRequestNames, MessageRequestParams, MessageRequestReturnType, Port } from "./types";
+import { MessageRequestFn, MessageRequestMap, MessageRequestNames, MessageRequestParams, MessageRequestReturnType, Port } from "./types.js";
 /**
  * Service client interface maps a `MessageRequestMap`
  * to its functional methods
@@ -10,6 +10,10 @@ export type IServiceClient<ReqMap extends MessageRequestMap, MType extends Messa
  * Messaging client interface
  */
 export interface IMessageClient<ReqMap extends MessageRequestMap, MType extends MessageRequestNames<ReqMap> = MessageRequestNames<ReqMap>> {
+    /**
+     * Get the clientId for the underlying port
+     */
+    get clientId(): string;
     /**
      * A very low level function for sending `any` data
      * to the `utilityProcess`

package/lib/cjs/common/clients.js

@@ -5,9 +5,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MessagePortClient = void 0;
 const guard_1 = require("@3fv/guard");
-const guards_1 = require("./guards");
+const guards_js_1 = require("./guards.js");
 const tracer_1 = __importDefault(require("tracer"));
-const types_1 = require("./types");
+const types_js_1 = require("./types.js");
 const deferred_1 = require("@3fv/deferred");
 const log = tracer_1.default.colorConsole();
 /**
@@ -63,8 +63,8 @@ class MessagePortClient {
             payloadOrEnvelopeOrData), 
         // FIND THE CHANNEL & PAYLOAD DEPENDING ON THE PROCESS & TRANSPORT
         [channel, payload] = ((0, guard_1.isDefined)(payloadOrEnvelope === null || payloadOrEnvelope === void 0 ? void 0 : payloadOrEnvelope["payload"]) ?
-            [(_a = payloadOrEnvelope["channel"]) !== null && _a !== void 0 ? _a : types_1.IPCChannel.UPMServiceMessage, payloadOrEnvelope["payload"]] :
-            [types_1.IPCChannel.UPMServiceMessage, payloadOrEnvelope]), { messageId, result, error } = payload;
+            [(_a = payloadOrEnvelope["channel"]) !== null && _a !== void 0 ? _a : types_js_1.IPCChannel.UPMServiceMessage, payloadOrEnvelope["payload"]] :
+            [types_js_1.IPCChannel.UPMServiceMessage, payloadOrEnvelope]), { messageId, result, error } = payload;
         try {
             const pending = this.pendingMessages_.get(messageId);
             if (!pending) {
@@ -90,8 +90,8 @@ class MessagePortClient {
     sendEvent(data) {
         const messageId = this.generateMessageId();
         const payload = {
-            channel: types_1.IPCChannel.UPMServiceMessage,
-            payload: { messageId, data, kind: types_1.MessageKind.Event }
+            channel: types_js_1.IPCChannel.UPMServiceMessage,
+            payload: { messageId, eventData: data, kind: types_js_1.MessageKind.Event }
         };
         this.port.postMessage(payload);
     }
@@ -99,12 +99,12 @@ class MessagePortClient {
         const messageId = this.generateMessageId(), pending = {
             deferred: new deferred_1.Deferred(),
             messageId,
-            timeoutId: setTimeout(() => this.removePendingMessage(messageId), types_1.Defaults.RequestTimeout)
+            timeoutId: setTimeout(() => this.removePendingMessage(messageId), types_js_1.Defaults.RequestTimeout)
         };
         this.pendingMessages_.set(messageId, pending);
         const payload = {
-            channel: types_1.IPCChannel.UPMServiceMessage,
-            payload: { type, messageId, args, kind: types_1.MessageKind.Request }
+            channel: types_js_1.IPCChannel.UPMServiceMessage,
+            payload: { type, messageId, args, kind: types_js_1.MessageKind.Request }
         };
         this.port.postMessage(payload);
         try {
@@ -159,7 +159,7 @@ class MessagePortClient {
          * @private
          */
         this.pendingMessages_ = new Map();
-        if ((0, guards_1.isMessagePort)(port) || (0, guards_1.isUtilityProcess)(port)) {
+        if ((0, guards_js_1.isMessagePort)(port) || (0, guards_js_1.isUtilityProcess)(port)) {
             if ((0, guard_1.isFunction)(port === null || port === void 0 ? void 0 : port["addEventListener"])) {
                 ;
                 port.addEventListener("message", this.onMessage.bind(this));
@@ -167,7 +167,7 @@ class MessagePortClient {
             else {
                 port.on("message", this.onMessage.bind(this));
             }
-            if ((0, guards_1.isMessagePort)(port))
+            if ((0, guards_js_1.isMessagePort)(port))
                 port.start();
         }
         else {

package/lib/cjs/common/clients.js.map

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

package/lib/cjs/common/guards.d.ts

@@ -1,4 +1,4 @@
 import type { UtilityProcess } from "electron";
-import { Port } from "./types";
+import { Port } from "./types.js";
 export declare function isMessagePort(port: Port): port is Electron.MessagePortMain;
 export declare function isUtilityProcess(port: Port): port is UtilityProcess;

package/lib/cjs/common/index.d.ts

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

package/lib/cjs/common/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./types"), exports);
-__exportStar(require("./guards"), exports);
-__exportStar(require("./clients"), exports);
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./guards.js"), exports);
+__exportStar(require("./clients.js"), exports);
 //# sourceMappingURL=index.js.map

package/lib/cjs/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAuB;AACvB,2CAAwB;AACxB,4CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA0B;AAC1B,8CAA2B;AAC3B,+CAA4B"}

package/lib/cjs/common/types.d.ts

@@ -21,7 +21,7 @@ export type MessageRequestMap = {};
 export type MessageRequestNames<ReqMap extends MessageRequestMap> = keyof ReqMap;
 export type MessageRequestFn<ReqMap extends MessageRequestMap, Name extends MessageRequestNames<ReqMap>> = ReqMap[Name] extends MessageRequestFnBase ? ReqMap[Name] : never;
 export type MessageRequestParams<ReqMap extends MessageRequestMap, Name extends MessageRequestNames<ReqMap>> = ReqMap[Name] extends MessageRequestFnBase ? Parameters<ReqMap[Name]> : never;
-export type MessageRequestReturnType<ReqMap extends MessageRequestMap, Name extends MessageRequestNames<ReqMap>> = ReqMap[Name] extends MessageRequestFnBase ? ReturnType<ReqMap[Name]> : never;
+export type MessageRequestReturnType<ReqMap extends MessageRequestMap, Name extends MessageRequestNames<ReqMap>> = ReqMap[Name] extends MessageRequestFnBase ? Awaited<ReturnType<ReqMap[Name]>> : never;
 export interface Message<ReqMap extends MessageRequestMap = any, Type extends MessageRequestNames<ReqMap> = MessageRequestNames<ReqMap>, Args extends MessageRequestParams<ReqMap, Type> = MessageRequestParams<ReqMap, Type>, R extends MessageRequestReturnType<ReqMap, Type> = MessageRequestReturnType<ReqMap, Type>> {
     type: Type;
     kind: MessageKind;
@@ -46,4 +46,26 @@ export interface PendingRequestMessage<ReqMap extends MessageRequestMap = any, T
  * @returns true if payload was handled, false if not
  */
 export type EventHandler = (clientId: string, port: Port, payload: any) => boolean;
+/**
+ * Port of any kind
+ */
 export type Port = MessagePort | Electron.MessagePortMain | Electron.ParentPort | UtilityProcess;
+/**
+ * Debugging & Inspection config
+ */
+export type ServiceInspectConfig = number | {
+    port: number;
+    break?: boolean;
+};
+/**
+ * Configuration to use when creating/launching
+ * a service (`Electron.UtilityProcess`)
+ */
+export interface CreateServiceConfig {
+    serviceName: string;
+    inspect: false | ServiceInspectConfig;
+}
+/**
+ * Optional/Partial `CreateServiceConfig`
+ */
+export type CreateServiceOptions = Partial<CreateServiceConfig>;

package/lib/cjs/common/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/common/types.ts"],"names":[],"mappings":";;;AAKa,QAAA,QAAQ,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,CAAA;AAElD,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,8BAAe,CAAA;IACf,kCAAmB,CAAA;IACnB,oCAAqB,CAAA;AACvB,CAAC,EAJW,WAAW,2BAAX,WAAW,QAItB;AAED,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,qDAAuC,CAAA;IACvC,yDAA2C,CAAA;AAC7C,CAAC,EAHW,UAAU,0BAAV,UAAU,QAGrB;AAED,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,8DAA2C,CAAA;IAC3C,2EAAwD,CAAA;AAC1D,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/common/types.ts"],"names":[],"mappings":";;;AAIa,QAAA,QAAQ,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,CAAA;AAElD,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,8BAAe,CAAA;IACf,kCAAmB,CAAA;IACnB,oCAAqB,CAAA;AACvB,CAAC,EAJW,WAAW,2BAAX,WAAW,QAItB;AAED,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,qDAAuC,CAAA;IACvC,yDAA2C,CAAA;AAC7C,CAAC,EAHW,UAAU,0BAAV,UAAU,QAGrB;AAED,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,8DAA2C,CAAA;IAC3C,2EAAwD,CAAA;AAC1D,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B"}

package/lib/cjs/index.d.ts

@@ -1,4 +1,4 @@
-export * from "./common";
-import * as UPM from "./common";
+export * from "./common/index.js";
+import * as UPM from "./common/index.js";
 export { UPM };
 export default UPM;

package/lib/cjs/index.js

@@ -27,8 +27,8 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UPM = void 0;
-__exportStar(require("./common"), exports);
-const UPM = __importStar(require("./common"));
+__exportStar(require("./common/index.js"), exports);
+const UPM = __importStar(require("./common/index.js"));
 exports.UPM = UPM;
 exports.default = UPM;
 //# sourceMappingURL=index.js.map

package/lib/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAAwB;AACxB,8CAA+B;AAG7B,kBAAG;AAGL,kBAAe,GAAG,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,oDAAiC;AACjC,uDAAwC;AAGtC,kBAAG;AAGL,kBAAe,GAAG,CAAA"}

package/lib/cjs/main/UPMMainService.d.ts

@@ -1,21 +1,35 @@
 import { MessagePortMain } from "electron";
-import * as UPM from "../common";
-import { IServiceClient } from "../common";
-export interface UPMMainServiceConfig {
-}
-export type UPMMainServiceOptions = Partial<UPMMainServiceConfig>;
+import * as UPM from "../common/index.js";
+/**
+ * Contains & Manages a `Utility/Process`
+ * providing simplified messaging & event
+ * propagation.
+ */
 export declare class UPMMainService<ReqMap extends UPM.MessageRequestMap = any, MType extends UPM.MessageRequestNames<ReqMap> = UPM.MessageRequestNames<ReqMap>> implements UPM.IMessageClient<ReqMap, MType> {
     readonly serviceName: string;
     readonly entryFile: string;
-    private readonly config_;
-    private readyDeferred_;
-    private killDeferred_;
-    private lastMessageId_;
-    private childProcess_;
-    private pendingMessages_;
-    private messageChannels_;
-    private init;
-    private onMessage;
+    /**
+     * As this container/wrapper implements
+     * `IMessageClient`, it needs to provide
+     * a `clientId`, which is constant in the
+     * main process
+     */
+    readonly clientId: string;
+    /**
+     * Send an event as `fire-and-forget`
+     *
+     * @param data
+     * @param port
+     */
+    sendEvent(data: any, port?: UPM.Port): void;
+    /**
+     * Send request
+     *
+     * @param type
+     * @param args
+     */
+    executeRequest<Type extends MType, R extends UPM.MessageRequestReturnType<ReqMap, Type> = UPM.MessageRequestReturnType<ReqMap, Type>>(type: Type, ...args: UPM.MessageRequestParams<ReqMap, Type>): Promise<R>;
+    close(): void;
     /**
      * Resolves when ready
      *
@@ -26,7 +40,15 @@ export declare class UPMMainService<ReqMap extends UPM.MessageRequestMap = any,
      * Return a simple proxy facade wrapping
      * `executeRequest` into individual methods
      */
-    getServiceClient(): IServiceClient<ReqMap, MType>;
+    getServiceClient(): UPM.IServiceClient<ReqMap, MType>;
+    private readonly config_;
+    private readyDeferred_;
+    private killDeferred_;
+    private messageIdSeq_;
+    private childProcess_;
+    private pendingMessages_;
+    private messageChannels_;
+    private onServiceExit;
     /**
      * Returned client side port (for Renderer)
      * @param clientId
@@ -37,33 +59,93 @@ export declare class UPMMainService<ReqMap extends UPM.MessageRequestMap = any,
      * (useful to avoid congestion on default child_process channel)
      *
      * @param {string} clientId
-     * @returns {UPM.MessagePortClient<MessageRequestMap, MessageType>}
+     * @returns {UPM.MessagePortClient}
      */
     createMainClient(clientId: string): UPM.MessagePortClient<ReqMap, MType>;
+    /**
+     * Service is still in a healthy/running/runnable state
+     */
+    get isRunning(): boolean;
+    /**
+     * Stop the service (kill)
+     */
+    stop(): Promise<void>;
+    /**
+     * Resource management & cleanup
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * Initialize the service
+     *
+     * @private
+     */
+    private init;
+    /**
+     * OnMessage really only handles `results` from
+     * `executeRequest(...)`; this may be expanded in
+     * the future
+     *
+     * @param payload
+     * @private
+     */
+    private onMessage;
+    /**
+     * This handler is currently unused, but
+     * could be attached to a `MessagePort.on('close')`
+     * event
+     *
+     * @param id
+     * @param channel
+     * @private
+     */
     private onPortClose;
-    private closeMessageChannel;
-    close(): void;
     /**
-     * Send an event as `fire-and-forget`
+     * Close a message channel
      *
-     * @param data
-     * @param port
+     * @param id
+     * @param channel
+     * @private
      */
-    sendEvent(data: any, port?: UPM.Port): void;
+    private closeMessageChannel;
     /**
-     * Send request
+     * Kill the service
      *
-     * @param type
-     * @param args
+     * @private
      */
-    executeRequest<Type extends MType, R extends UPM.MessageRequestReturnType<ReqMap, Type> = UPM.MessageRequestReturnType<ReqMap, Type>>(type: Type, ...args: UPM.MessageRequestParams<ReqMap, Type>): Promise<R>;
-    stop(): Promise<void>;
     private kill;
+    /**
+     * Close all message channels
+     *
+     * @private
+     */
     private removeAllMessageChannels;
+    /**
+     * Remove all pending messages
+     *
+     * @private
+     */
     private cancelAllPendingMessages;
-    constructor(serviceName: string, entryFile: string, options?: UPMMainServiceOptions);
+    /**
+     * Remove a pending message from the queue,
+     * whether settled or not
+     *
+     * @param messageId
+     * @private
+     */
     private removePendingMessage;
+    /**
+     * Generate next message id
+     *
+     * @private
+     */
     private generateMessageId;
-    [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * Construct a new service
+     *
+     * @param serviceName
+     * @param entryFile
+     * @param options
+     */
+    constructor(serviceName: string, entryFile: string, options?: UPM.CreateServiceOptions);
 }
 export default UPMMainService;