@thalesrc/hermes 0.0.0

package/package.json

@@ -0,0 +1,158 @@
+{
+  "name": "@thalesrc/hermes",
+  "version": "0.0.0",
+  "description": "Javascript messaging library",
+  "keywords": [
+    "javascript",
+    "messaging",
+    "send",
+    "message",
+    "chrome",
+    "extension",
+    "extensions",
+    "nodejs",
+    "child",
+    "process",
+    "webworkers"
+  ],
+  "homepage": "https://github.com/thalesrc/thalesrc/tree/main/libs/hermes#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thalesrc/thalesrc.git",
+    "directory": "libs/hermes"
+  },
+  "dependencies": {
+    "@thalesrc/js-utils": "^3.4.0",
+    "rxjs": "^7.8.1",
+    "tslib": "^2.3.0"
+  },
+  "type": "module",
+  "module": "./index.js",
+  "main": "./index.cjs",
+  "typings": "./index.d.ts",
+  "bugs": "https://github.com/thalesrc/thalesrc/issues",
+  "license": "MIT",
+  "author": {
+    "name": "Ali Şahin Özçelik",
+    "email": "alisahinozcelik@gmail.com",
+    "url": "https://alisah.in"
+  },
+  "funding": {
+    "type": "patreon",
+    "url": "https://www.patreon.com/alisahin"
+  },
+  "exports": {
+    ".": {
+      "default": "./index.cjs",
+      "import": "./index.js",
+      "node": "./index.cjs",
+      "require": "./index.cjs",
+      "types": "./index.d.ts"
+    },
+    "./broadcast": {
+      "default": "./broadcast/index.cjs",
+      "import": "./broadcast/index.js",
+      "node": "./broadcast/index.cjs",
+      "require": "./broadcast/index.cjs",
+      "types": "./broadcast/index.d.ts"
+    },
+    "./broadcast/message-client": {
+      "default": "./broadcast/message-client.cjs",
+      "import": "./broadcast/message-client.js",
+      "node": "./broadcast/message-client.cjs",
+      "require": "./broadcast/message-client.cjs",
+      "types": "./broadcast/message-client.d.ts"
+    },
+    "./broadcast/message-host": {
+      "default": "./broadcast/message-host.cjs",
+      "import": "./broadcast/message-host.js",
+      "node": "./broadcast/message-host.cjs",
+      "require": "./broadcast/message-host.cjs",
+      "types": "./broadcast/message-host.d.ts"
+    },
+    "./broadcast/message-service": {
+      "default": "./broadcast/message-service.cjs",
+      "import": "./broadcast/message-service.js",
+      "node": "./broadcast/message-service.cjs",
+      "require": "./broadcast/message-service.cjs",
+      "types": "./broadcast/message-service.d.ts"
+    },
+    "./chrome": {
+      "default": "./chrome/index.cjs",
+      "import": "./chrome/index.js",
+      "node": "./chrome/index.cjs",
+      "require": "./chrome/index.cjs",
+      "types": "./chrome/index.d.ts"
+    },
+    "./chrome/message-client": {
+      "default": "./chrome/message-client.cjs",
+      "import": "./chrome/message-client.js",
+      "node": "./chrome/message-client.cjs",
+      "require": "./chrome/message-client.cjs",
+      "types": "./chrome/message-client.d.ts"
+    },
+    "./chrome/message-host": {
+      "default": "./chrome/message-host.cjs",
+      "import": "./chrome/message-host.js",
+      "node": "./chrome/message-host.cjs",
+      "require": "./chrome/message-host.cjs",
+      "types": "./chrome/message-host.d.ts"
+    },
+    "./iframe": {
+      "default": "./iframe/index.cjs",
+      "import": "./iframe/index.js",
+      "node": "./iframe/index.cjs",
+      "require": "./iframe/index.cjs",
+      "types": "./iframe/index.d.ts"
+    },
+    "./iframe/message-client": {
+      "default": "./iframe/message-client.cjs",
+      "import": "./iframe/message-client.js",
+      "node": "./iframe/message-client.cjs",
+      "require": "./iframe/message-client.cjs",
+      "types": "./iframe/message-client.d.ts"
+    },
+    "./iframe/message-host": {
+      "default": "./iframe/message-host.cjs",
+      "import": "./iframe/message-host.js",
+      "node": "./iframe/message-host.cjs",
+      "require": "./iframe/message-host.cjs",
+      "types": "./iframe/message-host.d.ts"
+    },
+    "./iframe/message-service": {
+      "default": "./iframe/message-service.cjs",
+      "import": "./iframe/message-service.js",
+      "node": "./iframe/message-service.cjs",
+      "require": "./iframe/message-service.cjs",
+      "types": "./iframe/message-service.d.ts"
+    },
+    "./worker": {
+      "default": "./worker/index.cjs",
+      "import": "./worker/index.js",
+      "node": "./worker/index.cjs",
+      "require": "./worker/index.cjs",
+      "types": "./worker/index.d.ts"
+    },
+    "./worker/message-client": {
+      "default": "./worker/message-client.cjs",
+      "import": "./worker/message-client.js",
+      "node": "./worker/message-client.cjs",
+      "require": "./worker/message-client.cjs",
+      "types": "./worker/message-client.d.ts"
+    },
+    "./worker/message-host": {
+      "default": "./worker/message-host.cjs",
+      "import": "./worker/message-host.js",
+      "node": "./worker/message-host.cjs",
+      "require": "./worker/message-host.cjs",
+      "types": "./worker/message-host.d.ts"
+    },
+    "./worker/message-service": {
+      "default": "./worker/message-service.cjs",
+      "import": "./worker/message-service.js",
+      "node": "./worker/message-service.cjs",
+      "require": "./worker/message-service.cjs",
+      "types": "./worker/message-service.d.ts"
+    }
+  }
+}

