@nsshunt/stssocketioutils 1.1.21 → 1.1.22

package/dist/stssocketioutils.mjs

@@ -299,7 +299,11 @@ class SocketIoServerHelper {
     __privateSet(this, _socketIoServerHelperOptions, options);
   }
   LogMessage(namespace, message) {
-    __privateGet(this, _socketIoServerHelperOptions).logger.debug(`${namespace.namespace}: ${message}`);
+    if (namespace) {
+      __privateGet(this, _socketIoServerHelperOptions).logger.debug(`${namespace.namespace}: ${message}`);
+    } else {
+      __privateGet(this, _socketIoServerHelperOptions).logger.debug(`${message}`);
+    }
   }
   SetupEvent(event, eventCb) {
     return this;

package/dist/stssocketioutils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"stssocketioutils.mjs","sources":["../src/commonTypes.ts","../node_modules/detect-node/index.esm.js","../src/socketIoClientHelper.ts","../src/socketIoServerHelper.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     \n\t__STSsendToRoom: (rooms: string[], payload: { command: string, payload: any }) => 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 interface ISocketIoServerHelperOptions {\n    logger: ISTSLogger\n}\n\nexport type ServerEventCb = (socket: any, data: any) => void\n\nexport interface ServerSocketEvent {\n\tserverEventName: string,\n\tserverEventCb: ServerEventCb\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\nexport interface ISocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents>\n{\n    LogMessage: (namespace: STSSocketIONamespace, message: string) => void\n    LeaveRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void\n    JoinRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void\n    SetupNamespace: (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, \n        /* serverSocketEvents: ServerSocketEvent[], */\n        socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null,\n        socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null\n        ) => Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>\n    GetSTSSocketIONamespace: (namespace: any) => STSSocketIONamespace\n    GetSTSSocketIONamespaces: () => STSSocketIONamespaces\n    DisconnectSockets: () => void\n    SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\n    CloseAdaptors: () => Promise<void>\n}\n","// Only Node.JS has a process variable that is of [[Class]] process\nexport default Object.prototype.toString.call(typeof process !== 'undefined' ? process : 0) === '[object process]';\n","import { io, SocketOptions, ManagerOptions, Socket } from 'socket.io-client'\n\nimport isNode from 'detect-node';\n\nimport { ISTSLogger, AgentManager } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes'\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type EventCb = (socket: any, data: any) => void\n\n/*\nSocket.io - Reserved events\nOn each side, the following events are reserved and should not be used as event names by your application:\nconnect\nconnect_error\ndisconnect\ndisconnecting\nnewListener\nremoveListener\n*/\n\n/*\nexport interface EventsMap { // From the socket.io library - was not declared as external\n    // eslint-disable-next-line  @typescript-eslint/no-explicit-any\n    [event: string]: any;\n}\n*/\n\nexport interface ISocketDetail {\n\tname: string,\n\taddress: string,\n     \n\tsocket: Socket | null\n    errorCallBack: (error: Error) => void\n}\n\nexport interface ISocketIoClientHelperOptions\n{\n    url?: string\n    agentManager?: AgentManager\n    logger?: ISTSLogger\n}\n\nexport class SocketIoClientHelper<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents>\n{\n    #options: ISocketIoClientHelperOptions\n    #sockets: Record<string, ISocketDetail> = { }\n\n    constructor(options: ISocketIoClientHelperOptions) {\n        this.#options = options;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    #LogDebugMessage(message: any): void {\n        if (this.#options.logger) this.#options.logger.debug(message);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    #LogErrorMessage(message: any): void {\n        if (this.#options.logger) this.#options.logger.error(message);\n    }\n\n    get sockets(): Record<string, ISocketDetail> {\n        return this.#sockets;\n    }\n    \n    SetupClientSideSocket(name: string, address: string, socketIoCustomPath: string,\n        onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n        socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n        errorCallBack: ((error: Error) => void)\n    ): Socket<ServerToClientEvents, ClientToServerEvents> {\n        this.sockets[name] = {\n            name,\n            address,\n            socket: null,\n            errorCallBack\n        }\n        this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack);\n        return this.sockets[name].socket as Socket<ServerToClientEvents, ClientToServerEvents>\n    }\n\n    GetSocket(name: string): Socket<ServerToClientEvents, ClientToServerEvents> {\n        return this.sockets[name].socket as Socket<ServerToClientEvents, ClientToServerEvents>\n    }\n\n    GetSocketDetail(name: string): ISocketDetail {\n        return this.sockets[name];\n    }\n\n    #EstablishSocketConnect(name: string, socketIoCustomPath: string, onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n        socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null): void\n    {\n        const socketDetail: ISocketDetail = this.sockets[name];\n\n        if (socketDetail.socket !== null) {\n            // We already have a socket object (may or may not be connected)\n            if (socketDetail.socket.connected === true) {\n                socketDetail.socket.disconnect();\n            }\n            socketDetail.socket = null;\n            if (isNode) {\n                setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n            } else {\n                setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100); //@@ 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.#options.agentManager) {\n                socketOptions.agent = this.#options.agentManager.GetAgent(socketDetail.address);\n            }\n        } else {\n            socketOptions = {\n                transports: [\"websocket\" ]\n            }\n        }\n\n        if (socketIoCustomPath && socketIoCustomPath.localeCompare('') !== 0) {\n            socketOptions.path = socketIoCustomPath;\n        }\n\n        socketDetail.socket = io(socketDetail.address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n        // Manager errors\n        socketDetail.socket.io.on('error', (err: Error) => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.io.on('error'): [${err}]`);\n        });\n\n        socketDetail.socket.io.on('reconnect_error', (err: Error) => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.io.on('reconnect_error'): [${err}]`);\n        });\n\n        socketDetail.socket.io.on('reconnect', (attempt: number) => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.io.on('reconnect'): Number: [${attempt}]`);\n        });\n\n        // suppress automatic console logging by not letting it bubble up\n        socketDetail.socket.on(\"connect_error\", (err) => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.on('connect_error'): [${err}]`);\n        });\n\n        socketDetail.socket.on(\"connect_timeout\", () => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.on('connect_timeout')`);\n        });        \n\n        socketDetail.socket.on(\"connect\", () => {\n            if (socketDetail.socket) {\n                this.#LogDebugMessage(`SocketIoClientHelper(): Socket: [${socketDetail.socket.id}]: connected`);\n\n                if (onConnectCallBack) {\n                    setTimeout(() => {\n                        onConnectCallBack(socketDetail.socket as Socket<ServerToClientEvents, ClientToServerEvents>);\n                    }, 0);\n                }\n\n                if (socketEventsCallBack) {\n                    socketEventsCallBack(socketDetail.socket);\n                }\n\n            } else {\n                const errorMessage: string = 'SocketIoClientHelper(): Could not get socket object from socket.io';\n                this.#LogErrorMessage(errorMessage);\n                socketDetail.errorCallBack(new Error(errorMessage));\n            }\n        })\n\n        // https://socket.io/docs/v4/client-socket-instance/#disconnect\n        socketDetail.socket.on(\"disconnect\", (reason: string) => {\n            this.#LogDebugMessage('SocketIoClientHelper(): socket disconnect: ' + reason);\n            switch (reason) {\n            case 'io server disconnect' : {\n                // The server disconnect using disconnectSockets (i.e. normal safe shutdown)\n                this.#LogDebugMessage('SocketIoClientHelper(): The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n                this.#LogDebugMessage('SocketIoClientHelper(): The connection will be re-established when the server becomes available.');\n                const socketDetail: ISocketDetail = this.sockets[name];\n                socketDetail.socket = null;\n                if (isNode) {\n                    if (this.#options.agentManager) {\n                        this.#options.agentManager.ResetAgent();\n                    }\n                    setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n                }\n            }\n                break;\n            case 'io client disconnect' :\n                this.#LogDebugMessage('SocketIoClientHelper(): The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n                this.#LogDebugMessage('SocketIoClientHelper(): 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(`SocketIoClientHelper(): Server unexpectedly disconnected. Reason: [${reason}]`);\n                this.#LogDebugMessage('SocketIoClientHelper(): The connection will be re-established when the server becomes available.');\n                const socketDetail: ISocketDetail = this.sockets[name];\n                if (socketDetail.socket) {\n                    socketDetail.socket.disconnect();\n                }\n                socketDetail.socket = null;\n                if (isNode) {\n                    if (this.#options.agentManager) {\n                        this.#options.agentManager?.ResetAgent();\n                    }\n                    setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n                }\n            }\n                break;\n            }\n        });\n    }\n}\n","/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */  // --> OFF\nimport { JSONObject } from '@nsshunt/stsutils'\n\nimport { Server, Namespace, Socket } from \"socket.io\";\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, STSServerSocket, ISocketIoServerHelper,\n    ISocketIoServerHelperOptions, STSSocketIONamespace, STSSocketIONamespaces, STSNamespace,\n    InterServerEvents, ServerEventCb } from './commonTypes'\n\nexport class SocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> implements ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\n{\n    #socketIoServerHelperOptions: ISocketIoServerHelperOptions\n    #namespace: STSSocketIONamespaces = { };\n\n    constructor(options: ISocketIoServerHelperOptions) { // IProcessBase\n        this.#socketIoServerHelperOptions = options;\n    }\n\n    LogMessage(namespace: STSSocketIONamespace, message: any) {\n        this.#socketIoServerHelperOptions.logger.debug(`${namespace.namespace}: ${message}`);\n    }\n\n    LeaveRoom = (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string): void => {\n        this.LogMessage(namespace, `${namespace.socketionamespace.name}: Leaving room [${room}]`);\n        socket.leave(room);\n    };\n\n    JoinRoom = (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string): void => {\n        this.LogMessage(namespace, `${namespace.socketionamespace.name}: Socket joining room [${room}], ID: [${socket.id}]`);\n        socket.join(room);\n    };\n\n    #SetupStandardEvents = (namespace: STSSocketIONamespace, socket: Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents>): void => {\n        socket.on('disconnect', (reason: string) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnect, ID: [${socket.id}] [${reason}]`);\n        });\n\n        socket.on('disconnecting', (reason: string) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnecting, ID: [${socket.id}] [${reason}]`);\n        });\n\n        socket.on('error', (error: Error) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket error, ID: [${socket.id}] [${error}]`);\n        });\n\n        socket.on(\"__STSdisconnect\", (reason: string) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnect: socket disconnect, ID: [${socket.id}] [${reason}]`);\n        });\n\n        socket.on(\"__STSdisconnecting\", (reason, callBackResult) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnecting: socket disconnecting, ID: [${socket.id}] [${reason}]`);\n            callBackResult(\"__STSdisconnecting accepted by server.\");\n        });\n\n        socket.on('__STSjoinRoom', (rooms: string[]): void => { //@@ names\n            rooms.forEach((room) => {\n                this.JoinRoom(namespace, socket, room)\n            });\n        });\n\n        socket.on('__STSleaveRoom', (rooms: string[]): void => { //@@ names\n            rooms.forEach((room) => {\n                this.LeaveRoom(namespace, socket, room);\n            });\n        });\n\n        socket.on('__STSsendToRoom', (rooms: string[], payload: { command: string, payload: JSONObject }): void => {\n            rooms.forEach((room) => {\n                this.LogMessage(namespace, `${namespace.socketionamespace.name}:socket.on:sendToRoom: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}]`);\n                 \n                namespace.socketionamespace.to(room).emit(payload.command as any, payload);\n            });\n        });\n    }\n\n    // Use this middleward to check every incomming connection\n    #SetupConnectionMiddleware = (nameSpace: STSSocketIONamespace) => {\n        nameSpace.socketionamespace.use((socket, next) => {\n            //if (isValid(socket.request)) {\n            const a=5; // for lint purposes\n            if (a === 5) {\n                next();\n            } else {\n                next(new Error(\"invalid\"));\n            }\n        });\n    }\n\n    // Use this middleware to check very packet being received\n    #SetupMessageMiddleware = (socket: STSServerSocket) => {\n        socket.use(([event, ...args], next) => {\n            /*\n            if (isUnauthorized(event)) {\n                return next(new Error(\"unauthorized event\"));\n            }\n            */\n            next();\n        });\n    }\n    \n    SetupNamespace = (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, /* serverSocketEvents: ServerSocketEvent[], */\n        socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null,\n        socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null\n    ): Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents> => {\n        // Create STS Command Centre Client namespace\n        this.#namespace[namespace] = {\n            namespace: namespace,\n            pid: process.pid,\n            socketionamespace: io.of(`/${namespace}/`)\n        }\n\n        this.#SetupConnectionMiddleware(this.#namespace[namespace]);\n\n        this.#namespace[namespace].socketionamespace.on(\"connection\", socket => {\n            this.LogMessage(this.#namespace[namespace], `${namespace}: Socket connected, ID: [${socket.id}]`);\n            this.LogMessage(this.#namespace[namespace], `${namespace}: Authentication Handshake: [${JSON.stringify(socket.handshake.auth)}]`);\n\n            this.#SetupMessageMiddleware(socket);\n\n            if (autoJoinRooms) {\n                rooms.map((room) => {\n                    this.JoinRoom(this.#namespace[namespace], socket, room);\n                });\n            }\n\n            this.#SetupStandardEvents(this.#namespace[namespace], socket);\n\n            if (socketConnectCallBack) {\n                setTimeout(() => {\n                    socketConnectCallBack(socket);\n                }, 0);\n            }\n\n            if (socketEventsCallBack) {\n                socketEventsCallBack(socket);\n            }\n        });\n\n        return this.#namespace[namespace].socketionamespace as Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>;\n    }\n\n    GetSTSSocketIONamespace = (namespace: string): STSSocketIONamespace => {\n        return this.#namespace[namespace];\n    }\n\n    GetSTSSocketIONamespaces = (): STSSocketIONamespaces => {\n        return this.#namespace;\n    }\n\n    CloseAdaptors = async (): Promise<void> => {\n        for (const [, namespace] of Object.entries(this.#namespace)) {\n            await namespace.socketionamespace.adapter.close();\n        }\n    }\n\n    DisconnectSockets = (): void => {\n        for (const [, namespace] of Object.entries(this.#namespace)) {\n            namespace.socketionamespace.disconnectSockets();\n        }\n        this.#namespace = { };\n    }\n\n    SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents> {\n        return this as any;\n    }\n}\n"],"names":["STSNamespace","STSRoom","STSEvent","socketDetail","io"],"mappings":"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","x_google_ignoreList":[1]}
+{"version":3,"file":"stssocketioutils.mjs","sources":["../src/commonTypes.ts","../node_modules/detect-node/index.esm.js","../src/socketIoClientHelper.ts","../src/socketIoServerHelper.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     \n\t__STSsendToRoom: (rooms: string[], payload: { command: string, payload: any }) => 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 interface ISocketIoServerHelperOptions {\n    logger: ISTSLogger\n}\n\nexport type ServerEventCb = (socket: any, data: any) => void\n\nexport interface ServerSocketEvent {\n\tserverEventName: string,\n\tserverEventCb: ServerEventCb\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\nexport interface ISocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents>\n{\n    LogMessage: (namespace: STSSocketIONamespace, message: string) => void\n    LeaveRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void\n    JoinRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void\n    SetupNamespace: (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, \n        /* serverSocketEvents: ServerSocketEvent[], */\n        socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null,\n        socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null\n        ) => Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>\n    GetSTSSocketIONamespace: (namespace: any) => STSSocketIONamespace\n    GetSTSSocketIONamespaces: () => STSSocketIONamespaces\n    DisconnectSockets: () => void\n    SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\n    CloseAdaptors: () => Promise<void>\n}\n","// Only Node.JS has a process variable that is of [[Class]] process\nexport default Object.prototype.toString.call(typeof process !== 'undefined' ? process : 0) === '[object process]';\n","import { io, SocketOptions, ManagerOptions, Socket } from 'socket.io-client'\n\nimport isNode from 'detect-node';\n\nimport { ISTSLogger, AgentManager } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes'\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type EventCb = (socket: any, data: any) => void\n\n/*\nSocket.io - Reserved events\nOn each side, the following events are reserved and should not be used as event names by your application:\nconnect\nconnect_error\ndisconnect\ndisconnecting\nnewListener\nremoveListener\n*/\n\n/*\nexport interface EventsMap { // From the socket.io library - was not declared as external\n    // eslint-disable-next-line  @typescript-eslint/no-explicit-any\n    [event: string]: any;\n}\n*/\n\nexport interface ISocketDetail {\n\tname: string,\n\taddress: string,\n     \n\tsocket: Socket | null\n    errorCallBack: (error: Error) => void\n}\n\nexport interface ISocketIoClientHelperOptions\n{\n    url?: string\n    agentManager?: AgentManager\n    logger?: ISTSLogger\n}\n\nexport class SocketIoClientHelper<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents>\n{\n    #options: ISocketIoClientHelperOptions\n    #sockets: Record<string, ISocketDetail> = { }\n\n    constructor(options: ISocketIoClientHelperOptions) {\n        this.#options = options;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    #LogDebugMessage(message: any): void {\n        if (this.#options.logger) this.#options.logger.debug(message);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    #LogErrorMessage(message: any): void {\n        if (this.#options.logger) this.#options.logger.error(message);\n    }\n\n    get sockets(): Record<string, ISocketDetail> {\n        return this.#sockets;\n    }\n    \n    SetupClientSideSocket(name: string, address: string, socketIoCustomPath: string,\n        onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n        socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n        errorCallBack: ((error: Error) => void)\n    ): Socket<ServerToClientEvents, ClientToServerEvents> {\n        this.sockets[name] = {\n            name,\n            address,\n            socket: null,\n            errorCallBack\n        }\n        this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack);\n        return this.sockets[name].socket as Socket<ServerToClientEvents, ClientToServerEvents>\n    }\n\n    GetSocket(name: string): Socket<ServerToClientEvents, ClientToServerEvents> {\n        return this.sockets[name].socket as Socket<ServerToClientEvents, ClientToServerEvents>\n    }\n\n    GetSocketDetail(name: string): ISocketDetail {\n        return this.sockets[name];\n    }\n\n    #EstablishSocketConnect(name: string, socketIoCustomPath: string, onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n        socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null): void\n    {\n        const socketDetail: ISocketDetail = this.sockets[name];\n\n        if (socketDetail.socket !== null) {\n            // We already have a socket object (may or may not be connected)\n            if (socketDetail.socket.connected === true) {\n                socketDetail.socket.disconnect();\n            }\n            socketDetail.socket = null;\n            if (isNode) {\n                setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n            } else {\n                setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100); //@@ 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.#options.agentManager) {\n                socketOptions.agent = this.#options.agentManager.GetAgent(socketDetail.address);\n            }\n        } else {\n            socketOptions = {\n                transports: [\"websocket\" ]\n            }\n        }\n\n        if (socketIoCustomPath && socketIoCustomPath.localeCompare('') !== 0) {\n            socketOptions.path = socketIoCustomPath;\n        }\n\n        socketDetail.socket = io(socketDetail.address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n        // Manager errors\n        socketDetail.socket.io.on('error', (err: Error) => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.io.on('error'): [${err}]`);\n        });\n\n        socketDetail.socket.io.on('reconnect_error', (err: Error) => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.io.on('reconnect_error'): [${err}]`);\n        });\n\n        socketDetail.socket.io.on('reconnect', (attempt: number) => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.io.on('reconnect'): Number: [${attempt}]`);\n        });\n\n        // suppress automatic console logging by not letting it bubble up\n        socketDetail.socket.on(\"connect_error\", (err) => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.on('connect_error'): [${err}]`);\n        });\n\n        socketDetail.socket.on(\"connect_timeout\", () => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.on('connect_timeout')`);\n        });        \n\n        socketDetail.socket.on(\"connect\", () => {\n            if (socketDetail.socket) {\n                this.#LogDebugMessage(`SocketIoClientHelper(): Socket: [${socketDetail.socket.id}]: connected`);\n\n                if (onConnectCallBack) {\n                    setTimeout(() => {\n                        onConnectCallBack(socketDetail.socket as Socket<ServerToClientEvents, ClientToServerEvents>);\n                    }, 0);\n                }\n\n                if (socketEventsCallBack) {\n                    socketEventsCallBack(socketDetail.socket);\n                }\n\n            } else {\n                const errorMessage: string = 'SocketIoClientHelper(): Could not get socket object from socket.io';\n                this.#LogErrorMessage(errorMessage);\n                socketDetail.errorCallBack(new Error(errorMessage));\n            }\n        })\n\n        // https://socket.io/docs/v4/client-socket-instance/#disconnect\n        socketDetail.socket.on(\"disconnect\", (reason: string) => {\n            this.#LogDebugMessage('SocketIoClientHelper(): socket disconnect: ' + reason);\n            switch (reason) {\n            case 'io server disconnect' : {\n                // The server disconnect using disconnectSockets (i.e. normal safe shutdown)\n                this.#LogDebugMessage('SocketIoClientHelper(): The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n                this.#LogDebugMessage('SocketIoClientHelper(): The connection will be re-established when the server becomes available.');\n                const socketDetail: ISocketDetail = this.sockets[name];\n                socketDetail.socket = null;\n                if (isNode) {\n                    if (this.#options.agentManager) {\n                        this.#options.agentManager.ResetAgent();\n                    }\n                    setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n                }\n            }\n                break;\n            case 'io client disconnect' :\n                this.#LogDebugMessage('SocketIoClientHelper(): The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n                this.#LogDebugMessage('SocketIoClientHelper(): 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(`SocketIoClientHelper(): Server unexpectedly disconnected. Reason: [${reason}]`);\n                this.#LogDebugMessage('SocketIoClientHelper(): The connection will be re-established when the server becomes available.');\n                const socketDetail: ISocketDetail = this.sockets[name];\n                if (socketDetail.socket) {\n                    socketDetail.socket.disconnect();\n                }\n                socketDetail.socket = null;\n                if (isNode) {\n                    if (this.#options.agentManager) {\n                        this.#options.agentManager?.ResetAgent();\n                    }\n                    setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n                }\n            }\n                break;\n            }\n        });\n    }\n}\n","/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */  // --> OFF\nimport { JSONObject } from '@nsshunt/stsutils'\n\nimport { Server, Namespace, Socket } from \"socket.io\";\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, STSServerSocket, ISocketIoServerHelper,\n    ISocketIoServerHelperOptions, STSSocketIONamespace, STSSocketIONamespaces, STSNamespace,\n    InterServerEvents, ServerEventCb } from './commonTypes'\n\nexport class SocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> implements ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\n{\n    #socketIoServerHelperOptions: ISocketIoServerHelperOptions\n    #namespace: STSSocketIONamespaces = { };\n\n    constructor(options: ISocketIoServerHelperOptions) { // IProcessBase\n        this.#socketIoServerHelperOptions = options;\n    }\n\n    LogMessage(namespace: STSSocketIONamespace, message: any) {\n        if (namespace) {\n            this.#socketIoServerHelperOptions.logger.debug(`${namespace.namespace}: ${message}`);\n        } else {\n            this.#socketIoServerHelperOptions.logger.debug(`${message}`);\n        }\n    }\n\n    LeaveRoom = (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string): void => {\n        this.LogMessage(namespace, `${namespace.socketionamespace.name}: Leaving room [${room}]`);\n        socket.leave(room);\n    };\n\n    JoinRoom = (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string): void => {\n        this.LogMessage(namespace, `${namespace.socketionamespace.name}: Socket joining room [${room}], ID: [${socket.id}]`);\n        socket.join(room);\n    };\n\n    #SetupStandardEvents = (namespace: STSSocketIONamespace, socket: Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents>): void => {\n        socket.on('disconnect', (reason: string) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnect, ID: [${socket.id}] [${reason}]`);\n        });\n\n        socket.on('disconnecting', (reason: string) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnecting, ID: [${socket.id}] [${reason}]`);\n        });\n\n        socket.on('error', (error: Error) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket error, ID: [${socket.id}] [${error}]`);\n        });\n\n        socket.on(\"__STSdisconnect\", (reason: string) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnect: socket disconnect, ID: [${socket.id}] [${reason}]`);\n        });\n\n        socket.on(\"__STSdisconnecting\", (reason, callBackResult) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnecting: socket disconnecting, ID: [${socket.id}] [${reason}]`);\n            callBackResult(\"__STSdisconnecting accepted by server.\");\n        });\n\n        socket.on('__STSjoinRoom', (rooms: string[]): void => { //@@ names\n            rooms.forEach((room) => {\n                this.JoinRoom(namespace, socket, room)\n            });\n        });\n\n        socket.on('__STSleaveRoom', (rooms: string[]): void => { //@@ names\n            rooms.forEach((room) => {\n                this.LeaveRoom(namespace, socket, room);\n            });\n        });\n\n        socket.on('__STSsendToRoom', (rooms: string[], payload: { command: string, payload: JSONObject }): void => {\n            rooms.forEach((room) => {\n                this.LogMessage(namespace, `${namespace.socketionamespace.name}:socket.on:sendToRoom: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}]`);\n                 \n                namespace.socketionamespace.to(room).emit(payload.command as any, payload);\n            });\n        });\n    }\n\n    // Use this middleward to check every incomming connection\n    #SetupConnectionMiddleware = (nameSpace: STSSocketIONamespace) => {\n        nameSpace.socketionamespace.use((socket, next) => {\n            //if (isValid(socket.request)) {\n            const a=5; // for lint purposes\n            if (a === 5) {\n                next();\n            } else {\n                next(new Error(\"invalid\"));\n            }\n        });\n    }\n\n    // Use this middleware to check very packet being received\n    #SetupMessageMiddleware = (socket: STSServerSocket) => {\n        socket.use(([event, ...args], next) => {\n            /*\n            if (isUnauthorized(event)) {\n                return next(new Error(\"unauthorized event\"));\n            }\n            */\n            next();\n        });\n    }\n    \n    SetupNamespace = (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, /* serverSocketEvents: ServerSocketEvent[], */\n        socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null,\n        socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null\n    ): Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents> => {\n        // Create STS Command Centre Client namespace\n        this.#namespace[namespace] = {\n            namespace: namespace,\n            pid: process.pid,\n            socketionamespace: io.of(`/${namespace}/`)\n        }\n\n        this.#SetupConnectionMiddleware(this.#namespace[namespace]);\n\n        this.#namespace[namespace].socketionamespace.on(\"connection\", socket => {\n            this.LogMessage(this.#namespace[namespace], `${namespace}: Socket connected, ID: [${socket.id}]`);\n            this.LogMessage(this.#namespace[namespace], `${namespace}: Authentication Handshake: [${JSON.stringify(socket.handshake.auth)}]`);\n\n            this.#SetupMessageMiddleware(socket);\n\n            if (autoJoinRooms) {\n                rooms.map((room) => {\n                    this.JoinRoom(this.#namespace[namespace], socket, room);\n                });\n            }\n\n            this.#SetupStandardEvents(this.#namespace[namespace], socket);\n\n            if (socketConnectCallBack) {\n                setTimeout(() => {\n                    socketConnectCallBack(socket);\n                }, 0);\n            }\n\n            if (socketEventsCallBack) {\n                socketEventsCallBack(socket);\n            }\n        });\n\n        return this.#namespace[namespace].socketionamespace as Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>;\n    }\n\n    GetSTSSocketIONamespace = (namespace: string): STSSocketIONamespace => {\n        return this.#namespace[namespace];\n    }\n\n    GetSTSSocketIONamespaces = (): STSSocketIONamespaces => {\n        return this.#namespace;\n    }\n\n    CloseAdaptors = async (): Promise<void> => {\n        for (const [, namespace] of Object.entries(this.#namespace)) {\n            await namespace.socketionamespace.adapter.close();\n        }\n    }\n\n    DisconnectSockets = (): void => {\n        for (const [, namespace] of Object.entries(this.#namespace)) {\n            namespace.socketionamespace.disconnectSockets();\n        }\n        this.#namespace = { };\n    }\n\n    SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents> {\n        return this as any;\n    }\n}\n"],"names":["STSNamespace","STSRoom","STSEvent","socketDetail","io"],"mappings":"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","x_google_ignoreList":[1]}

