eimer 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright © 2025 Jan Hapke <https://janhapke.com>
+
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,130 @@
+<p align="center"><img src="eimer.png" alt="eimer logo" width="128"/></p>
+
+# eimer.js
+eimer.js (**E**lectron **I**nterprocess **ME**ssage **R**outer) is an inter-process communication (IPC) library for [electron.js](https://www.electronjs.org/) applications, which greatly reduces the amount of boilerplate code needed to interact between different processes.
+
+It is written in [TypeScript](https://www.typescriptlang.org/) and comes with minimal dependencies. It has been developed for *modern* versions of Electron.js (>= 28).
+
+⚠️ This library is in pre-beta stage and not yet production ready ⚠️
+
+## Table of Contents
+- [What problem(s) does it solve?](#what-problems-does-it-solve)
+- [Features](#features)
+- [Getting Started](#getting-started)
+  - [Install eimer.js](#install-eimerjs)
+  - [Add eimer.js to the Main Process](#add-eimerjs-to-the-main-process)
+  - [Add eimer.js to the Preload Script](#add-eimerjs-to-the-preload-script)
+  - [Add eimer.js to the Browser Window](#add-eimerjs-to-the-browser-window)
+  - [Build Process Considerations](#build-process-considerations)
+- [Limitations](#limitations)
+- [Authors](#authors)
+- [License](#license)
+
+## What problem(s) does it solve?
+Even simple Electron applications are naturally [split into two different processes](https://www.electronjs.org/docs/latest/tutorial/process-model) (main and renderer), which have to be linked through a "preload script". Exchanging data and calling functions across these process boundaries is already non-trivial and the [interfaces provided by Electron](https://www.electronjs.org/docs/latest/tutorial/ipc) make it difficult to keep a growing code base maintainable.
+
+As applications grow in functionality and complexity, even more processes become involved - [multiple windows](https://www.electronjs.org/docs/latest/api/base-window) on the rendering side, each potentially with [web workers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) or iframes and the main process can start [worker threads](https://nodejs.org/api/worker_threads.html) or spawn [utility processes](https://www.electronjs.org/docs/latest/api/utility-process) which themselves can spawn more processes and threads.
+
+All of the different process-like concepts in Electron have slightly different APIs for inter-process communication and while [MessagePorts](https://www.electronjs.org/docs/latest/tutorial/message-ports) can be used to unify these concepts, even these are limited to point-to-point communication between at most *two* processes at a time.
+
+## Features
+* **Transports** unify different IPC APIs under a single, common interface
+  * ipcMain, ipcRenderer, MessagePort, window.postMessage, node:worker_threads
+* **Message Bus** transparently forwards IPC messages across *all* connected processes
+* **Publish/Subscribe** pattern to broadcast and listen to events across processes
+* **Remote Procedure Call (RPC)** pattern to invoke methods in different processes with a promise-based interface
+
+## Getting Started
+We'll assume that you already have an Electron.js project that is written in TypeScript and it can be compiled / started.
+
+If not, check out the [examples](./examples) directory! It also contains examples that show how to implement a [basic counter](./examples/basic-counter/) with RPC and publish/subscribe and how to extend that to [multiple windows](./examples/multi-window/) or [worker threads](./examples/worker-thread/).
+
+### Install eimer.js
+```shell
+npm install eimer
+```
+
+Note that the following examples have been stripped down for brevity. Add best practices and coding style on your own. Also, you can find full source code, including build configurations, in the [examples](./examples) directory.
+
+### Add eimer.js to the *Main Process*
+The Main Process sets up an instance of eimer.js which uses Electron's [ipcMain](https://www.electronjs.org/docs/latest/api/ipc-main) to communicate with the renderer process. It also registers a simple "Hello World" RPC Handler. Every instance of Eimer has a unique "node id", which is passed to its constructor.
+
+```typescript
+import { app, BrowserWindow, ipcMain } from 'electron';
+import { Eimer, EimerIpcMainTransport } from 'eimer';
+
+const eimer = new Eimer('main');
+eimer.registerRpcHandler('hello', async () => 'world');
+
+app.whenReady().then(() => {
+    const mainWindow = new BrowserWindow({
+        width: 800, height: 600, webPreferences: { preload: __dirname + '/preload.js' }
+    });
+
+    eimer.connect(new EimerIpcMainTransport(ipcMain, mainWindow.webContents));
+
+    mainWindow.loadFile('index.html');
+    mainWindow.webContents.openDevTools();
+
+    app.on('window-all-closed', () => { app.quit() });
+});
+```
+
+### Add eimer.js to the *Preload Script*
+The purpose of the [Preload Script](https://www.electronjs.org/docs/latest/tutorial/tutorial-preload) is to set up communication between the main process and the "browser" window, without exposing too many APIs of the main process in the browser context.
+
+We set up another instance of eimer.js in the preload script, which simply forwards messages. It uses Electron's [ipcRenderer](https://www.electronjs.org/docs/latest/api/ipc-renderer) to communicate with the main process and [window.postMessage](https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage) to communicate with the  browser window.
+```typescript
+import { ipcRenderer } from 'electron';
+import { Eimer, EimerIpcRendererTransport, EimerBrowserTransport } from 'eimer';
+
+const eimer = new Eimer('preload');
+eimer.connect(new EimerIpcRendererTransport(ipcRenderer));
+eimer.connect(new EimerBrowserTransport(window, { targetOrigin: '*' }));
+```
+
+### Add eimer.js to the *Browser Window*
+The Browser Window sets up an instance of eimer.js, which uses [window.postMessage](https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage) to communicate with the preload script.
+```typescript
+import { Eimer, EimerBrowserTransport } from 'eimer';
+
+const eimer = new Eimer('renderer');
+eimer.connect(new EimerBrowserTransport(window));
+
+eimer.callRpc<string>('hello').then(value => { console.log('hello ' + value) });
+```
+
+### Build Process Considerations
+* The Preload Script as well as the Renderer / Browser Code run inside separate browser environments and need to be separately compiled and bundled with the eimer.js library.
+  * This is not specific to eimer.js but a general pitfall of Electron Applications
+* You can add extra build scripts to the `package.json` that rely on esbuild (`npm install esbuild`)
+  ```json
+  "scripts": {
+      "build": "tsc && npm run build:preload && npm run build:renderer",
+      "build:preload": "esbuild src/preload.ts --bundle --outfile=dist/preload.js --external:electron",
+      "build:renderer": "esbuild src/renderer.ts --bundle --outfile=dist/renderer.js",
+  }
+  ```
+* Be sure to call the `npm run build:preload` and the `npm run build:renderer` scripts in your build process!
+* Additional options for esbuild (build:preload and build:renderer) that could be useful
+  * `--platform=browser`
+  * `--target=es2020`
+  * `--format=cjs`
+* Check out the [examples](./examples) directory for complete projects including build configurations.
+
+## Limitations
+This library is in pre-beta stage.
+
+Existing functionality mostly works and is well tested. However, performance is not optimized at all
+(for example, all messages are broadcast to all connected processes, the ids of all messages ever sent
+is kept in memory indefinitely) and features are limited (security and extensibility need improvement).
+
+Also the documentation is lacking.
+
+Therefore, this library cannot be considered ready for production use just yet.
+
+## Authors
+* [Jan Hapke](https://janhapke.com)
+
+## License
+[MIT](LICENSE)

package/dist/cjs/eimer/Eimer.d.ts

@@ -0,0 +1,102 @@
+import type { EimerDependencies } from './EimerDependencies';
+import type { EimerOptions } from './EimerOptions';
+import type { NodeId } from './NodeId';
+import type { PayloadHandler } from './PayloadHandler';
+import type { RpcHandler } from './RpcHandler';
+import type { RpcMethod } from './RpcMethod';
+import type { Topic } from './Topic';
+import type { Transport } from './Transport';
+export interface EimerInterface {
+}
+/**
+ * Eimer main class
+ *   This class represents an instance of a "node" on the Eimer "network".
+ *   It encapsulates all user-facing functionality in a single class.
+ *   Allows connecting one or more transports.
+ *   Provides Publish/Subscribe and remote procedure call patterns.
+ *
+ * To use it, create an instance with a unique node id and connect a transport
+ *   After that, publish/subscribe and RPC can be used.
+ */
+export declare class Eimer implements EimerInterface {
+    private readonly nodeId;
+    private readonly idGenerator;
+    private readonly messageBus;
+    private readonly rpcManager;
+    private readonly logger;
+    private handlerMap;
+    /**
+     *
+     * @param nodeId id of the node this instance belongs to. should be unique across all instances
+     * @param options
+     * @param dependencies optionally inject dependencies
+     */
+    constructor(nodeId: NodeId, options?: EimerOptions, dependencies?: EimerDependencies);
+    /**
+     * Connect this Eimer instance to a `Transport`
+     * @param transport
+     */
+    connect(transport: Transport): void;
+    /**
+     * Disconnect from a `Transport`
+     * @param transport
+     */
+    disconnect(transport: Transport): void;
+    /**
+     * Call an RPC method
+     * Will time out if no handler exists or handler does not respond
+     * Will throw on errors from handler
+     * @param method name of method / rpc handler
+     * @param params optional params object
+     * @param timeout override timeout from constructor options for this single call
+     * @returns result from invoked handler
+     */
+    callRpc<T>(method: RpcMethod, params?: unknown, timeout?: number): Promise<T>;
+    /**
+     * Register an RPC handler
+     * Will be called if callRpc is called on any connected Eimer instance
+     * If there is already a registered handler, it will be replaced
+     * @param method name of method / rpc handler
+     * @param handler async function to be invoked
+     */
+    registerRpcHandler(method: RpcMethod, handler: RpcHandler): void;
+    /**
+     * Unregister an RPC handler
+     * @param method name of method / rpc handler
+     */
+    unregisterRpcHandler(method: RpcMethod): void;
+    /**
+     * Publish a payload to a topic
+     * Will send payload to all subscribers on the topic
+     * @param topic name of topic - subscribers can subscribe to it
+     * @param payload payload will be sent to subscribers
+     */
+    publish(topic: Topic, payload?: unknown): void;
+    /**
+     * Subscribe a handler function to a topic
+     * The handler function will be called with the payload everytime a message is published
+     * @param topic name of topic
+     * @param payloadHandler handler function
+     * @returns a function that can be called to unsubscribe the handler from the topic
+     */
+    subscribe(topic: Topic, payloadHandler: PayloadHandler): () => void;
+    /**
+     * Unsubscribe a handler function from a topic
+     * This has the same effect as calling the unsubscriber function that was returned from subscribe
+     * @param topic name of topic
+     * @param payloadHandler handler function (must be exact same variable that was used to subscribe)
+     */
+    unsubscribe(topic: Topic, payloadHandler: PayloadHandler): void;
+    /**
+     * Unsubscribe all handlers from a topic
+     * @param topic name of topic
+     */
+    unsubscribeAll(topic: Topic): void;
+    /**
+     * Shutdown this Eimer instance
+     * Will reject all RPC requests that are still waiting for a response
+     * and shutdown the MessageBus
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=Eimer.d.ts.map

package/dist/cjs/eimer/Eimer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Eimer.d.ts","sourceRoot":"","sources":["../../../src/eimer/Eimer.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,cAAc;CAAG;AAElC;;;;;;;;;GASG;AACH,qBAAa,KAAM,YAAW,cAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAGhC,OAAO,CAAC,UAAU,CAA8D;IAEhF;;;;;OAKG;gBACS,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,iBAAiB;IAQpF;;;OAGG;IACH,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAKnC;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAKtC;;;;;;;;OAQG;IACG,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAKnF;;;;;;OAMG;IACH,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI;IAKhE;;;OAGG;IACH,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAK7C;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAY9C;;;;;;OAMG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,GAAG,MAAM,IAAI;IA4BnE;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,GAAG,IAAI;IAgB/D;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAalC;;;;OAIG;IACH,QAAQ,IAAI,IAAI;CAKnB"}

package/dist/cjs/eimer/Eimer.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Eimer = void 0;
+const EimerMessage_1 = require("./EimerMessage");
+const LogLevel_1 = require("./LogLevel");
+const EimerIdGenerator_1 = require("../id-generator/EimerIdGenerator");
+const EimerLogger_1 = require("../logger/EimerLogger");
+const EimerMessageBus_1 = require("../message-bus/EimerMessageBus");
+const EimerRpcManager_1 = require("../rpc/EimerRpcManager");
+/**
+ * Eimer main class
+ *   This class represents an instance of a "node" on the Eimer "network".
+ *   It encapsulates all user-facing functionality in a single class.
+ *   Allows connecting one or more transports.
+ *   Provides Publish/Subscribe and remote procedure call patterns.
+ *
+ * To use it, create an instance with a unique node id and connect a transport
+ *   After that, publish/subscribe and RPC can be used.
+ */
+class Eimer {
+    /**
+     *
+     * @param nodeId id of the node this instance belongs to. should be unique across all instances
+     * @param options
+     * @param dependencies optionally inject dependencies
+     */
+    constructor(nodeId, options, dependencies) {
+        // Map to track user handler to wrapped handler for correct unsubscribe
+        // Nested map: topic -> payloadHandler -> messageHandler
+        this.handlerMap = new Map();
+        this.nodeId = nodeId;
+        this.idGenerator = dependencies?.idGenerator ?? new EimerIdGenerator_1.EimerIdGenerator();
+        this.logger = dependencies?.logger ?? new EimerLogger_1.EimerLogger(options?.logLevel ?? LogLevel_1.LogLevel.DEBUG, options?.logModuleName ?? 'Eimer', this.nodeId);
+        this.messageBus = dependencies?.messageBus ?? new EimerMessageBus_1.EimerMessageBus(this.nodeId, options);
+        this.rpcManager = dependencies?.rpcManager ?? new EimerRpcManager_1.EimerRpcManager(this.nodeId, this.messageBus, options);
+    }
+    /**
+     * Connect this Eimer instance to a `Transport`
+     * @param transport
+     */
+    connect(transport) {
+        this.logger.debug('Connecting Transport', { transport });
+        this.messageBus.connectTransport(transport);
+    }
+    /**
+     * Disconnect from a `Transport`
+     * @param transport
+     */
+    disconnect(transport) {
+        this.logger.debug('Disconnecting Transport', { transport });
+        this.messageBus.disconnectTransport(transport);
+    }
+    /**
+     * Call an RPC method
+     * Will time out if no handler exists or handler does not respond
+     * Will throw on errors from handler
+     * @param method name of method / rpc handler
+     * @param params optional params object
+     * @param timeout override timeout from constructor options for this single call
+     * @returns result from invoked handler
+     */
+    async callRpc(method, params, timeout) {
+        this.logger.debug('Making RPC call', { method, params });
+        return this.rpcManager.call(method, params, timeout);
+    }
+    /**
+     * Register an RPC handler
+     * Will be called if callRpc is called on any connected Eimer instance
+     * If there is already a registered handler, it will be replaced
+     * @param method name of method / rpc handler
+     * @param handler async function to be invoked
+     */
+    registerRpcHandler(method, handler) {
+        this.logger.debug('Registering RPC handler for method', { method });
+        this.rpcManager.registerHandler(method, handler);
+    }
+    /**
+     * Unregister an RPC handler
+     * @param method name of method / rpc handler
+     */
+    unregisterRpcHandler(method) {
+        this.logger.debug('Unregistering RPC handler for method', { method });
+        this.rpcManager.unregisterHandler(method);
+    }
+    /**
+     * Publish a payload to a topic
+     * Will send payload to all subscribers on the topic
+     * @param topic name of topic - subscribers can subscribe to it
+     * @param payload payload will be sent to subscribers
+     */
+    publish(topic, payload) {
+        this.logger.debug('Publishing message', { topic });
+        this.messageBus.publish(new EimerMessage_1.EimerMessage(this.idGenerator.generateId(), this.nodeId, topic, payload));
+    }
+    /**
+     * Subscribe a handler function to a topic
+     * The handler function will be called with the payload everytime a message is published
+     * @param topic name of topic
+     * @param payloadHandler handler function
+     * @returns a function that can be called to unsubscribe the handler from the topic
+     */
+    subscribe(topic, payloadHandler) {
+        this.logger.debug('Subscribing to topic', { topic });
+        const messageHandler = (message) => {
+            payloadHandler(message.payload);
+        };
+        // Get or create the topic's handler map
+        let topicHandlerMap = this.handlerMap.get(topic);
+        if (!topicHandlerMap) {
+            topicHandlerMap = new Map();
+            this.handlerMap.set(topic, topicHandlerMap);
+        }
+        topicHandlerMap.set(payloadHandler, messageHandler);
+        const unsubscribe = this.messageBus.subscribe(topic, messageHandler);
+        return () => {
+            unsubscribe();
+            const topicMap = this.handlerMap.get(topic);
+            if (topicMap) {
+                topicMap.delete(payloadHandler);
+                // Clean up empty topic maps
+                if (topicMap.size === 0) {
+                    this.handlerMap.delete(topic);
+                }
+            }
+        };
+    }
+    /**
+     * Unsubscribe a handler function from a topic
+     * This has the same effect as calling the unsubscriber function that was returned from subscribe
+     * @param topic name of topic
+     * @param payloadHandler handler function (must be exact same variable that was used to subscribe)
+     */
+    unsubscribe(topic, payloadHandler) {
+        this.logger.debug('Unsubscribing from topic', { topic });
+        const topicHandlerMap = this.handlerMap.get(topic);
+        if (topicHandlerMap) {
+            const messageHandler = topicHandlerMap.get(payloadHandler);
+            if (messageHandler) {
+                this.messageBus.unsubscribe(topic, messageHandler);
+                topicHandlerMap.delete(payloadHandler);
+                // Clean up empty topic maps
+                if (topicHandlerMap.size === 0) {
+                    this.handlerMap.delete(topic);
+                }
+            }
+        }
+    }
+    /**
+     * Unsubscribe all handlers from a topic
+     * @param topic name of topic
+     */
+    unsubscribeAll(topic) {
+        this.logger.debug('Unsubscribing all handlers from topic', { topic });
+        const topicHandlerMap = this.handlerMap.get(topic);
+        if (topicHandlerMap) {
+            // Unsubscribe all message handlers from the message bus
+            for (const messageHandler of topicHandlerMap.values()) {
+                this.messageBus.unsubscribe(topic, messageHandler);
+            }
+            // Remove the topic from the handler map
+            this.handlerMap.delete(topic);
+        }
+    }
+    /**
+     * Shutdown this Eimer instance
+     * Will reject all RPC requests that are still waiting for a response
+     * and shutdown the MessageBus
+     */
+    shutdown() {
+        this.rpcManager.shutdown();
+        this.messageBus.shutdown();
+    }
+}
+exports.Eimer = Eimer;
+//# sourceMappingURL=Eimer.js.map

package/dist/cjs/eimer/Eimer.js.map

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

package/dist/cjs/eimer/EimerDependencies.d.ts

@@ -0,0 +1,17 @@
+import type { IdGenerator } from "./IdGenerator";
+import type { Logger } from "./Logger";
+import type { MessageBus } from "./MessageBus";
+import type { RpcManager } from "./RpcManager";
+/**
+ * Base Interface for dependencies injected into constructors
+ *
+ * Extensions of this interface are used by Eimer classes
+ * to allow constructor-based dependency injection.
+ */
+export interface EimerDependencies {
+    idGenerator?: IdGenerator;
+    messageBus?: MessageBus;
+    rpcManager?: RpcManager;
+    logger?: Logger;
+}
+//# sourceMappingURL=EimerDependencies.d.ts.map

package/dist/cjs/eimer/EimerDependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EimerDependencies.d.ts","sourceRoot":"","sources":["../../../src/eimer/EimerDependencies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAC9B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/cjs/eimer/EimerDependencies.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+;
+//# sourceMappingURL=EimerDependencies.js.map

package/dist/cjs/eimer/EimerDependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EimerDependencies.js","sourceRoot":"","sources":["../../../src/eimer/EimerDependencies.ts"],"names":[],"mappings":";;AAgBC,CAAC"}

package/dist/cjs/eimer/EimerMessage.d.ts

@@ -0,0 +1,31 @@
+import type { MagicMessageMarker } from './MagicMessageMarker';
+import type { MessageId } from './MessageId';
+import type { NodeId } from './NodeId';
+import type { StructuredCloneable } from './StructuredCloneable';
+import type { Topic } from './Topic';
+/**
+ * Base class for Eimer Messages
+ */
+export declare class EimerMessage implements StructuredCloneable {
+    readonly marker: MagicMessageMarker;
+    readonly id: MessageId;
+    readonly from: NodeId;
+    readonly topic: Topic;
+    readonly payload?: unknown;
+    /**
+     *
+     * @param id globally unique id of this message - for example generated by an `IdGenerator`
+     * @param from nodeId that sent this message
+     * @param topic topic this message was sent on
+     * @param payload optional payload
+     */
+    constructor(id: MessageId, from: NodeId, topic: Topic, payload?: unknown);
+    /**
+     * User-defined Type Guard to ensure the message is an Eimer Request
+     * Similar to `Array.isArray()`, this static method can be used to check if an object is an `EimerMessage`
+     * @param message the message to test
+     * @returns true if the message looks like an Eimer Message
+     */
+    static isEimerMessage(message: any): message is EimerMessage;
+}
+//# sourceMappingURL=EimerMessage.d.ts.map

package/dist/cjs/eimer/EimerMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EimerMessage.d.ts","sourceRoot":"","sources":["../../../src/eimer/EimerMessage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;GAEG;AACH,qBAAa,YAAa,YAAW,mBAAmB;IAEpD,SAAgB,MAAM,EAAE,kBAAkB,CAAU;IACpD,SAAgB,EAAE,EAAE,SAAS,CAAC;IAC9B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,KAAK,EAAE,KAAK,CAAC;IAC7B,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;;OAMG;gBAEC,EAAE,EAAE,SAAS,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,OAAO;IAQrB;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,IAAI,YAAY;CAY/D"}

package/dist/cjs/eimer/EimerMessage.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EimerMessage = void 0;
+/**
+ * Base class for Eimer Messages
+ */
+class EimerMessage {
+    /**
+     *
+     * @param id globally unique id of this message - for example generated by an `IdGenerator`
+     * @param from nodeId that sent this message
+     * @param topic topic this message was sent on
+     * @param payload optional payload
+     */
+    constructor(id, from, topic, payload) {
+        this.marker = 'EM.1';
+        this.id = id;
+        this.from = from;
+        this.topic = topic;
+        this.payload = payload;
+    }
+    /**
+     * User-defined Type Guard to ensure the message is an Eimer Request
+     * Similar to `Array.isArray()`, this static method can be used to check if an object is an `EimerMessage`
+     * @param message the message to test
+     * @returns true if the message looks like an Eimer Message
+     */
+    static isEimerMessage(message) {
+        if (message === null || message === undefined || typeof message !== 'object') {
+            return false;
+        }
+        if (!('marker' in message) || !('id' in message) || !('from' in message) || !('topic' in message)) {
+            return false;
+        }
+        if (message.marker != 'EM.1') {
+            return false;
+        }
+        return true;
+    }
+}
+exports.EimerMessage = EimerMessage;
+//# sourceMappingURL=EimerMessage.js.map

package/dist/cjs/eimer/EimerMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EimerMessage.js","sourceRoot":"","sources":["../../../src/eimer/EimerMessage.ts"],"names":[],"mappings":";;;AAMA;;GAEG;AACH,MAAa,YAAY;IAQrB;;;;;;OAMG;IACH,YACI,EAAa,EACb,IAAY,EACZ,KAAY,EACZ,OAAiB;QAjBL,WAAM,GAAuB,MAAM,CAAC;QAmBhD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,OAAY;QAC9B,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC3E,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC;YAChG,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AA7CD,oCA6CC"}

package/dist/cjs/eimer/EimerOptions.d.ts

@@ -0,0 +1,12 @@
+import { LogLevel } from "./LogLevel";
+/**
+ * Base Interface for options injected into constructors
+ *
+ * Extensions of this interface are used by Eimer classes
+ * to allow passing options to constructors.
+ */
+export interface EimerOptions {
+    logModuleName?: string;
+    logLevel?: LogLevel;
+}
+//# sourceMappingURL=EimerOptions.d.ts.map

package/dist/cjs/eimer/EimerOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EimerOptions.d.ts","sourceRoot":"","sources":["../../../src/eimer/EimerOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACvB"}

package/dist/cjs/eimer/EimerOptions.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+;
+//# sourceMappingURL=EimerOptions.js.map

package/dist/cjs/eimer/EimerOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EimerOptions.js","sourceRoot":"","sources":["../../../src/eimer/EimerOptions.ts"],"names":[],"mappings":";;AAWC,CAAC"}

package/dist/cjs/eimer/IdGenerator.d.ts

@@ -0,0 +1,12 @@
+import type { MessageId } from "./MessageId";
+/**
+ * IdGenerator Interface
+ *
+ * Every message in an Eimer "network" needs a unique id.
+ *
+ * An `IdGenerator` can generate unique message ids.
+ */
+export interface IdGenerator {
+    generateId: () => MessageId;
+}
+//# sourceMappingURL=IdGenerator.d.ts.map

package/dist/cjs/eimer/IdGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdGenerator.d.ts","sourceRoot":"","sources":["../../../src/eimer/IdGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IACxB,UAAU,EAAE,MAAM,SAAS,CAAC;CAC/B"}

package/dist/cjs/eimer/IdGenerator.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IdGenerator.js.map

package/dist/cjs/eimer/IdGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdGenerator.js","sourceRoot":"","sources":["../../../src/eimer/IdGenerator.ts"],"names":[],"mappings":""}

package/dist/cjs/eimer/LogLevel.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Log Levels
+ *
+ * Defines Log Levels and their order.
+ *
+ * Based on the log levels provided by `console.log`
+ */
+export declare enum LogLevel {
+    TRACE = 2,
+    DEBUG = 4,
+    INFO = 8,
+    WARNING = 16,
+    ERROR = 32,
+    NONE = 99999
+}
+//# sourceMappingURL=LogLevel.d.ts.map

package/dist/cjs/eimer/LogLevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogLevel.d.ts","sourceRoot":"","sources":["../../../src/eimer/LogLevel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oBAAY,QAAQ;IAChB,KAAK,IAAI;IACT,KAAK,IAAI;IACT,IAAI,IAAI;IACR,OAAO,KAAK;IACZ,KAAK,KAAK;IACV,IAAI,QAAQ;CACf"}