package/request.decorator.cjs

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Request = Request;
+const operators_1 = require("rxjs/operators");
+const selectors_1 = require("./selectors");
+function Request(path) {
+    return function (target, key, descriptor) {
+        descriptor.value = function (message) {
+            const messageId = this[selectors_1.GET_NEW_ID]();
+            this[selectors_1.SEND]({ body: message, id: messageId, path });
+            return this[selectors_1.RESPONSES$].pipe((0, operators_1.map)((data) => {
+                const { error } = data;
+                if (error)
+                    throw error;
+                return data;
+            }), (0, operators_1.filter)(({ id }) => id === messageId), (0, operators_1.takeWhile)((res) => !res.completed), (0, operators_1.map)(({ body }) => body));
+        };
+        return descriptor;
+    };
+}

package/request.decorator.d.ts

@@ -0,0 +1 @@
+export declare function Request(path: string): MethodDecorator;

package/request.decorator.js

@@ -0,0 +1,19 @@
+import { filter, map, takeWhile } from 'rxjs/operators';
+import { GET_NEW_ID, RESPONSES$, SEND } from './selectors';
+export function Request(path) {
+    return function (target, key, descriptor) {
+        descriptor.value = function (message) {
+            const messageId = this[GET_NEW_ID]();
+            this[SEND]({ body: message, id: messageId, path });
+            return this[RESPONSES$].pipe(map((data) => {
+                const { error } = data;
+                if (error)
+                    throw error;
+                return data;
+            }), filter(({ id }) => id === messageId), takeWhile((res) => !res.completed), map(({ body }) => body));
+        };
+        return descriptor;
+    };
+}
+
+//# sourceMappingURL=request.decorator.js.map

