@venizia/ignis-helpers 0.1.1 → 0.2.0-0

package/dist/esm/modules/uid/request-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-id.js","sourceRoot":"","sources":["../../../../src/modules/uid/request-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;;;;;GASG;AACH,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAIhD,YAAY,IAAyB;QACnC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC;QAHnD,qBAAgB,GAAG,CAAC,CAAC;QAI3B,IAAI,CAAC,SAAS,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM;QACJ,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC;YAE3B,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;iBACrB,IAAI,CACH,sEAAsE,EACtE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;YAEJ,OAAO,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC3D,CAAC;IACH,CAAC;CACF"}

package/dist/esm/modules/worker-thread/base.d.ts

@@ -0,0 +1,78 @@
+import { Worker, WorkerOptions } from 'node:worker_threads';
+import { AnyType, ValueOrPromise } from '../../common/types.js';
+import { BaseHelper } from '../../modules/base.js';
+import { IWorker, IWorkerBus, IWorkerThread } from './types.js';
+export declare abstract class AbstractWorkerHelper<MessageType> extends BaseHelper implements IWorker<MessageType> {
+    worker: Worker;
+    options: WorkerOptions;
+    abstract onOnline(): ValueOrPromise<void>;
+    abstract onExit(opts: {
+        code: string | number;
+    }): ValueOrPromise<void>;
+    abstract onError(opts: {
+        error: Error;
+    }): ValueOrPromise<void>;
+    abstract onMessage(opts: {
+        message: MessageType;
+    }): ValueOrPromise<void>;
+    abstract onMessageError(opts: {
+        error: Error;
+    }): ValueOrPromise<void>;
+}
+export declare class BaseWorkerHelper<MessageType> extends AbstractWorkerHelper<MessageType> {
+    protected eventHandlers?: Partial<Pick<IWorker<MessageType>, 'onOnline' | 'onExit' | 'onError' | 'onMessage' | 'onMessageError'>>;
+    constructor(opts: {
+        scope?: string;
+        identifier: string;
+        path: string | URL;
+        options: WorkerOptions;
+        eventHandlers?: Partial<Pick<IWorker<MessageType>, 'onOnline' | 'onExit' | 'onError' | 'onMessage' | 'onMessageError'>>;
+    });
+    /** User handlers run inside worker listeners; a sync throw there is uncaught and kills the process, so wrap it - voidExecution alone can't catch a throw evaluated before it's called. */
+    protected invokeHook(opts: {
+        scope: string;
+        execution: () => ValueOrPromise<void>;
+    }): void;
+    onOnline(): ValueOrPromise<void>;
+    onExit(opts: {
+        code: string | number;
+    }): ValueOrPromise<void>;
+    onError(opts: {
+        error: Error;
+    }): ValueOrPromise<void>;
+    onMessage(opts: {
+        message: MessageType;
+    }): ValueOrPromise<void>;
+    onMessageError(opts: {
+        error: Error;
+    }): ValueOrPromise<void>;
+    binding(): void;
+}
+export declare abstract class AbstractWorkerThreadHelper extends BaseHelper implements IWorkerThread {
+    buses: {
+        [workerKey: string | symbol]: IWorkerBus<AnyType, AnyType>;
+    };
+    abstract bindWorkerBus<IC, IP>(opts: {
+        key: string;
+        bus: IWorkerBus<IC, IP>;
+    }): ValueOrPromise<void>;
+    abstract getWorkerBus<IC, IP>(opts: {
+        key: string;
+    }): IWorkerBus<IC, IP>;
+}
+export declare class BaseWorkerThreadHelper extends AbstractWorkerThreadHelper {
+    constructor(opts: {
+        scope: string;
+    });
+    bindWorkerBus<IC, IP>(opts: {
+        key: string;
+        bus: IWorkerBus<IC, IP>;
+    }): void;
+    unbindWorkerBus(opts: {
+        key: string;
+    }): void;
+    getWorkerBus<IC, IP>(opts: {
+        key: string;
+    }): IWorkerBus<IC, IP>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/esm/modules/worker-thread/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/modules/worker-thread/base.ts"],"names":[],"mappings":"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"}

package/dist/esm/modules/worker-thread/base.js

@@ -0,0 +1,147 @@
+import { toError, voidExecution } from '../../utilities/promise.utility.js';
+import { isMainThread, Worker } from 'node:worker_threads';
+import { BaseHelper } from '../../modules/base.js';
+import { getError } from '../../modules/error/index.js';
+export class AbstractWorkerHelper extends BaseHelper {
+}
+export class BaseWorkerHelper extends AbstractWorkerHelper {
+    constructor(opts) {
+        super({ scope: BaseWorkerHelper.name, identifier: opts.identifier });
+        this.worker = new Worker(opts.path, opts.options);
+        this.eventHandlers = opts.eventHandlers;
+        this.binding();
+    }
+    /** User handlers run inside worker listeners; a sync throw there is uncaught and kills the process, so wrap it - voidExecution alone can't catch a throw evaluated before it's called. */
+    invokeHook(opts) {
+        const { scope, execution } = opts;
+        try {
+            voidExecution({ logger: this.logger, scope, execution: execution() });
+        }
+        catch (error) {
+            this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);
+        }
+    }
+    onOnline() {
+        if (this.eventHandlers?.onOnline) {
+            this.invokeHook({
+                scope: this.onOnline.name,
+                execution: () => this.eventHandlers?.onOnline?.(),
+            });
+            return;
+        }
+        this.logger.for(this.onOnline.name).info('Worker ONLINE');
+    }
+    onExit(opts) {
+        if (this.eventHandlers?.onExit) {
+            this.invokeHook({
+                scope: this.onExit.name,
+                execution: () => this.eventHandlers?.onExit?.({ code: opts.code }),
+            });
+            return;
+        }
+        this.logger.for(this.onExit.name).warn('Worker EXIT | Code: %s', opts.code);
+    }
+    onError(opts) {
+        if (this.eventHandlers?.onError) {
+            this.invokeHook({
+                scope: this.onError.name,
+                execution: () => this.eventHandlers?.onError?.({ error: opts.error }),
+            });
+            return;
+        }
+        this.logger.for(this.onError.name).error('Worker ERROR | Error: %s', opts.error);
+    }
+    onMessage(opts) {
+        if (this.eventHandlers?.onMessage) {
+            this.invokeHook({
+                scope: this.onMessage.name,
+                execution: () => this.eventHandlers?.onMessage?.({ message: opts.message }),
+            });
+            return;
+        }
+        this.logger.for(this.onMessage.name).error('Worker MESSAGE | message: %j', opts.message);
+    }
+    onMessageError(opts) {
+        if (this.eventHandlers?.onMessageError) {
+            this.invokeHook({
+                scope: this.onMessageError.name,
+                execution: () => this.eventHandlers?.onMessageError?.({ error: opts.error }),
+            });
+            return;
+        }
+        this.logger.for(this.onMessageError.name).error('Worker MESSAGE_ERROR | Error: %s', opts.error);
+    }
+    binding() {
+        if (!this.worker) {
+            throw getError({ message: '[binding] Invalid worker instance to bind event handlers' });
+        }
+        this.worker.on('online', () => {
+            this.invokeHook({ scope: this.binding.name, execution: () => this.onOnline() });
+        });
+        this.worker.on('exit', code => {
+            this.invokeHook({ scope: this.binding.name, execution: () => this.onExit({ code }) });
+        });
+        this.worker.on('error', error => {
+            this.invokeHook({
+                scope: this.binding.name,
+                execution: () => this.onError({ error: toError(error) }),
+            });
+        });
+        this.worker.on('message', message => {
+            this.invokeHook({ scope: this.binding.name, execution: () => this.onMessage({ message }) });
+        });
+        this.worker.on('messageerror', error => {
+            this.invokeHook({
+                scope: this.binding.name,
+                execution: () => this.onMessageError({ error }),
+            });
+        });
+    }
+}
+export class AbstractWorkerThreadHelper extends BaseHelper {
+}
+export class BaseWorkerThreadHelper extends AbstractWorkerThreadHelper {
+    constructor(opts) {
+        const { scope } = opts;
+        super({ scope, identifier: scope });
+        if (isMainThread) {
+            throw getError({
+                message: '[BaseWorker] Cannot start worker in MAIN_THREAD',
+            });
+        }
+        this.buses = {};
+    }
+    bindWorkerBus(opts) {
+        if (!this.buses) {
+            this.buses = {};
+        }
+        const { key, bus } = opts;
+        if (this.buses[key]) {
+            this.logger.for(this.bindWorkerBus.name).warn('Worker Bus existed | key: %s', key);
+            return;
+        }
+        this.buses[key] = bus;
+    }
+    unbindWorkerBus(opts) {
+        if (!this.buses) {
+            return;
+        }
+        const { key } = opts;
+        if (!(key in this.buses)) {
+            this.logger.for(this.unbindWorkerBus.name).warn('Worker Bus not existed | key: %s', key);
+            return;
+        }
+        this.buses[key]?.port?.removeAllListeners();
+        delete this.buses[key];
+    }
+    getWorkerBus(opts) {
+        const rs = this.buses[opts.key];
+        if (!rs) {
+            throw getError({
+                message: `[getWorkerBus] Not found worker bus | key: ${opts.key}`,
+            });
+        }
+        return rs;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/esm/modules/worker-thread/base.js.map

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

package/dist/esm/modules/worker-thread/index.d.ts

@@ -0,0 +1,5 @@
+export * from './base.js';
+export * from './types.js';
+export * from './worker-bus.js';
+export * from './worker-pool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/modules/worker-thread/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/worker-thread/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/esm/modules/worker-thread/index.js

@@ -0,0 +1,5 @@
+export * from './base.js';
+export * from './types.js';
+export * from './worker-bus.js';
+export * from './worker-pool.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/modules/worker-thread/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/worker-thread/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/esm/modules/worker-thread/types.d.ts

@@ -0,0 +1,51 @@
+import { AnyType, ValueOrPromise } from '../../common/types.js';
+import { MessagePort, Transferable, Worker, WorkerOptions } from 'node:worker_threads';
+export interface IWorker<MessageType> {
+    worker: Worker;
+    options: WorkerOptions;
+    onOnline(): ValueOrPromise<void>;
+    onExit(opts: {
+        code: string | number;
+    }): ValueOrPromise<void>;
+    onError(opts: {
+        error: Error;
+    }): ValueOrPromise<void>;
+    onMessage(opts: {
+        message: MessageType;
+    }): ValueOrPromise<void>;
+    onMessageError(opts: {
+        error: Error;
+    }): ValueOrPromise<void>;
+}
+export interface IWorkerThread {
+    buses: {
+        [workerKey: string | symbol]: IWorkerBus<AnyType, AnyType>;
+    };
+}
+export interface IWorkerMessageBusHandler<IConsumePayload> {
+    onMessage: (opts: {
+        message: IConsumePayload;
+    }) => ValueOrPromise<void>;
+    onClose: () => ValueOrPromise<void>;
+    onError: (opts: {
+        error: Error;
+    }) => ValueOrPromise<void>;
+    onExit: (opts: {
+        exitCode: number | string;
+    }) => ValueOrPromise<void>;
+}
+export interface IWorkerBus<IConsumePayload, IPublishPayload> {
+    port: MessagePort;
+    handler: IWorkerMessageBusHandler<IConsumePayload>;
+    onBeforePostMessage?(opts: {
+        message: IPublishPayload;
+    }): ValueOrPromise<void>;
+    onAfterPostMessage?(opts: {
+        message: IPublishPayload;
+    }): ValueOrPromise<void>;
+    postMessage(opts: {
+        message: IPublishPayload;
+        transferList: readonly Transferable[] | undefined;
+    }): ValueOrPromise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/modules/worker-thread/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/modules/worker-thread/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEvF,MAAM,WAAW,OAAO,CAAC,WAAW;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,aAAa,CAAC;IAEvB,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACtD,SAAS,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAChE,cAAc,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE;QACL,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;KAC5D,CAAC;CACH;AAED,MAAM,WAAW,wBAAwB,CAAC,eAAe;IACvD,SAAS,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,eAAe,CAAA;KAAE,KAAK,cAAc,CAAC,IAAI,CAAC,CAAC;IAExE,OAAO,EAAE,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,KAAK,cAAc,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,KAAK,cAAc,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,UAAU,CAAC,eAAe,EAAE,eAAe;IAC1D,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,wBAAwB,CAAC,eAAe,CAAC,CAAC;IAEnD,mBAAmB,CAAC,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,eAAe,CAAA;KAAE,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAC/E,kBAAkB,CAAC,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,eAAe,CAAA;KAAE,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9E,WAAW,CAAC,IAAI,EAAE;QAChB,OAAO,EAAE,eAAe,CAAC;QACzB,YAAY,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,CAAC;KACnD,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/esm/modules/worker-thread/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/modules/worker-thread/types.js.map

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

package/dist/esm/modules/worker-thread/worker-bus.d.ts

@@ -0,0 +1,68 @@
+import { ValueOrPromise } from '../../common/types.js';
+import { BaseHelper } from '../../modules/base.js';
+import { MessagePort, Transferable } from 'node:worker_threads';
+import { IWorkerBus, IWorkerMessageBusHandler } from './types.js';
+export declare abstract class AbstractWorkerMessageBusHandlerHelper<IConsumePayload> extends BaseHelper implements IWorkerMessageBusHandler<IConsumePayload> {
+    onMessage: (opts: {
+        message: IConsumePayload;
+    }) => ValueOrPromise<void>;
+    onClose: () => ValueOrPromise<void>;
+    onError: (opts: {
+        error: Error;
+    }) => ValueOrPromise<void>;
+    onExit: (opts: {
+        exitCode: number | string;
+    }) => ValueOrPromise<void>;
+}
+export declare class BaseWorkerMessageBusHandlerHelper<IConsumePayload> extends AbstractWorkerMessageBusHandlerHelper<IConsumePayload> {
+    constructor(opts: {
+        scope: string;
+        onMessage: (opts: {
+            message: IConsumePayload;
+        }) => ValueOrPromise<void>;
+        onClose?: () => ValueOrPromise<void>;
+        onError?: (opts: {
+            error: Error;
+        }) => ValueOrPromise<void>;
+        onExit?: (opts: {
+            exitCode: number | string;
+        }) => ValueOrPromise<void>;
+    });
+}
+export declare abstract class AbstractWorkerBusHelper<IConsumePayload, IPublishPayload> extends BaseHelper implements IWorkerBus<IConsumePayload, IPublishPayload> {
+    port: MessagePort;
+    handler: IWorkerMessageBusHandler<IConsumePayload>;
+    abstract onBeforePostMessage?(opts: {
+        message: IPublishPayload;
+    }): ValueOrPromise<void>;
+    abstract onAfterPostMessage?(opts: {
+        message: IPublishPayload;
+    }): ValueOrPromise<void>;
+    abstract postMessage(opts: {
+        message: IPublishPayload;
+        transferList: readonly Transferable[] | undefined;
+    }): ValueOrPromise<void>;
+}
+export declare class BaseWorkerBusHelper<IConsumePayload, IPublishPayload> extends AbstractWorkerBusHelper<IConsumePayload, IPublishPayload> {
+    constructor(opts: {
+        scope: string;
+        port: MessagePort;
+        busHandler: IWorkerMessageBusHandler<IConsumePayload>;
+    });
+    /** Bus handlers run inside MessagePort listeners; a sync throw there is uncaught and kills the worker thread, so wrap it - voidExecution alone can't catch a throw evaluated before it's called. */
+    protected invokeHook(opts: {
+        scope: string;
+        execution: () => ValueOrPromise<void>;
+    }): void;
+    onBeforePostMessage?(opts: {
+        message: IPublishPayload;
+    }): ValueOrPromise<void>;
+    onAfterPostMessage?(opts: {
+        message: IPublishPayload;
+    }): ValueOrPromise<void>;
+    postMessage(opts: {
+        message: IPublishPayload;
+        transferList: readonly Transferable[] | undefined;
+    }): ValueOrPromise<void>;
+}
+//# sourceMappingURL=worker-bus.d.ts.map

package/dist/esm/modules/worker-thread/worker-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-bus.d.ts","sourceRoot":"","sources":["../../../../src/modules/worker-thread/worker-bus.ts"],"names":[],"mappings":"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"}

package/dist/esm/modules/worker-thread/worker-bus.js

@@ -0,0 +1,78 @@
+import { BaseHelper } from '../../modules/base.js';
+import { voidExecution } from '../../utilities/promise.utility.js';
+export class AbstractWorkerMessageBusHandlerHelper extends BaseHelper {
+}
+export class BaseWorkerMessageBusHandlerHelper extends AbstractWorkerMessageBusHandlerHelper {
+    constructor(opts) {
+        super({ scope: opts.scope, identifier: opts.scope });
+        this.onMessage = opts.onMessage;
+        this.onClose = opts?.onClose ?? (() => { });
+        this.onExit =
+            opts?.onExit ??
+                ((_opts) => {
+                    this.logger.for(this.onExit.name).warn('worker EXITED | exitCode: %s', _opts.exitCode);
+                });
+        this.onError =
+            opts?.onError ??
+                ((_opts) => {
+                    this.logger.for(this.onError.name).error('worker error: %s', _opts.error);
+                });
+    }
+}
+export class AbstractWorkerBusHelper extends BaseHelper {
+}
+export class BaseWorkerBusHelper extends AbstractWorkerBusHelper {
+    constructor(opts) {
+        super({ scope: opts.scope, identifier: opts.scope });
+        this.port = opts.port;
+        this.handler = opts.busHandler;
+        this.port.on('message', message => {
+            this.invokeHook({ scope: 'onMessage', execution: () => this.handler.onMessage({ message }) });
+        });
+        this.port.on('error', error => {
+            this.invokeHook({ scope: 'onError', execution: () => this.handler.onError({ error }) });
+        });
+        this.port.on('messageerror', error => {
+            this.invokeHook({ scope: 'onError', execution: () => this.handler.onError({ error }) });
+        });
+        this.port.on('exit', exitCode => {
+            this.invokeHook({ scope: 'onExit', execution: () => this.handler.onExit({ exitCode }) });
+        });
+        this.port.on('close', () => {
+            this.invokeHook({ scope: 'onClose', execution: () => this.handler.onClose() });
+        });
+    }
+    /** Bus handlers run inside MessagePort listeners; a sync throw there is uncaught and kills the worker thread, so wrap it - voidExecution alone can't catch a throw evaluated before it's called. */
+    invokeHook(opts) {
+        const { scope, execution } = opts;
+        try {
+            voidExecution({ logger: this.logger, scope, execution: execution() });
+        }
+        catch (error) {
+            this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);
+        }
+    }
+    postMessage(opts) {
+        if (!this.port) {
+            this.logger
+                .for(this.postMessage.name)
+                .error('Failed to post message to main | Invalid parentPort!');
+            return;
+        }
+        this.invokeHook({
+            scope: this.postMessage.name,
+            execution: () => this.onBeforePostMessage?.(opts),
+        });
+        if (opts.transferList) {
+            this.port.postMessage(opts.message, [...opts.transferList]);
+        }
+        else {
+            this.port.postMessage(opts.message);
+        }
+        this.invokeHook({
+            scope: this.postMessage.name,
+            execution: () => this.onAfterPostMessage?.(opts),
+        });
+    }
+}
+//# sourceMappingURL=worker-bus.js.map

package/dist/esm/modules/worker-thread/worker-bus.js.map

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

package/dist/esm/modules/worker-thread/worker-pool.d.ts

@@ -0,0 +1,27 @@
+import { BaseHelper } from '../../modules/base.js';
+import { IWorker } from './types.js';
+export declare class WorkerPoolHelper extends BaseHelper {
+    private static instance;
+    protected registry: Map<string | symbol, IWorker<any>>;
+    private numberOfCPUs;
+    private ignoreMaxWarning;
+    constructor(opts?: {
+        ignoreMaxWarning?: boolean;
+    });
+    static getInstance(): WorkerPoolHelper;
+    size(): number;
+    get<MessageType>(opts: {
+        key: string;
+    }): IWorker<MessageType> | undefined;
+    has(opts: {
+        key: string;
+    }): boolean;
+    register<MessageType>(opts: {
+        key: string;
+        worker: IWorker<MessageType>;
+    }): boolean;
+    unregister(opts: {
+        key: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=worker-pool.d.ts.map

package/dist/esm/modules/worker-thread/worker-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-pool.d.ts","sourceRoot":"","sources":["../../../../src/modules/worker-thread/worker-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAC1C,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAEvD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAU;gBAEtB,IAAI,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE;IASjD,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAQtC,IAAI;IAIJ,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GACE,OAAO,CAAC,WAAW,CAAC,GAAG,SAAS;IAGxE,GAAG,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;IAIzB,QAAQ,CAAC,WAAW,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;KAAE;IAmCnE,UAAU,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;CA0BvC"}

package/dist/esm/modules/worker-thread/worker-pool.js

@@ -0,0 +1,76 @@
+import { BaseHelper } from '../../modules/base.js';
+import { getError } from '../../modules/error/index.js';
+import os from 'node:os';
+export class WorkerPoolHelper extends BaseHelper {
+    constructor(opts) {
+        super({ scope: WorkerPoolHelper.name });
+        this.registry = new Map([]);
+        const cpus = os.cpus();
+        this.numberOfCPUs = cpus.length;
+        this.ignoreMaxWarning = opts?.ignoreMaxWarning ?? false;
+    }
+    static getInstance() {
+        if (!WorkerPoolHelper.instance) {
+            WorkerPoolHelper.instance = new WorkerPoolHelper({ ignoreMaxWarning: false });
+        }
+        return WorkerPoolHelper.instance;
+    }
+    size() {
+        return this.registry.size;
+    }
+    get(opts) {
+        return this.registry.get(opts.key);
+    }
+    has(opts) {
+        return this.registry.has(opts.key);
+    }
+    register(opts) {
+        if (!this.registry) {
+            throw getError({
+                message: '[register] Invalid worker registry instance | please init registry before register new worker!',
+            });
+        }
+        if (this.registry.size >= this.numberOfCPUs && !this.ignoreMaxWarning) {
+            this.logger
+                .for(this.register.name)
+                .warn('SKIP register worker | Pool size reached maximum number of cores | CPUs: %s | ignoreMaxWarning: %s', this.numberOfCPUs, this.ignoreMaxWarning);
+            return false;
+        }
+        const { key, worker } = opts;
+        if (this.registry.has(key)) {
+            this.logger
+                .for(this.register.name)
+                .error('SKIP register worker | Worker key existed in pool | key: %s', key);
+            return false;
+        }
+        this.registry.set(key, worker);
+        this.logger
+            .for(this.register.name)
+            .info('Successfully register worker | key: %s | poolSize: %s', key, this.registry.size);
+        return true;
+    }
+    async unregister(opts) {
+        const { key } = opts;
+        if (!this.has({ key })) {
+            this.logger
+                .for(this.unregister.name)
+                .warn('SKIP unregister worker | Worker not existed | key: %s', key);
+            return;
+        }
+        const registered = this.get({ key });
+        // The registry entry must go even if the thread refuses to die, otherwise the key is unusable forever and the pool never drops back below its max-workers bound
+        try {
+            await registered?.worker?.terminate();
+        }
+        catch (error) {
+            this.logger
+                .for(this.unregister.name)
+                .error('Failed to terminate worker | key: %s | error: %s', key, error);
+        }
+        this.registry.delete(key);
+        this.logger
+            .for(this.unregister.name)
+            .info('Successfully unregister worker | key: %s | poolSize: %s', key, this.registry.size);
+    }
+}
+//# sourceMappingURL=worker-pool.js.map

package/dist/esm/modules/worker-thread/worker-pool.js.map

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

package/dist/esm/utilities/crypto.utility.d.ts

@@ -0,0 +1,7 @@
+import C from 'node:crypto';
+export declare const hash: (text: string, options: {
+    algorithm: "SHA256" | "MD5";
+    secret?: string;
+    outputType: C.BinaryToTextEncoding;
+}) => string;
+//# sourceMappingURL=crypto.utility.d.ts.map

package/dist/esm/utilities/crypto.utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.utility.d.ts","sourceRoot":"","sources":["../../../src/utilities/crypto.utility.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,aAAa,CAAC;AAE5B,eAAO,MAAM,IAAI,GACf,MAAM,MAAM,EACZ,SAAS;IACP,SAAS,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,CAAC,CAAC,oBAAoB,CAAC;CACpC,KACA,MAkBF,CAAC"}

package/dist/esm/utilities/crypto.utility.js

@@ -0,0 +1,19 @@
+import C from 'node:crypto';
+export const hash = (text, options) => {
+    const { algorithm, secret, outputType } = options;
+    switch (algorithm) {
+        case 'SHA256': {
+            if (!secret) {
+                return text;
+            }
+            return C.createHmac(algorithm, secret).update(text).digest(outputType);
+        }
+        case 'MD5': {
+            return C.createHash(algorithm).update(text).digest(outputType);
+        }
+        default: {
+            return text;
+        }
+    }
+};
+//# sourceMappingURL=crypto.utility.js.map