@nsshunt/stssocketioutils 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 nsshunt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1 @@
+# stssocketioutils

package/dist/stssocketioutils.mjs

@@ -0,0 +1,302 @@
+var __defProp = Object.defineProperty;
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+var _options, _sockets, _agentManager, _SocketIoClientHelper_instances, LogDebugMessage_fn, LogErrorMessage_fn, EstablishSocketConnect_fn, _socketIoServerHelperOptions, _namespace, _SetupStandardEvents, _SetupConnectionMiddleware, _SetupMessageMiddleware;
+import { io } from "socket.io-client";
+import { AgentManager } from "@nsshunt/stsconfig";
+var STSNamespace = /* @__PURE__ */ ((STSNamespace2) => {
+  STSNamespace2["STSMonitor"] = "stsinstrumentmanager/stsmonitor";
+  STSNamespace2["STSControl"] = "stsinstrumentmanager/stscontrol";
+  return STSNamespace2;
+})(STSNamespace || {});
+var STSRoom = /* @__PURE__ */ ((STSRoom2) => {
+  STSRoom2["STSInstrumentDataRoom"] = "stsinstrumentdataroom";
+  STSRoom2["STSInstrumentDataSubscriptionRoom"] = "stsinstrumentdatasubscriptionroom";
+  STSRoom2["STSRunnerRoom"] = "stsrunnerroom";
+  STSRoom2["STSNodeRunnerRoom"] = "stsnoderunnerroom";
+  return STSRoom2;
+})(STSRoom || {});
+var STSEvent = /* @__PURE__ */ ((STSEvent2) => {
+  STSEvent2["STSInstrumentData"] = "stsinstrumentdata";
+  STSEvent2["STSSubInstrumentData"] = "stssubinstrumentdata";
+  STSEvent2["STSResetInstrumentData"] = "stsresetinstrumentdata";
+  STSEvent2["STSStartLoggingInstrumentData"] = "stsStartLoggingInstrumentData";
+  STSEvent2["STSStopLoggingInstrumentData"] = "stsStopLoggingInstrumentData";
+  STSEvent2["STSStart"] = "stsstart";
+  STSEvent2["STSStop"] = "stsstop";
+  STSEvent2["STSPause"] = "stspause";
+  STSEvent2["STSResume"] = "stsresume";
+  STSEvent2["STSTerminate"] = "ststerminate";
+  STSEvent2["STSUpdateStaticConfig"] = "stsupdatestaticconfig";
+  STSEvent2["STSUpdateDynamicConfig"] = "stsupdatedynamicconfig";
+  STSEvent2["STSSendToRoom"] = "sendToRoom";
+  STSEvent2["connect"] = "connect";
+  return STSEvent2;
+})(STSEvent || {});
+const isNode = Object.prototype.toString.call(typeof process !== "undefined" ? process : 0) === "[object process]";
+class SocketIoClientHelper {
+  constructor(options) {
+    __privateAdd(this, _SocketIoClientHelper_instances);
+    __privateAdd(this, _options);
+    __privateAdd(this, _sockets, {});
+    __privateAdd(this, _agentManager, null);
+    __privateSet(this, _options, options);
+    if (isNode) {
+      __privateSet(this, _agentManager, new AgentManager({
+        agentOptions: __privateGet(this, _options).agentOptions
+      }));
+    }
+  }
+  get sockets() {
+    return __privateGet(this, _sockets);
+  }
+  SetupClientSideSocket(name, address, onConnectCallBack, socketEventsCallBack, errorCallBack) {
+    this.sockets[name] = {
+      name,
+      address,
+      socket: null,
+      errorCallBack
+    };
+    __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack);
+    return this.sockets[name].socket;
+  }
+  GetSocket(name) {
+    return this.sockets[name].socket;
+  }
+  GetSocketDetail(name) {
+    return this.sockets[name];
+  }
+}
+_options = new WeakMap();
+_sockets = new WeakMap();
+_agentManager = new WeakMap();
+_SocketIoClientHelper_instances = new WeakSet();
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+LogDebugMessage_fn = function(message) {
+  if (__privateGet(this, _options).logger) __privateGet(this, _options).logger.debug(message);
+};
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+LogErrorMessage_fn = function(message) {
+  if (__privateGet(this, _options).logger) __privateGet(this, _options).logger.error(message);
+};
+EstablishSocketConnect_fn = function(name, onConnectCallBack, socketEventsCallBack) {
+  var _a;
+  const socketDetail = this.sockets[name];
+  if (socketDetail.socket !== null) {
+    if (socketDetail.socket.connected === true) {
+      socketDetail.socket.disconnect();
+    }
+    socketDetail.socket = null;
+    if (isNode) {
+      setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100).unref();
+    } else {
+      setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100);
+    }
+    return;
+  }
+  let socketOptions;
+  if (isNode) {
+    socketOptions = {
+      transports: ["websocket"],
+      // eslint-disable-next-line  @typescript-eslint/no-explicit-any
+      agent: (_a = __privateGet(this, _agentManager)) == null ? void 0 : _a.GetAgent(socketDetail.address)
+    };
+  } else {
+    socketOptions = {
+      transports: ["websocket"]
+    };
+  }
+  socketDetail.socket = io(socketDetail.address, socketOptions);
+  socketDetail.socket.on("connect", () => {
+    if (socketDetail.socket) {
+      __privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, `Socket: [${socketDetail.socket.id}]: connected`);
+      if (onConnectCallBack) {
+        setTimeout(() => {
+          onConnectCallBack(socketDetail.socket);
+        }, 0);
+      }
+      if (socketEventsCallBack) {
+        socketEventsCallBack(socketDetail.socket);
+      }
+    } else {
+      const errorMessage = "Could not get socket object from socket.io";
+      __privateMethod(this, _SocketIoClientHelper_instances, LogErrorMessage_fn).call(this, errorMessage);
+      socketDetail.errorCallBack(new Error(errorMessage));
+    }
+  });
+  socketDetail.socket.on("disconnect", (reason) => {
+    __privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, "socket disconnect: " + reason);
+    switch (reason) {
+      case "io server disconnect":
+        {
+          __privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, "The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.");
+          __privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, "The connection will be re-established when the server becomes available.");
+          const socketDetail2 = this.sockets[name];
+          socketDetail2.socket = null;
+          if (isNode) {
+            setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100).unref();
+          } else {
+            setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100);
+          }
+        }
+        break;
+      case "io client disconnect":
+        __privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, "The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.");
+        __privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, "The connection will not be re-established automatically.");
+        break;
+      case "transport close":
+      case "ping timeout":
+      case "transport error":
+        {
+          __privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, `Server unexpectedly disconnected. Reason: [${reason}]`);
+          __privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, "The connection will be re-established when the server becomes available.");
+          const socketDetail2 = this.sockets[name];
+          if (socketDetail2.socket) {
+            socketDetail2.socket.disconnect();
+          }
+          socketDetail2.socket = null;
+          if (isNode) {
+            setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100).unref();
+          } else {
+            setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100);
+          }
+        }
+        break;
+    }
+  });
+};
+class SocketIoServerHelper {
+  constructor(options) {
+    __privateAdd(this, _socketIoServerHelperOptions);
+    __privateAdd(this, _namespace, {});
+    __publicField(this, "LeaveRoom", (namespace, socket, room) => {
+      this.LogMessage(namespace, `${namespace.socketionamespace.name}: Leaving room [${room}]`);
+      socket.leave(room);
+    });
+    __publicField(this, "JoinRoom", (namespace, socket, room) => {
+      this.LogMessage(namespace, `${namespace.socketionamespace.name}: Socket joining room [${room}], ID: [${socket.id}]`);
+      socket.join(room);
+    });
+    __privateAdd(this, _SetupStandardEvents, (namespace, socket) => {
+      socket.on("disconnect", (reason) => {
+        this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnect, ID: [${socket.id}] [${reason}]`);
+      });
+      socket.on("disconnecting", (reason) => {
+        this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnecting, ID: [${socket.id}] [${reason}]`);
+      });
+      socket.on("error", (error) => {
+        this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket error, ID: [${socket.id}] [${error}]`);
+      });
+      socket.on("__STSdisconnect", (reason) => {
+        this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnect: socket disconnect, ID: [${socket.id}] [${reason}]`);
+      });
+      socket.on("__STSdisconnecting", (reason, callBackResult) => {
+        this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnecting: socket disconnecting, ID: [${socket.id}] [${reason}]`);
+        callBackResult("__STSdisconnecting accepted by server.");
+      });
+      socket.on("__STSjoinRoom", (rooms) => {
+        rooms.forEach((room) => {
+          this.JoinRoom(namespace, socket, room);
+        });
+      });
+      socket.on("__STSleaveRoom", (rooms) => {
+        rooms.forEach((room) => {
+          this.LeaveRoom(namespace, socket, room);
+        });
+      });
+      socket.on("__STSsendToRoom", (rooms, payload) => {
+        rooms.forEach((room) => {
+          this.LogMessage(namespace, `${namespace.socketionamespace.name}:socket.on:sendToRoom: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}]`);
+          namespace.socketionamespace.to(room).emit(payload.command, payload);
+        });
+      });
+    });
+    // Use this middleward to check every incomming connection
+    __privateAdd(this, _SetupConnectionMiddleware, (nameSpace) => {
+      nameSpace.socketionamespace.use((socket, next) => {
+        {
+          next();
+        }
+      });
+    });
+    // Use this middleware to check very packet being received
+    __privateAdd(this, _SetupMessageMiddleware, (socket) => {
+      socket.use(([event, ...args], next) => {
+        next();
+      });
+    });
+    __publicField(this, "SetupNamespace", (io2, namespace, rooms, autoJoinRooms, socketConnectCallBack, socketEventsCallBack) => {
+      __privateGet(this, _namespace)[namespace] = {
+        namespace,
+        pid: process.pid,
+        socketionamespace: io2.of(`/${namespace}/`)
+      };
+      __privateGet(this, _SetupConnectionMiddleware).call(this, __privateGet(this, _namespace)[namespace]);
+      __privateGet(this, _namespace)[namespace].socketionamespace.on("connection", (socket) => {
+        this.LogMessage(__privateGet(this, _namespace)[namespace], `${namespace}: Socket connected, ID: [${socket.id}]`);
+        this.LogMessage(__privateGet(this, _namespace)[namespace], `${namespace}: Authentication Handshake: [${JSON.stringify(socket.handshake.auth)}]`);
+        __privateGet(this, _SetupMessageMiddleware).call(this, socket);
+        if (autoJoinRooms) {
+          rooms.map((room) => {
+            this.JoinRoom(__privateGet(this, _namespace)[namespace], socket, room);
+          });
+        }
+        __privateGet(this, _SetupStandardEvents).call(this, __privateGet(this, _namespace)[namespace], socket);
+        if (socketConnectCallBack) {
+          setTimeout(() => {
+            socketConnectCallBack(socket);
+          }, 0);
+        }
+        if (socketEventsCallBack) {
+          socketEventsCallBack(socket);
+        }
+      });
+      return __privateGet(this, _namespace)[namespace].socketionamespace;
+    });
+    __publicField(this, "GetSTSSocketIONamespace", (namespace) => {
+      return __privateGet(this, _namespace)[namespace];
+    });
+    __publicField(this, "GetSTSSocketIONamespaces", () => {
+      return __privateGet(this, _namespace);
+    });
+    __publicField(this, "CloseAdaptors", async () => {
+      for (const [, namespace] of Object.entries(__privateGet(this, _namespace))) {
+        await namespace.socketionamespace.adapter.close();
+      }
+    });
+    __publicField(this, "DisconnectSockets", () => {
+      for (const [, namespace] of Object.entries(__privateGet(this, _namespace))) {
+        namespace.socketionamespace.disconnectSockets();
+      }
+      __privateSet(this, _namespace, {});
+    });
+    __privateSet(this, _socketIoServerHelperOptions, options);
+  }
+  LogMessage(namespace, message) {
+    __privateGet(this, _socketIoServerHelperOptions).logger.debug(`${namespace.namespace}: ${message}`);
+  }
+  SetupEvent(event, eventCb) {
+    return this;
+  }
+}
+_socketIoServerHelperOptions = new WeakMap();
+_namespace = new WeakMap();
+_SetupStandardEvents = new WeakMap();
+_SetupConnectionMiddleware = new WeakMap();
+_SetupMessageMiddleware = new WeakMap();
+export {
+  STSEvent,
+  STSNamespace,
+  STSRoom,
+  SocketIoClientHelper,
+  SocketIoServerHelper
+};
+//# sourceMappingURL=stssocketioutils.mjs.map

package/dist/stssocketioutils.mjs.map

@@ -0,0 +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}\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    CloseAdaptors: () => Promise<void>\n    SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\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 } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes'\nimport { AgentManager } from '@nsshunt/stsconfig';\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    agentOptions?: {\n\t\tkeepAlive: boolean,\n\t\tmaxSockets: number\n\t\tmaxTotalSockets: number,\n\t\tmaxFreeSockets: number,\n\t\ttimeout: number,\n\t\trejectUnauthorized: boolean // Allows self signed certs in non production mode(s)\n\t}\n    logger?: ISTSLogger\n}\n\nexport class SocketIoClientHelper<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents>\n{\n    #options: ISocketIoClientHelperOptions\n    #sockets: Record<string, ISocketDetail> = { }\n    #agentManager: AgentManager | null = null;\n\n    constructor(options: ISocketIoClientHelperOptions) {\n        this.#options = options;\n        if (isNode) {\n            this.#agentManager = new AgentManager({\n                agentOptions: this.#options.agentOptions\n            });\n        }\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, \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, 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, 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, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n            } else {\n                setTimeout(() => this.#EstablishSocketConnect(name, 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                // eslint-disable-next-line  @typescript-eslint/no-explicit-any\n                agent: this.#agentManager?.GetAgent(socketDetail.address) as any\n            }\n            // This also works for self signed certs\n            //rejectUnauthorized: goptions.isProduction // Allows self signed certs in non production mode(s)\n\n            //reconnection: true\n            //auth: {\n            //\ttoken: \"abcd\"\n            //}\n            //,path: '/zzz'\n        } else {\n            socketOptions = {\n                transports: [\"websocket\" ]\n            }\n        }\n        socketDetail.socket = io(socketDetail.address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n        socketDetail.socket.on(\"connect\", () => {\n            if (socketDetail.socket) {\n                this.#LogDebugMessage(`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 = '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        {\n            this.#LogDebugMessage('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('The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n                this.#LogDebugMessage('The connection will be re-established when the server becomes available.');\n                const socketDetail: ISocketDetail = this.sockets[name];\n                socketDetail.socket = null;\n                if (isNode) {\n                    setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n                }\n            }\n                break;\n            case 'io client disconnect' :\n                this.#LogDebugMessage('The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n                this.#LogDebugMessage('The connection will not be re-established automatically.');\n                // Do nothing\n                break;\n            case 'transport close' :\n            case 'ping timeout' :\n            case 'transport error' : {\n                this.#LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);\n                this.#LogDebugMessage('The connection will be re-established when the server becomes available.');\n                const socketDetail: ISocketDetail = this.sockets[name];\n                if (socketDetail.socket) {\n                    socketDetail.socket.disconnect();\n                }\n                socketDetail.socket = null;\n                if (isNode) {\n                    setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(name, 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]}

package/dist/stssocketioutils.umd.js

@@ -0,0 +1,304 @@
+(function(global, factory) {
+  typeof exports === "object" && typeof module !== "undefined" ? factory(exports, require("socket.io-client"), require("@nsshunt/stsconfig")) : typeof define === "function" && define.amd ? define(["exports", "socket.io-client", "@nsshunt/stsconfig"], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, factory(global["@nsshunt/stssocketioutils"] = {}, global.socket["io-client"], global.stsconfig));
+})(this, function(exports2, socket_ioClient, stsconfig) {
+  "use strict";var __defProp = Object.defineProperty;
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+
+  var _options, _sockets, _agentManager, _SocketIoClientHelper_instances, LogDebugMessage_fn, LogErrorMessage_fn, EstablishSocketConnect_fn, _socketIoServerHelperOptions, _namespace, _SetupStandardEvents, _SetupConnectionMiddleware, _SetupMessageMiddleware;
+  var STSNamespace = /* @__PURE__ */ ((STSNamespace2) => {
+    STSNamespace2["STSMonitor"] = "stsinstrumentmanager/stsmonitor";
+    STSNamespace2["STSControl"] = "stsinstrumentmanager/stscontrol";
+    return STSNamespace2;
+  })(STSNamespace || {});
+  var STSRoom = /* @__PURE__ */ ((STSRoom2) => {
+    STSRoom2["STSInstrumentDataRoom"] = "stsinstrumentdataroom";
+    STSRoom2["STSInstrumentDataSubscriptionRoom"] = "stsinstrumentdatasubscriptionroom";
+    STSRoom2["STSRunnerRoom"] = "stsrunnerroom";
+    STSRoom2["STSNodeRunnerRoom"] = "stsnoderunnerroom";
+    return STSRoom2;
+  })(STSRoom || {});
+  var STSEvent = /* @__PURE__ */ ((STSEvent2) => {
+    STSEvent2["STSInstrumentData"] = "stsinstrumentdata";
+    STSEvent2["STSSubInstrumentData"] = "stssubinstrumentdata";
+    STSEvent2["STSResetInstrumentData"] = "stsresetinstrumentdata";
+    STSEvent2["STSStartLoggingInstrumentData"] = "stsStartLoggingInstrumentData";
+    STSEvent2["STSStopLoggingInstrumentData"] = "stsStopLoggingInstrumentData";
+    STSEvent2["STSStart"] = "stsstart";
+    STSEvent2["STSStop"] = "stsstop";
+    STSEvent2["STSPause"] = "stspause";
+    STSEvent2["STSResume"] = "stsresume";
+    STSEvent2["STSTerminate"] = "ststerminate";
+    STSEvent2["STSUpdateStaticConfig"] = "stsupdatestaticconfig";
+    STSEvent2["STSUpdateDynamicConfig"] = "stsupdatedynamicconfig";
+    STSEvent2["STSSendToRoom"] = "sendToRoom";
+    STSEvent2["connect"] = "connect";
+    return STSEvent2;
+  })(STSEvent || {});
+  const isNode = Object.prototype.toString.call(typeof process !== "undefined" ? process : 0) === "[object process]";
+  class SocketIoClientHelper {
+    constructor(options) {
+      __privateAdd(this, _SocketIoClientHelper_instances);
+      __privateAdd(this, _options);
+      __privateAdd(this, _sockets, {});
+      __privateAdd(this, _agentManager, null);
+      __privateSet(this, _options, options);
+      if (isNode) {
+        __privateSet(this, _agentManager, new stsconfig.AgentManager({
+          agentOptions: __privateGet(this, _options).agentOptions
+        }));
+      }
+    }
+    get sockets() {
+      return __privateGet(this, _sockets);
+    }
+    SetupClientSideSocket(name, address, onConnectCallBack, socketEventsCallBack, errorCallBack) {
+      this.sockets[name] = {
+        name,
+        address,
+        socket: null,
+        errorCallBack
+      };
+      __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack);
+      return this.sockets[name].socket;
+    }
+    GetSocket(name) {
+      return this.sockets[name].socket;
+    }
+    GetSocketDetail(name) {
+      return this.sockets[name];
+    }
+  }
+  _options = new WeakMap();
+  _sockets = new WeakMap();
+  _agentManager = new WeakMap();
+  _SocketIoClientHelper_instances = new WeakSet();
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  LogDebugMessage_fn = function(message) {
+    if (__privateGet(this, _options).logger) __privateGet(this, _options).logger.debug(message);
+  };
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  LogErrorMessage_fn = function(message) {
+    if (__privateGet(this, _options).logger) __privateGet(this, _options).logger.error(message);
+  };
+  EstablishSocketConnect_fn = function(name, onConnectCallBack, socketEventsCallBack) {
+    var _a;
+    const socketDetail = this.sockets[name];
+    if (socketDetail.socket !== null) {
+      if (socketDetail.socket.connected === true) {
+        socketDetail.socket.disconnect();
+      }
+      socketDetail.socket = null;
+      if (isNode) {
+        setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100).unref();
+      } else {
+        setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100);
+      }
+      return;
+    }
+    let socketOptions;
+    if (isNode) {
+      socketOptions = {
+        transports: ["websocket"],
+        // eslint-disable-next-line  @typescript-eslint/no-explicit-any
+        agent: (_a = __privateGet(this, _agentManager)) == null ? void 0 : _a.GetAgent(socketDetail.address)
+      };
+    } else {
+      socketOptions = {
+        transports: ["websocket"]
+      };
+    }
+    socketDetail.socket = socket_ioClient.io(socketDetail.address, socketOptions);
+    socketDetail.socket.on("connect", () => {
+      if (socketDetail.socket) {
+        __privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, `Socket: [${socketDetail.socket.id}]: connected`);
+        if (onConnectCallBack) {
+          setTimeout(() => {
+            onConnectCallBack(socketDetail.socket);
+          }, 0);
+        }
+        if (socketEventsCallBack) {
+          socketEventsCallBack(socketDetail.socket);
+        }
+      } else {
+        const errorMessage = "Could not get socket object from socket.io";
+        __privateMethod(this, _SocketIoClientHelper_instances, LogErrorMessage_fn).call(this, errorMessage);
+        socketDetail.errorCallBack(new Error(errorMessage));
+      }
+    });
+    socketDetail.socket.on("disconnect", (reason) => {
+      __privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, "socket disconnect: " + reason);
+      switch (reason) {
+        case "io server disconnect":
+          {
+            __privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, "The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.");
+            __privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, "The connection will be re-established when the server becomes available.");
+            const socketDetail2 = this.sockets[name];
+            socketDetail2.socket = null;
+            if (isNode) {
+              setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100).unref();
+            } else {
+              setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100);
+            }
+          }
+          break;
+        case "io client disconnect":
+          __privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, "The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.");
+          __privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, "The connection will not be re-established automatically.");
+          break;
+        case "transport close":
+        case "ping timeout":
+        case "transport error":
+          {
+            __privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, `Server unexpectedly disconnected. Reason: [${reason}]`);
+            __privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, "The connection will be re-established when the server becomes available.");
+            const socketDetail2 = this.sockets[name];
+            if (socketDetail2.socket) {
+              socketDetail2.socket.disconnect();
+            }
+            socketDetail2.socket = null;
+            if (isNode) {
+              setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100).unref();
+            } else {
+              setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100);
+            }
+          }
+          break;
+      }
+    });
+  };
+  class SocketIoServerHelper {
+    constructor(options) {
+      __privateAdd(this, _socketIoServerHelperOptions);
+      __privateAdd(this, _namespace, {});
+      __publicField(this, "LeaveRoom", (namespace, socket, room) => {
+        this.LogMessage(namespace, `${namespace.socketionamespace.name}: Leaving room [${room}]`);
+        socket.leave(room);
+      });
+      __publicField(this, "JoinRoom", (namespace, socket, room) => {
+        this.LogMessage(namespace, `${namespace.socketionamespace.name}: Socket joining room [${room}], ID: [${socket.id}]`);
+        socket.join(room);
+      });
+      __privateAdd(this, _SetupStandardEvents, (namespace, socket) => {
+        socket.on("disconnect", (reason) => {
+          this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnect, ID: [${socket.id}] [${reason}]`);
+        });
+        socket.on("disconnecting", (reason) => {
+          this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnecting, ID: [${socket.id}] [${reason}]`);
+        });
+        socket.on("error", (error) => {
+          this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket error, ID: [${socket.id}] [${error}]`);
+        });
+        socket.on("__STSdisconnect", (reason) => {
+          this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnect: socket disconnect, ID: [${socket.id}] [${reason}]`);
+        });
+        socket.on("__STSdisconnecting", (reason, callBackResult) => {
+          this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnecting: socket disconnecting, ID: [${socket.id}] [${reason}]`);
+          callBackResult("__STSdisconnecting accepted by server.");
+        });
+        socket.on("__STSjoinRoom", (rooms) => {
+          rooms.forEach((room) => {
+            this.JoinRoom(namespace, socket, room);
+          });
+        });
+        socket.on("__STSleaveRoom", (rooms) => {
+          rooms.forEach((room) => {
+            this.LeaveRoom(namespace, socket, room);
+          });
+        });
+        socket.on("__STSsendToRoom", (rooms, payload) => {
+          rooms.forEach((room) => {
+            this.LogMessage(namespace, `${namespace.socketionamespace.name}:socket.on:sendToRoom: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}]`);
+            namespace.socketionamespace.to(room).emit(payload.command, payload);
+          });
+        });
+      });
+      // Use this middleward to check every incomming connection
+      __privateAdd(this, _SetupConnectionMiddleware, (nameSpace) => {
+        nameSpace.socketionamespace.use((socket, next) => {
+          {
+            next();
+          }
+        });
+      });
+      // Use this middleware to check very packet being received
+      __privateAdd(this, _SetupMessageMiddleware, (socket) => {
+        socket.use(([event, ...args], next) => {
+          next();
+        });
+      });
+      __publicField(this, "SetupNamespace", (io, namespace, rooms, autoJoinRooms, socketConnectCallBack, socketEventsCallBack) => {
+        __privateGet(this, _namespace)[namespace] = {
+          namespace,
+          pid: process.pid,
+          socketionamespace: io.of(`/${namespace}/`)
+        };
+        __privateGet(this, _SetupConnectionMiddleware).call(this, __privateGet(this, _namespace)[namespace]);
+        __privateGet(this, _namespace)[namespace].socketionamespace.on("connection", (socket) => {
+          this.LogMessage(__privateGet(this, _namespace)[namespace], `${namespace}: Socket connected, ID: [${socket.id}]`);
+          this.LogMessage(__privateGet(this, _namespace)[namespace], `${namespace}: Authentication Handshake: [${JSON.stringify(socket.handshake.auth)}]`);
+          __privateGet(this, _SetupMessageMiddleware).call(this, socket);
+          if (autoJoinRooms) {
+            rooms.map((room) => {
+              this.JoinRoom(__privateGet(this, _namespace)[namespace], socket, room);
+            });
+          }
+          __privateGet(this, _SetupStandardEvents).call(this, __privateGet(this, _namespace)[namespace], socket);
+          if (socketConnectCallBack) {
+            setTimeout(() => {
+              socketConnectCallBack(socket);
+            }, 0);
+          }
+          if (socketEventsCallBack) {
+            socketEventsCallBack(socket);
+          }
+        });
+        return __privateGet(this, _namespace)[namespace].socketionamespace;
+      });
+      __publicField(this, "GetSTSSocketIONamespace", (namespace) => {
+        return __privateGet(this, _namespace)[namespace];
+      });
+      __publicField(this, "GetSTSSocketIONamespaces", () => {
+        return __privateGet(this, _namespace);
+      });
+      __publicField(this, "CloseAdaptors", async () => {
+        for (const [, namespace] of Object.entries(__privateGet(this, _namespace))) {
+          await namespace.socketionamespace.adapter.close();
+        }
+      });
+      __publicField(this, "DisconnectSockets", () => {
+        for (const [, namespace] of Object.entries(__privateGet(this, _namespace))) {
+          namespace.socketionamespace.disconnectSockets();
+        }
+        __privateSet(this, _namespace, {});
+      });
+      __privateSet(this, _socketIoServerHelperOptions, options);
+    }
+    LogMessage(namespace, message) {
+      __privateGet(this, _socketIoServerHelperOptions).logger.debug(`${namespace.namespace}: ${message}`);
+    }
+    SetupEvent(event, eventCb) {
+      return this;
+    }
+  }
+  _socketIoServerHelperOptions = new WeakMap();
+  _namespace = new WeakMap();
+  _SetupStandardEvents = new WeakMap();
+  _SetupConnectionMiddleware = new WeakMap();
+  _SetupMessageMiddleware = new WeakMap();
+  exports2.STSEvent = STSEvent;
+  exports2.STSNamespace = STSNamespace;
+  exports2.STSRoom = STSRoom;
+  exports2.SocketIoClientHelper = SocketIoClientHelper;
+  exports2.SocketIoServerHelper = SocketIoServerHelper;
+  Object.defineProperty(exports2, Symbol.toStringTag, { value: "Module" });
+});
+//# sourceMappingURL=stssocketioutils.umd.js.map

package/dist/stssocketioutils.umd.js.map

@@ -0,0 +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}\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    CloseAdaptors: () => Promise<void>\n    SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\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 } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes'\nimport { AgentManager } from '@nsshunt/stsconfig';\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    agentOptions?: {\n\t\tkeepAlive: boolean,\n\t\tmaxSockets: number\n\t\tmaxTotalSockets: number,\n\t\tmaxFreeSockets: number,\n\t\ttimeout: number,\n\t\trejectUnauthorized: boolean // Allows self signed certs in non production mode(s)\n\t}\n    logger?: ISTSLogger\n}\n\nexport class SocketIoClientHelper<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents>\n{\n    #options: ISocketIoClientHelperOptions\n    #sockets: Record<string, ISocketDetail> = { }\n    #agentManager: AgentManager | null = null;\n\n    constructor(options: ISocketIoClientHelperOptions) {\n        this.#options = options;\n        if (isNode) {\n            this.#agentManager = new AgentManager({\n                agentOptions: this.#options.agentOptions\n            });\n        }\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, \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, 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, 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, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n            } else {\n                setTimeout(() => this.#EstablishSocketConnect(name, 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                // eslint-disable-next-line  @typescript-eslint/no-explicit-any\n                agent: this.#agentManager?.GetAgent(socketDetail.address) as any\n            }\n            // This also works for self signed certs\n            //rejectUnauthorized: goptions.isProduction // Allows self signed certs in non production mode(s)\n\n            //reconnection: true\n            //auth: {\n            //\ttoken: \"abcd\"\n            //}\n            //,path: '/zzz'\n        } else {\n            socketOptions = {\n                transports: [\"websocket\" ]\n            }\n        }\n        socketDetail.socket = io(socketDetail.address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n        socketDetail.socket.on(\"connect\", () => {\n            if (socketDetail.socket) {\n                this.#LogDebugMessage(`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 = '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        {\n            this.#LogDebugMessage('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('The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n                this.#LogDebugMessage('The connection will be re-established when the server becomes available.');\n                const socketDetail: ISocketDetail = this.sockets[name];\n                socketDetail.socket = null;\n                if (isNode) {\n                    setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n                }\n            }\n                break;\n            case 'io client disconnect' :\n                this.#LogDebugMessage('The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n                this.#LogDebugMessage('The connection will not be re-established automatically.');\n                // Do nothing\n                break;\n            case 'transport close' :\n            case 'ping timeout' :\n            case 'transport error' : {\n                this.#LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);\n                this.#LogDebugMessage('The connection will be re-established when the server becomes available.');\n                const socketDetail: ISocketDetail = this.sockets[name];\n                if (socketDetail.socket) {\n                    socketDetail.socket.disconnect();\n                }\n                socketDetail.socket = null;\n                if (isNode) {\n                    setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n                } else {\n                    setTimeout(() => this.#EstablishSocketConnect(name, 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","AgentManager","io","socketDetail"],"mappings":";;;;;;;;;;;;;;;;AAiEY,MAAA,iCAAAA,kBAAL;AACNA,kBAAA,YAAa,IAAA;AACbA,kBAAA,YAAa,IAAA;AAFFA,WAAAA;AAAAA,EAAA,GAAA,gBAAA,CAAA,CAAA;AAKA,MAAA,4BAAAC,aAAL;AAENA,aAAA,uBAAwB,IAAA;AACxBA,aAAA,mCAAoC,IAAA;AAGpCA,aAAA,eAAgB,IAAA;AAChBA,aAAA,mBAAoB,IAAA;AAPTA,WAAAA;AAAAA,EAAA,GAAA,WAAA,CAAA,CAAA;AAUA,MAAA,6BAAAC,cAAL;AAENA,cAAA,mBAAoB,IAAA;AACpBA,cAAA,sBAAuB,IAAA;AACvBA,cAAA,wBAAyB,IAAA;AAEzBA,cAAA,+BAAgC,IAAA;AAChCA,cAAA,8BAA+B,IAAA;AAG/BA,cAAA,UAAW,IAAA;AACXA,cAAA,SAAU,IAAA;AACVA,cAAA,UAAW,IAAA;AACXA,cAAA,WAAY,IAAA;AACZA,cAAA,cAAe,IAAA;AAGfA,cAAA,uBAAwB,IAAA;AACxBA,cAAA,wBAAyB,IAAA;AAGzBA,cAAA,eAAgB,IAAA;AAGhBA,cAAA,SAAU,IAAA;AAxBCA,WAAAA;AAAAA,EAAA,GAAA,YAAA,CAAA,CAAA;AC/EZ,QAAA,SAAe,OAAO,UAAU,SAAS,KAAK,OAAO,YAAY,cAAc,UAAU,CAAC,MAAM;AAAA,ECmDzF,MAAM,qBACb;AAAA,IAKI,YAAY,SAAuC;AANhD;AAEH;AACA,mCAA0C,CAAE;AAC5C,wCAAqC;AAGjC,yBAAK,UAAW;AAChB,UAAI,QAAQ;AACH,2BAAA,eAAgB,IAAIC,uBAAa;AAAA,UAClC,cAAc,mBAAK,UAAS;AAAA,QAAA,CAC/B;AAAA,MAAA;AAAA,IACL;AAAA,IAaJ,IAAI,UAAyC;AACzC,aAAO,mBAAK;AAAA,IAAA;AAAA,IAGhB,sBAAsB,MAAc,SAChC,mBACA,sBACA,eACkD;AAC7C,WAAA,QAAQ,IAAI,IAAI;AAAA,QACjB;AAAA,QACA;AAAA,QACA,QAAQ;AAAA,QACR;AAAA,MACJ;AACK,4BAAA,4DAAA,WAAwB,MAAM,mBAAmB;AAC/C,aAAA,KAAK,QAAQ,IAAI,EAAE;AAAA,IAAA;AAAA,IAG9B,UAAU,MAAkE;AACjE,aAAA,KAAK,QAAQ,IAAI,EAAE;AAAA,IAAA;AAAA,IAG9B,gBAAgB,MAA6B;AAClC,aAAA,KAAK,QAAQ,IAAI;AAAA,IAAA;AAAA,EA8GhC;AA7JI;AACA;AACA;AAJG;AAgBH;AAAA,gCAAiB,SAAoB;AACjC,QAAI,mBAAK,UAAS,2BAAa,UAAS,OAAO,MAAM,OAAO;AAAA,EAAA;AAIhE;AAAA,gCAAiB,SAAoB;AACjC,QAAI,mBAAK,UAAS,2BAAa,UAAS,OAAO,MAAM,OAAO;AAAA,EAAA;AA8BhE,8BAAA,SAAwB,MAAc,mBAClC,sBACJ;;AACU,UAAA,eAA8B,KAAK,QAAQ,IAAI;AAEjD,QAAA,aAAa,WAAW,MAAM;AAE1B,UAAA,aAAa,OAAO,cAAc,MAAM;AACxC,qBAAa,OAAO,WAAW;AAAA,MAAA;AAEnC,mBAAa,SAAS;AACtB,UAAI,QAAQ;AACG,mBAAA,MAAM,sBAAK,4DAAL,WAA6B,MAAM,mBAAmB,uBAAuB,GAAG,EAAE,MAAM;AAAA,MAAA,OACtG;AACH,mBAAW,MAAM,sBAAK,4DAAL,WAA6B,MAAM,mBAAmB,uBAAuB,GAAG;AAAA,MAAA;AAErG;AAAA,IAAA;AAGA,QAAA;AACJ,QAAI,QAAQ;AAGQ,sBAAA;AAAA,QACZ,YAAY,CAAC,WAAY;AAAA;AAAA,QAEzB,QAAO,wBAAK,mBAAL,mBAAoB,SAAS,aAAa;AAAA,MACrD;AAAA,IAAA,OASG;AACa,sBAAA;AAAA,QACZ,YAAY,CAAC,WAAY;AAAA,MAC7B;AAAA,IAAA;AAEJ,iBAAa,SAASC,gBAAAA,GAAG,aAAa,SAAS,aAAa;AAE/C,iBAAA,OAAO,GAAG,WAAW,MAAM;AACpC,UAAI,aAAa,QAAQ;AACrB,8BAAK,qDAAL,WAAsB,YAAY,aAAa,OAAO,EAAE;AAExD,YAAI,mBAAmB;AACnB,qBAAW,MAAM;AACb,8BAAkB,aAAa,MAA4D;AAAA,aAC5F,CAAC;AAAA,QAAA;AAGR,YAAI,sBAAsB;AACtB,+BAAqB,aAAa,MAAM;AAAA,QAAA;AAAA,MAC5C,OAEG;AACH,cAAM,eAAuB;AAC7B,8BAAK,qDAAL,WAAsB;AACtB,qBAAa,cAAc,IAAI,MAAM,YAAY,CAAC;AAAA,MAAA;AAAA,IACtD,CACH;AAGD,iBAAa,OAAO,GAAG,cAAc,CAAC,WACtC;AACS,4BAAA,qDAAA,WAAiB,wBAAwB;AAC9C,cAAQ,QAAQ;AAAA,QAChB,KAAK;AAAyB;AAE1B,kCAAK,qDAAL,WAAsB;AACtB,kCAAK,qDAAL,WAAsB;AAChBC,kBAAAA,gBAA8B,KAAK,QAAQ,IAAI;AACrDA,0BAAa,SAAS;AACtB,gBAAI,QAAQ;AACG,yBAAA,MAAM,sBAAK,4DAAL,WAA6B,MAAM,mBAAmB,uBAAuB,GAAG,EAAE,MAAM;AAAA,YAAA,OACtG;AACH,yBAAW,MAAM,sBAAK,4DAAL,WAA6B,MAAM,mBAAmB,uBAAuB,GAAG;AAAA,YAAA;AAAA,UACrG;AAEA;AAAA,QACJ,KAAK;AACD,gCAAK,qDAAL,WAAsB;AACtB,gCAAK,qDAAL,WAAsB;AAEtB;AAAA,QACJ,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAoB;AAChB,kCAAA,qDAAA,WAAiB,8CAA8C,MAAM;AAC1E,kCAAK,qDAAL,WAAsB;AAChBA,kBAAAA,gBAA8B,KAAK,QAAQ,IAAI;AACrD,gBAAIA,cAAa,QAAQ;AACrBA,4BAAa,OAAO,WAAW;AAAA,YAAA;AAEnCA,0BAAa,SAAS;AACtB,gBAAI,QAAQ;AACG,yBAAA,MAAM,sBAAK,4DAAL,WAA6B,MAAM,mBAAmB,uBAAuB,GAAG,EAAE,MAAM;AAAA,YAAA,OACtG;AACH,yBAAW,MAAM,sBAAK,4DAAL,WAA6B,MAAM,mBAAmB,uBAAuB,GAAG;AAAA,YAAA;AAAA,UACrG;AAEA;AAAA,MAAA;AAAA,IACJ,CACH;AAAA,EAAA;AAAA,ECxMF,MAAM,qBACb;AAAA,IAII,YAAY,SAAuC;AAHnD;AACA,qCAAoC,CAAE;AAUtC,uCAAY,CAAC,WAAiC,QAA4D,SAAuB;AACxH,aAAA,WAAW,WAAW,GAAG,UAAU,kBAAkB,IAAI,mBAAmB,IAAI,GAAG;AACxF,eAAO,MAAM,IAAI;AAAA,MACrB;AAEA,sCAAW,CAAC,WAAiC,QAA4D,SAAuB;AACvH,aAAA,WAAW,WAAW,GAAG,UAAU,kBAAkB,IAAI,0BAA0B,IAAI,WAAW,OAAO,EAAE,GAAG;AACnH,eAAO,KAAK,IAAI;AAAA,MACpB;AAEA,+CAAuB,CAAC,WAAiC,WAAyF;AACvI,eAAA,GAAG,cAAc,CAAC,WAAmB;AACnC,eAAA,WAAW,WAAW,GAAG,UAAU,kBAAkB,IAAI,6BAA6B,OAAO,EAAE,MAAM,MAAM,GAAG;AAAA,QAAA,CACtH;AAEM,eAAA,GAAG,iBAAiB,CAAC,WAAmB;AACtC,eAAA,WAAW,WAAW,GAAG,UAAU,kBAAkB,IAAI,gCAAgC,OAAO,EAAE,MAAM,MAAM,GAAG;AAAA,QAAA,CACzH;AAEM,eAAA,GAAG,SAAS,CAAC,UAAiB;AAC5B,eAAA,WAAW,WAAW,GAAG,UAAU,kBAAkB,IAAI,wBAAwB,OAAO,EAAE,MAAM,KAAK,GAAG;AAAA,QAAA,CAChH;AAEM,eAAA,GAAG,mBAAmB,CAAC,WAAmB;AACxC,eAAA,WAAW,WAAW,GAAG,UAAU,kBAAkB,IAAI,8CAA8C,OAAO,EAAE,MAAM,MAAM,GAAG;AAAA,QAAA,CACvI;AAED,eAAO,GAAG,sBAAsB,CAAC,QAAQ,mBAAmB;AACnD,eAAA,WAAW,WAAW,GAAG,UAAU,kBAAkB,IAAI,oDAAoD,OAAO,EAAE,MAAM,MAAM,GAAG;AAC1I,yBAAe,wCAAwC;AAAA,QAAA,CAC1D;AAEM,eAAA,GAAG,iBAAiB,CAAC,UAA0B;AAC5C,gBAAA,QAAQ,CAAC,SAAS;AACf,iBAAA,SAAS,WAAW,QAAQ,IAAI;AAAA,UAAA,CACxC;AAAA,QAAA,CACJ;AAEM,eAAA,GAAG,kBAAkB,CAAC,UAA0B;AAC7C,gBAAA,QAAQ,CAAC,SAAS;AACf,iBAAA,UAAU,WAAW,QAAQ,IAAI;AAAA,UAAA,CACzC;AAAA,QAAA,CACJ;AAED,eAAO,GAAG,mBAAmB,CAAC,OAAiB,YAA4D;AACjG,gBAAA,QAAQ,CAAC,SAAS;AACf,iBAAA,WAAW,WAAW,GAAG,UAAU,kBAAkB,IAAI,4DAA4D,IAAI,WAAW,OAAO,EAAE,GAAG;AAErJ,sBAAU,kBAAkB,GAAG,IAAI,EAAE,KAAK,QAAQ,SAAgB,OAAO;AAAA,UAAA,CAC5E;AAAA,QAAA,CACJ;AAAA,MACL;AAGA;AAAA,qDAA6B,CAAC,cAAoC;AAC9D,kBAAU,kBAAkB,IAAI,CAAC,QAAQ,SAAS;AAGjC;AACJ,iBAAA;AAAA,UAAA;AAAA,QAGT,CACH;AAAA,MACL;AAGA;AAAA,kDAA0B,CAAC,WAA4B;AACnD,eAAO,IAAI,CAAC,CAAC,OAAU,OAAI,GAAG,SAAS;AAM9B,eAAA;AAAA,QAAA,CACR;AAAA,MACL;AAEA,4CAAiB,CAAC,IAAY,WAAyB,OAAiB,eACpE,uBACA,yBAC2E;AAEtE,2BAAA,YAAW,SAAS,IAAI;AAAA,UACzB;AAAA,UACA,KAAK,QAAQ;AAAA,UACb,mBAAmB,GAAG,GAAG,IAAI,SAAS,GAAG;AAAA,QAC7C;AAEA,2BAAK,4BAAL,WAAgC,mBAAK,YAAW,SAAS;AAEzD,2BAAK,YAAW,SAAS,EAAE,kBAAkB,GAAG,cAAc,CAAU,WAAA;AAC/D,eAAA,WAAW,mBAAK,YAAW,SAAS,GAAG,GAAG,SAAS,4BAA4B,OAAO,EAAE,GAAG;AAChG,eAAK,WAAW,mBAAK,YAAW,SAAS,GAAG,GAAG,SAAS,gCAAgC,KAAK,UAAU,OAAO,UAAU,IAAI,CAAC,GAAG;AAEhI,6BAAK,yBAAL,WAA6B;AAE7B,cAAI,eAAe;AACT,kBAAA,IAAI,CAAC,SAAS;AAChB,mBAAK,SAAS,mBAAK,YAAW,SAAS,GAAG,QAAQ,IAAI;AAAA,YAAA,CACzD;AAAA,UAAA;AAGL,6BAAK,sBAAL,WAA0B,mBAAK,YAAW,SAAS,GAAG;AAEtD,cAAI,uBAAuB;AACvB,uBAAW,MAAM;AACb,oCAAsB,MAAM;AAAA,eAC7B,CAAC;AAAA,UAAA;AAGR,cAAI,sBAAsB;AACtB,iCAAqB,MAAM;AAAA,UAAA;AAAA,QAC/B,CACH;AAEM,eAAA,mBAAK,YAAW,SAAS,EAAE;AAAA,MACtC;AAEA,qDAA0B,CAAC,cAA4C;AAC5D,eAAA,mBAAK,YAAW,SAAS;AAAA,MACpC;AAEA,sDAA2B,MAA6B;AACpD,eAAO,mBAAK;AAAA,MAChB;AAEA,2CAAgB,YAA2B;AAC5B,mBAAA,CAAG,EAAA,SAAS,KAAK,OAAO,QAAQ,mBAAK,WAAU,GAAG;AACnD,gBAAA,UAAU,kBAAkB,QAAQ,MAAM;AAAA,QAAA;AAAA,MAExD;AAEA,+CAAoB,MAAY;AACjB,mBAAA,CAAG,EAAA,SAAS,KAAK,OAAO,QAAQ,mBAAK,WAAU,GAAG;AACzD,oBAAU,kBAAkB,kBAAkB;AAAA,QAAA;AAElD,2BAAK,YAAa,CAAE;AAAA,MACxB;AAjJI,yBAAK,8BAA+B;AAAA,IAAA;AAAA,IAGxC,WAAW,WAAiC,SAAc;AACjD,yBAAA,8BAA6B,OAAO,MAAM,GAAG,UAAU,SAAS,KAAK,OAAO,EAAE;AAAA,IAAA;AAAA,IA+IvF,WAAW,OAA6B,SAA2F;AACxH,aAAA;AAAA,IAAA;AAAA,EAEf;AA1JI;AACA;AAoBA;AA4CA;AAaA;;;;;;;;","x_google_ignoreList":[1]}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@nsshunt/stssocketioutils",
+  "version": "1.0.1",
+  "description": "STS Socket.IO Utils",
+  "main": "./dist/stssocketioutils.umd.js",
+  "module": "./dist/stssocketioutils.mjs",
+  "type": "commonjs",
+  "types": "./types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/stssocketioutils.mjs",
+      "require": "./dist/stssocketioutils.umd.js"
+    }
+  },
+  "files": [
+    "dist",
+    "types",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "lint": "eslint .",
+    "lintex": "eslint . --fix",
+    "test": "DEBUG=testcontainers:containers vitest run --reporter verbose --pool forks",
+    "test2": "jest --detectOpenHandles --no-cache",
+    "testwatch": "jest --watchAll --detectOpenHandles --no-cache",
+    "build": "tsc && vite build",
+    "build2": "tsc"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nsshunt/stssocketioutils.git"
+  },
+  "author": "STS",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/nsshunt/stssocketioutils/issues"
+  },
+  "homepage": "https://github.com/nsshunt/stssocketioutils#readme",
+  "devDependencies": {
+    "@babel/preset-env": "^7.26.0",
+    "@babel/preset-typescript": "^7.26.0",
+    "@eslint/eslintrc": "^3.1.0",
+    "@eslint/js": "^9.14.0",
+    "@tsconfig/node20": "^20.1.4",
+    "@types/detect-node": "^2.0.2",
+    "@types/uuid": "^10.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.13.0",
+    "@typescript-eslint/parser": "^8.13.0",
+    "eslint": "^9.14.0",
+    "globals": "^15.12.0",
+    "jest": "^29.7.0",
+    "testcontainers": "^10.14.0",
+    "typescript": "^5.6.3",
+    "vite": "^5.4.10",
+    "vitest": "^2.1.4"
+  },
+  "dependencies": {
+    "@nsshunt/stsconfig": "^1.25.167",
+    "@nsshunt/stsutils": "^1.16.91",
+    "@socket.io/cluster-adapter": "^0.2.2",
+    "@socket.io/redis-adapter": "^8.3.0",
+    "@socket.io/redis-streams-adapter": "^0.2.2",
+    "chalk": "^4.1.2",
+    "detect-node": "^2.1.0",
+    "ioredis": "^5.4.1",
+    "redis": "^4.7.0",
+    "socket.io": "^4.8.1",
+    "socket.io-client": "^4.8.1",
+    "uuid": "^10.0.0",
+    "winston": "^3.16.0"
+  }
+}

