@nsshunt/stssocketioutils 2.0.49 → 2.0.51

package/dist/index.cjs

@@ -46,6 +46,7 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 	#socket;
 	#reconnectTimeout = 2e3;
 	#ackTimeout = 5e3;
+	#reconnectTimeoutVal = void 0;
 	constructor(name) {
 		super();
 		this.#name = name;
@@ -118,7 +119,7 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 		return this;
 	}
 	SetupSocket() {
-		if (!this.#address) throw new Error(`SocketIoClientHelper:SetupSocket(): Error: [address not provided]`);
+		if (!this.#address) throw new Error(`SocketIoClient:SetupSocket(): Error: [address not provided]`);
 		this.#EstablishSocketConnect();
 		return this;
 	}
@@ -128,17 +129,20 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 	EngineReconnect(attempt) {}
 	#EstablishSocketConnect() {
 		if (this.#socket !== void 0) {
-			if (this.#socket.connected === true) this.#socket.disconnect();
-			this.#socket = void 0;
-			if (_nsshunt_stsutils.isNode) setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
-			else setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
+			this.ResetSocket();
+			if (_nsshunt_stsutils.isNode) this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
+			else this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
 			return;
 		}
 		let socketOptions;
 		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]`);
+				if (!this.#address) {
+					const message = `SocketIoClient:#EstablishSocketConnect(): Error: [address not provided when using agentManager]`;
+					this.LogErrorMessage(message);
+					throw new Error(message);
+				}
 				socketOptions.agent = this.#agentManager.GetAgent(this.#address);
 			}
 		} else socketOptions = { transports: ["websocket"] };
@@ -149,30 +153,30 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 		if (this.#socketIoCustomPath && this.#socketIoCustomPath.localeCompare("") !== 0) socketOptions.path = this.#socketIoCustomPath;
 		this.#socket = (0, socket_io_client.io)(this.#address, socketOptions);
 		this.#socket.io.on("error", (err) => {
-			this.LogErrorMessage(`socketDetail.socket.io.on('error'): [${err}] Address: [${this.#address}]`);
+			this.LogErrorMessage(`SocketIoClient.socket.io.on('error'): [${err}] Address: [${this.#address}]`);
 			this.EngineError(err);
 		});
 		this.#socket.io.on("reconnect_error", (err) => {
-			this.LogErrorMessage(`socketDetail.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);
+			this.LogErrorMessage(`SocketIoClient.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);
 			this.EngineReconnectError(err);
 		});
 		this.#socket.on("connect_error", (err) => {
-			this.LogErrorMessage(`socketDetail.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);
+			this.LogErrorMessage(`SocketIoClient.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);
 			this.EngineConnectError(err);
 		});
 		this.#socket.io.on("reconnect", (attempt) => {
