@nsshunt/stssocketioutils 2.0.39 → 2.0.40

package/dist/index.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_tiny_emitter$1 = require("./tiny-emitter-BqSsRcpg.cjs");
+const require_tiny_emitter$1 = require("./tiny-emitter-CjKjGEhV.cjs");
 let socket_io_client = require("socket.io-client");
+let _nsshunt_stsutils = require("@nsshunt/stsutils");
 //#region src/commonTypes.ts
 var STSNamespace = /* @__PURE__ */ function(STSNamespace) {
 	STSNamespace["STSMonitor"] = "stsinstrumentmanager/stsmonitor";
@@ -33,13 +34,7 @@ var STSEvent = /* @__PURE__ */ function(STSEvent) {
 	return STSEvent;
 }({});
 //#endregion
-//#region node_modules/detect-node/browser.js
-var require_browser = /* @__PURE__ */ require_tiny_emitter$1.__commonJSMin(((exports, module) => {
-	module.exports = false;
-}));
-//#endregion
 //#region src/socketIoClient.ts
-var import_browser = /* @__PURE__ */ require_tiny_emitter$1.__toESM(require_browser(), 1);
 var import_tiny_emitter = require_tiny_emitter$1.require_tiny_emitter();
 var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 	#agentManager;
@@ -127,12 +122,12 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 		if (this.#socket !== void 0) {
 			if (this.#socket.connected === true) this.#socket.disconnect();
 			this.#socket = void 0;
-			if (import_browser.default) setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
+			if (_nsshunt_stsutils.isNode) setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
 			else setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
 			return;
 		}
 		let socketOptions;
-		if (import_browser.default) {
+		if (_nsshunt_stsutils.isNode) {
 			socketOptions = { transports: ["websocket"] };
 			if (this.#agentManager) {
 				if (!this.#address) throw new Error(`SocketIoClient:SetupSocket(): Error: [address not provided when using agentManager]`);
@@ -181,7 +176,7 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 					this.LogDebugMessage("The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.");
 					this.LogDebugMessage("The connection will be re-established when the server becomes available.");
 					this.#socket = void 0;
-					if (import_browser.default) {
+					if (_nsshunt_stsutils.isNode) {
 						if (this.#agentManager) this.#agentManager.ResetAgent();
 						setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
 					} else setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
@@ -197,7 +192,7 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 					this.LogDebugMessage("The connection will be re-established when the server becomes available.");
 					if (this.#socket) this.#socket.disconnect();
 					this.#socket = void 0;
-					if (import_browser.default) {
+					if (_nsshunt_stsutils.isNode) {
 						if (this.#agentManager) this.#agentManager?.ResetAgent();
 						setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
 					} else setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["#name","#logger","#reconnectTimeout","#agentManager","#address","#authToken","#socketIoCustomPath","#socket","#EstablishSocketConnect"],"sources":["../src/commonTypes.ts","../node_modules/detect-node/browser.js","../src/socketIoClient.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */  // --> OFF\nimport { Server, Socket, Namespace } from \"socket.io\";\nimport { ISTSLogger } from '@nsshunt/stsutils'\n\nexport interface STSDefaultClientToServerEvents {\n    /**\n     * Join the room(s) specified for this client.\n     * @param room The room(s) to join for this client.\n     * @returns \n     */\n\t__STSjoinRoom: (room: string[]) => void;\n\n    /**\n     * Remove this client from the specified room(s).\n     * @param room The room(s) to remove the client from within the server.\n     * @returns \n     */\n\t__STSleaveRoom: (room: string[]) => void;\n\n    /**\n     * Alerts the server that this client has flagged to disconnect. Allows server to perform clean-up if required. The server must call-back with the result of the disconnecting event.\n     * @param reason Reason for the disconnecting event.\n     * @param callback The server must call-back with the result of the disconnecting event.\n     * @returns \n     */\n\t__STSdisconnecting: (reason: string, callback: (data: string) => void) => void;\n\n    /**\n     * Alerts the server to disconnect this client.\n     * @param reason Reason for the disconnect event.\n     * @returns \n     */\n\t__STSdisconnect: (reason: string) => void; // server and client event\n\n    /**\n     * Send a payload of data to 1 or more rooms registered on the server.\n     * @param rooms Room array for broadcasting.\n     * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n     * interface that extends STSServerToClientEvents.\n     * @returns \n     */\n    __STSsendToRoom: (rooms: string[], payload: { command: string, payload: any }) => void;\n\n    /**\n     * Send a payload of data to 1 or more rooms registered on the server.\n     * @param room Single room for broadcasting.\n\t * @param timeout Number of ms to try and get responses from all clients\n     * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n     * interface that extends STSServerToClientEvents.\n\t * @param callback The callback function to be invoked once all clients have responded with their respective payloads\n     * @returns \n     */\n    __STSsendToRoomWithCallback: (room: string, timeout: number, payload: { command: string, payload: any }, callback: (data: any) => void) => void;    \n\n    /**\n     * Send a payload of data to 1 or more rooms registered on the server.\n     * @param rooms Array of rooms for broadcasting.\n\t * @param timeout Number of ms to try and get responses from all clients\n     * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n     * interface that extends STSServerToClientEvents.\n\t * @param callback The callback function to be invoked once all clients have responded with their respective payloads\n     * @returns \n     */\n    __STSsendToRoomsWithCallback: (rooms: string[], timeout: number, payload: { command: string, payload: any }, callback: (data: any) => void) => void;    \n}\n\nexport interface STSDefaultServerToClientEvents {\n    /**\n     * The server may emit an unsolicited disconnect event to flag that all clients should disconnect. Most likely becuase the server may be shutting down.\n     * @param reason Reason why the server is emitting this disconnect event.\n     * @returns \n     */\n\t__STSdisconnect: (reason: string) => void;\n}\n\nexport enum STSNamespace {\n\tSTSMonitor = 'stsinstrumentmanager/stsmonitor',\n\tSTSControl = 'stsinstrumentmanager/stscontrol',\n    STSTestingNamespace = 'ststestingnamespace/ststesting'\n}\n\nexport enum STSRoom {\n\t// STSMonitor rooms\n\tSTSInstrumentDataRoom = 'stsinstrumentdataroom', // This room is for all instrument data messages\n\tSTSInstrumentDataSubscriptionRoom = 'stsinstrumentdatasubscriptionroom', // This room is only for subscribed instrument data messages\n\n\t// STSControl rooms\n\tSTSRunnerRoom = 'stsrunnerroom',\n\tSTSNodeRunnerRoom = 'stsnoderunnerroom'\n}\n\nexport enum STSEvent {\n\t// STSInstrumentData\n\tSTSInstrumentData = 'stsinstrumentdata',\n\tSTSSubInstrumentData = 'stssubinstrumentdata', // sub-scribed instrument data. This only outputs the nodes that have been subscribed by the client(s).\n\tSTSResetInstrumentData = 'stsresetinstrumentdata',\n\n\tSTSStartLoggingInstrumentData = 'stsStartLoggingInstrumentData',\n\tSTSStopLoggingInstrumentData = 'stsStopLoggingInstrumentData',\n\n\t// STSRunner events\n\tSTSStart = 'stsstart', // Start a test run with options as payload.\n\tSTSStop = 'stsstop', // Stop test run(s).\n\tSTSPause = 'stspause', // Pause test run(s).\n\tSTSResume = 'stsresume', // Resume test run(s).\n\tSTSTerminate = 'ststerminate', // Terminate runner instances and exit applications.\n\t// This may also be uysed to force trigger self healing (i.e. auto re-start) when\n\t// running within a container orchestrator such as K8, K3 or Docker Swarm.\n\tSTSUpdateStaticConfig = 'stsupdatestaticconfig', // Update base configuration. Options as payload.\n\tSTSUpdateDynamicConfig = 'stsupdatedynamicconfig', // Update running configuration. This is used\n\t// to control the runnning behaviour of test(s) in-flight. Options as payload.\n\n\tSTSSendToRoom = 'sendToRoom',\n\n\t// Standard socket events\n\tconnect = 'connect'\n}\n\n// https://socket.io/docs/v4/typescript/\n\nexport interface InterServerEvents {\n\tping: () => void;\n}\n\nexport interface STSSocketIONamespace {\n\tnamespace: string\n\tpid: number\n\tsocketionamespace: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n}\n\nexport type STSSocketIONamespaces = Record<string, STSSocketIONamespace>;\n\nexport type STSServerSocket = Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\nexport type STSClientSocket = Socket<STSDefaultServerToClientEvents, STSDefaultClientToServerEvents, InterServerEvents>\n","module.exports = false;\n\n","import { io, SocketOptions, ManagerOptions, Socket } from 'socket.io-client'\n//import { EventNames, EventParams } from \"@socket.io/component-emitter\";\n\nimport isNode from 'detect-node';\n\nimport { ISTSLogger, IAgentManager } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes.js'\n\nimport { TinyEmitter } from 'tiny-emitter';\n\nexport abstract class SocketIoClient<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents> extends TinyEmitter {\n    #agentManager?: IAgentManager\n    #logger?: ISTSLogger\n    #name: string\n    #address?: string\n    #socketIoCustomPath?: string\n    #authToken?: string\n    #socket?: Socket<ServerToClientEvents, ClientToServerEvents>;\n    #reconnectTimeout: number = 2000; // default\n\n    constructor(name: string) {\n        super();\n        this.#name = name;\n    }\n    \n    protected get logPrefix(): string {\n        return `SocketIoClient[${this.#name}]:`;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    protected LogDebugMessage(message: any): void {\n        if (this.#logger) this.#logger.debug(`${this.logPrefix}${message}`);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    protected LogErrorMessage(message: any): void {\n        if (this.#logger) this.#logger.error(`${this.logPrefix}${message}`);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    protected LogWarningMessage(message: any): void {\n        if (this.#logger) this.#logger.warn(`${this.logPrefix}${message}`);\n    }\n\n    get name(): string {\n        return this.#name;\n    }\n\n    get reconnectTimeout(): number {\n        return this.#reconnectTimeout;\n    }\n\n    get agentManager(): IAgentManager | undefined {\n        return this.#agentManager;\n    }\n\n    get logger(): ISTSLogger | undefined {\n        return this.#logger;\n    }\n\n    get address(): string | undefined {\n        return this.#address;\n    }\n\n    get authToken(): string | undefined {\n        return this.#authToken;\n    }\n\n    get socketIoCustomPath(): string | undefined {\n        return this.#socketIoCustomPath;\n    }\n\n    get socket(): Socket<ServerToClientEvents, ClientToServerEvents> | undefined {\n        return this.#socket;\n    }\n\n    WithAddress(address: string) {\n        this.#address = address;\n        return this;\n    }\n\n    WithAuthToken(authToken: string) {\n        this.#authToken = authToken;\n        return this;\n    }\n\n    WithSocketIoCustomPath(socketIoCustomPath: string) {\n        this.#socketIoCustomPath = socketIoCustomPath;\n        return this;\n    }\n\n    WithLogger(logger: ISTSLogger) {\n        this.#logger = logger;\n        return this;\n    }\n\n    WithAgentManager(agentManager: IAgentManager) {\n        this.#agentManager = agentManager;\n        return this;\n    }\n\n    WithReconnectTimeout(reconnectTimeout: number) {\n        this.#reconnectTimeout = reconnectTimeout;\n        return this;\n    }\n\n    SetupSocket() {\n        if (!this.#address) {\n            throw new Error(`SocketIoClientHelper:SetupSocket(): Error: [address not provided]`);\n        }\n\n        this.#EstablishSocketConnect();\n\n        return this;\n    }\n\n     \n    protected abstract SocketConnect(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;\n     \n    protected abstract SetupSocketEvents(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;\n     \n    protected abstract SocketConnectError(error: Error): void;\n     \n    protected abstract SocketDisconnect(reason: string): void;\n\n    // Engine Errors / Events\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    protected EngineError(error: Error): void { };\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    protected EngineReconnectError(error: Error): void { };\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    protected EngineConnectError(error: Error): void { };\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    protected EngineReconnect(attempt: number): void { };\n\n    /*\n    emit<Ev extends EventNames<ClientToServerEvents>>(ev: Ev, ...args: EventParams<ClientToServerEvents, Ev>): Socket<ServerToClientEvents, ClientToServerEvents> {\n        if (this.#socket) {\n            return this.#socket!.emit(ev, ...args);\n        } else {\n            throw new Error('SocketIoClient:emit(): Error: [socket instance not defined.]');\n        }\n    }\n    */\n\n    #EstablishSocketConnect(): void {\n        if (this.#socket !== undefined) {\n            // We already have a socket object (may or may not be connected)\n            if (this.#socket.connected === true) {\n                this.#socket.disconnect();\n            }\n            this.#socket = undefined;\n            if (isNode) {\n                setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n            } else {\n                setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n            }\n            return;\n        }\n\n        let socketOptions: Partial<SocketOptions & ManagerOptions>;\n        if (isNode) {\n            // https://socket.io/docs/v4/client-options/#reconnection\n            // https://github.com/socketio/engine.io-client#methods\n            socketOptions = {\n                transports: [\"websocket\" ]\n            }\n            if (this.#agentManager) {\n                if (!this.#address) {\n                    throw new Error(`SocketIoClient:SetupSocket(): Error: [address not provided when using agentManager]`);\n                }\n                // eslint-disable-next-line @typescript-eslint/no-explicit-any\n                socketOptions.agent = this.#agentManager.GetAgent(this.#address) as any;\n            }\n        } else {\n            socketOptions = {\n                transports: [\"websocket\" ]\n            }\n        }\n\n        // https://socket.io/docs/v4/middlewares/\n        // Send auth token for connections\n        if (this.#authToken) {\n            socketOptions.auth = (cb) => {\n                cb({\n                    token: this.#authToken\n                });\n            }\n        }\n\n        // On Server use;\n        /*\n        io.use((socket, next) => {\n            const token = socket.handshake.auth.token;\n            // ...\n        });\n        */\n\n        if (this.#socketIoCustomPath && this.#socketIoCustomPath.localeCompare('') !== 0) {\n            socketOptions.path = this.#socketIoCustomPath;\n        }\n\n        this.#socket = io(this.#address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n        // Manager errors\n        this.#socket.io.on('error', (err: Error) => {\n            this.LogErrorMessage(`socketDetail.socket.io.on('error'): [${err}] Address: [${this.#address}]`);\n            this.EngineError(err);\n        });\n\n        this.#socket.io.on('reconnect_error', (err: Error) => {\n            this.LogErrorMessage(`socketDetail.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);\n            this.EngineReconnectError(err);\n        });\n\n        // suppress automatic console logging by not letting it bubble up\n        this.#socket.on(\"connect_error\", (err) => {\n            this.LogErrorMessage(`socketDetail.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);\n            this.EngineConnectError(err);\n        });\n\n        this.#socket.io.on('reconnect', (attempt: number) => {\n            this.LogErrorMessage(`socketDetail.socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);\n            this.EngineReconnect(attempt);\n        });\n\n        /*\n        this.#socket.on(\"connect_timeout\", () => {\n            this.#LogErrorMessage(`socketDetail.socket.on('connect_timeout') Address: [${this.#address}]`);\n        });\n        */\n\n        this.#socket.on(\"connect\", () => {\n            if (this.#socket) {\n                this.LogDebugMessage(`Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);\n\n                setTimeout(() => {\n                    this.SocketConnect(this.#socket as Socket<ServerToClientEvents, ClientToServerEvents>);\n                }, 0);\n\n                this.SetupSocketEvents(this.#socket);\n\n            } else {\n                const errorMessage: string = 'Could not get socket object from socket.io, Address: [${socketDetail.address}]';\n                this.LogErrorMessage(errorMessage);\n                this.SocketConnectError(new Error(errorMessage));\n            }\n        })\n\n        // https://socket.io/docs/v4/client-socket-instance/#disconnect\n        this.#socket.on(\"disconnect\", (reason: string) => {\n            this.LogDebugMessage('socket disconnect: ' + reason);\n            this.SocketDisconnect(reason);\n            switch (reason) {\n            case 'io server disconnect' : {\n                // The server disconnect using disconnectSockets (i.e. normal safe shutdown)\n                this.LogDebugMessage('The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n                this.LogDebugMessage('The connection will be re-established when the server becomes available.');\n                this.#socket = undefined;\n                if (isNode) {\n                    if (this.#agentManager) {\n                        this.#agentManager.ResetAgent();\n                    }\n                    setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n                }\n            }\n                break;\n            case 'io client disconnect' :\n                this.LogDebugMessage('The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n                this.LogDebugMessage('The connection will not be re-established automatically.');\n                // Do nothing\n                break;\n            case 'transport close' :\n            case 'ping timeout' :\n            case 'transport error' : {\n                this.LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);\n                this.LogDebugMessage('The connection will be re-established when the server becomes available.');\n                if (this.#socket) {\n                    this.#socket.disconnect();\n                }\n                this.#socket = undefined;\n                if (isNode) {\n                    if (this.#agentManager) {\n                        this.#agentManager?.ResetAgent();\n                    }\n                    setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n                }\n            }\n                break;\n            }\n        });\n    }\n}\n"],"x_google_ignoreList":[1],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["#name","#logger","#reconnectTimeout","#agentManager","#address","#authToken","#socketIoCustomPath","#socket","#EstablishSocketConnect"],"sources":["../src/commonTypes.ts","../src/socketIoClient.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */  // --> OFF\nimport { Server, Socket, Namespace } from \"socket.io\";\nimport { ISTSLogger } from '@nsshunt/stsutils'\n\nexport interface STSDefaultClientToServerEvents {\n    /**\n     * Join the room(s) specified for this client.\n     * @param room The room(s) to join for this client.\n     * @returns \n     */\n\t__STSjoinRoom: (room: string[]) => void;\n\n    /**\n     * Remove this client from the specified room(s).\n     * @param room The room(s) to remove the client from within the server.\n     * @returns \n     */\n\t__STSleaveRoom: (room: string[]) => void;\n\n    /**\n     * Alerts the server that this client has flagged to disconnect. Allows server to perform clean-up if required. The server must call-back with the result of the disconnecting event.\n     * @param reason Reason for the disconnecting event.\n     * @param callback The server must call-back with the result of the disconnecting event.\n     * @returns \n     */\n\t__STSdisconnecting: (reason: string, callback: (data: string) => void) => void;\n\n    /**\n     * Alerts the server to disconnect this client.\n     * @param reason Reason for the disconnect event.\n     * @returns \n     */\n\t__STSdisconnect: (reason: string) => void; // server and client event\n\n    /**\n     * Send a payload of data to 1 or more rooms registered on the server.\n     * @param rooms Room array for broadcasting.\n     * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n     * interface that extends STSServerToClientEvents.\n     * @returns \n     */\n    __STSsendToRoom: (rooms: string[], payload: { command: string, payload: any }) => void;\n\n    /**\n     * Send a payload of data to 1 or more rooms registered on the server.\n     * @param room Single room for broadcasting.\n\t * @param timeout Number of ms to try and get responses from all clients\n     * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n     * interface that extends STSServerToClientEvents.\n\t * @param callback The callback function to be invoked once all clients have responded with their respective payloads\n     * @returns \n     */\n    __STSsendToRoomWithCallback: (room: string, timeout: number, payload: { command: string, payload: any }, callback: (data: any) => void) => void;    \n\n    /**\n     * Send a payload of data to 1 or more rooms registered on the server.\n     * @param rooms Array of rooms for broadcasting.\n\t * @param timeout Number of ms to try and get responses from all clients\n     * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n     * interface that extends STSServerToClientEvents.\n\t * @param callback The callback function to be invoked once all clients have responded with their respective payloads\n     * @returns \n     */\n    __STSsendToRoomsWithCallback: (rooms: string[], timeout: number, payload: { command: string, payload: any }, callback: (data: any) => void) => void;    \n}\n\nexport interface STSDefaultServerToClientEvents {\n    /**\n     * The server may emit an unsolicited disconnect event to flag that all clients should disconnect. Most likely becuase the server may be shutting down.\n     * @param reason Reason why the server is emitting this disconnect event.\n     * @returns \n     */\n\t__STSdisconnect: (reason: string) => void;\n}\n\nexport enum STSNamespace {\n\tSTSMonitor = 'stsinstrumentmanager/stsmonitor',\n\tSTSControl = 'stsinstrumentmanager/stscontrol',\n    STSTestingNamespace = 'ststestingnamespace/ststesting'\n}\n\nexport enum STSRoom {\n\t// STSMonitor rooms\n\tSTSInstrumentDataRoom = 'stsinstrumentdataroom', // This room is for all instrument data messages\n\tSTSInstrumentDataSubscriptionRoom = 'stsinstrumentdatasubscriptionroom', // This room is only for subscribed instrument data messages\n\n\t// STSControl rooms\n\tSTSRunnerRoom = 'stsrunnerroom',\n\tSTSNodeRunnerRoom = 'stsnoderunnerroom'\n}\n\nexport enum STSEvent {\n\t// STSInstrumentData\n\tSTSInstrumentData = 'stsinstrumentdata',\n\tSTSSubInstrumentData = 'stssubinstrumentdata', // sub-scribed instrument data. This only outputs the nodes that have been subscribed by the client(s).\n\tSTSResetInstrumentData = 'stsresetinstrumentdata',\n\n\tSTSStartLoggingInstrumentData = 'stsStartLoggingInstrumentData',\n\tSTSStopLoggingInstrumentData = 'stsStopLoggingInstrumentData',\n\n\t// STSRunner events\n\tSTSStart = 'stsstart', // Start a test run with options as payload.\n\tSTSStop = 'stsstop', // Stop test run(s).\n\tSTSPause = 'stspause', // Pause test run(s).\n\tSTSResume = 'stsresume', // Resume test run(s).\n\tSTSTerminate = 'ststerminate', // Terminate runner instances and exit applications.\n\t// This may also be uysed to force trigger self healing (i.e. auto re-start) when\n\t// running within a container orchestrator such as K8, K3 or Docker Swarm.\n\tSTSUpdateStaticConfig = 'stsupdatestaticconfig', // Update base configuration. Options as payload.\n\tSTSUpdateDynamicConfig = 'stsupdatedynamicconfig', // Update running configuration. This is used\n\t// to control the runnning behaviour of test(s) in-flight. Options as payload.\n\n\tSTSSendToRoom = 'sendToRoom',\n\n\t// Standard socket events\n\tconnect = 'connect'\n}\n\n// https://socket.io/docs/v4/typescript/\n\nexport interface InterServerEvents {\n\tping: () => void;\n}\n\nexport interface STSSocketIONamespace {\n\tnamespace: string\n\tpid: number\n\tsocketionamespace: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n}\n\nexport type STSSocketIONamespaces = Record<string, STSSocketIONamespace>;\n\nexport type STSServerSocket = Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\nexport type STSClientSocket = Socket<STSDefaultServerToClientEvents, STSDefaultClientToServerEvents, InterServerEvents>\n","import { io, SocketOptions, ManagerOptions, Socket } from 'socket.io-client'\n\nimport { ISTSLogger, IAgentManager, isNode } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes.js'\n\nimport { TinyEmitter } from 'tiny-emitter';\n\nexport abstract class SocketIoClient<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents> extends TinyEmitter {\n    #agentManager?: IAgentManager\n    #logger?: ISTSLogger\n    #name: string\n    #address?: string\n    #socketIoCustomPath?: string\n    #authToken?: string\n    #socket?: Socket<ServerToClientEvents, ClientToServerEvents>;\n    #reconnectTimeout: number = 2000; // default\n\n    constructor(name: string) {\n        super();\n        this.#name = name;\n    }\n    \n    protected get logPrefix(): string {\n        return `SocketIoClient[${this.#name}]:`;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    protected LogDebugMessage(message: any): void {\n        if (this.#logger) this.#logger.debug(`${this.logPrefix}${message}`);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    protected LogErrorMessage(message: any): void {\n        if (this.#logger) this.#logger.error(`${this.logPrefix}${message}`);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    protected LogWarningMessage(message: any): void {\n        if (this.#logger) this.#logger.warn(`${this.logPrefix}${message}`);\n    }\n\n    get name(): string {\n        return this.#name;\n    }\n\n    get reconnectTimeout(): number {\n        return this.#reconnectTimeout;\n    }\n\n    get agentManager(): IAgentManager | undefined {\n        return this.#agentManager;\n    }\n\n    get logger(): ISTSLogger | undefined {\n        return this.#logger;\n    }\n\n    get address(): string | undefined {\n        return this.#address;\n    }\n\n    get authToken(): string | undefined {\n        return this.#authToken;\n    }\n\n    get socketIoCustomPath(): string | undefined {\n        return this.#socketIoCustomPath;\n    }\n\n    get socket(): Socket<ServerToClientEvents, ClientToServerEvents> | undefined {\n        return this.#socket;\n    }\n\n    WithAddress(address: string) {\n        this.#address = address;\n        return this;\n    }\n\n    WithAuthToken(authToken: string) {\n        this.#authToken = authToken;\n        return this;\n    }\n\n    WithSocketIoCustomPath(socketIoCustomPath: string) {\n        this.#socketIoCustomPath = socketIoCustomPath;\n        return this;\n    }\n\n    WithLogger(logger: ISTSLogger) {\n        this.#logger = logger;\n        return this;\n    }\n\n    WithAgentManager(agentManager: IAgentManager) {\n        this.#agentManager = agentManager;\n        return this;\n    }\n\n    WithReconnectTimeout(reconnectTimeout: number) {\n        this.#reconnectTimeout = reconnectTimeout;\n        return this;\n    }\n\n    SetupSocket() {\n        if (!this.#address) {\n            throw new Error(`SocketIoClientHelper:SetupSocket(): Error: [address not provided]`);\n        }\n\n        this.#EstablishSocketConnect();\n\n        return this;\n    }\n\n     \n    protected abstract SocketConnect(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;\n     \n    protected abstract SetupSocketEvents(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;\n     \n    protected abstract SocketConnectError(error: Error): void;\n     \n    protected abstract SocketDisconnect(reason: string): void;\n\n    // Engine Errors / Events\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    protected EngineError(error: Error): void { };\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    protected EngineReconnectError(error: Error): void { };\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    protected EngineConnectError(error: Error): void { };\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    protected EngineReconnect(attempt: number): void { };\n\n    /*\n    emit<Ev extends EventNames<ClientToServerEvents>>(ev: Ev, ...args: EventParams<ClientToServerEvents, Ev>): Socket<ServerToClientEvents, ClientToServerEvents> {\n        if (this.#socket) {\n            return this.#socket!.emit(ev, ...args);\n        } else {\n            throw new Error('SocketIoClient:emit(): Error: [socket instance not defined.]');\n        }\n    }\n    */\n\n    #EstablishSocketConnect(): void {\n        if (this.#socket !== undefined) {\n            // We already have a socket object (may or may not be connected)\n            if (this.#socket.connected === true) {\n                this.#socket.disconnect();\n            }\n            this.#socket = undefined;\n            if (isNode) {\n                setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n            } else {\n                setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n            }\n            return;\n        }\n\n        let socketOptions: Partial<SocketOptions & ManagerOptions>;\n        if (isNode) {\n            // https://socket.io/docs/v4/client-options/#reconnection\n            // https://github.com/socketio/engine.io-client#methods\n            socketOptions = {\n                transports: [\"websocket\" ]\n            }\n            if (this.#agentManager) {\n                if (!this.#address) {\n                    throw new Error(`SocketIoClient:SetupSocket(): Error: [address not provided when using agentManager]`);\n                }\n                // eslint-disable-next-line @typescript-eslint/no-explicit-any\n                socketOptions.agent = this.#agentManager.GetAgent(this.#address) as any;\n            }\n        } else {\n            socketOptions = {\n                transports: [\"websocket\" ]\n            }\n        }\n\n        // https://socket.io/docs/v4/middlewares/\n        // Send auth token for connections\n        if (this.#authToken) {\n            socketOptions.auth = (cb) => {\n                cb({\n                    token: this.#authToken\n                });\n            }\n        }\n\n        // On Server use;\n        /*\n        io.use((socket, next) => {\n            const token = socket.handshake.auth.token;\n            // ...\n        });\n        */\n\n        if (this.#socketIoCustomPath && this.#socketIoCustomPath.localeCompare('') !== 0) {\n            socketOptions.path = this.#socketIoCustomPath;\n        }\n\n        this.#socket = io(this.#address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n        // Manager errors\n        this.#socket.io.on('error', (err: Error) => {\n            this.LogErrorMessage(`socketDetail.socket.io.on('error'): [${err}] Address: [${this.#address}]`);\n            this.EngineError(err);\n        });\n\n        this.#socket.io.on('reconnect_error', (err: Error) => {\n            this.LogErrorMessage(`socketDetail.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);\n            this.EngineReconnectError(err);\n        });\n\n        // suppress automatic console logging by not letting it bubble up\n        this.#socket.on(\"connect_error\", (err) => {\n            this.LogErrorMessage(`socketDetail.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);\n            this.EngineConnectError(err);\n        });\n\n        this.#socket.io.on('reconnect', (attempt: number) => {\n            this.LogErrorMessage(`socketDetail.socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);\n            this.EngineReconnect(attempt);\n        });\n\n        /*\n        this.#socket.on(\"connect_timeout\", () => {\n            this.#LogErrorMessage(`socketDetail.socket.on('connect_timeout') Address: [${this.#address}]`);\n        });\n        */\n\n        this.#socket.on(\"connect\", () => {\n            if (this.#socket) {\n                this.LogDebugMessage(`Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);\n\n                setTimeout(() => {\n                    this.SocketConnect(this.#socket as Socket<ServerToClientEvents, ClientToServerEvents>);\n                }, 0);\n\n                this.SetupSocketEvents(this.#socket);\n\n            } else {\n                const errorMessage: string = 'Could not get socket object from socket.io, Address: [${socketDetail.address}]';\n                this.LogErrorMessage(errorMessage);\n                this.SocketConnectError(new Error(errorMessage));\n            }\n        })\n\n        // https://socket.io/docs/v4/client-socket-instance/#disconnect\n        this.#socket.on(\"disconnect\", (reason: string) => {\n            this.LogDebugMessage('socket disconnect: ' + reason);\n            this.SocketDisconnect(reason);\n            switch (reason) {\n            case 'io server disconnect' : {\n                // The server disconnect using disconnectSockets (i.e. normal safe shutdown)\n                this.LogDebugMessage('The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n                this.LogDebugMessage('The connection will be re-established when the server becomes available.');\n                this.#socket = undefined;\n                if (isNode) {\n                    if (this.#agentManager) {\n                        this.#agentManager.ResetAgent();\n                    }\n                    setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n                }\n            }\n                break;\n            case 'io client disconnect' :\n                this.LogDebugMessage('The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n                this.LogDebugMessage('The connection will not be re-established automatically.');\n                // Do nothing\n                break;\n            case 'transport close' :\n            case 'ping timeout' :\n            case 'transport error' : {\n                this.LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);\n                this.LogDebugMessage('The connection will be re-established when the server becomes available.');\n                if (this.#socket) {\n                    this.#socket.disconnect();\n                }\n                this.#socket = undefined;\n                if (isNode) {\n                    if (this.#agentManager) {\n                        this.#agentManager?.ResetAgent();\n                    }\n                    setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n                }\n            }\n                break;\n            }\n        });\n    }\n}\n"],"mappings":"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"}

package/dist/index.mjs

@@ -1,5 +1,6 @@
-import { n as __commonJSMin, r as __toESM, t as require_tiny_emitter } from "./tiny-emitter-D1Sgcrvm.js";
+import { t as require_tiny_emitter } from "./tiny-emitter-DB59cw42.js";
 import { io } from "socket.io-client";
+import { isNode } from "@nsshunt/stsutils";
 //#region src/commonTypes.ts
 var STSNamespace = /* @__PURE__ */ function(STSNamespace) {
 	STSNamespace["STSMonitor"] = "stsinstrumentmanager/stsmonitor";
@@ -33,9 +34,6 @@ var STSEvent = /* @__PURE__ */ function(STSEvent) {
 }({});
 //#endregion
 //#region src/socketIoClient.ts
-var import_browser = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports, module) => {
-	module.exports = false;
-})))(), 1);
 var import_tiny_emitter = require_tiny_emitter();
 var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 	#agentManager;
@@ -123,12 +121,12 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 		if (this.#socket !== void 0) {
 			if (this.#socket.connected === true) this.#socket.disconnect();
 			this.#socket = void 0;
-			if (import_browser.default) setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
+			if (isNode) setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
 			else setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
 			return;
 		}
 		let socketOptions;
-		if (import_browser.default) {
+		if (isNode) {
 			socketOptions = { transports: ["websocket"] };
 			if (this.#agentManager) {
 				if (!this.#address) throw new Error(`SocketIoClient:SetupSocket(): Error: [address not provided when using agentManager]`);
@@ -177,7 +175,7 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 					this.LogDebugMessage("The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.");
 					this.LogDebugMessage("The connection will be re-established when the server becomes available.");
 					this.#socket = void 0;
-					if (import_browser.default) {
+					if (isNode) {
 						if (this.#agentManager) this.#agentManager.ResetAgent();
 						setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
 					} else setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
@@ -193,7 +191,7 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 					this.LogDebugMessage("The connection will be re-established when the server becomes available.");
 					if (this.#socket) this.#socket.disconnect();
 					this.#socket = void 0;
-					if (import_browser.default) {
+					if (isNode) {
 						if (this.#agentManager) this.#agentManager?.ResetAgent();
 						setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
 					} else setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["#name","#logger","#reconnectTimeout","#agentManager","#address","#authToken","#socketIoCustomPath","#socket","#EstablishSocketConnect"],"sources":["../src/commonTypes.ts","../node_modules/detect-node/browser.js","../src/socketIoClient.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */  // --> OFF\nimport { Server, Socket, Namespace } from \"socket.io\";\nimport { ISTSLogger } from '@nsshunt/stsutils'\n\nexport interface STSDefaultClientToServerEvents {\n    /**\n     * Join the room(s) specified for this client.\n     * @param room The room(s) to join for this client.\n     * @returns \n     */\n\t__STSjoinRoom: (room: string[]) => void;\n\n    /**\n     * Remove this client from the specified room(s).\n     * @param room The room(s) to remove the client from within the server.\n     * @returns \n     */\n\t__STSleaveRoom: (room: string[]) => void;\n\n    /**\n     * Alerts the server that this client has flagged to disconnect. Allows server to perform clean-up if required. The server must call-back with the result of the disconnecting event.\n     * @param reason Reason for the disconnecting event.\n     * @param callback The server must call-back with the result of the disconnecting event.\n     * @returns \n     */\n\t__STSdisconnecting: (reason: string, callback: (data: string) => void) => void;\n\n    /**\n     * Alerts the server to disconnect this client.\n     * @param reason Reason for the disconnect event.\n     * @returns \n     */\n\t__STSdisconnect: (reason: string) => void; // server and client event\n\n    /**\n     * Send a payload of data to 1 or more rooms registered on the server.\n     * @param rooms Room array for broadcasting.\n     * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n     * interface that extends STSServerToClientEvents.\n     * @returns \n     */\n    __STSsendToRoom: (rooms: string[], payload: { command: string, payload: any }) => void;\n\n    /**\n     * Send a payload of data to 1 or more rooms registered on the server.\n     * @param room Single room for broadcasting.\n\t * @param timeout Number of ms to try and get responses from all clients\n     * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n     * interface that extends STSServerToClientEvents.\n\t * @param callback The callback function to be invoked once all clients have responded with their respective payloads\n     * @returns \n     */\n    __STSsendToRoomWithCallback: (room: string, timeout: number, payload: { command: string, payload: any }, callback: (data: any) => void) => void;    \n\n    /**\n     * Send a payload of data to 1 or more rooms registered on the server.\n     * @param rooms Array of rooms for broadcasting.\n\t * @param timeout Number of ms to try and get responses from all clients\n     * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n     * interface that extends STSServerToClientEvents.\n\t * @param callback The callback function to be invoked once all clients have responded with their respective payloads\n     * @returns \n     */\n    __STSsendToRoomsWithCallback: (rooms: string[], timeout: number, payload: { command: string, payload: any }, callback: (data: any) => void) => void;    \n}\n\nexport interface STSDefaultServerToClientEvents {\n    /**\n     * The server may emit an unsolicited disconnect event to flag that all clients should disconnect. Most likely becuase the server may be shutting down.\n     * @param reason Reason why the server is emitting this disconnect event.\n     * @returns \n     */\n\t__STSdisconnect: (reason: string) => void;\n}\n\nexport enum STSNamespace {\n\tSTSMonitor = 'stsinstrumentmanager/stsmonitor',\n\tSTSControl = 'stsinstrumentmanager/stscontrol',\n    STSTestingNamespace = 'ststestingnamespace/ststesting'\n}\n\nexport enum STSRoom {\n\t// STSMonitor rooms\n\tSTSInstrumentDataRoom = 'stsinstrumentdataroom', // This room is for all instrument data messages\n\tSTSInstrumentDataSubscriptionRoom = 'stsinstrumentdatasubscriptionroom', // This room is only for subscribed instrument data messages\n\n\t// STSControl rooms\n\tSTSRunnerRoom = 'stsrunnerroom',\n\tSTSNodeRunnerRoom = 'stsnoderunnerroom'\n}\n\nexport enum STSEvent {\n\t// STSInstrumentData\n\tSTSInstrumentData = 'stsinstrumentdata',\n\tSTSSubInstrumentData = 'stssubinstrumentdata', // sub-scribed instrument data. This only outputs the nodes that have been subscribed by the client(s).\n\tSTSResetInstrumentData = 'stsresetinstrumentdata',\n\n\tSTSStartLoggingInstrumentData = 'stsStartLoggingInstrumentData',\n\tSTSStopLoggingInstrumentData = 'stsStopLoggingInstrumentData',\n\n\t// STSRunner events\n\tSTSStart = 'stsstart', // Start a test run with options as payload.\n\tSTSStop = 'stsstop', // Stop test run(s).\n\tSTSPause = 'stspause', // Pause test run(s).\n\tSTSResume = 'stsresume', // Resume test run(s).\n\tSTSTerminate = 'ststerminate', // Terminate runner instances and exit applications.\n\t// This may also be uysed to force trigger self healing (i.e. auto re-start) when\n\t// running within a container orchestrator such as K8, K3 or Docker Swarm.\n\tSTSUpdateStaticConfig = 'stsupdatestaticconfig', // Update base configuration. Options as payload.\n\tSTSUpdateDynamicConfig = 'stsupdatedynamicconfig', // Update running configuration. This is used\n\t// to control the runnning behaviour of test(s) in-flight. Options as payload.\n\n\tSTSSendToRoom = 'sendToRoom',\n\n\t// Standard socket events\n\tconnect = 'connect'\n}\n\n// https://socket.io/docs/v4/typescript/\n\nexport interface InterServerEvents {\n\tping: () => void;\n}\n\nexport interface STSSocketIONamespace {\n\tnamespace: string\n\tpid: number\n\tsocketionamespace: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n}\n\nexport type STSSocketIONamespaces = Record<string, STSSocketIONamespace>;\n\nexport type STSServerSocket = Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\nexport type STSClientSocket = Socket<STSDefaultServerToClientEvents, STSDefaultClientToServerEvents, InterServerEvents>\n","module.exports = false;\n\n","import { io, SocketOptions, ManagerOptions, Socket } from 'socket.io-client'\n//import { EventNames, EventParams } from \"@socket.io/component-emitter\";\n\nimport isNode from 'detect-node';\n\nimport { ISTSLogger, IAgentManager } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes.js'\n\nimport { TinyEmitter } from 'tiny-emitter';\n\nexport abstract class SocketIoClient<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents> extends TinyEmitter {\n    #agentManager?: IAgentManager\n    #logger?: ISTSLogger\n    #name: string\n    #address?: string\n    #socketIoCustomPath?: string\n    #authToken?: string\n    #socket?: Socket<ServerToClientEvents, ClientToServerEvents>;\n    #reconnectTimeout: number = 2000; // default\n\n    constructor(name: string) {\n        super();\n        this.#name = name;\n    }\n    \n    protected get logPrefix(): string {\n        return `SocketIoClient[${this.#name}]:`;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    protected LogDebugMessage(message: any): void {\n        if (this.#logger) this.#logger.debug(`${this.logPrefix}${message}`);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    protected LogErrorMessage(message: any): void {\n        if (this.#logger) this.#logger.error(`${this.logPrefix}${message}`);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    protected LogWarningMessage(message: any): void {\n        if (this.#logger) this.#logger.warn(`${this.logPrefix}${message}`);\n    }\n\n    get name(): string {\n        return this.#name;\n    }\n\n    get reconnectTimeout(): number {\n        return this.#reconnectTimeout;\n    }\n\n    get agentManager(): IAgentManager | undefined {\n        return this.#agentManager;\n    }\n\n    get logger(): ISTSLogger | undefined {\n        return this.#logger;\n    }\n\n    get address(): string | undefined {\n        return this.#address;\n    }\n\n    get authToken(): string | undefined {\n        return this.#authToken;\n    }\n\n    get socketIoCustomPath(): string | undefined {\n        return this.#socketIoCustomPath;\n    }\n\n    get socket(): Socket<ServerToClientEvents, ClientToServerEvents> | undefined {\n        return this.#socket;\n    }\n\n    WithAddress(address: string) {\n        this.#address = address;\n        return this;\n    }\n\n    WithAuthToken(authToken: string) {\n        this.#authToken = authToken;\n        return this;\n    }\n\n    WithSocketIoCustomPath(socketIoCustomPath: string) {\n        this.#socketIoCustomPath = socketIoCustomPath;\n        return this;\n    }\n\n    WithLogger(logger: ISTSLogger) {\n        this.#logger = logger;\n        return this;\n    }\n\n    WithAgentManager(agentManager: IAgentManager) {\n        this.#agentManager = agentManager;\n        return this;\n    }\n\n    WithReconnectTimeout(reconnectTimeout: number) {\n        this.#reconnectTimeout = reconnectTimeout;\n        return this;\n    }\n\n    SetupSocket() {\n        if (!this.#address) {\n            throw new Error(`SocketIoClientHelper:SetupSocket(): Error: [address not provided]`);\n        }\n\n        this.#EstablishSocketConnect();\n\n        return this;\n    }\n\n     \n    protected abstract SocketConnect(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;\n     \n    protected abstract SetupSocketEvents(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;\n     \n    protected abstract SocketConnectError(error: Error): void;\n     \n    protected abstract SocketDisconnect(reason: string): void;\n\n    // Engine Errors / Events\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    protected EngineError(error: Error): void { };\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    protected EngineReconnectError(error: Error): void { };\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    protected EngineConnectError(error: Error): void { };\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    protected EngineReconnect(attempt: number): void { };\n\n    /*\n    emit<Ev extends EventNames<ClientToServerEvents>>(ev: Ev, ...args: EventParams<ClientToServerEvents, Ev>): Socket<ServerToClientEvents, ClientToServerEvents> {\n        if (this.#socket) {\n            return this.#socket!.emit(ev, ...args);\n        } else {\n            throw new Error('SocketIoClient:emit(): Error: [socket instance not defined.]');\n        }\n    }\n    */\n\n    #EstablishSocketConnect(): void {\n        if (this.#socket !== undefined) {\n            // We already have a socket object (may or may not be connected)\n            if (this.#socket.connected === true) {\n                this.#socket.disconnect();\n            }\n            this.#socket = undefined;\n            if (isNode) {\n                setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n            } else {\n                setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n            }\n            return;\n        }\n\n        let socketOptions: Partial<SocketOptions & ManagerOptions>;\n        if (isNode) {\n            // https://socket.io/docs/v4/client-options/#reconnection\n            // https://github.com/socketio/engine.io-client#methods\n            socketOptions = {\n                transports: [\"websocket\" ]\n            }\n            if (this.#agentManager) {\n                if (!this.#address) {\n                    throw new Error(`SocketIoClient:SetupSocket(): Error: [address not provided when using agentManager]`);\n                }\n                // eslint-disable-next-line @typescript-eslint/no-explicit-any\n                socketOptions.agent = this.#agentManager.GetAgent(this.#address) as any;\n            }\n        } else {\n            socketOptions = {\n                transports: [\"websocket\" ]\n            }\n        }\n\n        // https://socket.io/docs/v4/middlewares/\n        // Send auth token for connections\n        if (this.#authToken) {\n            socketOptions.auth = (cb) => {\n                cb({\n                    token: this.#authToken\n                });\n            }\n        }\n\n        // On Server use;\n        /*\n        io.use((socket, next) => {\n            const token = socket.handshake.auth.token;\n            // ...\n        });\n        */\n\n        if (this.#socketIoCustomPath && this.#socketIoCustomPath.localeCompare('') !== 0) {\n            socketOptions.path = this.#socketIoCustomPath;\n        }\n\n        this.#socket = io(this.#address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n        // Manager errors\n        this.#socket.io.on('error', (err: Error) => {\n            this.LogErrorMessage(`socketDetail.socket.io.on('error'): [${err}] Address: [${this.#address}]`);\n            this.EngineError(err);\n        });\n\n        this.#socket.io.on('reconnect_error', (err: Error) => {\n            this.LogErrorMessage(`socketDetail.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);\n            this.EngineReconnectError(err);\n        });\n\n        // suppress automatic console logging by not letting it bubble up\n        this.#socket.on(\"connect_error\", (err) => {\n            this.LogErrorMessage(`socketDetail.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);\n            this.EngineConnectError(err);\n        });\n\n        this.#socket.io.on('reconnect', (attempt: number) => {\n            this.LogErrorMessage(`socketDetail.socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);\n            this.EngineReconnect(attempt);\n        });\n\n        /*\n        this.#socket.on(\"connect_timeout\", () => {\n            this.#LogErrorMessage(`socketDetail.socket.on('connect_timeout') Address: [${this.#address}]`);\n        });\n        */\n\n        this.#socket.on(\"connect\", () => {\n            if (this.#socket) {\n                this.LogDebugMessage(`Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);\n\n                setTimeout(() => {\n                    this.SocketConnect(this.#socket as Socket<ServerToClientEvents, ClientToServerEvents>);\n                }, 0);\n\n                this.SetupSocketEvents(this.#socket);\n\n            } else {\n                const errorMessage: string = 'Could not get socket object from socket.io, Address: [${socketDetail.address}]';\n                this.LogErrorMessage(errorMessage);\n                this.SocketConnectError(new Error(errorMessage));\n            }\n        })\n\n        // https://socket.io/docs/v4/client-socket-instance/#disconnect\n        this.#socket.on(\"disconnect\", (reason: string) => {\n            this.LogDebugMessage('socket disconnect: ' + reason);\n            this.SocketDisconnect(reason);\n            switch (reason) {\n            case 'io server disconnect' : {\n                // The server disconnect using disconnectSockets (i.e. normal safe shutdown)\n                this.LogDebugMessage('The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n                this.LogDebugMessage('The connection will be re-established when the server becomes available.');\n                this.#socket = undefined;\n                if (isNode) {\n                    if (this.#agentManager) {\n                        this.#agentManager.ResetAgent();\n                    }\n                    setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n                }\n            }\n                break;\n            case 'io client disconnect' :\n                this.LogDebugMessage('The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n                this.LogDebugMessage('The connection will not be re-established automatically.');\n                // Do nothing\n                break;\n            case 'transport close' :\n            case 'ping timeout' :\n            case 'transport error' : {\n                this.LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);\n                this.LogDebugMessage('The connection will be re-established when the server becomes available.');\n                if (this.#socket) {\n                    this.#socket.disconnect();\n                }\n                this.#socket = undefined;\n                if (isNode) {\n                    if (this.#agentManager) {\n                        this.#agentManager?.ResetAgent();\n                    }\n                    setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n                }\n            }\n                break;\n            }\n        });\n    }\n}\n"],"x_google_ignoreList":[1],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["#name","#logger","#reconnectTimeout","#agentManager","#address","#authToken","#socketIoCustomPath","#socket","#EstablishSocketConnect"],"sources":["../src/commonTypes.ts","../src/socketIoClient.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */  // --> OFF\nimport { Server, Socket, Namespace } from \"socket.io\";\nimport { ISTSLogger } from '@nsshunt/stsutils'\n\nexport interface STSDefaultClientToServerEvents {\n    /**\n     * Join the room(s) specified for this client.\n     * @param room The room(s) to join for this client.\n     * @returns \n     */\n\t__STSjoinRoom: (room: string[]) => void;\n\n    /**\n     * Remove this client from the specified room(s).\n     * @param room The room(s) to remove the client from within the server.\n     * @returns \n     */\n\t__STSleaveRoom: (room: string[]) => void;\n\n    /**\n     * Alerts the server that this client has flagged to disconnect. Allows server to perform clean-up if required. The server must call-back with the result of the disconnecting event.\n     * @param reason Reason for the disconnecting event.\n     * @param callback The server must call-back with the result of the disconnecting event.\n     * @returns \n     */\n\t__STSdisconnecting: (reason: string, callback: (data: string) => void) => void;\n\n    /**\n     * Alerts the server to disconnect this client.\n     * @param reason Reason for the disconnect event.\n     * @returns \n     */\n\t__STSdisconnect: (reason: string) => void; // server and client event\n\n    /**\n     * Send a payload of data to 1 or more rooms registered on the server.\n     * @param rooms Room array for broadcasting.\n     * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n     * interface that extends STSServerToClientEvents.\n     * @returns \n     */\n    __STSsendToRoom: (rooms: string[], payload: { command: string, payload: any }) => void;\n\n    /**\n     * Send a payload of data to 1 or more rooms registered on the server.\n     * @param room Single room for broadcasting.\n\t * @param timeout Number of ms to try and get responses from all clients\n     * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n     * interface that extends STSServerToClientEvents.\n\t * @param callback The callback function to be invoked once all clients have responded with their respective payloads\n     * @returns \n     */\n    __STSsendToRoomWithCallback: (room: string, timeout: number, payload: { command: string, payload: any }, callback: (data: any) => void) => void;    \n\n    /**\n     * Send a payload of data to 1 or more rooms registered on the server.\n     * @param rooms Array of rooms for broadcasting.\n\t * @param timeout Number of ms to try and get responses from all clients\n     * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n     * interface that extends STSServerToClientEvents.\n\t * @param callback The callback function to be invoked once all clients have responded with their respective payloads\n     * @returns \n     */\n    __STSsendToRoomsWithCallback: (rooms: string[], timeout: number, payload: { command: string, payload: any }, callback: (data: any) => void) => void;    \n}\n\nexport interface STSDefaultServerToClientEvents {\n    /**\n     * The server may emit an unsolicited disconnect event to flag that all clients should disconnect. Most likely becuase the server may be shutting down.\n     * @param reason Reason why the server is emitting this disconnect event.\n     * @returns \n     */\n\t__STSdisconnect: (reason: string) => void;\n}\n\nexport enum STSNamespace {\n\tSTSMonitor = 'stsinstrumentmanager/stsmonitor',\n\tSTSControl = 'stsinstrumentmanager/stscontrol',\n    STSTestingNamespace = 'ststestingnamespace/ststesting'\n}\n\nexport enum STSRoom {\n\t// STSMonitor rooms\n\tSTSInstrumentDataRoom = 'stsinstrumentdataroom', // This room is for all instrument data messages\n\tSTSInstrumentDataSubscriptionRoom = 'stsinstrumentdatasubscriptionroom', // This room is only for subscribed instrument data messages\n\n\t// STSControl rooms\n\tSTSRunnerRoom = 'stsrunnerroom',\n\tSTSNodeRunnerRoom = 'stsnoderunnerroom'\n}\n\nexport enum STSEvent {\n\t// STSInstrumentData\n\tSTSInstrumentData = 'stsinstrumentdata',\n\tSTSSubInstrumentData = 'stssubinstrumentdata', // sub-scribed instrument data. This only outputs the nodes that have been subscribed by the client(s).\n\tSTSResetInstrumentData = 'stsresetinstrumentdata',\n\n\tSTSStartLoggingInstrumentData = 'stsStartLoggingInstrumentData',\n\tSTSStopLoggingInstrumentData = 'stsStopLoggingInstrumentData',\n\n\t// STSRunner events\n\tSTSStart = 'stsstart', // Start a test run with options as payload.\n\tSTSStop = 'stsstop', // Stop test run(s).\n\tSTSPause = 'stspause', // Pause test run(s).\n\tSTSResume = 'stsresume', // Resume test run(s).\n\tSTSTerminate = 'ststerminate', // Terminate runner instances and exit applications.\n\t// This may also be uysed to force trigger self healing (i.e. auto re-start) when\n\t// running within a container orchestrator such as K8, K3 or Docker Swarm.\n\tSTSUpdateStaticConfig = 'stsupdatestaticconfig', // Update base configuration. Options as payload.\n\tSTSUpdateDynamicConfig = 'stsupdatedynamicconfig', // Update running configuration. This is used\n\t// to control the runnning behaviour of test(s) in-flight. Options as payload.\n\n\tSTSSendToRoom = 'sendToRoom',\n\n\t// Standard socket events\n\tconnect = 'connect'\n}\n\n// https://socket.io/docs/v4/typescript/\n\nexport interface InterServerEvents {\n\tping: () => void;\n}\n\nexport interface STSSocketIONamespace {\n\tnamespace: string\n\tpid: number\n\tsocketionamespace: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n}\n\nexport type STSSocketIONamespaces = Record<string, STSSocketIONamespace>;\n\nexport type STSServerSocket = Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\nexport type STSClientSocket = Socket<STSDefaultServerToClientEvents, STSDefaultClientToServerEvents, InterServerEvents>\n","import { io, SocketOptions, ManagerOptions, Socket } from 'socket.io-client'\n\nimport { ISTSLogger, IAgentManager, isNode } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes.js'\n\nimport { TinyEmitter } from 'tiny-emitter';\n\nexport abstract class SocketIoClient<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents> extends TinyEmitter {\n    #agentManager?: IAgentManager\n    #logger?: ISTSLogger\n    #name: string\n    #address?: string\n    #socketIoCustomPath?: string\n    #authToken?: string\n    #socket?: Socket<ServerToClientEvents, ClientToServerEvents>;\n    #reconnectTimeout: number = 2000; // default\n\n    constructor(name: string) {\n        super();\n        this.#name = name;\n    }\n    \n    protected get logPrefix(): string {\n        return `SocketIoClient[${this.#name}]:`;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    protected LogDebugMessage(message: any): void {\n        if (this.#logger) this.#logger.debug(`${this.logPrefix}${message}`);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    protected LogErrorMessage(message: any): void {\n        if (this.#logger) this.#logger.error(`${this.logPrefix}${message}`);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    protected LogWarningMessage(message: any): void {\n        if (this.#logger) this.#logger.warn(`${this.logPrefix}${message}`);\n    }\n\n    get name(): string {\n        return this.#name;\n    }\n\n    get reconnectTimeout(): number {\n        return this.#reconnectTimeout;\n    }\n\n    get agentManager(): IAgentManager | undefined {\n        return this.#agentManager;\n    }\n\n    get logger(): ISTSLogger | undefined {\n        return this.#logger;\n    }\n\n    get address(): string | undefined {\n        return this.#address;\n    }\n\n    get authToken(): string | undefined {\n        return this.#authToken;\n    }\n\n    get socketIoCustomPath(): string | undefined {\n        return this.#socketIoCustomPath;\n    }\n\n    get socket(): Socket<ServerToClientEvents, ClientToServerEvents> | undefined {\n        return this.#socket;\n    }\n\n    WithAddress(address: string) {\n        this.#address = address;\n        return this;\n    }\n\n    WithAuthToken(authToken: string) {\n        this.#authToken = authToken;\n        return this;\n    }\n\n    WithSocketIoCustomPath(socketIoCustomPath: string) {\n        this.#socketIoCustomPath = socketIoCustomPath;\n        return this;\n    }\n\n    WithLogger(logger: ISTSLogger) {\n        this.#logger = logger;\n        return this;\n    }\n\n    WithAgentManager(agentManager: IAgentManager) {\n        this.#agentManager = agentManager;\n        return this;\n    }\n\n    WithReconnectTimeout(reconnectTimeout: number) {\n        this.#reconnectTimeout = reconnectTimeout;\n        return this;\n    }\n\n    SetupSocket() {\n        if (!this.#address) {\n            throw new Error(`SocketIoClientHelper:SetupSocket(): Error: [address not provided]`);\n        }\n\n        this.#EstablishSocketConnect();\n\n        return this;\n    }\n\n     \n    protected abstract SocketConnect(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;\n     \n    protected abstract SetupSocketEvents(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;\n     \n    protected abstract SocketConnectError(error: Error): void;\n     \n    protected abstract SocketDisconnect(reason: string): void;\n\n    // Engine Errors / Events\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    protected EngineError(error: Error): void { };\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    protected EngineReconnectError(error: Error): void { };\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    protected EngineConnectError(error: Error): void { };\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    protected EngineReconnect(attempt: number): void { };\n\n    /*\n    emit<Ev extends EventNames<ClientToServerEvents>>(ev: Ev, ...args: EventParams<ClientToServerEvents, Ev>): Socket<ServerToClientEvents, ClientToServerEvents> {\n        if (this.#socket) {\n            return this.#socket!.emit(ev, ...args);\n        } else {\n            throw new Error('SocketIoClient:emit(): Error: [socket instance not defined.]');\n        }\n    }\n    */\n\n    #EstablishSocketConnect(): void {\n        if (this.#socket !== undefined) {\n            // We already have a socket object (may or may not be connected)\n            if (this.#socket.connected === true) {\n                this.#socket.disconnect();\n            }\n            this.#socket = undefined;\n            if (isNode) {\n                setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n            } else {\n                setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n            }\n            return;\n        }\n\n        let socketOptions: Partial<SocketOptions & ManagerOptions>;\n        if (isNode) {\n            // https://socket.io/docs/v4/client-options/#reconnection\n            // https://github.com/socketio/engine.io-client#methods\n            socketOptions = {\n                transports: [\"websocket\" ]\n            }\n            if (this.#agentManager) {\n                if (!this.#address) {\n                    throw new Error(`SocketIoClient:SetupSocket(): Error: [address not provided when using agentManager]`);\n                }\n                // eslint-disable-next-line @typescript-eslint/no-explicit-any\n                socketOptions.agent = this.#agentManager.GetAgent(this.#address) as any;\n            }\n        } else {\n            socketOptions = {\n                transports: [\"websocket\" ]\n            }\n        }\n\n        // https://socket.io/docs/v4/middlewares/\n        // Send auth token for connections\n        if (this.#authToken) {\n            socketOptions.auth = (cb) => {\n                cb({\n                    token: this.#authToken\n                });\n            }\n        }\n\n        // On Server use;\n        /*\n        io.use((socket, next) => {\n            const token = socket.handshake.auth.token;\n            // ...\n        });\n        */\n\n        if (this.#socketIoCustomPath && this.#socketIoCustomPath.localeCompare('') !== 0) {\n            socketOptions.path = this.#socketIoCustomPath;\n        }\n\n        this.#socket = io(this.#address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n        // Manager errors\n        this.#socket.io.on('error', (err: Error) => {\n            this.LogErrorMessage(`socketDetail.socket.io.on('error'): [${err}] Address: [${this.#address}]`);\n            this.EngineError(err);\n        });\n\n        this.#socket.io.on('reconnect_error', (err: Error) => {\n            this.LogErrorMessage(`socketDetail.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);\n            this.EngineReconnectError(err);\n        });\n\n        // suppress automatic console logging by not letting it bubble up\n        this.#socket.on(\"connect_error\", (err) => {\n            this.LogErrorMessage(`socketDetail.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);\n            this.EngineConnectError(err);\n        });\n\n        this.#socket.io.on('reconnect', (attempt: number) => {\n            this.LogErrorMessage(`socketDetail.socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);\n            this.EngineReconnect(attempt);\n        });\n\n        /*\n        this.#socket.on(\"connect_timeout\", () => {\n            this.#LogErrorMessage(`socketDetail.socket.on('connect_timeout') Address: [${this.#address}]`);\n        });\n        */\n\n        this.#socket.on(\"connect\", () => {\n            if (this.#socket) {\n                this.LogDebugMessage(`Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);\n\n                setTimeout(() => {\n                    this.SocketConnect(this.#socket as Socket<ServerToClientEvents, ClientToServerEvents>);\n                }, 0);\n\n                this.SetupSocketEvents(this.#socket);\n\n            } else {\n                const errorMessage: string = 'Could not get socket object from socket.io, Address: [${socketDetail.address}]';\n                this.LogErrorMessage(errorMessage);\n                this.SocketConnectError(new Error(errorMessage));\n            }\n        })\n\n        // https://socket.io/docs/v4/client-socket-instance/#disconnect\n        this.#socket.on(\"disconnect\", (reason: string) => {\n            this.LogDebugMessage('socket disconnect: ' + reason);\n            this.SocketDisconnect(reason);\n            switch (reason) {\n            case 'io server disconnect' : {\n                // The server disconnect using disconnectSockets (i.e. normal safe shutdown)\n                this.LogDebugMessage('The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n                this.LogDebugMessage('The connection will be re-established when the server becomes available.');\n                this.#socket = undefined;\n                if (isNode) {\n                    if (this.#agentManager) {\n                        this.#agentManager.ResetAgent();\n                    }\n                    setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n                }\n            }\n                break;\n            case 'io client disconnect' :\n                this.LogDebugMessage('The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n                this.LogDebugMessage('The connection will not be re-established automatically.');\n                // Do nothing\n                break;\n            case 'transport close' :\n            case 'ping timeout' :\n            case 'transport error' : {\n                this.LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);\n                this.LogDebugMessage('The connection will be re-established when the server becomes available.');\n                if (this.#socket) {\n                    this.#socket.disconnect();\n                }\n                this.#socket = undefined;\n                if (isNode) {\n                    if (this.#agentManager) {\n                        this.#agentManager?.ResetAgent();\n                    }\n                    setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n                }\n            }\n                break;\n            }\n        });\n    }\n}\n"],"mappings":"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"}

package/dist/node.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_tiny_emitter$1 = require("./tiny-emitter-BqSsRcpg.cjs");
+const require_tiny_emitter$1 = require("./tiny-emitter-CjKjGEhV.cjs");
 let _nsshunt_stsutils = require("@nsshunt/stsutils");
 let socket_io = require("socket.io");
 let ioredis = require("ioredis");

package/dist/node.mjs

@@ -1,4 +1,4 @@
-import { t as require_tiny_emitter } from "./tiny-emitter-D1Sgcrvm.js";
+import { t as require_tiny_emitter } from "./tiny-emitter-DB59cw42.js";
 import { Sleep } from "@nsshunt/stsutils";
 import { Server } from "socket.io";
 import { Redis } from "ioredis";

package/dist/{tiny-emitter-D1Sgcrvm.js → tiny-emitter-CjKjGEhV.cjs}

@@ -1,25 +1,5 @@
 //#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
 //#endregion
 //#region node_modules/tiny-emitter/index.js
 var require_tiny_emitter = /* @__PURE__ */ __commonJSMin(((exports, module) => {
@@ -65,6 +45,11 @@ var require_tiny_emitter = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports.TinyEmitter = E;
 }));
 //#endregion
-export { __commonJSMin as n, __toESM as r, require_tiny_emitter as t };
+Object.defineProperty(exports, "require_tiny_emitter", {
+	enumerable: true,
+	get: function() {
+		return require_tiny_emitter;
+	}
+});
 
-//# sourceMappingURL=tiny-emitter-D1Sgcrvm.js.map
+//# sourceMappingURL=tiny-emitter-CjKjGEhV.cjs.map

package/dist/{tiny-emitter-BqSsRcpg.cjs.map → tiny-emitter-CjKjGEhV.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"tiny-emitter-BqSsRcpg.cjs","names":[],"sources":["../node_modules/tiny-emitter/index.js"],"sourcesContent":["function E () {\n  // Keep this empty so it's easier to inherit from\n  // (via https://github.com/lipsmack from https://github.com/scottcorgan/tiny-emitter/issues/3)\n}\n\nE.prototype = {\n  on: function (name, callback, ctx) {\n    var e = this.e || (this.e = {});\n\n    (e[name] || (e[name] = [])).push({\n      fn: callback,\n      ctx: ctx\n    });\n\n    return this;\n  },\n\n  once: function (name, callback, ctx) {\n    var self = this;\n    function listener () {\n      self.off(name, listener);\n      callback.apply(ctx, arguments);\n    };\n\n    listener._ = callback\n    return this.on(name, listener, ctx);\n  },\n\n  emit: function (name) {\n    var data = [].slice.call(arguments, 1);\n    var evtArr = ((this.e || (this.e = {}))[name] || []).slice();\n    var i = 0;\n    var len = evtArr.length;\n\n    for (i; i < len; i++) {\n      evtArr[i].fn.apply(evtArr[i].ctx, data);\n    }\n\n    return this;\n  },\n\n  off: function (name, callback) {\n    var e = this.e || (this.e = {});\n    var evts = e[name];\n    var liveEvents = [];\n\n    if (evts && callback) {\n      for (var i = 0, len = evts.length; i < len; i++) {\n        if (evts[i].fn !== callback && evts[i].fn._ !== callback)\n          liveEvents.push(evts[i]);\n      }\n    }\n\n    // Remove event from queue to prevent memory leak\n    // Suggested by https://github.com/lazd\n    // Ref: https://github.com/scottcorgan/tiny-emitter/commit/c6ebfaa9bc973b33d110a84a307742b7cf94c953#commitcomment-5024910\n\n    (liveEvents.length)\n      ? e[name] = liveEvents\n      : delete e[name];\n\n    return this;\n  }\n};\n\nmodule.exports = E;\nmodule.exports.TinyEmitter = E;\n"],"x_google_ignoreList":[0],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;CAAA,SAAS,IAAK;AAKd,GAAE,YAAY;EACZ,IAAI,SAAU,MAAM,UAAU,KAAK;GACjC,IAAI,IAAI,KAAK,MAAM,KAAK,IAAI,EAAE;AAE9B,IAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,KAAK;IAC/B,IAAI;IACC;IACN,CAAC;AAEF,UAAO;;EAGT,MAAM,SAAU,MAAM,UAAU,KAAK;GACnC,IAAI,OAAO;GACX,SAAS,WAAY;AACnB,SAAK,IAAI,MAAM,SAAS;AACxB,aAAS,MAAM,KAAK,UAAU;;AAGhC,YAAS,IAAI;AACb,UAAO,KAAK,GAAG,MAAM,UAAU,IAAI;;EAGrC,MAAM,SAAU,MAAM;GACpB,IAAI,OAAO,EAAE,CAAC,MAAM,KAAK,WAAW,EAAE;GACtC,IAAI,WAAW,KAAK,MAAM,KAAK,IAAI,EAAE,GAAG,SAAS,EAAE,EAAE,OAAO;GAC5D,IAAI,IAAI;GACR,IAAI,MAAM,OAAO;AAEjB,UAAQ,IAAI,KAAK,IACf,QAAO,GAAG,GAAG,MAAM,OAAO,GAAG,KAAK,KAAK;AAGzC,UAAO;;EAGT,KAAK,SAAU,MAAM,UAAU;GAC7B,IAAI,IAAI,KAAK,MAAM,KAAK,IAAI,EAAE;GAC9B,IAAI,OAAO,EAAE;GACb,IAAI,aAAa,EAAE;AAEnB,OAAI,QAAQ;SACL,IAAI,IAAI,GAAG,MAAM,KAAK,QAAQ,IAAI,KAAK,IAC1C,KAAI,KAAK,GAAG,OAAO,YAAY,KAAK,GAAG,GAAG,MAAM,SAC9C,YAAW,KAAK,KAAK,GAAG;;AAQ7B,cAAW,SACR,EAAE,QAAQ,aACV,OAAO,EAAE;AAEb,UAAO;;EAEV;AAED,QAAO,UAAU;AACjB,QAAO,QAAQ,cAAc"}
+{"version":3,"file":"tiny-emitter-CjKjGEhV.cjs","names":[],"sources":["../node_modules/tiny-emitter/index.js"],"sourcesContent":["function E () {\n  // Keep this empty so it's easier to inherit from\n  // (via https://github.com/lipsmack from https://github.com/scottcorgan/tiny-emitter/issues/3)\n}\n\nE.prototype = {\n  on: function (name, callback, ctx) {\n    var e = this.e || (this.e = {});\n\n    (e[name] || (e[name] = [])).push({\n      fn: callback,\n      ctx: ctx\n    });\n\n    return this;\n  },\n\n  once: function (name, callback, ctx) {\n    var self = this;\n    function listener () {\n      self.off(name, listener);\n      callback.apply(ctx, arguments);\n    };\n\n    listener._ = callback\n    return this.on(name, listener, ctx);\n  },\n\n  emit: function (name) {\n    var data = [].slice.call(arguments, 1);\n    var evtArr = ((this.e || (this.e = {}))[name] || []).slice();\n    var i = 0;\n    var len = evtArr.length;\n\n    for (i; i < len; i++) {\n      evtArr[i].fn.apply(evtArr[i].ctx, data);\n    }\n\n    return this;\n  },\n\n  off: function (name, callback) {\n    var e = this.e || (this.e = {});\n    var evts = e[name];\n    var liveEvents = [];\n\n    if (evts && callback) {\n      for (var i = 0, len = evts.length; i < len; i++) {\n        if (evts[i].fn !== callback && evts[i].fn._ !== callback)\n          liveEvents.push(evts[i]);\n      }\n    }\n\n    // Remove event from queue to prevent memory leak\n    // Suggested by https://github.com/lazd\n    // Ref: https://github.com/scottcorgan/tiny-emitter/commit/c6ebfaa9bc973b33d110a84a307742b7cf94c953#commitcomment-5024910\n\n    (liveEvents.length)\n      ? e[name] = liveEvents\n      : delete e[name];\n\n    return this;\n  }\n};\n\nmodule.exports = E;\nmodule.exports.TinyEmitter = E;\n"],"x_google_ignoreList":[0],"mappings":";;;;;CAAA,SAAS,IAAK;AAKd,GAAE,YAAY;EACZ,IAAI,SAAU,MAAM,UAAU,KAAK;GACjC,IAAI,IAAI,KAAK,MAAM,KAAK,IAAI,EAAE;AAE9B,IAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,KAAK;IAC/B,IAAI;IACC;IACN,CAAC;AAEF,UAAO;;EAGT,MAAM,SAAU,MAAM,UAAU,KAAK;GACnC,IAAI,OAAO;GACX,SAAS,WAAY;AACnB,SAAK,IAAI,MAAM,SAAS;AACxB,aAAS,MAAM,KAAK,UAAU;;AAGhC,YAAS,IAAI;AACb,UAAO,KAAK,GAAG,MAAM,UAAU,IAAI;;EAGrC,MAAM,SAAU,MAAM;GACpB,IAAI,OAAO,EAAE,CAAC,MAAM,KAAK,WAAW,EAAE;GACtC,IAAI,WAAW,KAAK,MAAM,KAAK,IAAI,EAAE,GAAG,SAAS,EAAE,EAAE,OAAO;GAC5D,IAAI,IAAI;GACR,IAAI,MAAM,OAAO;AAEjB,UAAQ,IAAI,KAAK,IACf,QAAO,GAAG,GAAG,MAAM,OAAO,GAAG,KAAK,KAAK;AAGzC,UAAO;;EAGT,KAAK,SAAU,MAAM,UAAU;GAC7B,IAAI,IAAI,KAAK,MAAM,KAAK,IAAI,EAAE;GAC9B,IAAI,OAAO,EAAE;GACb,IAAI,aAAa,EAAE;AAEnB,OAAI,QAAQ;SACL,IAAI,IAAI,GAAG,MAAM,KAAK,QAAQ,IAAI,KAAK,IAC1C,KAAI,KAAK,GAAG,OAAO,YAAY,KAAK,GAAG,GAAG,MAAM,SAC9C,YAAW,KAAK,KAAK,GAAG;;AAQ7B,cAAW,SACR,EAAE,QAAQ,aACV,OAAO,EAAE;AAEb,UAAO;;EAEV;AAED,QAAO,UAAU;AACjB,QAAO,QAAQ,cAAc"}

package/dist/{tiny-emitter-BqSsRcpg.cjs → tiny-emitter-DB59cw42.js}

@@ -1,25 +1,5 @@
 //#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
 //#endregion
 //#region node_modules/tiny-emitter/index.js
 var require_tiny_emitter = /* @__PURE__ */ __commonJSMin(((exports, module) => {
@@ -65,23 +45,6 @@ var require_tiny_emitter = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports.TinyEmitter = E;
 }));
 //#endregion
-Object.defineProperty(exports, "__commonJSMin", {
-	enumerable: true,
-	get: function() {
-		return __commonJSMin;
-	}
-});
-Object.defineProperty(exports, "__toESM", {
-	enumerable: true,
-	get: function() {
-		return __toESM;
-	}
-});
-Object.defineProperty(exports, "require_tiny_emitter", {
-	enumerable: true,
-	get: function() {
-		return require_tiny_emitter;
-	}
-});
+export { require_tiny_emitter as t };
 
-//# sourceMappingURL=tiny-emitter-BqSsRcpg.cjs.map
+//# sourceMappingURL=tiny-emitter-DB59cw42.js.map

package/dist/{tiny-emitter-D1Sgcrvm.js.map → tiny-emitter-DB59cw42.js.map}

@@ -1 +1 @@
-{"version":3,"file":"tiny-emitter-D1Sgcrvm.js","names":[],"sources":["../node_modules/tiny-emitter/index.js"],"sourcesContent":["function E () {\n  // Keep this empty so it's easier to inherit from\n  // (via https://github.com/lipsmack from https://github.com/scottcorgan/tiny-emitter/issues/3)\n}\n\nE.prototype = {\n  on: function (name, callback, ctx) {\n    var e = this.e || (this.e = {});\n\n    (e[name] || (e[name] = [])).push({\n      fn: callback,\n      ctx: ctx\n    });\n\n    return this;\n  },\n\n  once: function (name, callback, ctx) {\n    var self = this;\n    function listener () {\n      self.off(name, listener);\n      callback.apply(ctx, arguments);\n    };\n\n    listener._ = callback\n    return this.on(name, listener, ctx);\n  },\n\n  emit: function (name) {\n    var data = [].slice.call(arguments, 1);\n    var evtArr = ((this.e || (this.e = {}))[name] || []).slice();\n    var i = 0;\n    var len = evtArr.length;\n\n    for (i; i < len; i++) {\n      evtArr[i].fn.apply(evtArr[i].ctx, data);\n    }\n\n    return this;\n  },\n\n  off: function (name, callback) {\n    var e = this.e || (this.e = {});\n    var evts = e[name];\n    var liveEvents = [];\n\n    if (evts && callback) {\n      for (var i = 0, len = evts.length; i < len; i++) {\n        if (evts[i].fn !== callback && evts[i].fn._ !== callback)\n          liveEvents.push(evts[i]);\n      }\n    }\n\n    // Remove event from queue to prevent memory leak\n    // Suggested by https://github.com/lazd\n    // Ref: https://github.com/scottcorgan/tiny-emitter/commit/c6ebfaa9bc973b33d110a84a307742b7cf94c953#commitcomment-5024910\n\n    (liveEvents.length)\n      ? e[name] = liveEvents\n      : delete e[name];\n\n    return this;\n  }\n};\n\nmodule.exports = E;\nmodule.exports.TinyEmitter = E;\n"],"x_google_ignoreList":[0],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;CAAA,SAAS,IAAK;AAKd,GAAE,YAAY;EACZ,IAAI,SAAU,MAAM,UAAU,KAAK;GACjC,IAAI,IAAI,KAAK,MAAM,KAAK,IAAI,EAAE;AAE9B,IAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,KAAK;IAC/B,IAAI;IACC;IACN,CAAC;AAEF,UAAO;;EAGT,MAAM,SAAU,MAAM,UAAU,KAAK;GACnC,IAAI,OAAO;GACX,SAAS,WAAY;AACnB,SAAK,IAAI,MAAM,SAAS;AACxB,aAAS,MAAM,KAAK,UAAU;;AAGhC,YAAS,IAAI;AACb,UAAO,KAAK,GAAG,MAAM,UAAU,IAAI;;EAGrC,MAAM,SAAU,MAAM;GACpB,IAAI,OAAO,EAAE,CAAC,MAAM,KAAK,WAAW,EAAE;GACtC,IAAI,WAAW,KAAK,MAAM,KAAK,IAAI,EAAE,GAAG,SAAS,EAAE,EAAE,OAAO;GAC5D,IAAI,IAAI;GACR,IAAI,MAAM,OAAO;AAEjB,UAAQ,IAAI,KAAK,IACf,QAAO,GAAG,GAAG,MAAM,OAAO,GAAG,KAAK,KAAK;AAGzC,UAAO;;EAGT,KAAK,SAAU,MAAM,UAAU;GAC7B,IAAI,IAAI,KAAK,MAAM,KAAK,IAAI,EAAE;GAC9B,IAAI,OAAO,EAAE;GACb,IAAI,aAAa,EAAE;AAEnB,OAAI,QAAQ;SACL,IAAI,IAAI,GAAG,MAAM,KAAK,QAAQ,IAAI,KAAK,IAC1C,KAAI,KAAK,GAAG,OAAO,YAAY,KAAK,GAAG,GAAG,MAAM,SAC9C,YAAW,KAAK,KAAK,GAAG;;AAQ7B,cAAW,SACR,EAAE,QAAQ,aACV,OAAO,EAAE;AAEb,UAAO;;EAEV;AAED,QAAO,UAAU;AACjB,QAAO,QAAQ,cAAc"}
+{"version":3,"file":"tiny-emitter-DB59cw42.js","names":[],"sources":["../node_modules/tiny-emitter/index.js"],"sourcesContent":["function E () {\n  // Keep this empty so it's easier to inherit from\n  // (via https://github.com/lipsmack from https://github.com/scottcorgan/tiny-emitter/issues/3)\n}\n\nE.prototype = {\n  on: function (name, callback, ctx) {\n    var e = this.e || (this.e = {});\n\n    (e[name] || (e[name] = [])).push({\n      fn: callback,\n      ctx: ctx\n    });\n\n    return this;\n  },\n\n  once: function (name, callback, ctx) {\n    var self = this;\n    function listener () {\n      self.off(name, listener);\n      callback.apply(ctx, arguments);\n    };\n\n    listener._ = callback\n    return this.on(name, listener, ctx);\n  },\n\n  emit: function (name) {\n    var data = [].slice.call(arguments, 1);\n    var evtArr = ((this.e || (this.e = {}))[name] || []).slice();\n    var i = 0;\n    var len = evtArr.length;\n\n    for (i; i < len; i++) {\n      evtArr[i].fn.apply(evtArr[i].ctx, data);\n    }\n\n    return this;\n  },\n\n  off: function (name, callback) {\n    var e = this.e || (this.e = {});\n    var evts = e[name];\n    var liveEvents = [];\n\n    if (evts && callback) {\n      for (var i = 0, len = evts.length; i < len; i++) {\n        if (evts[i].fn !== callback && evts[i].fn._ !== callback)\n          liveEvents.push(evts[i]);\n      }\n    }\n\n    // Remove event from queue to prevent memory leak\n    // Suggested by https://github.com/lazd\n    // Ref: https://github.com/scottcorgan/tiny-emitter/commit/c6ebfaa9bc973b33d110a84a307742b7cf94c953#commitcomment-5024910\n\n    (liveEvents.length)\n      ? e[name] = liveEvents\n      : delete e[name];\n\n    return this;\n  }\n};\n\nmodule.exports = E;\nmodule.exports.TinyEmitter = E;\n"],"x_google_ignoreList":[0],"mappings":";;;;;CAAA,SAAS,IAAK;AAKd,GAAE,YAAY;EACZ,IAAI,SAAU,MAAM,UAAU,KAAK;GACjC,IAAI,IAAI,KAAK,MAAM,KAAK,IAAI,EAAE;AAE9B,IAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,KAAK;IAC/B,IAAI;IACC;IACN,CAAC;AAEF,UAAO;;EAGT,MAAM,SAAU,MAAM,UAAU,KAAK;GACnC,IAAI,OAAO;GACX,SAAS,WAAY;AACnB,SAAK,IAAI,MAAM,SAAS;AACxB,aAAS,MAAM,KAAK,UAAU;;AAGhC,YAAS,IAAI;AACb,UAAO,KAAK,GAAG,MAAM,UAAU,IAAI;;EAGrC,MAAM,SAAU,MAAM;GACpB,IAAI,OAAO,EAAE,CAAC,MAAM,KAAK,WAAW,EAAE;GACtC,IAAI,WAAW,KAAK,MAAM,KAAK,IAAI,EAAE,GAAG,SAAS,EAAE,EAAE,OAAO;GAC5D,IAAI,IAAI;GACR,IAAI,MAAM,OAAO;AAEjB,UAAQ,IAAI,KAAK,IACf,QAAO,GAAG,GAAG,MAAM,OAAO,GAAG,KAAK,KAAK;AAGzC,UAAO;;EAGT,KAAK,SAAU,MAAM,UAAU;GAC7B,IAAI,IAAI,KAAK,MAAM,KAAK,IAAI,EAAE;GAC9B,IAAI,OAAO,EAAE;GACb,IAAI,aAAa,EAAE;AAEnB,OAAI,QAAQ;SACL,IAAI,IAAI,GAAG,MAAM,KAAK,QAAQ,IAAI,KAAK,IAC1C,KAAI,KAAK,GAAG,OAAO,YAAY,KAAK,GAAG,GAAG,MAAM,SAC9C,YAAW,KAAK,KAAK,GAAG;;AAQ7B,cAAW,SACR,EAAE,QAAQ,aACV,OAAO,EAAE;AAEb,UAAO;;EAEV;AAED,QAAO,UAAU;AACjB,QAAO,QAAQ,cAAc"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nsshunt/stssocketioutils",
-  "version": "2.0.39",
+  "version": "2.0.40",
   "description": "STS Socket.IO Utils",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -48,7 +48,7 @@
   },
   "homepage": "https://github.com/nsshunt/stssocketioutils#readme",
   "devDependencies": {
-    "@nsshunt/stsconfig": "^1.27.57",
+    "@nsshunt/stsconfig": "^1.27.58",
     "@types/detect-node": "^2.0.2",
     "@types/node": "^25.5.2",
     "@typescript-eslint/eslint-plugin": "^8.58.0",
@@ -61,11 +61,10 @@
     "vitest": "^4.1.2"
   },
   "dependencies": {
-    "@nsshunt/stsutils": "^1.19.92",
+    "@nsshunt/stsutils": "^1.19.95",
     "@socket.io/cluster-adapter": "^0.3.0",
     "@socket.io/redis-streams-adapter": "^0.3.1",
     "chalk": "^5.6.2",
-    "detect-node": "^2.1.0",
     "ioredis": "^5.10.1",
     "socket.io": "^4.8.3",
     "socket.io-adapter": "^2.5.6",

package/types/socketIoClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socketIoClient.d.ts","sourceRoot":"","sources":["../src/socketIoClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAK5E,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAE7D,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAA;AAEjG,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,8BAAsB,cAAc,CAAC,oBAAoB,SAAS,8BAA8B,EAAE,oBAAoB,SAAS,8BAA8B,CAAE,SAAQ,WAAW;;gBAUlK,IAAI,EAAE,MAAM;IAKxB,SAAS,KAAK,SAAS,IAAI,MAAM,CAEhC;IAGD,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAK7C,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAK7C,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAI/C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,IAAI,YAAY,IAAI,aAAa,GAAG,SAAS,CAE5C;IAED,IAAI,MAAM,IAAI,UAAU,GAAG,SAAS,CAEnC;IAED,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAEhC;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,IAAI,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAE3C;IAED,IAAI,MAAM,IAAI,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,SAAS,CAE3E;IAED,WAAW,CAAC,OAAO,EAAE,MAAM;IAK3B,aAAa,CAAC,SAAS,EAAE,MAAM;IAK/B,sBAAsB,CAAC,kBAAkB,EAAE,MAAM;IAKjD,UAAU,CAAC,MAAM,EAAE,UAAU;IAK7B,gBAAgB,CAAC,YAAY,EAAE,aAAa;IAK5C,oBAAoB,CAAC,gBAAgB,EAAE,MAAM;IAK7C,WAAW;IAWX,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,IAAI;IAElG,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,IAAI;IAEtG,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAEzD,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIzD,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAEzC,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAElD,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAEhD,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAmKnD"}
+{"version":3,"file":"socketIoClient.d.ts","sourceRoot":"","sources":["../src/socketIoClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE5E,OAAO,EAAE,UAAU,EAAE,aAAa,EAAU,MAAM,mBAAmB,CAAA;AAErE,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAA;AAEjG,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,8BAAsB,cAAc,CAAC,oBAAoB,SAAS,8BAA8B,EAAE,oBAAoB,SAAS,8BAA8B,CAAE,SAAQ,WAAW;;gBAUlK,IAAI,EAAE,MAAM;IAKxB,SAAS,KAAK,SAAS,IAAI,MAAM,CAEhC;IAGD,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAK7C,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAK7C,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAI/C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,IAAI,YAAY,IAAI,aAAa,GAAG,SAAS,CAE5C;IAED,IAAI,MAAM,IAAI,UAAU,GAAG,SAAS,CAEnC;IAED,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAEhC;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,IAAI,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAE3C;IAED,IAAI,MAAM,IAAI,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,SAAS,CAE3E;IAED,WAAW,CAAC,OAAO,EAAE,MAAM;IAK3B,aAAa,CAAC,SAAS,EAAE,MAAM;IAK/B,sBAAsB,CAAC,kBAAkB,EAAE,MAAM;IAKjD,UAAU,CAAC,MAAM,EAAE,UAAU;IAK7B,gBAAgB,CAAC,YAAY,EAAE,aAAa;IAK5C,oBAAoB,CAAC,gBAAgB,EAAE,MAAM;IAK7C,WAAW;IAWX,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,IAAI;IAElG,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,IAAI;IAEtG,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAEzD,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIzD,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAEzC,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAElD,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAEhD,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAmKnD"}