@nsshunt/stssocketioutils 2.0.16 → 2.0.17
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 +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.mjs +1 -1
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
package/dist/index.cjs
CHANGED
package/dist/index.cjs.map
CHANGED
|
@@ -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 = 1500; // 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 // 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]}
|
package/dist/index.mjs
CHANGED
package/dist/index.mjs.map
CHANGED
|
@@ -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 = 1500; // 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 // 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]}
|