package/request.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../libs/hermes/src/request.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGxD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAG3D,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,UAAS,MAAM,EAAE,GAAG,EAAE,UAAwC;QACnE,UAAU,CAAC,KAAK,GAAG,UAA8B,OAAY;YAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAErC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;YAEjD,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAC1B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACX,MAAM,EAAC,KAAK,EAAC,GAAG,IAA4B,CAAC;gBAE7C,IAAI,KAAK;oBAAE,MAAM,KAAK,CAAC;gBAEvB,OAAO,IAAiC,CAAC;YAC3C,CAAC,CAAC,EACF,MAAM,CAAC,CAAC,EAAC,EAAE,EAAC,EAAE,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,EAClC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,EAClC,GAAG,CAAC,CAAC,EAAC,IAAI,EAA6B,EAAE,EAAE,CAAC,IAAI,CAAC,CAClD,CAAC;QACJ,CAAC,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC","file":"request.decorator.js","sourcesContent":["import { filter, map, takeWhile } from 'rxjs/operators';\n\nimport { MessageClient } from './message-client';\nimport { GET_NEW_ID, RESPONSES$, SEND } from './selectors';\nimport { ErrorMessageResponse, SuccessfulMessageResponse, UncompletedMessageResponse } from './message-response.type';\n\nexport function Request(path: string): MethodDecorator {\n  return function(target, key, descriptor: TypedPropertyDescriptor<any>): TypedPropertyDescriptor<any> {\n    descriptor.value = function(this: MessageClient, message: any) {\n      const messageId = this[GET_NEW_ID]();\n\n      this[SEND]({body: message, id: messageId, path});\n\n      return this[RESPONSES$].pipe(\n        map((data) => {\n          const {error} = data as ErrorMessageResponse;\n\n          if (error) throw error;\n\n          return data as SuccessfulMessageResponse;\n        }),\n        filter(({id}) => id === messageId),\n        takeWhile((res) => !res.completed),\n        map(({body}: UncompletedMessageResponse) => body),\n      );\n    };\n\n    return descriptor;\n  };\n}\n"]}

package/selectors.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESPONSE = exports.TERMINATE_MESSAGE$ = exports.LISTEN = exports.GET_NEW_ID = exports.SEND = exports.RESPONSES$ = exports.MESSAGE_LISTENERS = void 0;
+exports.MESSAGE_LISTENERS = Symbol('Message Listeners');
+exports.RESPONSES$ = Symbol('Responses');
+exports.SEND = Symbol('Send');
+exports.GET_NEW_ID = Symbol('Get New Id');
+exports.LISTEN = Symbol('Listen');
+exports.TERMINATE_MESSAGE$ = Symbol('Terminate Message');
+exports.RESPONSE = Symbol('Response');

package/selectors.d.ts

@@ -0,0 +1,7 @@
+export declare const MESSAGE_LISTENERS: unique symbol;
+export declare const RESPONSES$: unique symbol;
+export declare const SEND: unique symbol;
+export declare const GET_NEW_ID: unique symbol;
+export declare const LISTEN: unique symbol;
+export declare const TERMINATE_MESSAGE$: unique symbol;
+export declare const RESPONSE: unique symbol;

package/selectors.js

@@ -0,0 +1,9 @@
+export const MESSAGE_LISTENERS = Symbol('Message Listeners');
+export const RESPONSES$ = Symbol('Responses');
+export const SEND = Symbol('Send');
+export const GET_NEW_ID = Symbol('Get New Id');
+export const LISTEN = Symbol('Listen');
+export const TERMINATE_MESSAGE$ = Symbol('Terminate Message');
+export const RESPONSE = Symbol('Response');
+
+//# sourceMappingURL=selectors.js.map

package/selectors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../libs/hermes/src/selectors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;AAC9C,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAC9D,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC","file":"selectors.js","sourcesContent":["export const MESSAGE_LISTENERS = Symbol('Message Listeners');\nexport const RESPONSES$ = Symbol('Responses');\nexport const SEND = Symbol('Send');\nexport const GET_NEW_ID = Symbol('Get New Id');\nexport const LISTEN = Symbol('Listen');\nexport const TERMINATE_MESSAGE$ = Symbol('Terminate Message');\nexport const RESPONSE = Symbol('Response');\n"]}

package/worker/index.cjs

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Listen = exports.Request = exports.WorkerMessageHost = exports.WorkerMessageClient = exports.WorkerMessageService = void 0;
+var message_service_1 = require("./message-service");
+Object.defineProperty(exports, "WorkerMessageService", { enumerable: true, get: function () { return message_service_1.WorkerMessageService; } });
+var message_client_1 = require("./message-client");
+Object.defineProperty(exports, "WorkerMessageClient", { enumerable: true, get: function () { return message_client_1.WorkerMessageClient; } });
+var message_host_1 = require("./message-host");
+Object.defineProperty(exports, "WorkerMessageHost", { enumerable: true, get: function () { return message_host_1.WorkerMessageHost; } });
+var request_decorator_1 = require("../request.decorator");
+Object.defineProperty(exports, "Request", { enumerable: true, get: function () { return request_decorator_1.Request; } });
+var listen_decorator_1 = require("../listen.decorator");
+Object.defineProperty(exports, "Listen", { enumerable: true, get: function () { return listen_decorator_1.Listen; } });

