npm - @venizia/ignis-helpers - Versions diffs - 0.0.9-0 → 0.1.0 - Mend

@venizia/ignis-helpers 0.0.9-0 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (260) hide show

package/dist/modules/network/tcp-socket/base-tcp-server.helper.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
-import { BaseHelper } from '../../../modules/base';
 import { ValueOrPromise } from '../../../common/types';
+import { BaseHelper } from '../../../modules/base';
 import { dayjs } from '../../../utilities/date.utility';
 import { ListenOptions, ServerOpts, Socket as SocketClient, Server as SocketServer } from 'node:net';
 export interface ITcpSocketClient<SocketClientType> {
@@ -10,6 +10,7 @@ export interface ITcpSocketClient<SocketClientType> {
     storage: {
         connectedAt: dayjs.Dayjs;
         authenticatedAt: dayjs.Dayjs | null;
+        authenticateTimeout?: ReturnType<typeof setTimeout> | null;
         [additionField: symbol | string]: any;
     };
 }
@@ -49,6 +50,10 @@ export interface ITcpSocketServerOptions<SocketServerOptions extends ServerOpts
         socket: SocketClientType;
         error: Error;
     }) => void;
+    onServerError?: (opts: {
+        server: SocketServerType;
+        error: Error;
+    }) => void;
 }
 export declare class BaseNetworkTcpServer<SocketServerOptions extends ServerOpts = ServerOpts, SocketServerType extends SocketServer = SocketServer, SocketClientType extends SocketClient = SocketClient> extends BaseHelper {
     protected serverOptions: Partial<SocketServerOptions>;
@@ -86,7 +91,15 @@ export declare class BaseNetworkTcpServer<SocketServerOptions extends ServerOpts
         socket: SocketClientType;
         error: Error;
     }) => void;
+    protected onServerError?: (opts: {
+        server: SocketServerType;
+        error: Error;
+    }) => void;
     constructor(opts: ITcpSocketServerOptions<SocketServerOptions, SocketServerType, SocketClientType>);
+    protected invokeHook(opts: {
+        scope: string;
+        execution: () => void;
+    }): void;
     configure(): void;
     onNewConnection(opts: {
         socket: SocketClientType;
@@ -96,6 +109,16 @@ export declare class BaseNetworkTcpServer<SocketServerOptions extends ServerOpts
         id: string;
     }): ITcpSocketClient<SocketClientType>;
     getServer(): SocketServerType;