package/types/commonTypes.d.ts

@@ -0,0 +1,105 @@
+import { Server, Socket, Namespace } from "socket.io";
+import { ISTSLogger } from '@nsshunt/stsutils';
+export interface STSDefaultClientToServerEvents {
+    /**
+     * Join the room(s) specified for this client.
+     * @param room The room(s) to join for this client.
+     * @returns
+     */
+    __STSjoinRoom: (room: string[]) => void;
+    /**
+     * Remove this client from the specified room(s).
+     * @param room The room(s) to remove the client from within the server.
+     * @returns
+     */
+    __STSleaveRoom: (room: string[]) => void;
+    /**
+     * 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.
+     * @param reason Reason for the disconnecting event.
+     * @param callback The server must call-back with the result of the disconnecting event.
+     * @returns
+     */
+    __STSdisconnecting: (reason: string, callback: (data: string) => void) => void;
+    /**
+     * Alerts the server to disconnect this client.
+     * @param reason Reason for the disconnect event.
+     * @returns
+     */
+    __STSdisconnect: (reason: string) => void;
+    /**
+     * Send a payload of data to 1 or more rooms registered on the server.
+     * @param rooms Room array for broadcasting.
+     * @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
+     * interface that extends STSServerToClientEvents.
+     * @returns
+     */
+    __STSsendToRoom: (rooms: string[], payload: {
+        command: string;
+        payload: any;
+    }) => void;
+}
+export interface STSDefaultServerToClientEvents {
+    /**
+     * The server may emit an unsolicited disconnect event to flag that all clients should disconnect. Most likely becuase the server may be shutting down.
+     * @param reason Reason why the server is emitting this disconnect event.
+     * @returns
+     */
+    __STSdisconnect: (reason: string) => void;
+}
+export interface ISocketIoServerHelperOptions {
+    logger: ISTSLogger;
+}
+export type ServerEventCb = (socket: any, data: any) => void;
+export interface ServerSocketEvent {
+    serverEventName: string;
+    serverEventCb: ServerEventCb;
+}
+export declare enum STSNamespace {
+    STSMonitor = "stsinstrumentmanager/stsmonitor",
+    STSControl = "stsinstrumentmanager/stscontrol"
+}
+export declare enum STSRoom {
+    STSInstrumentDataRoom = "stsinstrumentdataroom",// This room is for all instrument data messages
+    STSInstrumentDataSubscriptionRoom = "stsinstrumentdatasubscriptionroom",// This room is only for subscribed instrument data messages
+    STSRunnerRoom = "stsrunnerroom",
+    STSNodeRunnerRoom = "stsnoderunnerroom"
+}
+export declare enum STSEvent {
+    STSInstrumentData = "stsinstrumentdata",
+    STSSubInstrumentData = "stssubinstrumentdata",// sub-scribed instrument data. This only outputs the nodes that have been subscribed by the client(s).
+    STSResetInstrumentData = "stsresetinstrumentdata",
+    STSStartLoggingInstrumentData = "stsStartLoggingInstrumentData",
+    STSStopLoggingInstrumentData = "stsStopLoggingInstrumentData",
+    STSStart = "stsstart",// Start a test run with options as payload.
+    STSStop = "stsstop",// Stop test run(s).
+    STSPause = "stspause",// Pause test run(s).
+    STSResume = "stsresume",// Resume test run(s).
+    STSTerminate = "ststerminate",// Terminate runner instances and exit applications.
+    STSUpdateStaticConfig = "stsupdatestaticconfig",// Update base configuration. Options as payload.
+    STSUpdateDynamicConfig = "stsupdatedynamicconfig",// Update running configuration. This is used
+    STSSendToRoom = "sendToRoom",
+    connect = "connect"
+}
+export interface InterServerEvents {
+    ping: () => void;
+}
+export interface STSSocketIONamespace {
+    namespace: string;
+    pid: number;
+    socketionamespace: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>;
+}
+export type STSSocketIONamespaces = Record<string, STSSocketIONamespace>;
+export type STSServerSocket = Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>;
+export type STSClientSocket = Socket<STSDefaultServerToClientEvents, STSDefaultClientToServerEvents, InterServerEvents>;
+export interface ISocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> {
+    LogMessage: (namespace: STSSocketIONamespace, message: string) => void;
+    LeaveRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void;
+    JoinRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void;
+    SetupNamespace: (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null, socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null) => Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>;
+    GetSTSSocketIONamespace: (namespace: any) => STSSocketIONamespace;
+    GetSTSSocketIONamespaces: () => STSSocketIONamespaces;
+    DisconnectSockets: () => void;
+    CloseAdaptors: () => Promise<void>;
+    SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>;
+}
+//# sourceMappingURL=commonTypes.d.ts.map