package/worker/index.d.ts

@@ -0,0 +1,5 @@
+export { WorkerMessageService } from './message-service';
+export { WorkerMessageClient } from './message-client';
+export { WorkerMessageHost } from './message-host';
+export { Request } from '../request.decorator';
+export { Listen } from '../listen.decorator';

package/worker/index.js

@@ -0,0 +1,7 @@
+export { WorkerMessageService } from './message-service';
+export { WorkerMessageClient } from './message-client';
+export { WorkerMessageHost } from './message-host';
+export { Request } from '../request.decorator';
+export { Listen } from '../listen.decorator';
+
+//# sourceMappingURL=index.js.map

package/worker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../libs/hermes/src/worker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC","file":"index.js","sourcesContent":["export { WorkerMessageService } from './message-service';\nexport { WorkerMessageClient } from './message-client';\nexport { WorkerMessageHost } from './message-host';\nexport { Request } from '../request.decorator';\nexport { Listen } from '../listen.decorator';\n"]}

package/worker/message-client.cjs

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkerMessageClient = void 0;
+const unique_id_1 = require("@thalesrc/js-utils/unique-id");
+const noop_1 = require("@thalesrc/js-utils/function/noop");
+const promisify_1 = require("@thalesrc/js-utils/promise/promisify");
+const rxjs_1 = require("rxjs");
+const message_client_1 = require("../message-client");
+const selectors_1 = require("../selectors");
+/**
+ * WorkerMessageClient
+ *
+ * Client implementation for Web Worker communication. Sends messages to and receives
+ * responses from Web Workers using the Worker postMessage API.
+ *
+ * This class can be used in two contexts:
+ * - **Main thread**: Provide a Worker instance to communicate with that specific worker
+ * - **Worker thread**: Omit the worker parameter to communicate with the main thread via self
+ *
+ * The worker parameter supports multiple types for flexibility:
+ * - Direct Worker instance
+ * - Promise that resolves to a Worker (for async worker initialization)
+ * - Function that returns a Worker (for lazy initialization)
+ * - Function that returns a Promise<Worker> (for async lazy initialization)
+ *
+ * The `initialize()` method allows dynamic worker management, enabling you to switch
+ * workers at runtime or re-establish connections after errors.
+ *
+ * @example
+ * // In main thread - communicate with a specific worker
+ * const worker = new Worker('./worker.js');
+ * const client = new WorkerMessageClient(worker);
+ *
+ * @example
+ * // In worker thread - communicate with main thread
+ * const client = new WorkerMessageClient();
+ *
+ * @example
+ * // With async worker initialization
+ * const workerPromise = import('./worker.js').then(m => new m.MyWorker());
+ * const client = new WorkerMessageClient(workerPromise);
+ *
+ * @example
+ * // With lazy initialization
+ * const client = new WorkerMessageClient(() =>
+ *   document.querySelector('[data-worker]') ? new Worker('./worker.js') : undefined
+ * );
+ *
+ * @example
+ * // Re-initialize with a different worker
+ * const client = new WorkerMessageClient();
+ * // Later, switch to a different worker
+ * client.initialize(new Worker('./different-worker.js'));
+ */
+class WorkerMessageClient extends message_client_1.MessageClient {
+    /**
+     * Promise resolving to the Worker instance or undefined if running in worker context
+     * @private
+     */
+    #worker = Promise.resolve(undefined);
+    /**
+     * Unique identifier for this client instance to prevent ID collisions
+     * @private
+     */
+    #instanceId = Date.now();
+    /**
+     * Observable stream of message responses from the worker or main thread
+     */
+    [selectors_1.RESPONSES$] = new rxjs_1.Subject();
+    /**
+     * Creates a new WorkerMessageClient instance
+     *
+     * @param worker - Optional worker configuration:
+     *   - Worker: Direct worker instance (main thread)
+     *   - Promise<Worker>: Promise resolving to worker (async initialization)
+     *   - () => Worker: Function returning worker (lazy initialization)
+     *   - () => Promise<Worker>: Function returning promise (async lazy initialization)
+     *   - undefined: Omit for worker thread context (uses self)
+     */
+    constructor(worker) {
+        super();
+        this.initialize(worker);
+    }
+    /**
+     * Initializes or re-initializes the worker connection.
+     *
+     * This method sets up message listeners for the provided worker. If a worker
+     * was previously initialized, it cleans up the old connection before establishing
+     * the new one. This allows for dynamic worker management, such as:
+     * - Switching between different workers at runtime
+     * - Re-establishing connections after worker errors
+     * - Lazy initialization when the worker is conditionally needed
+     *
+     * @param worker - Optional worker configuration:
+     *   - Worker: Direct worker instance (main thread)
+     *   - Promise<Worker>: Promise resolving to worker (async initialization)
+     *   - () => Worker: Function returning worker (lazy initialization)
+     *   - () => Promise<Worker>: Function returning promise (async lazy initialization)
+     *   - undefined: Omit for worker thread context (uses self)
+     *
+     * @example
+     * // Switch to a different worker dynamically
+     * const client = new WorkerMessageClient(oldWorker);
+     * client.initialize(newWorker); // Cleans up old listener, sets up new one
+     *
+     * @example
+     * // Re-initialize after worker error
+     * worker.onerror = () => {
+     *   client.initialize(new Worker('./worker.js'));
+     * };
+     */
+    initialize(worker) {
+        // Deinitialize previous worker if any
+        this.#worker.then(prevWorker => {
+            if (prevWorker) {
+                prevWorker.removeEventListener('message', this.#handler);
+            }
+            else {
+                removeEventListener('message', this.#handler);
+            }
+        }).catch(noop_1.noop);
+        // Resolve worker parameter: execute function if provided, otherwise use value directly
+        const _worker = typeof worker === 'function' ? worker() : worker;
+        // Ensure worker is wrapped in a promise for consistent async handling
+        this.#worker = (0, promisify_1.promisify)(_worker);
+        // Set up message listener once worker is resolved
+        this.#worker.then(worker => {
+            if (worker) {
+                // Main thread context: listen to specific worker
+                worker.addEventListener('message', this.#handler);
+            }
+            else {
+                // Worker thread context: listen to messages from main thread
+                addEventListener('message', this.#handler);
+            }
+        }).catch(noop_1.noop);
+    }
+    /**
+     * Sends a message to the worker or main thread
+     *
+     * @param message - The message to send
+     * @template T - Type of the message body
+     * @internal Used by @Request decorator
+     */
+    [selectors_1.SEND](message) {
+        this.#worker.then(worker => {
+            if (worker) {
+                // Main thread: send to worker
+                worker.postMessage(message);
+            }
+            else {
+                // Worker thread: send to main thread
+                postMessage(message);
+            }
+        }).catch(noop_1.noop);
+    }
+    /**
+     * Handles incoming messages and forwards them to the responses stream
+     * @private
+     */
+    #handler = (event) => {
+        this[selectors_1.RESPONSES$].next(event.data);
+    };
+    /**
+     * Generates a unique message ID for tracking request-response pairs
+     *
+     * @returns Unique message identifier
+     * @internal Used by @Request decorator
+     */
+    [selectors_1.GET_NEW_ID]() {
+        return (0, unique_id_1.uniqueId)('hermes-worker-message-' + this.#instanceId);
+    }
+}
+exports.WorkerMessageClient = WorkerMessageClient;