package/dist/stssocketioutils.umd.js

@@ -302,7 +302,11 @@ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "acce
       __privateSet(this, _socketIoServerHelperOptions, options);
     }
     LogMessage(namespace, message) {
-      __privateGet(this, _socketIoServerHelperOptions).logger.debug(`${namespace.namespace}: ${message}`);
+      if (namespace) {
+        __privateGet(this, _socketIoServerHelperOptions).logger.debug(`${namespace.namespace}: ${message}`);
+      } else {
+        __privateGet(this, _socketIoServerHelperOptions).logger.debug(`${message}`);
+      }
     }
     SetupEvent(event, eventCb) {
       return this;

package/dist/stssocketioutils.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"stssocketioutils.umd.js","sources":["../src/commonTypes.ts","../node_modules/detect-node/index.esm.js","../src/socketIoClientHelper.ts","../src/socketIoServerHelper.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     \n\t__STSsendToRoom: (rooms: string[], payload: { command: string, payload: any }) => 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 interface ISocketIoServerHelperOptions {\n    logger: ISTSLogger\n}\n\nexport type ServerEventCb = (socket: any, data: any) => void\n\nexport interface ServerSocketEvent {\n\tserverEventName: string,\n\tserverEventCb: ServerEventCb\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\nexport interface ISocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents>\n{\n    LogMessage: (namespace: STSSocketIONamespace, message: string) => void\n    LeaveRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void\n    JoinRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void\n    SetupNamespace: (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, \n        /* serverSocketEvents: ServerSocketEvent[], */\n        socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null,\n        socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null\n        ) => Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>\n    GetSTSSocketIONamespace: (namespace: any) => STSSocketIONamespace\n    GetSTSSocketIONamespaces: () => STSSocketIONamespaces\n    DisconnectSockets: () => void\n    SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\n    CloseAdaptors: () => Promise<void>\n}\n","// Only Node.JS has a process variable that is of [[Class]] process\nexport default Object.prototype.toString.call(typeof process !== 'undefined' ? process : 0) === '[object process]';\n","import { io, SocketOptions, ManagerOptions, Socket } from 'socket.io-client'\n\nimport isNode from 'detect-node';\n\nimport { ISTSLogger, AgentManager } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes'\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type EventCb = (socket: any, data: any) => void\n\n/*\nSocket.io - Reserved events\nOn each side, the following events are reserved and should not be used as event names by your application:\nconnect\nconnect_error\ndisconnect\ndisconnecting\nnewListener\nremoveListener\n*/\n\n/*\nexport interface EventsMap { // From the socket.io library - was not declared as external\n    // eslint-disable-next-line  @typescript-eslint/no-explicit-any\n    [event: string]: any;\n}\n*/\n\nexport interface ISocketDetail {\n\tname: string,\n\taddress: string,\n     \n\tsocket: Socket | null\n    errorCallBack: (error: Error) => void\n}\n\nexport interface ISocketIoClientHelperOptions\n{\n    url?: string\n    agentManager?: AgentManager\n    logger?: ISTSLogger\n}\n\nexport class SocketIoClientHelper<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents>\n{\n    #options: ISocketIoClientHelperOptions\n    #sockets: Record<string, ISocketDetail> = { }\n\n    constructor(options: ISocketIoClientHelperOptions) {\n        this.#options = options;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    #LogDebugMessage(message: any): void {\n        if (this.#options.logger) this.#options.logger.debug(message);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    #LogErrorMessage(message: any): void {\n        if (this.#options.logger) this.#options.logger.error(message);\n    }\n\n    get sockets(): Record<string, ISocketDetail> {\n        return this.#sockets;\n    }\n    \n    SetupClientSideSocket(name: string, address: string, socketIoCustomPath: string,\n        onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n        socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n        errorCallBack: ((error: Error) => void)\n    ): Socket<ServerToClientEvents, ClientToServerEvents> {\n        this.sockets[name] = {\n            name,\n            address,\n            socket: null,\n            errorCallBack\n        }\n        this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack);\n        return this.sockets[name].socket as Socket<ServerToClientEvents, ClientToServerEvents>\n    }\n\n    GetSocket(name: string): Socket<ServerToClientEvents, ClientToServerEvents> {\n        return this.sockets[name].socket as Socket<ServerToClientEvents, ClientToServerEvents>\n    }\n\n    GetSocketDetail(name: string): ISocketDetail {\n        return this.sockets[name];\n    }\n\n    #EstablishSocketConnect(name: string, socketIoCustomPath: string, onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n        socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null): void\n    {\n        const socketDetail: ISocketDetail = this.sockets[name];\n\n        if (socketDetail.socket !== null) {\n            // We already have a socket object (may or may not be connected)\n            if (socketDetail.socket.connected === true) {\n                socketDetail.socket.disconnect();\n            }\n            socketDetail.socket = null;\n            if (isNode) {\n                setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n            } else {\n                setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100); //@@ 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.#options.agentManager) {\n                socketOptions.agent = this.#options.agentManager.GetAgent(socketDetail.address);\n            }\n        } else {\n            socketOptions = {\n                transports: [\"websocket\" ]\n            }\n        }\n\n        if (socketIoCustomPath && socketIoCustomPath.localeCompare('') !== 0) {\n            socketOptions.path = socketIoCustomPath;\n        }\n\n        socketDetail.socket = io(socketDetail.address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n        // Manager errors\n        socketDetail.socket.io.on('error', (err: Error) => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.io.on('error'): [${err}]`);\n        });\n\n        socketDetail.socket.io.on('reconnect_error', (err: Error) => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.io.on('reconnect_error'): [${err}]`);\n        });\n\n        socketDetail.socket.io.on('reconnect', (attempt: number) => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.io.on('reconnect'): Number: [${attempt}]`);\n        });\n\n        // suppress automatic console logging by not letting it bubble up\n        socketDetail.socket.on(\"connect_error\", (err) => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.on('connect_error'): [${err}]`);\n        });\n\n        socketDetail.socket.on(\"connect_timeout\", () => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.on('connect_timeout')`);\n        });        \n\n        socketDetail.socket.on(\"connect\", () => {\n            if (socketDetail.socket) {\n                this.#LogDebugMessage(`SocketIoClientHelper(): Socket: [${socketDetail.socket.id}]: connected`);\n\n                if (onConnectCallBack) {\n                    setTimeout(() => {\n                        onConnectCallBack(socketDetail.socket as Socket<ServerToClientEvents, ClientToServerEvents>);\n                    }, 0);\n                }\n\n                if (socketEventsCallBack) {\n                    socketEventsCallBack(socketDetail.socket);\n                }\n\n            } else {\n                const errorMessage: string = 'SocketIoClientHelper(): Could not get socket object from socket.io';\n                this.#LogErrorMessage(errorMessage);\n                socketDetail.errorCallBack(new Error(errorMessage));\n            }\n        })\n\n        // https://socket.io/docs/v4/client-socket-instance/#disconnect\n        socketDetail.socket.on(\"disconnect\", (reason: string) => {\n            this.#LogDebugMessage('SocketIoClientHelper(): socket disconnect: ' + reason);\n            switch (reason) {\n            case 'io server disconnect' : {\n                // The server disconnect using disconnectSockets (i.e. normal safe shutdown)\n                this.#LogDebugMessage('SocketIoClientHelper(): The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n                this.#LogDebugMessage('SocketIoClientHelper(): The connection will be re-established when the server becomes available.');\n                const socketDetail: ISocketDetail = this.sockets[name];\n                socketDetail.socket = null;\n                if (isNode) {\n                    if (this.#options.agentManager) {\n                        this.#options.agentManager.ResetAgent();\n                    }\n                    setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n                }\n            }\n                break;\n            case 'io client disconnect' :\n                this.#LogDebugMessage('SocketIoClientHelper(): The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n                this.#LogDebugMessage('SocketIoClientHelper(): 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(`SocketIoClientHelper(): Server unexpectedly disconnected. Reason: [${reason}]`);\n                this.#LogDebugMessage('SocketIoClientHelper(): The connection will be re-established when the server becomes available.');\n                const socketDetail: ISocketDetail = this.sockets[name];\n                if (socketDetail.socket) {\n                    socketDetail.socket.disconnect();\n                }\n                socketDetail.socket = null;\n                if (isNode) {\n                    if (this.#options.agentManager) {\n                        this.#options.agentManager?.ResetAgent();\n                    }\n                    setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n                }\n            }\n                break;\n            }\n        });\n    }\n}\n","/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */  // --> OFF\nimport { JSONObject } from '@nsshunt/stsutils'\n\nimport { Server, Namespace, Socket } from \"socket.io\";\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, STSServerSocket, ISocketIoServerHelper,\n    ISocketIoServerHelperOptions, STSSocketIONamespace, STSSocketIONamespaces, STSNamespace,\n    InterServerEvents, ServerEventCb } from './commonTypes'\n\nexport class SocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> implements ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\n{\n    #socketIoServerHelperOptions: ISocketIoServerHelperOptions\n    #namespace: STSSocketIONamespaces = { };\n\n    constructor(options: ISocketIoServerHelperOptions) { // IProcessBase\n        this.#socketIoServerHelperOptions = options;\n    }\n\n    LogMessage(namespace: STSSocketIONamespace, message: any) {\n        this.#socketIoServerHelperOptions.logger.debug(`${namespace.namespace}: ${message}`);\n    }\n\n    LeaveRoom = (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string): void => {\n        this.LogMessage(namespace, `${namespace.socketionamespace.name}: Leaving room [${room}]`);\n        socket.leave(room);\n    };\n\n    JoinRoom = (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string): void => {\n        this.LogMessage(namespace, `${namespace.socketionamespace.name}: Socket joining room [${room}], ID: [${socket.id}]`);\n        socket.join(room);\n    };\n\n    #SetupStandardEvents = (namespace: STSSocketIONamespace, socket: Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents>): void => {\n        socket.on('disconnect', (reason: string) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnect, ID: [${socket.id}] [${reason}]`);\n        });\n\n        socket.on('disconnecting', (reason: string) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnecting, ID: [${socket.id}] [${reason}]`);\n        });\n\n        socket.on('error', (error: Error) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket error, ID: [${socket.id}] [${error}]`);\n        });\n\n        socket.on(\"__STSdisconnect\", (reason: string) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnect: socket disconnect, ID: [${socket.id}] [${reason}]`);\n        });\n\n        socket.on(\"__STSdisconnecting\", (reason, callBackResult) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnecting: socket disconnecting, ID: [${socket.id}] [${reason}]`);\n            callBackResult(\"__STSdisconnecting accepted by server.\");\n        });\n\n        socket.on('__STSjoinRoom', (rooms: string[]): void => { //@@ names\n            rooms.forEach((room) => {\n                this.JoinRoom(namespace, socket, room)\n            });\n        });\n\n        socket.on('__STSleaveRoom', (rooms: string[]): void => { //@@ names\n            rooms.forEach((room) => {\n                this.LeaveRoom(namespace, socket, room);\n            });\n        });\n\n        socket.on('__STSsendToRoom', (rooms: string[], payload: { command: string, payload: JSONObject }): void => {\n            rooms.forEach((room) => {\n                this.LogMessage(namespace, `${namespace.socketionamespace.name}:socket.on:sendToRoom: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}]`);\n                 \n                namespace.socketionamespace.to(room).emit(payload.command as any, payload);\n            });\n        });\n    }\n\n    // Use this middleward to check every incomming connection\n    #SetupConnectionMiddleware = (nameSpace: STSSocketIONamespace) => {\n        nameSpace.socketionamespace.use((socket, next) => {\n            //if (isValid(socket.request)) {\n            const a=5; // for lint purposes\n            if (a === 5) {\n                next();\n            } else {\n                next(new Error(\"invalid\"));\n            }\n        });\n    }\n\n    // Use this middleware to check very packet being received\n    #SetupMessageMiddleware = (socket: STSServerSocket) => {\n        socket.use(([event, ...args], next) => {\n            /*\n            if (isUnauthorized(event)) {\n                return next(new Error(\"unauthorized event\"));\n            }\n            */\n            next();\n        });\n    }\n    \n    SetupNamespace = (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, /* serverSocketEvents: ServerSocketEvent[], */\n        socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null,\n        socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null\n    ): Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents> => {\n        // Create STS Command Centre Client namespace\n        this.#namespace[namespace] = {\n            namespace: namespace,\n            pid: process.pid,\n            socketionamespace: io.of(`/${namespace}/`)\n        }\n\n        this.#SetupConnectionMiddleware(this.#namespace[namespace]);\n\n        this.#namespace[namespace].socketionamespace.on(\"connection\", socket => {\n            this.LogMessage(this.#namespace[namespace], `${namespace}: Socket connected, ID: [${socket.id}]`);\n            this.LogMessage(this.#namespace[namespace], `${namespace}: Authentication Handshake: [${JSON.stringify(socket.handshake.auth)}]`);\n\n            this.#SetupMessageMiddleware(socket);\n\n            if (autoJoinRooms) {\n                rooms.map((room) => {\n                    this.JoinRoom(this.#namespace[namespace], socket, room);\n                });\n            }\n\n            this.#SetupStandardEvents(this.#namespace[namespace], socket);\n\n            if (socketConnectCallBack) {\n                setTimeout(() => {\n                    socketConnectCallBack(socket);\n                }, 0);\n            }\n\n            if (socketEventsCallBack) {\n                socketEventsCallBack(socket);\n            }\n        });\n\n        return this.#namespace[namespace].socketionamespace as Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>;\n    }\n\n    GetSTSSocketIONamespace = (namespace: string): STSSocketIONamespace => {\n        return this.#namespace[namespace];\n    }\n\n    GetSTSSocketIONamespaces = (): STSSocketIONamespaces => {\n        return this.#namespace;\n    }\n\n    CloseAdaptors = async (): Promise<void> => {\n        for (const [, namespace] of Object.entries(this.#namespace)) {\n            await namespace.socketionamespace.adapter.close();\n        }\n    }\n\n    DisconnectSockets = (): void => {\n        for (const [, namespace] of Object.entries(this.#namespace)) {\n            namespace.socketionamespace.disconnectSockets();\n        }\n        this.#namespace = { };\n    }\n\n    SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents> {\n        return this as any;\n    }\n}\n"],"names":["STSNamespace","STSRoom","STSEvent","io","socketDetail"],"mappings":"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","x_google_ignoreList":[1]}
+{"version":3,"file":"stssocketioutils.umd.js","sources":["../src/commonTypes.ts","../node_modules/detect-node/index.esm.js","../src/socketIoClientHelper.ts","../src/socketIoServerHelper.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     \n\t__STSsendToRoom: (rooms: string[], payload: { command: string, payload: any }) => 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 interface ISocketIoServerHelperOptions {\n    logger: ISTSLogger\n}\n\nexport type ServerEventCb = (socket: any, data: any) => void\n\nexport interface ServerSocketEvent {\n\tserverEventName: string,\n\tserverEventCb: ServerEventCb\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\nexport interface ISocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents>\n{\n    LogMessage: (namespace: STSSocketIONamespace, message: string) => void\n    LeaveRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void\n    JoinRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void\n    SetupNamespace: (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, \n        /* serverSocketEvents: ServerSocketEvent[], */\n        socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null,\n        socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null\n        ) => Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>\n    GetSTSSocketIONamespace: (namespace: any) => STSSocketIONamespace\n    GetSTSSocketIONamespaces: () => STSSocketIONamespaces\n    DisconnectSockets: () => void\n    SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\n    CloseAdaptors: () => Promise<void>\n}\n","// Only Node.JS has a process variable that is of [[Class]] process\nexport default Object.prototype.toString.call(typeof process !== 'undefined' ? process : 0) === '[object process]';\n","import { io, SocketOptions, ManagerOptions, Socket } from 'socket.io-client'\n\nimport isNode from 'detect-node';\n\nimport { ISTSLogger, AgentManager } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes'\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type EventCb = (socket: any, data: any) => void\n\n/*\nSocket.io - Reserved events\nOn each side, the following events are reserved and should not be used as event names by your application:\nconnect\nconnect_error\ndisconnect\ndisconnecting\nnewListener\nremoveListener\n*/\n\n/*\nexport interface EventsMap { // From the socket.io library - was not declared as external\n    // eslint-disable-next-line  @typescript-eslint/no-explicit-any\n    [event: string]: any;\n}\n*/\n\nexport interface ISocketDetail {\n\tname: string,\n\taddress: string,\n     \n\tsocket: Socket | null\n    errorCallBack: (error: Error) => void\n}\n\nexport interface ISocketIoClientHelperOptions\n{\n    url?: string\n    agentManager?: AgentManager\n    logger?: ISTSLogger\n}\n\nexport class SocketIoClientHelper<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents>\n{\n    #options: ISocketIoClientHelperOptions\n    #sockets: Record<string, ISocketDetail> = { }\n\n    constructor(options: ISocketIoClientHelperOptions) {\n        this.#options = options;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    #LogDebugMessage(message: any): void {\n        if (this.#options.logger) this.#options.logger.debug(message);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    #LogErrorMessage(message: any): void {\n        if (this.#options.logger) this.#options.logger.error(message);\n    }\n\n    get sockets(): Record<string, ISocketDetail> {\n        return this.#sockets;\n    }\n    \n    SetupClientSideSocket(name: string, address: string, socketIoCustomPath: string,\n        onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n        socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n        errorCallBack: ((error: Error) => void)\n    ): Socket<ServerToClientEvents, ClientToServerEvents> {\n        this.sockets[name] = {\n            name,\n            address,\n            socket: null,\n            errorCallBack\n        }\n        this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack);\n        return this.sockets[name].socket as Socket<ServerToClientEvents, ClientToServerEvents>\n    }\n\n    GetSocket(name: string): Socket<ServerToClientEvents, ClientToServerEvents> {\n        return this.sockets[name].socket as Socket<ServerToClientEvents, ClientToServerEvents>\n    }\n\n    GetSocketDetail(name: string): ISocketDetail {\n        return this.sockets[name];\n    }\n\n    #EstablishSocketConnect(name: string, socketIoCustomPath: string, onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n        socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null): void\n    {\n        const socketDetail: ISocketDetail = this.sockets[name];\n\n        if (socketDetail.socket !== null) {\n            // We already have a socket object (may or may not be connected)\n            if (socketDetail.socket.connected === true) {\n                socketDetail.socket.disconnect();\n            }\n            socketDetail.socket = null;\n            if (isNode) {\n                setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n            } else {\n                setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100); //@@ 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.#options.agentManager) {\n                socketOptions.agent = this.#options.agentManager.GetAgent(socketDetail.address);\n            }\n        } else {\n            socketOptions = {\n                transports: [\"websocket\" ]\n            }\n        }\n\n        if (socketIoCustomPath && socketIoCustomPath.localeCompare('') !== 0) {\n            socketOptions.path = socketIoCustomPath;\n        }\n\n        socketDetail.socket = io(socketDetail.address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n        // Manager errors\n        socketDetail.socket.io.on('error', (err: Error) => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.io.on('error'): [${err}]`);\n        });\n\n        socketDetail.socket.io.on('reconnect_error', (err: Error) => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.io.on('reconnect_error'): [${err}]`);\n        });\n\n        socketDetail.socket.io.on('reconnect', (attempt: number) => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.io.on('reconnect'): Number: [${attempt}]`);\n        });\n\n        // suppress automatic console logging by not letting it bubble up\n        socketDetail.socket.on(\"connect_error\", (err) => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.on('connect_error'): [${err}]`);\n        });\n\n        socketDetail.socket.on(\"connect_timeout\", () => {\n            this.#LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.on('connect_timeout')`);\n        });        \n\n        socketDetail.socket.on(\"connect\", () => {\n            if (socketDetail.socket) {\n                this.#LogDebugMessage(`SocketIoClientHelper(): Socket: [${socketDetail.socket.id}]: connected`);\n\n                if (onConnectCallBack) {\n                    setTimeout(() => {\n                        onConnectCallBack(socketDetail.socket as Socket<ServerToClientEvents, ClientToServerEvents>);\n                    }, 0);\n                }\n\n                if (socketEventsCallBack) {\n                    socketEventsCallBack(socketDetail.socket);\n                }\n\n            } else {\n                const errorMessage: string = 'SocketIoClientHelper(): Could not get socket object from socket.io';\n                this.#LogErrorMessage(errorMessage);\n                socketDetail.errorCallBack(new Error(errorMessage));\n            }\n        })\n\n        // https://socket.io/docs/v4/client-socket-instance/#disconnect\n        socketDetail.socket.on(\"disconnect\", (reason: string) => {\n            this.#LogDebugMessage('SocketIoClientHelper(): socket disconnect: ' + reason);\n            switch (reason) {\n            case 'io server disconnect' : {\n                // The server disconnect using disconnectSockets (i.e. normal safe shutdown)\n                this.#LogDebugMessage('SocketIoClientHelper(): The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n                this.#LogDebugMessage('SocketIoClientHelper(): The connection will be re-established when the server becomes available.');\n                const socketDetail: ISocketDetail = this.sockets[name];\n                socketDetail.socket = null;\n                if (isNode) {\n                    if (this.#options.agentManager) {\n                        this.#options.agentManager.ResetAgent();\n                    }\n                    setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n                }\n            }\n                break;\n            case 'io client disconnect' :\n                this.#LogDebugMessage('SocketIoClientHelper(): The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n                this.#LogDebugMessage('SocketIoClientHelper(): 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(`SocketIoClientHelper(): Server unexpectedly disconnected. Reason: [${reason}]`);\n                this.#LogDebugMessage('SocketIoClientHelper(): The connection will be re-established when the server becomes available.');\n                const socketDetail: ISocketDetail = this.sockets[name];\n                if (socketDetail.socket) {\n                    socketDetail.socket.disconnect();\n                }\n                socketDetail.socket = null;\n                if (isNode) {\n                    if (this.#options.agentManager) {\n                        this.#options.agentManager?.ResetAgent();\n                    }\n                    setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(name, socketIoCustomPath, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n                }\n            }\n                break;\n            }\n        });\n    }\n}\n","/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */  // --> OFF\nimport { JSONObject } from '@nsshunt/stsutils'\n\nimport { Server, Namespace, Socket } from \"socket.io\";\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, STSServerSocket, ISocketIoServerHelper,\n    ISocketIoServerHelperOptions, STSSocketIONamespace, STSSocketIONamespaces, STSNamespace,\n    InterServerEvents, ServerEventCb } from './commonTypes'\n\nexport class SocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> implements ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\n{\n    #socketIoServerHelperOptions: ISocketIoServerHelperOptions\n    #namespace: STSSocketIONamespaces = { };\n\n    constructor(options: ISocketIoServerHelperOptions) { // IProcessBase\n        this.#socketIoServerHelperOptions = options;\n    }\n\n    LogMessage(namespace: STSSocketIONamespace, message: any) {\n        if (namespace) {\n            this.#socketIoServerHelperOptions.logger.debug(`${namespace.namespace}: ${message}`);\n        } else {\n            this.#socketIoServerHelperOptions.logger.debug(`${message}`);\n        }\n    }\n\n    LeaveRoom = (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string): void => {\n        this.LogMessage(namespace, `${namespace.socketionamespace.name}: Leaving room [${room}]`);\n        socket.leave(room);\n    };\n\n    JoinRoom = (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string): void => {\n        this.LogMessage(namespace, `${namespace.socketionamespace.name}: Socket joining room [${room}], ID: [${socket.id}]`);\n        socket.join(room);\n    };\n\n    #SetupStandardEvents = (namespace: STSSocketIONamespace, socket: Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents>): void => {\n        socket.on('disconnect', (reason: string) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnect, ID: [${socket.id}] [${reason}]`);\n        });\n\n        socket.on('disconnecting', (reason: string) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnecting, ID: [${socket.id}] [${reason}]`);\n        });\n\n        socket.on('error', (error: Error) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket error, ID: [${socket.id}] [${error}]`);\n        });\n\n        socket.on(\"__STSdisconnect\", (reason: string) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnect: socket disconnect, ID: [${socket.id}] [${reason}]`);\n        });\n\n        socket.on(\"__STSdisconnecting\", (reason, callBackResult) => {\n            this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnecting: socket disconnecting, ID: [${socket.id}] [${reason}]`);\n            callBackResult(\"__STSdisconnecting accepted by server.\");\n        });\n\n        socket.on('__STSjoinRoom', (rooms: string[]): void => { //@@ names\n            rooms.forEach((room) => {\n                this.JoinRoom(namespace, socket, room)\n            });\n        });\n\n        socket.on('__STSleaveRoom', (rooms: string[]): void => { //@@ names\n            rooms.forEach((room) => {\n                this.LeaveRoom(namespace, socket, room);\n            });\n        });\n\n        socket.on('__STSsendToRoom', (rooms: string[], payload: { command: string, payload: JSONObject }): void => {\n            rooms.forEach((room) => {\n                this.LogMessage(namespace, `${namespace.socketionamespace.name}:socket.on:sendToRoom: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}]`);\n                 \n                namespace.socketionamespace.to(room).emit(payload.command as any, payload);\n            });\n        });\n    }\n\n    // Use this middleward to check every incomming connection\n    #SetupConnectionMiddleware = (nameSpace: STSSocketIONamespace) => {\n        nameSpace.socketionamespace.use((socket, next) => {\n            //if (isValid(socket.request)) {\n            const a=5; // for lint purposes\n            if (a === 5) {\n                next();\n            } else {\n                next(new Error(\"invalid\"));\n            }\n        });\n    }\n\n    // Use this middleware to check very packet being received\n    #SetupMessageMiddleware = (socket: STSServerSocket) => {\n        socket.use(([event, ...args], next) => {\n            /*\n            if (isUnauthorized(event)) {\n                return next(new Error(\"unauthorized event\"));\n            }\n            */\n            next();\n        });\n    }\n    \n    SetupNamespace = (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, /* serverSocketEvents: ServerSocketEvent[], */\n        socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null,\n        socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null\n    ): Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents> => {\n        // Create STS Command Centre Client namespace\n        this.#namespace[namespace] = {\n            namespace: namespace,\n            pid: process.pid,\n            socketionamespace: io.of(`/${namespace}/`)\n        }\n\n        this.#SetupConnectionMiddleware(this.#namespace[namespace]);\n\n        this.#namespace[namespace].socketionamespace.on(\"connection\", socket => {\n            this.LogMessage(this.#namespace[namespace], `${namespace}: Socket connected, ID: [${socket.id}]`);\n            this.LogMessage(this.#namespace[namespace], `${namespace}: Authentication Handshake: [${JSON.stringify(socket.handshake.auth)}]`);\n\n            this.#SetupMessageMiddleware(socket);\n\n            if (autoJoinRooms) {\n                rooms.map((room) => {\n                    this.JoinRoom(this.#namespace[namespace], socket, room);\n                });\n            }\n\n            this.#SetupStandardEvents(this.#namespace[namespace], socket);\n\n            if (socketConnectCallBack) {\n                setTimeout(() => {\n                    socketConnectCallBack(socket);\n                }, 0);\n            }\n\n            if (socketEventsCallBack) {\n                socketEventsCallBack(socket);\n            }\n        });\n\n        return this.#namespace[namespace].socketionamespace as Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>;\n    }\n\n    GetSTSSocketIONamespace = (namespace: string): STSSocketIONamespace => {\n        return this.#namespace[namespace];\n    }\n\n    GetSTSSocketIONamespaces = (): STSSocketIONamespaces => {\n        return this.#namespace;\n    }\n\n    CloseAdaptors = async (): Promise<void> => {\n        for (const [, namespace] of Object.entries(this.#namespace)) {\n            await namespace.socketionamespace.adapter.close();\n        }\n    }\n\n    DisconnectSockets = (): void => {\n        for (const [, namespace] of Object.entries(this.#namespace)) {\n            namespace.socketionamespace.disconnectSockets();\n        }\n        this.#namespace = { };\n    }\n\n    SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents> {\n        return this as any;\n    }\n}\n"],"names":["STSNamespace","STSRoom","STSEvent","io","socketDetail"],"mappings":"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","x_google_ignoreList":[1]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nsshunt/stssocketioutils",
-  "version": "1.1.21",
+  "version": "1.1.22",
   "description": "STS Socket.IO Utils",
   "main": "./dist/stssocketioutils.umd.js",
   "module": "./dist/stssocketioutils.mjs",

package/types/socketIoServerHelper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socketIoServerHelper.d.ts","sourceRoot":"","sources":["../src/socketIoServerHelper.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAAmB,qBAAqB,EAC3G,4BAA4B,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,YAAY,EACvF,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE3D,qBAAa,oBAAoB,CAAC,oBAAoB,SAAS,8BAA8B,EAAE,oBAAoB,SAAS,8BAA8B,CAAE,YAAW,qBAAqB,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;;gBAKxN,OAAO,EAAE,4BAA4B;IAIjD,UAAU,CAAC,SAAS,EAAE,oBAAoB,EAAE,OAAO,EAAE,GAAG;IAIxD,SAAS,GAAI,WAAW,oBAAoB,EAAE,QAAQ,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,EAAE,MAAM,MAAM,KAAG,IAAI,CAG3H;IAEF,QAAQ,GAAI,WAAW,oBAAoB,EAAE,QAAQ,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,EAAE,MAAM,MAAM,KAAG,IAAI,CAG1H;IAsEF,cAAc,GAAI,IAAI,MAAM,EAAE,WAAW,YAAY,EAAE,OAAO,MAAM,EAAE,EAAE,eAAe,OAAO,EAAE,8CAA8C,CAC1I,uBAAuB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,iBAAiB,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,EACvH,sBAAsB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,iBAAiB,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,KACvH,SAAS,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,iBAAiB,CAAC,CAoC1E;IAED,uBAAuB,GAAI,WAAW,MAAM,KAAG,oBAAoB,CAElE;IAED,wBAAwB,QAAO,qBAAqB,CAEnD;IAED,aAAa,QAAa,OAAO,CAAC,IAAI,CAAC,CAItC;IAED,iBAAiB,QAAO,IAAI,CAK3B;IAED,UAAU,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,aAAa,GAAG,qBAAqB,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;CAGrI"}
+{"version":3,"file":"socketIoServerHelper.d.ts","sourceRoot":"","sources":["../src/socketIoServerHelper.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAAmB,qBAAqB,EAC3G,4BAA4B,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,YAAY,EACvF,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE3D,qBAAa,oBAAoB,CAAC,oBAAoB,SAAS,8BAA8B,EAAE,oBAAoB,SAAS,8BAA8B,CAAE,YAAW,qBAAqB,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;;gBAKxN,OAAO,EAAE,4BAA4B;IAIjD,UAAU,CAAC,SAAS,EAAE,oBAAoB,EAAE,OAAO,EAAE,GAAG;IAQxD,SAAS,GAAI,WAAW,oBAAoB,EAAE,QAAQ,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,EAAE,MAAM,MAAM,KAAG,IAAI,CAG3H;IAEF,QAAQ,GAAI,WAAW,oBAAoB,EAAE,QAAQ,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,EAAE,MAAM,MAAM,KAAG,IAAI,CAG1H;IAsEF,cAAc,GAAI,IAAI,MAAM,EAAE,WAAW,YAAY,EAAE,OAAO,MAAM,EAAE,EAAE,eAAe,OAAO,EAAE,8CAA8C,CAC1I,uBAAuB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,iBAAiB,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,EACvH,sBAAsB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,iBAAiB,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,KACvH,SAAS,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,iBAAiB,CAAC,CAoC1E;IAED,uBAAuB,GAAI,WAAW,MAAM,KAAG,oBAAoB,CAElE;IAED,wBAAwB,QAAO,qBAAqB,CAEnD;IAED,aAAa,QAAa,OAAO,CAAC,IAAI,CAAC,CAItC;IAED,iBAAiB,QAAO,IAAI,CAK3B;IAED,UAAU,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,aAAa,GAAG,qBAAqB,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;CAGrI"}