@thalesrc/hermes 7.3.0 → 7.5.1

package/request.decorator.cjs

@@ -8,12 +8,12 @@ function Request(path) {
         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) => {
+            return this[selectors_1.RESPONSES$].pipe((0, operators_1.filter)(({ id }) => id === messageId), (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));
+            }), (0, operators_1.takeWhile)((res) => !res.completed), (0, operators_1.map)(({ body }) => body));
         };
         return descriptor;
     };

package/request.decorator.js

@@ -5,12 +5,12 @@ export function Request(path) {
         descriptor.value = function (message) {
             const messageId = this[GET_NEW_ID]();
             this[SEND]({ body: message, id: messageId, path });
-            return this[RESPONSES$].pipe(map((data) => {
+            return this[RESPONSES$].pipe(filter(({ id }) => id === messageId), map((data) => {
                 const { error } = data;
                 if (error)
                     throw error;
                 return data;
-            }), filter(({ id }) => id === messageId), takeWhile((res) => !res.completed), map(({ body }) => body));
+            }), takeWhile((res) => !res.completed), map(({ body }) => body));
         };
         return descriptor;
     };

package/request.decorator.js.map

@@ -1 +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"]}
+{"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,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAEnD,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAC1B,MAAM,CAAC,CAAC,EAAC,EAAE,EAAC,EAAE,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,EAClC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACX,MAAM,EAAE,KAAK,EAAE,GAAG,IAA4B,CAAC;gBAE/C,IAAI,KAAK;oBAAE,MAAM,KAAK,CAAC;gBAEvB,OAAO,IAAiC,CAAC;YAC3C,CAAC,CAAC,EACF,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,EAClC,GAAG,CAAC,CAAC,EAAE,IAAI,EAA8B,EAAE,EAAE,CAAC,IAAI,CAAC,CACpD,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        filter(({id}) => id === messageId),\n        map((data) => {\n          const { error } = data as ErrorMessageResponse;\n\n          if (error) throw error;\n\n          return data as SuccessfulMessageResponse;\n        }),\n        takeWhile((res) => !res.completed),\n        map(({ body }: UncompletedMessageResponse) => body),\n      );\n    };\n\n    return descriptor;\n  };\n}\n"]}

package/selectors.cjs

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GET_NEW_ID = exports.SEND = exports.RESPONSES$ = exports.SENDING_SERVICE = exports.MESSAGE_LISTENERS = void 0;
+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.SENDING_SERVICE = Symbol('Sending Service');
 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

@@ -1,5 +1,7 @@
 export declare const MESSAGE_LISTENERS: unique symbol;
-export declare const SENDING_SERVICE: 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

@@ -1,7 +1,9 @@
 export const MESSAGE_LISTENERS = Symbol('Message Listeners');
-export const SENDING_SERVICE = Symbol('Sending Service');
 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

