@nsshunt/stssocketioutils 2.0.20 → 2.0.22

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.cjs CHANGED
@@ -117,14 +117,18 @@ class SocketIoClient extends index.tinyEmitterExports.TinyEmitter {
117
117
  this.#EstablishSocketConnect();
118
118
  return this;
119
119
  }
120
+ // Engine Errors / Events
120
121
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
121
- ConnectCallBack(socket) {
122
+ EngineError(error) {
122
123
  }
123
124
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
124
- SocketEventsCallBack(socket) {
125
+ EngineReconnectError(error) {
125
126
  }
126
127
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
127
- ErrorCallBack(error) {
128
+ EngineConnectError(error) {
129
+ }
130
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
131
+ EngineReconnect(attempt) {
128
132
  }
129
133
  /*
130
134
  emit<Ev extends EventNames<ClientToServerEvents>>(ev: Ev, ...args: EventParams<ClientToServerEvents, Ev>): Socket<ServerToClientEvents, ClientToServerEvents> {
@@ -177,31 +181,36 @@ class SocketIoClient extends index.tinyEmitterExports.TinyEmitter {
177
181
  this.#socket = socket_ioClient.io(this.#address, socketOptions);
178
182
  this.#socket.io.on("error", (err) => {
179
183
  this.LogErrorMessage(`socketDetail.socket.io.on('error'): [${err}] Address: [${this.#address}]`);
184
+ this.EngineError(err);
180
185
  });
181
186
  this.#socket.io.on("reconnect_error", (err) => {
182
187
  this.LogErrorMessage(`socketDetail.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);
188
+ this.EngineReconnectError(err);
183
189
  });
184
190
  this.#socket.on("connect_error", (err) => {
185
191
  this.LogErrorMessage(`socketDetail.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);
192
+ this.EngineConnectError(err);
186
193
  });
187
194
  this.#socket.io.on("reconnect", (attempt) => {
188
195
  this.LogErrorMessage(`socketDetail.socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);
196
+ this.EngineReconnect(attempt);
189
197
  });
190
198
  this.#socket.on("connect", () => {
191
199
  if (this.#socket) {
192
200
  this.LogDebugMessage(`Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);
193
201
  setTimeout(() => {
194
- this.ConnectCallBack(this.#socket);
202
+ this.SocketConnect(this.#socket);
195
203
  }, 0);
196
- this.SocketEventsCallBack(this.#socket);
204
+ this.SetupSocketEvents(this.#socket);
197
205
  } else {
198
206
  const errorMessage = "Could not get socket object from socket.io, Address: [${socketDetail.address}]";
199
207
  this.LogErrorMessage(errorMessage);
200
- this.ErrorCallBack(new Error(errorMessage));
208
+ this.SocketConnectError(new Error(errorMessage));
201
209
  }
202
210
  });
203
211
  this.#socket.on("disconnect", (reason) => {
204
212
  this.LogDebugMessage("socket disconnect: " + reason);
213
+ this.SocketDisconnect(reason);
205
214
  switch (reason) {
206
215
  case "io server disconnect":
207
216
  {
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","sources":["../src/commonTypes.ts","../node_modules/detect-node/index.esm.js","../src/socketIoClient.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */ // --> OFF\nimport { Server, Socket, Namespace } from \"socket.io\";\nimport { ISTSLogger } from '@nsshunt/stsutils'\n\nexport interface STSDefaultClientToServerEvents {\n /**\n * Join the room(s) specified for this client.\n * @param room The room(s) to join for this client.\n * @returns \n */\n\t__STSjoinRoom: (room: string[]) => void;\n\n /**\n * Remove this client from the specified room(s).\n * @param room The room(s) to remove the client from within the server.\n * @returns \n */\n\t__STSleaveRoom: (room: string[]) => void;\n\n /**\n * Alerts the server that this client has flagged to disconnect. Allows server to perform clean-up if required. The server must call-back with the result of the disconnecting event.\n * @param reason Reason for the disconnecting event.\n * @param callback The server must call-back with the result of the disconnecting event.\n * @returns \n */\n\t__STSdisconnecting: (reason: string, callback: (data: string) => void) => void;\n\n /**\n * Alerts the server to disconnect this client.\n * @param reason Reason for the disconnect event.\n * @returns \n */\n\t__STSdisconnect: (reason: string) => void; // server and client event\n\n /**\n * Send a payload of data to 1 or more rooms registered on the server.\n * @param rooms Room array for broadcasting.\n * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n * interface that extends STSServerToClientEvents.\n * @returns \n */\n __STSsendToRoom: (rooms: string[], payload: { command: string, payload: any }) => void;\n\n /**\n * Send a payload of data to 1 or more rooms registered on the server.\n * @param room Single room for broadcasting.\n\t * @param timeout Number of ms to try and get responses from all clients\n * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n * interface that extends STSServerToClientEvents.\n\t * @param callback The callback function to be invoked once all clients have responded with their respective payloads\n * @returns \n */\n __STSsendToRoomWithCallback: (room: string, timeout: number, payload: { command: string, payload: any }, callback: (data: any) => void) => void; \n\n /**\n * Send a payload of data to 1 or more rooms registered on the server.\n * @param rooms Array of rooms for broadcasting.\n\t * @param timeout Number of ms to try and get responses from all clients\n * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n * interface that extends STSServerToClientEvents.\n\t * @param callback The callback function to be invoked once all clients have responded with their respective payloads\n * @returns \n */\n __STSsendToRoomsWithCallback: (rooms: string[], timeout: number, payload: { command: string, payload: any }, callback: (data: any) => void) => void; \n}\n\nexport interface STSDefaultServerToClientEvents {\n /**\n * The server may emit an unsolicited disconnect event to flag that all clients should disconnect. Most likely becuase the server may be shutting down.\n * @param reason Reason why the server is emitting this disconnect event.\n * @returns \n */\n\t__STSdisconnect: (reason: string) => void;\n}\n\nexport enum STSNamespace {\n\tSTSMonitor = 'stsinstrumentmanager/stsmonitor',\n\tSTSControl = 'stsinstrumentmanager/stscontrol',\n STSTestingNamespace = 'ststestingnamespace/ststesting'\n}\n\nexport enum STSRoom {\n\t// STSMonitor rooms\n\tSTSInstrumentDataRoom = 'stsinstrumentdataroom', // This room is for all instrument data messages\n\tSTSInstrumentDataSubscriptionRoom = 'stsinstrumentdatasubscriptionroom', // This room is only for subscribed instrument data messages\n\n\t// STSControl rooms\n\tSTSRunnerRoom = 'stsrunnerroom',\n\tSTSNodeRunnerRoom = 'stsnoderunnerroom'\n}\n\nexport enum STSEvent {\n\t// STSInstrumentData\n\tSTSInstrumentData = 'stsinstrumentdata',\n\tSTSSubInstrumentData = 'stssubinstrumentdata', // sub-scribed instrument data. This only outputs the nodes that have been subscribed by the client(s).\n\tSTSResetInstrumentData = 'stsresetinstrumentdata',\n\n\tSTSStartLoggingInstrumentData = 'stsStartLoggingInstrumentData',\n\tSTSStopLoggingInstrumentData = 'stsStopLoggingInstrumentData',\n\n\t// STSRunner events\n\tSTSStart = 'stsstart', // Start a test run with options as payload.\n\tSTSStop = 'stsstop', // Stop test run(s).\n\tSTSPause = 'stspause', // Pause test run(s).\n\tSTSResume = 'stsresume', // Resume test run(s).\n\tSTSTerminate = 'ststerminate', // Terminate runner instances and exit applications.\n\t// This may also be uysed to force trigger self healing (i.e. auto re-start) when\n\t// running within a container orchestrator such as K8, K3 or Docker Swarm.\n\tSTSUpdateStaticConfig = 'stsupdatestaticconfig', // Update base configuration. Options as payload.\n\tSTSUpdateDynamicConfig = 'stsupdatedynamicconfig', // Update running configuration. This is used\n\t// to control the runnning behaviour of test(s) in-flight. Options as payload.\n\n\tSTSSendToRoom = 'sendToRoom',\n\n\t// Standard socket events\n\tconnect = 'connect'\n}\n\n// https://socket.io/docs/v4/typescript/\n\nexport interface InterServerEvents {\n\tping: () => void;\n}\n\nexport interface STSSocketIONamespace {\n\tnamespace: string\n\tpid: number\n\tsocketionamespace: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n}\n\nexport type STSSocketIONamespaces = Record<string, STSSocketIONamespace>;\n\nexport type STSServerSocket = Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\nexport type STSClientSocket = Socket<STSDefaultServerToClientEvents, STSDefaultClientToServerEvents, InterServerEvents>\n","// 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//import { EventNames, EventParams } from \"@socket.io/component-emitter\";\n\nimport isNode from 'detect-node';\n\nimport { ISTSLogger, AgentManager } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes'\n\nimport { TinyEmitter } from 'tiny-emitter';\n\nexport abstract class SocketIoClient<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents> extends TinyEmitter {\n #agentManager?: AgentManager\n #logger?: ISTSLogger\n #name: string\n #address?: string\n #socketIoCustomPath?: string\n #authToken?: string\n #socket?: Socket<ServerToClientEvents, ClientToServerEvents>;\n #reconnectTimeout: number = 2000; // default\n\n constructor(name: string) {\n super();\n this.#name = name;\n }\n \n protected get logPrefix(): string {\n return `SocketIoClient[${this.#name}]:`;\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n protected LogDebugMessage(message: any): void {\n if (this.#logger) this.#logger.debug(`${this.logPrefix}${message}`);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n protected LogErrorMessage(message: any): void {\n if (this.#logger) this.#logger.error(`${this.logPrefix}${message}`);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n protected LogWarningMessage(message: any): void {\n if (this.#logger) this.#logger.warn(`${this.logPrefix}${message}`);\n }\n\n get name(): string {\n return this.#name;\n }\n\n get reconnectTimeout(): number {\n return this.#reconnectTimeout;\n }\n\n get agentManager(): AgentManager | undefined {\n return this.#agentManager;\n }\n\n get logger(): ISTSLogger | undefined {\n return this.#logger;\n }\n\n get address(): string | undefined {\n return this.#address;\n }\n\n get authToken(): string | undefined {\n return this.#authToken;\n }\n\n get socketIoCustomPath(): string | undefined {\n return this.#socketIoCustomPath;\n }\n\n get socket(): Socket<ServerToClientEvents, ClientToServerEvents> | undefined {\n return this.#socket;\n }\n\n WithAddress(address: string) {\n this.#address = address;\n return this;\n }\n\n WithAuthToken(authToken: string) {\n this.#authToken = authToken;\n return this;\n }\n\n WithSocketIoCustomPath(socketIoCustomPath: string) {\n this.#socketIoCustomPath = socketIoCustomPath;\n return this;\n }\n\n WithLogger(logger: ISTSLogger) {\n this.#logger = logger;\n return this;\n }\n\n WithAgentManager(agentManager: AgentManager) {\n this.#agentManager = agentManager;\n return this;\n }\n\n WithReconnectTimeout(reconnectTimeout: number) {\n this.#reconnectTimeout = reconnectTimeout;\n return this;\n }\n\n SetupSocket() {\n if (!this.#address) {\n throw new Error(`SocketIoClientHelper:SetupSocket(): Error: [address not provided]`);\n }\n\n this.#EstablishSocketConnect();\n\n return this;\n }\n\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n protected ConnectCallBack(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void { };\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n protected SocketEventsCallBack(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void { };\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n protected ErrorCallBack(error: Error): void { };\n\n /*\n emit<Ev extends EventNames<ClientToServerEvents>>(ev: Ev, ...args: EventParams<ClientToServerEvents, Ev>): Socket<ServerToClientEvents, ClientToServerEvents> {\n if (this.#socket) {\n return this.#socket!.emit(ev, ...args);\n } else {\n throw new Error('SocketIoClient:emit(): Error: [socket instance not defined.]');\n }\n }\n */\n\n #EstablishSocketConnect(): void {\n if (this.#socket !== undefined) {\n // We already have a socket object (may or may not be connected)\n if (this.#socket.connected === true) {\n this.#socket.disconnect();\n }\n this.#socket = undefined;\n if (isNode) {\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n }\n return;\n }\n\n let socketOptions: Partial<SocketOptions & ManagerOptions>;\n if (isNode) {\n // https://socket.io/docs/v4/client-options/#reconnection\n // https://github.com/socketio/engine.io-client#methods\n socketOptions = {\n transports: [\"websocket\" ]\n }\n if (this.#agentManager) {\n if (!this.#address) {\n throw new Error(`SocketIoClient:SetupSocket(): Error: [address not provided when using agentManager]`);\n }\n socketOptions.agent = this.#agentManager.GetAgent(this.#address);\n }\n } else {\n socketOptions = {\n transports: [\"websocket\" ]\n }\n }\n\n // https://socket.io/docs/v4/middlewares/\n // Send auth token for connections\n if (this.#authToken) {\n socketOptions.auth = (cb) => {\n cb({\n token: this.#authToken\n });\n }\n }\n\n // On Server use;\n /*\n io.use((socket, next) => {\n const token = socket.handshake.auth.token;\n // ...\n });\n */\n\n if (this.#socketIoCustomPath && this.#socketIoCustomPath.localeCompare('') !== 0) {\n socketOptions.path = this.#socketIoCustomPath;\n }\n\n this.#socket = io(this.#address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n // Manager errors\n this.#socket.io.on('error', (err: Error) => {\n this.LogErrorMessage(`socketDetail.socket.io.on('error'): [${err}] Address: [${this.#address}]`);\n });\n\n this.#socket.io.on('reconnect_error', (err: Error) => {\n this.LogErrorMessage(`socketDetail.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);\n });\n\n // suppress automatic console logging by not letting it bubble up\n this.#socket.on(\"connect_error\", (err) => {\n this.LogErrorMessage(`socketDetail.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);\n });\n\n this.#socket.io.on('reconnect', (attempt: number) => {\n this.LogErrorMessage(`socketDetail.socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);\n });\n\n /*\n this.#socket.on(\"connect_timeout\", () => {\n this.#LogErrorMessage(`socketDetail.socket.on('connect_timeout') Address: [${this.#address}]`);\n });\n */\n\n this.#socket.on(\"connect\", () => {\n if (this.#socket) {\n this.LogDebugMessage(`Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);\n\n setTimeout(() => {\n this.ConnectCallBack(this.#socket as Socket<ServerToClientEvents, ClientToServerEvents>);\n }, 0);\n\n this.SocketEventsCallBack(this.#socket);\n\n } else {\n const errorMessage: string = 'Could not get socket object from socket.io, Address: [${socketDetail.address}]';\n this.LogErrorMessage(errorMessage);\n this.ErrorCallBack(new Error(errorMessage));\n }\n })\n\n // https://socket.io/docs/v4/client-socket-instance/#disconnect\n this.#socket.on(\"disconnect\", (reason: string) => {\n this.LogDebugMessage('socket disconnect: ' + reason);\n switch (reason) {\n case 'io server disconnect' : {\n // The server disconnect using disconnectSockets (i.e. normal safe shutdown)\n this.LogDebugMessage('The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n this.LogDebugMessage('The connection will be re-established when the server becomes available.');\n this.#socket = undefined;\n if (isNode) {\n if (this.#agentManager) {\n this.#agentManager.ResetAgent();\n }\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n }\n }\n break;\n case 'io client disconnect' :\n this.LogDebugMessage('The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n this.LogDebugMessage('The connection will not be re-established automatically.');\n // Do nothing\n break;\n case 'transport close' :\n case 'ping timeout' :\n case 'transport error' : {\n this.LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);\n this.LogDebugMessage('The connection will be re-established when the server becomes available.');\n if (this.#socket) {\n this.#socket.disconnect();\n }\n this.#socket = undefined;\n if (isNode) {\n if (this.#agentManager) {\n this.#agentManager?.ResetAgent();\n }\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n }\n }\n break;\n }\n });\n }\n}\n"],"names":["STSNamespace","STSRoom","STSEvent","TinyEmitter","io"],"mappings":"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","x_google_ignoreList":[1]}
1
+ {"version":3,"file":"index.cjs","sources":["../src/commonTypes.ts","../node_modules/detect-node/index.esm.js","../src/socketIoClient.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */ // --> OFF\nimport { Server, Socket, Namespace } from \"socket.io\";\nimport { ISTSLogger } from '@nsshunt/stsutils'\n\nexport interface STSDefaultClientToServerEvents {\n /**\n * Join the room(s) specified for this client.\n * @param room The room(s) to join for this client.\n * @returns \n */\n\t__STSjoinRoom: (room: string[]) => void;\n\n /**\n * Remove this client from the specified room(s).\n * @param room The room(s) to remove the client from within the server.\n * @returns \n */\n\t__STSleaveRoom: (room: string[]) => void;\n\n /**\n * Alerts the server that this client has flagged to disconnect. Allows server to perform clean-up if required. The server must call-back with the result of the disconnecting event.\n * @param reason Reason for the disconnecting event.\n * @param callback The server must call-back with the result of the disconnecting event.\n * @returns \n */\n\t__STSdisconnecting: (reason: string, callback: (data: string) => void) => void;\n\n /**\n * Alerts the server to disconnect this client.\n * @param reason Reason for the disconnect event.\n * @returns \n */\n\t__STSdisconnect: (reason: string) => void; // server and client event\n\n /**\n * Send a payload of data to 1 or more rooms registered on the server.\n * @param rooms Room array for broadcasting.\n * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n * interface that extends STSServerToClientEvents.\n * @returns \n */\n __STSsendToRoom: (rooms: string[], payload: { command: string, payload: any }) => void;\n\n /**\n * Send a payload of data to 1 or more rooms registered on the server.\n * @param room Single room for broadcasting.\n\t * @param timeout Number of ms to try and get responses from all clients\n * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n * interface that extends STSServerToClientEvents.\n\t * @param callback The callback function to be invoked once all clients have responded with their respective payloads\n * @returns \n */\n __STSsendToRoomWithCallback: (room: string, timeout: number, payload: { command: string, payload: any }, callback: (data: any) => void) => void; \n\n /**\n * Send a payload of data to 1 or more rooms registered on the server.\n * @param rooms Array of rooms for broadcasting.\n\t * @param timeout Number of ms to try and get responses from all clients\n * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n * interface that extends STSServerToClientEvents.\n\t * @param callback The callback function to be invoked once all clients have responded with their respective payloads\n * @returns \n */\n __STSsendToRoomsWithCallback: (rooms: string[], timeout: number, payload: { command: string, payload: any }, callback: (data: any) => void) => void; \n}\n\nexport interface STSDefaultServerToClientEvents {\n /**\n * The server may emit an unsolicited disconnect event to flag that all clients should disconnect. Most likely becuase the server may be shutting down.\n * @param reason Reason why the server is emitting this disconnect event.\n * @returns \n */\n\t__STSdisconnect: (reason: string) => void;\n}\n\nexport enum STSNamespace {\n\tSTSMonitor = 'stsinstrumentmanager/stsmonitor',\n\tSTSControl = 'stsinstrumentmanager/stscontrol',\n STSTestingNamespace = 'ststestingnamespace/ststesting'\n}\n\nexport enum STSRoom {\n\t// STSMonitor rooms\n\tSTSInstrumentDataRoom = 'stsinstrumentdataroom', // This room is for all instrument data messages\n\tSTSInstrumentDataSubscriptionRoom = 'stsinstrumentdatasubscriptionroom', // This room is only for subscribed instrument data messages\n\n\t// STSControl rooms\n\tSTSRunnerRoom = 'stsrunnerroom',\n\tSTSNodeRunnerRoom = 'stsnoderunnerroom'\n}\n\nexport enum STSEvent {\n\t// STSInstrumentData\n\tSTSInstrumentData = 'stsinstrumentdata',\n\tSTSSubInstrumentData = 'stssubinstrumentdata', // sub-scribed instrument data. This only outputs the nodes that have been subscribed by the client(s).\n\tSTSResetInstrumentData = 'stsresetinstrumentdata',\n\n\tSTSStartLoggingInstrumentData = 'stsStartLoggingInstrumentData',\n\tSTSStopLoggingInstrumentData = 'stsStopLoggingInstrumentData',\n\n\t// STSRunner events\n\tSTSStart = 'stsstart', // Start a test run with options as payload.\n\tSTSStop = 'stsstop', // Stop test run(s).\n\tSTSPause = 'stspause', // Pause test run(s).\n\tSTSResume = 'stsresume', // Resume test run(s).\n\tSTSTerminate = 'ststerminate', // Terminate runner instances and exit applications.\n\t// This may also be uysed to force trigger self healing (i.e. auto re-start) when\n\t// running within a container orchestrator such as K8, K3 or Docker Swarm.\n\tSTSUpdateStaticConfig = 'stsupdatestaticconfig', // Update base configuration. Options as payload.\n\tSTSUpdateDynamicConfig = 'stsupdatedynamicconfig', // Update running configuration. This is used\n\t// to control the runnning behaviour of test(s) in-flight. Options as payload.\n\n\tSTSSendToRoom = 'sendToRoom',\n\n\t// Standard socket events\n\tconnect = 'connect'\n}\n\n// https://socket.io/docs/v4/typescript/\n\nexport interface InterServerEvents {\n\tping: () => void;\n}\n\nexport interface STSSocketIONamespace {\n\tnamespace: string\n\tpid: number\n\tsocketionamespace: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n}\n\nexport type STSSocketIONamespaces = Record<string, STSSocketIONamespace>;\n\nexport type STSServerSocket = Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\nexport type STSClientSocket = Socket<STSDefaultServerToClientEvents, STSDefaultClientToServerEvents, InterServerEvents>\n","// 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//import { EventNames, EventParams } from \"@socket.io/component-emitter\";\n\nimport isNode from 'detect-node';\n\nimport { ISTSLogger, AgentManager } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes'\n\nimport { TinyEmitter } from 'tiny-emitter';\n\nexport abstract class SocketIoClient<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents> extends TinyEmitter {\n #agentManager?: AgentManager\n #logger?: ISTSLogger\n #name: string\n #address?: string\n #socketIoCustomPath?: string\n #authToken?: string\n #socket?: Socket<ServerToClientEvents, ClientToServerEvents>;\n #reconnectTimeout: number = 2000; // default\n\n constructor(name: string) {\n super();\n this.#name = name;\n }\n \n protected get logPrefix(): string {\n return `SocketIoClient[${this.#name}]:`;\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n protected LogDebugMessage(message: any): void {\n if (this.#logger) this.#logger.debug(`${this.logPrefix}${message}`);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n protected LogErrorMessage(message: any): void {\n if (this.#logger) this.#logger.error(`${this.logPrefix}${message}`);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n protected LogWarningMessage(message: any): void {\n if (this.#logger) this.#logger.warn(`${this.logPrefix}${message}`);\n }\n\n get name(): string {\n return this.#name;\n }\n\n get reconnectTimeout(): number {\n return this.#reconnectTimeout;\n }\n\n get agentManager(): AgentManager | undefined {\n return this.#agentManager;\n }\n\n get logger(): ISTSLogger | undefined {\n return this.#logger;\n }\n\n get address(): string | undefined {\n return this.#address;\n }\n\n get authToken(): string | undefined {\n return this.#authToken;\n }\n\n get socketIoCustomPath(): string | undefined {\n return this.#socketIoCustomPath;\n }\n\n get socket(): Socket<ServerToClientEvents, ClientToServerEvents> | undefined {\n return this.#socket;\n }\n\n WithAddress(address: string) {\n this.#address = address;\n return this;\n }\n\n WithAuthToken(authToken: string) {\n this.#authToken = authToken;\n return this;\n }\n\n WithSocketIoCustomPath(socketIoCustomPath: string) {\n this.#socketIoCustomPath = socketIoCustomPath;\n return this;\n }\n\n WithLogger(logger: ISTSLogger) {\n this.#logger = logger;\n return this;\n }\n\n WithAgentManager(agentManager: AgentManager) {\n this.#agentManager = agentManager;\n return this;\n }\n\n WithReconnectTimeout(reconnectTimeout: number) {\n this.#reconnectTimeout = reconnectTimeout;\n return this;\n }\n\n SetupSocket() {\n if (!this.#address) {\n throw new Error(`SocketIoClientHelper:SetupSocket(): Error: [address not provided]`);\n }\n\n this.#EstablishSocketConnect();\n\n return this;\n }\n\n \n protected abstract SocketConnect(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;\n \n protected abstract SetupSocketEvents(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;\n \n protected abstract SocketConnectError(error: Error): void;\n \n protected abstract SocketDisconnect(reason: string): void;\n\n // Engine Errors / Events\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n protected EngineError(error: Error): void { };\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n protected EngineReconnectError(error: Error): void { };\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n protected EngineConnectError(error: Error): void { };\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n protected EngineReconnect(attempt: number): void { };\n\n /*\n emit<Ev extends EventNames<ClientToServerEvents>>(ev: Ev, ...args: EventParams<ClientToServerEvents, Ev>): Socket<ServerToClientEvents, ClientToServerEvents> {\n if (this.#socket) {\n return this.#socket!.emit(ev, ...args);\n } else {\n throw new Error('SocketIoClient:emit(): Error: [socket instance not defined.]');\n }\n }\n */\n\n #EstablishSocketConnect(): void {\n if (this.#socket !== undefined) {\n // We already have a socket object (may or may not be connected)\n if (this.#socket.connected === true) {\n this.#socket.disconnect();\n }\n this.#socket = undefined;\n if (isNode) {\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n }\n return;\n }\n\n let socketOptions: Partial<SocketOptions & ManagerOptions>;\n if (isNode) {\n // https://socket.io/docs/v4/client-options/#reconnection\n // https://github.com/socketio/engine.io-client#methods\n socketOptions = {\n transports: [\"websocket\" ]\n }\n if (this.#agentManager) {\n if (!this.#address) {\n throw new Error(`SocketIoClient:SetupSocket(): Error: [address not provided when using agentManager]`);\n }\n socketOptions.agent = this.#agentManager.GetAgent(this.#address);\n }\n } else {\n socketOptions = {\n transports: [\"websocket\" ]\n }\n }\n\n // https://socket.io/docs/v4/middlewares/\n // Send auth token for connections\n if (this.#authToken) {\n socketOptions.auth = (cb) => {\n cb({\n token: this.#authToken\n });\n }\n }\n\n // On Server use;\n /*\n io.use((socket, next) => {\n const token = socket.handshake.auth.token;\n // ...\n });\n */\n\n if (this.#socketIoCustomPath && this.#socketIoCustomPath.localeCompare('') !== 0) {\n socketOptions.path = this.#socketIoCustomPath;\n }\n\n this.#socket = io(this.#address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n // Manager errors\n this.#socket.io.on('error', (err: Error) => {\n this.LogErrorMessage(`socketDetail.socket.io.on('error'): [${err}] Address: [${this.#address}]`);\n this.EngineError(err);\n });\n\n this.#socket.io.on('reconnect_error', (err: Error) => {\n this.LogErrorMessage(`socketDetail.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);\n this.EngineReconnectError(err);\n });\n\n // suppress automatic console logging by not letting it bubble up\n this.#socket.on(\"connect_error\", (err) => {\n this.LogErrorMessage(`socketDetail.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);\n this.EngineConnectError(err);\n });\n\n this.#socket.io.on('reconnect', (attempt: number) => {\n this.LogErrorMessage(`socketDetail.socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);\n this.EngineReconnect(attempt);\n });\n\n /*\n this.#socket.on(\"connect_timeout\", () => {\n this.#LogErrorMessage(`socketDetail.socket.on('connect_timeout') Address: [${this.#address}]`);\n });\n */\n\n this.#socket.on(\"connect\", () => {\n if (this.#socket) {\n this.LogDebugMessage(`Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);\n\n setTimeout(() => {\n this.SocketConnect(this.#socket as Socket<ServerToClientEvents, ClientToServerEvents>);\n }, 0);\n\n this.SetupSocketEvents(this.#socket);\n\n } else {\n const errorMessage: string = 'Could not get socket object from socket.io, Address: [${socketDetail.address}]';\n this.LogErrorMessage(errorMessage);\n this.SocketConnectError(new Error(errorMessage));\n }\n })\n\n // https://socket.io/docs/v4/client-socket-instance/#disconnect\n this.#socket.on(\"disconnect\", (reason: string) => {\n this.LogDebugMessage('socket disconnect: ' + reason);\n this.SocketDisconnect(reason);\n switch (reason) {\n case 'io server disconnect' : {\n // The server disconnect using disconnectSockets (i.e. normal safe shutdown)\n this.LogDebugMessage('The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n this.LogDebugMessage('The connection will be re-established when the server becomes available.');\n this.#socket = undefined;\n if (isNode) {\n if (this.#agentManager) {\n this.#agentManager.ResetAgent();\n }\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n }\n }\n break;\n case 'io client disconnect' :\n this.LogDebugMessage('The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n this.LogDebugMessage('The connection will not be re-established automatically.');\n // Do nothing\n break;\n case 'transport close' :\n case 'ping timeout' :\n case 'transport error' : {\n this.LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);\n this.LogDebugMessage('The connection will be re-established when the server becomes available.');\n if (this.#socket) {\n this.#socket.disconnect();\n }\n this.#socket = undefined;\n if (isNode) {\n if (this.#agentManager) {\n this.#agentManager?.ResetAgent();\n }\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n }\n }\n break;\n }\n });\n }\n}\n"],"names":["STSNamespace","STSRoom","STSEvent","TinyEmitter","io"],"mappings":"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","x_google_ignoreList":[1]}
package/dist/index.mjs CHANGED
@@ -115,14 +115,18 @@ class SocketIoClient extends tinyEmitterExports.TinyEmitter {
115
115
  this.#EstablishSocketConnect();
116
116
  return this;
117
117
  }
118
+ // Engine Errors / Events
118
119
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
119
- ConnectCallBack(socket) {
120
+ EngineError(error) {
120
121
  }
121
122
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
122
- SocketEventsCallBack(socket) {
123
+ EngineReconnectError(error) {
123
124
  }
124
125
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
125
- ErrorCallBack(error) {
126
+ EngineConnectError(error) {
127
+ }
128
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
129
+ EngineReconnect(attempt) {
126
130
  }
127
131
  /*
128
132
  emit<Ev extends EventNames<ClientToServerEvents>>(ev: Ev, ...args: EventParams<ClientToServerEvents, Ev>): Socket<ServerToClientEvents, ClientToServerEvents> {
@@ -175,31 +179,36 @@ class SocketIoClient extends tinyEmitterExports.TinyEmitter {
175
179
  this.#socket = io(this.#address, socketOptions);
176
180
  this.#socket.io.on("error", (err) => {
177
181
  this.LogErrorMessage(`socketDetail.socket.io.on('error'): [${err}] Address: [${this.#address}]`);
182
+ this.EngineError(err);
178
183
  });
179
184
  this.#socket.io.on("reconnect_error", (err) => {
180
185
  this.LogErrorMessage(`socketDetail.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);
186
+ this.EngineReconnectError(err);
181
187
  });
182
188
  this.#socket.on("connect_error", (err) => {
183
189
  this.LogErrorMessage(`socketDetail.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);
190
+ this.EngineConnectError(err);
184
191
  });
185
192
  this.#socket.io.on("reconnect", (attempt) => {
186
193
  this.LogErrorMessage(`socketDetail.socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);
194
+ this.EngineReconnect(attempt);
187
195
  });
188
196
  this.#socket.on("connect", () => {
189
197
  if (this.#socket) {
190
198
  this.LogDebugMessage(`Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);
191
199
  setTimeout(() => {
192
- this.ConnectCallBack(this.#socket);
200
+ this.SocketConnect(this.#socket);
193
201
  }, 0);
194
- this.SocketEventsCallBack(this.#socket);
202
+ this.SetupSocketEvents(this.#socket);
195
203
  } else {
196
204
  const errorMessage = "Could not get socket object from socket.io, Address: [${socketDetail.address}]";
197
205
  this.LogErrorMessage(errorMessage);
198
- this.ErrorCallBack(new Error(errorMessage));
206
+ this.SocketConnectError(new Error(errorMessage));
199
207
  }
200
208
  });
201
209
  this.#socket.on("disconnect", (reason) => {
202
210
  this.LogDebugMessage("socket disconnect: " + reason);
211
+ this.SocketDisconnect(reason);
203
212
  switch (reason) {
204
213
  case "io server disconnect":
205
214
  {
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","sources":["../src/commonTypes.ts","../node_modules/detect-node/index.esm.js","../src/socketIoClient.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */ // --> OFF\nimport { Server, Socket, Namespace } from \"socket.io\";\nimport { ISTSLogger } from '@nsshunt/stsutils'\n\nexport interface STSDefaultClientToServerEvents {\n /**\n * Join the room(s) specified for this client.\n * @param room The room(s) to join for this client.\n * @returns \n */\n\t__STSjoinRoom: (room: string[]) => void;\n\n /**\n * Remove this client from the specified room(s).\n * @param room The room(s) to remove the client from within the server.\n * @returns \n */\n\t__STSleaveRoom: (room: string[]) => void;\n\n /**\n * Alerts the server that this client has flagged to disconnect. Allows server to perform clean-up if required. The server must call-back with the result of the disconnecting event.\n * @param reason Reason for the disconnecting event.\n * @param callback The server must call-back with the result of the disconnecting event.\n * @returns \n */\n\t__STSdisconnecting: (reason: string, callback: (data: string) => void) => void;\n\n /**\n * Alerts the server to disconnect this client.\n * @param reason Reason for the disconnect event.\n * @returns \n */\n\t__STSdisconnect: (reason: string) => void; // server and client event\n\n /**\n * Send a payload of data to 1 or more rooms registered on the server.\n * @param rooms Room array for broadcasting.\n * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n * interface that extends STSServerToClientEvents.\n * @returns \n */\n __STSsendToRoom: (rooms: string[], payload: { command: string, payload: any }) => void;\n\n /**\n * Send a payload of data to 1 or more rooms registered on the server.\n * @param room Single room for broadcasting.\n\t * @param timeout Number of ms to try and get responses from all clients\n * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n * interface that extends STSServerToClientEvents.\n\t * @param callback The callback function to be invoked once all clients have responded with their respective payloads\n * @returns \n */\n __STSsendToRoomWithCallback: (room: string, timeout: number, payload: { command: string, payload: any }, callback: (data: any) => void) => void; \n\n /**\n * Send a payload of data to 1 or more rooms registered on the server.\n * @param rooms Array of rooms for broadcasting.\n\t * @param timeout Number of ms to try and get responses from all clients\n * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n * interface that extends STSServerToClientEvents.\n\t * @param callback The callback function to be invoked once all clients have responded with their respective payloads\n * @returns \n */\n __STSsendToRoomsWithCallback: (rooms: string[], timeout: number, payload: { command: string, payload: any }, callback: (data: any) => void) => void; \n}\n\nexport interface STSDefaultServerToClientEvents {\n /**\n * The server may emit an unsolicited disconnect event to flag that all clients should disconnect. Most likely becuase the server may be shutting down.\n * @param reason Reason why the server is emitting this disconnect event.\n * @returns \n */\n\t__STSdisconnect: (reason: string) => void;\n}\n\nexport enum STSNamespace {\n\tSTSMonitor = 'stsinstrumentmanager/stsmonitor',\n\tSTSControl = 'stsinstrumentmanager/stscontrol',\n STSTestingNamespace = 'ststestingnamespace/ststesting'\n}\n\nexport enum STSRoom {\n\t// STSMonitor rooms\n\tSTSInstrumentDataRoom = 'stsinstrumentdataroom', // This room is for all instrument data messages\n\tSTSInstrumentDataSubscriptionRoom = 'stsinstrumentdatasubscriptionroom', // This room is only for subscribed instrument data messages\n\n\t// STSControl rooms\n\tSTSRunnerRoom = 'stsrunnerroom',\n\tSTSNodeRunnerRoom = 'stsnoderunnerroom'\n}\n\nexport enum STSEvent {\n\t// STSInstrumentData\n\tSTSInstrumentData = 'stsinstrumentdata',\n\tSTSSubInstrumentData = 'stssubinstrumentdata', // sub-scribed instrument data. This only outputs the nodes that have been subscribed by the client(s).\n\tSTSResetInstrumentData = 'stsresetinstrumentdata',\n\n\tSTSStartLoggingInstrumentData = 'stsStartLoggingInstrumentData',\n\tSTSStopLoggingInstrumentData = 'stsStopLoggingInstrumentData',\n\n\t// STSRunner events\n\tSTSStart = 'stsstart', // Start a test run with options as payload.\n\tSTSStop = 'stsstop', // Stop test run(s).\n\tSTSPause = 'stspause', // Pause test run(s).\n\tSTSResume = 'stsresume', // Resume test run(s).\n\tSTSTerminate = 'ststerminate', // Terminate runner instances and exit applications.\n\t// This may also be uysed to force trigger self healing (i.e. auto re-start) when\n\t// running within a container orchestrator such as K8, K3 or Docker Swarm.\n\tSTSUpdateStaticConfig = 'stsupdatestaticconfig', // Update base configuration. Options as payload.\n\tSTSUpdateDynamicConfig = 'stsupdatedynamicconfig', // Update running configuration. This is used\n\t// to control the runnning behaviour of test(s) in-flight. Options as payload.\n\n\tSTSSendToRoom = 'sendToRoom',\n\n\t// Standard socket events\n\tconnect = 'connect'\n}\n\n// https://socket.io/docs/v4/typescript/\n\nexport interface InterServerEvents {\n\tping: () => void;\n}\n\nexport interface STSSocketIONamespace {\n\tnamespace: string\n\tpid: number\n\tsocketionamespace: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n}\n\nexport type STSSocketIONamespaces = Record<string, STSSocketIONamespace>;\n\nexport type STSServerSocket = Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\nexport type STSClientSocket = Socket<STSDefaultServerToClientEvents, STSDefaultClientToServerEvents, InterServerEvents>\n","// 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//import { EventNames, EventParams } from \"@socket.io/component-emitter\";\n\nimport isNode from 'detect-node';\n\nimport { ISTSLogger, AgentManager } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes'\n\nimport { TinyEmitter } from 'tiny-emitter';\n\nexport abstract class SocketIoClient<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents> extends TinyEmitter {\n #agentManager?: AgentManager\n #logger?: ISTSLogger\n #name: string\n #address?: string\n #socketIoCustomPath?: string\n #authToken?: string\n #socket?: Socket<ServerToClientEvents, ClientToServerEvents>;\n #reconnectTimeout: number = 2000; // default\n\n constructor(name: string) {\n super();\n this.#name = name;\n }\n \n protected get logPrefix(): string {\n return `SocketIoClient[${this.#name}]:`;\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n protected LogDebugMessage(message: any): void {\n if (this.#logger) this.#logger.debug(`${this.logPrefix}${message}`);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n protected LogErrorMessage(message: any): void {\n if (this.#logger) this.#logger.error(`${this.logPrefix}${message}`);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n protected LogWarningMessage(message: any): void {\n if (this.#logger) this.#logger.warn(`${this.logPrefix}${message}`);\n }\n\n get name(): string {\n return this.#name;\n }\n\n get reconnectTimeout(): number {\n return this.#reconnectTimeout;\n }\n\n get agentManager(): AgentManager | undefined {\n return this.#agentManager;\n }\n\n get logger(): ISTSLogger | undefined {\n return this.#logger;\n }\n\n get address(): string | undefined {\n return this.#address;\n }\n\n get authToken(): string | undefined {\n return this.#authToken;\n }\n\n get socketIoCustomPath(): string | undefined {\n return this.#socketIoCustomPath;\n }\n\n get socket(): Socket<ServerToClientEvents, ClientToServerEvents> | undefined {\n return this.#socket;\n }\n\n WithAddress(address: string) {\n this.#address = address;\n return this;\n }\n\n WithAuthToken(authToken: string) {\n this.#authToken = authToken;\n return this;\n }\n\n WithSocketIoCustomPath(socketIoCustomPath: string) {\n this.#socketIoCustomPath = socketIoCustomPath;\n return this;\n }\n\n WithLogger(logger: ISTSLogger) {\n this.#logger = logger;\n return this;\n }\n\n WithAgentManager(agentManager: AgentManager) {\n this.#agentManager = agentManager;\n return this;\n }\n\n WithReconnectTimeout(reconnectTimeout: number) {\n this.#reconnectTimeout = reconnectTimeout;\n return this;\n }\n\n SetupSocket() {\n if (!this.#address) {\n throw new Error(`SocketIoClientHelper:SetupSocket(): Error: [address not provided]`);\n }\n\n this.#EstablishSocketConnect();\n\n return this;\n }\n\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n protected ConnectCallBack(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void { };\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n protected SocketEventsCallBack(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void { };\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n protected ErrorCallBack(error: Error): void { };\n\n /*\n emit<Ev extends EventNames<ClientToServerEvents>>(ev: Ev, ...args: EventParams<ClientToServerEvents, Ev>): Socket<ServerToClientEvents, ClientToServerEvents> {\n if (this.#socket) {\n return this.#socket!.emit(ev, ...args);\n } else {\n throw new Error('SocketIoClient:emit(): Error: [socket instance not defined.]');\n }\n }\n */\n\n #EstablishSocketConnect(): void {\n if (this.#socket !== undefined) {\n // We already have a socket object (may or may not be connected)\n if (this.#socket.connected === true) {\n this.#socket.disconnect();\n }\n this.#socket = undefined;\n if (isNode) {\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n }\n return;\n }\n\n let socketOptions: Partial<SocketOptions & ManagerOptions>;\n if (isNode) {\n // https://socket.io/docs/v4/client-options/#reconnection\n // https://github.com/socketio/engine.io-client#methods\n socketOptions = {\n transports: [\"websocket\" ]\n }\n if (this.#agentManager) {\n if (!this.#address) {\n throw new Error(`SocketIoClient:SetupSocket(): Error: [address not provided when using agentManager]`);\n }\n socketOptions.agent = this.#agentManager.GetAgent(this.#address);\n }\n } else {\n socketOptions = {\n transports: [\"websocket\" ]\n }\n }\n\n // https://socket.io/docs/v4/middlewares/\n // Send auth token for connections\n if (this.#authToken) {\n socketOptions.auth = (cb) => {\n cb({\n token: this.#authToken\n });\n }\n }\n\n // On Server use;\n /*\n io.use((socket, next) => {\n const token = socket.handshake.auth.token;\n // ...\n });\n */\n\n if (this.#socketIoCustomPath && this.#socketIoCustomPath.localeCompare('') !== 0) {\n socketOptions.path = this.#socketIoCustomPath;\n }\n\n this.#socket = io(this.#address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n // Manager errors\n this.#socket.io.on('error', (err: Error) => {\n this.LogErrorMessage(`socketDetail.socket.io.on('error'): [${err}] Address: [${this.#address}]`);\n });\n\n this.#socket.io.on('reconnect_error', (err: Error) => {\n this.LogErrorMessage(`socketDetail.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);\n });\n\n // suppress automatic console logging by not letting it bubble up\n this.#socket.on(\"connect_error\", (err) => {\n this.LogErrorMessage(`socketDetail.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);\n });\n\n this.#socket.io.on('reconnect', (attempt: number) => {\n this.LogErrorMessage(`socketDetail.socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);\n });\n\n /*\n this.#socket.on(\"connect_timeout\", () => {\n this.#LogErrorMessage(`socketDetail.socket.on('connect_timeout') Address: [${this.#address}]`);\n });\n */\n\n this.#socket.on(\"connect\", () => {\n if (this.#socket) {\n this.LogDebugMessage(`Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);\n\n setTimeout(() => {\n this.ConnectCallBack(this.#socket as Socket<ServerToClientEvents, ClientToServerEvents>);\n }, 0);\n\n this.SocketEventsCallBack(this.#socket);\n\n } else {\n const errorMessage: string = 'Could not get socket object from socket.io, Address: [${socketDetail.address}]';\n this.LogErrorMessage(errorMessage);\n this.ErrorCallBack(new Error(errorMessage));\n }\n })\n\n // https://socket.io/docs/v4/client-socket-instance/#disconnect\n this.#socket.on(\"disconnect\", (reason: string) => {\n this.LogDebugMessage('socket disconnect: ' + reason);\n switch (reason) {\n case 'io server disconnect' : {\n // The server disconnect using disconnectSockets (i.e. normal safe shutdown)\n this.LogDebugMessage('The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n this.LogDebugMessage('The connection will be re-established when the server becomes available.');\n this.#socket = undefined;\n if (isNode) {\n if (this.#agentManager) {\n this.#agentManager.ResetAgent();\n }\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n }\n }\n break;\n case 'io client disconnect' :\n this.LogDebugMessage('The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n this.LogDebugMessage('The connection will not be re-established automatically.');\n // Do nothing\n break;\n case 'transport close' :\n case 'ping timeout' :\n case 'transport error' : {\n this.LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);\n this.LogDebugMessage('The connection will be re-established when the server becomes available.');\n if (this.#socket) {\n this.#socket.disconnect();\n }\n this.#socket = undefined;\n if (isNode) {\n if (this.#agentManager) {\n this.#agentManager?.ResetAgent();\n }\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n }\n }\n break;\n }\n });\n }\n}\n"],"names":["STSNamespace","STSRoom","STSEvent","TinyEmitter"],"mappings":"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","x_google_ignoreList":[1]}
1
+ {"version":3,"file":"index.mjs","sources":["../src/commonTypes.ts","../node_modules/detect-node/index.esm.js","../src/socketIoClient.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */ // --> OFF\nimport { Server, Socket, Namespace } from \"socket.io\";\nimport { ISTSLogger } from '@nsshunt/stsutils'\n\nexport interface STSDefaultClientToServerEvents {\n /**\n * Join the room(s) specified for this client.\n * @param room The room(s) to join for this client.\n * @returns \n */\n\t__STSjoinRoom: (room: string[]) => void;\n\n /**\n * Remove this client from the specified room(s).\n * @param room The room(s) to remove the client from within the server.\n * @returns \n */\n\t__STSleaveRoom: (room: string[]) => void;\n\n /**\n * Alerts the server that this client has flagged to disconnect. Allows server to perform clean-up if required. The server must call-back with the result of the disconnecting event.\n * @param reason Reason for the disconnecting event.\n * @param callback The server must call-back with the result of the disconnecting event.\n * @returns \n */\n\t__STSdisconnecting: (reason: string, callback: (data: string) => void) => void;\n\n /**\n * Alerts the server to disconnect this client.\n * @param reason Reason for the disconnect event.\n * @returns \n */\n\t__STSdisconnect: (reason: string) => void; // server and client event\n\n /**\n * Send a payload of data to 1 or more rooms registered on the server.\n * @param rooms Room array for broadcasting.\n * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n * interface that extends STSServerToClientEvents.\n * @returns \n */\n __STSsendToRoom: (rooms: string[], payload: { command: string, payload: any }) => void;\n\n /**\n * Send a payload of data to 1 or more rooms registered on the server.\n * @param room Single room for broadcasting.\n\t * @param timeout Number of ms to try and get responses from all clients\n * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n * interface that extends STSServerToClientEvents.\n\t * @param callback The callback function to be invoked once all clients have responded with their respective payloads\n * @returns \n */\n __STSsendToRoomWithCallback: (room: string, timeout: number, payload: { command: string, payload: any }, callback: (data: any) => void) => void; \n\n /**\n * Send a payload of data to 1 or more rooms registered on the server.\n * @param rooms Array of rooms for broadcasting.\n\t * @param timeout Number of ms to try and get responses from all clients\n * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n * interface that extends STSServerToClientEvents.\n\t * @param callback The callback function to be invoked once all clients have responded with their respective payloads\n * @returns \n */\n __STSsendToRoomsWithCallback: (rooms: string[], timeout: number, payload: { command: string, payload: any }, callback: (data: any) => void) => void; \n}\n\nexport interface STSDefaultServerToClientEvents {\n /**\n * The server may emit an unsolicited disconnect event to flag that all clients should disconnect. Most likely becuase the server may be shutting down.\n * @param reason Reason why the server is emitting this disconnect event.\n * @returns \n */\n\t__STSdisconnect: (reason: string) => void;\n}\n\nexport enum STSNamespace {\n\tSTSMonitor = 'stsinstrumentmanager/stsmonitor',\n\tSTSControl = 'stsinstrumentmanager/stscontrol',\n STSTestingNamespace = 'ststestingnamespace/ststesting'\n}\n\nexport enum STSRoom {\n\t// STSMonitor rooms\n\tSTSInstrumentDataRoom = 'stsinstrumentdataroom', // This room is for all instrument data messages\n\tSTSInstrumentDataSubscriptionRoom = 'stsinstrumentdatasubscriptionroom', // This room is only for subscribed instrument data messages\n\n\t// STSControl rooms\n\tSTSRunnerRoom = 'stsrunnerroom',\n\tSTSNodeRunnerRoom = 'stsnoderunnerroom'\n}\n\nexport enum STSEvent {\n\t// STSInstrumentData\n\tSTSInstrumentData = 'stsinstrumentdata',\n\tSTSSubInstrumentData = 'stssubinstrumentdata', // sub-scribed instrument data. This only outputs the nodes that have been subscribed by the client(s).\n\tSTSResetInstrumentData = 'stsresetinstrumentdata',\n\n\tSTSStartLoggingInstrumentData = 'stsStartLoggingInstrumentData',\n\tSTSStopLoggingInstrumentData = 'stsStopLoggingInstrumentData',\n\n\t// STSRunner events\n\tSTSStart = 'stsstart', // Start a test run with options as payload.\n\tSTSStop = 'stsstop', // Stop test run(s).\n\tSTSPause = 'stspause', // Pause test run(s).\n\tSTSResume = 'stsresume', // Resume test run(s).\n\tSTSTerminate = 'ststerminate', // Terminate runner instances and exit applications.\n\t// This may also be uysed to force trigger self healing (i.e. auto re-start) when\n\t// running within a container orchestrator such as K8, K3 or Docker Swarm.\n\tSTSUpdateStaticConfig = 'stsupdatestaticconfig', // Update base configuration. Options as payload.\n\tSTSUpdateDynamicConfig = 'stsupdatedynamicconfig', // Update running configuration. This is used\n\t// to control the runnning behaviour of test(s) in-flight. Options as payload.\n\n\tSTSSendToRoom = 'sendToRoom',\n\n\t// Standard socket events\n\tconnect = 'connect'\n}\n\n// https://socket.io/docs/v4/typescript/\n\nexport interface InterServerEvents {\n\tping: () => void;\n}\n\nexport interface STSSocketIONamespace {\n\tnamespace: string\n\tpid: number\n\tsocketionamespace: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n}\n\nexport type STSSocketIONamespaces = Record<string, STSSocketIONamespace>;\n\nexport type STSServerSocket = Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\nexport type STSClientSocket = Socket<STSDefaultServerToClientEvents, STSDefaultClientToServerEvents, InterServerEvents>\n","// 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//import { EventNames, EventParams } from \"@socket.io/component-emitter\";\n\nimport isNode from 'detect-node';\n\nimport { ISTSLogger, AgentManager } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes'\n\nimport { TinyEmitter } from 'tiny-emitter';\n\nexport abstract class SocketIoClient<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents> extends TinyEmitter {\n #agentManager?: AgentManager\n #logger?: ISTSLogger\n #name: string\n #address?: string\n #socketIoCustomPath?: string\n #authToken?: string\n #socket?: Socket<ServerToClientEvents, ClientToServerEvents>;\n #reconnectTimeout: number = 2000; // default\n\n constructor(name: string) {\n super();\n this.#name = name;\n }\n \n protected get logPrefix(): string {\n return `SocketIoClient[${this.#name}]:`;\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n protected LogDebugMessage(message: any): void {\n if (this.#logger) this.#logger.debug(`${this.logPrefix}${message}`);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n protected LogErrorMessage(message: any): void {\n if (this.#logger) this.#logger.error(`${this.logPrefix}${message}`);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n protected LogWarningMessage(message: any): void {\n if (this.#logger) this.#logger.warn(`${this.logPrefix}${message}`);\n }\n\n get name(): string {\n return this.#name;\n }\n\n get reconnectTimeout(): number {\n return this.#reconnectTimeout;\n }\n\n get agentManager(): AgentManager | undefined {\n return this.#agentManager;\n }\n\n get logger(): ISTSLogger | undefined {\n return this.#logger;\n }\n\n get address(): string | undefined {\n return this.#address;\n }\n\n get authToken(): string | undefined {\n return this.#authToken;\n }\n\n get socketIoCustomPath(): string | undefined {\n return this.#socketIoCustomPath;\n }\n\n get socket(): Socket<ServerToClientEvents, ClientToServerEvents> | undefined {\n return this.#socket;\n }\n\n WithAddress(address: string) {\n this.#address = address;\n return this;\n }\n\n WithAuthToken(authToken: string) {\n this.#authToken = authToken;\n return this;\n }\n\n WithSocketIoCustomPath(socketIoCustomPath: string) {\n this.#socketIoCustomPath = socketIoCustomPath;\n return this;\n }\n\n WithLogger(logger: ISTSLogger) {\n this.#logger = logger;\n return this;\n }\n\n WithAgentManager(agentManager: AgentManager) {\n this.#agentManager = agentManager;\n return this;\n }\n\n WithReconnectTimeout(reconnectTimeout: number) {\n this.#reconnectTimeout = reconnectTimeout;\n return this;\n }\n\n SetupSocket() {\n if (!this.#address) {\n throw new Error(`SocketIoClientHelper:SetupSocket(): Error: [address not provided]`);\n }\n\n this.#EstablishSocketConnect();\n\n return this;\n }\n\n \n protected abstract SocketConnect(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;\n \n protected abstract SetupSocketEvents(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;\n \n protected abstract SocketConnectError(error: Error): void;\n \n protected abstract SocketDisconnect(reason: string): void;\n\n // Engine Errors / Events\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n protected EngineError(error: Error): void { };\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n protected EngineReconnectError(error: Error): void { };\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n protected EngineConnectError(error: Error): void { };\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n protected EngineReconnect(attempt: number): void { };\n\n /*\n emit<Ev extends EventNames<ClientToServerEvents>>(ev: Ev, ...args: EventParams<ClientToServerEvents, Ev>): Socket<ServerToClientEvents, ClientToServerEvents> {\n if (this.#socket) {\n return this.#socket!.emit(ev, ...args);\n } else {\n throw new Error('SocketIoClient:emit(): Error: [socket instance not defined.]');\n }\n }\n */\n\n #EstablishSocketConnect(): void {\n if (this.#socket !== undefined) {\n // We already have a socket object (may or may not be connected)\n if (this.#socket.connected === true) {\n this.#socket.disconnect();\n }\n this.#socket = undefined;\n if (isNode) {\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n }\n return;\n }\n\n let socketOptions: Partial<SocketOptions & ManagerOptions>;\n if (isNode) {\n // https://socket.io/docs/v4/client-options/#reconnection\n // https://github.com/socketio/engine.io-client#methods\n socketOptions = {\n transports: [\"websocket\" ]\n }\n if (this.#agentManager) {\n if (!this.#address) {\n throw new Error(`SocketIoClient:SetupSocket(): Error: [address not provided when using agentManager]`);\n }\n socketOptions.agent = this.#agentManager.GetAgent(this.#address);\n }\n } else {\n socketOptions = {\n transports: [\"websocket\" ]\n }\n }\n\n // https://socket.io/docs/v4/middlewares/\n // Send auth token for connections\n if (this.#authToken) {\n socketOptions.auth = (cb) => {\n cb({\n token: this.#authToken\n });\n }\n }\n\n // On Server use;\n /*\n io.use((socket, next) => {\n const token = socket.handshake.auth.token;\n // ...\n });\n */\n\n if (this.#socketIoCustomPath && this.#socketIoCustomPath.localeCompare('') !== 0) {\n socketOptions.path = this.#socketIoCustomPath;\n }\n\n this.#socket = io(this.#address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n // Manager errors\n this.#socket.io.on('error', (err: Error) => {\n this.LogErrorMessage(`socketDetail.socket.io.on('error'): [${err}] Address: [${this.#address}]`);\n this.EngineError(err);\n });\n\n this.#socket.io.on('reconnect_error', (err: Error) => {\n this.LogErrorMessage(`socketDetail.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);\n this.EngineReconnectError(err);\n });\n\n // suppress automatic console logging by not letting it bubble up\n this.#socket.on(\"connect_error\", (err) => {\n this.LogErrorMessage(`socketDetail.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);\n this.EngineConnectError(err);\n });\n\n this.#socket.io.on('reconnect', (attempt: number) => {\n this.LogErrorMessage(`socketDetail.socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);\n this.EngineReconnect(attempt);\n });\n\n /*\n this.#socket.on(\"connect_timeout\", () => {\n this.#LogErrorMessage(`socketDetail.socket.on('connect_timeout') Address: [${this.#address}]`);\n });\n */\n\n this.#socket.on(\"connect\", () => {\n if (this.#socket) {\n this.LogDebugMessage(`Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);\n\n setTimeout(() => {\n this.SocketConnect(this.#socket as Socket<ServerToClientEvents, ClientToServerEvents>);\n }, 0);\n\n this.SetupSocketEvents(this.#socket);\n\n } else {\n const errorMessage: string = 'Could not get socket object from socket.io, Address: [${socketDetail.address}]';\n this.LogErrorMessage(errorMessage);\n this.SocketConnectError(new Error(errorMessage));\n }\n })\n\n // https://socket.io/docs/v4/client-socket-instance/#disconnect\n this.#socket.on(\"disconnect\", (reason: string) => {\n this.LogDebugMessage('socket disconnect: ' + reason);\n this.SocketDisconnect(reason);\n switch (reason) {\n case 'io server disconnect' : {\n // The server disconnect using disconnectSockets (i.e. normal safe shutdown)\n this.LogDebugMessage('The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n this.LogDebugMessage('The connection will be re-established when the server becomes available.');\n this.#socket = undefined;\n if (isNode) {\n if (this.#agentManager) {\n this.#agentManager.ResetAgent();\n }\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n }\n }\n break;\n case 'io client disconnect' :\n this.LogDebugMessage('The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n this.LogDebugMessage('The connection will not be re-established automatically.');\n // Do nothing\n break;\n case 'transport close' :\n case 'ping timeout' :\n case 'transport error' : {\n this.LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);\n this.LogDebugMessage('The connection will be re-established when the server becomes available.');\n if (this.#socket) {\n this.#socket.disconnect();\n }\n this.#socket = undefined;\n if (isNode) {\n if (this.#agentManager) {\n this.#agentManager?.ResetAgent();\n }\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout); //@@ config\n }\n }\n break;\n }\n });\n }\n}\n"],"names":["STSNamespace","STSRoom","STSEvent","TinyEmitter"],"mappings":";;AA2EO,IAAK,iCAAAA,kBAAL;AACNA,gBAAA,YAAA,IAAa;AACbA,gBAAA,YAAA,IAAa;AACVA,gBAAA,qBAAA,IAAsB;AAHd,SAAAA;AAAA,GAAA,gBAAA,CAAA,CAAA;AAML,IAAK,4BAAAC,aAAL;AAENA,WAAA,uBAAA,IAAwB;AACxBA,WAAA,mCAAA,IAAoC;AAGpCA,WAAA,eAAA,IAAgB;AAChBA,WAAA,mBAAA,IAAoB;AAPT,SAAAA;AAAA,GAAA,WAAA,CAAA,CAAA;AAUL,IAAK,6BAAAC,cAAL;AAENA,YAAA,mBAAA,IAAoB;AACpBA,YAAA,sBAAA,IAAuB;AACvBA,YAAA,wBAAA,IAAyB;AAEzBA,YAAA,+BAAA,IAAgC;AAChCA,YAAA,8BAAA,IAA+B;AAG/BA,YAAA,UAAA,IAAW;AACXA,YAAA,SAAA,IAAU;AACVA,YAAA,UAAA,IAAW;AACXA,YAAA,WAAA,IAAY;AACZA,YAAA,cAAA,IAAe;AAGfA,YAAA,uBAAA,IAAwB;AACxBA,YAAA,wBAAA,IAAyB;AAGzBA,YAAA,eAAA,IAAgB;AAGhBA,YAAA,SAAA,IAAU;AAxBC,SAAAA;AAAA,GAAA,YAAA,CAAA,CAAA;AC1FZ,MAAA,SAAe,OAAO,UAAU,SAAS,KAAK,OAAO,YAAY,cAAc,UAAU,CAAC,MAAM;ACUzF,MAAe,uBAAiJC,mBAAAA,YAAY;AAAA,EAC/K;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,oBAA4B;AAAA;AAAA,EAE5B,YAAY,MAAc;AACtB,UAAA;AACA,SAAK,QAAQ;AAAA,EACjB;AAAA,EAEA,IAAc,YAAoB;AAC9B,WAAO,kBAAkB,KAAK,KAAK;AAAA,EACvC;AAAA;AAAA,EAGU,gBAAgB,SAAoB;AAC1C,QAAI,KAAK,QAAS,MAAK,QAAQ,MAAM,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,EACtE;AAAA;AAAA,EAGU,gBAAgB,SAAoB;AAC1C,QAAI,KAAK,QAAS,MAAK,QAAQ,MAAM,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,EACtE;AAAA;AAAA,EAGU,kBAAkB,SAAoB;AAC5C,QAAI,KAAK,QAAS,MAAK,QAAQ,KAAK,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,EACrE;AAAA,EAEA,IAAI,OAAe;AACf,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,mBAA2B;AAC3B,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,eAAyC;AACzC,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,SAAiC;AACjC,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,UAA8B;AAC9B,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,YAAgC;AAChC,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,qBAAyC;AACzC,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,SAAyE;AACzE,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,YAAY,SAAiB;AACzB,SAAK,WAAW;AAChB,WAAO;AAAA,EACX;AAAA,EAEA,cAAc,WAAmB;AAC7B,SAAK,aAAa;AAClB,WAAO;AAAA,EACX;AAAA,EAEA,uBAAuB,oBAA4B;AAC/C,SAAK,sBAAsB;AAC3B,WAAO;AAAA,EACX;AAAA,EAEA,WAAW,QAAoB;AAC3B,SAAK,UAAU;AACf,WAAO;AAAA,EACX;AAAA,EAEA,iBAAiB,cAA4B;AACzC,SAAK,gBAAgB;AACrB,WAAO;AAAA,EACX;AAAA,EAEA,qBAAqB,kBAA0B;AAC3C,SAAK,oBAAoB;AACzB,WAAO;AAAA,EACX;AAAA,EAEA,cAAc;AACV,QAAI,CAAC,KAAK,UAAU;AAChB,YAAM,IAAI,MAAM,mEAAmE;AAAA,IACvF;AAEA,SAAK,wBAAA;AAEL,WAAO;AAAA,EACX;AAAA;AAAA;AAAA,EAaU,YAAY,OAAoB;AAAA,EAAE;AAAA;AAAA,EAElC,qBAAqB,OAAoB;AAAA,EAAE;AAAA;AAAA,EAE3C,mBAAmB,OAAoB;AAAA,EAAE;AAAA;AAAA,EAEzC,gBAAgB,SAAuB;AAAA,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYnD,0BAAgC;AAC5B,QAAI,KAAK,YAAY,QAAW;AAE5B,UAAI,KAAK,QAAQ,cAAc,MAAM;AACjC,aAAK,QAAQ,WAAA;AAAA,MACjB;AACA,WAAK,UAAU;AACf,UAAI,QAAQ;AACR,mBAAW,MAAM,KAAK,wBAAA,GAA2B,KAAK,iBAAiB,EAAE,MAAA;AAAA,MAC7E,OAAO;AACH,mBAAW,MAAM,KAAK,wBAAA,GAA2B,KAAK,iBAAiB;AAAA,MAC3E;AACA;AAAA,IACJ;AAEA,QAAI;AACJ,QAAI,QAAQ;AAGR,sBAAgB;AAAA,QACZ,YAAY,CAAC,WAAY;AAAA,MAAA;AAE7B,UAAI,KAAK,eAAe;AACpB,YAAI,CAAC,KAAK,UAAU;AAChB,gBAAM,IAAI,MAAM,qFAAqF;AAAA,QACzG;AACA,sBAAc,QAAQ,KAAK,cAAc,SAAS,KAAK,QAAQ;AAAA,MACnE;AAAA,IACJ,OAAO;AACH,sBAAgB;AAAA,QACZ,YAAY,CAAC,WAAY;AAAA,MAAA;AAAA,IAEjC;AAIA,QAAI,KAAK,YAAY;AACjB,oBAAc,OAAO,CAAC,OAAO;AACzB,WAAG;AAAA,UACC,OAAO,KAAK;AAAA,QAAA,CACf;AAAA,MACL;AAAA,IACJ;AAUA,QAAI,KAAK,uBAAuB,KAAK,oBAAoB,cAAc,EAAE,MAAM,GAAG;AAC9E,oBAAc,OAAO,KAAK;AAAA,IAC9B;AAEA,SAAK,UAAU,GAAG,KAAK,UAAU,aAAa;AAG9C,SAAK,QAAQ,GAAG,GAAG,SAAS,CAAC,QAAe;AACxC,WAAK,gBAAgB,wCAAwC,GAAG,eAAe,KAAK,QAAQ,GAAG;AAC/F,WAAK,YAAY,GAAG;AAAA,IACxB,CAAC;AAED,SAAK,QAAQ,GAAG,GAAG,mBAAmB,CAAC,QAAe;AAClD,WAAK,gBAAgB,kDAAkD,GAAG,eAAe,KAAK,QAAQ,GAAG;AACzG,WAAK,qBAAqB,GAAG;AAAA,IACjC,CAAC;AAGD,SAAK,QAAQ,GAAG,iBAAiB,CAAC,QAAQ;AACtC,WAAK,gBAAgB,6CAA6C,GAAG,eAAe,KAAK,QAAQ,GAAG;AACpG,WAAK,mBAAmB,GAAG;AAAA,IAC/B,CAAC;AAED,SAAK,QAAQ,GAAG,GAAG,aAAa,CAAC,YAAoB;AACjD,WAAK,gBAAgB,oDAAoD,OAAO,eAAe,KAAK,QAAQ,GAAG;AAC/G,WAAK,gBAAgB,OAAO;AAAA,IAChC,CAAC;AAQD,SAAK,QAAQ,GAAG,WAAW,MAAM;AAC7B,UAAI,KAAK,SAAS;AACd,aAAK,gBAAgB,YAAY,KAAK,QAAQ,EAAE,2BAA2B,KAAK,QAAQ,GAAG;AAE3F,mBAAW,MAAM;AACb,eAAK,cAAc,KAAK,OAA6D;AAAA,QACzF,GAAG,CAAC;AAEJ,aAAK,kBAAkB,KAAK,OAAO;AAAA,MAEvC,OAAO;AACH,cAAM,eAAuB;AAC7B,aAAK,gBAAgB,YAAY;AACjC,aAAK,mBAAmB,IAAI,MAAM,YAAY,CAAC;AAAA,MACnD;AAAA,IACJ,CAAC;AAGD,SAAK,QAAQ,GAAG,cAAc,CAAC,WAAmB;AAC9C,WAAK,gBAAgB,wBAAwB,MAAM;AACnD,WAAK,iBAAiB,MAAM;AAC5B,cAAQ,QAAA;AAAA,QACR,KAAK;AAAyB;AAE1B,iBAAK,gBAAgB,uHAAuH;AAC5I,iBAAK,gBAAgB,0EAA0E;AAC/F,iBAAK,UAAU;AACf,gBAAI,QAAQ;AACR,kBAAI,KAAK,eAAe;AACpB,qBAAK,cAAc,WAAA;AAAA,cACvB;AACA,yBAAW,MAAM,KAAK,wBAAA,GAA2B,KAAK,iBAAiB,EAAE,MAAA;AAAA,YAC7E,OAAO;AACH,yBAAW,MAAM,KAAK,wBAAA,GAA2B,KAAK,iBAAiB;AAAA,YAC3E;AAAA,UACJ;AACI;AAAA,QACJ,KAAK;AACD,eAAK,gBAAgB,4HAA4H;AACjJ,eAAK,gBAAgB,0DAA0D;AAE/E;AAAA,QACJ,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAoB;AACrB,iBAAK,gBAAgB,8CAA8C,MAAM,GAAG;AAC5E,iBAAK,gBAAgB,0EAA0E;AAC/F,gBAAI,KAAK,SAAS;AACd,mBAAK,QAAQ,WAAA;AAAA,YACjB;AACA,iBAAK,UAAU;AACf,gBAAI,QAAQ;AACR,kBAAI,KAAK,eAAe;AACpB,qBAAK,eAAe,WAAA;AAAA,cACxB;AACA,yBAAW,MAAM,KAAK,wBAAA,GAA2B,KAAK,iBAAiB,EAAE,MAAA;AAAA,YAC7E,OAAO;AACH,yBAAW,MAAM,KAAK,wBAAA,GAA2B,KAAK,iBAAiB;AAAA,YAC3E;AAAA,UACJ;AACI;AAAA,MAAA;AAAA,IAER,CAAC;AAAA,EACL;AACJ;","x_google_ignoreList":[1]}
package/dist/node.cjs CHANGED
@@ -26,12 +26,6 @@ class SocketIoServer extends index.tinyEmitterExports.TinyEmitter {
26
26
  super();
27
27
  this.serverName = serverName;
28
28
  }
29
- SocketDisconnectCallBack = (socket, reason) => {
30
- };
31
- SocketDisconnectingCallBack = (socket, reason) => {
32
- };
33
- SocketErrorCallBack = (socket, error) => {
34
- };
35
29
  get logPrefix() {
36
30
  if (this.namespace) {
37
31
  return `SocketIoServer[${this.serverName}:${this.namespace}]: `;
@@ -83,10 +77,6 @@ class SocketIoServer extends index.tinyEmitterExports.TinyEmitter {
83
77
  // Use this middleware to check every packet being received
84
78
  SetupMessageMiddleware = (socket) => {
85
79
  };
86
- SocketConnectCallBack = (socket) => {
87
- };
88
- SocketEventsCallBack = (socket) => {
89
- };
90
80
  /*
91
81
  protected GetConfig = (socketIoServeroptions: ISocketIoServerOpitons): Partial<ServerOptions> => {
92
82
  //this.#redisClient = createClient({url: this.#options.ioRedisMessageProcessorUrl});
@@ -285,15 +275,15 @@ class SocketIoServer extends index.tinyEmitterExports.TinyEmitter {
285
275
  SetupStandardEvents = (socket) => {
286
276
  socket.on("disconnect", (reason) => {
287
277
  this.LogDebugMessage(`SetupStandardEvents(): socket disconnect, ID: [${socket.id}], reason: [${reason}]`);
288
- this.SocketDisconnectCallBack(socket, reason);
278
+ this.SocketDisconnect(socket, reason);
289
279
  });
290
280
  socket.on("disconnecting", (reason) => {
291
281
  this.LogDebugMessage(`SetupStandardEvents(): socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);
292
- this.SocketDisconnectingCallBack(socket, reason);
282
+ this.SocketDisconnecting(socket, reason);
293
283
  });
294
284
  socket.on("error", (error) => {
295
285
  this.LogDebugMessage(`SetupStandardEvents(): socket error, ID: [${socket.id}], Error: [${error}]`);
296
- this.SocketErrorCallBack(socket, error);
286
+ this.SocketError(socket, error);
297
287
  });
298
288
  socket.on("__STSdisconnect", (reason) => {
299
289
  this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnect: socket disconnect, ID: [${socket.id}], reason: [${reason}]`);
@@ -429,10 +419,10 @@ class SocketIoServer extends index.tinyEmitterExports.TinyEmitter {
429
419
  this.SetupStandardEvents(socket);
430
420
  setTimeout(() => {
431
421
  this.LogDebugMessage(`SetupNamespace(): SocketConnectCallBack(): Socket: [${socket.id}]`);
432
- this.SocketConnectCallBack(socket);
422
+ this.SocketConnect(socket);
433
423
  }, 0);
434
424
  this.LogDebugMessage(`SetupNamespace(): SocketEventsCallBack(): Socket: [${socket.id}]`);
435
- this.SocketEventsCallBack(socket);
425
+ this.SetupSocketEvents(socket);
436
426
  });
437
427
  } else {
438
428
  const errorMessage = `SetupNamespace(): Error: [No server attached]`;
package/dist/node.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"node.cjs","sources":["../src/socketIoServer.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */ // --> OFF\nimport { ISTSLogger, JSONObject, Sleep } from '@nsshunt/stsutils'\n\nimport { Server, Namespace, Socket, ServerOptions } from \"socket.io\";\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, STSServerSocket, \n InterServerEvents } from './commonTypes'\n\n//import { createClient, RedisClientType } from 'redis';\nimport { Redis } from 'ioredis';\n\nimport { createAdapter as clusterCreateAdapter } from '@socket.io/cluster-adapter'\nimport { createAdapter } from \"@socket.io/redis-streams-adapter\";\n\nimport { TinyEmitter } from 'tiny-emitter';\n\nexport interface ISocketIoServerOpitons {\n listenPort?: number\n ioRedisMessageProcessorUrl?: string\n wssCustomPath?: string\n serverClusterMode?: boolean\n}\n \nexport abstract class SocketIoServer<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> extends TinyEmitter {\n protected namespace?: string\n protected socketionamespace?: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n //protected socketionamespace?: Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>\n protected logger?: ISTSLogger\n protected io?: Server<ClientToServerEvents, ServerToClientEvents>;\n //#redisClient: RedisClientType | Redis | null = null;\n protected redisClient?: Redis;\n protected listenPort?: number;\n protected socketIoCustomPath?: string;\n protected ioRedisMessageProcessorUrl?: string;\n protected serverClusterMode?: boolean;\n protected rooms?: string[];\n protected serverName: string\n protected draining: boolean = false;\n protected attached: boolean = false;\n\n constructor(serverName: string) { // IProcessBase\n super();\n this.serverName = serverName;\n }\n\n protected SocketDisconnectCallBack = (socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void => { };\n\n protected SocketDisconnectingCallBack = (socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void => { };\n\n protected SocketErrorCallBack = (socket: Socket<ClientToServerEvents, ServerToClientEvents>, error: Error): void => { };\n\n protected get logPrefix(): string {\n if (this.namespace) {\n return `SocketIoServer[${this.serverName}:${this.namespace}]: `;\n } else {\n return `SocketIoServer[${this.serverName}:<No Namespace>]: `;\n }\n }\n\n protected LogErrorMessage(message: any) {\n if (this.logger) {\n this.logger.error(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogDebugMessage(message: any) {\n if (this.logger) {\n this.logger.debug(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogInfoMessage(message: any) {\n if (this.logger) {\n this.logger.info(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogWarnMessage(message: any) {\n if (this.logger) {\n this.logger.warn(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogSillyMessage(message: any) {\n if (this.logger) {\n this.logger.silly(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogVerboseMessage(message: any) {\n if (this.logger) {\n this.logger.verbose(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogHttpMessage(message: any) {\n if (this.logger) {\n this.logger.http(`${this.logPrefix}${message}`);\n }\n }\n\n // https://socket.io/docs/v4/middlewares/\n // https://socket.io/docs/v4/server-socket-instance/#sockethandshake\n // https://socket.io/docs/v4/server-socket-instance/#socket-middlewares\n // Use this middleward to check every incomming connection\n protected SetupConnectionMiddleware = () => { };\n\n // Use this middleware to check every packet being received\n protected SetupMessageMiddleware = (socket: STSServerSocket) => { };\n\n protected SocketConnectCallBack = (socket: Socket<ClientToServerEvents, ServerToClientEvents>): void => { };\n\n protected SocketEventsCallBack = (socket: Socket<ClientToServerEvents, ServerToClientEvents>): void => { };\n\n /*\n protected GetConfig = (socketIoServeroptions: ISocketIoServerOpitons): Partial<ServerOptions> => {\n //this.#redisClient = createClient({url: this.#options.ioRedisMessageProcessorUrl});\n //await this.#redisClient.connect();\n this.LogDebugMessage(`GetConfig() transports: [ [websocket] ]`);\n const options: Partial<ServerOptions> = {\n transports: [ \"websocket\" ], // or [ \"websocket\", \"polling\" ] (to use long-poolling. Note that the order matters)\n }\n\n if (socketIoServeroptions.ioRedisMessageProcessorUrl && socketIoServeroptions.ioRedisMessageProcessorUrl !== '') {\n this.redisClient = new Redis(socketIoServeroptions.ioRedisMessageProcessorUrl);\n this.LogDebugMessage(`GetConfig() createAdapter(redis): redis url: [${socketIoServeroptions.ioRedisMessageProcessorUrl}]`);\n options.adapter = createAdapter(this.redisClient) as any;\n } else if (socketIoServeroptions.serverClusterMode && socketIoServeroptions.serverClusterMode === true) {\n this.LogDebugMessage(`GetConfig() createAdapter(cluster)`);\n options.adapter = clusterCreateAdapter() as any;\n }\n\n if (socketIoServeroptions.wssCustomPath && socketIoServeroptions.wssCustomPath.localeCompare('') !== 0) {\n this.LogDebugMessage(`GetConfig() wssCustomPath: [${socketIoServeroptions.wssCustomPath}]`);\n options.path = socketIoServeroptions.wssCustomPath;\n }\n\n return options;\n }\n */\n\n protected SetEngineEvents = () => {\n if (this.io) {\n this.io.engine.on(\"connection_error\", (err) => {\n this.LogWarnMessage(`SetEngineEvents(): connection_error`); // the request object\n this.LogWarnMessage(err.req); // the request object\n this.LogWarnMessage(err.code); // the error code, for example 1\n this.LogWarnMessage(err.message); // the error message, for example \"Session ID unknown\"\n this.LogWarnMessage(err.context); // some additional error context\n });\n }\n }\n\n WithLogger = (logger: ISTSLogger) => {\n this.logger = logger;\n return this;\n }\n\n WithListenPort = (listenPort: number) => {\n this.listenPort = listenPort;\n return this;\n }\n\n WithSocketIoCustomPath = (socketIoCustomPath: string) => {\n this.socketIoCustomPath = socketIoCustomPath;\n return this;\n }\n\n WithIoRedisMessageProcessorUrl = (ioRedisMessageProcessorUrl: string) => {\n this.ioRedisMessageProcessorUrl = ioRedisMessageProcessorUrl;\n return this;\n }\n\n WithClusterMode = (serverClusterMode: boolean) => {\n this.serverClusterMode = serverClusterMode;\n return this;\n }\n\n WithRooms = (rooms: string[]) => {\n this.rooms = rooms;\n return this;\n }\n\n WithNamespace = (namespace: string) => {\n this.namespace = namespace;\n return this;\n }\n\n AttachSocketIoServer = async (server: Server): Promise<SocketIoServer<ClientToServerEvents, ServerToClientEvents>> => {\n if (!this.io) {\n this.LogInfoMessage(`AttachServer(): io = server`);\n this.io = server;\n\n this.LogInfoMessage(`AttachServer(): attached = true`);\n this.attached = true;\n\n this.LogInfoMessage(`AttachServer(): SetupNamespace()`);\n this.SetupNamespace();\n } else {\n const errorMessage = (this.attached === true ? `AttachServer(): Server already exists (from AttachServer())` : `AttachServer(): Server already exists (from StartServer())`);\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n return this;\n }\n\n StartSocketIoServer = async (): Promise<SocketIoServer<ClientToServerEvents, ServerToClientEvents>> => {\n //this.#io = require(\"socket.io\")(this.#httpServer, options);\n if (!this.namespace) {\n const errorMessage = `StartServer(): Error: [namespace not specified]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n\n if (!this.io) {\n if (!this.listenPort) {\n const errorMessage = `StartServer(): Error: [listenPort not specified]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n\n this.LogDebugMessage(`StartServer(): draining = false`);\n this.draining = false;\n\n this.LogDebugMessage(`StartServer(): transports: [ [websocket] ]`);\n const options: Partial<ServerOptions> = {\n transports: [ \"websocket\" ], // or [ \"websocket\", \"polling\" ] (to use long-poolling. Note that the order matters)\n }\n\n if (this.ioRedisMessageProcessorUrl && this.ioRedisMessageProcessorUrl !== '') {\n this.redisClient = new Redis(this.ioRedisMessageProcessorUrl);\n this.LogDebugMessage(`StartServer(): createAdapter(redis): redis url: [${this.ioRedisMessageProcessorUrl}]`);\n options.adapter = createAdapter(this.redisClient) as any;\n } else if (this.serverClusterMode && this.serverClusterMode === true) {\n this.LogDebugMessage(`StartServer(): createAdapter(cluster)`);\n options.adapter = clusterCreateAdapter() as any;\n }\n\n if (this.socketIoCustomPath && this.socketIoCustomPath.localeCompare('') !== 0) {\n this.LogDebugMessage(`StartServer(): socketIoCustomPath: [${this.socketIoCustomPath}]`);\n options.path = this.socketIoCustomPath;\n }\n\n this.LogDebugMessage(`StartServer(): new Server(): listenPort: [${this.listenPort}]`);\n this.io = new Server(this.listenPort, options);\n\n this.LogDebugMessage(`StartServer(): SetEngineEvents()`);\n this.SetEngineEvents();\n\n this.LogDebugMessage(`StartServer(): Sleeping ...`);\n await Sleep(500);\n this.LogDebugMessage(`StartServer(): Done Sleeping`);\n\n this.LogInfoMessage(`AttachServer(): attached = false`);\n this.attached = false;\n\n this.LogInfoMessage(`StartServer(): SetupNamespace()`);\n this.SetupNamespace();\n\n } else {\n const errorMessage = (this.attached === true ? `StartServer(): Server already exists (from AttachServer())` : `StartServer(): Server already exists (from StartServer())`);\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n return this;\n }\n\n DetachSockerIoServer = async (): Promise<void> => {\n if (this.io) {\n if (this.attached === true) {\n this.LogInfoMessage(`DetachServer(): StopNamespace()`);\n await this.StopNamespace();\n this.io = undefined;\n this.LogInfoMessage(`DetachServer(): attached = false`);\n this.attached = false;\n } else {\n const errorMessage = `DetachServer(): Error: [Server has not been attached. Use StopServer() to stop the socker.io server.]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n } else {\n const errorMessage = `DetachServer(): Error: [no server exists to DetachServer()]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n }\n\n StopSocketIoServer = async () => {\n if (this.io) {\n if (this.attached === false) {\n // We are now draining connections\n this.LogInfoMessage(`StopServer(): draining = true`);\n this.draining = true;\n\n this.LogInfoMessage(`StopServer(): StopNamespace()`);\n await this.StopNamespace();\n\n this.LogInfoMessage(`StopServer(): io.of('/').adapter.close()`);\n await this.io.of('/').adapter.close();\n\n if (this.redisClient) {\n this.LogInfoMessage(`StopServer(): redisClient.disconnect()`);\n await this.redisClient.disconnect();\n this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Sleeping...)`);\n await Sleep(50);\n this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Done Sleeping)`);\n }\n\n // boot all current connections\n this.LogInfoMessage(`StopServer(): io.disconnectSockets()`);\n this.io.disconnectSockets();\n\n // Stop any future connections, close this server (does not close the underlying http(s) server if io server via that method\n this.LogInfoMessage(`StopServer(): io.close()`);\n this.io.close();\n\n this.LogInfoMessage(`StopServer(): io = undefined`);\n this.io = undefined;\n } else {\n const errorMessage = `StopServer(): Cannot stop an attached server. The server created must handle stop/disconnections. Use StopNamespace() instead.`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n } else {\n const errorMessage = `StopServer(): Error: [no server exists to StopServer()]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n }\n\n LeaveRoom = (socket: STSServerSocket, room: string): void => {\n this.LogDebugMessage(`LeaveRoom(): Leaving room [${room}]`);\n socket.leave(room);\n };\n\n JoinRoom = (socket: STSServerSocket, room: string): void => {\n this.LogDebugMessage(`JoinRoom(): Socket joining room [${room}], ID: [${socket.id}]`);\n socket.join(room);\n };\n\n protected StopNamespace = async() => {\n this.LogInfoMessage(`StopServer(): CloseNamespaceAdaptors()`);\n await this.CloseNamespaceAdaptors();\n\n this.LogInfoMessage(`StopServer(): DisconnectNamespaceSockets()`);\n this.DisconnectNamespaceSockets();\n }\n\n protected SetupStandardEvents = (socket: STSServerSocket): void => {\n socket.on('disconnect', (reason: string) => {\n this.LogDebugMessage(`SetupStandardEvents(): socket disconnect, ID: [${socket.id}], reason: [${reason}]`);\n this.SocketDisconnectCallBack(socket, reason);\n });\n\n socket.on('disconnecting', (reason: string) => {\n this.LogDebugMessage(`SetupStandardEvents(): socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);\n this.SocketDisconnectingCallBack(socket, reason);\n });\n\n socket.on('error', (error: Error) => {\n this.LogDebugMessage(`SetupStandardEvents(): socket error, ID: [${socket.id}], Error: [${error}]`);\n this.SocketErrorCallBack(socket, error);\n });\n\n socket.on(\"__STSdisconnect\", (reason: string) => {\n this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnect: socket disconnect, ID: [${socket.id}], reason: [${reason}]`);\n });\n\n socket.on(\"__STSdisconnecting\", (reason, callBackResult) => {\n this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnecting: socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);\n callBackResult(\"__STSdisconnecting accepted by server.\");\n });\n\n socket.on('__STSjoinRoom', (rooms: string[]): void => { //@@ names\n rooms.forEach((room) => {\n this.LogDebugMessage(`SetupStandardEvents(): __STSjoinRoom: room: [${room}], socket: [${socket.id}]`);\n this.JoinRoom(socket, room)\n });\n });\n\n socket.on('__STSleaveRoom', (rooms: string[]): void => { //@@ names\n rooms.forEach((room) => {\n this.LogDebugMessage(`SetupStandardEvents(): __STSleaveRoom: room: [${room}], socket: [${socket.id}]`);\n this.LeaveRoom(socket, room);\n });\n });\n\n socket.on('__STSsendToRoom', (rooms: string[], payload: { command: string, payload: JSONObject }): void => {\n rooms.forEach((room) => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}], Command: [${payload.command}]`);\n this.socketionamespace.to(room).emit(payload.command as any, payload);\n }\n });\n });\n\n socket.on('__STSsendToRoomWithCallback', (room: string, timeout: number, payload: { command: string, payload: JSONObject }, cb: (data: JSONObject) => void): void => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);\n this.socketionamespace.to(room).timeout(timeout).emit(payload.command as any, payload, (err: Error, dataResponse: JSONObject[]) => {\n if (err) {\n console.error(err);\n const errorResponse = {\n error: true, \n errorName: err.name, \n errorMessage: err.message,\n //errorCause: err.cause,\n //errorStack: err.stack\n };\n this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`)\n cb(errorResponse);\n } else {\n this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`)\n cb(dataResponse);\n }\n });\n }\n });\n\n socket.on('__STSsendToRoomsWithCallback', (rooms: string[], timeout: number, payload: { command: string, payload: JSONObject }, cb: (data: JSONObject) => void): void => {\n const responses: any[] = [ ];\n\n const timeoutForComplete = setTimeout(() => {\n // for this timeout case, sent back the error response and the responses we have received so far ...\n responses.push({\n room: '',\n responses: {\n error: true,\n errorName: 'timeout',\n errorMessage: `__STSsendToRoomsWithCallback timeout: [${timeout}] before all responses received`\n }\n });\n cb(responses);\n }, timeout).unref();\n\n rooms.forEach((room) => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);\n this.socketionamespace.to(room).timeout(timeout).emit(payload.command as any, payload, (err: Error, dataResponse: JSONObject[]) => {\n if (err) {\n console.error(err);\n const errorResponse = {\n error: true, \n errorName: err.name, \n errorMessage: err.message,\n //errorCause: err.cause,\n //errorStack: err.stack\n };\n this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`)\n responses.push({\n room,\n responses: errorResponse\n });\n } else {\n this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`)\n responses.push({\n room,\n responses: dataResponse\n });\n }\n if (responses.length === rooms.length) {\n clearTimeout(timeoutForComplete);\n this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: All complete, Responses Count: [${responses.length}] Invoke call back(responses)`);\n cb(responses);\n }\n });\n }\n });\n });\n }\n\n protected ConnectionDrainingConnectionMiddleware = (): void => {\n if (this.socketionamespace) {\n this.socketionamespace.use((socket, next) => {\n if (this.draining === true) {\n next(new Error(`ConnectionDrainingConnectionMiddleware(): Error: [server connections draining (from a server disconnect)]`));\n } else {\n next();\n }\n });\n }\n }\n \n protected SetupNamespace = (): SocketIoServer<ClientToServerEvents, ServerToClientEvents> => {\n // Create STS Command Centre Client namespace\n if (this.io) {\n this.LogDebugMessage(`SetupNamespace(): socketionamespace = io.of('/${this.namespace}/'`);\n this.socketionamespace = this.io.of(`/${this.namespace}/`);\n\n this.LogDebugMessage(`SetupNamespace(): ConnectionDrainingConnectionMiddleware()`);\n this.ConnectionDrainingConnectionMiddleware();\n\n this.LogDebugMessage(`SetupNamespace(): SetupConnectionMiddleware()`);\n this.SetupConnectionMiddleware();\n\n this.socketionamespace.on(\"connection\", socket => {\n this.LogDebugMessage(`SetupNamespace(): Socket connected, ID: [${socket.id}]`);\n this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (auth): [${JSON.stringify(socket.handshake.auth)}]`);\n this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (host): [${JSON.stringify(socket.handshake.headers.host)}]`);\n this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (url): [${JSON.stringify(socket.handshake.url)}]`);\n this.LogDebugMessage(`SetupNamespace(): Authentication Handshake: [${JSON.stringify(socket.handshake)}]`);\n\n this.LogDebugMessage(`SetupNamespace(): SetupMessageMiddleware(): Socket: [${socket.id}]`);\n this.SetupMessageMiddleware(socket);\n\n if (this.rooms && this.rooms.length > 0) {\n this.rooms.map((room) => {\n this.LogDebugMessage(`SetupNamespace(): Joining Room: [${room}], Socket: [${socket.id}]`);\n this.JoinRoom(socket, room);\n });\n }\n\n this.LogDebugMessage(`SetupNamespace(): SetupStandardEvents: Socket: [${socket.id}]`);\n this.SetupStandardEvents(socket);\n\n setTimeout(() => {\n this.LogDebugMessage(`SetupNamespace(): SocketConnectCallBack(): Socket: [${socket.id}]`);\n this.SocketConnectCallBack(socket);\n }, 0);\n\n this.LogDebugMessage(`SetupNamespace(): SocketEventsCallBack(): Socket: [${socket.id}]`);\n this.SocketEventsCallBack(socket);\n });\n } else {\n const errorMessage = `SetupNamespace(): Error: [No server attached]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n\n return this;\n }\n\n protected CloseNamespaceAdaptors = async (): Promise<void> => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`CloseNamespaceAdaptors(): this.socketionamespace.adapter.close()`);\n await this.socketionamespace.adapter.close();\n }\n }\n\n protected DisconnectNamespaceSockets = (): void => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`DisconnectNamespaceSockets(): this.socketionamespace.disconnectSockets()`);\n this.socketionamespace.disconnectSockets();\n this.socketionamespace = undefined;\n }\n }\n}\n"],"names":["TinyEmitter","Redis","createAdapter","clusterCreateAdapter","Server","Sleep"],"mappings":"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"}
1
+ {"version":3,"file":"node.cjs","sources":["../src/socketIoServer.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */ // --> OFF\nimport { ISTSLogger, JSONObject, Sleep } from '@nsshunt/stsutils'\n\nimport { Server, Namespace, Socket, ServerOptions } from \"socket.io\";\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, STSServerSocket, \n InterServerEvents } from './commonTypes'\n\n//import { createClient, RedisClientType } from 'redis';\nimport { Redis } from 'ioredis';\n\nimport { createAdapter as clusterCreateAdapter } from '@socket.io/cluster-adapter'\nimport { createAdapter } from \"@socket.io/redis-streams-adapter\";\n\nimport { TinyEmitter } from 'tiny-emitter';\n\nexport interface ISocketIoServerOpitons {\n listenPort?: number\n ioRedisMessageProcessorUrl?: string\n wssCustomPath?: string\n serverClusterMode?: boolean\n}\n \nexport abstract class SocketIoServer<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> extends TinyEmitter {\n protected namespace?: string\n protected socketionamespace?: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n //protected socketionamespace?: Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>\n protected logger?: ISTSLogger\n protected io?: Server<ClientToServerEvents, ServerToClientEvents>;\n //#redisClient: RedisClientType | Redis | null = null;\n protected redisClient?: Redis;\n protected listenPort?: number;\n protected socketIoCustomPath?: string;\n protected ioRedisMessageProcessorUrl?: string;\n protected serverClusterMode?: boolean;\n protected rooms?: string[];\n protected serverName: string\n protected draining: boolean = false;\n protected attached: boolean = false;\n\n constructor(serverName: string) { // IProcessBase\n super();\n this.serverName = serverName;\n }\n\n protected abstract SocketDisconnect(socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void;\n\n protected abstract SocketDisconnecting(socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void;\n\n protected abstract SocketError(socket: Socket<ClientToServerEvents, ServerToClientEvents>, error: Error): void;\n\n protected abstract SocketConnect(socket: Socket<ClientToServerEvents, ServerToClientEvents>): void;\n\n protected abstract SetupSocketEvents(socket: Socket<ClientToServerEvents, ServerToClientEvents>): void;\n\n protected get logPrefix(): string {\n if (this.namespace) {\n return `SocketIoServer[${this.serverName}:${this.namespace}]: `;\n } else {\n return `SocketIoServer[${this.serverName}:<No Namespace>]: `;\n }\n }\n\n protected LogErrorMessage(message: any) {\n if (this.logger) {\n this.logger.error(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogDebugMessage(message: any) {\n if (this.logger) {\n this.logger.debug(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogInfoMessage(message: any) {\n if (this.logger) {\n this.logger.info(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogWarnMessage(message: any) {\n if (this.logger) {\n this.logger.warn(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogSillyMessage(message: any) {\n if (this.logger) {\n this.logger.silly(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogVerboseMessage(message: any) {\n if (this.logger) {\n this.logger.verbose(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogHttpMessage(message: any) {\n if (this.logger) {\n this.logger.http(`${this.logPrefix}${message}`);\n }\n }\n\n // https://socket.io/docs/v4/middlewares/\n // https://socket.io/docs/v4/server-socket-instance/#sockethandshake\n // https://socket.io/docs/v4/server-socket-instance/#socket-middlewares\n // Use this middleward to check every incomming connection\n protected SetupConnectionMiddleware = () => { };\n\n // Use this middleware to check every packet being received\n protected SetupMessageMiddleware = (socket: STSServerSocket) => { };\n\n /*\n protected GetConfig = (socketIoServeroptions: ISocketIoServerOpitons): Partial<ServerOptions> => {\n //this.#redisClient = createClient({url: this.#options.ioRedisMessageProcessorUrl});\n //await this.#redisClient.connect();\n this.LogDebugMessage(`GetConfig() transports: [ [websocket] ]`);\n const options: Partial<ServerOptions> = {\n transports: [ \"websocket\" ], // or [ \"websocket\", \"polling\" ] (to use long-poolling. Note that the order matters)\n }\n\n if (socketIoServeroptions.ioRedisMessageProcessorUrl && socketIoServeroptions.ioRedisMessageProcessorUrl !== '') {\n this.redisClient = new Redis(socketIoServeroptions.ioRedisMessageProcessorUrl);\n this.LogDebugMessage(`GetConfig() createAdapter(redis): redis url: [${socketIoServeroptions.ioRedisMessageProcessorUrl}]`);\n options.adapter = createAdapter(this.redisClient) as any;\n } else if (socketIoServeroptions.serverClusterMode && socketIoServeroptions.serverClusterMode === true) {\n this.LogDebugMessage(`GetConfig() createAdapter(cluster)`);\n options.adapter = clusterCreateAdapter() as any;\n }\n\n if (socketIoServeroptions.wssCustomPath && socketIoServeroptions.wssCustomPath.localeCompare('') !== 0) {\n this.LogDebugMessage(`GetConfig() wssCustomPath: [${socketIoServeroptions.wssCustomPath}]`);\n options.path = socketIoServeroptions.wssCustomPath;\n }\n\n return options;\n }\n */\n\n protected SetEngineEvents = () => {\n if (this.io) {\n this.io.engine.on(\"connection_error\", (err) => {\n this.LogWarnMessage(`SetEngineEvents(): connection_error`); // the request object\n this.LogWarnMessage(err.req); // the request object\n this.LogWarnMessage(err.code); // the error code, for example 1\n this.LogWarnMessage(err.message); // the error message, for example \"Session ID unknown\"\n this.LogWarnMessage(err.context); // some additional error context\n });\n }\n }\n\n WithLogger = (logger: ISTSLogger) => {\n this.logger = logger;\n return this;\n }\n\n WithListenPort = (listenPort: number) => {\n this.listenPort = listenPort;\n return this;\n }\n\n WithSocketIoCustomPath = (socketIoCustomPath: string) => {\n this.socketIoCustomPath = socketIoCustomPath;\n return this;\n }\n\n WithIoRedisMessageProcessorUrl = (ioRedisMessageProcessorUrl: string) => {\n this.ioRedisMessageProcessorUrl = ioRedisMessageProcessorUrl;\n return this;\n }\n\n WithClusterMode = (serverClusterMode: boolean) => {\n this.serverClusterMode = serverClusterMode;\n return this;\n }\n\n WithRooms = (rooms: string[]) => {\n this.rooms = rooms;\n return this;\n }\n\n WithNamespace = (namespace: string) => {\n this.namespace = namespace;\n return this;\n }\n\n AttachSocketIoServer = async (server: Server): Promise<SocketIoServer<ClientToServerEvents, ServerToClientEvents>> => {\n if (!this.io) {\n this.LogInfoMessage(`AttachServer(): io = server`);\n this.io = server;\n\n this.LogInfoMessage(`AttachServer(): attached = true`);\n this.attached = true;\n\n this.LogInfoMessage(`AttachServer(): SetupNamespace()`);\n this.SetupNamespace();\n } else {\n const errorMessage = (this.attached === true ? `AttachServer(): Server already exists (from AttachServer())` : `AttachServer(): Server already exists (from StartServer())`);\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n return this;\n }\n\n StartSocketIoServer = async (): Promise<SocketIoServer<ClientToServerEvents, ServerToClientEvents>> => {\n //this.#io = require(\"socket.io\")(this.#httpServer, options);\n if (!this.namespace) {\n const errorMessage = `StartServer(): Error: [namespace not specified]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n\n if (!this.io) {\n if (!this.listenPort) {\n const errorMessage = `StartServer(): Error: [listenPort not specified]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n\n this.LogDebugMessage(`StartServer(): draining = false`);\n this.draining = false;\n\n this.LogDebugMessage(`StartServer(): transports: [ [websocket] ]`);\n const options: Partial<ServerOptions> = {\n transports: [ \"websocket\" ], // or [ \"websocket\", \"polling\" ] (to use long-poolling. Note that the order matters)\n }\n\n if (this.ioRedisMessageProcessorUrl && this.ioRedisMessageProcessorUrl !== '') {\n this.redisClient = new Redis(this.ioRedisMessageProcessorUrl);\n this.LogDebugMessage(`StartServer(): createAdapter(redis): redis url: [${this.ioRedisMessageProcessorUrl}]`);\n options.adapter = createAdapter(this.redisClient) as any;\n } else if (this.serverClusterMode && this.serverClusterMode === true) {\n this.LogDebugMessage(`StartServer(): createAdapter(cluster)`);\n options.adapter = clusterCreateAdapter() as any;\n }\n\n if (this.socketIoCustomPath && this.socketIoCustomPath.localeCompare('') !== 0) {\n this.LogDebugMessage(`StartServer(): socketIoCustomPath: [${this.socketIoCustomPath}]`);\n options.path = this.socketIoCustomPath;\n }\n\n this.LogDebugMessage(`StartServer(): new Server(): listenPort: [${this.listenPort}]`);\n this.io = new Server(this.listenPort, options);\n\n this.LogDebugMessage(`StartServer(): SetEngineEvents()`);\n this.SetEngineEvents();\n\n this.LogDebugMessage(`StartServer(): Sleeping ...`);\n await Sleep(500);\n this.LogDebugMessage(`StartServer(): Done Sleeping`);\n\n this.LogInfoMessage(`AttachServer(): attached = false`);\n this.attached = false;\n\n this.LogInfoMessage(`StartServer(): SetupNamespace()`);\n this.SetupNamespace();\n\n } else {\n const errorMessage = (this.attached === true ? `StartServer(): Server already exists (from AttachServer())` : `StartServer(): Server already exists (from StartServer())`);\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n return this;\n }\n\n DetachSockerIoServer = async (): Promise<void> => {\n if (this.io) {\n if (this.attached === true) {\n this.LogInfoMessage(`DetachServer(): StopNamespace()`);\n await this.StopNamespace();\n this.io = undefined;\n this.LogInfoMessage(`DetachServer(): attached = false`);\n this.attached = false;\n } else {\n const errorMessage = `DetachServer(): Error: [Server has not been attached. Use StopServer() to stop the socker.io server.]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n } else {\n const errorMessage = `DetachServer(): Error: [no server exists to DetachServer()]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n }\n\n StopSocketIoServer = async () => {\n if (this.io) {\n if (this.attached === false) {\n // We are now draining connections\n this.LogInfoMessage(`StopServer(): draining = true`);\n this.draining = true;\n\n this.LogInfoMessage(`StopServer(): StopNamespace()`);\n await this.StopNamespace();\n\n this.LogInfoMessage(`StopServer(): io.of('/').adapter.close()`);\n await this.io.of('/').adapter.close();\n\n if (this.redisClient) {\n this.LogInfoMessage(`StopServer(): redisClient.disconnect()`);\n await this.redisClient.disconnect();\n this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Sleeping...)`);\n await Sleep(50);\n this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Done Sleeping)`);\n }\n\n // boot all current connections\n this.LogInfoMessage(`StopServer(): io.disconnectSockets()`);\n this.io.disconnectSockets();\n\n // Stop any future connections, close this server (does not close the underlying http(s) server if io server via that method\n this.LogInfoMessage(`StopServer(): io.close()`);\n this.io.close();\n\n this.LogInfoMessage(`StopServer(): io = undefined`);\n this.io = undefined;\n } else {\n const errorMessage = `StopServer(): Cannot stop an attached server. The server created must handle stop/disconnections. Use StopNamespace() instead.`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n } else {\n const errorMessage = `StopServer(): Error: [no server exists to StopServer()]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n }\n\n LeaveRoom = (socket: STSServerSocket, room: string): void => {\n this.LogDebugMessage(`LeaveRoom(): Leaving room [${room}]`);\n socket.leave(room);\n };\n\n JoinRoom = (socket: STSServerSocket, room: string): void => {\n this.LogDebugMessage(`JoinRoom(): Socket joining room [${room}], ID: [${socket.id}]`);\n socket.join(room);\n };\n\n protected StopNamespace = async() => {\n this.LogInfoMessage(`StopServer(): CloseNamespaceAdaptors()`);\n await this.CloseNamespaceAdaptors();\n\n this.LogInfoMessage(`StopServer(): DisconnectNamespaceSockets()`);\n this.DisconnectNamespaceSockets();\n }\n\n protected SetupStandardEvents = (socket: STSServerSocket): void => {\n socket.on('disconnect', (reason: string) => {\n this.LogDebugMessage(`SetupStandardEvents(): socket disconnect, ID: [${socket.id}], reason: [${reason}]`);\n this.SocketDisconnect(socket, reason);\n });\n\n socket.on('disconnecting', (reason: string) => {\n this.LogDebugMessage(`SetupStandardEvents(): socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);\n this.SocketDisconnecting(socket, reason);\n });\n\n socket.on('error', (error: Error) => {\n this.LogDebugMessage(`SetupStandardEvents(): socket error, ID: [${socket.id}], Error: [${error}]`);\n this.SocketError(socket, error);\n });\n\n socket.on(\"__STSdisconnect\", (reason: string) => {\n this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnect: socket disconnect, ID: [${socket.id}], reason: [${reason}]`);\n });\n\n socket.on(\"__STSdisconnecting\", (reason, callBackResult) => {\n this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnecting: socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);\n callBackResult(\"__STSdisconnecting accepted by server.\");\n });\n\n socket.on('__STSjoinRoom', (rooms: string[]): void => { //@@ names\n rooms.forEach((room) => {\n this.LogDebugMessage(`SetupStandardEvents(): __STSjoinRoom: room: [${room}], socket: [${socket.id}]`);\n this.JoinRoom(socket, room)\n });\n });\n\n socket.on('__STSleaveRoom', (rooms: string[]): void => { //@@ names\n rooms.forEach((room) => {\n this.LogDebugMessage(`SetupStandardEvents(): __STSleaveRoom: room: [${room}], socket: [${socket.id}]`);\n this.LeaveRoom(socket, room);\n });\n });\n\n socket.on('__STSsendToRoom', (rooms: string[], payload: { command: string, payload: JSONObject }): void => {\n rooms.forEach((room) => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}], Command: [${payload.command}]`);\n this.socketionamespace.to(room).emit(payload.command as any, payload);\n }\n });\n });\n\n socket.on('__STSsendToRoomWithCallback', (room: string, timeout: number, payload: { command: string, payload: JSONObject }, cb: (data: JSONObject) => void): void => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);\n this.socketionamespace.to(room).timeout(timeout).emit(payload.command as any, payload, (err: Error, dataResponse: JSONObject[]) => {\n if (err) {\n console.error(err);\n const errorResponse = {\n error: true, \n errorName: err.name, \n errorMessage: err.message,\n //errorCause: err.cause,\n //errorStack: err.stack\n };\n this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`)\n cb(errorResponse);\n } else {\n this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`)\n cb(dataResponse);\n }\n });\n }\n });\n\n socket.on('__STSsendToRoomsWithCallback', (rooms: string[], timeout: number, payload: { command: string, payload: JSONObject }, cb: (data: JSONObject) => void): void => {\n const responses: any[] = [ ];\n\n const timeoutForComplete = setTimeout(() => {\n // for this timeout case, sent back the error response and the responses we have received so far ...\n responses.push({\n room: '',\n responses: {\n error: true,\n errorName: 'timeout',\n errorMessage: `__STSsendToRoomsWithCallback timeout: [${timeout}] before all responses received`\n }\n });\n cb(responses);\n }, timeout).unref();\n\n rooms.forEach((room) => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);\n this.socketionamespace.to(room).timeout(timeout).emit(payload.command as any, payload, (err: Error, dataResponse: JSONObject[]) => {\n if (err) {\n console.error(err);\n const errorResponse = {\n error: true, \n errorName: err.name, \n errorMessage: err.message,\n //errorCause: err.cause,\n //errorStack: err.stack\n };\n this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`)\n responses.push({\n room,\n responses: errorResponse\n });\n } else {\n this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`)\n responses.push({\n room,\n responses: dataResponse\n });\n }\n if (responses.length === rooms.length) {\n clearTimeout(timeoutForComplete);\n this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: All complete, Responses Count: [${responses.length}] Invoke call back(responses)`);\n cb(responses);\n }\n });\n }\n });\n });\n }\n\n protected ConnectionDrainingConnectionMiddleware = (): void => {\n if (this.socketionamespace) {\n this.socketionamespace.use((socket, next) => {\n if (this.draining === true) {\n next(new Error(`ConnectionDrainingConnectionMiddleware(): Error: [server connections draining (from a server disconnect)]`));\n } else {\n next();\n }\n });\n }\n }\n \n protected SetupNamespace = (): SocketIoServer<ClientToServerEvents, ServerToClientEvents> => {\n // Create STS Command Centre Client namespace\n if (this.io) {\n this.LogDebugMessage(`SetupNamespace(): socketionamespace = io.of('/${this.namespace}/'`);\n this.socketionamespace = this.io.of(`/${this.namespace}/`);\n\n this.LogDebugMessage(`SetupNamespace(): ConnectionDrainingConnectionMiddleware()`);\n this.ConnectionDrainingConnectionMiddleware();\n\n this.LogDebugMessage(`SetupNamespace(): SetupConnectionMiddleware()`);\n this.SetupConnectionMiddleware();\n\n this.socketionamespace.on(\"connection\", socket => {\n this.LogDebugMessage(`SetupNamespace(): Socket connected, ID: [${socket.id}]`);\n this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (auth): [${JSON.stringify(socket.handshake.auth)}]`);\n this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (host): [${JSON.stringify(socket.handshake.headers.host)}]`);\n this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (url): [${JSON.stringify(socket.handshake.url)}]`);\n this.LogDebugMessage(`SetupNamespace(): Authentication Handshake: [${JSON.stringify(socket.handshake)}]`);\n\n this.LogDebugMessage(`SetupNamespace(): SetupMessageMiddleware(): Socket: [${socket.id}]`);\n this.SetupMessageMiddleware(socket);\n\n if (this.rooms && this.rooms.length > 0) {\n this.rooms.map((room) => {\n this.LogDebugMessage(`SetupNamespace(): Joining Room: [${room}], Socket: [${socket.id}]`);\n this.JoinRoom(socket, room);\n });\n }\n\n this.LogDebugMessage(`SetupNamespace(): SetupStandardEvents: Socket: [${socket.id}]`);\n this.SetupStandardEvents(socket);\n\n setTimeout(() => {\n this.LogDebugMessage(`SetupNamespace(): SocketConnectCallBack(): Socket: [${socket.id}]`);\n this.SocketConnect(socket);\n }, 0);\n\n this.LogDebugMessage(`SetupNamespace(): SocketEventsCallBack(): Socket: [${socket.id}]`);\n this.SetupSocketEvents(socket);\n });\n } else {\n const errorMessage = `SetupNamespace(): Error: [No server attached]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n\n return this;\n }\n\n protected CloseNamespaceAdaptors = async (): Promise<void> => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`CloseNamespaceAdaptors(): this.socketionamespace.adapter.close()`);\n await this.socketionamespace.adapter.close();\n }\n }\n\n protected DisconnectNamespaceSockets = (): void => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`DisconnectNamespaceSockets(): this.socketionamespace.disconnectSockets()`);\n this.socketionamespace.disconnectSockets();\n this.socketionamespace = undefined;\n }\n }\n}\n"],"names":["TinyEmitter","Redis","createAdapter","clusterCreateAdapter","Server","Sleep"],"mappings":";;;;;;;;AAuBO,MAAe,uBAAiJA,MAAAA,mBAAAA,YAAY;AAAA,EACrK;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAoB;AAAA,EACpB,WAAoB;AAAA,EAE9B,YAAY,YAAoB;AAC5B,UAAA;AACA,SAAK,aAAa;AAAA,EACtB;AAAA,EAYA,IAAc,YAAoB;AAC9B,QAAI,KAAK,WAAW;AAChB,aAAO,kBAAkB,KAAK,UAAU,IAAI,KAAK,SAAS;AAAA,IAC9D,OAAO;AACH,aAAO,kBAAkB,KAAK,UAAU;AAAA,IAC5C;AAAA,EACJ;AAAA,EAEU,gBAAgB,SAAc;AACpC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,MAAM,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IACnD;AAAA,EACJ;AAAA,EAEU,gBAAgB,SAAc;AACpC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,MAAM,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IACnD;AAAA,EACJ;AAAA,EAEU,eAAe,SAAc;AACnC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,KAAK,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IAClD;AAAA,EACJ;AAAA,EAEU,eAAe,SAAc;AACnC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,KAAK,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IAClD;AAAA,EACJ;AAAA,EAEU,gBAAgB,SAAc;AACpC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,MAAM,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IACnD;AAAA,EACJ;AAAA,EAEU,kBAAkB,SAAc;AACtC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,QAAQ,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IACrD;AAAA,EACJ;AAAA,EAEU,eAAe,SAAc;AACnC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,KAAK,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IAClD;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA,EAMU,4BAA4B,MAAM;AAAA,EAAE;AAAA;AAAA,EAGpC,yBAAyB,CAAC,WAA4B;AAAA,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BxD,kBAAkB,MAAM;AAC9B,QAAI,KAAK,IAAI;AACT,WAAK,GAAG,OAAO,GAAG,oBAAoB,CAAC,QAAQ;AAC3C,aAAK,eAAe,qCAAqC;AACzD,aAAK,eAAe,IAAI,GAAG;AAC3B,aAAK,eAAe,IAAI,IAAI;AAC5B,aAAK,eAAe,IAAI,OAAO;AAC/B,aAAK,eAAe,IAAI,OAAO;AAAA,MACnC,CAAC;AAAA,IACL;AAAA,EACJ;AAAA,EAEA,aAAa,CAAC,WAAuB;AACjC,SAAK,SAAS;AACd,WAAO;AAAA,EACX;AAAA,EAEA,iBAAiB,CAAC,eAAuB;AACrC,SAAK,aAAa;AAClB,WAAO;AAAA,EACX;AAAA,EAEA,yBAAyB,CAAC,uBAA+B;AACrD,SAAK,qBAAqB;AAC1B,WAAO;AAAA,EACX;AAAA,EAEA,iCAAiC,CAAC,+BAAuC;AACrE,SAAK,6BAA6B;AAClC,WAAO;AAAA,EACX;AAAA,EAEA,kBAAkB,CAAC,sBAA+B;AAC9C,SAAK,oBAAoB;AACzB,WAAO;AAAA,EACX;AAAA,EAEA,YAAY,CAAC,UAAoB;AAC7B,SAAK,QAAQ;AACb,WAAO;AAAA,EACX;AAAA,EAEA,gBAAgB,CAAC,cAAsB;AACnC,SAAK,YAAY;AACjB,WAAO;AAAA,EACX;AAAA,EAEA,uBAAuB,OAAO,WAAwF;AAClH,QAAI,CAAC,KAAK,IAAI;AACV,WAAK,eAAe,6BAA6B;AACjD,WAAK,KAAK;AAEV,WAAK,eAAe,iCAAiC;AACrD,WAAK,WAAW;AAEhB,WAAK,eAAe,kCAAkC;AACtD,WAAK,eAAA;AAAA,IACT,OAAO;AACH,YAAM,eAAgB,KAAK,aAAa,OAAO,gEAAgE;AAC/G,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AACA,WAAO;AAAA,EACX;AAAA,EAEA,sBAAsB,YAAiF;AAEnG,QAAI,CAAC,KAAK,WAAW;AACjB,YAAM,eAAe;AACrB,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AAEA,QAAI,CAAC,KAAK,IAAI;AACV,UAAI,CAAC,KAAK,YAAY;AAClB,cAAM,eAAe;AACrB,aAAK,gBAAgB,YAAY;AACjC,cAAM,IAAI,MAAM,YAAY;AAAA,MAChC;AAEA,WAAK,gBAAgB,iCAAiC;AACtD,WAAK,WAAW;AAEhB,WAAK,gBAAgB,4CAA4C;AACjE,YAAM,UAAkC;AAAA,QACpC,YAAY,CAAE,WAAY;AAAA;AAAA,MAAA;AAG9B,UAAI,KAAK,8BAA8B,KAAK,+BAA+B,IAAI;AAC3E,aAAK,cAAc,IAAIC,cAAM,KAAK,0BAA0B;AAC5D,aAAK,gBAAgB,oDAAoD,KAAK,0BAA0B,GAAG;AAC3G,gBAAQ,UAAUC,kCAAc,KAAK,WAAW;AAAA,MACpD,WAAW,KAAK,qBAAqB,KAAK,sBAAsB,MAAM;AAClE,aAAK,gBAAgB,uCAAuC;AAC5D,gBAAQ,UAAUC,6BAAA;AAAA,MACtB;AAEA,UAAI,KAAK,sBAAsB,KAAK,mBAAmB,cAAc,EAAE,MAAM,GAAG;AAC5E,aAAK,gBAAgB,uCAAuC,KAAK,kBAAkB,GAAG;AACtF,gBAAQ,OAAO,KAAK;AAAA,MACxB;AAEA,WAAK,gBAAgB,6CAA6C,KAAK,UAAU,GAAG;AACpF,WAAK,KAAK,IAAIC,UAAAA,OAAO,KAAK,YAAY,OAAO;AAE7C,WAAK,gBAAgB,kCAAkC;AACvD,WAAK,gBAAA;AAEL,WAAK,gBAAgB,6BAA6B;AAClD,YAAMC,SAAAA,MAAM,GAAG;AACf,WAAK,gBAAgB,8BAA8B;AAEnD,WAAK,eAAe,kCAAkC;AACtD,WAAK,WAAW;AAEhB,WAAK,eAAe,iCAAiC;AACrD,WAAK,eAAA;AAAA,IAET,OAAO;AACH,YAAM,eAAgB,KAAK,aAAa,OAAO,+DAA+D;AAC9G,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AACA,WAAO;AAAA,EACX;AAAA,EAEA,uBAAuB,YAA2B;AAC9C,QAAI,KAAK,IAAI;AACT,UAAI,KAAK,aAAa,MAAM;AACxB,aAAK,eAAe,iCAAiC;AACrD,cAAM,KAAK,cAAA;AACX,aAAK,KAAK;AACV,aAAK,eAAe,kCAAkC;AACtD,aAAK,WAAW;AAAA,MACpB,OAAO;AACH,cAAM,eAAe;AACrB,aAAK,gBAAgB,YAAY;AACjC,cAAM,IAAI,MAAM,YAAY;AAAA,MAChC;AAAA,IACJ,OAAO;AACH,YAAM,eAAe;AACrB,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AAAA,EACJ;AAAA,EAEA,qBAAqB,YAAY;AAC7B,QAAI,KAAK,IAAI;AACT,UAAI,KAAK,aAAa,OAAO;AAEzB,aAAK,eAAe,+BAA+B;AACnD,aAAK,WAAW;AAEhB,aAAK,eAAe,+BAA+B;AACnD,cAAM,KAAK,cAAA;AAEX,aAAK,eAAe,0CAA0C;AAC9D,cAAM,KAAK,GAAG,GAAG,GAAG,EAAE,QAAQ,MAAA;AAE9B,YAAI,KAAK,aAAa;AAClB,eAAK,eAAe,wCAAwC;AAC5D,gBAAM,KAAK,YAAY,WAAA;AACvB,eAAK,eAAe,sDAAsD;AAC1E,gBAAMA,SAAAA,MAAM,EAAE;AACd,eAAK,eAAe,wDAAwD;AAAA,QAChF;AAGA,aAAK,eAAe,sCAAsC;AAC1D,aAAK,GAAG,kBAAA;AAGR,aAAK,eAAe,0BAA0B;AAC9C,aAAK,GAAG,MAAA;AAER,aAAK,eAAe,8BAA8B;AAClD,aAAK,KAAK;AAAA,MACd,OAAO;AACH,cAAM,eAAe;AACrB,aAAK,gBAAgB,YAAY;AACjC,cAAM,IAAI,MAAM,YAAY;AAAA,MAChC;AAAA,IACJ,OAAO;AACH,YAAM,eAAe;AACrB,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AAAA,EACJ;AAAA,EAEA,YAAY,CAAC,QAAyB,SAAuB;AACzD,SAAK,gBAAgB,8BAA8B,IAAI,GAAG;AAC1D,WAAO,MAAM,IAAI;AAAA,EACrB;AAAA,EAEA,WAAW,CAAC,QAAyB,SAAuB;AACxD,SAAK,gBAAgB,oCAAoC,IAAI,WAAW,OAAO,EAAE,GAAG;AACpF,WAAO,KAAK,IAAI;AAAA,EACpB;AAAA,EAEU,gBAAgB,YAAW;AACjC,SAAK,eAAe,wCAAwC;AAC5D,UAAM,KAAK,uBAAA;AAEX,SAAK,eAAe,4CAA4C;AAChE,SAAK,2BAAA;AAAA,EACT;AAAA,EAEU,sBAAsB,CAAC,WAAkC;AAC/D,WAAO,GAAG,cAAc,CAAC,WAAmB;AACxC,WAAK,gBAAgB,kDAAkD,OAAO,EAAE,eAAe,MAAM,GAAG;AACxG,WAAK,iBAAiB,QAAQ,MAAM;AAAA,IACxC,CAAC;AAED,WAAO,GAAG,iBAAiB,CAAC,WAAmB;AAC3C,WAAK,gBAAgB,qDAAqD,OAAO,EAAE,eAAe,MAAM,GAAG;AAC3G,WAAK,oBAAoB,QAAQ,MAAM;AAAA,IAC3C,CAAC;AAED,WAAO,GAAG,SAAS,CAAC,UAAiB;AACjC,WAAK,gBAAgB,6CAA6C,OAAO,EAAE,cAAc,KAAK,GAAG;AACjG,WAAK,YAAY,QAAQ,KAAK;AAAA,IAClC,CAAC;AAED,WAAO,GAAG,mBAAmB,CAAC,WAAmB;AAC7C,WAAK,gBAAgB,mEAAmE,OAAO,EAAE,eAAe,MAAM,GAAG;AAAA,IAC7H,CAAC;AAED,WAAO,GAAG,sBAAsB,CAAC,QAAQ,mBAAmB;AACxD,WAAK,gBAAgB,yEAAyE,OAAO,EAAE,eAAe,MAAM,GAAG;AAC/H,qBAAe,wCAAwC;AAAA,IAC3D,CAAC;AAED,WAAO,GAAG,iBAAiB,CAAC,UAA0B;AAClD,YAAM,QAAQ,CAAC,SAAS;AACpB,aAAK,gBAAgB,gDAAgD,IAAI,eAAe,OAAO,EAAE,GAAG;AACpG,aAAK,SAAS,QAAQ,IAAI;AAAA,MAC9B,CAAC;AAAA,IACL,CAAC;AAED,WAAO,GAAG,kBAAkB,CAAC,UAA0B;AACnD,YAAM,QAAQ,CAAC,SAAS;AACpB,aAAK,gBAAgB,iDAAiD,IAAI,eAAe,OAAO,EAAE,GAAG;AACrG,aAAK,UAAU,QAAQ,IAAI;AAAA,MAC/B,CAAC;AAAA,IACL,CAAC;AAED,WAAO,GAAG,mBAAmB,CAAC,OAAiB,YAA4D;AACvG,YAAM,QAAQ,CAAC,SAAS;AACpB,YAAI,KAAK,mBAAmB;AACxB,eAAK,gBAAgB,uEAAuE,IAAI,WAAW,OAAO,EAAE,gBAAgB,QAAQ,OAAO,GAAG;AACtJ,eAAK,kBAAkB,GAAG,IAAI,EAAE,KAAK,QAAQ,SAAgB,OAAO;AAAA,QACxE;AAAA,MACJ,CAAC;AAAA,IACL,CAAC;AAED,WAAO,GAAG,+BAA+B,CAAC,MAAc,SAAiB,SAAmD,OAAyC;AACjK,UAAI,KAAK,mBAAmB;AACxB,aAAK,gBAAgB,mFAAmF,IAAI,WAAW,OAAO,EAAE,gBAAgB,OAAO,gBAAgB,QAAQ,OAAO,GAAG;AACzL,aAAK,kBAAkB,GAAG,IAAI,EAAE,QAAQ,OAAO,EAAE,KAAK,QAAQ,SAAgB,SAAS,CAAC,KAAY,iBAA+B;AAC/H,cAAI,KAAK;AACL,oBAAQ,MAAM,GAAG;AACjB,kBAAM,gBAAgB;AAAA,cAClB,OAAO;AAAA,cACP,WAAW,IAAI;AAAA,cACf,cAAc,IAAI;AAAA;AAAA;AAAA,YAAA;AAItB,iBAAK,gBAAgB,0EAA0E,KAAK,UAAU,aAAa,CAAC,GAAG;AAC/H,eAAG,aAAa;AAAA,UACpB,OAAO;AACH,iBAAK,gBAAgB,kEAAkE,KAAK,UAAU,YAAY,CAAC,GAAG;AACtH,eAAG,YAAY;AAAA,UACnB;AAAA,QACJ,CAAC;AAAA,MACL;AAAA,IACJ,CAAC;AAED,WAAO,GAAG,gCAAgC,CAAC,OAAiB,SAAiB,SAAmD,OAAyC;AACrK,YAAM,YAAmB,CAAA;AAEzB,YAAM,qBAAqB,WAAW,MAAM;AAExC,kBAAU,KAAK;AAAA,UACX,MAAM;AAAA,UACN,WAAW;AAAA,YACP,OAAO;AAAA,YACP,WAAW;AAAA,YACX,cAAc,0CAA0C,OAAO;AAAA,UAAA;AAAA,QACnE,CACH;AACD,WAAG,SAAS;AAAA,MAChB,GAAG,OAAO,EAAE,MAAA;AAEZ,YAAM,QAAQ,CAAC,SAAS;AACpB,YAAI,KAAK,mBAAmB;AACxB,eAAK,gBAAgB,oFAAoF,IAAI,WAAW,OAAO,EAAE,gBAAgB,OAAO,gBAAgB,QAAQ,OAAO,GAAG;AAC1L,eAAK,kBAAkB,GAAG,IAAI,EAAE,QAAQ,OAAO,EAAE,KAAK,QAAQ,SAAgB,SAAS,CAAC,KAAY,iBAA+B;AAC/H,gBAAI,KAAK;AACL,sBAAQ,MAAM,GAAG;AACjB,oBAAM,gBAAgB;AAAA,gBAClB,OAAO;AAAA,gBACP,WAAW,IAAI;AAAA,gBACf,cAAc,IAAI;AAAA;AAAA;AAAA,cAAA;AAItB,mBAAK,gBAAgB,0EAA0E,KAAK,UAAU,aAAa,CAAC,GAAG;AAC/H,wBAAU,KAAK;AAAA,gBACX;AAAA,gBACA,WAAW;AAAA,cAAA,CACd;AAAA,YACL,OAAO;AACH,mBAAK,gBAAgB,kEAAkE,KAAK,UAAU,YAAY,CAAC,GAAG;AACtH,wBAAU,KAAK;AAAA,gBACX;AAAA,gBACA,WAAW;AAAA,cAAA,CACd;AAAA,YACL;AACA,gBAAI,UAAU,WAAW,MAAM,QAAQ;AACnC,2BAAa,kBAAkB;AAC/B,mBAAK,gBAAgB,mGAAmG,UAAU,MAAM,+BAA+B;AACvK,iBAAG,SAAS;AAAA,YAChB;AAAA,UACJ,CAAC;AAAA,QACL;AAAA,MACJ,CAAC;AAAA,IACL,CAAC;AAAA,EACL;AAAA,EAEU,yCAAyC,MAAY;AAC3D,QAAI,KAAK,mBAAmB;AACxB,WAAK,kBAAkB,IAAI,CAAC,QAAQ,SAAS;AACzC,YAAI,KAAK,aAAa,MAAM;AACxB,eAAK,IAAI,MAAM,2GAA2G,CAAC;AAAA,QAC/H,OAAO;AACH,eAAA;AAAA,QACJ;AAAA,MACJ,CAAC;AAAA,IACL;AAAA,EACJ;AAAA,EAEU,iBAAiB,MAAkE;AAEzF,QAAI,KAAK,IAAI;AACT,WAAK,gBAAgB,iDAAiD,KAAK,SAAS,IAAI;AACxF,WAAK,oBAAoB,KAAK,GAAG,GAAG,IAAI,KAAK,SAAS,GAAG;AAEzD,WAAK,gBAAgB,4DAA4D;AACjF,WAAK,uCAAA;AAEL,WAAK,gBAAgB,+CAA+C;AACpE,WAAK,0BAAA;AAEL,WAAK,kBAAkB,GAAG,cAAc,CAAA,WAAU;AAC9C,aAAK,gBAAgB,4CAA4C,OAAO,EAAE,GAAG;AAC7E,aAAK,gBAAgB,uDAAuD,KAAK,UAAU,OAAO,UAAU,IAAI,CAAC,GAAG;AACpH,aAAK,gBAAgB,uDAAuD,KAAK,UAAU,OAAO,UAAU,QAAQ,IAAI,CAAC,GAAG;AAC5H,aAAK,gBAAgB,sDAAsD,KAAK,UAAU,OAAO,UAAU,GAAG,CAAC,GAAG;AAClH,aAAK,gBAAgB,gDAAgD,KAAK,UAAU,OAAO,SAAS,CAAC,GAAG;AAExG,aAAK,gBAAgB,wDAAwD,OAAO,EAAE,GAAG;AACzF,aAAK,uBAAuB,MAAM;AAElC,YAAI,KAAK,SAAS,KAAK,MAAM,SAAS,GAAG;AACrC,eAAK,MAAM,IAAI,CAAC,SAAS;AACrB,iBAAK,gBAAgB,oCAAoC,IAAI,eAAe,OAAO,EAAE,GAAG;AACxF,iBAAK,SAAS,QAAQ,IAAI;AAAA,UAC9B,CAAC;AAAA,QACL;AAEA,aAAK,gBAAgB,mDAAmD,OAAO,EAAE,GAAG;AACpF,aAAK,oBAAoB,MAAM;AAE/B,mBAAW,MAAM;AACb,eAAK,gBAAgB,uDAAuD,OAAO,EAAE,GAAG;AACxF,eAAK,cAAc,MAAM;AAAA,QAC7B,GAAG,CAAC;AAEJ,aAAK,gBAAgB,sDAAsD,OAAO,EAAE,GAAG;AACvF,aAAK,kBAAkB,MAAM;AAAA,MACjC,CAAC;AAAA,IACL,OAAO;AACH,YAAM,eAAe;AACrB,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AAEA,WAAO;AAAA,EACX;AAAA,EAEU,yBAAyB,YAA2B;AAC1D,QAAI,KAAK,mBAAmB;AACxB,WAAK,gBAAgB,kEAAkE;AACvF,YAAM,KAAK,kBAAkB,QAAQ,MAAA;AAAA,IACzC;AAAA,EACJ;AAAA,EAEU,6BAA6B,MAAY;AAC/C,QAAI,KAAK,mBAAmB;AACxB,WAAK,gBAAgB,0EAA0E;AAC/F,WAAK,kBAAkB,kBAAA;AACvB,WAAK,oBAAoB;AAAA,IAC7B;AAAA,EACJ;AACJ;;"}
package/dist/node.mjs CHANGED
@@ -24,12 +24,6 @@ class SocketIoServer extends tinyEmitterExports.TinyEmitter {
24
24
  super();
25
25
  this.serverName = serverName;
26
26
  }
27
- SocketDisconnectCallBack = (socket, reason) => {
28
- };
29
- SocketDisconnectingCallBack = (socket, reason) => {
30
- };
31
- SocketErrorCallBack = (socket, error) => {
32
- };
33
27
  get logPrefix() {
34
28
  if (this.namespace) {
35
29
  return `SocketIoServer[${this.serverName}:${this.namespace}]: `;
@@ -81,10 +75,6 @@ class SocketIoServer extends tinyEmitterExports.TinyEmitter {
81
75
  // Use this middleware to check every packet being received
82
76
  SetupMessageMiddleware = (socket) => {
83
77
  };
84
- SocketConnectCallBack = (socket) => {
85
- };
86
- SocketEventsCallBack = (socket) => {
87
- };
88
78
  /*
89
79
  protected GetConfig = (socketIoServeroptions: ISocketIoServerOpitons): Partial<ServerOptions> => {
90
80
  //this.#redisClient = createClient({url: this.#options.ioRedisMessageProcessorUrl});
@@ -283,15 +273,15 @@ class SocketIoServer extends tinyEmitterExports.TinyEmitter {
283
273
  SetupStandardEvents = (socket) => {
284
274
  socket.on("disconnect", (reason) => {
285
275
  this.LogDebugMessage(`SetupStandardEvents(): socket disconnect, ID: [${socket.id}], reason: [${reason}]`);
286
- this.SocketDisconnectCallBack(socket, reason);
276
+ this.SocketDisconnect(socket, reason);
287
277
  });
288
278
  socket.on("disconnecting", (reason) => {
289
279
  this.LogDebugMessage(`SetupStandardEvents(): socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);
290
- this.SocketDisconnectingCallBack(socket, reason);
280
+ this.SocketDisconnecting(socket, reason);
291
281
  });
292
282
  socket.on("error", (error) => {
293
283
  this.LogDebugMessage(`SetupStandardEvents(): socket error, ID: [${socket.id}], Error: [${error}]`);
294
- this.SocketErrorCallBack(socket, error);
284
+ this.SocketError(socket, error);
295
285
  });
296
286
  socket.on("__STSdisconnect", (reason) => {
297
287
  this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnect: socket disconnect, ID: [${socket.id}], reason: [${reason}]`);
@@ -427,10 +417,10 @@ class SocketIoServer extends tinyEmitterExports.TinyEmitter {
427
417
  this.SetupStandardEvents(socket);
428
418
  setTimeout(() => {
429
419
  this.LogDebugMessage(`SetupNamespace(): SocketConnectCallBack(): Socket: [${socket.id}]`);
430
- this.SocketConnectCallBack(socket);
420
+ this.SocketConnect(socket);
431
421
  }, 0);
432
422
  this.LogDebugMessage(`SetupNamespace(): SocketEventsCallBack(): Socket: [${socket.id}]`);
433
- this.SocketEventsCallBack(socket);
423
+ this.SetupSocketEvents(socket);
434
424
  });
435
425
  } else {
436
426
  const errorMessage = `SetupNamespace(): Error: [No server attached]`;
package/dist/node.mjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"node.mjs","sources":["../src/socketIoServer.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */ // --> OFF\nimport { ISTSLogger, JSONObject, Sleep } from '@nsshunt/stsutils'\n\nimport { Server, Namespace, Socket, ServerOptions } from \"socket.io\";\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, STSServerSocket, \n InterServerEvents } from './commonTypes'\n\n//import { createClient, RedisClientType } from 'redis';\nimport { Redis } from 'ioredis';\n\nimport { createAdapter as clusterCreateAdapter } from '@socket.io/cluster-adapter'\nimport { createAdapter } from \"@socket.io/redis-streams-adapter\";\n\nimport { TinyEmitter } from 'tiny-emitter';\n\nexport interface ISocketIoServerOpitons {\n listenPort?: number\n ioRedisMessageProcessorUrl?: string\n wssCustomPath?: string\n serverClusterMode?: boolean\n}\n \nexport abstract class SocketIoServer<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> extends TinyEmitter {\n protected namespace?: string\n protected socketionamespace?: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n //protected socketionamespace?: Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>\n protected logger?: ISTSLogger\n protected io?: Server<ClientToServerEvents, ServerToClientEvents>;\n //#redisClient: RedisClientType | Redis | null = null;\n protected redisClient?: Redis;\n protected listenPort?: number;\n protected socketIoCustomPath?: string;\n protected ioRedisMessageProcessorUrl?: string;\n protected serverClusterMode?: boolean;\n protected rooms?: string[];\n protected serverName: string\n protected draining: boolean = false;\n protected attached: boolean = false;\n\n constructor(serverName: string) { // IProcessBase\n super();\n this.serverName = serverName;\n }\n\n protected SocketDisconnectCallBack = (socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void => { };\n\n protected SocketDisconnectingCallBack = (socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void => { };\n\n protected SocketErrorCallBack = (socket: Socket<ClientToServerEvents, ServerToClientEvents>, error: Error): void => { };\n\n protected get logPrefix(): string {\n if (this.namespace) {\n return `SocketIoServer[${this.serverName}:${this.namespace}]: `;\n } else {\n return `SocketIoServer[${this.serverName}:<No Namespace>]: `;\n }\n }\n\n protected LogErrorMessage(message: any) {\n if (this.logger) {\n this.logger.error(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogDebugMessage(message: any) {\n if (this.logger) {\n this.logger.debug(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogInfoMessage(message: any) {\n if (this.logger) {\n this.logger.info(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogWarnMessage(message: any) {\n if (this.logger) {\n this.logger.warn(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogSillyMessage(message: any) {\n if (this.logger) {\n this.logger.silly(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogVerboseMessage(message: any) {\n if (this.logger) {\n this.logger.verbose(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogHttpMessage(message: any) {\n if (this.logger) {\n this.logger.http(`${this.logPrefix}${message}`);\n }\n }\n\n // https://socket.io/docs/v4/middlewares/\n // https://socket.io/docs/v4/server-socket-instance/#sockethandshake\n // https://socket.io/docs/v4/server-socket-instance/#socket-middlewares\n // Use this middleward to check every incomming connection\n protected SetupConnectionMiddleware = () => { };\n\n // Use this middleware to check every packet being received\n protected SetupMessageMiddleware = (socket: STSServerSocket) => { };\n\n protected SocketConnectCallBack = (socket: Socket<ClientToServerEvents, ServerToClientEvents>): void => { };\n\n protected SocketEventsCallBack = (socket: Socket<ClientToServerEvents, ServerToClientEvents>): void => { };\n\n /*\n protected GetConfig = (socketIoServeroptions: ISocketIoServerOpitons): Partial<ServerOptions> => {\n //this.#redisClient = createClient({url: this.#options.ioRedisMessageProcessorUrl});\n //await this.#redisClient.connect();\n this.LogDebugMessage(`GetConfig() transports: [ [websocket] ]`);\n const options: Partial<ServerOptions> = {\n transports: [ \"websocket\" ], // or [ \"websocket\", \"polling\" ] (to use long-poolling. Note that the order matters)\n }\n\n if (socketIoServeroptions.ioRedisMessageProcessorUrl && socketIoServeroptions.ioRedisMessageProcessorUrl !== '') {\n this.redisClient = new Redis(socketIoServeroptions.ioRedisMessageProcessorUrl);\n this.LogDebugMessage(`GetConfig() createAdapter(redis): redis url: [${socketIoServeroptions.ioRedisMessageProcessorUrl}]`);\n options.adapter = createAdapter(this.redisClient) as any;\n } else if (socketIoServeroptions.serverClusterMode && socketIoServeroptions.serverClusterMode === true) {\n this.LogDebugMessage(`GetConfig() createAdapter(cluster)`);\n options.adapter = clusterCreateAdapter() as any;\n }\n\n if (socketIoServeroptions.wssCustomPath && socketIoServeroptions.wssCustomPath.localeCompare('') !== 0) {\n this.LogDebugMessage(`GetConfig() wssCustomPath: [${socketIoServeroptions.wssCustomPath}]`);\n options.path = socketIoServeroptions.wssCustomPath;\n }\n\n return options;\n }\n */\n\n protected SetEngineEvents = () => {\n if (this.io) {\n this.io.engine.on(\"connection_error\", (err) => {\n this.LogWarnMessage(`SetEngineEvents(): connection_error`); // the request object\n this.LogWarnMessage(err.req); // the request object\n this.LogWarnMessage(err.code); // the error code, for example 1\n this.LogWarnMessage(err.message); // the error message, for example \"Session ID unknown\"\n this.LogWarnMessage(err.context); // some additional error context\n });\n }\n }\n\n WithLogger = (logger: ISTSLogger) => {\n this.logger = logger;\n return this;\n }\n\n WithListenPort = (listenPort: number) => {\n this.listenPort = listenPort;\n return this;\n }\n\n WithSocketIoCustomPath = (socketIoCustomPath: string) => {\n this.socketIoCustomPath = socketIoCustomPath;\n return this;\n }\n\n WithIoRedisMessageProcessorUrl = (ioRedisMessageProcessorUrl: string) => {\n this.ioRedisMessageProcessorUrl = ioRedisMessageProcessorUrl;\n return this;\n }\n\n WithClusterMode = (serverClusterMode: boolean) => {\n this.serverClusterMode = serverClusterMode;\n return this;\n }\n\n WithRooms = (rooms: string[]) => {\n this.rooms = rooms;\n return this;\n }\n\n WithNamespace = (namespace: string) => {\n this.namespace = namespace;\n return this;\n }\n\n AttachSocketIoServer = async (server: Server): Promise<SocketIoServer<ClientToServerEvents, ServerToClientEvents>> => {\n if (!this.io) {\n this.LogInfoMessage(`AttachServer(): io = server`);\n this.io = server;\n\n this.LogInfoMessage(`AttachServer(): attached = true`);\n this.attached = true;\n\n this.LogInfoMessage(`AttachServer(): SetupNamespace()`);\n this.SetupNamespace();\n } else {\n const errorMessage = (this.attached === true ? `AttachServer(): Server already exists (from AttachServer())` : `AttachServer(): Server already exists (from StartServer())`);\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n return this;\n }\n\n StartSocketIoServer = async (): Promise<SocketIoServer<ClientToServerEvents, ServerToClientEvents>> => {\n //this.#io = require(\"socket.io\")(this.#httpServer, options);\n if (!this.namespace) {\n const errorMessage = `StartServer(): Error: [namespace not specified]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n\n if (!this.io) {\n if (!this.listenPort) {\n const errorMessage = `StartServer(): Error: [listenPort not specified]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n\n this.LogDebugMessage(`StartServer(): draining = false`);\n this.draining = false;\n\n this.LogDebugMessage(`StartServer(): transports: [ [websocket] ]`);\n const options: Partial<ServerOptions> = {\n transports: [ \"websocket\" ], // or [ \"websocket\", \"polling\" ] (to use long-poolling. Note that the order matters)\n }\n\n if (this.ioRedisMessageProcessorUrl && this.ioRedisMessageProcessorUrl !== '') {\n this.redisClient = new Redis(this.ioRedisMessageProcessorUrl);\n this.LogDebugMessage(`StartServer(): createAdapter(redis): redis url: [${this.ioRedisMessageProcessorUrl}]`);\n options.adapter = createAdapter(this.redisClient) as any;\n } else if (this.serverClusterMode && this.serverClusterMode === true) {\n this.LogDebugMessage(`StartServer(): createAdapter(cluster)`);\n options.adapter = clusterCreateAdapter() as any;\n }\n\n if (this.socketIoCustomPath && this.socketIoCustomPath.localeCompare('') !== 0) {\n this.LogDebugMessage(`StartServer(): socketIoCustomPath: [${this.socketIoCustomPath}]`);\n options.path = this.socketIoCustomPath;\n }\n\n this.LogDebugMessage(`StartServer(): new Server(): listenPort: [${this.listenPort}]`);\n this.io = new Server(this.listenPort, options);\n\n this.LogDebugMessage(`StartServer(): SetEngineEvents()`);\n this.SetEngineEvents();\n\n this.LogDebugMessage(`StartServer(): Sleeping ...`);\n await Sleep(500);\n this.LogDebugMessage(`StartServer(): Done Sleeping`);\n\n this.LogInfoMessage(`AttachServer(): attached = false`);\n this.attached = false;\n\n this.LogInfoMessage(`StartServer(): SetupNamespace()`);\n this.SetupNamespace();\n\n } else {\n const errorMessage = (this.attached === true ? `StartServer(): Server already exists (from AttachServer())` : `StartServer(): Server already exists (from StartServer())`);\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n return this;\n }\n\n DetachSockerIoServer = async (): Promise<void> => {\n if (this.io) {\n if (this.attached === true) {\n this.LogInfoMessage(`DetachServer(): StopNamespace()`);\n await this.StopNamespace();\n this.io = undefined;\n this.LogInfoMessage(`DetachServer(): attached = false`);\n this.attached = false;\n } else {\n const errorMessage = `DetachServer(): Error: [Server has not been attached. Use StopServer() to stop the socker.io server.]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n } else {\n const errorMessage = `DetachServer(): Error: [no server exists to DetachServer()]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n }\n\n StopSocketIoServer = async () => {\n if (this.io) {\n if (this.attached === false) {\n // We are now draining connections\n this.LogInfoMessage(`StopServer(): draining = true`);\n this.draining = true;\n\n this.LogInfoMessage(`StopServer(): StopNamespace()`);\n await this.StopNamespace();\n\n this.LogInfoMessage(`StopServer(): io.of('/').adapter.close()`);\n await this.io.of('/').adapter.close();\n\n if (this.redisClient) {\n this.LogInfoMessage(`StopServer(): redisClient.disconnect()`);\n await this.redisClient.disconnect();\n this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Sleeping...)`);\n await Sleep(50);\n this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Done Sleeping)`);\n }\n\n // boot all current connections\n this.LogInfoMessage(`StopServer(): io.disconnectSockets()`);\n this.io.disconnectSockets();\n\n // Stop any future connections, close this server (does not close the underlying http(s) server if io server via that method\n this.LogInfoMessage(`StopServer(): io.close()`);\n this.io.close();\n\n this.LogInfoMessage(`StopServer(): io = undefined`);\n this.io = undefined;\n } else {\n const errorMessage = `StopServer(): Cannot stop an attached server. The server created must handle stop/disconnections. Use StopNamespace() instead.`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n } else {\n const errorMessage = `StopServer(): Error: [no server exists to StopServer()]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n }\n\n LeaveRoom = (socket: STSServerSocket, room: string): void => {\n this.LogDebugMessage(`LeaveRoom(): Leaving room [${room}]`);\n socket.leave(room);\n };\n\n JoinRoom = (socket: STSServerSocket, room: string): void => {\n this.LogDebugMessage(`JoinRoom(): Socket joining room [${room}], ID: [${socket.id}]`);\n socket.join(room);\n };\n\n protected StopNamespace = async() => {\n this.LogInfoMessage(`StopServer(): CloseNamespaceAdaptors()`);\n await this.CloseNamespaceAdaptors();\n\n this.LogInfoMessage(`StopServer(): DisconnectNamespaceSockets()`);\n this.DisconnectNamespaceSockets();\n }\n\n protected SetupStandardEvents = (socket: STSServerSocket): void => {\n socket.on('disconnect', (reason: string) => {\n this.LogDebugMessage(`SetupStandardEvents(): socket disconnect, ID: [${socket.id}], reason: [${reason}]`);\n this.SocketDisconnectCallBack(socket, reason);\n });\n\n socket.on('disconnecting', (reason: string) => {\n this.LogDebugMessage(`SetupStandardEvents(): socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);\n this.SocketDisconnectingCallBack(socket, reason);\n });\n\n socket.on('error', (error: Error) => {\n this.LogDebugMessage(`SetupStandardEvents(): socket error, ID: [${socket.id}], Error: [${error}]`);\n this.SocketErrorCallBack(socket, error);\n });\n\n socket.on(\"__STSdisconnect\", (reason: string) => {\n this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnect: socket disconnect, ID: [${socket.id}], reason: [${reason}]`);\n });\n\n socket.on(\"__STSdisconnecting\", (reason, callBackResult) => {\n this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnecting: socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);\n callBackResult(\"__STSdisconnecting accepted by server.\");\n });\n\n socket.on('__STSjoinRoom', (rooms: string[]): void => { //@@ names\n rooms.forEach((room) => {\n this.LogDebugMessage(`SetupStandardEvents(): __STSjoinRoom: room: [${room}], socket: [${socket.id}]`);\n this.JoinRoom(socket, room)\n });\n });\n\n socket.on('__STSleaveRoom', (rooms: string[]): void => { //@@ names\n rooms.forEach((room) => {\n this.LogDebugMessage(`SetupStandardEvents(): __STSleaveRoom: room: [${room}], socket: [${socket.id}]`);\n this.LeaveRoom(socket, room);\n });\n });\n\n socket.on('__STSsendToRoom', (rooms: string[], payload: { command: string, payload: JSONObject }): void => {\n rooms.forEach((room) => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}], Command: [${payload.command}]`);\n this.socketionamespace.to(room).emit(payload.command as any, payload);\n }\n });\n });\n\n socket.on('__STSsendToRoomWithCallback', (room: string, timeout: number, payload: { command: string, payload: JSONObject }, cb: (data: JSONObject) => void): void => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);\n this.socketionamespace.to(room).timeout(timeout).emit(payload.command as any, payload, (err: Error, dataResponse: JSONObject[]) => {\n if (err) {\n console.error(err);\n const errorResponse = {\n error: true, \n errorName: err.name, \n errorMessage: err.message,\n //errorCause: err.cause,\n //errorStack: err.stack\n };\n this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`)\n cb(errorResponse);\n } else {\n this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`)\n cb(dataResponse);\n }\n });\n }\n });\n\n socket.on('__STSsendToRoomsWithCallback', (rooms: string[], timeout: number, payload: { command: string, payload: JSONObject }, cb: (data: JSONObject) => void): void => {\n const responses: any[] = [ ];\n\n const timeoutForComplete = setTimeout(() => {\n // for this timeout case, sent back the error response and the responses we have received so far ...\n responses.push({\n room: '',\n responses: {\n error: true,\n errorName: 'timeout',\n errorMessage: `__STSsendToRoomsWithCallback timeout: [${timeout}] before all responses received`\n }\n });\n cb(responses);\n }, timeout).unref();\n\n rooms.forEach((room) => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);\n this.socketionamespace.to(room).timeout(timeout).emit(payload.command as any, payload, (err: Error, dataResponse: JSONObject[]) => {\n if (err) {\n console.error(err);\n const errorResponse = {\n error: true, \n errorName: err.name, \n errorMessage: err.message,\n //errorCause: err.cause,\n //errorStack: err.stack\n };\n this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`)\n responses.push({\n room,\n responses: errorResponse\n });\n } else {\n this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`)\n responses.push({\n room,\n responses: dataResponse\n });\n }\n if (responses.length === rooms.length) {\n clearTimeout(timeoutForComplete);\n this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: All complete, Responses Count: [${responses.length}] Invoke call back(responses)`);\n cb(responses);\n }\n });\n }\n });\n });\n }\n\n protected ConnectionDrainingConnectionMiddleware = (): void => {\n if (this.socketionamespace) {\n this.socketionamespace.use((socket, next) => {\n if (this.draining === true) {\n next(new Error(`ConnectionDrainingConnectionMiddleware(): Error: [server connections draining (from a server disconnect)]`));\n } else {\n next();\n }\n });\n }\n }\n \n protected SetupNamespace = (): SocketIoServer<ClientToServerEvents, ServerToClientEvents> => {\n // Create STS Command Centre Client namespace\n if (this.io) {\n this.LogDebugMessage(`SetupNamespace(): socketionamespace = io.of('/${this.namespace}/'`);\n this.socketionamespace = this.io.of(`/${this.namespace}/`);\n\n this.LogDebugMessage(`SetupNamespace(): ConnectionDrainingConnectionMiddleware()`);\n this.ConnectionDrainingConnectionMiddleware();\n\n this.LogDebugMessage(`SetupNamespace(): SetupConnectionMiddleware()`);\n this.SetupConnectionMiddleware();\n\n this.socketionamespace.on(\"connection\", socket => {\n this.LogDebugMessage(`SetupNamespace(): Socket connected, ID: [${socket.id}]`);\n this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (auth): [${JSON.stringify(socket.handshake.auth)}]`);\n this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (host): [${JSON.stringify(socket.handshake.headers.host)}]`);\n this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (url): [${JSON.stringify(socket.handshake.url)}]`);\n this.LogDebugMessage(`SetupNamespace(): Authentication Handshake: [${JSON.stringify(socket.handshake)}]`);\n\n this.LogDebugMessage(`SetupNamespace(): SetupMessageMiddleware(): Socket: [${socket.id}]`);\n this.SetupMessageMiddleware(socket);\n\n if (this.rooms && this.rooms.length > 0) {\n this.rooms.map((room) => {\n this.LogDebugMessage(`SetupNamespace(): Joining Room: [${room}], Socket: [${socket.id}]`);\n this.JoinRoom(socket, room);\n });\n }\n\n this.LogDebugMessage(`SetupNamespace(): SetupStandardEvents: Socket: [${socket.id}]`);\n this.SetupStandardEvents(socket);\n\n setTimeout(() => {\n this.LogDebugMessage(`SetupNamespace(): SocketConnectCallBack(): Socket: [${socket.id}]`);\n this.SocketConnectCallBack(socket);\n }, 0);\n\n this.LogDebugMessage(`SetupNamespace(): SocketEventsCallBack(): Socket: [${socket.id}]`);\n this.SocketEventsCallBack(socket);\n });\n } else {\n const errorMessage = `SetupNamespace(): Error: [No server attached]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n\n return this;\n }\n\n protected CloseNamespaceAdaptors = async (): Promise<void> => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`CloseNamespaceAdaptors(): this.socketionamespace.adapter.close()`);\n await this.socketionamespace.adapter.close();\n }\n }\n\n protected DisconnectNamespaceSockets = (): void => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`DisconnectNamespaceSockets(): this.socketionamespace.disconnectSockets()`);\n this.socketionamespace.disconnectSockets();\n this.socketionamespace = undefined;\n }\n }\n}\n"],"names":["TinyEmitter","clusterCreateAdapter"],"mappings":";;;;;;AAuBO,MAAe,uBAAiJA,mBAAAA,YAAY;AAAA,EACrK;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAoB;AAAA,EACpB,WAAoB;AAAA,EAE9B,YAAY,YAAoB;AAC5B,UAAA;AACA,SAAK,aAAa;AAAA,EACtB;AAAA,EAEU,2BAA2B,CAAC,QAA4D,WAAyB;AAAA,EAAE;AAAA,EAEnH,8BAA8B,CAAC,QAA4D,WAAyB;AAAA,EAAE;AAAA,EAEtH,sBAAsB,CAAC,QAA4D,UAAuB;AAAA,EAAE;AAAA,EAEtH,IAAc,YAAoB;AAC9B,QAAI,KAAK,WAAW;AAChB,aAAO,kBAAkB,KAAK,UAAU,IAAI,KAAK,SAAS;AAAA,IAC9D,OAAO;AACH,aAAO,kBAAkB,KAAK,UAAU;AAAA,IAC5C;AAAA,EACJ;AAAA,EAEU,gBAAgB,SAAc;AACpC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,MAAM,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IACnD;AAAA,EACJ;AAAA,EAEU,gBAAgB,SAAc;AACpC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,MAAM,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IACnD;AAAA,EACJ;AAAA,EAEU,eAAe,SAAc;AACnC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,KAAK,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IAClD;AAAA,EACJ;AAAA,EAEU,eAAe,SAAc;AACnC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,KAAK,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IAClD;AAAA,EACJ;AAAA,EAEU,gBAAgB,SAAc;AACpC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,MAAM,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IACnD;AAAA,EACJ;AAAA,EAEU,kBAAkB,SAAc;AACtC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,QAAQ,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IACrD;AAAA,EACJ;AAAA,EAEU,eAAe,SAAc;AACnC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,KAAK,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IAClD;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA,EAMU,4BAA4B,MAAM;AAAA,EAAE;AAAA;AAAA,EAGpC,yBAAyB,CAAC,WAA4B;AAAA,EAAE;AAAA,EAExD,wBAAwB,CAAC,WAAqE;AAAA,EAAE;AAAA,EAEhG,uBAAuB,CAAC,WAAqE;AAAA,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6B/F,kBAAkB,MAAM;AAC9B,QAAI,KAAK,IAAI;AACT,WAAK,GAAG,OAAO,GAAG,oBAAoB,CAAC,QAAQ;AAC3C,aAAK,eAAe,qCAAqC;AACzD,aAAK,eAAe,IAAI,GAAG;AAC3B,aAAK,eAAe,IAAI,IAAI;AAC5B,aAAK,eAAe,IAAI,OAAO;AAC/B,aAAK,eAAe,IAAI,OAAO;AAAA,MACnC,CAAC;AAAA,IACL;AAAA,EACJ;AAAA,EAEA,aAAa,CAAC,WAAuB;AACjC,SAAK,SAAS;AACd,WAAO;AAAA,EACX;AAAA,EAEA,iBAAiB,CAAC,eAAuB;AACrC,SAAK,aAAa;AAClB,WAAO;AAAA,EACX;AAAA,EAEA,yBAAyB,CAAC,uBAA+B;AACrD,SAAK,qBAAqB;AAC1B,WAAO;AAAA,EACX;AAAA,EAEA,iCAAiC,CAAC,+BAAuC;AACrE,SAAK,6BAA6B;AAClC,WAAO;AAAA,EACX;AAAA,EAEA,kBAAkB,CAAC,sBAA+B;AAC9C,SAAK,oBAAoB;AACzB,WAAO;AAAA,EACX;AAAA,EAEA,YAAY,CAAC,UAAoB;AAC7B,SAAK,QAAQ;AACb,WAAO;AAAA,EACX;AAAA,EAEA,gBAAgB,CAAC,cAAsB;AACnC,SAAK,YAAY;AACjB,WAAO;AAAA,EACX;AAAA,EAEA,uBAAuB,OAAO,WAAwF;AAClH,QAAI,CAAC,KAAK,IAAI;AACV,WAAK,eAAe,6BAA6B;AACjD,WAAK,KAAK;AAEV,WAAK,eAAe,iCAAiC;AACrD,WAAK,WAAW;AAEhB,WAAK,eAAe,kCAAkC;AACtD,WAAK,eAAA;AAAA,IACT,OAAO;AACH,YAAM,eAAgB,KAAK,aAAa,OAAO,gEAAgE;AAC/G,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AACA,WAAO;AAAA,EACX;AAAA,EAEA,sBAAsB,YAAiF;AAEnG,QAAI,CAAC,KAAK,WAAW;AACjB,YAAM,eAAe;AACrB,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AAEA,QAAI,CAAC,KAAK,IAAI;AACV,UAAI,CAAC,KAAK,YAAY;AAClB,cAAM,eAAe;AACrB,aAAK,gBAAgB,YAAY;AACjC,cAAM,IAAI,MAAM,YAAY;AAAA,MAChC;AAEA,WAAK,gBAAgB,iCAAiC;AACtD,WAAK,WAAW;AAEhB,WAAK,gBAAgB,4CAA4C;AACjE,YAAM,UAAkC;AAAA,QACpC,YAAY,CAAE,WAAY;AAAA;AAAA,MAAA;AAG9B,UAAI,KAAK,8BAA8B,KAAK,+BAA+B,IAAI;AAC3E,aAAK,cAAc,IAAI,MAAM,KAAK,0BAA0B;AAC5D,aAAK,gBAAgB,oDAAoD,KAAK,0BAA0B,GAAG;AAC3G,gBAAQ,UAAU,cAAc,KAAK,WAAW;AAAA,MACpD,WAAW,KAAK,qBAAqB,KAAK,sBAAsB,MAAM;AAClE,aAAK,gBAAgB,uCAAuC;AAC5D,gBAAQ,UAAUC,gBAAA;AAAA,MACtB;AAEA,UAAI,KAAK,sBAAsB,KAAK,mBAAmB,cAAc,EAAE,MAAM,GAAG;AAC5E,aAAK,gBAAgB,uCAAuC,KAAK,kBAAkB,GAAG;AACtF,gBAAQ,OAAO,KAAK;AAAA,MACxB;AAEA,WAAK,gBAAgB,6CAA6C,KAAK,UAAU,GAAG;AACpF,WAAK,KAAK,IAAI,OAAO,KAAK,YAAY,OAAO;AAE7C,WAAK,gBAAgB,kCAAkC;AACvD,WAAK,gBAAA;AAEL,WAAK,gBAAgB,6BAA6B;AAClD,YAAM,MAAM,GAAG;AACf,WAAK,gBAAgB,8BAA8B;AAEnD,WAAK,eAAe,kCAAkC;AACtD,WAAK,WAAW;AAEhB,WAAK,eAAe,iCAAiC;AACrD,WAAK,eAAA;AAAA,IAET,OAAO;AACH,YAAM,eAAgB,KAAK,aAAa,OAAO,+DAA+D;AAC9G,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AACA,WAAO;AAAA,EACX;AAAA,EAEA,uBAAuB,YAA2B;AAC9C,QAAI,KAAK,IAAI;AACT,UAAI,KAAK,aAAa,MAAM;AACxB,aAAK,eAAe,iCAAiC;AACrD,cAAM,KAAK,cAAA;AACX,aAAK,KAAK;AACV,aAAK,eAAe,kCAAkC;AACtD,aAAK,WAAW;AAAA,MACpB,OAAO;AACH,cAAM,eAAe;AACrB,aAAK,gBAAgB,YAAY;AACjC,cAAM,IAAI,MAAM,YAAY;AAAA,MAChC;AAAA,IACJ,OAAO;AACH,YAAM,eAAe;AACrB,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AAAA,EACJ;AAAA,EAEA,qBAAqB,YAAY;AAC7B,QAAI,KAAK,IAAI;AACT,UAAI,KAAK,aAAa,OAAO;AAEzB,aAAK,eAAe,+BAA+B;AACnD,aAAK,WAAW;AAEhB,aAAK,eAAe,+BAA+B;AACnD,cAAM,KAAK,cAAA;AAEX,aAAK,eAAe,0CAA0C;AAC9D,cAAM,KAAK,GAAG,GAAG,GAAG,EAAE,QAAQ,MAAA;AAE9B,YAAI,KAAK,aAAa;AAClB,eAAK,eAAe,wCAAwC;AAC5D,gBAAM,KAAK,YAAY,WAAA;AACvB,eAAK,eAAe,sDAAsD;AAC1E,gBAAM,MAAM,EAAE;AACd,eAAK,eAAe,wDAAwD;AAAA,QAChF;AAGA,aAAK,eAAe,sCAAsC;AAC1D,aAAK,GAAG,kBAAA;AAGR,aAAK,eAAe,0BAA0B;AAC9C,aAAK,GAAG,MAAA;AAER,aAAK,eAAe,8BAA8B;AAClD,aAAK,KAAK;AAAA,MACd,OAAO;AACH,cAAM,eAAe;AACrB,aAAK,gBAAgB,YAAY;AACjC,cAAM,IAAI,MAAM,YAAY;AAAA,MAChC;AAAA,IACJ,OAAO;AACH,YAAM,eAAe;AACrB,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AAAA,EACJ;AAAA,EAEA,YAAY,CAAC,QAAyB,SAAuB;AACzD,SAAK,gBAAgB,8BAA8B,IAAI,GAAG;AAC1D,WAAO,MAAM,IAAI;AAAA,EACrB;AAAA,EAEA,WAAW,CAAC,QAAyB,SAAuB;AACxD,SAAK,gBAAgB,oCAAoC,IAAI,WAAW,OAAO,EAAE,GAAG;AACpF,WAAO,KAAK,IAAI;AAAA,EACpB;AAAA,EAEU,gBAAgB,YAAW;AACjC,SAAK,eAAe,wCAAwC;AAC5D,UAAM,KAAK,uBAAA;AAEX,SAAK,eAAe,4CAA4C;AAChE,SAAK,2BAAA;AAAA,EACT;AAAA,EAEU,sBAAsB,CAAC,WAAkC;AAC/D,WAAO,GAAG,cAAc,CAAC,WAAmB;AACxC,WAAK,gBAAgB,kDAAkD,OAAO,EAAE,eAAe,MAAM,GAAG;AACxG,WAAK,yBAAyB,QAAQ,MAAM;AAAA,IAChD,CAAC;AAED,WAAO,GAAG,iBAAiB,CAAC,WAAmB;AAC3C,WAAK,gBAAgB,qDAAqD,OAAO,EAAE,eAAe,MAAM,GAAG;AAC3G,WAAK,4BAA4B,QAAQ,MAAM;AAAA,IACnD,CAAC;AAED,WAAO,GAAG,SAAS,CAAC,UAAiB;AACjC,WAAK,gBAAgB,6CAA6C,OAAO,EAAE,cAAc,KAAK,GAAG;AACjG,WAAK,oBAAoB,QAAQ,KAAK;AAAA,IAC1C,CAAC;AAED,WAAO,GAAG,mBAAmB,CAAC,WAAmB;AAC7C,WAAK,gBAAgB,mEAAmE,OAAO,EAAE,eAAe,MAAM,GAAG;AAAA,IAC7H,CAAC;AAED,WAAO,GAAG,sBAAsB,CAAC,QAAQ,mBAAmB;AACxD,WAAK,gBAAgB,yEAAyE,OAAO,EAAE,eAAe,MAAM,GAAG;AAC/H,qBAAe,wCAAwC;AAAA,IAC3D,CAAC;AAED,WAAO,GAAG,iBAAiB,CAAC,UAA0B;AAClD,YAAM,QAAQ,CAAC,SAAS;AACpB,aAAK,gBAAgB,gDAAgD,IAAI,eAAe,OAAO,EAAE,GAAG;AACpG,aAAK,SAAS,QAAQ,IAAI;AAAA,MAC9B,CAAC;AAAA,IACL,CAAC;AAED,WAAO,GAAG,kBAAkB,CAAC,UAA0B;AACnD,YAAM,QAAQ,CAAC,SAAS;AACpB,aAAK,gBAAgB,iDAAiD,IAAI,eAAe,OAAO,EAAE,GAAG;AACrG,aAAK,UAAU,QAAQ,IAAI;AAAA,MAC/B,CAAC;AAAA,IACL,CAAC;AAED,WAAO,GAAG,mBAAmB,CAAC,OAAiB,YAA4D;AACvG,YAAM,QAAQ,CAAC,SAAS;AACpB,YAAI,KAAK,mBAAmB;AACxB,eAAK,gBAAgB,uEAAuE,IAAI,WAAW,OAAO,EAAE,gBAAgB,QAAQ,OAAO,GAAG;AACtJ,eAAK,kBAAkB,GAAG,IAAI,EAAE,KAAK,QAAQ,SAAgB,OAAO;AAAA,QACxE;AAAA,MACJ,CAAC;AAAA,IACL,CAAC;AAED,WAAO,GAAG,+BAA+B,CAAC,MAAc,SAAiB,SAAmD,OAAyC;AACjK,UAAI,KAAK,mBAAmB;AACxB,aAAK,gBAAgB,mFAAmF,IAAI,WAAW,OAAO,EAAE,gBAAgB,OAAO,gBAAgB,QAAQ,OAAO,GAAG;AACzL,aAAK,kBAAkB,GAAG,IAAI,EAAE,QAAQ,OAAO,EAAE,KAAK,QAAQ,SAAgB,SAAS,CAAC,KAAY,iBAA+B;AAC/H,cAAI,KAAK;AACL,oBAAQ,MAAM,GAAG;AACjB,kBAAM,gBAAgB;AAAA,cAClB,OAAO;AAAA,cACP,WAAW,IAAI;AAAA,cACf,cAAc,IAAI;AAAA;AAAA;AAAA,YAAA;AAItB,iBAAK,gBAAgB,0EAA0E,KAAK,UAAU,aAAa,CAAC,GAAG;AAC/H,eAAG,aAAa;AAAA,UACpB,OAAO;AACH,iBAAK,gBAAgB,kEAAkE,KAAK,UAAU,YAAY,CAAC,GAAG;AACtH,eAAG,YAAY;AAAA,UACnB;AAAA,QACJ,CAAC;AAAA,MACL;AAAA,IACJ,CAAC;AAED,WAAO,GAAG,gCAAgC,CAAC,OAAiB,SAAiB,SAAmD,OAAyC;AACrK,YAAM,YAAmB,CAAA;AAEzB,YAAM,qBAAqB,WAAW,MAAM;AAExC,kBAAU,KAAK;AAAA,UACX,MAAM;AAAA,UACN,WAAW;AAAA,YACP,OAAO;AAAA,YACP,WAAW;AAAA,YACX,cAAc,0CAA0C,OAAO;AAAA,UAAA;AAAA,QACnE,CACH;AACD,WAAG,SAAS;AAAA,MAChB,GAAG,OAAO,EAAE,MAAA;AAEZ,YAAM,QAAQ,CAAC,SAAS;AACpB,YAAI,KAAK,mBAAmB;AACxB,eAAK,gBAAgB,oFAAoF,IAAI,WAAW,OAAO,EAAE,gBAAgB,OAAO,gBAAgB,QAAQ,OAAO,GAAG;AAC1L,eAAK,kBAAkB,GAAG,IAAI,EAAE,QAAQ,OAAO,EAAE,KAAK,QAAQ,SAAgB,SAAS,CAAC,KAAY,iBAA+B;AAC/H,gBAAI,KAAK;AACL,sBAAQ,MAAM,GAAG;AACjB,oBAAM,gBAAgB;AAAA,gBAClB,OAAO;AAAA,gBACP,WAAW,IAAI;AAAA,gBACf,cAAc,IAAI;AAAA;AAAA;AAAA,cAAA;AAItB,mBAAK,gBAAgB,0EAA0E,KAAK,UAAU,aAAa,CAAC,GAAG;AAC/H,wBAAU,KAAK;AAAA,gBACX;AAAA,gBACA,WAAW;AAAA,cAAA,CACd;AAAA,YACL,OAAO;AACH,mBAAK,gBAAgB,kEAAkE,KAAK,UAAU,YAAY,CAAC,GAAG;AACtH,wBAAU,KAAK;AAAA,gBACX;AAAA,gBACA,WAAW;AAAA,cAAA,CACd;AAAA,YACL;AACA,gBAAI,UAAU,WAAW,MAAM,QAAQ;AACnC,2BAAa,kBAAkB;AAC/B,mBAAK,gBAAgB,mGAAmG,UAAU,MAAM,+BAA+B;AACvK,iBAAG,SAAS;AAAA,YAChB;AAAA,UACJ,CAAC;AAAA,QACL;AAAA,MACJ,CAAC;AAAA,IACL,CAAC;AAAA,EACL;AAAA,EAEU,yCAAyC,MAAY;AAC3D,QAAI,KAAK,mBAAmB;AACxB,WAAK,kBAAkB,IAAI,CAAC,QAAQ,SAAS;AACzC,YAAI,KAAK,aAAa,MAAM;AACxB,eAAK,IAAI,MAAM,2GAA2G,CAAC;AAAA,QAC/H,OAAO;AACH,eAAA;AAAA,QACJ;AAAA,MACJ,CAAC;AAAA,IACL;AAAA,EACJ;AAAA,EAEU,iBAAiB,MAAkE;AAEzF,QAAI,KAAK,IAAI;AACT,WAAK,gBAAgB,iDAAiD,KAAK,SAAS,IAAI;AACxF,WAAK,oBAAoB,KAAK,GAAG,GAAG,IAAI,KAAK,SAAS,GAAG;AAEzD,WAAK,gBAAgB,4DAA4D;AACjF,WAAK,uCAAA;AAEL,WAAK,gBAAgB,+CAA+C;AACpE,WAAK,0BAAA;AAEL,WAAK,kBAAkB,GAAG,cAAc,CAAA,WAAU;AAC9C,aAAK,gBAAgB,4CAA4C,OAAO,EAAE,GAAG;AAC7E,aAAK,gBAAgB,uDAAuD,KAAK,UAAU,OAAO,UAAU,IAAI,CAAC,GAAG;AACpH,aAAK,gBAAgB,uDAAuD,KAAK,UAAU,OAAO,UAAU,QAAQ,IAAI,CAAC,GAAG;AAC5H,aAAK,gBAAgB,sDAAsD,KAAK,UAAU,OAAO,UAAU,GAAG,CAAC,GAAG;AAClH,aAAK,gBAAgB,gDAAgD,KAAK,UAAU,OAAO,SAAS,CAAC,GAAG;AAExG,aAAK,gBAAgB,wDAAwD,OAAO,EAAE,GAAG;AACzF,aAAK,uBAAuB,MAAM;AAElC,YAAI,KAAK,SAAS,KAAK,MAAM,SAAS,GAAG;AACrC,eAAK,MAAM,IAAI,CAAC,SAAS;AACrB,iBAAK,gBAAgB,oCAAoC,IAAI,eAAe,OAAO,EAAE,GAAG;AACxF,iBAAK,SAAS,QAAQ,IAAI;AAAA,UAC9B,CAAC;AAAA,QACL;AAEA,aAAK,gBAAgB,mDAAmD,OAAO,EAAE,GAAG;AACpF,aAAK,oBAAoB,MAAM;AAE/B,mBAAW,MAAM;AACb,eAAK,gBAAgB,uDAAuD,OAAO,EAAE,GAAG;AACxF,eAAK,sBAAsB,MAAM;AAAA,QACrC,GAAG,CAAC;AAEJ,aAAK,gBAAgB,sDAAsD,OAAO,EAAE,GAAG;AACvF,aAAK,qBAAqB,MAAM;AAAA,MACpC,CAAC;AAAA,IACL,OAAO;AACH,YAAM,eAAe;AACrB,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AAEA,WAAO;AAAA,EACX;AAAA,EAEU,yBAAyB,YAA2B;AAC1D,QAAI,KAAK,mBAAmB;AACxB,WAAK,gBAAgB,kEAAkE;AACvF,YAAM,KAAK,kBAAkB,QAAQ,MAAA;AAAA,IACzC;AAAA,EACJ;AAAA,EAEU,6BAA6B,MAAY;AAC/C,QAAI,KAAK,mBAAmB;AACxB,WAAK,gBAAgB,0EAA0E;AAC/F,WAAK,kBAAkB,kBAAA;AACvB,WAAK,oBAAoB;AAAA,IAC7B;AAAA,EACJ;AACJ;"}
1
+ {"version":3,"file":"node.mjs","sources":["../src/socketIoServer.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */ // --> OFF\nimport { ISTSLogger, JSONObject, Sleep } from '@nsshunt/stsutils'\n\nimport { Server, Namespace, Socket, ServerOptions } from \"socket.io\";\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, STSServerSocket, \n InterServerEvents } from './commonTypes'\n\n//import { createClient, RedisClientType } from 'redis';\nimport { Redis } from 'ioredis';\n\nimport { createAdapter as clusterCreateAdapter } from '@socket.io/cluster-adapter'\nimport { createAdapter } from \"@socket.io/redis-streams-adapter\";\n\nimport { TinyEmitter } from 'tiny-emitter';\n\nexport interface ISocketIoServerOpitons {\n listenPort?: number\n ioRedisMessageProcessorUrl?: string\n wssCustomPath?: string\n serverClusterMode?: boolean\n}\n \nexport abstract class SocketIoServer<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> extends TinyEmitter {\n protected namespace?: string\n protected socketionamespace?: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n //protected socketionamespace?: Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>\n protected logger?: ISTSLogger\n protected io?: Server<ClientToServerEvents, ServerToClientEvents>;\n //#redisClient: RedisClientType | Redis | null = null;\n protected redisClient?: Redis;\n protected listenPort?: number;\n protected socketIoCustomPath?: string;\n protected ioRedisMessageProcessorUrl?: string;\n protected serverClusterMode?: boolean;\n protected rooms?: string[];\n protected serverName: string\n protected draining: boolean = false;\n protected attached: boolean = false;\n\n constructor(serverName: string) { // IProcessBase\n super();\n this.serverName = serverName;\n }\n\n protected abstract SocketDisconnect(socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void;\n\n protected abstract SocketDisconnecting(socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void;\n\n protected abstract SocketError(socket: Socket<ClientToServerEvents, ServerToClientEvents>, error: Error): void;\n\n protected abstract SocketConnect(socket: Socket<ClientToServerEvents, ServerToClientEvents>): void;\n\n protected abstract SetupSocketEvents(socket: Socket<ClientToServerEvents, ServerToClientEvents>): void;\n\n protected get logPrefix(): string {\n if (this.namespace) {\n return `SocketIoServer[${this.serverName}:${this.namespace}]: `;\n } else {\n return `SocketIoServer[${this.serverName}:<No Namespace>]: `;\n }\n }\n\n protected LogErrorMessage(message: any) {\n if (this.logger) {\n this.logger.error(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogDebugMessage(message: any) {\n if (this.logger) {\n this.logger.debug(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogInfoMessage(message: any) {\n if (this.logger) {\n this.logger.info(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogWarnMessage(message: any) {\n if (this.logger) {\n this.logger.warn(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogSillyMessage(message: any) {\n if (this.logger) {\n this.logger.silly(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogVerboseMessage(message: any) {\n if (this.logger) {\n this.logger.verbose(`${this.logPrefix}${message}`);\n }\n }\n\n protected LogHttpMessage(message: any) {\n if (this.logger) {\n this.logger.http(`${this.logPrefix}${message}`);\n }\n }\n\n // https://socket.io/docs/v4/middlewares/\n // https://socket.io/docs/v4/server-socket-instance/#sockethandshake\n // https://socket.io/docs/v4/server-socket-instance/#socket-middlewares\n // Use this middleward to check every incomming connection\n protected SetupConnectionMiddleware = () => { };\n\n // Use this middleware to check every packet being received\n protected SetupMessageMiddleware = (socket: STSServerSocket) => { };\n\n /*\n protected GetConfig = (socketIoServeroptions: ISocketIoServerOpitons): Partial<ServerOptions> => {\n //this.#redisClient = createClient({url: this.#options.ioRedisMessageProcessorUrl});\n //await this.#redisClient.connect();\n this.LogDebugMessage(`GetConfig() transports: [ [websocket] ]`);\n const options: Partial<ServerOptions> = {\n transports: [ \"websocket\" ], // or [ \"websocket\", \"polling\" ] (to use long-poolling. Note that the order matters)\n }\n\n if (socketIoServeroptions.ioRedisMessageProcessorUrl && socketIoServeroptions.ioRedisMessageProcessorUrl !== '') {\n this.redisClient = new Redis(socketIoServeroptions.ioRedisMessageProcessorUrl);\n this.LogDebugMessage(`GetConfig() createAdapter(redis): redis url: [${socketIoServeroptions.ioRedisMessageProcessorUrl}]`);\n options.adapter = createAdapter(this.redisClient) as any;\n } else if (socketIoServeroptions.serverClusterMode && socketIoServeroptions.serverClusterMode === true) {\n this.LogDebugMessage(`GetConfig() createAdapter(cluster)`);\n options.adapter = clusterCreateAdapter() as any;\n }\n\n if (socketIoServeroptions.wssCustomPath && socketIoServeroptions.wssCustomPath.localeCompare('') !== 0) {\n this.LogDebugMessage(`GetConfig() wssCustomPath: [${socketIoServeroptions.wssCustomPath}]`);\n options.path = socketIoServeroptions.wssCustomPath;\n }\n\n return options;\n }\n */\n\n protected SetEngineEvents = () => {\n if (this.io) {\n this.io.engine.on(\"connection_error\", (err) => {\n this.LogWarnMessage(`SetEngineEvents(): connection_error`); // the request object\n this.LogWarnMessage(err.req); // the request object\n this.LogWarnMessage(err.code); // the error code, for example 1\n this.LogWarnMessage(err.message); // the error message, for example \"Session ID unknown\"\n this.LogWarnMessage(err.context); // some additional error context\n });\n }\n }\n\n WithLogger = (logger: ISTSLogger) => {\n this.logger = logger;\n return this;\n }\n\n WithListenPort = (listenPort: number) => {\n this.listenPort = listenPort;\n return this;\n }\n\n WithSocketIoCustomPath = (socketIoCustomPath: string) => {\n this.socketIoCustomPath = socketIoCustomPath;\n return this;\n }\n\n WithIoRedisMessageProcessorUrl = (ioRedisMessageProcessorUrl: string) => {\n this.ioRedisMessageProcessorUrl = ioRedisMessageProcessorUrl;\n return this;\n }\n\n WithClusterMode = (serverClusterMode: boolean) => {\n this.serverClusterMode = serverClusterMode;\n return this;\n }\n\n WithRooms = (rooms: string[]) => {\n this.rooms = rooms;\n return this;\n }\n\n WithNamespace = (namespace: string) => {\n this.namespace = namespace;\n return this;\n }\n\n AttachSocketIoServer = async (server: Server): Promise<SocketIoServer<ClientToServerEvents, ServerToClientEvents>> => {\n if (!this.io) {\n this.LogInfoMessage(`AttachServer(): io = server`);\n this.io = server;\n\n this.LogInfoMessage(`AttachServer(): attached = true`);\n this.attached = true;\n\n this.LogInfoMessage(`AttachServer(): SetupNamespace()`);\n this.SetupNamespace();\n } else {\n const errorMessage = (this.attached === true ? `AttachServer(): Server already exists (from AttachServer())` : `AttachServer(): Server already exists (from StartServer())`);\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n return this;\n }\n\n StartSocketIoServer = async (): Promise<SocketIoServer<ClientToServerEvents, ServerToClientEvents>> => {\n //this.#io = require(\"socket.io\")(this.#httpServer, options);\n if (!this.namespace) {\n const errorMessage = `StartServer(): Error: [namespace not specified]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n\n if (!this.io) {\n if (!this.listenPort) {\n const errorMessage = `StartServer(): Error: [listenPort not specified]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n\n this.LogDebugMessage(`StartServer(): draining = false`);\n this.draining = false;\n\n this.LogDebugMessage(`StartServer(): transports: [ [websocket] ]`);\n const options: Partial<ServerOptions> = {\n transports: [ \"websocket\" ], // or [ \"websocket\", \"polling\" ] (to use long-poolling. Note that the order matters)\n }\n\n if (this.ioRedisMessageProcessorUrl && this.ioRedisMessageProcessorUrl !== '') {\n this.redisClient = new Redis(this.ioRedisMessageProcessorUrl);\n this.LogDebugMessage(`StartServer(): createAdapter(redis): redis url: [${this.ioRedisMessageProcessorUrl}]`);\n options.adapter = createAdapter(this.redisClient) as any;\n } else if (this.serverClusterMode && this.serverClusterMode === true) {\n this.LogDebugMessage(`StartServer(): createAdapter(cluster)`);\n options.adapter = clusterCreateAdapter() as any;\n }\n\n if (this.socketIoCustomPath && this.socketIoCustomPath.localeCompare('') !== 0) {\n this.LogDebugMessage(`StartServer(): socketIoCustomPath: [${this.socketIoCustomPath}]`);\n options.path = this.socketIoCustomPath;\n }\n\n this.LogDebugMessage(`StartServer(): new Server(): listenPort: [${this.listenPort}]`);\n this.io = new Server(this.listenPort, options);\n\n this.LogDebugMessage(`StartServer(): SetEngineEvents()`);\n this.SetEngineEvents();\n\n this.LogDebugMessage(`StartServer(): Sleeping ...`);\n await Sleep(500);\n this.LogDebugMessage(`StartServer(): Done Sleeping`);\n\n this.LogInfoMessage(`AttachServer(): attached = false`);\n this.attached = false;\n\n this.LogInfoMessage(`StartServer(): SetupNamespace()`);\n this.SetupNamespace();\n\n } else {\n const errorMessage = (this.attached === true ? `StartServer(): Server already exists (from AttachServer())` : `StartServer(): Server already exists (from StartServer())`);\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n return this;\n }\n\n DetachSockerIoServer = async (): Promise<void> => {\n if (this.io) {\n if (this.attached === true) {\n this.LogInfoMessage(`DetachServer(): StopNamespace()`);\n await this.StopNamespace();\n this.io = undefined;\n this.LogInfoMessage(`DetachServer(): attached = false`);\n this.attached = false;\n } else {\n const errorMessage = `DetachServer(): Error: [Server has not been attached. Use StopServer() to stop the socker.io server.]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n } else {\n const errorMessage = `DetachServer(): Error: [no server exists to DetachServer()]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n }\n\n StopSocketIoServer = async () => {\n if (this.io) {\n if (this.attached === false) {\n // We are now draining connections\n this.LogInfoMessage(`StopServer(): draining = true`);\n this.draining = true;\n\n this.LogInfoMessage(`StopServer(): StopNamespace()`);\n await this.StopNamespace();\n\n this.LogInfoMessage(`StopServer(): io.of('/').adapter.close()`);\n await this.io.of('/').adapter.close();\n\n if (this.redisClient) {\n this.LogInfoMessage(`StopServer(): redisClient.disconnect()`);\n await this.redisClient.disconnect();\n this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Sleeping...)`);\n await Sleep(50);\n this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Done Sleeping)`);\n }\n\n // boot all current connections\n this.LogInfoMessage(`StopServer(): io.disconnectSockets()`);\n this.io.disconnectSockets();\n\n // Stop any future connections, close this server (does not close the underlying http(s) server if io server via that method\n this.LogInfoMessage(`StopServer(): io.close()`);\n this.io.close();\n\n this.LogInfoMessage(`StopServer(): io = undefined`);\n this.io = undefined;\n } else {\n const errorMessage = `StopServer(): Cannot stop an attached server. The server created must handle stop/disconnections. Use StopNamespace() instead.`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n } else {\n const errorMessage = `StopServer(): Error: [no server exists to StopServer()]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n }\n\n LeaveRoom = (socket: STSServerSocket, room: string): void => {\n this.LogDebugMessage(`LeaveRoom(): Leaving room [${room}]`);\n socket.leave(room);\n };\n\n JoinRoom = (socket: STSServerSocket, room: string): void => {\n this.LogDebugMessage(`JoinRoom(): Socket joining room [${room}], ID: [${socket.id}]`);\n socket.join(room);\n };\n\n protected StopNamespace = async() => {\n this.LogInfoMessage(`StopServer(): CloseNamespaceAdaptors()`);\n await this.CloseNamespaceAdaptors();\n\n this.LogInfoMessage(`StopServer(): DisconnectNamespaceSockets()`);\n this.DisconnectNamespaceSockets();\n }\n\n protected SetupStandardEvents = (socket: STSServerSocket): void => {\n socket.on('disconnect', (reason: string) => {\n this.LogDebugMessage(`SetupStandardEvents(): socket disconnect, ID: [${socket.id}], reason: [${reason}]`);\n this.SocketDisconnect(socket, reason);\n });\n\n socket.on('disconnecting', (reason: string) => {\n this.LogDebugMessage(`SetupStandardEvents(): socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);\n this.SocketDisconnecting(socket, reason);\n });\n\n socket.on('error', (error: Error) => {\n this.LogDebugMessage(`SetupStandardEvents(): socket error, ID: [${socket.id}], Error: [${error}]`);\n this.SocketError(socket, error);\n });\n\n socket.on(\"__STSdisconnect\", (reason: string) => {\n this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnect: socket disconnect, ID: [${socket.id}], reason: [${reason}]`);\n });\n\n socket.on(\"__STSdisconnecting\", (reason, callBackResult) => {\n this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnecting: socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);\n callBackResult(\"__STSdisconnecting accepted by server.\");\n });\n\n socket.on('__STSjoinRoom', (rooms: string[]): void => { //@@ names\n rooms.forEach((room) => {\n this.LogDebugMessage(`SetupStandardEvents(): __STSjoinRoom: room: [${room}], socket: [${socket.id}]`);\n this.JoinRoom(socket, room)\n });\n });\n\n socket.on('__STSleaveRoom', (rooms: string[]): void => { //@@ names\n rooms.forEach((room) => {\n this.LogDebugMessage(`SetupStandardEvents(): __STSleaveRoom: room: [${room}], socket: [${socket.id}]`);\n this.LeaveRoom(socket, room);\n });\n });\n\n socket.on('__STSsendToRoom', (rooms: string[], payload: { command: string, payload: JSONObject }): void => {\n rooms.forEach((room) => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}], Command: [${payload.command}]`);\n this.socketionamespace.to(room).emit(payload.command as any, payload);\n }\n });\n });\n\n socket.on('__STSsendToRoomWithCallback', (room: string, timeout: number, payload: { command: string, payload: JSONObject }, cb: (data: JSONObject) => void): void => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);\n this.socketionamespace.to(room).timeout(timeout).emit(payload.command as any, payload, (err: Error, dataResponse: JSONObject[]) => {\n if (err) {\n console.error(err);\n const errorResponse = {\n error: true, \n errorName: err.name, \n errorMessage: err.message,\n //errorCause: err.cause,\n //errorStack: err.stack\n };\n this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`)\n cb(errorResponse);\n } else {\n this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`)\n cb(dataResponse);\n }\n });\n }\n });\n\n socket.on('__STSsendToRoomsWithCallback', (rooms: string[], timeout: number, payload: { command: string, payload: JSONObject }, cb: (data: JSONObject) => void): void => {\n const responses: any[] = [ ];\n\n const timeoutForComplete = setTimeout(() => {\n // for this timeout case, sent back the error response and the responses we have received so far ...\n responses.push({\n room: '',\n responses: {\n error: true,\n errorName: 'timeout',\n errorMessage: `__STSsendToRoomsWithCallback timeout: [${timeout}] before all responses received`\n }\n });\n cb(responses);\n }, timeout).unref();\n\n rooms.forEach((room) => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);\n this.socketionamespace.to(room).timeout(timeout).emit(payload.command as any, payload, (err: Error, dataResponse: JSONObject[]) => {\n if (err) {\n console.error(err);\n const errorResponse = {\n error: true, \n errorName: err.name, \n errorMessage: err.message,\n //errorCause: err.cause,\n //errorStack: err.stack\n };\n this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`)\n responses.push({\n room,\n responses: errorResponse\n });\n } else {\n this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`)\n responses.push({\n room,\n responses: dataResponse\n });\n }\n if (responses.length === rooms.length) {\n clearTimeout(timeoutForComplete);\n this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: All complete, Responses Count: [${responses.length}] Invoke call back(responses)`);\n cb(responses);\n }\n });\n }\n });\n });\n }\n\n protected ConnectionDrainingConnectionMiddleware = (): void => {\n if (this.socketionamespace) {\n this.socketionamespace.use((socket, next) => {\n if (this.draining === true) {\n next(new Error(`ConnectionDrainingConnectionMiddleware(): Error: [server connections draining (from a server disconnect)]`));\n } else {\n next();\n }\n });\n }\n }\n \n protected SetupNamespace = (): SocketIoServer<ClientToServerEvents, ServerToClientEvents> => {\n // Create STS Command Centre Client namespace\n if (this.io) {\n this.LogDebugMessage(`SetupNamespace(): socketionamespace = io.of('/${this.namespace}/'`);\n this.socketionamespace = this.io.of(`/${this.namespace}/`);\n\n this.LogDebugMessage(`SetupNamespace(): ConnectionDrainingConnectionMiddleware()`);\n this.ConnectionDrainingConnectionMiddleware();\n\n this.LogDebugMessage(`SetupNamespace(): SetupConnectionMiddleware()`);\n this.SetupConnectionMiddleware();\n\n this.socketionamespace.on(\"connection\", socket => {\n this.LogDebugMessage(`SetupNamespace(): Socket connected, ID: [${socket.id}]`);\n this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (auth): [${JSON.stringify(socket.handshake.auth)}]`);\n this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (host): [${JSON.stringify(socket.handshake.headers.host)}]`);\n this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (url): [${JSON.stringify(socket.handshake.url)}]`);\n this.LogDebugMessage(`SetupNamespace(): Authentication Handshake: [${JSON.stringify(socket.handshake)}]`);\n\n this.LogDebugMessage(`SetupNamespace(): SetupMessageMiddleware(): Socket: [${socket.id}]`);\n this.SetupMessageMiddleware(socket);\n\n if (this.rooms && this.rooms.length > 0) {\n this.rooms.map((room) => {\n this.LogDebugMessage(`SetupNamespace(): Joining Room: [${room}], Socket: [${socket.id}]`);\n this.JoinRoom(socket, room);\n });\n }\n\n this.LogDebugMessage(`SetupNamespace(): SetupStandardEvents: Socket: [${socket.id}]`);\n this.SetupStandardEvents(socket);\n\n setTimeout(() => {\n this.LogDebugMessage(`SetupNamespace(): SocketConnectCallBack(): Socket: [${socket.id}]`);\n this.SocketConnect(socket);\n }, 0);\n\n this.LogDebugMessage(`SetupNamespace(): SocketEventsCallBack(): Socket: [${socket.id}]`);\n this.SetupSocketEvents(socket);\n });\n } else {\n const errorMessage = `SetupNamespace(): Error: [No server attached]`;\n this.LogErrorMessage(errorMessage);\n throw new Error(errorMessage);\n }\n\n return this;\n }\n\n protected CloseNamespaceAdaptors = async (): Promise<void> => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`CloseNamespaceAdaptors(): this.socketionamespace.adapter.close()`);\n await this.socketionamespace.adapter.close();\n }\n }\n\n protected DisconnectNamespaceSockets = (): void => {\n if (this.socketionamespace) {\n this.LogDebugMessage(`DisconnectNamespaceSockets(): this.socketionamespace.disconnectSockets()`);\n this.socketionamespace.disconnectSockets();\n this.socketionamespace = undefined;\n }\n }\n}\n"],"names":["TinyEmitter","clusterCreateAdapter"],"mappings":";;;;;;AAuBO,MAAe,uBAAiJA,mBAAAA,YAAY;AAAA,EACrK;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAoB;AAAA,EACpB,WAAoB;AAAA,EAE9B,YAAY,YAAoB;AAC5B,UAAA;AACA,SAAK,aAAa;AAAA,EACtB;AAAA,EAYA,IAAc,YAAoB;AAC9B,QAAI,KAAK,WAAW;AAChB,aAAO,kBAAkB,KAAK,UAAU,IAAI,KAAK,SAAS;AAAA,IAC9D,OAAO;AACH,aAAO,kBAAkB,KAAK,UAAU;AAAA,IAC5C;AAAA,EACJ;AAAA,EAEU,gBAAgB,SAAc;AACpC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,MAAM,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IACnD;AAAA,EACJ;AAAA,EAEU,gBAAgB,SAAc;AACpC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,MAAM,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IACnD;AAAA,EACJ;AAAA,EAEU,eAAe,SAAc;AACnC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,KAAK,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IAClD;AAAA,EACJ;AAAA,EAEU,eAAe,SAAc;AACnC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,KAAK,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IAClD;AAAA,EACJ;AAAA,EAEU,gBAAgB,SAAc;AACpC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,MAAM,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IACnD;AAAA,EACJ;AAAA,EAEU,kBAAkB,SAAc;AACtC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,QAAQ,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IACrD;AAAA,EACJ;AAAA,EAEU,eAAe,SAAc;AACnC,QAAI,KAAK,QAAQ;AACb,WAAK,OAAO,KAAK,GAAG,KAAK,SAAS,GAAG,OAAO,EAAE;AAAA,IAClD;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA,EAMU,4BAA4B,MAAM;AAAA,EAAE;AAAA;AAAA,EAGpC,yBAAyB,CAAC,WAA4B;AAAA,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BxD,kBAAkB,MAAM;AAC9B,QAAI,KAAK,IAAI;AACT,WAAK,GAAG,OAAO,GAAG,oBAAoB,CAAC,QAAQ;AAC3C,aAAK,eAAe,qCAAqC;AACzD,aAAK,eAAe,IAAI,GAAG;AAC3B,aAAK,eAAe,IAAI,IAAI;AAC5B,aAAK,eAAe,IAAI,OAAO;AAC/B,aAAK,eAAe,IAAI,OAAO;AAAA,MACnC,CAAC;AAAA,IACL;AAAA,EACJ;AAAA,EAEA,aAAa,CAAC,WAAuB;AACjC,SAAK,SAAS;AACd,WAAO;AAAA,EACX;AAAA,EAEA,iBAAiB,CAAC,eAAuB;AACrC,SAAK,aAAa;AAClB,WAAO;AAAA,EACX;AAAA,EAEA,yBAAyB,CAAC,uBAA+B;AACrD,SAAK,qBAAqB;AAC1B,WAAO;AAAA,EACX;AAAA,EAEA,iCAAiC,CAAC,+BAAuC;AACrE,SAAK,6BAA6B;AAClC,WAAO;AAAA,EACX;AAAA,EAEA,kBAAkB,CAAC,sBAA+B;AAC9C,SAAK,oBAAoB;AACzB,WAAO;AAAA,EACX;AAAA,EAEA,YAAY,CAAC,UAAoB;AAC7B,SAAK,QAAQ;AACb,WAAO;AAAA,EACX;AAAA,EAEA,gBAAgB,CAAC,cAAsB;AACnC,SAAK,YAAY;AACjB,WAAO;AAAA,EACX;AAAA,EAEA,uBAAuB,OAAO,WAAwF;AAClH,QAAI,CAAC,KAAK,IAAI;AACV,WAAK,eAAe,6BAA6B;AACjD,WAAK,KAAK;AAEV,WAAK,eAAe,iCAAiC;AACrD,WAAK,WAAW;AAEhB,WAAK,eAAe,kCAAkC;AACtD,WAAK,eAAA;AAAA,IACT,OAAO;AACH,YAAM,eAAgB,KAAK,aAAa,OAAO,gEAAgE;AAC/G,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AACA,WAAO;AAAA,EACX;AAAA,EAEA,sBAAsB,YAAiF;AAEnG,QAAI,CAAC,KAAK,WAAW;AACjB,YAAM,eAAe;AACrB,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AAEA,QAAI,CAAC,KAAK,IAAI;AACV,UAAI,CAAC,KAAK,YAAY;AAClB,cAAM,eAAe;AACrB,aAAK,gBAAgB,YAAY;AACjC,cAAM,IAAI,MAAM,YAAY;AAAA,MAChC;AAEA,WAAK,gBAAgB,iCAAiC;AACtD,WAAK,WAAW;AAEhB,WAAK,gBAAgB,4CAA4C;AACjE,YAAM,UAAkC;AAAA,QACpC,YAAY,CAAE,WAAY;AAAA;AAAA,MAAA;AAG9B,UAAI,KAAK,8BAA8B,KAAK,+BAA+B,IAAI;AAC3E,aAAK,cAAc,IAAI,MAAM,KAAK,0BAA0B;AAC5D,aAAK,gBAAgB,oDAAoD,KAAK,0BAA0B,GAAG;AAC3G,gBAAQ,UAAU,cAAc,KAAK,WAAW;AAAA,MACpD,WAAW,KAAK,qBAAqB,KAAK,sBAAsB,MAAM;AAClE,aAAK,gBAAgB,uCAAuC;AAC5D,gBAAQ,UAAUC,gBAAA;AAAA,MACtB;AAEA,UAAI,KAAK,sBAAsB,KAAK,mBAAmB,cAAc,EAAE,MAAM,GAAG;AAC5E,aAAK,gBAAgB,uCAAuC,KAAK,kBAAkB,GAAG;AACtF,gBAAQ,OAAO,KAAK;AAAA,MACxB;AAEA,WAAK,gBAAgB,6CAA6C,KAAK,UAAU,GAAG;AACpF,WAAK,KAAK,IAAI,OAAO,KAAK,YAAY,OAAO;AAE7C,WAAK,gBAAgB,kCAAkC;AACvD,WAAK,gBAAA;AAEL,WAAK,gBAAgB,6BAA6B;AAClD,YAAM,MAAM,GAAG;AACf,WAAK,gBAAgB,8BAA8B;AAEnD,WAAK,eAAe,kCAAkC;AACtD,WAAK,WAAW;AAEhB,WAAK,eAAe,iCAAiC;AACrD,WAAK,eAAA;AAAA,IAET,OAAO;AACH,YAAM,eAAgB,KAAK,aAAa,OAAO,+DAA+D;AAC9G,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AACA,WAAO;AAAA,EACX;AAAA,EAEA,uBAAuB,YAA2B;AAC9C,QAAI,KAAK,IAAI;AACT,UAAI,KAAK,aAAa,MAAM;AACxB,aAAK,eAAe,iCAAiC;AACrD,cAAM,KAAK,cAAA;AACX,aAAK,KAAK;AACV,aAAK,eAAe,kCAAkC;AACtD,aAAK,WAAW;AAAA,MACpB,OAAO;AACH,cAAM,eAAe;AACrB,aAAK,gBAAgB,YAAY;AACjC,cAAM,IAAI,MAAM,YAAY;AAAA,MAChC;AAAA,IACJ,OAAO;AACH,YAAM,eAAe;AACrB,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AAAA,EACJ;AAAA,EAEA,qBAAqB,YAAY;AAC7B,QAAI,KAAK,IAAI;AACT,UAAI,KAAK,aAAa,OAAO;AAEzB,aAAK,eAAe,+BAA+B;AACnD,aAAK,WAAW;AAEhB,aAAK,eAAe,+BAA+B;AACnD,cAAM,KAAK,cAAA;AAEX,aAAK,eAAe,0CAA0C;AAC9D,cAAM,KAAK,GAAG,GAAG,GAAG,EAAE,QAAQ,MAAA;AAE9B,YAAI,KAAK,aAAa;AAClB,eAAK,eAAe,wCAAwC;AAC5D,gBAAM,KAAK,YAAY,WAAA;AACvB,eAAK,eAAe,sDAAsD;AAC1E,gBAAM,MAAM,EAAE;AACd,eAAK,eAAe,wDAAwD;AAAA,QAChF;AAGA,aAAK,eAAe,sCAAsC;AAC1D,aAAK,GAAG,kBAAA;AAGR,aAAK,eAAe,0BAA0B;AAC9C,aAAK,GAAG,MAAA;AAER,aAAK,eAAe,8BAA8B;AAClD,aAAK,KAAK;AAAA,MACd,OAAO;AACH,cAAM,eAAe;AACrB,aAAK,gBAAgB,YAAY;AACjC,cAAM,IAAI,MAAM,YAAY;AAAA,MAChC;AAAA,IACJ,OAAO;AACH,YAAM,eAAe;AACrB,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AAAA,EACJ;AAAA,EAEA,YAAY,CAAC,QAAyB,SAAuB;AACzD,SAAK,gBAAgB,8BAA8B,IAAI,GAAG;AAC1D,WAAO,MAAM,IAAI;AAAA,EACrB;AAAA,EAEA,WAAW,CAAC,QAAyB,SAAuB;AACxD,SAAK,gBAAgB,oCAAoC,IAAI,WAAW,OAAO,EAAE,GAAG;AACpF,WAAO,KAAK,IAAI;AAAA,EACpB;AAAA,EAEU,gBAAgB,YAAW;AACjC,SAAK,eAAe,wCAAwC;AAC5D,UAAM,KAAK,uBAAA;AAEX,SAAK,eAAe,4CAA4C;AAChE,SAAK,2BAAA;AAAA,EACT;AAAA,EAEU,sBAAsB,CAAC,WAAkC;AAC/D,WAAO,GAAG,cAAc,CAAC,WAAmB;AACxC,WAAK,gBAAgB,kDAAkD,OAAO,EAAE,eAAe,MAAM,GAAG;AACxG,WAAK,iBAAiB,QAAQ,MAAM;AAAA,IACxC,CAAC;AAED,WAAO,GAAG,iBAAiB,CAAC,WAAmB;AAC3C,WAAK,gBAAgB,qDAAqD,OAAO,EAAE,eAAe,MAAM,GAAG;AAC3G,WAAK,oBAAoB,QAAQ,MAAM;AAAA,IAC3C,CAAC;AAED,WAAO,GAAG,SAAS,CAAC,UAAiB;AACjC,WAAK,gBAAgB,6CAA6C,OAAO,EAAE,cAAc,KAAK,GAAG;AACjG,WAAK,YAAY,QAAQ,KAAK;AAAA,IAClC,CAAC;AAED,WAAO,GAAG,mBAAmB,CAAC,WAAmB;AAC7C,WAAK,gBAAgB,mEAAmE,OAAO,EAAE,eAAe,MAAM,GAAG;AAAA,IAC7H,CAAC;AAED,WAAO,GAAG,sBAAsB,CAAC,QAAQ,mBAAmB;AACxD,WAAK,gBAAgB,yEAAyE,OAAO,EAAE,eAAe,MAAM,GAAG;AAC/H,qBAAe,wCAAwC;AAAA,IAC3D,CAAC;AAED,WAAO,GAAG,iBAAiB,CAAC,UAA0B;AAClD,YAAM,QAAQ,CAAC,SAAS;AACpB,aAAK,gBAAgB,gDAAgD,IAAI,eAAe,OAAO,EAAE,GAAG;AACpG,aAAK,SAAS,QAAQ,IAAI;AAAA,MAC9B,CAAC;AAAA,IACL,CAAC;AAED,WAAO,GAAG,kBAAkB,CAAC,UAA0B;AACnD,YAAM,QAAQ,CAAC,SAAS;AACpB,aAAK,gBAAgB,iDAAiD,IAAI,eAAe,OAAO,EAAE,GAAG;AACrG,aAAK,UAAU,QAAQ,IAAI;AAAA,MAC/B,CAAC;AAAA,IACL,CAAC;AAED,WAAO,GAAG,mBAAmB,CAAC,OAAiB,YAA4D;AACvG,YAAM,QAAQ,CAAC,SAAS;AACpB,YAAI,KAAK,mBAAmB;AACxB,eAAK,gBAAgB,uEAAuE,IAAI,WAAW,OAAO,EAAE,gBAAgB,QAAQ,OAAO,GAAG;AACtJ,eAAK,kBAAkB,GAAG,IAAI,EAAE,KAAK,QAAQ,SAAgB,OAAO;AAAA,QACxE;AAAA,MACJ,CAAC;AAAA,IACL,CAAC;AAED,WAAO,GAAG,+BAA+B,CAAC,MAAc,SAAiB,SAAmD,OAAyC;AACjK,UAAI,KAAK,mBAAmB;AACxB,aAAK,gBAAgB,mFAAmF,IAAI,WAAW,OAAO,EAAE,gBAAgB,OAAO,gBAAgB,QAAQ,OAAO,GAAG;AACzL,aAAK,kBAAkB,GAAG,IAAI,EAAE,QAAQ,OAAO,EAAE,KAAK,QAAQ,SAAgB,SAAS,CAAC,KAAY,iBAA+B;AAC/H,cAAI,KAAK;AACL,oBAAQ,MAAM,GAAG;AACjB,kBAAM,gBAAgB;AAAA,cAClB,OAAO;AAAA,cACP,WAAW,IAAI;AAAA,cACf,cAAc,IAAI;AAAA;AAAA;AAAA,YAAA;AAItB,iBAAK,gBAAgB,0EAA0E,KAAK,UAAU,aAAa,CAAC,GAAG;AAC/H,eAAG,aAAa;AAAA,UACpB,OAAO;AACH,iBAAK,gBAAgB,kEAAkE,KAAK,UAAU,YAAY,CAAC,GAAG;AACtH,eAAG,YAAY;AAAA,UACnB;AAAA,QACJ,CAAC;AAAA,MACL;AAAA,IACJ,CAAC;AAED,WAAO,GAAG,gCAAgC,CAAC,OAAiB,SAAiB,SAAmD,OAAyC;AACrK,YAAM,YAAmB,CAAA;AAEzB,YAAM,qBAAqB,WAAW,MAAM;AAExC,kBAAU,KAAK;AAAA,UACX,MAAM;AAAA,UACN,WAAW;AAAA,YACP,OAAO;AAAA,YACP,WAAW;AAAA,YACX,cAAc,0CAA0C,OAAO;AAAA,UAAA;AAAA,QACnE,CACH;AACD,WAAG,SAAS;AAAA,MAChB,GAAG,OAAO,EAAE,MAAA;AAEZ,YAAM,QAAQ,CAAC,SAAS;AACpB,YAAI,KAAK,mBAAmB;AACxB,eAAK,gBAAgB,oFAAoF,IAAI,WAAW,OAAO,EAAE,gBAAgB,OAAO,gBAAgB,QAAQ,OAAO,GAAG;AAC1L,eAAK,kBAAkB,GAAG,IAAI,EAAE,QAAQ,OAAO,EAAE,KAAK,QAAQ,SAAgB,SAAS,CAAC,KAAY,iBAA+B;AAC/H,gBAAI,KAAK;AACL,sBAAQ,MAAM,GAAG;AACjB,oBAAM,gBAAgB;AAAA,gBAClB,OAAO;AAAA,gBACP,WAAW,IAAI;AAAA,gBACf,cAAc,IAAI;AAAA;AAAA;AAAA,cAAA;AAItB,mBAAK,gBAAgB,0EAA0E,KAAK,UAAU,aAAa,CAAC,GAAG;AAC/H,wBAAU,KAAK;AAAA,gBACX;AAAA,gBACA,WAAW;AAAA,cAAA,CACd;AAAA,YACL,OAAO;AACH,mBAAK,gBAAgB,kEAAkE,KAAK,UAAU,YAAY,CAAC,GAAG;AACtH,wBAAU,KAAK;AAAA,gBACX;AAAA,gBACA,WAAW;AAAA,cAAA,CACd;AAAA,YACL;AACA,gBAAI,UAAU,WAAW,MAAM,QAAQ;AACnC,2BAAa,kBAAkB;AAC/B,mBAAK,gBAAgB,mGAAmG,UAAU,MAAM,+BAA+B;AACvK,iBAAG,SAAS;AAAA,YAChB;AAAA,UACJ,CAAC;AAAA,QACL;AAAA,MACJ,CAAC;AAAA,IACL,CAAC;AAAA,EACL;AAAA,EAEU,yCAAyC,MAAY;AAC3D,QAAI,KAAK,mBAAmB;AACxB,WAAK,kBAAkB,IAAI,CAAC,QAAQ,SAAS;AACzC,YAAI,KAAK,aAAa,MAAM;AACxB,eAAK,IAAI,MAAM,2GAA2G,CAAC;AAAA,QAC/H,OAAO;AACH,eAAA;AAAA,QACJ;AAAA,MACJ,CAAC;AAAA,IACL;AAAA,EACJ;AAAA,EAEU,iBAAiB,MAAkE;AAEzF,QAAI,KAAK,IAAI;AACT,WAAK,gBAAgB,iDAAiD,KAAK,SAAS,IAAI;AACxF,WAAK,oBAAoB,KAAK,GAAG,GAAG,IAAI,KAAK,SAAS,GAAG;AAEzD,WAAK,gBAAgB,4DAA4D;AACjF,WAAK,uCAAA;AAEL,WAAK,gBAAgB,+CAA+C;AACpE,WAAK,0BAAA;AAEL,WAAK,kBAAkB,GAAG,cAAc,CAAA,WAAU;AAC9C,aAAK,gBAAgB,4CAA4C,OAAO,EAAE,GAAG;AAC7E,aAAK,gBAAgB,uDAAuD,KAAK,UAAU,OAAO,UAAU,IAAI,CAAC,GAAG;AACpH,aAAK,gBAAgB,uDAAuD,KAAK,UAAU,OAAO,UAAU,QAAQ,IAAI,CAAC,GAAG;AAC5H,aAAK,gBAAgB,sDAAsD,KAAK,UAAU,OAAO,UAAU,GAAG,CAAC,GAAG;AAClH,aAAK,gBAAgB,gDAAgD,KAAK,UAAU,OAAO,SAAS,CAAC,GAAG;AAExG,aAAK,gBAAgB,wDAAwD,OAAO,EAAE,GAAG;AACzF,aAAK,uBAAuB,MAAM;AAElC,YAAI,KAAK,SAAS,KAAK,MAAM,SAAS,GAAG;AACrC,eAAK,MAAM,IAAI,CAAC,SAAS;AACrB,iBAAK,gBAAgB,oCAAoC,IAAI,eAAe,OAAO,EAAE,GAAG;AACxF,iBAAK,SAAS,QAAQ,IAAI;AAAA,UAC9B,CAAC;AAAA,QACL;AAEA,aAAK,gBAAgB,mDAAmD,OAAO,EAAE,GAAG;AACpF,aAAK,oBAAoB,MAAM;AAE/B,mBAAW,MAAM;AACb,eAAK,gBAAgB,uDAAuD,OAAO,EAAE,GAAG;AACxF,eAAK,cAAc,MAAM;AAAA,QAC7B,GAAG,CAAC;AAEJ,aAAK,gBAAgB,sDAAsD,OAAO,EAAE,GAAG;AACvF,aAAK,kBAAkB,MAAM;AAAA,MACjC,CAAC;AAAA,IACL,OAAO;AACH,YAAM,eAAe;AACrB,WAAK,gBAAgB,YAAY;AACjC,YAAM,IAAI,MAAM,YAAY;AAAA,IAChC;AAEA,WAAO;AAAA,EACX;AAAA,EAEU,yBAAyB,YAA2B;AAC1D,QAAI,KAAK,mBAAmB;AACxB,WAAK,gBAAgB,kEAAkE;AACvF,YAAM,KAAK,kBAAkB,QAAQ,MAAA;AAAA,IACzC;AAAA,EACJ;AAAA,EAEU,6BAA6B,MAAY;AAC/C,QAAI,KAAK,mBAAmB;AACxB,WAAK,gBAAgB,0EAA0E;AAC/F,WAAK,kBAAkB,kBAAA;AACvB,WAAK,oBAAoB;AAAA,IAC7B;AAAA,EACJ;AACJ;"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nsshunt/stssocketioutils",
3
- "version": "2.0.20",
3
+ "version": "2.0.22",
4
4
  "description": "STS Socket.IO Utils",
5
5
  "type": "commonjs",
6
6
  "main": "./dist/index.cjs",
@@ -24,8 +24,13 @@ export declare abstract class SocketIoClient<ServerToClientEvents extends STSDef
24
24
  WithAgentManager(agentManager: AgentManager): this;
25
25
  WithReconnectTimeout(reconnectTimeout: number): this;
26
26
  SetupSocket(): this;
27
- protected ConnectCallBack(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;
28
- protected SocketEventsCallBack(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;
29
- protected ErrorCallBack(error: Error): void;
27
+ protected abstract SocketConnect(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;
28
+ protected abstract SetupSocketEvents(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;
29
+ protected abstract SocketConnectError(error: Error): void;
30
+ protected abstract SocketDisconnect(reason: string): void;
31
+ protected EngineError(error: Error): void;
32
+ protected EngineReconnectError(error: Error): void;
33
+ protected EngineConnectError(error: Error): void;
34
+ protected EngineReconnect(attempt: number): void;
30
35
  }
31
36
  //# sourceMappingURL=socketIoClient.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"socketIoClient.d.ts","sourceRoot":"","sources":["../src/socketIoClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAK5E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAE5D,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAA;AAE9F,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,8BAAsB,cAAc,CAAC,oBAAoB,SAAS,8BAA8B,EAAE,oBAAoB,SAAS,8BAA8B,CAAE,SAAQ,WAAW;;gBAUlK,IAAI,EAAE,MAAM;IAKxB,SAAS,KAAK,SAAS,IAAI,MAAM,CAEhC;IAGD,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAK7C,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAK7C,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAI/C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,IAAI,YAAY,IAAI,YAAY,GAAG,SAAS,CAE3C;IAED,IAAI,MAAM,IAAI,UAAU,GAAG,SAAS,CAEnC;IAED,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAEhC;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,IAAI,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAE3C;IAED,IAAI,MAAM,IAAI,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,SAAS,CAE3E;IAED,WAAW,CAAC,OAAO,EAAE,MAAM;IAK3B,aAAa,CAAC,SAAS,EAAE,MAAM;IAK/B,sBAAsB,CAAC,kBAAkB,EAAE,MAAM;IAKjD,UAAU,CAAC,MAAM,EAAE,UAAU;IAK7B,gBAAgB,CAAC,YAAY,EAAE,YAAY;IAK3C,oBAAoB,CAAC,gBAAgB,EAAE,MAAM;IAK7C,WAAW;IAWX,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,IAAI;IAE3F,SAAS,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,IAAI;IAEhG,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;CA6J9C"}
1
+ {"version":3,"file":"socketIoClient.d.ts","sourceRoot":"","sources":["../src/socketIoClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAK5E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAE5D,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAA;AAE9F,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,8BAAsB,cAAc,CAAC,oBAAoB,SAAS,8BAA8B,EAAE,oBAAoB,SAAS,8BAA8B,CAAE,SAAQ,WAAW;;gBAUlK,IAAI,EAAE,MAAM;IAKxB,SAAS,KAAK,SAAS,IAAI,MAAM,CAEhC;IAGD,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAK7C,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAK7C,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAI/C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,IAAI,YAAY,IAAI,YAAY,GAAG,SAAS,CAE3C;IAED,IAAI,MAAM,IAAI,UAAU,GAAG,SAAS,CAEnC;IAED,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAEhC;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,IAAI,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAE3C;IAED,IAAI,MAAM,IAAI,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,SAAS,CAE3E;IAED,WAAW,CAAC,OAAO,EAAE,MAAM;IAK3B,aAAa,CAAC,SAAS,EAAE,MAAM;IAK/B,sBAAsB,CAAC,kBAAkB,EAAE,MAAM;IAKjD,UAAU,CAAC,MAAM,EAAE,UAAU;IAK7B,gBAAgB,CAAC,YAAY,EAAE,YAAY;IAK3C,oBAAoB,CAAC,gBAAgB,EAAE,MAAM;IAK7C,WAAW;IAWX,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,IAAI;IAElG,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,IAAI;IAEtG,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAEzD,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIzD,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAEzC,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAElD,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAEhD,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAkKnD"}
@@ -8,8 +8,9 @@ export declare class SocketIoClientInstance extends SocketIoClient<ServerToClien
8
8
  unsubscribeAckCount: number;
9
9
  subscribeKeepAliveAckCount: number;
10
10
  doneAckCount: number;
11
- protected ConnectCallBack(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;
12
- protected ErrorCallBack(error: Error): void;
13
- protected SocketEventsCallBack(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;
11
+ protected SocketConnect(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;
12
+ protected SocketConnectError(error: Error): void;
13
+ protected SocketDisconnect(reason: string): void;
14
+ protected SetupSocketEvents(socket: Socket<ServerToClientEvents, ClientToServerEvents>): void;
14
15
  }
15
16
  //# sourceMappingURL=socketIoClientInstance.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"socketIoClientInstance.d.ts","sourceRoot":"","sources":["../src/socketIoClientInstance.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEvE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAEzC,qBAAa,sBAAuB,SAAQ,cAAc,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;gBACtF,UAAU,EAAE,MAAM;IAI9B,YAAY,SAAK;IACjB,iBAAiB,SAAK;IACtB,mBAAmB,SAAK;IACxB,0BAA0B,SAAK;IAC/B,YAAY,SAAK;IAGjB,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,IAAI;IAM3F,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI3C,SAAS,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,IAAI;CA6CnG"}
1
+ {"version":3,"file":"socketIoClientInstance.d.ts","sourceRoot":"","sources":["../src/socketIoClientInstance.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEvE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAEzC,qBAAa,sBAAuB,SAAQ,cAAc,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;gBACtF,UAAU,EAAE,MAAM;IAI9B,YAAY,SAAK;IACjB,iBAAiB,SAAK;IACtB,mBAAmB,SAAK;IACxB,0BAA0B,SAAK;IAC/B,YAAY,SAAK;IAGjB,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,IAAI;IAMzF,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAIhD,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIhD,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,IAAI;CA6ChG"}
@@ -24,9 +24,11 @@ export declare abstract class SocketIoServer<ClientToServerEvents extends STSDef
24
24
  protected draining: boolean;
25
25
  protected attached: boolean;
26
26
  constructor(serverName: string);
27
- protected SocketDisconnectCallBack: (socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string) => void;
28
- protected SocketDisconnectingCallBack: (socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string) => void;
29
- protected SocketErrorCallBack: (socket: Socket<ClientToServerEvents, ServerToClientEvents>, error: Error) => void;
27
+ protected abstract SocketDisconnect(socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void;
28
+ protected abstract SocketDisconnecting(socket: Socket<ClientToServerEvents, ServerToClientEvents>, reason: string): void;
29
+ protected abstract SocketError(socket: Socket<ClientToServerEvents, ServerToClientEvents>, error: Error): void;
30
+ protected abstract SocketConnect(socket: Socket<ClientToServerEvents, ServerToClientEvents>): void;
31
+ protected abstract SetupSocketEvents(socket: Socket<ClientToServerEvents, ServerToClientEvents>): void;
30
32
  protected get logPrefix(): string;
31
33
  protected LogErrorMessage(message: any): void;
32
34
  protected LogDebugMessage(message: any): void;
@@ -37,8 +39,6 @@ export declare abstract class SocketIoServer<ClientToServerEvents extends STSDef
37
39
  protected LogHttpMessage(message: any): void;
38
40
  protected SetupConnectionMiddleware: () => void;
39
41
  protected SetupMessageMiddleware: (socket: STSServerSocket) => void;
40
- protected SocketConnectCallBack: (socket: Socket<ClientToServerEvents, ServerToClientEvents>) => void;
41
- protected SocketEventsCallBack: (socket: Socket<ClientToServerEvents, ServerToClientEvents>) => void;
42
42
  protected SetEngineEvents: () => void;
43
43
  WithLogger: (logger: ISTSLogger) => this;
44
44
  WithListenPort: (listenPort: number) => this;
@@ -1 +1 @@
1
- {"version":3,"file":"socketIoServer.d.ts","sourceRoot":"","sources":["../src/socketIoServer.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"socketIoServer.d.ts","sourceRoot":"","sources":["../src/socketIoServer.ts"],"names":[],"mappings":"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"}
@@ -1,11 +1,14 @@
1
- import { Socket } from 'socket.io';
1
+ import { Socket, DefaultEventsMap } from 'socket.io';
2
2
  import { SocketIoServer } from './socketIoServer';
3
3
  import { STSServerSocket } from './commonTypes';
4
4
  import { ServerToClientEvents, ClientToServerEvents } from './wsevents';
5
5
  export declare class SocketIoServerInstance extends SocketIoServer<ClientToServerEvents, ServerToClientEvents> {
6
6
  constructor();
7
- protected SocketConnectCallBack: (socket: Socket<ClientToServerEvents, ServerToClientEvents>) => void;
8
- protected SocketEventsCallBack: (socket: Socket<ClientToServerEvents, ServerToClientEvents>) => void;
7
+ protected SocketConnect: (socket: Socket<ClientToServerEvents, ServerToClientEvents>) => void;
8
+ protected SocketDisconnect(socket: Socket<ClientToServerEvents, ServerToClientEvents, DefaultEventsMap, any>, reason: string): void;
9
+ protected SocketDisconnecting(socket: Socket<ClientToServerEvents, ServerToClientEvents, DefaultEventsMap, any>, reason: string): void;
10
+ protected SocketError(socket: Socket<ClientToServerEvents, ServerToClientEvents, DefaultEventsMap, any>, error: Error): void;
11
+ protected SetupSocketEvents: (socket: Socket<ClientToServerEvents, ServerToClientEvents>) => void;
9
12
  protected SetupConnectionMiddleware: () => void;
10
13
  protected SetupMessageMiddleware: (socket: STSServerSocket) => void;
11
14
  }
@@ -1 +1 @@
1
- {"version":3,"file":"socketIoServerInstance.d.ts","sourceRoot":"","sources":["../src/socketIoServerInstance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAa,MAAM,WAAW,CAAA;AAM7C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,EAAqB,eAAe,EAAE,MAAM,eAAe,CAAA;AAElE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAIvE,qBAAa,sBAAuB,SAAQ,cAAc,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;;IAKlG,SAAS,CAAC,qBAAqB,GAAI,QAAQ,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,KAAG,IAAI,CAUnG;IAED,SAAS,CAAC,oBAAoB,GAAI,QAAQ,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,KAAG,IAAI,CA2ClG;IAED,SAAS,CAAC,yBAAyB,QAAO,IAAI,CAqB7C;IAED,SAAS,CAAC,sBAAsB,GAAI,QAAQ,eAAe,KAAG,IAAI,CAWjE;CACJ"}
1
+ {"version":3,"file":"socketIoServerInstance.d.ts","sourceRoot":"","sources":["../src/socketIoServerInstance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAa,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAM/D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,EAAqB,eAAe,EAAE,MAAM,eAAe,CAAA;AAElE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAIvE,qBAAa,sBAAuB,SAAQ,cAAc,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;;IAKlG,SAAS,CAAC,aAAa,GAAI,QAAQ,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,KAAG,IAAI,CAU3F;IAED,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAInI,SAAS,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAItI,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAI5H,SAAS,CAAC,iBAAiB,GAAI,QAAQ,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,KAAG,IAAI,CA2C/F;IAED,SAAS,CAAC,yBAAyB,QAAO,IAAI,CAqB7C;IAED,SAAS,CAAC,sBAAsB,GAAI,QAAQ,eAAe,KAAG,IAAI,CAWjE;CACJ"}