+    /**
+     * Tears the server down completely: pending authenticate timers cleared, every client socket
+     * destroyed, the registry emptied, then the listener closed.
+     *
+     * The order is what makes this necessary at all - `server.close()` stops accepting NEW
+     * connections but never settles while an existing socket is still attached, so a caller reaching
+     * through `getServer().close()` hangs forever on a busy server. Idempotent, and safe on a server
+     * that never listened.
+     */
+    shutdown(): Promise<void>;
     doAuthenticate(opts: {
         id: string;
         state: 'unauthorized' | 'authenticating' | 'authenticated';

package/dist/modules/network/tcp-socket/base-tcp-server.helper.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"base-tcp-server.helper.d.ts","sourceRoot":"","sources":["../../../../src/modules/network/tcp-socket/base-tcp-server.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,~~UAAU~~,EAAE,MAAM,gBAAgB,CAAC;~~AAC5C~~,OAAO,EAAE,~~cAAc~~,EAAE,MAAM,gBAAgB,CAAC;~~AAEhD~~,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;~~AAGjD~~,OAAO,EACL,aAAa,EACb,UAAU,EACV,MAAM,IAAI,YAAY,EACtB,MAAM,IAAI,YAAY,EACvB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,gBAAgB,CAAC,gBAAgB;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,cAAc,GAAG,gBAAgB,GAAG,eAAe,CAAC;IAC3D,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,OAAO,EAAE;QACP,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC;QACzB,eAAe,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;QACpC,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;KACvC,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB,CACtC,mBAAmB,SAAS,UAAU,GAAG,UAAU,EACnD,gBAAgB,SAAS,YAAY,GAAG,YAAY,EACpD,gBAAgB,SAAS,YAAY,GAAG,YAAY;IAEpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IAEnB,aAAa,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5C,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACtC,mBAAmB,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAE9D,WAAW,CAAC,EAAE,MAAM,CAClB,MAAM,EACN,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,KAAK,cAAc,CAAC,IAAI,CAAC,CACpF,CAAC;IAEF,cAAc,EAAE,CACd,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,EACrC,kBAAkB,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,KACnD,gBAAgB,CAAC;IAEtB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,gBAAgB,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7D,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/F,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAA;KAAE,KAAK,IAAI,CAAC;IACzE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,KAAK,IAAI,CAAC;~~CACxF~~;AAED,qBAAa,oBAAoB,CAC/B,mBAAmB,SAAS,UAAU,GAAG,UAAU,EACnD,gBAAgB,SAAS,YAAY,GAAG,YAAY,EACpD,gBAAgB,SAAS,YAAY,GAAG,YAAY,CACpD,SAAQ,UAAU;IAClB,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAM;IAC3D,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC,CAAM;IACrD,SAAS,CAAC,mBAAmB,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAExE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACtE,SAAS,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAEnC,SAAS,CAAC,WAAW,EAAE,MAAM,CAC3B,MAAM,EACN,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,KAAK,cAAc,CAAC,IAAI,CAAC,CACpF,CAAC;IAEF,SAAS,CAAC,cAAc,EAAE,CACxB,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,EACrC,kBAAkB,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,KACnD,gBAAgB,CAAC;IAEtB,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,gBAAgB,CAAA;KAAE,KAAK,IAAI,CAAC;IACvE,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAA;KAAE,KAAK,IAAI,CAAC;IACvF,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAC9B,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,gBAAgB,CAAC;QACzB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;KACvB,KAAK,IAAI,CAAC;IACX,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAA;KAAE,KAAK,IAAI,CAAC;IACnF,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,KAAK,IAAI,CAAC;~~gBAG/F~~,IAAI,EAAE,uBAAuB,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,CAAC;~~IAmCxF~~,SAAS;~~IAcT~~,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,gBAAgB,CAAA;KAAE;~~IA0ElD~~,UAAU;IAIV,SAAS,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE;IAI9B,SAAS;IAIT,cAAc,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB,GAAG,eAAe,CAAA;KAAE;~~IA2B~~/F,IAAI,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE;CA4B1D"}
1	+ {"version":3,"file":"base-tcp-server.helper.d.ts","sourceRoot":"","sources":["../../../../src/modules/network/tcp-socket/base-tcp-server.helper.ts"],"names":[],"mappings":"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"}

package/dist/modules/network/tcp-socket/base-tcp-server.helper.js CHANGED Viewed

@@ -8,6 +8,7 @@ const base_1 = require("../../../modules/base");
 const error_1 = require("../../../modules/error");
 const date_utility_1 = require("../../../utilities/date.utility");
 const parse_utility_1 = require("../../../utilities/parse.utility");
+const promise_utility_1 = require("../../../utilities/promise.utility");
 const omit_1 = __importDefault(require("lodash/omit"));
 class BaseNetworkTcpServer extends base_1.BaseHelper {
     constructor(opts) {
@@ -33,40 +34,96 @@ class BaseNetworkTcpServer extends base_1.BaseHelper {
         this.onClientConnected = opts.onClientConnected;
         this.onClientData = opts.onClientData;
         this.onClientClose = opts.onClientClose;
+        this.onClientError = opts.onClientError;
+        this.onServerError = opts.onServerError;
         this.configure();
     }
+    // Hooks run inside socket event listeners: a synchronous throw there is an uncaught exception
+    // that kills the process and skips the client-registry cleanup that follows it.
+    invokeHook(opts) {
+        const { scope, execution } = opts;
+        try {
+            execution();
+        }
+        catch (error) {
+            this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);
+        }
+    }
     configure() {
         this.server = this.createServerFn(this.serverOptions, socket => {
             this.onNewConnection({ socket });
         });
+        // Without this listener a failed listen - a port already in use is the commonest boot failure
+        // there is - emits an unhandled 'error' event, which takes the whole process down with it.
+        this.server.on('error', (error) => {
+            this.logger
+                .for(this.configure.name)
+                .error('TCP Socket Server error | Options: %j | Error: %s', this.listenOptions, error);
+            this.invokeHook({
+                scope: this.configure.name,
+                execution: () => {
+                    this.onServerError?.({ server: this.server, error });
+                },
+            });
+        });
         this.server.listen(this.listenOptions, () => {
             this.logger
                 .for(this.configure.name)
                 .info('TCP Socket Server is now listening | Options: %j', this.listenOptions);
-            this.onServerReady?.({ server: this.server });
+            this.invokeHook({
+                scope: this.configure.name,
+                execution: () => {
+                    this.onServerReady?.({ server: this.server });
+                },
+            });
         });
     }
     onNewConnection(opts) {
         const { socket } = opts;
         const id = (0, parse_utility_1.getUID)();
         socket.on('data', (data) => {
-            this.onClientData?.({ id, socket, data });
+            this.invokeHook({
+                scope: 'onClientData',
+                execution: () => {
+                    this.onClientData?.({ id, socket, data });
+                },
+            });
         });
         socket.on('error', (error) => {
             this.logger.for('onClientConnect').error('Socket Error | ID: %s | Error: %s', id, error);
-            this.onClientError?.({ id, socket, error });
+            this.invokeHook({
+                scope: 'onClientError',
+                execution: () => {
+                    this.onClientError?.({ id, socket, error });
+                },
+            });
             socket.end();
         });
         socket.on('close', (hasError) => {
             this.logger
                 .for('onClientConnect')
                 .info('Socket Closed | ID: %s | hasError: %s', id, hasError);
-            this.onClientClose?.({ id, socket });
+            this.invokeHook({
+                scope: 'onClientClose',
+                execution: () => {
+                    this.onClientClose?.({ id, socket });
+                },
+            });
+            const authenticateTimeout = this.getClient({ id })?.storage?.authenticateTimeout;
+            if (authenticateTimeout) {
+                clearTimeout(authenticateTimeout);
+            }
             this.clients = (0, omit_1.default)(this.clients, [id]);
         });
         for (const extraEvent in this.extraEvents) {
             socket.on(extraEvent, args => {
-                this.extraEvents[extraEvent]({ id, socket, args });
+                (0, promise_utility_1.voidExecution)({
+                    logger: this.logger,
+                    scope: 'onClientConnect',
+                    // The async wrapper turns a SYNCHRONOUS throw from the handler into a rejection;
+                    // calling it bare would throw out of this listener as an uncaught exception.
+                    execution: (async () => this.extraEvents[extraEvent]({ id, socket, args }))(),
+                });
             });
         }
         this.clients[id] = {
@@ -82,21 +139,33 @@ class BaseNetworkTcpServer extends base_1.BaseHelper {
         this.logger
             .for('onClientConnect')
             .info('New TCP SocketClient | Client: %s | authenticateOptions: %s %s', `${id} - ${socket.remoteAddress} - ${socket.remotePort} - ${socket.remoteFamily}`, this.authenticateOptions.required, this.authenticateOptions.duration);
-        this.onClientConnected?.({ id, socket });
+        this.invokeHook({
+            scope: 'onClientConnected',
+            execution: () => {
+                this.onClientConnected?.({ id, socket });
+            },
+        });
         if (this.authenticateOptions.required &&
             this.authenticateOptions.duration &&
             this.authenticateOptions.duration > 0) {
-            setTimeout(() => {
+            const authenticateTimeout = setTimeout(() => {
                 const client = this.getClient({ id });
                 if (!client) {
                     return;
                 }
+                client.storage.authenticateTimeout = null;
                 if (client.state === 'authenticated') {
                     return;
                 }
                 this.emit({ clientId: id, payload: 'Unauthorized Client' });
                 client.socket.end();
             }, this.authenticateOptions.duration);
+            const client = this.getClient({ id });
+            if (!client) {
+                clearTimeout(authenticateTimeout);
+                return;
+            }
+            client.storage.authenticateTimeout = authenticateTimeout;
         }
     }
     getClients() {
@@ -108,6 +177,43 @@ class BaseNetworkTcpServer extends base_1.BaseHelper {
     getServer() {
         return this.server;
     }
+    /**
+     * Tears the server down completely: pending authenticate timers cleared, every client socket
+     * destroyed, the registry emptied, then the listener closed.
+     *
+     * The order is what makes this necessary at all - `server.close()` stops accepting NEW
+     * connections but never settles while an existing socket is still attached, so a caller reaching
+     * through `getServer().close()` hangs forever on a busy server. Idempotent, and safe on a server
+     * that never listened.
+     */
+    async shutdown() {
+        for (const client of Object.values(this.clients)) {
+            const { authenticateTimeout } = client.storage;
+            if (authenticateTimeout) {
+                clearTimeout(authenticateTimeout);
+                client.storage.authenticateTimeout = null;
+            }
+            client.socket.destroy();
+        }
+        this.clients = {};
+        const server = this.server;
+        if (!server) {
+            return;
+        }
+        // NOT guarded on `listening`: listen() is asynchronous (a hostname needs a DNS lookup), so a
+        // shutdown() racing startup would see listening === false, close nothing, and let the server
+        // bind its port a moment later - keeping the process alive forever. close() on a server that
+        // never listened simply reports ERR_SERVER_NOT_RUNNING, which is logged below.
+        await new Promise(resolve => {
+            server.close(error => {
+                if (error) {
+                    this.logger.for(this.shutdown.name).error('Failed to close server | Error: %s', error);
+                }
+                resolve();
+            });
+        });
+        this.logger.for(this.shutdown.name).info('Server closed | Identifier: %s', this.identifier);
+    }
     doAuthenticate(opts) {
         const { id, state } = opts;
         const client = this.getClient({ id });
@@ -124,6 +230,10 @@ class BaseNetworkTcpServer extends base_1.BaseHelper {
             }
             case 'authenticated': {
                 client.storage.authenticatedAt = (0, date_utility_1.dayjs)();
+                if (client.storage.authenticateTimeout) {
+                    clearTimeout(client.storage.authenticateTimeout);
+                    client.storage.authenticateTimeout = null;
+                }
                 break;
             }
             default: {

package/dist/modules/network/tcp-socket/base-tcp-server.helper.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"base-tcp-server.helper.js","sourceRoot":"","sources":["../../../../src/modules/network/tcp-socket/base-tcp-server.helper.ts"],"names":[],"mappings":";;;;;;~~AAAA~~,yCAA4C;~~AAE5C~~,2CAA2C;AAC3C,2DAAiD;AACjD,6DAAmD;AACnD,uDAA+B;~~AAiD~~/B,MAAa,oBAIX,SAAQ,iBAAU;~~IA4BlB~~,YACE,IAAsF;QAEtF,KAAK,CAAC;YACJ,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,UAAU,IAAI,oBAAoB,CAAC,IAAI;YACjE,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;~~QAjCK~~,kBAAa,GAAiC,EAAE,CAAC;QACjD,kBAAa,GAA2B,EAAE,CAAC;~~QAkCnD~~,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAEjC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,CAAC;QAEpD,IACE,IAAI,CAAC,mBAAmB,CAAC,QAAQ;YACjC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,IAAI,IAAI,CAAC,mBAAmB,CAAC,QAAQ,GAAG,CAAC,CAAC,EAC7E,CAAC;YACD,MAAM,IAAA,gBAAQ,EAAC;gBACb,OAAO,EACL,wFAAwF;aAC3F,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QAE1C,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAE1C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAChD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QACtC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QAExC,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAED,SAAS;QACP,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,EAAE;YAC7D,IAAI,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,EAAE;YAC1C,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;iBACxB,IAAI,CAAC,kDAAkD,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAEhF,IAAI,CAAC,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;~~QAChD~~,CAAC,CAAC,CAAC;IACL,CAAC;IAED,eAAe,CAAC,IAAkC;QAChD,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAExB,MAAM,EAAE,GAAG,IAAA,sBAAM,GAAE,CAAC;QAEpB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAqB,EAAE,EAAE;YAC1C,IAAI,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;~~QAC5C~~,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;YAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,mCAAmC,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;YAEzF,IAAI,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;~~YAC5C~~,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,QAAiB,EAAE,EAAE;YACvC,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,iBAAiB,CAAC;iBACtB,IAAI,CAAC,uCAAuC,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;YAE/D,IAAI,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;~~YACrC~~,IAAI,CAAC,OAAO,GAAG,IAAA,cAAI,EAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE;gBAC3B,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;~~YACrD~~,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG;YACjB,EAAE;YACF,MAAM;YACN,KAAK,EAAE,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,eAAe;YAC3E,aAAa,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE;gBACP,WAAW,EAAE,IAAA,oBAAK,GAAE;gBACpB,eAAe,EAAE,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAA,oBAAK,GAAE;aACpE;SACF,CAAC;QAEF,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,iBAAiB,CAAC;aACtB,IAAI,CACH,gEAAgE,EAChE,GAAG,EAAE,MAAM,MAAM,CAAC,aAAa,MAAM,MAAM,CAAC,UAAU,MAAM,MAAM,CAAC,YAAY,EAAE,EACjF,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EACjC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAClC,CAAC;QAEJ,IAAI,CAAC,iBAAiB,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;~~QAEzC~~,IACE,IAAI,CAAC,mBAAmB,CAAC,QAAQ;YACjC,IAAI,CAAC,mBAAmB,CAAC,QAAQ;YACjC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,GAAG,CAAC,EACrC,CAAC;YACD,UAAU,CAAC,GAAG,EAAE;~~gBACd~~,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBACtC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO;gBACT,CAAC;gBAED,IAAI,MAAM,CAAC,KAAK,KAAK,eAAe,EAAE,CAAC;oBACrC,OAAO;gBACT,CAAC;gBAED,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;gBAC5D,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YACtB,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;~~QACxC~~,CAAC;IACH,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,SAAS,CAAC,IAAoB;QAC5B,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,cAAc,CAAC,IAAgF;QAC7F,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAE3B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;YAC7E,OAAO;QACT,CAAC;QAED,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QAErB,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,cAAc,CAAC;YACpB,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACtB,MAAM,CAAC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;gBACtC,MAAM;YACR,CAAC;YACD,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,MAAM,CAAC,OAAO,CAAC,eAAe,GAAG,IAAA,oBAAK,GAAE,CAAC;~~gBACzC~~,MAAM;YACR,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAoD;QACvD,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEhD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;YAC7E,OAAO;QACT,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,8BAA8B,EAAE,QAAQ,CAAC,CAAC;YAChF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;iBACnB,IAAI,CACH,0DAA0D,EAC1D,IAAI,CAAC,UAAU,EACf,QAAQ,CACT,CAAC;YACJ,OAAO;QACT,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;CACF;AA/ND,oDA+NC"}
1	+ {"version":3,"file":"base-tcp-server.helper.js","sourceRoot":"","sources":["../../../../src/modules/network/tcp-socket/base-tcp-server.helper.ts"],"names":[],"mappings":"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"}

package/dist/modules/network/tcp-socket/network-tls-tcp-server.helper.d.ts CHANGED Viewed

@@ -1,7 +1,9 @@
 import { Server, TLSSocket as SocketClient, TlsOptions } from 'node:tls';
 import { BaseNetworkTcpServer, ITcpSocketServerOptions } from './base-tcp-server.helper';
+type TTlsTcpServerOptions = Omit<ITcpSocketServerOptions<TlsOptions, Server, SocketClient>, 'createServerFn'>;
 export declare class NetworkTlsTcpServer extends BaseNetworkTcpServer<TlsOptions, Server, SocketClient> {
-    constructor(opts: Omit<ITcpSocketServerOptions, 'createServerFn'>);
-    static newInstance(opts: Omit<ITcpSocketServerOptions, 'createServerFn'>): NetworkTlsTcpServer;
+    constructor(opts: TTlsTcpServerOptions);
+    static newInstance(opts: TTlsTcpServerOptions): NetworkTlsTcpServer;
 }
+export {};
 //# sourceMappingURL=network-tls-tcp-server.helper.d.ts.map

package/dist/modules/network/tcp-socket/network-tls-tcp-server.helper.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"network-tls-tcp-server.helper.d.ts","sourceRoot":"","sources":["../../../../src/modules/network/tcp-socket/network-tls-tcp-server.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,SAAS,IAAI,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEzF,~~qBAAa~~,~~mBAAoB~~,~~SAAQ~~,~~oBAAoB~~,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC~~;gBACjF~~,~~IAAI~~,~~EAAE~~,~~IAAI~~,CAAC,~~uBAAuB~~,~~EAAE~~,~~gBAAgB~~,CAAC~~;IAQjE~~,MAAM,~~CAAC~~,~~WAAW~~,CAAC,IAAI,EAAE,~~IAAI~~,CAAC,~~uBAAuB~~,EAAE,~~gBAAgB,CAAC~~;~~CAGzE~~"}
1	+ {"version":3,"file":"network-tls-tcp-server.helper.d.ts","sourceRoot":"","sources":["../../../../src/modules/network/tcp-socket/network-tls-tcp-server.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,SAAS,IAAI,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEzF,KAAK,oBAAoB,GAAG,IAAI,CAC9B,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EACzD,gBAAgB,CACjB,CAAC;AAEF,qBAAa,mBAAoB,SAAQ,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC;gBACjF,IAAI,EAAE,oBAAoB;IAQtC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,oBAAoB;CAG9C"}

package/dist/modules/network/tcp-socket/network-tls-tcp-server.helper.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"network-tls-tcp-server.helper.js","sourceRoot":"","sources":["../../../../src/modules/network/tcp-socket/network-tls-tcp-server.helper.ts"],"names":[],"mappings":";;;AAAA,uCAAuF;AACvF,qEAAyF;~~AAEzF~~,MAAa,mBAAoB,SAAQ,6CAAsD;IAC7F,YAAY,~~IAAqD~~;~~QAC/D~~,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,mBAAmB,CAAC,IAAI;YAC/B,cAAc,EAAE,uBAAY;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,~~IAAqD~~;~~QACtE~~,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;CACF;AAZD,kDAYC"}
1	+ {"version":3,"file":"network-tls-tcp-server.helper.js","sourceRoot":"","sources":["../../../../src/modules/network/tcp-socket/network-tls-tcp-server.helper.ts"],"names":[],"mappings":";;;AAAA,uCAAuF;AACvF,qEAAyF;AAOzF,MAAa,mBAAoB,SAAQ,6CAAsD;IAC7F,YAAY,IAA0B;QACpC,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,mBAAmB,CAAC,IAAI;YAC/B,cAAc,EAAE,uBAAY;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAA0B;QAC3C,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;CACF;AAZD,kDAYC"}

package/dist/modules/network/udp-socket/network-udp-client.helper.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
-import { BaseHelper } from '../../../modules/base';
 import { ValueOrPromise } from '../../../common';
+import { BaseHelper } from '../../../modules/base';
 import dgram from 'node:dgram';
 interface INetworkUdpClientProps {
     identifier: string;
@@ -69,6 +69,7 @@ export declare class NetworkUdpClient extends BaseHelper {
         error: Error;
     }): void;
     connect(): void;
+    private invokeHook;
     disconnect(): void;
     isConnected(): dgram.Socket | null | undefined;
 }

package/dist/modules/network/udp-socket/network-udp-client.helper.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"network-udp-client.helper.d.ts","sourceRoot":"","sources":["../../../../src/modules/network/udp-socket/network-udp-client.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,~~UAAU~~,EAAE,MAAM,~~gBAAgB~~,CAAC;~~AAC5C~~,OAAO,EAAE,~~cAAc~~,EAAE,MAAM,~~UAAU~~,CAAC;~~AAC1C~~,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B,UAAU,sBAAsB;IAC9B,UAAU,EAAE,MAAM,CAAC;IAEnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,gBAAgB,CAAC,EAAE;QACjB,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAClF,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;QACzB,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC;KAC9B,KAAK,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/E,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,KAAK,IAAI,CAAC;IAC5F,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,gBAAgB,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACnE,KAAK,cAAc,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,SAAS,CAAC,CAAU;IAE5B,OAAO,CAAC,gBAAgB,CAAC,CAGvB;IAEF,OAAO,CAAC,WAAW,CAAsE;IACzF,OAAO,CAAC,MAAM,CAIH;IACX,OAAO,CAAC,QAAQ,CAAC,CAAsE;IACvF,OAAO,CAAC,OAAO,CAAC,CAKL;IACX,OAAO,CAAC,MAAM,CAAC,CAOY;IAE3B,OAAO,CAAC,MAAM,CAAC,CAAsB;gBAEzB,IAAI,EAAE,sBAAsB;IAexC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,sBAAsB;IAI/C,SAAS;IAIT,eAAe;IAUf,UAAU,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAA;KAAE;IAS/F,YAAY;IAUZ,WAAW,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE;IAYtD,OAAO;~~IAsDP~~,UAAU;IAcV,WAAW;CAGZ"}
1	+ {"version":3,"file":"network-udp-client.helper.d.ts","sourceRoot":"","sources":["../../../../src/modules/network/udp-socket/network-udp-client.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B,UAAU,sBAAsB;IAC9B,UAAU,EAAE,MAAM,CAAC;IAEnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,gBAAgB,CAAC,EAAE;QACjB,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAClF,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;QACzB,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC;KAC9B,KAAK,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/E,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,KAAK,IAAI,CAAC;IAC5F,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,gBAAgB,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACnE,KAAK,cAAc,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,SAAS,CAAC,CAAU;IAE5B,OAAO,CAAC,gBAAgB,CAAC,CAGvB;IAEF,OAAO,CAAC,WAAW,CAAsE;IACzF,OAAO,CAAC,MAAM,CAIH;IACX,OAAO,CAAC,QAAQ,CAAC,CAAsE;IACvF,OAAO,CAAC,OAAO,CAAC,CAKL;IACX,OAAO,CAAC,MAAM,CAAC,CAOY;IAE3B,OAAO,CAAC,MAAM,CAAC,CAAsB;gBAEzB,IAAI,EAAE,sBAAsB;IAexC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,sBAAsB;IAI/C,SAAS;IAIT,eAAe;IAUf,UAAU,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAA;KAAE;IAS/F,YAAY;IAUZ,WAAW,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE;IAYtD,OAAO;IAuFP,OAAO,CAAC,UAAU;IAUlB,UAAU;IAcV,WAAW;CAGZ"}

package/dist/modules/network/udp-socket/network-udp-client.helper.js CHANGED Viewed

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NetworkUdpClient = void 0;
 const base_1 = require("../../../modules/base");
+const promise_utility_1 = require("../../../utilities/promise.utility");
 const node_dgram_1 = __importDefault(require("node:dgram"));
 class NetworkUdpClient extends base_1.BaseHelper {
     constructor(opts) {
@@ -64,10 +65,11 @@ class NetworkUdpClient extends base_1.BaseHelper {
                 .info('[%s] UdpClient is already initialized!', this.identifier);
             return;
         }
-        if (!this.port) {
+        // Port 0 is a VALID request for an OS assigned port - only a missing / negative port is invalid.
+        if (!Number.isInteger(this.port) || this.port < 0) {
             this.logger
                 .for(this.connect.name)
-                .info('[%s] Cannot init UDP Client with null options', this.identifier);
+                .info('[%s] Cannot init UDP Client with invalid port | Port: %s', this.identifier, this.port);
             return;
         }
         this.logger
@@ -75,28 +77,64 @@ class NetworkUdpClient extends base_1.BaseHelper {
             .info('[%s] New network udp client | Host: %s | Port: %s | multicastAddress: %j', this.identifier, this.host, this.port, this.multicastAddress);
         this.client = node_dgram_1.default.createSocket({ type: 'udp4', reuseAddr: this.reuseAddr });
         this.client.on('close', () => {
-            this.onClosed?.({ identifier: this.identifier, host: this.host, port: this.port });
+            this.invokeHook({
+                scope: this.handleClosed.name,
+                execution: () => {
+                    this.onClosed?.({ identifier: this.identifier, host: this.host, port: this.port });
+                },
+            });
         });
         this.client.on('error', error => {
-            this.onError?.({ identifier: this.identifier, host: this.host, port: this.port, error });
+            this.invokeHook({
+                scope: this.handleError.name,
+                execution: () => {
+                    this.onError?.({ identifier: this.identifier, host: this.host, port: this.port, error });
+                },
+            });
         });
         this.client.on('listening', () => {
-            this.onConnected?.({ identifier: this.identifier, host: this.host, port: this.port });
+            this.invokeHook({
+                scope: this.handleConnected.name,
+                execution: () => {
+                    this.onConnected?.({ identifier: this.identifier, host: this.host, port: this.port });
+                },
+            });
         });
         this.client.on('message', (message, remoteInfo) => {
-            this.onData?.({ identifier: this.identifier, message, remoteInfo });
+            this.invokeHook({
+                scope: this.handleData.name,
+                execution: () => {
+                    this.onData?.({ identifier: this.identifier, message, remoteInfo });
+                },
+            });
         });
         this.client.bind({ port: this.port, address: this.host }, () => {
-            this.onBind?.({
-                identifier: this.identifier,
-                socket: this.client,
-                host: this.host,
-                port: this.port,
-                reuseAddr: this.reuseAddr,
-                multicastAddress: this.multicastAddress,
+            (0, promise_utility_1.voidExecution)({
+                logger: this.logger,
+                scope: 'bind',
+                // The async wrapper turns a SYNCHRONOUS throw from onBind into a rejection; calling it bare
+                // would throw out of the dgram listening listener as an uncaught exception.
+                execution: (async () => this.onBind?.({
+                    identifier: this.identifier,
+                    socket: this.client,
+                    host: this.host,
+                    port: this.port,
+                    reuseAddr: this.reuseAddr,
+                    multicastAddress: this.multicastAddress,
+                }))(),
             });
         });
     }
+    // Hooks run inside dgram event listeners: a synchronous throw there is an uncaught exception.
+    invokeHook(opts) {
+        const { scope, execution } = opts;
+        try {
+            execution();
+        }
+        catch (error) {
+            this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);
+        }
+    }
     disconnect() {
         if (!this.client) {
             this.logger

package/dist/modules/network/udp-socket/network-udp-client.helper.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"network-udp-client.helper.js","sourceRoot":"","sources":["../../../../src/modules/network/udp-socket/network-udp-client.helper.ts"],"names":[],"mappings":";;;;;;~~AAAA~~,yCAA4C;~~AAE5C~~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~~YACf~~,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;iBACtB,IAAI,~~CAAC,+CAA+C~~,~~EAAE~~,IAAI,CAAC,UAAU,CAAC,CAAC;~~YAC1E~~,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;aACtB,IAAI,CACH,0EAA0E,EAC1E,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,gBAAgB,CACtB,CAAC;QAEJ,IAAI,CAAC,MAAM,GAAG,oBAAK,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAC3B,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;~~QACrF~~,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE;YAC9B,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;~~QAC3F~~,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;YAC/B,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;~~QACxF~~,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAwB,EAAE,UAA4B,EAAE,EAAE;YACnF,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;~~QACtE~~,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE;YAC7D,IAAI,CAAC,MAAM,EAAE,CAAC;~~gBACZ~~,UAAU,EAAE,IAAI,CAAC,UAAU;~~gBAC3B~~,MAAM,EAAE,IAAI,CAAC,MAAO;~~gBACpB~~,IAAI,EAAE,IAAI,CAAC,IAAI;~~gBACf~~,IAAI,EAAE,IAAI,CAAC,IAAI;~~gBACf~~,SAAS,EAAE,IAAI,CAAC,SAAS;~~gBACzB~~,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;~~aACxC~~,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,UAAU;QACR,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;iBACzB,IAAI,CAAC,wCAAwC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QAErB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kCAAkC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAClG,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;~~AAzKD~~,~~4CAyKC~~"}
1	+ {"version":3,"file":"network-udp-client.helper.js","sourceRoot":"","sources":["../../../../src/modules/network/udp-socket/network-udp-client.helper.ts"],"names":[],"mappings":"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"}

package/dist/modules/pool/{helper.d.ts → abstract.d.ts} RENAMED Viewed

@@ -1,6 +1,6 @@
 import { ValueOrPromise } from '../../common/types';
 import { BaseHelper } from '../../modules/base';
-import { IPool, IPoolControlOptions, IPoolOptions, IPoolStats } from './types';
+import { IPool, IPoolControlOptions, IPoolStats } from './types';
 /**
  * Generic single-borrower object pool — skeleton.
  *
@@ -48,7 +48,7 @@ export declare abstract class AbstractPoolHelper<T> extends BaseHelper implement
     }): void;
     warmup(): Promise<void>;
     use<R>(opts: {
-        fn: (resource: T) => ValueOrPromise<R>;
+        execution: (resource: T) => ValueOrPromise<R>;
     }): Promise<R>;
     discard(opts: {
         resource: T;
@@ -77,24 +77,4 @@ export declare abstract class AbstractPoolHelper<T> extends BaseHelper implement
     private takeNextWaiter;
     private clearWaiterTimer;
 }
-/**
- * Concrete object pool configured by callbacks ({@link IPoolOptions}). Implements the
- * AbstractPoolHelper lifecycle hooks by delegating to `create`/`validate`/`reset`/`destroy`.
- *
- * Each borrow is exclusive until released; `use()` is leak-safe (destroys the resource on error).
- */
-export declare class BasePoolHelper<T> extends AbstractPoolHelper<T> {
-    private readonly factory;
-    constructor(options: IPoolOptions<T>);
-    protected create(): ValueOrPromise<T>;
-    protected validateResource(opts: {
-        resource: T;
-    }): ValueOrPromise<boolean>;
-    protected resetResource(opts: {
-        resource: T;
-    }): ValueOrPromise<void>;
-    protected onDestroyResource(opts: {
-        resource: T;
-    }): ValueOrPromise<void>;
-}
-//# sourceMappingURL=helper.d.ts.map
+//# sourceMappingURL=abstract.d.ts.map

package/dist/modules/pool/abstract.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../src/modules/pool/abstract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAe,MAAM,SAAS,CAAC;AAE9E;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,kBAAkB,CAAC,CAAC,CAAE,SAAQ,UAAW,YAAW,KAAK,CAAC,CAAC,CAAC;IAChF,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC7C,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IAEnE,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAS;gBAEhB,IAAI,EAAE,mBAAmB;IASrC,qCAAqC;IACrC,SAAS,CAAC,QAAQ,CAAC,MAAM,IAAI,cAAc,CAAC,CAAC,CAAC;IAE9C,2GAA2G;IAC3G,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,CAAC,CAAA;KAAE,GAAG,cAAc,CAAC,OAAO,CAAC;IAI3E,6GAA6G;IAC7G,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,CAAC,CAAA;KAAE,GAAG,cAAc,CAAC,IAAI,CAAC;IAIrE,wEAAwE;IACxE,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,CAAC,CAAA;KAAE,GAAG,cAAc,CAAC,IAAI,CAAC;IAMzE,QAAQ,IAAI,UAAU;IAShB,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC;IAuC3B,OAAO,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,CAAC,CAAA;KAAE,GAAG,IAAI;IAqB9B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBvB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE;QAAE,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAgB3E,OAAO,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAgBhB,cAAc;YAed,eAAe;IAY7B,yFAAyF;IACzF,OAAO,CAAC,YAAY;IAQpB;;;;OAIG;YACW,QAAQ;IAsCtB,8GAA8G;YAChG,gBAAgB;IA+B9B,qGAAqG;YACvF,aAAa;IAY3B;;;OAGG;IACH,OAAO,CAAC,YAAY;IA0BpB,sGAAsG;IACtG,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,gBAAgB;CAOzB"}