@@ -1 +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,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AACzD,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","file":"selectors.js","sourcesContent":["export const MESSAGE_LISTENERS = Symbol('Message Listeners');\nexport const SENDING_SERVICE = Symbol('Sending Service');\nexport const RESPONSES$ = Symbol('Responses');\nexport const SEND = Symbol('Send');\nexport const GET_NEW_ID = Symbol('Get New Id');\n"]}
+{"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/initializer.cjs

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializer = initializer;
+const noop_1 = require("@thalesrc/js-utils/function/noop");
+const promisify_1 = require("@thalesrc/js-utils/promise/promisify");
+/**
+ * Initializes a Web Worker or the worker context for message communication.
+ * @param prevWorker The previous worker promise to deinitialize
+ * @param worker The new worker argument (Worker instance, promise, or factory function)
+ * @param handler The message event handler to attach
+ * @returns A promise resolving to the initialized Worker or undefined if in worker context
+ */
+function initializer(prevWorker, worker, handler) {
+    // Deinitialize previous worker if any
+    prevWorker.then(pw => {
+        if (pw) {
+            pw.removeEventListener('message', handler);
+        }
+        else {
+            removeEventListener('message', 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
+    const newWorker = (0, promisify_1.promisify)(_worker);
+    // Set up message listener once worker is resolved
+    newWorker.then(worker => {
+        if (worker) {
+            // Main thread context: listen to specific worker
+            worker.addEventListener('message', handler);
+        }
+        else {
+            // Worker thread context: listen to messages from main thread
+            addEventListener('message', handler);
+        }
+    }).catch(noop_1.noop);
+    return newWorker;
+}

package/worker/initializer.d.ts

@@ -0,0 +1,12 @@
+export type ClientWorkerType = Worker | undefined;
+export type ClientWorkerPromise = Promise<ClientWorkerType>;
+export type ClientWorkerFactory = () => ClientWorkerType | ClientWorkerPromise;
+export type ClientWorkerArg = ClientWorkerType | ClientWorkerPromise | ClientWorkerFactory;
+/**
+ * Initializes a Web Worker or the worker context for message communication.
+ * @param prevWorker The previous worker promise to deinitialize
+ * @param worker The new worker argument (Worker instance, promise, or factory function)
+ * @param handler The message event handler to attach
+ * @returns A promise resolving to the initialized Worker or undefined if in worker context
+ */
+export declare function initializer(prevWorker: ClientWorkerPromise, worker: ClientWorkerArg, handler: (event: MessageEvent) => void): Promise<Worker | undefined>;

package/worker/initializer.js

@@ -0,0 +1,38 @@
+import { noop } from "@thalesrc/js-utils/function/noop";
+import { promisify } from "@thalesrc/js-utils/promise/promisify";
+/**
+ * Initializes a Web Worker or the worker context for message communication.
+ * @param prevWorker The previous worker promise to deinitialize
+ * @param worker The new worker argument (Worker instance, promise, or factory function)
+ * @param handler The message event handler to attach
+ * @returns A promise resolving to the initialized Worker or undefined if in worker context
+ */
+export function initializer(prevWorker, worker, handler) {
+    // Deinitialize previous worker if any
+    prevWorker.then(pw => {
+        if (pw) {
+            pw.removeEventListener('message', handler);
+        }
+        else {
+            removeEventListener('message', handler);
+        }
+    }).catch(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
+    const newWorker = promisify(_worker);
+    // Set up message listener once worker is resolved
+    newWorker.then(worker => {
+        if (worker) {
+            // Main thread context: listen to specific worker
+            worker.addEventListener('message', handler);
+        }
+        else {
+            // Worker thread context: listen to messages from main thread
+            addEventListener('message', handler);
+        }
+    }).catch(noop);
+    return newWorker;
+}
+
+//# sourceMappingURL=initializer.js.map

package/worker/initializer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../libs/hermes/src/worker/initializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAOjE;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,UAA+B,EAC/B,MAAuB,EACvB,OAAsC;IAEtC,sCAAsC;IACtC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QACnB,IAAI,EAAE,EAAE,CAAC;YACP,EAAE,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEf,uFAAuF;IACvF,MAAM,OAAO,GAAuD,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IACrH,sEAAsE;IACtE,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAErC,kDAAkD;IAClD,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;QACtB,IAAI,MAAM,EAAE,CAAC;YACX,iDAAiD;YACjD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,6DAA6D;YAC7D,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEf,OAAO,SAAS,CAAC;AACnB,CAAC","file":"initializer.js","sourcesContent":["import { noop } from \"@thalesrc/js-utils/function/noop\";\nimport { promisify } from \"@thalesrc/js-utils/promise/promisify\";\n\nexport type ClientWorkerType = Worker | undefined;\nexport type ClientWorkerPromise = Promise<ClientWorkerType>;\nexport type ClientWorkerFactory = () => ClientWorkerType | ClientWorkerPromise;\nexport type ClientWorkerArg = ClientWorkerType | ClientWorkerPromise | ClientWorkerFactory;\n\n/**\n * Initializes a Web Worker or the worker context for message communication.\n * @param prevWorker The previous worker promise to deinitialize\n * @param worker The new worker argument (Worker instance, promise, or factory function)\n * @param handler The message event handler to attach\n * @returns A promise resolving to the initialized Worker or undefined if in worker context\n */\nexport function initializer(\n  prevWorker: ClientWorkerPromise,\n  worker: ClientWorkerArg,\n  handler: (event: MessageEvent) => void\n) {\n  // Deinitialize previous worker if any\n  prevWorker.then(pw => {\n    if (pw) {\n      pw.removeEventListener('message', handler);\n    } else {\n      removeEventListener('message', handler);\n    }\n  }).catch(noop);\n\n  // Resolve worker parameter: execute function if provided, otherwise use value directly\n  const _worker: ClientWorkerType | ClientWorkerPromise | undefined = typeof worker === 'function' ? worker() : worker;\n  // Ensure worker is wrapped in a promise for consistent async handling\n  const newWorker = promisify(_worker);\n\n  // Set up message listener once worker is resolved\n  newWorker.then(worker => {\n    if (worker) {\n      // Main thread context: listen to specific worker\n      worker.addEventListener('message', handler);\n    } else {\n      // Worker thread context: listen to messages from main thread\n      addEventListener('message', handler);\n    }\n  }).catch(noop);\n\n  return newWorker;\n}\n"]}

package/worker/message-client.cjs

@@ -3,10 +3,13 @@ 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");
+const initializer_1 = require("./initializer");
+const WORKER = Symbol('Client Worker');
+const HANDLER = Symbol('Client Message Handler');
+const INSTANCE_ID = Symbol('Client Instance ID');
 /**
  * WorkerMessageClient
  *
@@ -57,12 +60,12 @@ 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);
+    [WORKER] = Promise.resolve(undefined);
     /**
      * Unique identifier for this client instance to prevent ID collisions
      * @private
      */
-    #instanceId = Date.now();
+    [INSTANCE_ID] = '' + Math.floor(Math.random() * 10000);
     /**
      * Observable stream of message responses from the worker or main thread
      */
@@ -110,30 +113,11 @@ class WorkerMessageClient extends message_client_1.MessageClient {
      * };
      */
     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);
+        // Ensure WORKER is initialized if not already
+        if (!this[WORKER]) {
+            this[WORKER] = Promise.resolve(undefined);
+        }
+        this[WORKER] = (0, initializer_1.initializer)(this[WORKER], worker, this[HANDLER]);
     }
     /**
      * Sends a message to the worker or main thread
@@ -143,7 +127,7 @@ class WorkerMessageClient extends message_client_1.MessageClient {
      * @internal Used by @Request decorator
      */
     [selectors_1.SEND](message) {
-        this.#worker.then(worker => {
+        this[WORKER].then(worker => {
             if (worker) {
                 // Main thread: send to worker
                 worker.postMessage(message);
@@ -158,7 +142,7 @@ class WorkerMessageClient extends message_client_1.MessageClient {
      * Handles incoming messages and forwards them to the responses stream
      * @private
      */
-    #handler = (event) => {
+    [HANDLER] = (event) => {
         this[selectors_1.RESPONSES$].next(event.data);
     };
     /**
@@ -168,7 +152,7 @@ class WorkerMessageClient extends message_client_1.MessageClient {
      * @internal Used by @Request decorator
      */
     [selectors_1.GET_NEW_ID]() {
-        return (0, unique_id_1.uniqueId)('hermes-worker-message-' + this.#instanceId);
+        return (0, unique_id_1.uniqueId)('hermes-worker-message-' + this[INSTANCE_ID]);
     }
 }
 exports.WorkerMessageClient = WorkerMessageClient;

package/worker/message-client.d.ts

@@ -3,10 +3,10 @@ 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;
+import { ClientWorkerArg } from "./initializer";
+declare const WORKER: unique symbol;
+declare const HANDLER: unique symbol;
+declare const INSTANCE_ID: unique symbol;
 /**
  * WorkerMessageClient
  *
@@ -53,7 +53,16 @@ type ClientWorkerArg = ClientWorkerType | ClientWorkerPromise | ClientWorkerFact
  * client.initialize(new Worker('./different-worker.js'));
  */
 export declare class WorkerMessageClient extends MessageClient {
-    #private;
+    /**
+     * Promise resolving to the Worker instance or undefined if running in worker context
+     * @private
+     */
+    private [WORKER];
+    /**
+     * Unique identifier for this client instance to prevent ID collisions
+     * @private
+     */
+    private [INSTANCE_ID];
     /**
      * Observable stream of message responses from the worker or main thread
      */
@@ -106,6 +115,11 @@ export declare class WorkerMessageClient extends MessageClient {
      * @internal Used by @Request decorator
      */
     [SEND]<T>(message: Message<T>): void;
+    /**
+     * Handles incoming messages and forwards them to the responses stream
+     * @private
+     */
+    private [HANDLER];
     /**
      * Generates a unique message ID for tracking request-response pairs
      *

package/worker/message-client.js

@@ -1,9 +1,12 @@
 import { uniqueId } from "@thalesrc/js-utils/unique-id";
 import { noop } from "@thalesrc/js-utils/function/noop";
-import { promisify } from '@thalesrc/js-utils/promise/promisify';
 import { Subject } from "rxjs";
 import { MessageClient } from "../message-client";
 import { GET_NEW_ID, RESPONSES$, SEND } from "../selectors";
+import { initializer } from "./initializer";
+const WORKER = Symbol('Client Worker');
+const HANDLER = Symbol('Client Message Handler');
+const INSTANCE_ID = Symbol('Client Instance ID');
 /**
  * WorkerMessageClient
  *
@@ -54,12 +57,12 @@ export class WorkerMessageClient extends MessageClient {
      * Promise resolving to the Worker instance or undefined if running in worker context
      * @private
      */
-    #worker = Promise.resolve(undefined);
+    [WORKER] = Promise.resolve(undefined);
     /**
      * Unique identifier for this client instance to prevent ID collisions
      * @private
      */
-    #instanceId = Date.now();
+    [INSTANCE_ID] = '' + Math.floor(Math.random() * 10000);
     /**
      * Observable stream of message responses from the worker or main thread
      */
@@ -107,30 +110,11 @@ export class WorkerMessageClient extends MessageClient {
      * };
      */
     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);
-        // 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 = 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);
+        // Ensure WORKER is initialized if not already
+        if (!this[WORKER]) {
+            this[WORKER] = Promise.resolve(undefined);
+        }
+        this[WORKER] = initializer(this[WORKER], worker, this[HANDLER]);
     }
     /**
      * Sends a message to the worker or main thread
@@ -140,7 +124,7 @@ export class WorkerMessageClient extends MessageClient {
      * @internal Used by @Request decorator
      */
     [SEND](message) {
-        this.#worker.then(worker => {
+        this[WORKER].then(worker => {
             if (worker) {
                 // Main thread: send to worker
                 worker.postMessage(message);
@@ -155,7 +139,7 @@ export class WorkerMessageClient extends MessageClient {
      * Handles incoming messages and forwards them to the responses stream
      * @private
      */
-    #handler = (event) => {
+    [HANDLER] = (event) => {
         this[RESPONSES$].next(event.data);
     };
     /**
@@ -165,7 +149,7 @@ export class WorkerMessageClient extends MessageClient {
      * @internal Used by @Request decorator
      */
     [GET_NEW_ID]() {
-        return uniqueId('hermes-worker-message-' + this.#instanceId);
+        return uniqueId('hermes-worker-message-' + this[INSTANCE_ID]);
     }
 }
 

package/worker/message-client.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../libs/hermes/src/worker/message-client.ts"],"names":[],"mappings":"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","file":"message-client.js","sourcesContent":["import { uniqueId } from \"@thalesrc/js-utils/unique-id\";\nimport { noop } from \"@thalesrc/js-utils/function/noop\";\nimport { promisify } from '@thalesrc/js-utils/promise/promisify';\nimport { Subject } from \"rxjs\";\nimport { MessageClient } from \"../message-client\";\nimport { MessageResponse } from \"../message-response.type\";\nimport { Message } from \"../message.interface\";\nimport { GET_NEW_ID, RESPONSES$, SEND } from \"../selectors\";\n\ntype ClientWorkerType = Worker | undefined;\ntype ClientWorkerPromise = Promise<ClientWorkerType>;\ntype ClientWorkerFactory = () => ClientWorkerType | ClientWorkerPromise;\ntype ClientWorkerArg = ClientWorkerType | ClientWorkerPromise | ClientWorkerFactory;\n\n/**\n * WorkerMessageClient\n *\n * Client implementation for Web Worker communication. Sends messages to and receives\n * responses from Web Workers using the Worker postMessage API.\n *\n * This class can be used in two contexts:\n * - **Main thread**: Provide a Worker instance to communicate with that specific worker\n * - **Worker thread**: Omit the worker parameter to communicate with the main thread via self\n *\n * The worker parameter supports multiple types for flexibility:\n * - Direct Worker instance\n * - Promise that resolves to a Worker (for async worker initialization)\n * - Function that returns a Worker (for lazy initialization)\n * - Function that returns a Promise<Worker> (for async lazy initialization)\n *\n * The `initialize()` method allows dynamic worker management, enabling you to switch\n * workers at runtime or re-establish connections after errors.\n *\n * @example\n * // In main thread - communicate with a specific worker\n * const worker = new Worker('./worker.js');\n * const client = new WorkerMessageClient(worker);\n *\n * @example\n * // In worker thread - communicate with main thread\n * const client = new WorkerMessageClient();\n *\n * @example\n * // With async worker initialization\n * const workerPromise = import('./worker.js').then(m => new m.MyWorker());\n * const client = new WorkerMessageClient(workerPromise);\n *\n * @example\n * // With lazy initialization\n * const client = new WorkerMessageClient(() =>\n *   document.querySelector('[data-worker]') ? new Worker('./worker.js') : undefined\n * );\n *\n * @example\n * // Re-initialize with a different worker\n * const client = new WorkerMessageClient();\n * // Later, switch to a different worker\n * client.initialize(new Worker('./different-worker.js'));\n */\nexport class WorkerMessageClient extends MessageClient {\n  /**\n   * Promise resolving to the Worker instance or undefined if running in worker context\n   * @private\n   */\n  #worker: ClientWorkerPromise = Promise.resolve(undefined);\n\n  /**\n   * Unique identifier for this client instance to prevent ID collisions\n   * @private\n   */\n  #instanceId = Date.now();\n\n  /**\n   * Observable stream of message responses from the worker or main thread\n   */\n  public [RESPONSES$] = new Subject<MessageResponse>();\n\n  /**\n   * Creates a new WorkerMessageClient instance\n   *\n   * @param worker - Optional worker configuration:\n   *   - Worker: Direct worker instance (main thread)\n   *   - Promise<Worker>: Promise resolving to worker (async initialization)\n   *   - () => Worker: Function returning worker (lazy initialization)\n   *   - () => Promise<Worker>: Function returning promise (async lazy initialization)\n   *   - undefined: Omit for worker thread context (uses self)\n   */\n  constructor(worker?: ClientWorkerArg) {\n    super();\n\n    this.initialize(worker);\n  }\n\n  /**\n   * Initializes or re-initializes the worker connection.\n   *\n   * This method sets up message listeners for the provided worker. If a worker\n   * was previously initialized, it cleans up the old connection before establishing\n   * the new one. This allows for dynamic worker management, such as:\n   * - Switching between different workers at runtime\n   * - Re-establishing connections after worker errors\n   * - Lazy initialization when the worker is conditionally needed\n   *\n   * @param worker - Optional worker configuration:\n   *   - Worker: Direct worker instance (main thread)\n   *   - Promise<Worker>: Promise resolving to worker (async initialization)\n   *   - () => Worker: Function returning worker (lazy initialization)\n   *   - () => Promise<Worker>: Function returning promise (async lazy initialization)\n   *   - undefined: Omit for worker thread context (uses self)\n   *\n   * @example\n   * // Switch to a different worker dynamically\n   * const client = new WorkerMessageClient(oldWorker);\n   * client.initialize(newWorker); // Cleans up old listener, sets up new one\n   *\n   * @example\n   * // Re-initialize after worker error\n   * worker.onerror = () => {\n   *   client.initialize(new Worker('./worker.js'));\n   * };\n   */\n  initialize(worker?: ClientWorkerArg) {\n    // Deinitialize previous worker if any\n    this.#worker.then(prevWorker => {\n      if (prevWorker) {\n        prevWorker.removeEventListener('message', this.#handler);\n      } else {\n        removeEventListener('message', this.#handler);\n      }\n    }).catch(noop);\n\n    // Resolve worker parameter: execute function if provided, otherwise use value directly\n    const _worker: ClientWorkerType | ClientWorkerPromise | undefined = typeof worker === 'function' ? worker() : worker;\n    // Ensure worker is wrapped in a promise for consistent async handling\n    this.#worker = promisify(_worker);\n\n    // Set up message listener once worker is resolved\n    this.#worker.then(worker => {\n      if (worker) {\n        // Main thread context: listen to specific worker\n        worker.addEventListener('message', this.#handler);\n      } else {\n        // Worker thread context: listen to messages from main thread\n        addEventListener('message', this.#handler);\n      }\n    }).catch(noop);\n  }\n\n  /**\n   * Sends a message to the worker or main thread\n   *\n   * @param message - The message to send\n   * @template T - Type of the message body\n   * @internal Used by @Request decorator\n   */\n  public [SEND]<T>(message: Message<T>) {\n    this.#worker.then(worker => {\n      if (worker) {\n        // Main thread: send to worker\n        worker.postMessage(message);\n      } else {\n        // Worker thread: send to main thread\n        (postMessage as any)(message);\n      }\n    }).catch(noop);\n  }\n\n  /**\n   * Handles incoming messages and forwards them to the responses stream\n   * @private\n   */\n  #handler = (event: MessageEvent<MessageResponse>) => {\n    this[RESPONSES$].next(event.data);\n  }\n\n  /**\n   * Generates a unique message ID for tracking request-response pairs\n   *\n   * @returns Unique message identifier\n   * @internal Used by @Request decorator\n   */\n  protected [GET_NEW_ID](): string {\n    return uniqueId('hermes-worker-message-' + this.#instanceId) as string;\n  }\n}\n"]}
+{"version":3,"sources":["../../../../../libs/hermes/src/worker/message-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAwC,WAAW,EAAE,MAAM,eAAe,CAAC;AAElF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;AACvC,MAAM,OAAO,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AACjD,MAAM,WAAW,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IACpD;;;OAGG;IACK,CAAC,MAAM,CAAC,GAAwB,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEnE;;;OAGG;IACK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;IAE/D;;OAEG;IACI,CAAC,UAAU,CAAC,GAAG,IAAI,OAAO,EAAmB,CAAC;IAErD;;;;;;;;;OASG;IACH,YAAY,MAAwB;QAClC,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,UAAU,CAAC,MAAwB;QACjC,8CAA8C;QAC9C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,WAAW,CACxB,IAAI,CAAC,MAAM,CAAC,EACZ,MAAM,EACN,IAAI,CAAC,OAAO,CAAC,CACd,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACI,CAAC,IAAI,CAAC,CAAI,OAAmB;QAClC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;YACzB,IAAI,MAAM,EAAE,CAAC;gBACX,8BAA8B;gBAC9B,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,qCAAqC;gBACpC,WAAmB,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IAED;;;OAGG;IACK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAoC,EAAE,EAAE;QAC3D,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAA;IAED;;;;;OAKG;IACO,CAAC,UAAU,CAAC;QACpB,OAAO,QAAQ,CAAC,wBAAwB,GAAG,IAAI,CAAC,WAAW,CAAC,CAAW,CAAC;IAC1E,CAAC;CACF","file":"message-client.js","sourcesContent":["import { uniqueId } from \"@thalesrc/js-utils/unique-id\";\nimport { noop } from \"@thalesrc/js-utils/function/noop\";\nimport { Subject } from \"rxjs\";\nimport { MessageClient } from \"../message-client\";\nimport { MessageResponse } from \"../message-response.type\";\nimport { Message } from \"../message.interface\";\nimport { GET_NEW_ID, RESPONSES$, SEND } from \"../selectors\";\nimport { ClientWorkerArg, ClientWorkerPromise, initializer } from \"./initializer\";\n\nconst WORKER = Symbol('Client Worker');\nconst HANDLER = Symbol('Client Message Handler');\nconst INSTANCE_ID = Symbol('Client Instance ID');\n\n/**\n * WorkerMessageClient\n *\n * Client implementation for Web Worker communication. Sends messages to and receives\n * responses from Web Workers using the Worker postMessage API.\n *\n * This class can be used in two contexts:\n * - **Main thread**: Provide a Worker instance to communicate with that specific worker\n * - **Worker thread**: Omit the worker parameter to communicate with the main thread via self\n *\n * The worker parameter supports multiple types for flexibility:\n * - Direct Worker instance\n * - Promise that resolves to a Worker (for async worker initialization)\n * - Function that returns a Worker (for lazy initialization)\n * - Function that returns a Promise<Worker> (for async lazy initialization)\n *\n * The `initialize()` method allows dynamic worker management, enabling you to switch\n * workers at runtime or re-establish connections after errors.\n *\n * @example\n * // In main thread - communicate with a specific worker\n * const worker = new Worker('./worker.js');\n * const client = new WorkerMessageClient(worker);\n *\n * @example\n * // In worker thread - communicate with main thread\n * const client = new WorkerMessageClient();\n *\n * @example\n * // With async worker initialization\n * const workerPromise = import('./worker.js').then(m => new m.MyWorker());\n * const client = new WorkerMessageClient(workerPromise);\n *\n * @example\n * // With lazy initialization\n * const client = new WorkerMessageClient(() =>\n *   document.querySelector('[data-worker]') ? new Worker('./worker.js') : undefined\n * );\n *\n * @example\n * // Re-initialize with a different worker\n * const client = new WorkerMessageClient();\n * // Later, switch to a different worker\n * client.initialize(new Worker('./different-worker.js'));\n */\nexport class WorkerMessageClient extends MessageClient {\n  /**\n   * Promise resolving to the Worker instance or undefined if running in worker context\n   * @private\n   */\n  private [WORKER]: ClientWorkerPromise = Promise.resolve(undefined);\n\n  /**\n   * Unique identifier for this client instance to prevent ID collisions\n   * @private\n   */\n  private [INSTANCE_ID] = '' + Math.floor(Math.random() * 10000);\n\n  /**\n   * Observable stream of message responses from the worker or main thread\n   */\n  public [RESPONSES$] = new Subject<MessageResponse>();\n\n  /**\n   * Creates a new WorkerMessageClient instance\n   *\n   * @param worker - Optional worker configuration:\n   *   - Worker: Direct worker instance (main thread)\n   *   - Promise<Worker>: Promise resolving to worker (async initialization)\n   *   - () => Worker: Function returning worker (lazy initialization)\n   *   - () => Promise<Worker>: Function returning promise (async lazy initialization)\n   *   - undefined: Omit for worker thread context (uses self)\n   */\n  constructor(worker?: ClientWorkerArg) {\n    super();\n\n    this.initialize(worker);\n  }\n\n  /**\n   * Initializes or re-initializes the worker connection.\n   *\n   * This method sets up message listeners for the provided worker. If a worker\n   * was previously initialized, it cleans up the old connection before establishing\n   * the new one. This allows for dynamic worker management, such as:\n   * - Switching between different workers at runtime\n   * - Re-establishing connections after worker errors\n   * - Lazy initialization when the worker is conditionally needed\n   *\n   * @param worker - Optional worker configuration:\n   *   - Worker: Direct worker instance (main thread)\n   *   - Promise<Worker>: Promise resolving to worker (async initialization)\n   *   - () => Worker: Function returning worker (lazy initialization)\n   *   - () => Promise<Worker>: Function returning promise (async lazy initialization)\n   *   - undefined: Omit for worker thread context (uses self)\n   *\n   * @example\n   * // Switch to a different worker dynamically\n   * const client = new WorkerMessageClient(oldWorker);\n   * client.initialize(newWorker); // Cleans up old listener, sets up new one\n   *\n   * @example\n   * // Re-initialize after worker error\n   * worker.onerror = () => {\n   *   client.initialize(new Worker('./worker.js'));\n   * };\n   */\n  initialize(worker?: ClientWorkerArg) {\n    // Ensure WORKER is initialized if not already\n    if (!this[WORKER]) {\n      this[WORKER] = Promise.resolve(undefined);\n    }\n\n    this[WORKER] = initializer(\n      this[WORKER],\n      worker,\n      this[HANDLER]\n    );\n  }\n\n  /**\n   * Sends a message to the worker or main thread\n   *\n   * @param message - The message to send\n   * @template T - Type of the message body\n   * @internal Used by @Request decorator\n   */\n  public [SEND]<T>(message: Message<T>) {\n    this[WORKER].then(worker => {\n      if (worker) {\n        // Main thread: send to worker\n        worker.postMessage(message);\n      } else {\n        // Worker thread: send to main thread\n        (postMessage as any)(message);\n      }\n    }).catch(noop);\n  }\n\n  /**\n   * Handles incoming messages and forwards them to the responses stream\n   * @private\n   */\n  private [HANDLER] = (event: MessageEvent<MessageResponse>) => {\n    this[RESPONSES$].next(event.data);\n  }\n\n  /**\n   * Generates a unique message ID for tracking request-response pairs\n   *\n   * @returns Unique message identifier\n   * @internal Used by @Request decorator\n   */\n  protected [GET_NEW_ID](): string {\n    return uniqueId('hermes-worker-message-' + this[INSTANCE_ID]) as string;\n  }\n}\n"]}