package/types/commonTypes.d.ts.map

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

package/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './commonTypes';
+export * from './socketIoClientHelper';
+export * from './socketIoServerHelper';
+//# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC"}

package/types/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/types/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/types/socketIoClientHelper.d.ts

@@ -0,0 +1,31 @@
+import { Socket } from 'socket.io-client';
+import { ISTSLogger } from '@nsshunt/stsutils';
+import { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes';
+export type EventCb = (socket: any, data: any) => void;
+export interface ISocketDetail {
+    name: string;
+    address: string;
+    socket: Socket | null;
+    errorCallBack: (error: Error) => void;
+}
+export interface ISocketIoClientHelperOptions {
+    url?: string;
+    agentOptions?: {
+        keepAlive: boolean;
+        maxSockets: number;
+        maxTotalSockets: number;
+        maxFreeSockets: number;
+        timeout: number;
+        rejectUnauthorized: boolean;
+    };
+    logger?: ISTSLogger;
+}
+export declare class SocketIoClientHelper<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents> {
+    #private;
+    constructor(options: ISocketIoClientHelperOptions);
+    get sockets(): Record<string, ISocketDetail>;
+    SetupClientSideSocket(name: string, address: string, onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null, socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null, errorCallBack: ((error: Error) => void)): Socket<ServerToClientEvents, ClientToServerEvents>;
+    GetSocket(name: string): Socket<ServerToClientEvents, ClientToServerEvents>;
+    GetSocketDetail(name: string): ISocketDetail;
+}
+//# sourceMappingURL=socketIoClientHelper.d.ts.map

package/types/socketIoClientHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socketIoClientHelper.d.ts","sourceRoot":"","sources":["../src/socketIoClientHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAI5E,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAA;AAI9F,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,CAAA;AAoBtD,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAEhB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CACxC;AAED,MAAM,WAAW,4BAA4B;IAEzC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE;QACjB,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,MAAM,CAAA;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,kBAAkB,EAAE,OAAO,CAAA;KAC3B,CAAA;IACE,MAAM,CAAC,EAAE,UAAU,CAAA;CACtB;AAED,qBAAa,oBAAoB,CAAC,oBAAoB,SAAS,8BAA8B,EAAE,oBAAoB,SAAS,8BAA8B;;gBAM1I,OAAO,EAAE,4BAA4B;IAmBjD,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAE3C;IAED,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAC/C,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,EAChG,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,EACnG,aAAa,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GACxC,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IAWrD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IAI3E,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;CA+G/C"}

package/types/socketIoServerHelper.d.ts

@@ -0,0 +1,16 @@
+import { Server, Namespace, Socket } from "socket.io";
+import { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, ISocketIoServerHelper, ISocketIoServerHelperOptions, STSSocketIONamespace, STSSocketIONamespaces, STSNamespace, InterServerEvents, ServerEventCb } from './commonTypes';
+export declare class SocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> implements ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents> {
+    #private;
+    constructor(options: ISocketIoServerHelperOptions);
+    LogMessage(namespace: STSSocketIONamespace, message: any): void;
+    LeaveRoom: (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string) => void;
+    JoinRoom: (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string) => void;
+    SetupNamespace: (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null, socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null) => Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>;
+    GetSTSSocketIONamespace: (namespace: string) => STSSocketIONamespace;
+    GetSTSSocketIONamespaces: () => STSSocketIONamespaces;
+    CloseAdaptors: () => Promise<void>;
+    DisconnectSockets: () => void;
+    SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>;
+}
+//# sourceMappingURL=socketIoServerHelper.d.ts.map

package/types/socketIoServerHelper.d.ts.map

@@ -0,0 +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,cAAe,oBAAoB,UAAU,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,QAAQ,MAAM,KAAG,IAAI,CAG3H;IAEF,QAAQ,cAAe,oBAAoB,UAAU,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,QAAQ,MAAM,KAAG,IAAI,CAG1H;IAsEF,cAAc,OAAQ,MAAM,aAAa,YAAY,SAAS,MAAM,EAAE,iBAAiB,OAAO,yBACnE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,iBAAiB,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,wBACjG,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,cAAe,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"}