-			this.LogErrorMessage(`socketDetail.socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);
+			this.LogErrorMessage(`SocketIoClient:socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);
 			this.EngineReconnect(attempt);
 		});
 		this.#socket.on("connect", () => {
 			if (this.#socket) {
-				this.LogDebugMessage(`Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);
+				this.LogDebugMessage(`SocketIoClient:on("connect"): Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);
 				setTimeout(() => {
 					this.SocketConnect(this.#socket);
 				}, 0);
 				this.SetupSocketEvents(this.#socket);
 			} else {
-				const errorMessage = "Could not get socket object from socket.io, Address: [${socketDetail.address}]";
+				const errorMessage = "SocketIoClient:on(\"connect\"): Could not get socket object from socket.io, Address: [${socketDetail.address}]";
 				this.LogErrorMessage(errorMessage);
 				this.SocketConnectError(new Error(errorMessage));
 			}
@@ -182,33 +186,50 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 			this.SocketDisconnect(reason);
 			switch (reason) {
 				case "io server disconnect":
-					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 (_nsshunt_stsutils.isNode) {
-						if (this.#agentManager) this.#agentManager.ResetAgent();
-						setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
-					} else setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
+					this.LogDebugMessage("SocketIoClient:on(\"disconnect\"): The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.");
+					this.LogDebugMessage("SocketIoClient:on(\"disconnect\"): The connection will be re-established when the server becomes available.");
+					this.ResetSocket();
+					if (_nsshunt_stsutils.isNode) this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
+					else this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
 					break;
 				case "io client disconnect":
-					this.LogDebugMessage("The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.");
-					this.LogDebugMessage("The connection will not be re-established automatically.");
+					this.LogDebugMessage("SocketIoClient:on(\"disconnect\"): The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.");
+					this.LogDebugMessage("SocketIoClient:on(\"disconnect\"): The connection will not be re-established automatically.");
+					this.ResetSocket();
 					break;
 				case "transport close":
 				case "ping timeout":
 				case "transport error":
-					this.LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);
-					this.LogDebugMessage("The connection will be re-established when the server becomes available.");
-					if (this.#socket) this.#socket.disconnect();
-					this.#socket = void 0;
-					if (_nsshunt_stsutils.isNode) {
-						if (this.#agentManager) this.#agentManager?.ResetAgent();
-						setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
-					} else setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
+					this.LogDebugMessage(`SocketIoClient:on("disconnect"): Server unexpectedly disconnected. Reason: [${reason}]`);
+					this.LogDebugMessage("SocketIoClient:on(\"disconnect\"): The connection will be re-established when the server becomes available.");
+					this.ResetSocket();
+					if (_nsshunt_stsutils.isNode) this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
+					else this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
 					break;
 			}
 		});
 	}
+	ResetSocket = () => {
+		try {
+			if (this.#reconnectTimeoutVal !== void 0) {
+				clearTimeout(this.#reconnectTimeoutVal);
+				this.#reconnectTimeoutVal = void 0;
+			}
+			if (this.#socket) {
+				this.#socket.removeAllListeners();
+				this.#socket.io.removeAllListeners();
+				if (this.#socket.connected === true) this.#socket.disconnect();
+				if (_nsshunt_stsutils.isNode) {
+					if (this.#agentManager) this.#agentManager.ResetAgent();
+				}
+				this.#socket = void 0;
+			}
+		} catch (error) {
+			const errorMessage = `SocketIoClient:ResetSocket(): Error: [${error}]`;
+			this.LogErrorMessage(errorMessage);
+			this.SocketConnectError(new Error(errorMessage));
+		}
+	};
 };
 //#endregion
 exports.STSEvent = STSEvent;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["#name","#logger","#reconnectTimeout","#agentManager","#address","#authToken","#socketIoCustomPath","#socket","#ackTimeout","#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    #ackTimeout: number = 5000;\n    //#retries: number = 10;\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    get ackTimeout(): number {\n        return this.#ackTimeout;\n    }\n\n    /*\n    get retries(): number {\n        return this.#retries;\n    }\n    */\n\n    WithAckTimeout(ackTimeout: number) {\n        this.#ackTimeout = ackTimeout;\n        return this;\n    }\n\n    /*\n    WithRetries(retries: number) {\n        this.#retries = retries;\n        return this;\n    }\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        socketOptions.ackTimeout = this.#ackTimeout;\n\n        //@@ for some reason, including this makes the test cases appear to hang ...\n        //socketOptions.retries = this.#retries;\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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"}
+{"version":3,"file":"index.cjs","names":["#name","#logger","#reconnectTimeout","#agentManager","#address","#authToken","#socketIoCustomPath","#socket","#ackTimeout","#EstablishSocketConnect","#reconnectTimeoutVal"],"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    #ackTimeout: number = 5000;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    #reconnectTimeoutVal: any = undefined;\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    get ackTimeout(): number {\n        return this.#ackTimeout;\n    }\n\n    /*\n    get retries(): number {\n        return this.#retries;\n    }\n    */\n\n    WithAckTimeout(ackTimeout: number) {\n        this.#ackTimeout = ackTimeout;\n        return this;\n    }\n\n    /*\n    WithRetries(retries: number) {\n        this.#retries = retries;\n        return this;\n    }\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(`SocketIoClient:SetupSocket(): Error: [address not provided]`);\n        }\n        this.#EstablishSocketConnect();\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            this.ResetSocket();\n            if (isNode) {\n                this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n            } else {\n                this.#reconnectTimeoutVal = 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                    const message = `SocketIoClient:#EstablishSocketConnect(): Error: [address not provided when using agentManager]`;\n                    this.LogErrorMessage(message);\n                    throw new Error(message);\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        socketOptions.ackTimeout = this.#ackTimeout;\n\n        //@@ for some reason, including this makes the test cases appear to hang ...\n        //socketOptions.retries = this.#retries;\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(`SocketIoClient.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(`SocketIoClient.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(`SocketIoClient.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(`SocketIoClient: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(`SocketIoClient:on(\"connect\"): 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            } else {\n                const errorMessage: string = 'SocketIoClient:on(\"connect\"): 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('SocketIoClient:on(\"disconnect\"): The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n                this.LogDebugMessage('SocketIoClient:on(\"disconnect\"): The connection will be re-established when the server becomes available.');\n                this.ResetSocket();\n                if (isNode) {\n                    this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n                } else {\n                    this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n                }\n            }\n                break;\n            case 'io client disconnect' :\n                this.LogDebugMessage('SocketIoClient:on(\"disconnect\"): The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n                this.LogDebugMessage('SocketIoClient:on(\"disconnect\"): The connection will not be re-established automatically.');\n                this.ResetSocket();\n                break;\n            case 'transport close' :\n            case 'ping timeout' :\n            case 'transport error' : {\n                this.LogDebugMessage(`SocketIoClient:on(\"disconnect\"): Server unexpectedly disconnected. Reason: [${reason}]`);\n                this.LogDebugMessage('SocketIoClient:on(\"disconnect\"): The connection will be re-established when the server becomes available.');\n                this.ResetSocket();\n                if (isNode) {\n                    this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n                } else {\n                    this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n                }\n            }\n                break;\n            }\n        });\n    }\n\n    ResetSocket = () => {\n        try {\n            if (this.#reconnectTimeoutVal !== undefined) {\n                clearTimeout(this.#reconnectTimeoutVal);\n                this.#reconnectTimeoutVal = undefined;\n            }\n            if (this.#socket) {\n                this.#socket.removeAllListeners();\n                this.#socket.io.removeAllListeners();\n                if (this.#socket.connected === true) {\n                    this.#socket.disconnect();\n                }\n                if (isNode) {\n                    if (this.#agentManager) {\n                        this.#agentManager.ResetAgent();\n                    }\n                }\n                this.#socket = undefined;\n            }\n        } catch (error) {\n            const errorMessage: string = `SocketIoClient:ResetSocket(): Error: [${error}]`;\n            this.LogErrorMessage(errorMessage);\n            this.SocketConnectError(new Error(errorMessage));\n        }\n    }\n}\n"],"mappings":"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"}

package/dist/index.mjs

@@ -45,6 +45,7 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 	#socket;
 	#reconnectTimeout = 2e3;
 	#ackTimeout = 5e3;
+	#reconnectTimeoutVal = void 0;
 	constructor(name) {
 		super();
 		this.#name = name;
@@ -117,7 +118,7 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 		return this;
 	}
 	SetupSocket() {
-		if (!this.#address) throw new Error(`SocketIoClientHelper:SetupSocket(): Error: [address not provided]`);
+		if (!this.#address) throw new Error(`SocketIoClient:SetupSocket(): Error: [address not provided]`);
 		this.#EstablishSocketConnect();
 		return this;
 	}
@@ -127,17 +128,20 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 	EngineReconnect(attempt) {}
 	#EstablishSocketConnect() {
 		if (this.#socket !== void 0) {
-			if (this.#socket.connected === true) this.#socket.disconnect();
-			this.#socket = void 0;
-			if (isNode) setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
-			else setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
+			this.ResetSocket();
+			if (isNode) this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
+			else this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
 			return;
 		}
 		let socketOptions;
 		if (isNode) {
 			socketOptions = { transports: ["websocket"] };
 			if (this.#agentManager) {
-				if (!this.#address) throw new Error(`SocketIoClient:SetupSocket(): Error: [address not provided when using agentManager]`);
+				if (!this.#address) {
+					const message = `SocketIoClient:#EstablishSocketConnect(): Error: [address not provided when using agentManager]`;
+					this.LogErrorMessage(message);
+					throw new Error(message);
+				}
 				socketOptions.agent = this.#agentManager.GetAgent(this.#address);
 			}
 		} else socketOptions = { transports: ["websocket"] };
@@ -148,30 +152,30 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 		if (this.#socketIoCustomPath && this.#socketIoCustomPath.localeCompare("") !== 0) socketOptions.path = this.#socketIoCustomPath;
 		this.#socket = io(this.#address, socketOptions);
 		this.#socket.io.on("error", (err) => {
-			this.LogErrorMessage(`socketDetail.socket.io.on('error'): [${err}] Address: [${this.#address}]`);
+			this.LogErrorMessage(`SocketIoClient.socket.io.on('error'): [${err}] Address: [${this.#address}]`);
 			this.EngineError(err);
 		});
 		this.#socket.io.on("reconnect_error", (err) => {
-			this.LogErrorMessage(`socketDetail.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);
+			this.LogErrorMessage(`SocketIoClient.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);
 			this.EngineReconnectError(err);
 		});
 		this.#socket.on("connect_error", (err) => {
-			this.LogErrorMessage(`socketDetail.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);
+			this.LogErrorMessage(`SocketIoClient.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);
 			this.EngineConnectError(err);
 		});
 		this.#socket.io.on("reconnect", (attempt) => {
-			this.LogErrorMessage(`socketDetail.socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);
+			this.LogErrorMessage(`SocketIoClient:socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);
 			this.EngineReconnect(attempt);
 		});
 		this.#socket.on("connect", () => {
 			if (this.#socket) {
-				this.LogDebugMessage(`Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);
+				this.LogDebugMessage(`SocketIoClient:on("connect"): Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);
 				setTimeout(() => {
 					this.SocketConnect(this.#socket);
 				}, 0);
 				this.SetupSocketEvents(this.#socket);
 			} else {
-				const errorMessage = "Could not get socket object from socket.io, Address: [${socketDetail.address}]";
+				const errorMessage = "SocketIoClient:on(\"connect\"): Could not get socket object from socket.io, Address: [${socketDetail.address}]";
 				this.LogErrorMessage(errorMessage);
 				this.SocketConnectError(new Error(errorMessage));
 			}
@@ -181,33 +185,50 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 			this.SocketDisconnect(reason);
 			switch (reason) {
 				case "io server disconnect":
-					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 (isNode) {
-						if (this.#agentManager) this.#agentManager.ResetAgent();
-						setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
-					} else setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
+					this.LogDebugMessage("SocketIoClient:on(\"disconnect\"): The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.");
+					this.LogDebugMessage("SocketIoClient:on(\"disconnect\"): The connection will be re-established when the server becomes available.");
+					this.ResetSocket();
+					if (isNode) this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
+					else this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
 					break;
 				case "io client disconnect":
-					this.LogDebugMessage("The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.");
-					this.LogDebugMessage("The connection will not be re-established automatically.");
+					this.LogDebugMessage("SocketIoClient:on(\"disconnect\"): The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.");
+					this.LogDebugMessage("SocketIoClient:on(\"disconnect\"): The connection will not be re-established automatically.");
+					this.ResetSocket();
 					break;
 				case "transport close":
 				case "ping timeout":
 				case "transport error":
-					this.LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);
-					this.LogDebugMessage("The connection will be re-established when the server becomes available.");
-					if (this.#socket) this.#socket.disconnect();
-					this.#socket = void 0;
-					if (isNode) {
-						if (this.#agentManager) this.#agentManager?.ResetAgent();
-						setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
-					} else setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
+					this.LogDebugMessage(`SocketIoClient:on("disconnect"): Server unexpectedly disconnected. Reason: [${reason}]`);
+					this.LogDebugMessage("SocketIoClient:on(\"disconnect\"): The connection will be re-established when the server becomes available.");
+					this.ResetSocket();
+					if (isNode) this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
+					else this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
 					break;
 			}
 		});
 	}
+	ResetSocket = () => {
+		try {
+			if (this.#reconnectTimeoutVal !== void 0) {
+				clearTimeout(this.#reconnectTimeoutVal);
+				this.#reconnectTimeoutVal = void 0;
+			}
+			if (this.#socket) {
+				this.#socket.removeAllListeners();
+				this.#socket.io.removeAllListeners();
+				if (this.#socket.connected === true) this.#socket.disconnect();
+				if (isNode) {
+					if (this.#agentManager) this.#agentManager.ResetAgent();
+				}
+				this.#socket = void 0;
+			}
+		} catch (error) {
+			const errorMessage = `SocketIoClient:ResetSocket(): Error: [${error}]`;
+			this.LogErrorMessage(errorMessage);
+			this.SocketConnectError(new Error(errorMessage));
+		}
+	};
 };
 //#endregion
 export { STSEvent, STSNamespace, STSRoom, SocketIoClient };

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["#name","#logger","#reconnectTimeout","#agentManager","#address","#authToken","#socketIoCustomPath","#socket","#ackTimeout","#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    #ackTimeout: number = 5000;\n    //#retries: number = 10;\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    get ackTimeout(): number {\n        return this.#ackTimeout;\n    }\n\n    /*\n    get retries(): number {\n        return this.#retries;\n    }\n    */\n\n    WithAckTimeout(ackTimeout: number) {\n        this.#ackTimeout = ackTimeout;\n        return this;\n    }\n\n    /*\n    WithRetries(retries: number) {\n        this.#retries = retries;\n        return this;\n    }\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        socketOptions.ackTimeout = this.#ackTimeout;\n\n        //@@ for some reason, including this makes the test cases appear to hang ...\n        //socketOptions.retries = this.#retries;\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":";;;;AA2EA,IAAY,eAAL,yBAAA,cAAA;AACN,cAAA,gBAAa;AACb,cAAA,gBAAa;AACV,cAAA,yBAAsB;;KACzB;AAED,IAAY,UAAL,yBAAA,SAAA;AAEN,SAAA,2BAAwB;AACxB,SAAA,uCAAoC;AAGpC,SAAA,mBAAgB;AAChB,SAAA,uBAAoB;;KACpB;AAED,IAAY,WAAL,yBAAA,UAAA;AAEN,UAAA,uBAAoB;AACpB,UAAA,0BAAuB;AACvB,UAAA,4BAAyB;AAEzB,UAAA,mCAAgC;AAChC,UAAA,kCAA+B;AAG/B,UAAA,cAAW;AACX,UAAA,aAAU;AACV,UAAA,cAAW;AACX,UAAA,eAAY;AACZ,UAAA,kBAAe;AAGf,UAAA,2BAAwB;AACxB,UAAA,4BAAyB;AAGzB,UAAA,mBAAgB;AAGhB,UAAA,aAAU;;KACV;;;;AC5GD,IAAsB,iBAAtB,cAAuK,oBAAA,YAAY;CAC/K;CACA;CACA;CACA;CACA;CACA;CACA;CACA,oBAA4B;CAC5B,cAAsB;CAGtB,YAAY,MAAc;AACtB,SAAO;AACP,QAAA,OAAa;;CAGjB,IAAc,YAAoB;AAC9B,SAAO,kBAAkB,MAAA,KAAW;;CAIxC,gBAA0B,SAAoB;AAC1C,MAAI,MAAA,OAAc,OAAA,OAAa,MAAM,GAAG,KAAK,YAAY,UAAU;;CAIvE,gBAA0B,SAAoB;AAC1C,MAAI,MAAA,OAAc,OAAA,OAAa,MAAM,GAAG,KAAK,YAAY,UAAU;;CAIvE,kBAA4B,SAAoB;AAC5C,MAAI,MAAA,OAAc,OAAA,OAAa,KAAK,GAAG,KAAK,YAAY,UAAU;;CAGtE,IAAI,OAAe;AACf,SAAO,MAAA;;CAGX,IAAI,mBAA2B;AAC3B,SAAO,MAAA;;CAGX,IAAI,eAA0C;AAC1C,SAAO,MAAA;;CAGX,IAAI,SAAiC;AACjC,SAAO,MAAA;;CAGX,IAAI,UAA8B;AAC9B,SAAO,MAAA;;CAGX,IAAI,YAAgC;AAChC,SAAO,MAAA;;CAGX,IAAI,qBAAyC;AACzC,SAAO,MAAA;;CAGX,IAAI,SAAyE;AACzE,SAAO,MAAA;;CAGX,IAAI,aAAqB;AACrB,SAAO,MAAA;;CASX,eAAe,YAAoB;AAC/B,QAAA,aAAmB;AACnB,SAAO;;CAUX,YAAY,SAAiB;AACzB,QAAA,UAAgB;AAChB,SAAO;;CAGX,cAAc,WAAmB;AAC7B,QAAA,YAAkB;AAClB,SAAO;;CAGX,uBAAuB,oBAA4B;AAC/C,QAAA,qBAA2B;AAC3B,SAAO;;CAGX,WAAW,QAAoB;AAC3B,QAAA,SAAe;AACf,SAAO;;CAGX,iBAAiB,cAA6B;AAC1C,QAAA,eAAqB;AACrB,SAAO;;CAGX,qBAAqB,kBAA0B;AAC3C,QAAA,mBAAyB;AACzB,SAAO;;CAGX,cAAc;AACV,MAAI,CAAC,MAAA,QACD,OAAM,IAAI,MAAM,oEAAoE;AAGxF,QAAA,wBAA8B;AAE9B,SAAO;;CAcX,YAAsB,OAAoB;CAE1C,qBAA+B,OAAoB;CAEnD,mBAA6B,OAAoB;CAEjD,gBAA0B,SAAuB;CAYjD,0BAAgC;AAC5B,MAAI,MAAA,WAAiB,KAAA,GAAW;AAE5B,OAAI,MAAA,OAAa,cAAc,KAC3B,OAAA,OAAa,YAAY;AAE7B,SAAA,SAAe,KAAA;AACf,OAAI,OACA,kBAAiB,MAAA,wBAA8B,EAAE,MAAA,iBAAuB,CAAC,OAAO;OAEhF,kBAAiB,MAAA,wBAA8B,EAAE,MAAA,iBAAuB;AAE5E;;EAGJ,IAAI;AACJ,MAAI,QAAQ;AAGR,mBAAgB,EACZ,YAAY,CAAC,YAAa,EAC7B;AACD,OAAI,MAAA,cAAoB;AACpB,QAAI,CAAC,MAAA,QACD,OAAM,IAAI,MAAM,sFAAsF;AAG1G,kBAAc,QAAQ,MAAA,aAAmB,SAAS,MAAA,QAAc;;QAGpE,iBAAgB,EACZ,YAAY,CAAC,YAAa,EAC7B;AAGL,gBAAc,aAAa,MAAA;AAO3B,MAAI,MAAA,UACA,eAAc,QAAQ,OAAO;AACzB,MAAG,EACC,OAAO,MAAA,WACV,CAAC;;AAYV,MAAI,MAAA,sBAA4B,MAAA,mBAAyB,cAAc,GAAG,KAAK,EAC3E,eAAc,OAAO,MAAA;AAGzB,QAAA,SAAe,GAAG,MAAA,SAAe,cAAc;AAG/C,QAAA,OAAa,GAAG,GAAG,UAAU,QAAe;AACxC,QAAK,gBAAgB,wCAAwC,IAAI,cAAc,MAAA,QAAc,GAAG;AAChG,QAAK,YAAY,IAAI;IACvB;AAEF,QAAA,OAAa,GAAG,GAAG,oBAAoB,QAAe;AAClD,QAAK,gBAAgB,kDAAkD,IAAI,cAAc,MAAA,QAAc,GAAG;AAC1G,QAAK,qBAAqB,IAAI;IAChC;AAGF,QAAA,OAAa,GAAG,kBAAkB,QAAQ;AACtC,QAAK,gBAAgB,6CAA6C,IAAI,cAAc,MAAA,QAAc,GAAG;AACrG,QAAK,mBAAmB,IAAI;IAC9B;AAEF,QAAA,OAAa,GAAG,GAAG,cAAc,YAAoB;AACjD,QAAK,gBAAgB,oDAAoD,QAAQ,cAAc,MAAA,QAAc,GAAG;AAChH,QAAK,gBAAgB,QAAQ;IAC/B;AAQF,QAAA,OAAa,GAAG,iBAAiB;AAC7B,OAAI,MAAA,QAAc;AACd,SAAK,gBAAgB,YAAY,MAAA,OAAa,GAAG,0BAA0B,MAAA,QAAc,GAAG;AAE5F,qBAAiB;AACb,UAAK,cAAc,MAAA,OAAmE;OACvF,EAAE;AAEL,SAAK,kBAAkB,MAAA,OAAa;UAEjC;IACH,MAAM,eAAuB;AAC7B,SAAK,gBAAgB,aAAa;AAClC,SAAK,mBAAmB,IAAI,MAAM,aAAa,CAAC;;IAEtD;AAGF,QAAA,OAAa,GAAG,eAAe,WAAmB;AAC9C,QAAK,gBAAgB,wBAAwB,OAAO;AACpD,QAAK,iBAAiB,OAAO;AAC7B,WAAQ,QAAR;IACA,KAAK;AAED,UAAK,gBAAgB,wHAAwH;AAC7I,UAAK,gBAAgB,2EAA2E;AAChG,WAAA,SAAe,KAAA;AACf,SAAI,QAAQ;AACR,UAAI,MAAA,aACA,OAAA,aAAmB,YAAY;AAEnC,uBAAiB,MAAA,wBAA8B,EAAE,MAAA,iBAAuB,CAAC,OAAO;WAEhF,kBAAiB,MAAA,wBAA8B,EAAE,MAAA,iBAAuB;AAG5E;IACJ,KAAK;AACD,UAAK,gBAAgB,6HAA6H;AAClJ,UAAK,gBAAgB,2DAA2D;AAEhF;IACJ,KAAK;IACL,KAAK;IACL,KAAK;AACD,UAAK,gBAAgB,8CAA8C,OAAO,GAAG;AAC7E,UAAK,gBAAgB,2EAA2E;AAChG,SAAI,MAAA,OACA,OAAA,OAAa,YAAY;AAE7B,WAAA,SAAe,KAAA;AACf,SAAI,QAAQ;AACR,UAAI,MAAA,aACA,OAAA,cAAoB,YAAY;AAEpC,uBAAiB,MAAA,wBAA8B,EAAE,MAAA,iBAAuB,CAAC,OAAO;WAEhF,kBAAiB,MAAA,wBAA8B,EAAE,MAAA,iBAAuB;AAG5E;;IAEN"}
+{"version":3,"file":"index.mjs","names":["#name","#logger","#reconnectTimeout","#agentManager","#address","#authToken","#socketIoCustomPath","#socket","#ackTimeout","#EstablishSocketConnect","#reconnectTimeoutVal"],"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    #ackTimeout: number = 5000;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    #reconnectTimeoutVal: any = undefined;\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    get ackTimeout(): number {\n        return this.#ackTimeout;\n    }\n\n    /*\n    get retries(): number {\n        return this.#retries;\n    }\n    */\n\n    WithAckTimeout(ackTimeout: number) {\n        this.#ackTimeout = ackTimeout;\n        return this;\n    }\n\n    /*\n    WithRetries(retries: number) {\n        this.#retries = retries;\n        return this;\n    }\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(`SocketIoClient:SetupSocket(): Error: [address not provided]`);\n        }\n        this.#EstablishSocketConnect();\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            this.ResetSocket();\n            if (isNode) {\n                this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n            } else {\n                this.#reconnectTimeoutVal = 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                    const message = `SocketIoClient:#EstablishSocketConnect(): Error: [address not provided when using agentManager]`;\n                    this.LogErrorMessage(message);\n                    throw new Error(message);\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        socketOptions.ackTimeout = this.#ackTimeout;\n\n        //@@ for some reason, including this makes the test cases appear to hang ...\n        //socketOptions.retries = this.#retries;\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(`SocketIoClient.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(`SocketIoClient.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(`SocketIoClient.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(`SocketIoClient: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(`SocketIoClient:on(\"connect\"): 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            } else {\n                const errorMessage: string = 'SocketIoClient:on(\"connect\"): 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('SocketIoClient:on(\"disconnect\"): The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n                this.LogDebugMessage('SocketIoClient:on(\"disconnect\"): The connection will be re-established when the server becomes available.');\n                this.ResetSocket();\n                if (isNode) {\n                    this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n                } else {\n                    this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n                }\n            }\n                break;\n            case 'io client disconnect' :\n                this.LogDebugMessage('SocketIoClient:on(\"disconnect\"): The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n                this.LogDebugMessage('SocketIoClient:on(\"disconnect\"): The connection will not be re-established automatically.');\n                this.ResetSocket();\n                break;\n            case 'transport close' :\n            case 'ping timeout' :\n            case 'transport error' : {\n                this.LogDebugMessage(`SocketIoClient:on(\"disconnect\"): Server unexpectedly disconnected. Reason: [${reason}]`);\n                this.LogDebugMessage('SocketIoClient:on(\"disconnect\"): The connection will be re-established when the server becomes available.');\n                this.ResetSocket();\n                if (isNode) {\n                    this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n                } else {\n                    this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n                }\n            }\n                break;\n            }\n        });\n    }\n\n    ResetSocket = () => {\n        try {\n            if (this.#reconnectTimeoutVal !== undefined) {\n                clearTimeout(this.#reconnectTimeoutVal);\n                this.#reconnectTimeoutVal = undefined;\n            }\n            if (this.#socket) {\n                this.#socket.removeAllListeners();\n                this.#socket.io.removeAllListeners();\n                if (this.#socket.connected === true) {\n                    this.#socket.disconnect();\n                }\n                if (isNode) {\n                    if (this.#agentManager) {\n                        this.#agentManager.ResetAgent();\n                    }\n                }\n                this.#socket = undefined;\n            }\n        } catch (error) {\n            const errorMessage: string = `SocketIoClient:ResetSocket(): Error: [${error}]`;\n            this.LogErrorMessage(errorMessage);\n            this.SocketConnectError(new Error(errorMessage));\n        }\n    }\n}\n"],"mappings":"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"}

package/dist/node.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"node.cjs","names":[],"sources":["../src/socketIoServer.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */  // --> OFF\nimport { ISTSLogger, JSONObject, Sleep } from '@nsshunt/stsutils'\n\nimport { Server, Namespace, Socket, ServerOptions } from \"socket.io\";\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, STSServerSocket, \n    InterServerEvents } from './commonTypes.js'\n\n//import { createClient, RedisClientType } from 'redis';\nimport { Redis } from 'ioredis';\n\nimport { createAdapter as clusterCreateAdapter } from '@socket.io/cluster-adapter'\nimport { createAdapter } from \"@socket.io/redis-streams-adapter\";\n\nimport { TinyEmitter } from 'tiny-emitter';\n\nexport interface ISocketIoServerOpitons {\n    listenPort?: number\n    ioRedisMessageProcessorUrl?: string\n    wssCustomPath?: string\n    serverClusterMode?: boolean\n}\n    \nexport abstract class SocketIoServer<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> extends TinyEmitter {\n    protected namespace?: string\n    protected socketionamespace?: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n    //protected socketionamespace?: Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>\n    protected logger?: ISTSLogger\n    protected io?: Server<ClientToServerEvents, ServerToClientEvents>;\n    //#redisClient: RedisClientType | Redis | null = null;\n    protected redisClient?: Redis;\n    protected listenPort?: number;\n    protected socketIoCustomPath?: string;\n    protected ioRedisMessageProcessorUrl?: string;\n    protected serverClusterMode?: boolean;\n    protected rooms?: string[];\n    protected serverName: string\n    protected draining: boolean = false;\n    protected attached: boolean = false;\n\n    constructor(serverName: string) { // IProcessBase\n        super();\n        this.serverName = serverName;\n    }\n\n    protected abstract SocketDisconnect(socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void;\n\n    protected abstract SocketDisconnecting(socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void;\n\n    protected abstract SocketError(socket: Socket<ClientToServerEvents, ServerToClientEvents>, error: Error): void;\n\n    protected abstract SocketConnect(socket: Socket<ClientToServerEvents, ServerToClientEvents>): void;\n\n    protected abstract SetupSocketEvents(socket: Socket<ClientToServerEvents, ServerToClientEvents>): void;\n\n    protected get logPrefix(): string {\n        if (this.namespace) {\n            return `SocketIoServer[${this.serverName}:${this.namespace}]: `;\n        } else {\n            return `SocketIoServer[${this.serverName}:<No Namespace>]: `;\n        }\n    }\n\n    protected LogErrorMessage(message: any) {\n        if (this.logger) {\n            this.logger.error(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogDebugMessage(message: any) {\n        if (this.logger) {\n            this.logger.debug(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogInfoMessage(message: any) {\n        if (this.logger) {\n            this.logger.info(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogWarnMessage(message: any) {\n        if (this.logger) {\n            this.logger.warn(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogSillyMessage(message: any) {\n        if (this.logger) {\n            this.logger.silly(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogVerboseMessage(message: any) {\n        if (this.logger) {\n            this.logger.verbose(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogHttpMessage(message: any) {\n        if (this.logger) {\n            this.logger.http(`${this.logPrefix}${message}`);\n        }\n    }\n\n    // https://socket.io/docs/v4/middlewares/\n    // https://socket.io/docs/v4/server-socket-instance/#sockethandshake\n    // https://socket.io/docs/v4/server-socket-instance/#socket-middlewares\n    // Use this middleward to check every incomming connection\n    protected SetupConnectionMiddleware = () => { };\n\n    // Use this middleware to check every packet being received\n    protected SetupMessageMiddleware = (socket: STSServerSocket) => { };\n\n    /*\n    protected GetConfig = (socketIoServeroptions: ISocketIoServerOpitons): Partial<ServerOptions> => {\n        //this.#redisClient = createClient({url: this.#options.ioRedisMessageProcessorUrl});\n        //await this.#redisClient.connect();\n        this.LogDebugMessage(`GetConfig() transports: [ [websocket] ]`);\n        const options: Partial<ServerOptions> = {\n            transports: [ \"websocket\" ], // or [ \"websocket\", \"polling\" ] (to use long-poolling. Note that the order matters)\n        }\n\n        if (socketIoServeroptions.ioRedisMessageProcessorUrl && socketIoServeroptions.ioRedisMessageProcessorUrl !== '') {\n            this.redisClient = new Redis(socketIoServeroptions.ioRedisMessageProcessorUrl);\n            this.LogDebugMessage(`GetConfig() createAdapter(redis): redis url: [${socketIoServeroptions.ioRedisMessageProcessorUrl}]`);\n            options.adapter = createAdapter(this.redisClient) as any;\n        } else if (socketIoServeroptions.serverClusterMode && socketIoServeroptions.serverClusterMode === true) {\n            this.LogDebugMessage(`GetConfig() createAdapter(cluster)`);\n            options.adapter = clusterCreateAdapter() as any;\n        }\n\n        if (socketIoServeroptions.wssCustomPath && socketIoServeroptions.wssCustomPath.localeCompare('') !== 0) {\n            this.LogDebugMessage(`GetConfig() wssCustomPath: [${socketIoServeroptions.wssCustomPath}]`);\n            options.path = socketIoServeroptions.wssCustomPath;\n        }\n\n        return options;\n    }\n    */\n\n    protected SetEngineEvents = () => {\n        if (this.io) {\n            this.io.engine.on(\"connection_error\", (err) => {\n                this.LogWarnMessage(`SetEngineEvents(): connection_error`); // the request object\n                this.LogWarnMessage(err.req); // the request object\n                this.LogWarnMessage(err.code); // the error code, for example 1\n                this.LogWarnMessage(err.message); // the error message, for example \"Session ID unknown\"\n                this.LogWarnMessage(err.context); // some additional error context\n            });\n        }\n    }\n\n    WithLogger = (logger: ISTSLogger) => {\n        this.logger = logger;\n        return this;\n    }\n\n    WithListenPort = (listenPort: number) => {\n        this.listenPort = listenPort;\n        return this;\n    }\n\n    WithSocketIoCustomPath = (socketIoCustomPath: string) => {\n        this.socketIoCustomPath = socketIoCustomPath;\n        return this;\n    }\n\n    WithIoRedisMessageProcessorUrl = (ioRedisMessageProcessorUrl: string) => {\n        this.ioRedisMessageProcessorUrl = ioRedisMessageProcessorUrl;\n        return this;\n    }\n\n    WithClusterMode = (serverClusterMode: boolean) => {\n        this.serverClusterMode = serverClusterMode;\n        return this;\n    }\n\n    WithRooms = (rooms: string[]) => {\n        this.rooms = rooms;\n        return this;\n    }\n\n    WithNamespace = (namespace: string) => {\n        this.namespace = namespace;\n        return this;\n    }\n\n    AttachSocketIoServer = async (server: Server): Promise<SocketIoServer<ClientToServerEvents, ServerToClientEvents>> => {\n        if (!this.io) {\n            this.LogInfoMessage(`AttachServer(): io = server`);\n            this.io = server;\n\n            this.LogInfoMessage(`AttachServer(): attached = true`);\n            this.attached = true;\n\n            this.LogInfoMessage(`AttachServer(): SetupNamespace()`);\n            this.SetupNamespace();\n        } else {\n            const errorMessage = (this.attached === true ? `AttachServer(): Server already exists (from AttachServer())` : `AttachServer(): Server already exists (from StartServer())`);\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n        return this;\n    }\n\n    StartSocketIoServer = async (): Promise<SocketIoServer<ClientToServerEvents, ServerToClientEvents>> => {\n        //this.#io = require(\"socket.io\")(this.#httpServer, options);\n        if (!this.namespace) {\n            const errorMessage = `StartServer(): Error: [namespace not specified]`;\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n\n        if (!this.io) {\n            if (!this.listenPort) {\n                const errorMessage = `StartServer(): Error: [listenPort not specified]`;\n                this.LogErrorMessage(errorMessage);\n                throw new Error(errorMessage);\n            }\n\n            this.LogDebugMessage(`StartServer(): draining = false`);\n            this.draining = false;\n\n            this.LogDebugMessage(`StartServer(): transports: [ [websocket] ]`);\n            const options: Partial<ServerOptions> = {\n                transports: [ \"websocket\" ], // or [ \"websocket\", \"polling\" ] (to use long-poolling. Note that the order matters)\n            }\n\n            if (this.ioRedisMessageProcessorUrl && this.ioRedisMessageProcessorUrl !== '') {\n                this.redisClient = new Redis(this.ioRedisMessageProcessorUrl);\n                this.LogDebugMessage(`StartServer(): createAdapter(redis): redis url: [${this.ioRedisMessageProcessorUrl}]`);\n                options.adapter = createAdapter(this.redisClient) as any;\n            } else if (this.serverClusterMode && this.serverClusterMode === true) {\n                this.LogDebugMessage(`StartServer(): createAdapter(cluster)`);\n                options.adapter = clusterCreateAdapter() as any;\n            }\n\n            if (this.socketIoCustomPath && this.socketIoCustomPath.localeCompare('') !== 0) {\n                this.LogDebugMessage(`StartServer(): socketIoCustomPath: [${this.socketIoCustomPath}]`);\n                options.path = this.socketIoCustomPath;\n            }\n\n            this.LogDebugMessage(`StartServer(): new Server(): listenPort: [${this.listenPort}]`);\n            this.io = new Server(this.listenPort, options);\n\n            this.LogDebugMessage(`StartServer(): SetEngineEvents()`);\n            this.SetEngineEvents();\n\n            this.LogDebugMessage(`StartServer(): Sleeping ...`);\n            await Sleep(500);\n            this.LogDebugMessage(`StartServer(): Done Sleeping`);\n\n            this.LogInfoMessage(`AttachServer(): attached = false`);\n            this.attached = false;\n\n            this.LogInfoMessage(`StartServer(): SetupNamespace()`);\n            this.SetupNamespace();\n\n        } else {\n            const errorMessage = (this.attached === true ? `StartServer(): Server already exists (from AttachServer())` : `StartServer(): Server already exists (from StartServer())`);\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n        return this;\n    }\n\n    DetachSockerIoServer = async (): Promise<void> => {\n        if (this.io) {\n            if (this.attached === true) {\n                this.LogInfoMessage(`DetachServer(): StopNamespace()`);\n                await this.StopNamespace();\n                this.io = undefined;\n                this.LogInfoMessage(`DetachServer(): attached = false`);\n                this.attached = false;\n            } else {\n                const errorMessage = `DetachServer(): Error: [Server has not been attached. Use StopServer() to stop the socker.io server.]`;\n                this.LogErrorMessage(errorMessage);\n                throw new Error(errorMessage);\n            }\n        } else {\n            const errorMessage = `DetachServer(): Error: [no server exists to DetachServer()]`;\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n    }\n\n    StopSocketIoServer = async () => {\n        if (this.io) {\n            if (this.attached === false) {\n                // We are now draining connections\n                this.LogInfoMessage(`StopServer(): draining = true`);\n                this.draining = true;\n\n                this.LogInfoMessage(`StopServer(): StopNamespace()`);\n                await this.StopNamespace();\n\n                this.LogInfoMessage(`StopServer(): io.of('/').adapter.close()`);\n                await this.io.of('/').adapter.close();\n\n                if (this.redisClient) {\n                    this.LogInfoMessage(`StopServer(): redisClient.disconnect()`);\n                    await this.redisClient.disconnect();\n                    this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Sleeping...)`);\n                    await Sleep(50);\n                    this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Done Sleeping)`);\n                }\n\n                // boot all current connections\n                this.LogInfoMessage(`StopServer(): io.disconnectSockets()`);\n                this.io.disconnectSockets();\n\n                // Stop any future connections, close this server (does not close the underlying http(s) server if io server via that method\n                this.LogInfoMessage(`StopServer(): io.close()`);\n                this.io.close();\n\n                this.LogInfoMessage(`StopServer(): io = undefined`);\n                this.io = undefined;\n            } else {\n                const errorMessage = `StopServer(): Cannot stop an attached server. The server created must handle stop/disconnections. Use StopNamespace() instead.`;\n                this.LogErrorMessage(errorMessage);\n                throw new Error(errorMessage);\n            }\n        } else {\n            const errorMessage = `StopServer(): Error: [no server exists to StopServer()]`;\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n    }\n\n    LeaveRoom = (socket: STSServerSocket, room: string): void => {\n        this.LogDebugMessage(`LeaveRoom(): Leaving room [${room}]`);\n        socket.leave(room);\n    };\n\n    JoinRoom = (socket: STSServerSocket, room: string): void => {\n        this.LogDebugMessage(`JoinRoom(): Socket joining room [${room}], ID: [${socket.id}]`);\n        socket.join(room);\n    };\n\n    protected StopNamespace = async() => {\n        this.LogInfoMessage(`StopServer(): CloseNamespaceAdaptors()`);\n        await this.CloseNamespaceAdaptors();\n\n        this.LogInfoMessage(`StopServer(): DisconnectNamespaceSockets()`);\n        this.DisconnectNamespaceSockets();\n    }\n\n    protected SetupStandardEvents = (socket: STSServerSocket): void => {\n        socket.on('disconnect', (reason: string) => {\n            this.LogDebugMessage(`SetupStandardEvents(): socket disconnect, ID: [${socket.id}], reason: [${reason}]`);\n            this.SocketDisconnect(socket, reason);\n        });\n\n        socket.on('disconnecting', (reason: string) => {\n            this.LogDebugMessage(`SetupStandardEvents(): socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);\n            this.SocketDisconnecting(socket, reason);\n        });\n\n        socket.on('error', (error: Error) => {\n            this.LogDebugMessage(`SetupStandardEvents(): socket error, ID: [${socket.id}], Error: [${error}]`);\n            this.SocketError(socket, error);\n        });\n\n        socket.on(\"__STSdisconnect\", (reason: string) => {\n            this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnect: socket disconnect, ID: [${socket.id}], reason: [${reason}]`);\n        });\n\n        socket.on(\"__STSdisconnecting\", (reason, callBackResult) => {\n            this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnecting: socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);\n            callBackResult(\"__STSdisconnecting accepted by server.\");\n        });\n\n        socket.on('__STSjoinRoom', (rooms: string[]): void => { //@@ names\n            rooms.forEach((room) => {\n                this.LogDebugMessage(`SetupStandardEvents(): __STSjoinRoom: room: [${room}], socket: [${socket.id}]`);\n                this.JoinRoom(socket, room)\n            });\n        });\n\n        socket.on('__STSleaveRoom', (rooms: string[]): void => { //@@ names\n            rooms.forEach((room) => {\n                this.LogDebugMessage(`SetupStandardEvents(): __STSleaveRoom: room: [${room}], socket: [${socket.id}]`);\n                this.LeaveRoom(socket, room);\n            });\n        });\n\n        socket.on('__STSsendToRoom', (rooms: string[], payload: { command: string, payload: JSONObject }): void => {\n            rooms.forEach((room) => {\n                if (this.socketionamespace) {\n                    this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}], Command: [${payload.command}]`);\n                    this.socketionamespace.to(room).emit(payload.command as any, payload);\n                }\n            });\n        });\n\n        socket.on('__STSsendToRoomWithCallback', (room: string, timeout: number, payload: { command: string, payload: JSONObject }, cb: (data: JSONObject) => void): void => {\n            if (this.socketionamespace) {\n                this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);\n                this.socketionamespace.to(room).timeout(timeout).emit(payload.command as any, payload, (err: Error, dataResponse: JSONObject[]) => {\n                    if (err) {\n                        console.error(err);\n                        const errorResponse = {\n                            error: true, \n                            errorName: err.name, \n                            errorMessage: err.message,\n                            //errorCause: err.cause,\n                            //errorStack: err.stack\n                        };\n                        this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`)\n                        cb(errorResponse);\n                    } else {\n                        this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`)\n                        cb(dataResponse);\n                    }\n                });\n            }\n        });\n\n        socket.on('__STSsendToRoomsWithCallback', (rooms: string[], timeout: number, payload: { command: string, payload: JSONObject }, cb: (data: JSONObject) => void): void => {\n            const responses: any[] = [ ];\n\n            const timeoutForComplete = setTimeout(() => {\n                // for this timeout case, sent back the error response and the responses we have received so far ...\n                responses.push({\n                    room: '',\n                    responses: {\n                        error: true,\n                        errorName: 'timeout',\n                        errorMessage: `__STSsendToRoomsWithCallback timeout: [${timeout}] before all responses received`\n                    }\n                });\n                cb(responses);\n            }, timeout).unref();\n\n            rooms.forEach((room) => {\n                if (this.socketionamespace) {\n                    this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);\n                    this.socketionamespace.to(room).timeout(timeout).emit(payload.command as any, payload, (err: Error, dataResponse: JSONObject[]) => {\n                        if (err) {\n                            console.error(err);\n                            const errorResponse = {\n                                error: true, \n                                errorName: err.name, \n                                errorMessage: err.message,\n                                //errorCause: err.cause,\n                                //errorStack: err.stack\n                            };\n                            this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`)\n                            responses.push({\n                                room,\n                                responses: errorResponse\n                            });\n                        } else {\n                            this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`)\n                            responses.push({\n                                room,\n                                responses: dataResponse\n                            });\n                        }\n                        if (responses.length === rooms.length) {\n                            clearTimeout(timeoutForComplete);\n                            this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: All complete, Responses Count: [${responses.length}] Invoke call back(responses)`);\n                            cb(responses);\n                        }\n                    });\n                }\n            });\n        });\n    }\n\n    protected ConnectionDrainingConnectionMiddleware = (): void => {\n        if (this.socketionamespace) {\n            this.socketionamespace.use((socket, next) => {\n                if (this.draining === true) {\n                    next(new Error(`ConnectionDrainingConnectionMiddleware(): Error: [server connections draining (from a server disconnect)]`));\n                } else {\n                    next();\n                }\n            });\n        }\n    }\n   \n    protected SetupNamespace = (): SocketIoServer<ClientToServerEvents, ServerToClientEvents> => {\n        // Create STS Command Centre Client namespace\n        if (this.io) {\n            this.LogDebugMessage(`SetupNamespace(): socketionamespace = io.of('/${this.namespace}/'`);\n            this.socketionamespace = this.io.of(`/${this.namespace}/`);\n\n            this.LogDebugMessage(`SetupNamespace(): ConnectionDrainingConnectionMiddleware()`);\n            this.ConnectionDrainingConnectionMiddleware();\n\n            this.LogDebugMessage(`SetupNamespace(): SetupConnectionMiddleware()`);\n            this.SetupConnectionMiddleware();\n\n            this.socketionamespace.on(\"connection\", socket => {\n                this.LogDebugMessage(`SetupNamespace(): Socket connected, ID: [${socket.id}]`);\n                this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (auth): [${JSON.stringify(socket.handshake.auth)}]`);\n                this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (host): [${JSON.stringify(socket.handshake.headers.host)}]`);\n                this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (url): [${JSON.stringify(socket.handshake.url)}]`);\n                this.LogDebugMessage(`SetupNamespace(): Authentication Handshake: [${JSON.stringify(socket.handshake)}]`);\n\n                this.LogDebugMessage(`SetupNamespace(): SetupMessageMiddleware(): Socket: [${socket.id}]`);\n                this.SetupMessageMiddleware(socket);\n\n                if (this.rooms && this.rooms.length > 0) {\n                    this.rooms.map((room) => {\n                        this.LogDebugMessage(`SetupNamespace(): Joining Room: [${room}], Socket: [${socket.id}]`);\n                        this.JoinRoom(socket, room);\n                    });\n                }\n\n                this.LogDebugMessage(`SetupNamespace(): SetupStandardEvents: Socket: [${socket.id}]`);\n                this.SetupStandardEvents(socket);\n\n                setTimeout(() => {\n                    this.LogDebugMessage(`SetupNamespace(): SocketConnectCallBack(): Socket: [${socket.id}]`);\n                    this.SocketConnect(socket);\n                }, 0);\n\n                this.LogDebugMessage(`SetupNamespace(): SocketEventsCallBack(): Socket: [${socket.id}]`);\n                this.SetupSocketEvents(socket);\n            });\n        } else {\n            const errorMessage = `SetupNamespace(): Error: [No server attached]`;\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n\n        return this;\n    }\n\n    protected CloseNamespaceAdaptors = async (): Promise<void> => {\n        if (this.socketionamespace) {\n            this.LogDebugMessage(`CloseNamespaceAdaptors(): this.socketionamespace.adapter.close()`);\n            await this.socketionamespace.adapter.close();\n        }\n    }\n\n    protected DisconnectNamespaceSockets = (): void => {\n        if (this.socketionamespace) {\n            this.LogDebugMessage(`DisconnectNamespaceSockets(): this.socketionamespace.disconnectSockets()`);\n            this.socketionamespace.disconnectSockets();\n            this.socketionamespace = undefined;\n        }\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"node.cjs","names":[],"sources":["../src/socketIoServer.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */  // --> OFF\nimport { ISTSLogger, JSONObject, Sleep } from '@nsshunt/stsutils'\n\nimport { Server, Namespace, Socket, ServerOptions } from \"socket.io\";\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, STSServerSocket, \n    InterServerEvents } from './commonTypes.js'\n\n//import { createClient, RedisClientType } from 'redis';\nimport { Redis } from 'ioredis';\n\nimport { createAdapter as clusterCreateAdapter } from '@socket.io/cluster-adapter'\nimport { createAdapter } from \"@socket.io/redis-streams-adapter\";\n\nimport { TinyEmitter } from 'tiny-emitter';\n\nexport interface ISocketIoServerOpitons {\n    listenPort?: number\n    ioRedisMessageProcessorUrl?: string\n    wssCustomPath?: string\n    serverClusterMode?: boolean\n}\n    \nexport abstract class SocketIoServer<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> extends TinyEmitter {\n    protected namespace?: string\n    protected socketionamespace?: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n    //protected socketionamespace?: Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>\n    protected logger?: ISTSLogger\n    protected io?: Server<ClientToServerEvents, ServerToClientEvents>;\n    //#redisClient: RedisClientType | Redis | null = null;\n    protected redisClient?: Redis;\n    protected listenPort?: number;\n    protected socketIoCustomPath?: string;\n    protected ioRedisMessageProcessorUrl?: string;\n    protected serverClusterMode?: boolean;\n    protected rooms?: string[];\n    protected serverName: string\n    protected draining: boolean = false;\n    protected attached: boolean = false;\n\n    constructor(serverName: string) { // IProcessBase\n        super();\n        this.serverName = serverName;\n    }\n\n    protected abstract SocketDisconnect(socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void;\n\n    protected abstract SocketDisconnecting(socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void;\n\n    protected abstract SocketError(socket: Socket<ClientToServerEvents, ServerToClientEvents>, error: Error): void;\n\n    protected abstract SocketConnect(socket: Socket<ClientToServerEvents, ServerToClientEvents>): void;\n\n    protected abstract SetupSocketEvents(socket: Socket<ClientToServerEvents, ServerToClientEvents>): void;\n\n    protected get logPrefix(): string {\n        if (this.namespace) {\n            return `SocketIoServer[${this.serverName}:${this.namespace}]: `;\n        } else {\n            return `SocketIoServer[${this.serverName}:<No Namespace>]: `;\n        }\n    }\n\n    protected LogErrorMessage(message: any) {\n        if (this.logger) {\n            this.logger.error(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogDebugMessage(message: any) {\n        if (this.logger) {\n            this.logger.debug(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogInfoMessage(message: any) {\n        if (this.logger) {\n            this.logger.info(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogWarnMessage(message: any) {\n        if (this.logger) {\n            this.logger.warn(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogSillyMessage(message: any) {\n        if (this.logger) {\n            this.logger.silly(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogVerboseMessage(message: any) {\n        if (this.logger) {\n            this.logger.verbose(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogHttpMessage(message: any) {\n        if (this.logger) {\n            this.logger.http(`${this.logPrefix}${message}`);\n        }\n    }\n\n    // https://socket.io/docs/v4/middlewares/\n    // https://socket.io/docs/v4/server-socket-instance/#sockethandshake\n    // https://socket.io/docs/v4/server-socket-instance/#socket-middlewares\n    // Use this middleward to check every incomming connection\n    protected SetupConnectionMiddleware = () => { };\n\n    // Use this middleware to check every packet being received\n    protected SetupMessageMiddleware = (socket: STSServerSocket) => { };\n\n    /*\n    protected GetConfig = (socketIoServeroptions: ISocketIoServerOpitons): Partial<ServerOptions> => {\n        //this.#redisClient = createClient({url: this.#options.ioRedisMessageProcessorUrl});\n        //await this.#redisClient.connect();\n        this.LogDebugMessage(`GetConfig() transports: [ [websocket] ]`);\n        const options: Partial<ServerOptions> = {\n            transports: [ \"websocket\" ], // or [ \"websocket\", \"polling\" ] (to use long-poolling. Note that the order matters)\n        }\n\n        if (socketIoServeroptions.ioRedisMessageProcessorUrl && socketIoServeroptions.ioRedisMessageProcessorUrl !== '') {\n            this.redisClient = new Redis(socketIoServeroptions.ioRedisMessageProcessorUrl);\n            this.LogDebugMessage(`GetConfig() createAdapter(redis): redis url: [${socketIoServeroptions.ioRedisMessageProcessorUrl}]`);\n            options.adapter = createAdapter(this.redisClient) as any;\n        } else if (socketIoServeroptions.serverClusterMode && socketIoServeroptions.serverClusterMode === true) {\n            this.LogDebugMessage(`GetConfig() createAdapter(cluster)`);\n            options.adapter = clusterCreateAdapter() as any;\n        }\n\n        if (socketIoServeroptions.wssCustomPath && socketIoServeroptions.wssCustomPath.localeCompare('') !== 0) {\n            this.LogDebugMessage(`GetConfig() wssCustomPath: [${socketIoServeroptions.wssCustomPath}]`);\n            options.path = socketIoServeroptions.wssCustomPath;\n        }\n\n        return options;\n    }\n    */\n\n    protected SetEngineEvents = () => {\n        if (this.io) {\n            this.io.engine.on(\"connection_error\", (err) => {\n                this.LogWarnMessage(`SetEngineEvents(): connection_error`); // the request object\n                this.LogWarnMessage(err.req); // the request object\n                this.LogWarnMessage(err.code); // the error code, for example 1\n                this.LogWarnMessage(err.message); // the error message, for example \"Session ID unknown\"\n                this.LogWarnMessage(err.context); // some additional error context\n            });\n        }\n    }\n\n    WithLogger = (logger: ISTSLogger) => {\n        this.logger = logger;\n        return this;\n    }\n\n    WithListenPort = (listenPort: number) => {\n        this.listenPort = listenPort;\n        return this;\n    }\n\n    WithSocketIoCustomPath = (socketIoCustomPath: string) => {\n        this.socketIoCustomPath = socketIoCustomPath;\n        return this;\n    }\n\n    WithIoRedisMessageProcessorUrl = (ioRedisMessageProcessorUrl: string) => {\n        this.ioRedisMessageProcessorUrl = ioRedisMessageProcessorUrl;\n        return this;\n    }\n\n    WithClusterMode = (serverClusterMode: boolean) => {\n        this.serverClusterMode = serverClusterMode;\n        return this;\n    }\n\n    WithRooms = (rooms: string[]) => {\n        this.rooms = rooms;\n        return this;\n    }\n\n    WithNamespace = (namespace: string) => {\n        this.namespace = namespace;\n        return this;\n    }\n\n    AttachSocketIoServer = async (server: Server): Promise<SocketIoServer<ClientToServerEvents, ServerToClientEvents>> => {\n        if (!this.io) {\n            this.LogInfoMessage(`AttachServer(): io = server`);\n            this.io = server;\n\n            this.LogInfoMessage(`AttachServer(): attached = true`);\n            this.attached = true;\n\n            this.LogInfoMessage(`AttachServer(): SetupNamespace()`);\n            this.SetupNamespace();\n        } else {\n            const errorMessage = (this.attached === true ? `AttachServer(): Server already exists (from AttachServer())` : `AttachServer(): Server already exists (from StartServer())`);\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n        return this;\n    }\n\n    StartSocketIoServer = async (): Promise<SocketIoServer<ClientToServerEvents, ServerToClientEvents>> => {\n        //this.#io = require(\"socket.io\")(this.#httpServer, options);\n        if (!this.namespace) {\n            const errorMessage = `StartServer(): Error: [namespace not specified]`;\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n\n        if (!this.io) {\n            if (!this.listenPort) {\n                const errorMessage = `StartServer(): Error: [listenPort not specified]`;\n                this.LogErrorMessage(errorMessage);\n                throw new Error(errorMessage);\n            }\n\n            this.LogDebugMessage(`StartServer(): draining = false`);\n            this.draining = false;\n\n            this.LogDebugMessage(`StartServer(): transports: [ [websocket] ]`);\n            const options: Partial<ServerOptions> = {\n                transports: [ \"websocket\" ], // or [ \"websocket\", \"polling\" ] (to use long-poolling. Note that the order matters)\n            }\n\n            if (this.ioRedisMessageProcessorUrl && this.ioRedisMessageProcessorUrl !== '') {\n                this.redisClient = new Redis(this.ioRedisMessageProcessorUrl);\n                this.LogDebugMessage(`StartServer(): createAdapter(redis): redis url: [${this.ioRedisMessageProcessorUrl}]`);\n                options.adapter = createAdapter(this.redisClient) as any;\n            } else if (this.serverClusterMode && this.serverClusterMode === true) {\n                this.LogDebugMessage(`StartServer(): createAdapter(cluster)`);\n                options.adapter = clusterCreateAdapter() as any;\n            }\n\n            if (this.socketIoCustomPath && this.socketIoCustomPath.localeCompare('') !== 0) {\n                this.LogDebugMessage(`StartServer(): socketIoCustomPath: [${this.socketIoCustomPath}]`);\n                options.path = this.socketIoCustomPath;\n            }\n\n            this.LogDebugMessage(`StartServer(): new Server(): listenPort: [${this.listenPort}]`);\n            this.io = new Server(this.listenPort, options);\n\n            this.LogDebugMessage(`StartServer(): SetEngineEvents()`);\n            this.SetEngineEvents();\n\n            this.LogDebugMessage(`StartServer(): Sleeping ...`);\n            await Sleep(500);\n            this.LogDebugMessage(`StartServer(): Done Sleeping`);\n\n            this.LogInfoMessage(`AttachServer(): attached = false`);\n            this.attached = false;\n\n            this.LogInfoMessage(`StartServer(): SetupNamespace()`);\n            this.SetupNamespace();\n\n        } else {\n            const errorMessage = (this.attached === true ? `StartServer(): Server already exists (from AttachServer())` : `StartServer(): Server already exists (from StartServer())`);\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n        return this;\n    }\n\n    DetachSockerIoServer = async (): Promise<void> => {\n        if (this.io) {\n            if (this.attached === true) {\n                this.LogInfoMessage(`DetachServer(): StopNamespace()`);\n                await this.StopNamespace();\n                this.io = undefined;\n                this.LogInfoMessage(`DetachServer(): attached = false`);\n                this.attached = false;\n            } else {\n                const errorMessage = `DetachServer(): Error: [Server has not been attached. Use StopServer() to stop the socker.io server.]`;\n                this.LogErrorMessage(errorMessage);\n                throw new Error(errorMessage);\n            }\n        } else {\n            const errorMessage = `DetachServer(): Error: [no server exists to DetachServer()]`;\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n    }\n\n    StopSocketIoServer = async () => {\n        if (this.io) {\n            if (this.attached === false) {\n                // We are now draining connections\n                this.LogInfoMessage(`StopServer(): draining = true`);\n                this.draining = true;\n\n                this.LogInfoMessage(`StopServer(): StopNamespace()`);\n                await this.StopNamespace();\n\n                this.LogInfoMessage(`StopServer(): io.of('/').adapter.close()`);\n                await this.io.of('/').adapter.close();\n\n                if (this.redisClient) {\n                    this.LogInfoMessage(`StopServer(): redisClient.disconnect()`);\n                    await this.redisClient.disconnect();\n                    this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Sleeping...)`);\n                    await Sleep(50);\n                    this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Done Sleeping)`);\n                }\n\n                // boot all current connections\n                this.LogInfoMessage(`StopServer(): io.disconnectSockets()`);\n                this.io.disconnectSockets();\n\n                // Stop any future connections, close this server (does not close the underlying http(s) server if io server via that method\n                this.LogInfoMessage(`StopServer(): io.close()`);\n                this.io.close();\n\n                this.LogInfoMessage(`StopServer(): io = undefined`);\n                this.io = undefined;\n            } else {\n                const errorMessage = `StopServer(): Cannot stop an attached server. The server created must handle stop/disconnections. Use StopNamespace() instead.`;\n                this.LogErrorMessage(errorMessage);\n                throw new Error(errorMessage);\n            }\n        } else {\n            const errorMessage = `StopServer(): Error: [no server exists to StopServer()]`;\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n    }\n\n    LeaveRoom = (socket: STSServerSocket, room: string): void => {\n        this.LogDebugMessage(`LeaveRoom(): Leaving room [${room}]`);\n        socket.leave(room);\n    };\n\n    JoinRoom = (socket: STSServerSocket, room: string): void => {\n        this.LogDebugMessage(`JoinRoom(): Socket joining room [${room}], ID: [${socket.id}]`);\n        socket.join(room);\n    };\n\n    protected StopNamespace = async() => {\n        this.LogInfoMessage(`StopServer(): CloseNamespaceAdaptors()`);\n        await this.CloseNamespaceAdaptors();\n\n        this.LogInfoMessage(`StopServer(): DisconnectNamespaceSockets()`);\n        this.DisconnectNamespaceSockets();\n    }\n\n    protected SetupStandardEvents = (socket: STSServerSocket): void => {\n        socket.on('disconnect', (reason: string) => {\n            this.LogDebugMessage(`SetupStandardEvents(): socket disconnect, ID: [${socket.id}], reason: [${reason}]`);\n            this.SocketDisconnect(socket, reason);\n        });\n\n        socket.on('disconnecting', (reason: string) => {\n            this.LogDebugMessage(`SetupStandardEvents(): socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);\n            this.SocketDisconnecting(socket, reason);\n        });\n\n        socket.on('error', (error: Error) => {\n            this.LogDebugMessage(`SetupStandardEvents(): socket error, ID: [${socket.id}], Error: [${error}]`);\n            this.SocketError(socket, error);\n        });\n\n        socket.on(\"__STSdisconnect\", (reason: string) => {\n            this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnect: socket disconnect, ID: [${socket.id}], reason: [${reason}]`);\n        });\n\n        socket.on(\"__STSdisconnecting\", (reason, callBackResult) => {\n            this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnecting: socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);\n            callBackResult(\"__STSdisconnecting accepted by server.\");\n        });\n\n        socket.on('__STSjoinRoom', (rooms: string[]): void => { //@@ names\n            rooms.forEach((room) => {\n                this.LogDebugMessage(`SetupStandardEvents(): __STSjoinRoom: room: [${room}], socket: [${socket.id}]`);\n                this.JoinRoom(socket, room)\n            });\n        });\n\n        socket.on('__STSleaveRoom', (rooms: string[]): void => { //@@ names\n            rooms.forEach((room) => {\n                this.LogDebugMessage(`SetupStandardEvents(): __STSleaveRoom: room: [${room}], socket: [${socket.id}]`);\n                this.LeaveRoom(socket, room);\n            });\n        });\n\n        socket.on('__STSsendToRoom', (rooms: string[], payload: { command: string, payload: JSONObject }): void => {\n            rooms.forEach((room) => {\n                if (this.socketionamespace) {\n                    this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}], Command: [${payload.command}]`);\n                    this.socketionamespace.to(room).emit(payload.command as any, payload);\n                }\n            });\n        });\n\n        socket.on('__STSsendToRoomWithCallback', (room: string, timeout: number, payload: { command: string, payload: JSONObject }, cb: (data: JSONObject) => void): void => {\n            if (this.socketionamespace) {\n                this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);\n                this.socketionamespace.to(room).timeout(timeout).emit(payload.command as any, payload, (err: Error, dataResponse: JSONObject[]) => {\n                    if (err) {\n                        console.error(err);\n                        const errorResponse = {\n                            error: true, \n                            errorName: err.name, \n                            errorMessage: err.message,\n                            //errorCause: err.cause,\n                            //errorStack: err.stack\n                        };\n                        this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`)\n                        cb(errorResponse);\n                    } else {\n                        this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`)\n                        cb(dataResponse);\n                    }\n                });\n            }\n        });\n\n        socket.on('__STSsendToRoomsWithCallback', (rooms: string[], timeout: number, payload: { command: string, payload: JSONObject }, cb: (data: JSONObject) => void): void => {\n            const responses: any[] = [ ];\n\n            const timeoutForComplete = setTimeout(() => {\n                // for this timeout case, sent back the error response and the responses we have received so far ...\n                responses.push({\n                    room: '',\n                    responses: {\n                        error: true,\n                        errorName: 'timeout',\n                        errorMessage: `__STSsendToRoomsWithCallback timeout: [${timeout}] before all responses received`\n                    }\n                });\n                cb(responses);\n            }, timeout).unref();\n\n            rooms.forEach((room) => {\n                if (this.socketionamespace) {\n                    this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);\n                    this.socketionamespace.to(room).timeout(timeout).emit(payload.command as any, payload, (err: Error, dataResponse: JSONObject[]) => {\n                        if (err) {\n                            console.error(err);\n                            const errorResponse = {\n                                error: true, \n                                errorName: err.name, \n                                errorMessage: err.message,\n                                //errorCause: err.cause,\n                                //errorStack: err.stack\n                            };\n                            this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`)\n                            responses.push({\n                                room,\n                                responses: errorResponse\n                            });\n                        } else {\n                            this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`)\n                            responses.push({\n                                room,\n                                responses: dataResponse\n                            });\n                        }\n                        if (responses.length === rooms.length) {\n                            clearTimeout(timeoutForComplete);\n                            this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: All complete, Responses Count: [${responses.length}] Invoke call back(responses)`);\n                            cb(responses);\n                        }\n                    });\n                }\n            });\n        });\n    }\n\n    protected ConnectionDrainingConnectionMiddleware = (): void => {\n        if (this.socketionamespace) {\n            this.socketionamespace.use((socket, next) => {\n                if (this.draining === true) {\n                    next(new Error(`ConnectionDrainingConnectionMiddleware(): Error: [server connections draining (from a server disconnect)]`));\n                } else {\n                    next();\n                }\n            });\n        }\n    }\n   \n    protected SetupNamespace = (): SocketIoServer<ClientToServerEvents, ServerToClientEvents> => {\n        // Create STS Command Centre Client namespace\n        if (this.io) {\n            this.LogDebugMessage(`SetupNamespace(): socketionamespace = io.of('/${this.namespace}/'`);\n            this.socketionamespace = this.io.of(`/${this.namespace}/`);\n\n            this.LogDebugMessage(`SetupNamespace(): ConnectionDrainingConnectionMiddleware()`);\n            this.ConnectionDrainingConnectionMiddleware();\n\n            this.LogDebugMessage(`SetupNamespace(): SetupConnectionMiddleware()`);\n            this.SetupConnectionMiddleware();\n\n            this.socketionamespace.on(\"connection\", socket => {\n                this.LogDebugMessage(`SetupNamespace(): Socket connected, ID: [${socket.id}]`);\n                this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (auth): [${JSON.stringify(socket.handshake.auth)}]`);\n                this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (host): [${JSON.stringify(socket.handshake.headers.host)}]`);\n                this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (url): [${JSON.stringify(socket.handshake.url)}]`);\n                this.LogDebugMessage(`SetupNamespace(): Authentication Handshake: [${JSON.stringify(socket.handshake)}]`);\n\n                this.LogDebugMessage(`SetupNamespace(): SetupMessageMiddleware(): Socket: [${socket.id}]`);\n                this.SetupMessageMiddleware(socket);\n\n                if (this.rooms && this.rooms.length > 0) {\n                    this.rooms.map((room) => {\n                        this.LogDebugMessage(`SetupNamespace(): Joining Room: [${room}], Socket: [${socket.id}]`);\n                        this.JoinRoom(socket, room);\n                    });\n                }\n\n                this.LogDebugMessage(`SetupNamespace(): SetupStandardEvents: Socket: [${socket.id}]`);\n                this.SetupStandardEvents(socket);\n\n                setTimeout(() => {\n                    this.LogDebugMessage(`SetupNamespace(): SocketConnectCallBack(): Socket: [${socket.id}]`);\n                    this.SocketConnect(socket);\n                }, 0);\n\n                this.LogDebugMessage(`SetupNamespace(): SocketEventsCallBack(): Socket: [${socket.id}]`);\n                this.SetupSocketEvents(socket);\n            });\n        } else {\n            const errorMessage = `SetupNamespace(): Error: [No server attached]`;\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n\n        return this;\n    }\n\n    protected CloseNamespaceAdaptors = async (): Promise<void> => {\n        if (this.socketionamespace) {\n            this.LogDebugMessage(`CloseNamespaceAdaptors(): this.socketionamespace.adapter.close()`);\n            await this.socketionamespace.adapter.close();\n        }\n    }\n\n    protected DisconnectNamespaceSockets = (): void => {\n        if (this.socketionamespace) {\n            this.LogDebugMessage(`DisconnectNamespaceSockets(): this.socketionamespace.disconnectSockets()`);\n            this.socketionamespace.disconnectSockets();\n            this.socketionamespace = undefined;\n        }\n    }\n}\n"],"mappings":"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"}

package/dist/node.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"node.mjs","names":[],"sources":["../src/socketIoServer.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */  // --> OFF\nimport { ISTSLogger, JSONObject, Sleep } from '@nsshunt/stsutils'\n\nimport { Server, Namespace, Socket, ServerOptions } from \"socket.io\";\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, STSServerSocket, \n    InterServerEvents } from './commonTypes.js'\n\n//import { createClient, RedisClientType } from 'redis';\nimport { Redis } from 'ioredis';\n\nimport { createAdapter as clusterCreateAdapter } from '@socket.io/cluster-adapter'\nimport { createAdapter } from \"@socket.io/redis-streams-adapter\";\n\nimport { TinyEmitter } from 'tiny-emitter';\n\nexport interface ISocketIoServerOpitons {\n    listenPort?: number\n    ioRedisMessageProcessorUrl?: string\n    wssCustomPath?: string\n    serverClusterMode?: boolean\n}\n    \nexport abstract class SocketIoServer<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> extends TinyEmitter {\n    protected namespace?: string\n    protected socketionamespace?: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n    //protected socketionamespace?: Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>\n    protected logger?: ISTSLogger\n    protected io?: Server<ClientToServerEvents, ServerToClientEvents>;\n    //#redisClient: RedisClientType | Redis | null = null;\n    protected redisClient?: Redis;\n    protected listenPort?: number;\n    protected socketIoCustomPath?: string;\n    protected ioRedisMessageProcessorUrl?: string;\n    protected serverClusterMode?: boolean;\n    protected rooms?: string[];\n    protected serverName: string\n    protected draining: boolean = false;\n    protected attached: boolean = false;\n\n    constructor(serverName: string) { // IProcessBase\n        super();\n        this.serverName = serverName;\n    }\n\n    protected abstract SocketDisconnect(socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void;\n\n    protected abstract SocketDisconnecting(socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void;\n\n    protected abstract SocketError(socket: Socket<ClientToServerEvents, ServerToClientEvents>, error: Error): void;\n\n    protected abstract SocketConnect(socket: Socket<ClientToServerEvents, ServerToClientEvents>): void;\n\n    protected abstract SetupSocketEvents(socket: Socket<ClientToServerEvents, ServerToClientEvents>): void;\n\n    protected get logPrefix(): string {\n        if (this.namespace) {\n            return `SocketIoServer[${this.serverName}:${this.namespace}]: `;\n        } else {\n            return `SocketIoServer[${this.serverName}:<No Namespace>]: `;\n        }\n    }\n\n    protected LogErrorMessage(message: any) {\n        if (this.logger) {\n            this.logger.error(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogDebugMessage(message: any) {\n        if (this.logger) {\n            this.logger.debug(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogInfoMessage(message: any) {\n        if (this.logger) {\n            this.logger.info(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogWarnMessage(message: any) {\n        if (this.logger) {\n            this.logger.warn(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogSillyMessage(message: any) {\n        if (this.logger) {\n            this.logger.silly(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogVerboseMessage(message: any) {\n        if (this.logger) {\n            this.logger.verbose(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogHttpMessage(message: any) {\n        if (this.logger) {\n            this.logger.http(`${this.logPrefix}${message}`);\n        }\n    }\n\n    // https://socket.io/docs/v4/middlewares/\n    // https://socket.io/docs/v4/server-socket-instance/#sockethandshake\n    // https://socket.io/docs/v4/server-socket-instance/#socket-middlewares\n    // Use this middleward to check every incomming connection\n    protected SetupConnectionMiddleware = () => { };\n\n    // Use this middleware to check every packet being received\n    protected SetupMessageMiddleware = (socket: STSServerSocket) => { };\n\n    /*\n    protected GetConfig = (socketIoServeroptions: ISocketIoServerOpitons): Partial<ServerOptions> => {\n        //this.#redisClient = createClient({url: this.#options.ioRedisMessageProcessorUrl});\n        //await this.#redisClient.connect();\n        this.LogDebugMessage(`GetConfig() transports: [ [websocket] ]`);\n        const options: Partial<ServerOptions> = {\n            transports: [ \"websocket\" ], // or [ \"websocket\", \"polling\" ] (to use long-poolling. Note that the order matters)\n        }\n\n        if (socketIoServeroptions.ioRedisMessageProcessorUrl && socketIoServeroptions.ioRedisMessageProcessorUrl !== '') {\n            this.redisClient = new Redis(socketIoServeroptions.ioRedisMessageProcessorUrl);\n            this.LogDebugMessage(`GetConfig() createAdapter(redis): redis url: [${socketIoServeroptions.ioRedisMessageProcessorUrl}]`);\n            options.adapter = createAdapter(this.redisClient) as any;\n        } else if (socketIoServeroptions.serverClusterMode && socketIoServeroptions.serverClusterMode === true) {\n            this.LogDebugMessage(`GetConfig() createAdapter(cluster)`);\n            options.adapter = clusterCreateAdapter() as any;\n        }\n\n        if (socketIoServeroptions.wssCustomPath && socketIoServeroptions.wssCustomPath.localeCompare('') !== 0) {\n            this.LogDebugMessage(`GetConfig() wssCustomPath: [${socketIoServeroptions.wssCustomPath}]`);\n            options.path = socketIoServeroptions.wssCustomPath;\n        }\n\n        return options;\n    }\n    */\n\n    protected SetEngineEvents = () => {\n        if (this.io) {\n            this.io.engine.on(\"connection_error\", (err) => {\n                this.LogWarnMessage(`SetEngineEvents(): connection_error`); // the request object\n                this.LogWarnMessage(err.req); // the request object\n                this.LogWarnMessage(err.code); // the error code, for example 1\n                this.LogWarnMessage(err.message); // the error message, for example \"Session ID unknown\"\n                this.LogWarnMessage(err.context); // some additional error context\n            });\n        }\n    }\n\n    WithLogger = (logger: ISTSLogger) => {\n        this.logger = logger;\n        return this;\n    }\n\n    WithListenPort = (listenPort: number) => {\n        this.listenPort = listenPort;\n        return this;\n    }\n\n    WithSocketIoCustomPath = (socketIoCustomPath: string) => {\n        this.socketIoCustomPath = socketIoCustomPath;\n        return this;\n    }\n\n    WithIoRedisMessageProcessorUrl = (ioRedisMessageProcessorUrl: string) => {\n        this.ioRedisMessageProcessorUrl = ioRedisMessageProcessorUrl;\n        return this;\n    }\n\n    WithClusterMode = (serverClusterMode: boolean) => {\n        this.serverClusterMode = serverClusterMode;\n        return this;\n    }\n\n    WithRooms = (rooms: string[]) => {\n        this.rooms = rooms;\n        return this;\n    }\n\n    WithNamespace = (namespace: string) => {\n        this.namespace = namespace;\n        return this;\n    }\n\n    AttachSocketIoServer = async (server: Server): Promise<SocketIoServer<ClientToServerEvents, ServerToClientEvents>> => {\n        if (!this.io) {\n            this.LogInfoMessage(`AttachServer(): io = server`);\n            this.io = server;\n\n            this.LogInfoMessage(`AttachServer(): attached = true`);\n            this.attached = true;\n\n            this.LogInfoMessage(`AttachServer(): SetupNamespace()`);\n            this.SetupNamespace();\n        } else {\n            const errorMessage = (this.attached === true ? `AttachServer(): Server already exists (from AttachServer())` : `AttachServer(): Server already exists (from StartServer())`);\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n        return this;\n    }\n\n    StartSocketIoServer = async (): Promise<SocketIoServer<ClientToServerEvents, ServerToClientEvents>> => {\n        //this.#io = require(\"socket.io\")(this.#httpServer, options);\n        if (!this.namespace) {\n            const errorMessage = `StartServer(): Error: [namespace not specified]`;\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n\n        if (!this.io) {\n            if (!this.listenPort) {\n                const errorMessage = `StartServer(): Error: [listenPort not specified]`;\n                this.LogErrorMessage(errorMessage);\n                throw new Error(errorMessage);\n            }\n\n            this.LogDebugMessage(`StartServer(): draining = false`);\n            this.draining = false;\n\n            this.LogDebugMessage(`StartServer(): transports: [ [websocket] ]`);\n            const options: Partial<ServerOptions> = {\n                transports: [ \"websocket\" ], // or [ \"websocket\", \"polling\" ] (to use long-poolling. Note that the order matters)\n            }\n\n            if (this.ioRedisMessageProcessorUrl && this.ioRedisMessageProcessorUrl !== '') {\n                this.redisClient = new Redis(this.ioRedisMessageProcessorUrl);\n                this.LogDebugMessage(`StartServer(): createAdapter(redis): redis url: [${this.ioRedisMessageProcessorUrl}]`);\n                options.adapter = createAdapter(this.redisClient) as any;\n            } else if (this.serverClusterMode && this.serverClusterMode === true) {\n                this.LogDebugMessage(`StartServer(): createAdapter(cluster)`);\n                options.adapter = clusterCreateAdapter() as any;\n            }\n\n            if (this.socketIoCustomPath && this.socketIoCustomPath.localeCompare('') !== 0) {\n                this.LogDebugMessage(`StartServer(): socketIoCustomPath: [${this.socketIoCustomPath}]`);\n                options.path = this.socketIoCustomPath;\n            }\n\n            this.LogDebugMessage(`StartServer(): new Server(): listenPort: [${this.listenPort}]`);\n            this.io = new Server(this.listenPort, options);\n\n            this.LogDebugMessage(`StartServer(): SetEngineEvents()`);\n            this.SetEngineEvents();\n\n            this.LogDebugMessage(`StartServer(): Sleeping ...`);\n            await Sleep(500);\n            this.LogDebugMessage(`StartServer(): Done Sleeping`);\n\n            this.LogInfoMessage(`AttachServer(): attached = false`);\n            this.attached = false;\n\n            this.LogInfoMessage(`StartServer(): SetupNamespace()`);\n            this.SetupNamespace();\n\n        } else {\n            const errorMessage = (this.attached === true ? `StartServer(): Server already exists (from AttachServer())` : `StartServer(): Server already exists (from StartServer())`);\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n        return this;\n    }\n\n    DetachSockerIoServer = async (): Promise<void> => {\n        if (this.io) {\n            if (this.attached === true) {\n                this.LogInfoMessage(`DetachServer(): StopNamespace()`);\n                await this.StopNamespace();\n                this.io = undefined;\n                this.LogInfoMessage(`DetachServer(): attached = false`);\n                this.attached = false;\n            } else {\n                const errorMessage = `DetachServer(): Error: [Server has not been attached. Use StopServer() to stop the socker.io server.]`;\n                this.LogErrorMessage(errorMessage);\n                throw new Error(errorMessage);\n            }\n        } else {\n            const errorMessage = `DetachServer(): Error: [no server exists to DetachServer()]`;\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n    }\n\n    StopSocketIoServer = async () => {\n        if (this.io) {\n            if (this.attached === false) {\n                // We are now draining connections\n                this.LogInfoMessage(`StopServer(): draining = true`);\n                this.draining = true;\n\n                this.LogInfoMessage(`StopServer(): StopNamespace()`);\n                await this.StopNamespace();\n\n                this.LogInfoMessage(`StopServer(): io.of('/').adapter.close()`);\n                await this.io.of('/').adapter.close();\n\n                if (this.redisClient) {\n                    this.LogInfoMessage(`StopServer(): redisClient.disconnect()`);\n                    await this.redisClient.disconnect();\n                    this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Sleeping...)`);\n                    await Sleep(50);\n                    this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Done Sleeping)`);\n                }\n\n                // boot all current connections\n                this.LogInfoMessage(`StopServer(): io.disconnectSockets()`);\n                this.io.disconnectSockets();\n\n                // Stop any future connections, close this server (does not close the underlying http(s) server if io server via that method\n                this.LogInfoMessage(`StopServer(): io.close()`);\n                this.io.close();\n\n                this.LogInfoMessage(`StopServer(): io = undefined`);\n                this.io = undefined;\n            } else {\n                const errorMessage = `StopServer(): Cannot stop an attached server. The server created must handle stop/disconnections. Use StopNamespace() instead.`;\n                this.LogErrorMessage(errorMessage);\n                throw new Error(errorMessage);\n            }\n        } else {\n            const errorMessage = `StopServer(): Error: [no server exists to StopServer()]`;\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n    }\n\n    LeaveRoom = (socket: STSServerSocket, room: string): void => {\n        this.LogDebugMessage(`LeaveRoom(): Leaving room [${room}]`);\n        socket.leave(room);\n    };\n\n    JoinRoom = (socket: STSServerSocket, room: string): void => {\n        this.LogDebugMessage(`JoinRoom(): Socket joining room [${room}], ID: [${socket.id}]`);\n        socket.join(room);\n    };\n\n    protected StopNamespace = async() => {\n        this.LogInfoMessage(`StopServer(): CloseNamespaceAdaptors()`);\n        await this.CloseNamespaceAdaptors();\n\n        this.LogInfoMessage(`StopServer(): DisconnectNamespaceSockets()`);\n        this.DisconnectNamespaceSockets();\n    }\n\n    protected SetupStandardEvents = (socket: STSServerSocket): void => {\n        socket.on('disconnect', (reason: string) => {\n            this.LogDebugMessage(`SetupStandardEvents(): socket disconnect, ID: [${socket.id}], reason: [${reason}]`);\n            this.SocketDisconnect(socket, reason);\n        });\n\n        socket.on('disconnecting', (reason: string) => {\n            this.LogDebugMessage(`SetupStandardEvents(): socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);\n            this.SocketDisconnecting(socket, reason);\n        });\n\n        socket.on('error', (error: Error) => {\n            this.LogDebugMessage(`SetupStandardEvents(): socket error, ID: [${socket.id}], Error: [${error}]`);\n            this.SocketError(socket, error);\n        });\n\n        socket.on(\"__STSdisconnect\", (reason: string) => {\n            this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnect: socket disconnect, ID: [${socket.id}], reason: [${reason}]`);\n        });\n\n        socket.on(\"__STSdisconnecting\", (reason, callBackResult) => {\n            this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnecting: socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);\n            callBackResult(\"__STSdisconnecting accepted by server.\");\n        });\n\n        socket.on('__STSjoinRoom', (rooms: string[]): void => { //@@ names\n            rooms.forEach((room) => {\n                this.LogDebugMessage(`SetupStandardEvents(): __STSjoinRoom: room: [${room}], socket: [${socket.id}]`);\n                this.JoinRoom(socket, room)\n            });\n        });\n\n        socket.on('__STSleaveRoom', (rooms: string[]): void => { //@@ names\n            rooms.forEach((room) => {\n                this.LogDebugMessage(`SetupStandardEvents(): __STSleaveRoom: room: [${room}], socket: [${socket.id}]`);\n                this.LeaveRoom(socket, room);\n            });\n        });\n\n        socket.on('__STSsendToRoom', (rooms: string[], payload: { command: string, payload: JSONObject }): void => {\n            rooms.forEach((room) => {\n                if (this.socketionamespace) {\n                    this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}], Command: [${payload.command}]`);\n                    this.socketionamespace.to(room).emit(payload.command as any, payload);\n                }\n            });\n        });\n\n        socket.on('__STSsendToRoomWithCallback', (room: string, timeout: number, payload: { command: string, payload: JSONObject }, cb: (data: JSONObject) => void): void => {\n            if (this.socketionamespace) {\n                this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);\n                this.socketionamespace.to(room).timeout(timeout).emit(payload.command as any, payload, (err: Error, dataResponse: JSONObject[]) => {\n                    if (err) {\n                        console.error(err);\n                        const errorResponse = {\n                            error: true, \n                            errorName: err.name, \n                            errorMessage: err.message,\n                            //errorCause: err.cause,\n                            //errorStack: err.stack\n                        };\n                        this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`)\n                        cb(errorResponse);\n                    } else {\n                        this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`)\n                        cb(dataResponse);\n                    }\n                });\n            }\n        });\n\n        socket.on('__STSsendToRoomsWithCallback', (rooms: string[], timeout: number, payload: { command: string, payload: JSONObject }, cb: (data: JSONObject) => void): void => {\n            const responses: any[] = [ ];\n\n            const timeoutForComplete = setTimeout(() => {\n                // for this timeout case, sent back the error response and the responses we have received so far ...\n                responses.push({\n                    room: '',\n                    responses: {\n                        error: true,\n                        errorName: 'timeout',\n                        errorMessage: `__STSsendToRoomsWithCallback timeout: [${timeout}] before all responses received`\n                    }\n                });\n                cb(responses);\n            }, timeout).unref();\n\n            rooms.forEach((room) => {\n                if (this.socketionamespace) {\n                    this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);\n                    this.socketionamespace.to(room).timeout(timeout).emit(payload.command as any, payload, (err: Error, dataResponse: JSONObject[]) => {\n                        if (err) {\n                            console.error(err);\n                            const errorResponse = {\n                                error: true, \n                                errorName: err.name, \n                                errorMessage: err.message,\n                                //errorCause: err.cause,\n                                //errorStack: err.stack\n                            };\n                            this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`)\n                            responses.push({\n                                room,\n                                responses: errorResponse\n                            });\n                        } else {\n                            this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`)\n                            responses.push({\n                                room,\n                                responses: dataResponse\n                            });\n                        }\n                        if (responses.length === rooms.length) {\n                            clearTimeout(timeoutForComplete);\n                            this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: All complete, Responses Count: [${responses.length}] Invoke call back(responses)`);\n                            cb(responses);\n                        }\n                    });\n                }\n            });\n        });\n    }\n\n    protected ConnectionDrainingConnectionMiddleware = (): void => {\n        if (this.socketionamespace) {\n            this.socketionamespace.use((socket, next) => {\n                if (this.draining === true) {\n                    next(new Error(`ConnectionDrainingConnectionMiddleware(): Error: [server connections draining (from a server disconnect)]`));\n                } else {\n                    next();\n                }\n            });\n        }\n    }\n   \n    protected SetupNamespace = (): SocketIoServer<ClientToServerEvents, ServerToClientEvents> => {\n        // Create STS Command Centre Client namespace\n        if (this.io) {\n            this.LogDebugMessage(`SetupNamespace(): socketionamespace = io.of('/${this.namespace}/'`);\n            this.socketionamespace = this.io.of(`/${this.namespace}/`);\n\n            this.LogDebugMessage(`SetupNamespace(): ConnectionDrainingConnectionMiddleware()`);\n            this.ConnectionDrainingConnectionMiddleware();\n\n            this.LogDebugMessage(`SetupNamespace(): SetupConnectionMiddleware()`);\n            this.SetupConnectionMiddleware();\n\n            this.socketionamespace.on(\"connection\", socket => {\n                this.LogDebugMessage(`SetupNamespace(): Socket connected, ID: [${socket.id}]`);\n                this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (auth): [${JSON.stringify(socket.handshake.auth)}]`);\n                this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (host): [${JSON.stringify(socket.handshake.headers.host)}]`);\n                this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (url): [${JSON.stringify(socket.handshake.url)}]`);\n                this.LogDebugMessage(`SetupNamespace(): Authentication Handshake: [${JSON.stringify(socket.handshake)}]`);\n\n                this.LogDebugMessage(`SetupNamespace(): SetupMessageMiddleware(): Socket: [${socket.id}]`);\n                this.SetupMessageMiddleware(socket);\n\n                if (this.rooms && this.rooms.length > 0) {\n                    this.rooms.map((room) => {\n                        this.LogDebugMessage(`SetupNamespace(): Joining Room: [${room}], Socket: [${socket.id}]`);\n                        this.JoinRoom(socket, room);\n                    });\n                }\n\n                this.LogDebugMessage(`SetupNamespace(): SetupStandardEvents: Socket: [${socket.id}]`);\n                this.SetupStandardEvents(socket);\n\n                setTimeout(() => {\n                    this.LogDebugMessage(`SetupNamespace(): SocketConnectCallBack(): Socket: [${socket.id}]`);\n                    this.SocketConnect(socket);\n                }, 0);\n\n                this.LogDebugMessage(`SetupNamespace(): SocketEventsCallBack(): Socket: [${socket.id}]`);\n                this.SetupSocketEvents(socket);\n            });\n        } else {\n            const errorMessage = `SetupNamespace(): Error: [No server attached]`;\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n\n        return this;\n    }\n\n    protected CloseNamespaceAdaptors = async (): Promise<void> => {\n        if (this.socketionamespace) {\n            this.LogDebugMessage(`CloseNamespaceAdaptors(): this.socketionamespace.adapter.close()`);\n            await this.socketionamespace.adapter.close();\n        }\n    }\n\n    protected DisconnectNamespaceSockets = (): void => {\n        if (this.socketionamespace) {\n            this.LogDebugMessage(`DisconnectNamespaceSockets(): this.socketionamespace.disconnectSockets()`);\n            this.socketionamespace.disconnectSockets();\n            this.socketionamespace = undefined;\n        }\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"node.mjs","names":[],"sources":["../src/socketIoServer.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */  // --> OFF\nimport { ISTSLogger, JSONObject, Sleep } from '@nsshunt/stsutils'\n\nimport { Server, Namespace, Socket, ServerOptions } from \"socket.io\";\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, STSServerSocket, \n    InterServerEvents } from './commonTypes.js'\n\n//import { createClient, RedisClientType } from 'redis';\nimport { Redis } from 'ioredis';\n\nimport { createAdapter as clusterCreateAdapter } from '@socket.io/cluster-adapter'\nimport { createAdapter } from \"@socket.io/redis-streams-adapter\";\n\nimport { TinyEmitter } from 'tiny-emitter';\n\nexport interface ISocketIoServerOpitons {\n    listenPort?: number\n    ioRedisMessageProcessorUrl?: string\n    wssCustomPath?: string\n    serverClusterMode?: boolean\n}\n    \nexport abstract class SocketIoServer<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> extends TinyEmitter {\n    protected namespace?: string\n    protected socketionamespace?: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n    //protected socketionamespace?: Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>\n    protected logger?: ISTSLogger\n    protected io?: Server<ClientToServerEvents, ServerToClientEvents>;\n    //#redisClient: RedisClientType | Redis | null = null;\n    protected redisClient?: Redis;\n    protected listenPort?: number;\n    protected socketIoCustomPath?: string;\n    protected ioRedisMessageProcessorUrl?: string;\n    protected serverClusterMode?: boolean;\n    protected rooms?: string[];\n    protected serverName: string\n    protected draining: boolean = false;\n    protected attached: boolean = false;\n\n    constructor(serverName: string) { // IProcessBase\n        super();\n        this.serverName = serverName;\n    }\n\n    protected abstract SocketDisconnect(socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void;\n\n    protected abstract SocketDisconnecting(socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void;\n\n    protected abstract SocketError(socket: Socket<ClientToServerEvents, ServerToClientEvents>, error: Error): void;\n\n    protected abstract SocketConnect(socket: Socket<ClientToServerEvents, ServerToClientEvents>): void;\n\n    protected abstract SetupSocketEvents(socket: Socket<ClientToServerEvents, ServerToClientEvents>): void;\n\n    protected get logPrefix(): string {\n        if (this.namespace) {\n            return `SocketIoServer[${this.serverName}:${this.namespace}]: `;\n        } else {\n            return `SocketIoServer[${this.serverName}:<No Namespace>]: `;\n        }\n    }\n\n    protected LogErrorMessage(message: any) {\n        if (this.logger) {\n            this.logger.error(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogDebugMessage(message: any) {\n        if (this.logger) {\n            this.logger.debug(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogInfoMessage(message: any) {\n        if (this.logger) {\n            this.logger.info(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogWarnMessage(message: any) {\n        if (this.logger) {\n            this.logger.warn(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogSillyMessage(message: any) {\n        if (this.logger) {\n            this.logger.silly(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogVerboseMessage(message: any) {\n        if (this.logger) {\n            this.logger.verbose(`${this.logPrefix}${message}`);\n        }\n    }\n\n    protected LogHttpMessage(message: any) {\n        if (this.logger) {\n            this.logger.http(`${this.logPrefix}${message}`);\n        }\n    }\n\n    // https://socket.io/docs/v4/middlewares/\n    // https://socket.io/docs/v4/server-socket-instance/#sockethandshake\n    // https://socket.io/docs/v4/server-socket-instance/#socket-middlewares\n    // Use this middleward to check every incomming connection\n    protected SetupConnectionMiddleware = () => { };\n\n    // Use this middleware to check every packet being received\n    protected SetupMessageMiddleware = (socket: STSServerSocket) => { };\n\n    /*\n    protected GetConfig = (socketIoServeroptions: ISocketIoServerOpitons): Partial<ServerOptions> => {\n        //this.#redisClient = createClient({url: this.#options.ioRedisMessageProcessorUrl});\n        //await this.#redisClient.connect();\n        this.LogDebugMessage(`GetConfig() transports: [ [websocket] ]`);\n        const options: Partial<ServerOptions> = {\n            transports: [ \"websocket\" ], // or [ \"websocket\", \"polling\" ] (to use long-poolling. Note that the order matters)\n        }\n\n        if (socketIoServeroptions.ioRedisMessageProcessorUrl && socketIoServeroptions.ioRedisMessageProcessorUrl !== '') {\n            this.redisClient = new Redis(socketIoServeroptions.ioRedisMessageProcessorUrl);\n            this.LogDebugMessage(`GetConfig() createAdapter(redis): redis url: [${socketIoServeroptions.ioRedisMessageProcessorUrl}]`);\n            options.adapter = createAdapter(this.redisClient) as any;\n        } else if (socketIoServeroptions.serverClusterMode && socketIoServeroptions.serverClusterMode === true) {\n            this.LogDebugMessage(`GetConfig() createAdapter(cluster)`);\n            options.adapter = clusterCreateAdapter() as any;\n        }\n\n        if (socketIoServeroptions.wssCustomPath && socketIoServeroptions.wssCustomPath.localeCompare('') !== 0) {\n            this.LogDebugMessage(`GetConfig() wssCustomPath: [${socketIoServeroptions.wssCustomPath}]`);\n            options.path = socketIoServeroptions.wssCustomPath;\n        }\n\n        return options;\n    }\n    */\n\n    protected SetEngineEvents = () => {\n        if (this.io) {\n            this.io.engine.on(\"connection_error\", (err) => {\n                this.LogWarnMessage(`SetEngineEvents(): connection_error`); // the request object\n                this.LogWarnMessage(err.req); // the request object\n                this.LogWarnMessage(err.code); // the error code, for example 1\n                this.LogWarnMessage(err.message); // the error message, for example \"Session ID unknown\"\n                this.LogWarnMessage(err.context); // some additional error context\n            });\n        }\n    }\n\n    WithLogger = (logger: ISTSLogger) => {\n        this.logger = logger;\n        return this;\n    }\n\n    WithListenPort = (listenPort: number) => {\n        this.listenPort = listenPort;\n        return this;\n    }\n\n    WithSocketIoCustomPath = (socketIoCustomPath: string) => {\n        this.socketIoCustomPath = socketIoCustomPath;\n        return this;\n    }\n\n    WithIoRedisMessageProcessorUrl = (ioRedisMessageProcessorUrl: string) => {\n        this.ioRedisMessageProcessorUrl = ioRedisMessageProcessorUrl;\n        return this;\n    }\n\n    WithClusterMode = (serverClusterMode: boolean) => {\n        this.serverClusterMode = serverClusterMode;\n        return this;\n    }\n\n    WithRooms = (rooms: string[]) => {\n        this.rooms = rooms;\n        return this;\n    }\n\n    WithNamespace = (namespace: string) => {\n        this.namespace = namespace;\n        return this;\n    }\n\n    AttachSocketIoServer = async (server: Server): Promise<SocketIoServer<ClientToServerEvents, ServerToClientEvents>> => {\n        if (!this.io) {\n            this.LogInfoMessage(`AttachServer(): io = server`);\n            this.io = server;\n\n            this.LogInfoMessage(`AttachServer(): attached = true`);\n            this.attached = true;\n\n            this.LogInfoMessage(`AttachServer(): SetupNamespace()`);\n            this.SetupNamespace();\n        } else {\n            const errorMessage = (this.attached === true ? `AttachServer(): Server already exists (from AttachServer())` : `AttachServer(): Server already exists (from StartServer())`);\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n        return this;\n    }\n\n    StartSocketIoServer = async (): Promise<SocketIoServer<ClientToServerEvents, ServerToClientEvents>> => {\n        //this.#io = require(\"socket.io\")(this.#httpServer, options);\n        if (!this.namespace) {\n            const errorMessage = `StartServer(): Error: [namespace not specified]`;\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n\n        if (!this.io) {\n            if (!this.listenPort) {\n                const errorMessage = `StartServer(): Error: [listenPort not specified]`;\n                this.LogErrorMessage(errorMessage);\n                throw new Error(errorMessage);\n            }\n\n            this.LogDebugMessage(`StartServer(): draining = false`);\n            this.draining = false;\n\n            this.LogDebugMessage(`StartServer(): transports: [ [websocket] ]`);\n            const options: Partial<ServerOptions> = {\n                transports: [ \"websocket\" ], // or [ \"websocket\", \"polling\" ] (to use long-poolling. Note that the order matters)\n            }\n\n            if (this.ioRedisMessageProcessorUrl && this.ioRedisMessageProcessorUrl !== '') {\n                this.redisClient = new Redis(this.ioRedisMessageProcessorUrl);\n                this.LogDebugMessage(`StartServer(): createAdapter(redis): redis url: [${this.ioRedisMessageProcessorUrl}]`);\n                options.adapter = createAdapter(this.redisClient) as any;\n            } else if (this.serverClusterMode && this.serverClusterMode === true) {\n                this.LogDebugMessage(`StartServer(): createAdapter(cluster)`);\n                options.adapter = clusterCreateAdapter() as any;\n            }\n\n            if (this.socketIoCustomPath && this.socketIoCustomPath.localeCompare('') !== 0) {\n                this.LogDebugMessage(`StartServer(): socketIoCustomPath: [${this.socketIoCustomPath}]`);\n                options.path = this.socketIoCustomPath;\n            }\n\n            this.LogDebugMessage(`StartServer(): new Server(): listenPort: [${this.listenPort}]`);\n            this.io = new Server(this.listenPort, options);\n\n            this.LogDebugMessage(`StartServer(): SetEngineEvents()`);\n            this.SetEngineEvents();\n\n            this.LogDebugMessage(`StartServer(): Sleeping ...`);\n            await Sleep(500);\n            this.LogDebugMessage(`StartServer(): Done Sleeping`);\n\n            this.LogInfoMessage(`AttachServer(): attached = false`);\n            this.attached = false;\n\n            this.LogInfoMessage(`StartServer(): SetupNamespace()`);\n            this.SetupNamespace();\n\n        } else {\n            const errorMessage = (this.attached === true ? `StartServer(): Server already exists (from AttachServer())` : `StartServer(): Server already exists (from StartServer())`);\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n        return this;\n    }\n\n    DetachSockerIoServer = async (): Promise<void> => {\n        if (this.io) {\n            if (this.attached === true) {\n                this.LogInfoMessage(`DetachServer(): StopNamespace()`);\n                await this.StopNamespace();\n                this.io = undefined;\n                this.LogInfoMessage(`DetachServer(): attached = false`);\n                this.attached = false;\n            } else {\n                const errorMessage = `DetachServer(): Error: [Server has not been attached. Use StopServer() to stop the socker.io server.]`;\n                this.LogErrorMessage(errorMessage);\n                throw new Error(errorMessage);\n            }\n        } else {\n            const errorMessage = `DetachServer(): Error: [no server exists to DetachServer()]`;\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n    }\n\n    StopSocketIoServer = async () => {\n        if (this.io) {\n            if (this.attached === false) {\n                // We are now draining connections\n                this.LogInfoMessage(`StopServer(): draining = true`);\n                this.draining = true;\n\n                this.LogInfoMessage(`StopServer(): StopNamespace()`);\n                await this.StopNamespace();\n\n                this.LogInfoMessage(`StopServer(): io.of('/').adapter.close()`);\n                await this.io.of('/').adapter.close();\n\n                if (this.redisClient) {\n                    this.LogInfoMessage(`StopServer(): redisClient.disconnect()`);\n                    await this.redisClient.disconnect();\n                    this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Sleeping...)`);\n                    await Sleep(50);\n                    this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Done Sleeping)`);\n                }\n\n                // boot all current connections\n                this.LogInfoMessage(`StopServer(): io.disconnectSockets()`);\n                this.io.disconnectSockets();\n\n                // Stop any future connections, close this server (does not close the underlying http(s) server if io server via that method\n                this.LogInfoMessage(`StopServer(): io.close()`);\n                this.io.close();\n\n                this.LogInfoMessage(`StopServer(): io = undefined`);\n                this.io = undefined;\n            } else {\n                const errorMessage = `StopServer(): Cannot stop an attached server. The server created must handle stop/disconnections. Use StopNamespace() instead.`;\n                this.LogErrorMessage(errorMessage);\n                throw new Error(errorMessage);\n            }\n        } else {\n            const errorMessage = `StopServer(): Error: [no server exists to StopServer()]`;\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n    }\n\n    LeaveRoom = (socket: STSServerSocket, room: string): void => {\n        this.LogDebugMessage(`LeaveRoom(): Leaving room [${room}]`);\n        socket.leave(room);\n    };\n\n    JoinRoom = (socket: STSServerSocket, room: string): void => {\n        this.LogDebugMessage(`JoinRoom(): Socket joining room [${room}], ID: [${socket.id}]`);\n        socket.join(room);\n    };\n\n    protected StopNamespace = async() => {\n        this.LogInfoMessage(`StopServer(): CloseNamespaceAdaptors()`);\n        await this.CloseNamespaceAdaptors();\n\n        this.LogInfoMessage(`StopServer(): DisconnectNamespaceSockets()`);\n        this.DisconnectNamespaceSockets();\n    }\n\n    protected SetupStandardEvents = (socket: STSServerSocket): void => {\n        socket.on('disconnect', (reason: string) => {\n            this.LogDebugMessage(`SetupStandardEvents(): socket disconnect, ID: [${socket.id}], reason: [${reason}]`);\n            this.SocketDisconnect(socket, reason);\n        });\n\n        socket.on('disconnecting', (reason: string) => {\n            this.LogDebugMessage(`SetupStandardEvents(): socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);\n            this.SocketDisconnecting(socket, reason);\n        });\n\n        socket.on('error', (error: Error) => {\n            this.LogDebugMessage(`SetupStandardEvents(): socket error, ID: [${socket.id}], Error: [${error}]`);\n            this.SocketError(socket, error);\n        });\n\n        socket.on(\"__STSdisconnect\", (reason: string) => {\n            this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnect: socket disconnect, ID: [${socket.id}], reason: [${reason}]`);\n        });\n\n        socket.on(\"__STSdisconnecting\", (reason, callBackResult) => {\n            this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnecting: socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);\n            callBackResult(\"__STSdisconnecting accepted by server.\");\n        });\n\n        socket.on('__STSjoinRoom', (rooms: string[]): void => { //@@ names\n            rooms.forEach((room) => {\n                this.LogDebugMessage(`SetupStandardEvents(): __STSjoinRoom: room: [${room}], socket: [${socket.id}]`);\n                this.JoinRoom(socket, room)\n            });\n        });\n\n        socket.on('__STSleaveRoom', (rooms: string[]): void => { //@@ names\n            rooms.forEach((room) => {\n                this.LogDebugMessage(`SetupStandardEvents(): __STSleaveRoom: room: [${room}], socket: [${socket.id}]`);\n                this.LeaveRoom(socket, room);\n            });\n        });\n\n        socket.on('__STSsendToRoom', (rooms: string[], payload: { command: string, payload: JSONObject }): void => {\n            rooms.forEach((room) => {\n                if (this.socketionamespace) {\n                    this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}], Command: [${payload.command}]`);\n                    this.socketionamespace.to(room).emit(payload.command as any, payload);\n                }\n            });\n        });\n\n        socket.on('__STSsendToRoomWithCallback', (room: string, timeout: number, payload: { command: string, payload: JSONObject }, cb: (data: JSONObject) => void): void => {\n            if (this.socketionamespace) {\n                this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);\n                this.socketionamespace.to(room).timeout(timeout).emit(payload.command as any, payload, (err: Error, dataResponse: JSONObject[]) => {\n                    if (err) {\n                        console.error(err);\n                        const errorResponse = {\n                            error: true, \n                            errorName: err.name, \n                            errorMessage: err.message,\n                            //errorCause: err.cause,\n                            //errorStack: err.stack\n                        };\n                        this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`)\n                        cb(errorResponse);\n                    } else {\n                        this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`)\n                        cb(dataResponse);\n                    }\n                });\n            }\n        });\n\n        socket.on('__STSsendToRoomsWithCallback', (rooms: string[], timeout: number, payload: { command: string, payload: JSONObject }, cb: (data: JSONObject) => void): void => {\n            const responses: any[] = [ ];\n\n            const timeoutForComplete = setTimeout(() => {\n                // for this timeout case, sent back the error response and the responses we have received so far ...\n                responses.push({\n                    room: '',\n                    responses: {\n                        error: true,\n                        errorName: 'timeout',\n                        errorMessage: `__STSsendToRoomsWithCallback timeout: [${timeout}] before all responses received`\n                    }\n                });\n                cb(responses);\n            }, timeout).unref();\n\n            rooms.forEach((room) => {\n                if (this.socketionamespace) {\n                    this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);\n                    this.socketionamespace.to(room).timeout(timeout).emit(payload.command as any, payload, (err: Error, dataResponse: JSONObject[]) => {\n                        if (err) {\n                            console.error(err);\n                            const errorResponse = {\n                                error: true, \n                                errorName: err.name, \n                                errorMessage: err.message,\n                                //errorCause: err.cause,\n                                //errorStack: err.stack\n                            };\n                            this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`)\n                            responses.push({\n                                room,\n                                responses: errorResponse\n                            });\n                        } else {\n                            this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`)\n                            responses.push({\n                                room,\n                                responses: dataResponse\n                            });\n                        }\n                        if (responses.length === rooms.length) {\n                            clearTimeout(timeoutForComplete);\n                            this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: All complete, Responses Count: [${responses.length}] Invoke call back(responses)`);\n                            cb(responses);\n                        }\n                    });\n                }\n            });\n        });\n    }\n\n    protected ConnectionDrainingConnectionMiddleware = (): void => {\n        if (this.socketionamespace) {\n            this.socketionamespace.use((socket, next) => {\n                if (this.draining === true) {\n                    next(new Error(`ConnectionDrainingConnectionMiddleware(): Error: [server connections draining (from a server disconnect)]`));\n                } else {\n                    next();\n                }\n            });\n        }\n    }\n   \n    protected SetupNamespace = (): SocketIoServer<ClientToServerEvents, ServerToClientEvents> => {\n        // Create STS Command Centre Client namespace\n        if (this.io) {\n            this.LogDebugMessage(`SetupNamespace(): socketionamespace = io.of('/${this.namespace}/'`);\n            this.socketionamespace = this.io.of(`/${this.namespace}/`);\n\n            this.LogDebugMessage(`SetupNamespace(): ConnectionDrainingConnectionMiddleware()`);\n            this.ConnectionDrainingConnectionMiddleware();\n\n            this.LogDebugMessage(`SetupNamespace(): SetupConnectionMiddleware()`);\n            this.SetupConnectionMiddleware();\n\n            this.socketionamespace.on(\"connection\", socket => {\n                this.LogDebugMessage(`SetupNamespace(): Socket connected, ID: [${socket.id}]`);\n                this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (auth): [${JSON.stringify(socket.handshake.auth)}]`);\n                this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (host): [${JSON.stringify(socket.handshake.headers.host)}]`);\n                this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (url): [${JSON.stringify(socket.handshake.url)}]`);\n                this.LogDebugMessage(`SetupNamespace(): Authentication Handshake: [${JSON.stringify(socket.handshake)}]`);\n\n                this.LogDebugMessage(`SetupNamespace(): SetupMessageMiddleware(): Socket: [${socket.id}]`);\n                this.SetupMessageMiddleware(socket);\n\n                if (this.rooms && this.rooms.length > 0) {\n                    this.rooms.map((room) => {\n                        this.LogDebugMessage(`SetupNamespace(): Joining Room: [${room}], Socket: [${socket.id}]`);\n                        this.JoinRoom(socket, room);\n                    });\n                }\n\n                this.LogDebugMessage(`SetupNamespace(): SetupStandardEvents: Socket: [${socket.id}]`);\n                this.SetupStandardEvents(socket);\n\n                setTimeout(() => {\n                    this.LogDebugMessage(`SetupNamespace(): SocketConnectCallBack(): Socket: [${socket.id}]`);\n                    this.SocketConnect(socket);\n                }, 0);\n\n                this.LogDebugMessage(`SetupNamespace(): SocketEventsCallBack(): Socket: [${socket.id}]`);\n                this.SetupSocketEvents(socket);\n            });\n        } else {\n            const errorMessage = `SetupNamespace(): Error: [No server attached]`;\n            this.LogErrorMessage(errorMessage);\n            throw new Error(errorMessage);\n        }\n\n        return this;\n    }\n\n    protected CloseNamespaceAdaptors = async (): Promise<void> => {\n        if (this.socketionamespace) {\n            this.LogDebugMessage(`CloseNamespaceAdaptors(): this.socketionamespace.adapter.close()`);\n            await this.socketionamespace.adapter.close();\n        }\n    }\n\n    protected DisconnectNamespaceSockets = (): void => {\n        if (this.socketionamespace) {\n            this.LogDebugMessage(`DisconnectNamespaceSockets(): this.socketionamespace.disconnectSockets()`);\n            this.socketionamespace.disconnectSockets();\n            this.socketionamespace = undefined;\n        }\n    }\n}\n"],"mappings":"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"}

package/dist/tiny-emitter-CVnlbTl1.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"tiny-emitter-CVnlbTl1.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-CVnlbTl1.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,CAGd;CAEA,EAAE,YAAY;EACZ,IAAI,SAAU,MAAM,UAAU,KAAK;GACjC,IAAI,IAAI,KAAK,MAAM,KAAK,IAAI,CAAC;GAE7B,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,IAAI,KAAK;IAC/B,IAAI;IACC;GACP,CAAC;GAED,OAAO;EACT;EAEA,MAAM,SAAU,MAAM,UAAU,KAAK;GACnC,IAAI,OAAO;GACX,SAAS,WAAY;IACnB,KAAK,IAAI,MAAM,QAAQ;IACvB,SAAS,MAAM,KAAK,SAAS;GAC/B;GAEA,SAAS,IAAI;GACb,OAAO,KAAK,GAAG,MAAM,UAAU,GAAG;EACpC;EAEA,MAAM,SAAU,MAAM;GACpB,IAAI,OAAO,CAAC,EAAE,MAAM,KAAK,WAAW,CAAC;GACrC,IAAI,WAAW,KAAK,MAAM,KAAK,IAAI,CAAC,IAAI,SAAS,CAAC,GAAG,MAAM;GAC3D,IAAI,IAAI;GACR,IAAI,MAAM,OAAO;GAEjB,OAAQ,IAAI,KAAK,KACf,OAAO,GAAG,GAAG,MAAM,OAAO,GAAG,KAAK,IAAI;GAGxC,OAAO;EACT;EAEA,KAAK,SAAU,MAAM,UAAU;GAC7B,IAAI,IAAI,KAAK,MAAM,KAAK,IAAI,CAAC;GAC7B,IAAI,OAAO,EAAE;GACb,IAAI,aAAa,CAAC;GAElB,IAAI,QAAQ;SACL,IAAI,IAAI,GAAG,MAAM,KAAK,QAAQ,IAAI,KAAK,KAC1C,IAAI,KAAK,GAAG,OAAO,YAAY,KAAK,GAAG,GAAG,MAAM,UAC9C,WAAW,KAAK,KAAK,EAAE;GAAA;GAQ7B,WAAY,SACR,EAAE,QAAQ,aACV,OAAO,EAAE;GAEb,OAAO;EACT;CACF;CAEA,OAAO,UAAU;CACjB,OAAO,QAAQ,cAAc"}

package/dist/tiny-emitter-DcZ69ZvJ.js.map

@@ -1 +1 @@
-{"version":3,"file":"tiny-emitter-DcZ69ZvJ.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-DcZ69ZvJ.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,CAGd;CAEA,EAAE,YAAY;EACZ,IAAI,SAAU,MAAM,UAAU,KAAK;GACjC,IAAI,IAAI,KAAK,MAAM,KAAK,IAAI,CAAC;GAE7B,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,IAAI,KAAK;IAC/B,IAAI;IACC;GACP,CAAC;GAED,OAAO;EACT;EAEA,MAAM,SAAU,MAAM,UAAU,KAAK;GACnC,IAAI,OAAO;GACX,SAAS,WAAY;IACnB,KAAK,IAAI,MAAM,QAAQ;IACvB,SAAS,MAAM,KAAK,SAAS;GAC/B;GAEA,SAAS,IAAI;GACb,OAAO,KAAK,GAAG,MAAM,UAAU,GAAG;EACpC;EAEA,MAAM,SAAU,MAAM;GACpB,IAAI,OAAO,CAAC,EAAE,MAAM,KAAK,WAAW,CAAC;GACrC,IAAI,WAAW,KAAK,MAAM,KAAK,IAAI,CAAC,IAAI,SAAS,CAAC,GAAG,MAAM;GAC3D,IAAI,IAAI;GACR,IAAI,MAAM,OAAO;GAEjB,OAAQ,IAAI,KAAK,KACf,OAAO,GAAG,GAAG,MAAM,OAAO,GAAG,KAAK,IAAI;GAGxC,OAAO;EACT;EAEA,KAAK,SAAU,MAAM,UAAU;GAC7B,IAAI,IAAI,KAAK,MAAM,KAAK,IAAI,CAAC;GAC7B,IAAI,OAAO,EAAE;GACb,IAAI,aAAa,CAAC;GAElB,IAAI,QAAQ;SACL,IAAI,IAAI,GAAG,MAAM,KAAK,QAAQ,IAAI,KAAK,KAC1C,IAAI,KAAK,GAAG,OAAO,YAAY,KAAK,GAAG,GAAG,MAAM,UAC9C,WAAW,KAAK,KAAK,EAAE;GAAA;GAQ7B,WAAY,SACR,EAAE,QAAQ,aACV,OAAO,EAAE;GAEb,OAAO;EACT;CACF;CAEA,OAAO,UAAU;CACjB,OAAO,QAAQ,cAAc"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nsshunt/stssocketioutils",
-  "version": "2.0.49",
+  "version": "2.0.51",
   "description": "STS Socket.IO Utils",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -48,19 +48,19 @@
   },
   "homepage": "https://github.com/nsshunt/stssocketioutils#readme",
   "devDependencies": {
-    "@nsshunt/stsconfig": "^1.27.66",
-    "@types/node": "^25.6.0",
-    "@typescript-eslint/eslint-plugin": "^8.59.2",
-    "@typescript-eslint/parser": "^8.59.2",
-    "eslint": "^10.3.0",
+    "@nsshunt/stsconfig": "^1.27.67",
+    "@types/node": "^25.8.0",
+    "@typescript-eslint/eslint-plugin": "^8.59.3",
+    "@typescript-eslint/parser": "^8.59.3",
+    "eslint": "^10.4.0",
     "globals": "^17.6.0",
     "testcontainers": "^11.14.0",
     "typescript": "^6.0.3",
-    "vite": "^8.0.10",
-    "vitest": "^4.1.5"
+    "vite": "^8.0.13",
+    "vitest": "^4.1.6"
   },
   "dependencies": {
-    "@nsshunt/stsutils": "^1.19.104",
+    "@nsshunt/stsutils": "^1.19.105",
     "@socket.io/cluster-adapter": "^0.3.0",
     "@socket.io/redis-streams-adapter": "^0.3.1",
     "chalk": "^5.6.2",

package/types/socketIoClient.d.ts

@@ -34,5 +34,6 @@ export declare abstract class SocketIoClient<ServerToClientEvents extends STSDef
     protected EngineReconnectError(error: Error): void;
     protected EngineConnectError(error: Error): void;
     protected EngineReconnect(attempt: number): void;
+    ResetSocket: () => void;
 }
 //# sourceMappingURL=socketIoClient.d.ts.map

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;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;;gBAYlK,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,IAAI,UAAU,IAAI,MAAM,CAEvB;IAQD,cAAc,CAAC,UAAU,EAAE,MAAM;IAYjC,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;CAwKnD"}
+{"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;;gBAalK,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,IAAI,UAAU,IAAI,MAAM,CAEvB;IAQD,cAAc,CAAC,UAAU,EAAE,MAAM;IAYjC,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;IASX,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;IA8JhD,WAAW,aAwBV;CACJ"}