package/worker/message-client.d.ts

@@ -0,0 +1,117 @@
+import { Subject } from "rxjs";
+import { MessageClient } from "../message-client";
+import { MessageResponse } from "../message-response.type";
+import { Message } from "../message.interface";
+import { GET_NEW_ID, RESPONSES$, SEND } from "../selectors";
+type ClientWorkerType = Worker | undefined;
+type ClientWorkerPromise = Promise<ClientWorkerType>;
+type ClientWorkerFactory = () => ClientWorkerType | ClientWorkerPromise;
+type ClientWorkerArg = ClientWorkerType | ClientWorkerPromise | ClientWorkerFactory;
+/**
+ * WorkerMessageClient
+ *
+ * Client implementation for Web Worker communication. Sends messages to and receives
+ * responses from Web Workers using the Worker postMessage API.
+ *
+ * This class can be used in two contexts:
+ * - **Main thread**: Provide a Worker instance to communicate with that specific worker
+ * - **Worker thread**: Omit the worker parameter to communicate with the main thread via self
+ *
+ * The worker parameter supports multiple types for flexibility:
+ * - Direct Worker instance
+ * - Promise that resolves to a Worker (for async worker initialization)
+ * - Function that returns a Worker (for lazy initialization)
+ * - Function that returns a Promise<Worker> (for async lazy initialization)
+ *
+ * The `initialize()` method allows dynamic worker management, enabling you to switch
+ * workers at runtime or re-establish connections after errors.
+ *
+ * @example
+ * // In main thread - communicate with a specific worker
+ * const worker = new Worker('./worker.js');
+ * const client = new WorkerMessageClient(worker);
+ *
+ * @example
+ * // In worker thread - communicate with main thread
+ * const client = new WorkerMessageClient();
+ *
+ * @example
+ * // With async worker initialization
+ * const workerPromise = import('./worker.js').then(m => new m.MyWorker());
+ * const client = new WorkerMessageClient(workerPromise);
+ *
+ * @example
+ * // With lazy initialization
+ * const client = new WorkerMessageClient(() =>
+ *   document.querySelector('[data-worker]') ? new Worker('./worker.js') : undefined
+ * );
+ *
+ * @example
+ * // Re-initialize with a different worker
+ * const client = new WorkerMessageClient();
+ * // Later, switch to a different worker
+ * client.initialize(new Worker('./different-worker.js'));
+ */
+export declare class WorkerMessageClient extends MessageClient {
+    #private;
+    /**
+     * Observable stream of message responses from the worker or main thread
+     */
+    [RESPONSES$]: Subject<MessageResponse>;
+    /**
+     * Creates a new WorkerMessageClient instance
+     *
+     * @param worker - Optional worker configuration:
+     *   - Worker: Direct worker instance (main thread)
+     *   - Promise<Worker>: Promise resolving to worker (async initialization)
+     *   - () => Worker: Function returning worker (lazy initialization)
+     *   - () => Promise<Worker>: Function returning promise (async lazy initialization)
+     *   - undefined: Omit for worker thread context (uses self)
+     */
+    constructor(worker?: ClientWorkerArg);
+    /**
+     * Initializes or re-initializes the worker connection.
+     *
+     * This method sets up message listeners for the provided worker. If a worker
+     * was previously initialized, it cleans up the old connection before establishing
+     * the new one. This allows for dynamic worker management, such as:
+     * - Switching between different workers at runtime
+     * - Re-establishing connections after worker errors
+     * - Lazy initialization when the worker is conditionally needed
+     *
+     * @param worker - Optional worker configuration:
+     *   - Worker: Direct worker instance (main thread)
+     *   - Promise<Worker>: Promise resolving to worker (async initialization)
+     *   - () => Worker: Function returning worker (lazy initialization)
+     *   - () => Promise<Worker>: Function returning promise (async lazy initialization)
+     *   - undefined: Omit for worker thread context (uses self)
+     *
+     * @example
+     * // Switch to a different worker dynamically
+     * const client = new WorkerMessageClient(oldWorker);
+     * client.initialize(newWorker); // Cleans up old listener, sets up new one
+     *
+     * @example
+     * // Re-initialize after worker error
+     * worker.onerror = () => {
+     *   client.initialize(new Worker('./worker.js'));
+     * };
+     */
+    initialize(worker?: ClientWorkerArg): void;
+    /**
+     * Sends a message to the worker or main thread
+     *
+     * @param message - The message to send
+     * @template T - Type of the message body
+     * @internal Used by @Request decorator
+     */
+    [SEND]<T>(message: Message<T>): void;
+    /**
+     * Generates a unique message ID for tracking request-response pairs
+     *
+     * @returns Unique message identifier
+     * @internal Used by @Request decorator
+     */
+    protected [GET_NEW_ID](): string;
+}
+export {};