@nsshunt/stssocketioutils 1.1.6 → 1.1.7
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/stssocketioutils.mjs +12 -16
- package/dist/stssocketioutils.mjs.map +1 -1
- package/dist/stssocketioutils.umd.js +14 -17
- package/dist/stssocketioutils.umd.js.map +1 -1
- package/package.json +4 -4
- package/types/socketIoClientHelper.d.ts +2 -9
- package/types/socketIoClientHelper.d.ts.map +1 -1
|
@@ -9,9 +9,8 @@ var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read fr
|
|
|
9
9
|
var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
|
|
10
10
|
var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
|
|
11
11
|
var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
|
|
12
|
-
var _options, _sockets,
|
|
12
|
+
var _options, _sockets, _SocketIoClientHelper_instances, LogDebugMessage_fn, LogErrorMessage_fn, EstablishSocketConnect_fn, _socketIoServerHelperOptions, _namespace, _SetupStandardEvents, _SetupConnectionMiddleware, _SetupMessageMiddleware;
|
|
13
13
|
import { io } from "socket.io-client";
|
|
14
|
-
import { AgentManager } from "@nsshunt/stsconfig";
|
|
15
14
|
var STSNamespace = /* @__PURE__ */ ((STSNamespace2) => {
|
|
16
15
|
STSNamespace2["STSMonitor"] = "stsinstrumentmanager/stsmonitor";
|
|
17
16
|
STSNamespace2["STSControl"] = "stsinstrumentmanager/stscontrol";
|
|
@@ -48,13 +47,7 @@ class SocketIoClientHelper {
|
|
|
48
47
|
__privateAdd(this, _SocketIoClientHelper_instances);
|
|
49
48
|
__privateAdd(this, _options);
|
|
50
49
|
__privateAdd(this, _sockets, {});
|
|
51
|
-
__privateAdd(this, _agentManager, null);
|
|
52
50
|
__privateSet(this, _options, options);
|
|
53
|
-
if (isNode) {
|
|
54
|
-
__privateSet(this, _agentManager, new AgentManager({
|
|
55
|
-
agentOptions: __privateGet(this, _options).agentOptions
|
|
56
|
-
}));
|
|
57
|
-
}
|
|
58
51
|
}
|
|
59
52
|
get sockets() {
|
|
60
53
|
return __privateGet(this, _sockets);
|
|
@@ -78,7 +71,6 @@ class SocketIoClientHelper {
|
|
|
78
71
|
}
|
|
79
72
|
_options = new WeakMap();
|
|
80
73
|
_sockets = new WeakMap();
|
|
81
|
-
_agentManager = new WeakMap();
|
|
82
74
|
_SocketIoClientHelper_instances = new WeakSet();
|
|
83
75
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
84
76
|
LogDebugMessage_fn = function(message) {
|
|
@@ -89,7 +81,6 @@ LogErrorMessage_fn = function(message) {
|
|
|
89
81
|
if (__privateGet(this, _options).logger) __privateGet(this, _options).logger.error(message);
|
|
90
82
|
};
|
|
91
83
|
EstablishSocketConnect_fn = function(name, onConnectCallBack, socketEventsCallBack) {
|
|
92
|
-
var _a;
|
|
93
84
|
const socketDetail = this.sockets[name];
|
|
94
85
|
if (socketDetail.socket !== null) {
|
|
95
86
|
if (socketDetail.socket.connected === true) {
|
|
@@ -106,10 +97,11 @@ EstablishSocketConnect_fn = function(name, onConnectCallBack, socketEventsCallBa
|
|
|
106
97
|
let socketOptions;
|
|
107
98
|
if (isNode) {
|
|
108
99
|
socketOptions = {
|
|
109
|
-
transports: ["websocket"]
|
|
110
|
-
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
111
|
-
agent: (_a = __privateGet(this, _agentManager)) == null ? void 0 : _a.GetAgent(socketDetail.address)
|
|
100
|
+
transports: ["websocket"]
|
|
112
101
|
};
|
|
102
|
+
if (__privateGet(this, _options).agentManager) {
|
|
103
|
+
socketOptions.agent = __privateGet(this, _options).agentManager.GetAgent(socketDetail.address);
|
|
104
|
+
}
|
|
113
105
|
} else {
|
|
114
106
|
socketOptions = {
|
|
115
107
|
transports: ["websocket"]
|
|
@@ -134,7 +126,7 @@ EstablishSocketConnect_fn = function(name, onConnectCallBack, socketEventsCallBa
|
|
|
134
126
|
}
|
|
135
127
|
});
|
|
136
128
|
socketDetail.socket.on("disconnect", (reason) => {
|
|
137
|
-
var
|
|
129
|
+
var _a;
|
|
138
130
|
__privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, "socket disconnect: " + reason);
|
|
139
131
|
switch (reason) {
|
|
140
132
|
case "io server disconnect":
|
|
@@ -144,7 +136,9 @@ EstablishSocketConnect_fn = function(name, onConnectCallBack, socketEventsCallBa
|
|
|
144
136
|
const socketDetail2 = this.sockets[name];
|
|
145
137
|
socketDetail2.socket = null;
|
|
146
138
|
if (isNode) {
|
|
147
|
-
(
|
|
139
|
+
if (__privateGet(this, _options).agentManager) {
|
|
140
|
+
__privateGet(this, _options).agentManager.ResetAgent();
|
|
141
|
+
}
|
|
148
142
|
setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100).unref();
|
|
149
143
|
} else {
|
|
150
144
|
setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100);
|
|
@@ -167,7 +161,9 @@ EstablishSocketConnect_fn = function(name, onConnectCallBack, socketEventsCallBa
|
|
|
167
161
|
}
|
|
168
162
|
socketDetail2.socket = null;
|
|
169
163
|
if (isNode) {
|
|
170
|
-
(
|
|
164
|
+
if (__privateGet(this, _options).agentManager) {
|
|
165
|
+
(_a = __privateGet(this, _options).agentManager) == null ? void 0 : _a.ResetAgent();
|
|
166
|
+
}
|
|
171
167
|
setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100).unref();
|
|
172
168
|
} else {
|
|
173
169
|
setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"stssocketioutils.mjs","sources":["../src/commonTypes.ts","../node_modules/detect-node/index.esm.js","../src/socketIoClientHelper.ts","../src/socketIoServerHelper.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */ // --> OFF\nimport { Server, Socket, Namespace } from \"socket.io\";\nimport { ISTSLogger } from '@nsshunt/stsutils'\n\nexport interface STSDefaultClientToServerEvents {\n /**\n * Join the room(s) specified for this client.\n * @param room The room(s) to join for this client.\n * @returns \n */\n\t__STSjoinRoom: (room: string[]) => void;\n\n /**\n * Remove this client from the specified room(s).\n * @param room The room(s) to remove the client from within the server.\n * @returns \n */\n\t__STSleaveRoom: (room: string[]) => void;\n\n /**\n * Alerts the server that this client has flagged to disconnect. Allows server to perform clean-up if required. The server must call-back with the result of the disconnecting event.\n * @param reason Reason for the disconnecting event.\n * @param callback The server must call-back with the result of the disconnecting event.\n * @returns \n */\n\t__STSdisconnecting: (reason: string, callback: (data: string) => void) => void;\n\n /**\n * Alerts the server to disconnect this client.\n * @param reason Reason for the disconnect event.\n * @returns \n */\n\t__STSdisconnect: (reason: string) => void; // server and client event\n\n /**\n * Send a payload of data to 1 or more rooms registered on the server.\n * @param rooms Room array for broadcasting.\n * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n * interface that extends STSServerToClientEvents.\n * @returns \n */\n \n\t__STSsendToRoom: (rooms: string[], payload: { command: string, payload: any }) => void;\n}\n\nexport interface STSDefaultServerToClientEvents {\n /**\n * The server may emit an unsolicited disconnect event to flag that all clients should disconnect. Most likely becuase the server may be shutting down.\n * @param reason Reason why the server is emitting this disconnect event.\n * @returns \n */\n\t__STSdisconnect: (reason: string) => void;\n}\n\nexport interface ISocketIoServerHelperOptions {\n logger: ISTSLogger\n}\n\nexport type ServerEventCb = (socket: any, data: any) => void\n\nexport interface ServerSocketEvent {\n\tserverEventName: string,\n\tserverEventCb: ServerEventCb\n}\n\nexport enum STSNamespace {\n\tSTSMonitor = 'stsinstrumentmanager/stsmonitor',\n\tSTSControl = 'stsinstrumentmanager/stscontrol',\n STSTestingNamespace = 'ststestingnamespace/ststesting'\n}\n\nexport enum STSRoom {\n\t// STSMonitor rooms\n\tSTSInstrumentDataRoom = 'stsinstrumentdataroom', // This room is for all instrument data messages\n\tSTSInstrumentDataSubscriptionRoom = 'stsinstrumentdatasubscriptionroom', // This room is only for subscribed instrument data messages\n\n\t// STSControl rooms\n\tSTSRunnerRoom = 'stsrunnerroom',\n\tSTSNodeRunnerRoom = 'stsnoderunnerroom'\n}\n\nexport enum STSEvent {\n\t// STSInstrumentData\n\tSTSInstrumentData = 'stsinstrumentdata',\n\tSTSSubInstrumentData = 'stssubinstrumentdata', // sub-scribed instrument data. This only outputs the nodes that have been subscribed by the client(s).\n\tSTSResetInstrumentData = 'stsresetinstrumentdata',\n\n\tSTSStartLoggingInstrumentData = 'stsStartLoggingInstrumentData',\n\tSTSStopLoggingInstrumentData = 'stsStopLoggingInstrumentData',\n\n\t// STSRunner events\n\tSTSStart = 'stsstart', // Start a test run with options as payload.\n\tSTSStop = 'stsstop', // Stop test run(s).\n\tSTSPause = 'stspause', // Pause test run(s).\n\tSTSResume = 'stsresume', // Resume test run(s).\n\tSTSTerminate = 'ststerminate', // Terminate runner instances and exit applications.\n\t// This may also be uysed to force trigger self healing (i.e. auto re-start) when\n\t// running within a container orchestrator such as K8, K3 or Docker Swarm.\n\tSTSUpdateStaticConfig = 'stsupdatestaticconfig', // Update base configuration. Options as payload.\n\tSTSUpdateDynamicConfig = 'stsupdatedynamicconfig', // Update running configuration. This is used\n\t// to control the runnning behaviour of test(s) in-flight. Options as payload.\n\n\tSTSSendToRoom = 'sendToRoom',\n\n\t// Standard socket events\n\tconnect = 'connect'\n}\n\n// https://socket.io/docs/v4/typescript/\n\nexport interface InterServerEvents {\n\tping: () => void;\n}\n\nexport interface STSSocketIONamespace {\n\tnamespace: string\n\tpid: number\n\tsocketionamespace: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n}\n\nexport type STSSocketIONamespaces = Record<string, STSSocketIONamespace>;\n\nexport type STSServerSocket = Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\nexport type STSClientSocket = Socket<STSDefaultServerToClientEvents, STSDefaultClientToServerEvents, InterServerEvents>\n\nexport interface ISocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents>\n{\n LogMessage: (namespace: STSSocketIONamespace, message: string) => void\n LeaveRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void\n JoinRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void\n SetupNamespace: (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, \n /* serverSocketEvents: ServerSocketEvent[], */\n socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null,\n socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null\n ) => Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>\n GetSTSSocketIONamespace: (namespace: any) => STSSocketIONamespace\n GetSTSSocketIONamespaces: () => STSSocketIONamespaces\n DisconnectSockets: () => void\n SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\n CloseAdaptors: () => Promise<void>\n}\n","// Only Node.JS has a process variable that is of [[Class]] process\nexport default Object.prototype.toString.call(typeof process !== 'undefined' ? process : 0) === '[object process]';\n","import { io, SocketOptions, ManagerOptions, Socket } from 'socket.io-client'\n\nimport isNode from 'detect-node';\n\nimport { ISTSLogger } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes'\nimport { AgentManager } from '@nsshunt/stsconfig';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type EventCb = (socket: any, data: any) => void\n\n/*\nSocket.io - Reserved events\nOn each side, the following events are reserved and should not be used as event names by your application:\nconnect\nconnect_error\ndisconnect\ndisconnecting\nnewListener\nremoveListener\n*/\n\n/*\nexport interface EventsMap { // From the socket.io library - was not declared as external\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n [event: string]: any;\n}\n*/\n\nexport interface ISocketDetail {\n\tname: string,\n\taddress: string,\n \n\tsocket: Socket | null\n errorCallBack: (error: Error) => void\n}\n\nexport interface ISocketIoClientHelperOptions\n{\n url?: string\n agentOptions?: {\n\t\tkeepAlive: boolean,\n\t\tmaxSockets: number\n\t\tmaxTotalSockets: number,\n\t\tmaxFreeSockets: number,\n\t\ttimeout: number,\n\t\trejectUnauthorized: boolean // Allows self signed certs in non production mode(s)\n\t}\n logger?: ISTSLogger\n}\n\nexport class SocketIoClientHelper<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents>\n{\n #options: ISocketIoClientHelperOptions\n #sockets: Record<string, ISocketDetail> = { }\n #agentManager: AgentManager | null = null;\n\n constructor(options: ISocketIoClientHelperOptions) {\n this.#options = options;\n if (isNode) {\n this.#agentManager = new AgentManager({\n agentOptions: this.#options.agentOptions\n });\n }\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n #LogDebugMessage(message: any): void {\n if (this.#options.logger) this.#options.logger.debug(message);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n #LogErrorMessage(message: any): void {\n if (this.#options.logger) this.#options.logger.error(message);\n }\n\n get sockets(): Record<string, ISocketDetail> {\n return this.#sockets;\n }\n \n SetupClientSideSocket(name: string, address: string, \n onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n errorCallBack: ((error: Error) => void)\n ): Socket<ServerToClientEvents, ClientToServerEvents> {\n this.sockets[name] = {\n name,\n address,\n socket: null,\n errorCallBack\n }\n this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack);\n return this.sockets[name].socket as Socket<ServerToClientEvents, ClientToServerEvents>\n }\n\n GetSocket(name: string): Socket<ServerToClientEvents, ClientToServerEvents> {\n return this.sockets[name].socket as Socket<ServerToClientEvents, ClientToServerEvents>\n }\n\n GetSocketDetail(name: string): ISocketDetail {\n return this.sockets[name];\n }\n\n #EstablishSocketConnect(name: string, onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null): void\n {\n const socketDetail: ISocketDetail = this.sockets[name];\n\n if (socketDetail.socket !== null) {\n // We already have a socket object (may or may not be connected)\n if (socketDetail.socket.connected === true) {\n socketDetail.socket.disconnect();\n }\n socketDetail.socket = null;\n if (isNode) {\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n }\n return;\n }\n\n let socketOptions: Partial<SocketOptions & ManagerOptions>;\n if (isNode) {\n // https://socket.io/docs/v4/client-options/#reconnection\n // https://github.com/socketio/engine.io-client#methods\n socketOptions = {\n transports: [\"websocket\" ],\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n agent: this.#agentManager?.GetAgent(socketDetail.address) as any\n }\n // This also works for self signed certs\n //rejectUnauthorized: goptions.isProduction // Allows self signed certs in non production mode(s)\n\n //reconnection: true\n //auth: {\n //\ttoken: \"abcd\"\n //}\n //,path: '/zzz'\n } else {\n socketOptions = {\n transports: [\"websocket\" ]\n }\n }\n socketDetail.socket = io(socketDetail.address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n socketDetail.socket.on(\"connect\", () => {\n if (socketDetail.socket) {\n this.#LogDebugMessage(`Socket: [${socketDetail.socket.id}]: connected`);\n\n if (onConnectCallBack) {\n setTimeout(() => {\n onConnectCallBack(socketDetail.socket as Socket<ServerToClientEvents, ClientToServerEvents>);\n }, 0);\n }\n\n if (socketEventsCallBack) {\n socketEventsCallBack(socketDetail.socket);\n }\n\n } else {\n const errorMessage: string = 'Could not get socket object from socket.io';\n this.#LogErrorMessage(errorMessage);\n socketDetail.errorCallBack(new Error(errorMessage));\n }\n })\n\n // https://socket.io/docs/v4/client-socket-instance/#disconnect\n socketDetail.socket.on(\"disconnect\", (reason: string) =>\n {\n this.#LogDebugMessage('socket disconnect: ' + reason);\n switch (reason) {\n case 'io server disconnect' : {\n // The server disconnect using disconnectSockets (i.e. normal safe shutdown)\n this.#LogDebugMessage('The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n this.#LogDebugMessage('The connection will be re-established when the server becomes available.');\n const socketDetail: ISocketDetail = this.sockets[name];\n socketDetail.socket = null;\n if (isNode) {\n this.#agentManager?.ResetAgent();\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n }\n }\n break;\n case 'io client disconnect' :\n this.#LogDebugMessage('The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n this.#LogDebugMessage('The connection will not be re-established automatically.');\n // Do nothing\n break;\n case 'transport close' :\n case 'ping timeout' :\n case 'transport error' : {\n this.#LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);\n this.#LogDebugMessage('The connection will be re-established when the server becomes available.');\n const socketDetail: ISocketDetail = this.sockets[name];\n if (socketDetail.socket) {\n socketDetail.socket.disconnect();\n }\n socketDetail.socket = null;\n if (isNode) {\n this.#agentManager?.ResetAgent();\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n }\n }\n break;\n }\n });\n }\n}\n","/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */ // --> OFF\nimport { JSONObject } from '@nsshunt/stsutils'\n\nimport { Server, Namespace, Socket } from \"socket.io\";\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, STSServerSocket, ISocketIoServerHelper,\n ISocketIoServerHelperOptions, STSSocketIONamespace, STSSocketIONamespaces, STSNamespace,\n InterServerEvents, ServerEventCb } from './commonTypes'\n\nexport class SocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> implements ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\n{\n #socketIoServerHelperOptions: ISocketIoServerHelperOptions\n #namespace: STSSocketIONamespaces = { };\n\n constructor(options: ISocketIoServerHelperOptions) { // IProcessBase\n this.#socketIoServerHelperOptions = options;\n }\n\n LogMessage(namespace: STSSocketIONamespace, message: any) {\n this.#socketIoServerHelperOptions.logger.debug(`${namespace.namespace}: ${message}`);\n }\n\n LeaveRoom = (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string): void => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: Leaving room [${room}]`);\n socket.leave(room);\n };\n\n JoinRoom = (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string): void => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: Socket joining room [${room}], ID: [${socket.id}]`);\n socket.join(room);\n };\n\n #SetupStandardEvents = (namespace: STSSocketIONamespace, socket: Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents>): void => {\n socket.on('disconnect', (reason: string) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnect, ID: [${socket.id}] [${reason}]`);\n });\n\n socket.on('disconnecting', (reason: string) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnecting, ID: [${socket.id}] [${reason}]`);\n });\n\n socket.on('error', (error: Error) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket error, ID: [${socket.id}] [${error}]`);\n });\n\n socket.on(\"__STSdisconnect\", (reason: string) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnect: socket disconnect, ID: [${socket.id}] [${reason}]`);\n });\n\n socket.on(\"__STSdisconnecting\", (reason, callBackResult) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnecting: socket disconnecting, ID: [${socket.id}] [${reason}]`);\n callBackResult(\"__STSdisconnecting accepted by server.\");\n });\n\n socket.on('__STSjoinRoom', (rooms: string[]): void => { //@@ names\n rooms.forEach((room) => {\n this.JoinRoom(namespace, socket, room)\n });\n });\n\n socket.on('__STSleaveRoom', (rooms: string[]): void => { //@@ names\n rooms.forEach((room) => {\n this.LeaveRoom(namespace, socket, room);\n });\n });\n\n socket.on('__STSsendToRoom', (rooms: string[], payload: { command: string, payload: JSONObject }): void => {\n rooms.forEach((room) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}:socket.on:sendToRoom: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}]`);\n \n namespace.socketionamespace.to(room).emit(payload.command as any, payload);\n });\n });\n }\n\n // Use this middleward to check every incomming connection\n #SetupConnectionMiddleware = (nameSpace: STSSocketIONamespace) => {\n nameSpace.socketionamespace.use((socket, next) => {\n //if (isValid(socket.request)) {\n const a=5; // for lint purposes\n if (a === 5) {\n next();\n } else {\n next(new Error(\"invalid\"));\n }\n });\n }\n\n // Use this middleware to check very packet being received\n #SetupMessageMiddleware = (socket: STSServerSocket) => {\n socket.use(([event, ...args], next) => {\n /*\n if (isUnauthorized(event)) {\n return next(new Error(\"unauthorized event\"));\n }\n */\n next();\n });\n }\n \n SetupNamespace = (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, /* serverSocketEvents: ServerSocketEvent[], */\n socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null,\n socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null\n ): Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents> => {\n // Create STS Command Centre Client namespace\n this.#namespace[namespace] = {\n namespace: namespace,\n pid: process.pid,\n socketionamespace: io.of(`/${namespace}/`)\n }\n\n this.#SetupConnectionMiddleware(this.#namespace[namespace]);\n\n this.#namespace[namespace].socketionamespace.on(\"connection\", socket => {\n this.LogMessage(this.#namespace[namespace], `${namespace}: Socket connected, ID: [${socket.id}]`);\n this.LogMessage(this.#namespace[namespace], `${namespace}: Authentication Handshake: [${JSON.stringify(socket.handshake.auth)}]`);\n\n this.#SetupMessageMiddleware(socket);\n\n if (autoJoinRooms) {\n rooms.map((room) => {\n this.JoinRoom(this.#namespace[namespace], socket, room);\n });\n }\n\n this.#SetupStandardEvents(this.#namespace[namespace], socket);\n\n if (socketConnectCallBack) {\n setTimeout(() => {\n socketConnectCallBack(socket);\n }, 0);\n }\n\n if (socketEventsCallBack) {\n socketEventsCallBack(socket);\n }\n });\n\n return this.#namespace[namespace].socketionamespace as Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>;\n }\n\n GetSTSSocketIONamespace = (namespace: string): STSSocketIONamespace => {\n return this.#namespace[namespace];\n }\n\n GetSTSSocketIONamespaces = (): STSSocketIONamespaces => {\n return this.#namespace;\n }\n\n CloseAdaptors = async (): Promise<void> => {\n for (const [, namespace] of Object.entries(this.#namespace)) {\n await namespace.socketionamespace.adapter.close();\n }\n }\n\n DisconnectSockets = (): void => {\n for (const [, namespace] of Object.entries(this.#namespace)) {\n namespace.socketionamespace.disconnectSockets();\n }\n this.#namespace = { };\n }\n\n SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents> {\n return this as any;\n }\n}\n"],"names":["STSNamespace","STSRoom","STSEvent","socketDetail","_a","io"],"mappings":"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","x_google_ignoreList":[1]}
|
|
1
|
+
{"version":3,"file":"stssocketioutils.mjs","sources":["../src/commonTypes.ts","../node_modules/detect-node/index.esm.js","../src/socketIoClientHelper.ts","../src/socketIoServerHelper.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */ // --> OFF\nimport { Server, Socket, Namespace } from \"socket.io\";\nimport { ISTSLogger } from '@nsshunt/stsutils'\n\nexport interface STSDefaultClientToServerEvents {\n /**\n * Join the room(s) specified for this client.\n * @param room The room(s) to join for this client.\n * @returns \n */\n\t__STSjoinRoom: (room: string[]) => void;\n\n /**\n * Remove this client from the specified room(s).\n * @param room The room(s) to remove the client from within the server.\n * @returns \n */\n\t__STSleaveRoom: (room: string[]) => void;\n\n /**\n * Alerts the server that this client has flagged to disconnect. Allows server to perform clean-up if required. The server must call-back with the result of the disconnecting event.\n * @param reason Reason for the disconnecting event.\n * @param callback The server must call-back with the result of the disconnecting event.\n * @returns \n */\n\t__STSdisconnecting: (reason: string, callback: (data: string) => void) => void;\n\n /**\n * Alerts the server to disconnect this client.\n * @param reason Reason for the disconnect event.\n * @returns \n */\n\t__STSdisconnect: (reason: string) => void; // server and client event\n\n /**\n * Send a payload of data to 1 or more rooms registered on the server.\n * @param rooms Room array for broadcasting.\n * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n * interface that extends STSServerToClientEvents.\n * @returns \n */\n \n\t__STSsendToRoom: (rooms: string[], payload: { command: string, payload: any }) => void;\n}\n\nexport interface STSDefaultServerToClientEvents {\n /**\n * The server may emit an unsolicited disconnect event to flag that all clients should disconnect. Most likely becuase the server may be shutting down.\n * @param reason Reason why the server is emitting this disconnect event.\n * @returns \n */\n\t__STSdisconnect: (reason: string) => void;\n}\n\nexport interface ISocketIoServerHelperOptions {\n logger: ISTSLogger\n}\n\nexport type ServerEventCb = (socket: any, data: any) => void\n\nexport interface ServerSocketEvent {\n\tserverEventName: string,\n\tserverEventCb: ServerEventCb\n}\n\nexport enum STSNamespace {\n\tSTSMonitor = 'stsinstrumentmanager/stsmonitor',\n\tSTSControl = 'stsinstrumentmanager/stscontrol',\n STSTestingNamespace = 'ststestingnamespace/ststesting'\n}\n\nexport enum STSRoom {\n\t// STSMonitor rooms\n\tSTSInstrumentDataRoom = 'stsinstrumentdataroom', // This room is for all instrument data messages\n\tSTSInstrumentDataSubscriptionRoom = 'stsinstrumentdatasubscriptionroom', // This room is only for subscribed instrument data messages\n\n\t// STSControl rooms\n\tSTSRunnerRoom = 'stsrunnerroom',\n\tSTSNodeRunnerRoom = 'stsnoderunnerroom'\n}\n\nexport enum STSEvent {\n\t// STSInstrumentData\n\tSTSInstrumentData = 'stsinstrumentdata',\n\tSTSSubInstrumentData = 'stssubinstrumentdata', // sub-scribed instrument data. This only outputs the nodes that have been subscribed by the client(s).\n\tSTSResetInstrumentData = 'stsresetinstrumentdata',\n\n\tSTSStartLoggingInstrumentData = 'stsStartLoggingInstrumentData',\n\tSTSStopLoggingInstrumentData = 'stsStopLoggingInstrumentData',\n\n\t// STSRunner events\n\tSTSStart = 'stsstart', // Start a test run with options as payload.\n\tSTSStop = 'stsstop', // Stop test run(s).\n\tSTSPause = 'stspause', // Pause test run(s).\n\tSTSResume = 'stsresume', // Resume test run(s).\n\tSTSTerminate = 'ststerminate', // Terminate runner instances and exit applications.\n\t// This may also be uysed to force trigger self healing (i.e. auto re-start) when\n\t// running within a container orchestrator such as K8, K3 or Docker Swarm.\n\tSTSUpdateStaticConfig = 'stsupdatestaticconfig', // Update base configuration. Options as payload.\n\tSTSUpdateDynamicConfig = 'stsupdatedynamicconfig', // Update running configuration. This is used\n\t// to control the runnning behaviour of test(s) in-flight. Options as payload.\n\n\tSTSSendToRoom = 'sendToRoom',\n\n\t// Standard socket events\n\tconnect = 'connect'\n}\n\n// https://socket.io/docs/v4/typescript/\n\nexport interface InterServerEvents {\n\tping: () => void;\n}\n\nexport interface STSSocketIONamespace {\n\tnamespace: string\n\tpid: number\n\tsocketionamespace: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n}\n\nexport type STSSocketIONamespaces = Record<string, STSSocketIONamespace>;\n\nexport type STSServerSocket = Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\nexport type STSClientSocket = Socket<STSDefaultServerToClientEvents, STSDefaultClientToServerEvents, InterServerEvents>\n\nexport interface ISocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents>\n{\n LogMessage: (namespace: STSSocketIONamespace, message: string) => void\n LeaveRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void\n JoinRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void\n SetupNamespace: (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, \n /* serverSocketEvents: ServerSocketEvent[], */\n socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null,\n socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null\n ) => Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>\n GetSTSSocketIONamespace: (namespace: any) => STSSocketIONamespace\n GetSTSSocketIONamespaces: () => STSSocketIONamespaces\n DisconnectSockets: () => void\n SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\n CloseAdaptors: () => Promise<void>\n}\n","// Only Node.JS has a process variable that is of [[Class]] process\nexport default Object.prototype.toString.call(typeof process !== 'undefined' ? process : 0) === '[object process]';\n","import { io, SocketOptions, ManagerOptions, Socket } from 'socket.io-client'\n\nimport isNode from 'detect-node';\n\nimport { ISTSLogger, AgentManager } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes'\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type EventCb = (socket: any, data: any) => void\n\n/*\nSocket.io - Reserved events\nOn each side, the following events are reserved and should not be used as event names by your application:\nconnect\nconnect_error\ndisconnect\ndisconnecting\nnewListener\nremoveListener\n*/\n\n/*\nexport interface EventsMap { // From the socket.io library - was not declared as external\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n [event: string]: any;\n}\n*/\n\nexport interface ISocketDetail {\n\tname: string,\n\taddress: string,\n \n\tsocket: Socket | null\n errorCallBack: (error: Error) => void\n}\n\nexport interface ISocketIoClientHelperOptions\n{\n url?: string\n agentManager?: AgentManager\n logger?: ISTSLogger\n}\n\nexport class SocketIoClientHelper<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents>\n{\n #options: ISocketIoClientHelperOptions\n #sockets: Record<string, ISocketDetail> = { }\n\n constructor(options: ISocketIoClientHelperOptions) {\n this.#options = options;\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n #LogDebugMessage(message: any): void {\n if (this.#options.logger) this.#options.logger.debug(message);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n #LogErrorMessage(message: any): void {\n if (this.#options.logger) this.#options.logger.error(message);\n }\n\n get sockets(): Record<string, ISocketDetail> {\n return this.#sockets;\n }\n \n SetupClientSideSocket(name: string, address: string, \n onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n errorCallBack: ((error: Error) => void)\n ): Socket<ServerToClientEvents, ClientToServerEvents> {\n this.sockets[name] = {\n name,\n address,\n socket: null,\n errorCallBack\n }\n this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack);\n return this.sockets[name].socket as Socket<ServerToClientEvents, ClientToServerEvents>\n }\n\n GetSocket(name: string): Socket<ServerToClientEvents, ClientToServerEvents> {\n return this.sockets[name].socket as Socket<ServerToClientEvents, ClientToServerEvents>\n }\n\n GetSocketDetail(name: string): ISocketDetail {\n return this.sockets[name];\n }\n\n #EstablishSocketConnect(name: string, onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null): void\n {\n const socketDetail: ISocketDetail = this.sockets[name];\n\n if (socketDetail.socket !== null) {\n // We already have a socket object (may or may not be connected)\n if (socketDetail.socket.connected === true) {\n socketDetail.socket.disconnect();\n }\n socketDetail.socket = null;\n if (isNode) {\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n }\n return;\n }\n\n let socketOptions: Partial<SocketOptions & ManagerOptions>;\n if (isNode) {\n // https://socket.io/docs/v4/client-options/#reconnection\n // https://github.com/socketio/engine.io-client#methods\n socketOptions = {\n transports: [\"websocket\" ]\n }\n if (this.#options.agentManager) {\n socketOptions.agent = this.#options.agentManager.GetAgent(socketDetail.address);\n }\n } else {\n socketOptions = {\n transports: [\"websocket\" ]\n }\n }\n socketDetail.socket = io(socketDetail.address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n socketDetail.socket.on(\"connect\", () => {\n if (socketDetail.socket) {\n this.#LogDebugMessage(`Socket: [${socketDetail.socket.id}]: connected`);\n\n if (onConnectCallBack) {\n setTimeout(() => {\n onConnectCallBack(socketDetail.socket as Socket<ServerToClientEvents, ClientToServerEvents>);\n }, 0);\n }\n\n if (socketEventsCallBack) {\n socketEventsCallBack(socketDetail.socket);\n }\n\n } else {\n const errorMessage: string = 'Could not get socket object from socket.io';\n this.#LogErrorMessage(errorMessage);\n socketDetail.errorCallBack(new Error(errorMessage));\n }\n })\n\n // https://socket.io/docs/v4/client-socket-instance/#disconnect\n socketDetail.socket.on(\"disconnect\", (reason: string) =>\n {\n this.#LogDebugMessage('socket disconnect: ' + reason);\n switch (reason) {\n case 'io server disconnect' : {\n // The server disconnect using disconnectSockets (i.e. normal safe shutdown)\n this.#LogDebugMessage('The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n this.#LogDebugMessage('The connection will be re-established when the server becomes available.');\n const socketDetail: ISocketDetail = this.sockets[name];\n socketDetail.socket = null;\n if (isNode) {\n if (this.#options.agentManager) {\n this.#options.agentManager.ResetAgent();\n }\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n }\n }\n break;\n case 'io client disconnect' :\n this.#LogDebugMessage('The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n this.#LogDebugMessage('The connection will not be re-established automatically.');\n // Do nothing\n break;\n case 'transport close' :\n case 'ping timeout' :\n case 'transport error' : {\n this.#LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);\n this.#LogDebugMessage('The connection will be re-established when the server becomes available.');\n const socketDetail: ISocketDetail = this.sockets[name];\n if (socketDetail.socket) {\n socketDetail.socket.disconnect();\n }\n socketDetail.socket = null;\n if (isNode) {\n if (this.#options.agentManager) {\n this.#options.agentManager?.ResetAgent();\n }\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n }\n }\n break;\n }\n });\n }\n}\n","/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */ // --> OFF\nimport { JSONObject } from '@nsshunt/stsutils'\n\nimport { Server, Namespace, Socket } from \"socket.io\";\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, STSServerSocket, ISocketIoServerHelper,\n ISocketIoServerHelperOptions, STSSocketIONamespace, STSSocketIONamespaces, STSNamespace,\n InterServerEvents, ServerEventCb } from './commonTypes'\n\nexport class SocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> implements ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\n{\n #socketIoServerHelperOptions: ISocketIoServerHelperOptions\n #namespace: STSSocketIONamespaces = { };\n\n constructor(options: ISocketIoServerHelperOptions) { // IProcessBase\n this.#socketIoServerHelperOptions = options;\n }\n\n LogMessage(namespace: STSSocketIONamespace, message: any) {\n this.#socketIoServerHelperOptions.logger.debug(`${namespace.namespace}: ${message}`);\n }\n\n LeaveRoom = (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string): void => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: Leaving room [${room}]`);\n socket.leave(room);\n };\n\n JoinRoom = (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string): void => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: Socket joining room [${room}], ID: [${socket.id}]`);\n socket.join(room);\n };\n\n #SetupStandardEvents = (namespace: STSSocketIONamespace, socket: Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents>): void => {\n socket.on('disconnect', (reason: string) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnect, ID: [${socket.id}] [${reason}]`);\n });\n\n socket.on('disconnecting', (reason: string) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnecting, ID: [${socket.id}] [${reason}]`);\n });\n\n socket.on('error', (error: Error) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket error, ID: [${socket.id}] [${error}]`);\n });\n\n socket.on(\"__STSdisconnect\", (reason: string) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnect: socket disconnect, ID: [${socket.id}] [${reason}]`);\n });\n\n socket.on(\"__STSdisconnecting\", (reason, callBackResult) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnecting: socket disconnecting, ID: [${socket.id}] [${reason}]`);\n callBackResult(\"__STSdisconnecting accepted by server.\");\n });\n\n socket.on('__STSjoinRoom', (rooms: string[]): void => { //@@ names\n rooms.forEach((room) => {\n this.JoinRoom(namespace, socket, room)\n });\n });\n\n socket.on('__STSleaveRoom', (rooms: string[]): void => { //@@ names\n rooms.forEach((room) => {\n this.LeaveRoom(namespace, socket, room);\n });\n });\n\n socket.on('__STSsendToRoom', (rooms: string[], payload: { command: string, payload: JSONObject }): void => {\n rooms.forEach((room) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}:socket.on:sendToRoom: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}]`);\n \n namespace.socketionamespace.to(room).emit(payload.command as any, payload);\n });\n });\n }\n\n // Use this middleward to check every incomming connection\n #SetupConnectionMiddleware = (nameSpace: STSSocketIONamespace) => {\n nameSpace.socketionamespace.use((socket, next) => {\n //if (isValid(socket.request)) {\n const a=5; // for lint purposes\n if (a === 5) {\n next();\n } else {\n next(new Error(\"invalid\"));\n }\n });\n }\n\n // Use this middleware to check very packet being received\n #SetupMessageMiddleware = (socket: STSServerSocket) => {\n socket.use(([event, ...args], next) => {\n /*\n if (isUnauthorized(event)) {\n return next(new Error(\"unauthorized event\"));\n }\n */\n next();\n });\n }\n \n SetupNamespace = (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, /* serverSocketEvents: ServerSocketEvent[], */\n socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null,\n socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null\n ): Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents> => {\n // Create STS Command Centre Client namespace\n this.#namespace[namespace] = {\n namespace: namespace,\n pid: process.pid,\n socketionamespace: io.of(`/${namespace}/`)\n }\n\n this.#SetupConnectionMiddleware(this.#namespace[namespace]);\n\n this.#namespace[namespace].socketionamespace.on(\"connection\", socket => {\n this.LogMessage(this.#namespace[namespace], `${namespace}: Socket connected, ID: [${socket.id}]`);\n this.LogMessage(this.#namespace[namespace], `${namespace}: Authentication Handshake: [${JSON.stringify(socket.handshake.auth)}]`);\n\n this.#SetupMessageMiddleware(socket);\n\n if (autoJoinRooms) {\n rooms.map((room) => {\n this.JoinRoom(this.#namespace[namespace], socket, room);\n });\n }\n\n this.#SetupStandardEvents(this.#namespace[namespace], socket);\n\n if (socketConnectCallBack) {\n setTimeout(() => {\n socketConnectCallBack(socket);\n }, 0);\n }\n\n if (socketEventsCallBack) {\n socketEventsCallBack(socket);\n }\n });\n\n return this.#namespace[namespace].socketionamespace as Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>;\n }\n\n GetSTSSocketIONamespace = (namespace: string): STSSocketIONamespace => {\n return this.#namespace[namespace];\n }\n\n GetSTSSocketIONamespaces = (): STSSocketIONamespaces => {\n return this.#namespace;\n }\n\n CloseAdaptors = async (): Promise<void> => {\n for (const [, namespace] of Object.entries(this.#namespace)) {\n await namespace.socketionamespace.adapter.close();\n }\n }\n\n DisconnectSockets = (): void => {\n for (const [, namespace] of Object.entries(this.#namespace)) {\n namespace.socketionamespace.disconnectSockets();\n }\n this.#namespace = { };\n }\n\n SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents> {\n return this as any;\n }\n}\n"],"names":["STSNamespace","STSRoom","STSEvent","socketDetail","io"],"mappings":"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","x_google_ignoreList":[1]}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
(function(global, factory) {
|
|
2
|
-
typeof exports === "object" && typeof module !== "undefined" ? factory(exports, require("socket.io-client")
|
|
3
|
-
})(this, function(exports2, socket_ioClient
|
|
2
|
+
typeof exports === "object" && typeof module !== "undefined" ? factory(exports, require("socket.io-client")) : typeof define === "function" && define.amd ? define(["exports", "socket.io-client"], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, factory(global["@nsshunt/stssocketioutils"] = {}, global.socket["io-client"]));
|
|
3
|
+
})(this, function(exports2, socket_ioClient) {
|
|
4
4
|
"use strict";var __defProp = Object.defineProperty;
|
|
5
5
|
var __typeError = (msg) => {
|
|
6
6
|
throw TypeError(msg);
|
|
@@ -13,7 +13,7 @@ var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot
|
|
|
13
13
|
var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
|
|
14
14
|
var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
|
|
15
15
|
|
|
16
|
-
var _options, _sockets,
|
|
16
|
+
var _options, _sockets, _SocketIoClientHelper_instances, LogDebugMessage_fn, LogErrorMessage_fn, EstablishSocketConnect_fn, _socketIoServerHelperOptions, _namespace, _SetupStandardEvents, _SetupConnectionMiddleware, _SetupMessageMiddleware;
|
|
17
17
|
var STSNamespace = /* @__PURE__ */ ((STSNamespace2) => {
|
|
18
18
|
STSNamespace2["STSMonitor"] = "stsinstrumentmanager/stsmonitor";
|
|
19
19
|
STSNamespace2["STSControl"] = "stsinstrumentmanager/stscontrol";
|
|
@@ -50,13 +50,7 @@ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "acce
|
|
|
50
50
|
__privateAdd(this, _SocketIoClientHelper_instances);
|
|
51
51
|
__privateAdd(this, _options);
|
|
52
52
|
__privateAdd(this, _sockets, {});
|
|
53
|
-
__privateAdd(this, _agentManager, null);
|
|
54
53
|
__privateSet(this, _options, options);
|
|
55
|
-
if (isNode) {
|
|
56
|
-
__privateSet(this, _agentManager, new stsconfig.AgentManager({
|
|
57
|
-
agentOptions: __privateGet(this, _options).agentOptions
|
|
58
|
-
}));
|
|
59
|
-
}
|
|
60
54
|
}
|
|
61
55
|
get sockets() {
|
|
62
56
|
return __privateGet(this, _sockets);
|
|
@@ -80,7 +74,6 @@ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "acce
|
|
|
80
74
|
}
|
|
81
75
|
_options = new WeakMap();
|
|
82
76
|
_sockets = new WeakMap();
|
|
83
|
-
_agentManager = new WeakMap();
|
|
84
77
|
_SocketIoClientHelper_instances = new WeakSet();
|
|
85
78
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
86
79
|
LogDebugMessage_fn = function(message) {
|
|
@@ -91,7 +84,6 @@ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "acce
|
|
|
91
84
|
if (__privateGet(this, _options).logger) __privateGet(this, _options).logger.error(message);
|
|
92
85
|
};
|
|
93
86
|
EstablishSocketConnect_fn = function(name, onConnectCallBack, socketEventsCallBack) {
|
|
94
|
-
var _a;
|
|
95
87
|
const socketDetail = this.sockets[name];
|
|
96
88
|
if (socketDetail.socket !== null) {
|
|
97
89
|
if (socketDetail.socket.connected === true) {
|
|
@@ -108,10 +100,11 @@ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "acce
|
|
|
108
100
|
let socketOptions;
|
|
109
101
|
if (isNode) {
|
|
110
102
|
socketOptions = {
|
|
111
|
-
transports: ["websocket"]
|
|
112
|
-
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
113
|
-
agent: (_a = __privateGet(this, _agentManager)) == null ? void 0 : _a.GetAgent(socketDetail.address)
|
|
103
|
+
transports: ["websocket"]
|
|
114
104
|
};
|
|
105
|
+
if (__privateGet(this, _options).agentManager) {
|
|
106
|
+
socketOptions.agent = __privateGet(this, _options).agentManager.GetAgent(socketDetail.address);
|
|
107
|
+
}
|
|
115
108
|
} else {
|
|
116
109
|
socketOptions = {
|
|
117
110
|
transports: ["websocket"]
|
|
@@ -136,7 +129,7 @@ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "acce
|
|
|
136
129
|
}
|
|
137
130
|
});
|
|
138
131
|
socketDetail.socket.on("disconnect", (reason) => {
|
|
139
|
-
var
|
|
132
|
+
var _a;
|
|
140
133
|
__privateMethod(this, _SocketIoClientHelper_instances, LogDebugMessage_fn).call(this, "socket disconnect: " + reason);
|
|
141
134
|
switch (reason) {
|
|
142
135
|
case "io server disconnect":
|
|
@@ -146,7 +139,9 @@ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "acce
|
|
|
146
139
|
const socketDetail2 = this.sockets[name];
|
|
147
140
|
socketDetail2.socket = null;
|
|
148
141
|
if (isNode) {
|
|
149
|
-
(
|
|
142
|
+
if (__privateGet(this, _options).agentManager) {
|
|
143
|
+
__privateGet(this, _options).agentManager.ResetAgent();
|
|
144
|
+
}
|
|
150
145
|
setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100).unref();
|
|
151
146
|
} else {
|
|
152
147
|
setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100);
|
|
@@ -169,7 +164,9 @@ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "acce
|
|
|
169
164
|
}
|
|
170
165
|
socketDetail2.socket = null;
|
|
171
166
|
if (isNode) {
|
|
172
|
-
(
|
|
167
|
+
if (__privateGet(this, _options).agentManager) {
|
|
168
|
+
(_a = __privateGet(this, _options).agentManager) == null ? void 0 : _a.ResetAgent();
|
|
169
|
+
}
|
|
173
170
|
setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100).unref();
|
|
174
171
|
} else {
|
|
175
172
|
setTimeout(() => __privateMethod(this, _SocketIoClientHelper_instances, EstablishSocketConnect_fn).call(this, name, onConnectCallBack, socketEventsCallBack), 100);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"stssocketioutils.umd.js","sources":["../src/commonTypes.ts","../node_modules/detect-node/index.esm.js","../src/socketIoClientHelper.ts","../src/socketIoServerHelper.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */ // --> OFF\nimport { Server, Socket, Namespace } from \"socket.io\";\nimport { ISTSLogger } from '@nsshunt/stsutils'\n\nexport interface STSDefaultClientToServerEvents {\n /**\n * Join the room(s) specified for this client.\n * @param room The room(s) to join for this client.\n * @returns \n */\n\t__STSjoinRoom: (room: string[]) => void;\n\n /**\n * Remove this client from the specified room(s).\n * @param room The room(s) to remove the client from within the server.\n * @returns \n */\n\t__STSleaveRoom: (room: string[]) => void;\n\n /**\n * Alerts the server that this client has flagged to disconnect. Allows server to perform clean-up if required. The server must call-back with the result of the disconnecting event.\n * @param reason Reason for the disconnecting event.\n * @param callback The server must call-back with the result of the disconnecting event.\n * @returns \n */\n\t__STSdisconnecting: (reason: string, callback: (data: string) => void) => void;\n\n /**\n * Alerts the server to disconnect this client.\n * @param reason Reason for the disconnect event.\n * @returns \n */\n\t__STSdisconnect: (reason: string) => void; // server and client event\n\n /**\n * Send a payload of data to 1 or more rooms registered on the server.\n * @param rooms Room array for broadcasting.\n * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n * interface that extends STSServerToClientEvents.\n * @returns \n */\n \n\t__STSsendToRoom: (rooms: string[], payload: { command: string, payload: any }) => void;\n}\n\nexport interface STSDefaultServerToClientEvents {\n /**\n * The server may emit an unsolicited disconnect event to flag that all clients should disconnect. Most likely becuase the server may be shutting down.\n * @param reason Reason why the server is emitting this disconnect event.\n * @returns \n */\n\t__STSdisconnect: (reason: string) => void;\n}\n\nexport interface ISocketIoServerHelperOptions {\n logger: ISTSLogger\n}\n\nexport type ServerEventCb = (socket: any, data: any) => void\n\nexport interface ServerSocketEvent {\n\tserverEventName: string,\n\tserverEventCb: ServerEventCb\n}\n\nexport enum STSNamespace {\n\tSTSMonitor = 'stsinstrumentmanager/stsmonitor',\n\tSTSControl = 'stsinstrumentmanager/stscontrol',\n STSTestingNamespace = 'ststestingnamespace/ststesting'\n}\n\nexport enum STSRoom {\n\t// STSMonitor rooms\n\tSTSInstrumentDataRoom = 'stsinstrumentdataroom', // This room is for all instrument data messages\n\tSTSInstrumentDataSubscriptionRoom = 'stsinstrumentdatasubscriptionroom', // This room is only for subscribed instrument data messages\n\n\t// STSControl rooms\n\tSTSRunnerRoom = 'stsrunnerroom',\n\tSTSNodeRunnerRoom = 'stsnoderunnerroom'\n}\n\nexport enum STSEvent {\n\t// STSInstrumentData\n\tSTSInstrumentData = 'stsinstrumentdata',\n\tSTSSubInstrumentData = 'stssubinstrumentdata', // sub-scribed instrument data. This only outputs the nodes that have been subscribed by the client(s).\n\tSTSResetInstrumentData = 'stsresetinstrumentdata',\n\n\tSTSStartLoggingInstrumentData = 'stsStartLoggingInstrumentData',\n\tSTSStopLoggingInstrumentData = 'stsStopLoggingInstrumentData',\n\n\t// STSRunner events\n\tSTSStart = 'stsstart', // Start a test run with options as payload.\n\tSTSStop = 'stsstop', // Stop test run(s).\n\tSTSPause = 'stspause', // Pause test run(s).\n\tSTSResume = 'stsresume', // Resume test run(s).\n\tSTSTerminate = 'ststerminate', // Terminate runner instances and exit applications.\n\t// This may also be uysed to force trigger self healing (i.e. auto re-start) when\n\t// running within a container orchestrator such as K8, K3 or Docker Swarm.\n\tSTSUpdateStaticConfig = 'stsupdatestaticconfig', // Update base configuration. Options as payload.\n\tSTSUpdateDynamicConfig = 'stsupdatedynamicconfig', // Update running configuration. This is used\n\t// to control the runnning behaviour of test(s) in-flight. Options as payload.\n\n\tSTSSendToRoom = 'sendToRoom',\n\n\t// Standard socket events\n\tconnect = 'connect'\n}\n\n// https://socket.io/docs/v4/typescript/\n\nexport interface InterServerEvents {\n\tping: () => void;\n}\n\nexport interface STSSocketIONamespace {\n\tnamespace: string\n\tpid: number\n\tsocketionamespace: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n}\n\nexport type STSSocketIONamespaces = Record<string, STSSocketIONamespace>;\n\nexport type STSServerSocket = Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\nexport type STSClientSocket = Socket<STSDefaultServerToClientEvents, STSDefaultClientToServerEvents, InterServerEvents>\n\nexport interface ISocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents>\n{\n LogMessage: (namespace: STSSocketIONamespace, message: string) => void\n LeaveRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void\n JoinRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void\n SetupNamespace: (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, \n /* serverSocketEvents: ServerSocketEvent[], */\n socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null,\n socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null\n ) => Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>\n GetSTSSocketIONamespace: (namespace: any) => STSSocketIONamespace\n GetSTSSocketIONamespaces: () => STSSocketIONamespaces\n DisconnectSockets: () => void\n SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\n CloseAdaptors: () => Promise<void>\n}\n","// Only Node.JS has a process variable that is of [[Class]] process\nexport default Object.prototype.toString.call(typeof process !== 'undefined' ? process : 0) === '[object process]';\n","import { io, SocketOptions, ManagerOptions, Socket } from 'socket.io-client'\n\nimport isNode from 'detect-node';\n\nimport { ISTSLogger } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes'\nimport { AgentManager } from '@nsshunt/stsconfig';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type EventCb = (socket: any, data: any) => void\n\n/*\nSocket.io - Reserved events\nOn each side, the following events are reserved and should not be used as event names by your application:\nconnect\nconnect_error\ndisconnect\ndisconnecting\nnewListener\nremoveListener\n*/\n\n/*\nexport interface EventsMap { // From the socket.io library - was not declared as external\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n [event: string]: any;\n}\n*/\n\nexport interface ISocketDetail {\n\tname: string,\n\taddress: string,\n \n\tsocket: Socket | null\n errorCallBack: (error: Error) => void\n}\n\nexport interface ISocketIoClientHelperOptions\n{\n url?: string\n agentOptions?: {\n\t\tkeepAlive: boolean,\n\t\tmaxSockets: number\n\t\tmaxTotalSockets: number,\n\t\tmaxFreeSockets: number,\n\t\ttimeout: number,\n\t\trejectUnauthorized: boolean // Allows self signed certs in non production mode(s)\n\t}\n logger?: ISTSLogger\n}\n\nexport class SocketIoClientHelper<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents>\n{\n #options: ISocketIoClientHelperOptions\n #sockets: Record<string, ISocketDetail> = { }\n #agentManager: AgentManager | null = null;\n\n constructor(options: ISocketIoClientHelperOptions) {\n this.#options = options;\n if (isNode) {\n this.#agentManager = new AgentManager({\n agentOptions: this.#options.agentOptions\n });\n }\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n #LogDebugMessage(message: any): void {\n if (this.#options.logger) this.#options.logger.debug(message);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n #LogErrorMessage(message: any): void {\n if (this.#options.logger) this.#options.logger.error(message);\n }\n\n get sockets(): Record<string, ISocketDetail> {\n return this.#sockets;\n }\n \n SetupClientSideSocket(name: string, address: string, \n onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n errorCallBack: ((error: Error) => void)\n ): Socket<ServerToClientEvents, ClientToServerEvents> {\n this.sockets[name] = {\n name,\n address,\n socket: null,\n errorCallBack\n }\n this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack);\n return this.sockets[name].socket as Socket<ServerToClientEvents, ClientToServerEvents>\n }\n\n GetSocket(name: string): Socket<ServerToClientEvents, ClientToServerEvents> {\n return this.sockets[name].socket as Socket<ServerToClientEvents, ClientToServerEvents>\n }\n\n GetSocketDetail(name: string): ISocketDetail {\n return this.sockets[name];\n }\n\n #EstablishSocketConnect(name: string, onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null): void\n {\n const socketDetail: ISocketDetail = this.sockets[name];\n\n if (socketDetail.socket !== null) {\n // We already have a socket object (may or may not be connected)\n if (socketDetail.socket.connected === true) {\n socketDetail.socket.disconnect();\n }\n socketDetail.socket = null;\n if (isNode) {\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n }\n return;\n }\n\n let socketOptions: Partial<SocketOptions & ManagerOptions>;\n if (isNode) {\n // https://socket.io/docs/v4/client-options/#reconnection\n // https://github.com/socketio/engine.io-client#methods\n socketOptions = {\n transports: [\"websocket\" ],\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n agent: this.#agentManager?.GetAgent(socketDetail.address) as any\n }\n // This also works for self signed certs\n //rejectUnauthorized: goptions.isProduction // Allows self signed certs in non production mode(s)\n\n //reconnection: true\n //auth: {\n //\ttoken: \"abcd\"\n //}\n //,path: '/zzz'\n } else {\n socketOptions = {\n transports: [\"websocket\" ]\n }\n }\n socketDetail.socket = io(socketDetail.address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n socketDetail.socket.on(\"connect\", () => {\n if (socketDetail.socket) {\n this.#LogDebugMessage(`Socket: [${socketDetail.socket.id}]: connected`);\n\n if (onConnectCallBack) {\n setTimeout(() => {\n onConnectCallBack(socketDetail.socket as Socket<ServerToClientEvents, ClientToServerEvents>);\n }, 0);\n }\n\n if (socketEventsCallBack) {\n socketEventsCallBack(socketDetail.socket);\n }\n\n } else {\n const errorMessage: string = 'Could not get socket object from socket.io';\n this.#LogErrorMessage(errorMessage);\n socketDetail.errorCallBack(new Error(errorMessage));\n }\n })\n\n // https://socket.io/docs/v4/client-socket-instance/#disconnect\n socketDetail.socket.on(\"disconnect\", (reason: string) =>\n {\n this.#LogDebugMessage('socket disconnect: ' + reason);\n switch (reason) {\n case 'io server disconnect' : {\n // The server disconnect using disconnectSockets (i.e. normal safe shutdown)\n this.#LogDebugMessage('The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n this.#LogDebugMessage('The connection will be re-established when the server becomes available.');\n const socketDetail: ISocketDetail = this.sockets[name];\n socketDetail.socket = null;\n if (isNode) {\n this.#agentManager?.ResetAgent();\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n }\n }\n break;\n case 'io client disconnect' :\n this.#LogDebugMessage('The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n this.#LogDebugMessage('The connection will not be re-established automatically.');\n // Do nothing\n break;\n case 'transport close' :\n case 'ping timeout' :\n case 'transport error' : {\n this.#LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);\n this.#LogDebugMessage('The connection will be re-established when the server becomes available.');\n const socketDetail: ISocketDetail = this.sockets[name];\n if (socketDetail.socket) {\n socketDetail.socket.disconnect();\n }\n socketDetail.socket = null;\n if (isNode) {\n this.#agentManager?.ResetAgent();\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n }\n }\n break;\n }\n });\n }\n}\n","/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */ // --> OFF\nimport { JSONObject } from '@nsshunt/stsutils'\n\nimport { Server, Namespace, Socket } from \"socket.io\";\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, STSServerSocket, ISocketIoServerHelper,\n ISocketIoServerHelperOptions, STSSocketIONamespace, STSSocketIONamespaces, STSNamespace,\n InterServerEvents, ServerEventCb } from './commonTypes'\n\nexport class SocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> implements ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\n{\n #socketIoServerHelperOptions: ISocketIoServerHelperOptions\n #namespace: STSSocketIONamespaces = { };\n\n constructor(options: ISocketIoServerHelperOptions) { // IProcessBase\n this.#socketIoServerHelperOptions = options;\n }\n\n LogMessage(namespace: STSSocketIONamespace, message: any) {\n this.#socketIoServerHelperOptions.logger.debug(`${namespace.namespace}: ${message}`);\n }\n\n LeaveRoom = (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string): void => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: Leaving room [${room}]`);\n socket.leave(room);\n };\n\n JoinRoom = (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string): void => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: Socket joining room [${room}], ID: [${socket.id}]`);\n socket.join(room);\n };\n\n #SetupStandardEvents = (namespace: STSSocketIONamespace, socket: Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents>): void => {\n socket.on('disconnect', (reason: string) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnect, ID: [${socket.id}] [${reason}]`);\n });\n\n socket.on('disconnecting', (reason: string) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnecting, ID: [${socket.id}] [${reason}]`);\n });\n\n socket.on('error', (error: Error) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket error, ID: [${socket.id}] [${error}]`);\n });\n\n socket.on(\"__STSdisconnect\", (reason: string) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnect: socket disconnect, ID: [${socket.id}] [${reason}]`);\n });\n\n socket.on(\"__STSdisconnecting\", (reason, callBackResult) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnecting: socket disconnecting, ID: [${socket.id}] [${reason}]`);\n callBackResult(\"__STSdisconnecting accepted by server.\");\n });\n\n socket.on('__STSjoinRoom', (rooms: string[]): void => { //@@ names\n rooms.forEach((room) => {\n this.JoinRoom(namespace, socket, room)\n });\n });\n\n socket.on('__STSleaveRoom', (rooms: string[]): void => { //@@ names\n rooms.forEach((room) => {\n this.LeaveRoom(namespace, socket, room);\n });\n });\n\n socket.on('__STSsendToRoom', (rooms: string[], payload: { command: string, payload: JSONObject }): void => {\n rooms.forEach((room) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}:socket.on:sendToRoom: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}]`);\n \n namespace.socketionamespace.to(room).emit(payload.command as any, payload);\n });\n });\n }\n\n // Use this middleward to check every incomming connection\n #SetupConnectionMiddleware = (nameSpace: STSSocketIONamespace) => {\n nameSpace.socketionamespace.use((socket, next) => {\n //if (isValid(socket.request)) {\n const a=5; // for lint purposes\n if (a === 5) {\n next();\n } else {\n next(new Error(\"invalid\"));\n }\n });\n }\n\n // Use this middleware to check very packet being received\n #SetupMessageMiddleware = (socket: STSServerSocket) => {\n socket.use(([event, ...args], next) => {\n /*\n if (isUnauthorized(event)) {\n return next(new Error(\"unauthorized event\"));\n }\n */\n next();\n });\n }\n \n SetupNamespace = (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, /* serverSocketEvents: ServerSocketEvent[], */\n socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null,\n socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null\n ): Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents> => {\n // Create STS Command Centre Client namespace\n this.#namespace[namespace] = {\n namespace: namespace,\n pid: process.pid,\n socketionamespace: io.of(`/${namespace}/`)\n }\n\n this.#SetupConnectionMiddleware(this.#namespace[namespace]);\n\n this.#namespace[namespace].socketionamespace.on(\"connection\", socket => {\n this.LogMessage(this.#namespace[namespace], `${namespace}: Socket connected, ID: [${socket.id}]`);\n this.LogMessage(this.#namespace[namespace], `${namespace}: Authentication Handshake: [${JSON.stringify(socket.handshake.auth)}]`);\n\n this.#SetupMessageMiddleware(socket);\n\n if (autoJoinRooms) {\n rooms.map((room) => {\n this.JoinRoom(this.#namespace[namespace], socket, room);\n });\n }\n\n this.#SetupStandardEvents(this.#namespace[namespace], socket);\n\n if (socketConnectCallBack) {\n setTimeout(() => {\n socketConnectCallBack(socket);\n }, 0);\n }\n\n if (socketEventsCallBack) {\n socketEventsCallBack(socket);\n }\n });\n\n return this.#namespace[namespace].socketionamespace as Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>;\n }\n\n GetSTSSocketIONamespace = (namespace: string): STSSocketIONamespace => {\n return this.#namespace[namespace];\n }\n\n GetSTSSocketIONamespaces = (): STSSocketIONamespaces => {\n return this.#namespace;\n }\n\n CloseAdaptors = async (): Promise<void> => {\n for (const [, namespace] of Object.entries(this.#namespace)) {\n await namespace.socketionamespace.adapter.close();\n }\n }\n\n DisconnectSockets = (): void => {\n for (const [, namespace] of Object.entries(this.#namespace)) {\n namespace.socketionamespace.disconnectSockets();\n }\n this.#namespace = { };\n }\n\n SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents> {\n return this as any;\n }\n}\n"],"names":["STSNamespace","STSRoom","STSEvent","AgentManager","io","socketDetail","_a"],"mappings":"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","x_google_ignoreList":[1]}
|
|
1
|
+
{"version":3,"file":"stssocketioutils.umd.js","sources":["../src/commonTypes.ts","../node_modules/detect-node/index.esm.js","../src/socketIoClientHelper.ts","../src/socketIoServerHelper.ts"],"sourcesContent":["/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */ // --> OFF\nimport { Server, Socket, Namespace } from \"socket.io\";\nimport { ISTSLogger } from '@nsshunt/stsutils'\n\nexport interface STSDefaultClientToServerEvents {\n /**\n * Join the room(s) specified for this client.\n * @param room The room(s) to join for this client.\n * @returns \n */\n\t__STSjoinRoom: (room: string[]) => void;\n\n /**\n * Remove this client from the specified room(s).\n * @param room The room(s) to remove the client from within the server.\n * @returns \n */\n\t__STSleaveRoom: (room: string[]) => void;\n\n /**\n * Alerts the server that this client has flagged to disconnect. Allows server to perform clean-up if required. The server must call-back with the result of the disconnecting event.\n * @param reason Reason for the disconnecting event.\n * @param callback The server must call-back with the result of the disconnecting event.\n * @returns \n */\n\t__STSdisconnecting: (reason: string, callback: (data: string) => void) => void;\n\n /**\n * Alerts the server to disconnect this client.\n * @param reason Reason for the disconnect event.\n * @returns \n */\n\t__STSdisconnect: (reason: string) => void; // server and client event\n\n /**\n * Send a payload of data to 1 or more rooms registered on the server.\n * @param rooms Room array for broadcasting.\n * @param payload The data to be sent to every client within each of the rooms provided. The command within the payload must be a valid STSServerToClientEvents event. This includes any\n * interface that extends STSServerToClientEvents.\n * @returns \n */\n \n\t__STSsendToRoom: (rooms: string[], payload: { command: string, payload: any }) => void;\n}\n\nexport interface STSDefaultServerToClientEvents {\n /**\n * The server may emit an unsolicited disconnect event to flag that all clients should disconnect. Most likely becuase the server may be shutting down.\n * @param reason Reason why the server is emitting this disconnect event.\n * @returns \n */\n\t__STSdisconnect: (reason: string) => void;\n}\n\nexport interface ISocketIoServerHelperOptions {\n logger: ISTSLogger\n}\n\nexport type ServerEventCb = (socket: any, data: any) => void\n\nexport interface ServerSocketEvent {\n\tserverEventName: string,\n\tserverEventCb: ServerEventCb\n}\n\nexport enum STSNamespace {\n\tSTSMonitor = 'stsinstrumentmanager/stsmonitor',\n\tSTSControl = 'stsinstrumentmanager/stscontrol',\n STSTestingNamespace = 'ststestingnamespace/ststesting'\n}\n\nexport enum STSRoom {\n\t// STSMonitor rooms\n\tSTSInstrumentDataRoom = 'stsinstrumentdataroom', // This room is for all instrument data messages\n\tSTSInstrumentDataSubscriptionRoom = 'stsinstrumentdatasubscriptionroom', // This room is only for subscribed instrument data messages\n\n\t// STSControl rooms\n\tSTSRunnerRoom = 'stsrunnerroom',\n\tSTSNodeRunnerRoom = 'stsnoderunnerroom'\n}\n\nexport enum STSEvent {\n\t// STSInstrumentData\n\tSTSInstrumentData = 'stsinstrumentdata',\n\tSTSSubInstrumentData = 'stssubinstrumentdata', // sub-scribed instrument data. This only outputs the nodes that have been subscribed by the client(s).\n\tSTSResetInstrumentData = 'stsresetinstrumentdata',\n\n\tSTSStartLoggingInstrumentData = 'stsStartLoggingInstrumentData',\n\tSTSStopLoggingInstrumentData = 'stsStopLoggingInstrumentData',\n\n\t// STSRunner events\n\tSTSStart = 'stsstart', // Start a test run with options as payload.\n\tSTSStop = 'stsstop', // Stop test run(s).\n\tSTSPause = 'stspause', // Pause test run(s).\n\tSTSResume = 'stsresume', // Resume test run(s).\n\tSTSTerminate = 'ststerminate', // Terminate runner instances and exit applications.\n\t// This may also be uysed to force trigger self healing (i.e. auto re-start) when\n\t// running within a container orchestrator such as K8, K3 or Docker Swarm.\n\tSTSUpdateStaticConfig = 'stsupdatestaticconfig', // Update base configuration. Options as payload.\n\tSTSUpdateDynamicConfig = 'stsupdatedynamicconfig', // Update running configuration. This is used\n\t// to control the runnning behaviour of test(s) in-flight. Options as payload.\n\n\tSTSSendToRoom = 'sendToRoom',\n\n\t// Standard socket events\n\tconnect = 'connect'\n}\n\n// https://socket.io/docs/v4/typescript/\n\nexport interface InterServerEvents {\n\tping: () => void;\n}\n\nexport interface STSSocketIONamespace {\n\tnamespace: string\n\tpid: number\n\tsocketionamespace: Namespace<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\n}\n\nexport type STSSocketIONamespaces = Record<string, STSSocketIONamespace>;\n\nexport type STSServerSocket = Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, InterServerEvents>\nexport type STSClientSocket = Socket<STSDefaultServerToClientEvents, STSDefaultClientToServerEvents, InterServerEvents>\n\nexport interface ISocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents>\n{\n LogMessage: (namespace: STSSocketIONamespace, message: string) => void\n LeaveRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void\n JoinRoom: (namespace: STSSocketIONamespace, socket: STSServerSocket, room: STSRoom) => void\n SetupNamespace: (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, \n /* serverSocketEvents: ServerSocketEvent[], */\n socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null,\n socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null\n ) => Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>\n GetSTSSocketIONamespace: (namespace: any) => STSSocketIONamespace\n GetSTSSocketIONamespaces: () => STSSocketIONamespaces\n DisconnectSockets: () => void\n SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\n CloseAdaptors: () => Promise<void>\n}\n","// Only Node.JS has a process variable that is of [[Class]] process\nexport default Object.prototype.toString.call(typeof process !== 'undefined' ? process : 0) === '[object process]';\n","import { io, SocketOptions, ManagerOptions, Socket } from 'socket.io-client'\n\nimport isNode from 'detect-node';\n\nimport { ISTSLogger, AgentManager } from '@nsshunt/stsutils'\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes'\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type EventCb = (socket: any, data: any) => void\n\n/*\nSocket.io - Reserved events\nOn each side, the following events are reserved and should not be used as event names by your application:\nconnect\nconnect_error\ndisconnect\ndisconnecting\nnewListener\nremoveListener\n*/\n\n/*\nexport interface EventsMap { // From the socket.io library - was not declared as external\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n [event: string]: any;\n}\n*/\n\nexport interface ISocketDetail {\n\tname: string,\n\taddress: string,\n \n\tsocket: Socket | null\n errorCallBack: (error: Error) => void\n}\n\nexport interface ISocketIoClientHelperOptions\n{\n url?: string\n agentManager?: AgentManager\n logger?: ISTSLogger\n}\n\nexport class SocketIoClientHelper<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents>\n{\n #options: ISocketIoClientHelperOptions\n #sockets: Record<string, ISocketDetail> = { }\n\n constructor(options: ISocketIoClientHelperOptions) {\n this.#options = options;\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n #LogDebugMessage(message: any): void {\n if (this.#options.logger) this.#options.logger.debug(message);\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n #LogErrorMessage(message: any): void {\n if (this.#options.logger) this.#options.logger.error(message);\n }\n\n get sockets(): Record<string, ISocketDetail> {\n return this.#sockets;\n }\n \n SetupClientSideSocket(name: string, address: string, \n onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n errorCallBack: ((error: Error) => void)\n ): Socket<ServerToClientEvents, ClientToServerEvents> {\n this.sockets[name] = {\n name,\n address,\n socket: null,\n errorCallBack\n }\n this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack);\n return this.sockets[name].socket as Socket<ServerToClientEvents, ClientToServerEvents>\n }\n\n GetSocket(name: string): Socket<ServerToClientEvents, ClientToServerEvents> {\n return this.sockets[name].socket as Socket<ServerToClientEvents, ClientToServerEvents>\n }\n\n GetSocketDetail(name: string): ISocketDetail {\n return this.sockets[name];\n }\n\n #EstablishSocketConnect(name: string, onConnectCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null,\n socketEventsCallBack: ((socket: Socket<ServerToClientEvents, ClientToServerEvents>) => void) | null): void\n {\n const socketDetail: ISocketDetail = this.sockets[name];\n\n if (socketDetail.socket !== null) {\n // We already have a socket object (may or may not be connected)\n if (socketDetail.socket.connected === true) {\n socketDetail.socket.disconnect();\n }\n socketDetail.socket = null;\n if (isNode) {\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n }\n return;\n }\n\n let socketOptions: Partial<SocketOptions & ManagerOptions>;\n if (isNode) {\n // https://socket.io/docs/v4/client-options/#reconnection\n // https://github.com/socketio/engine.io-client#methods\n socketOptions = {\n transports: [\"websocket\" ]\n }\n if (this.#options.agentManager) {\n socketOptions.agent = this.#options.agentManager.GetAgent(socketDetail.address);\n }\n } else {\n socketOptions = {\n transports: [\"websocket\" ]\n }\n }\n socketDetail.socket = io(socketDetail.address, socketOptions) as Socket<ServerToClientEvents, ClientToServerEvents>\n\n socketDetail.socket.on(\"connect\", () => {\n if (socketDetail.socket) {\n this.#LogDebugMessage(`Socket: [${socketDetail.socket.id}]: connected`);\n\n if (onConnectCallBack) {\n setTimeout(() => {\n onConnectCallBack(socketDetail.socket as Socket<ServerToClientEvents, ClientToServerEvents>);\n }, 0);\n }\n\n if (socketEventsCallBack) {\n socketEventsCallBack(socketDetail.socket);\n }\n\n } else {\n const errorMessage: string = 'Could not get socket object from socket.io';\n this.#LogErrorMessage(errorMessage);\n socketDetail.errorCallBack(new Error(errorMessage));\n }\n })\n\n // https://socket.io/docs/v4/client-socket-instance/#disconnect\n socketDetail.socket.on(\"disconnect\", (reason: string) =>\n {\n this.#LogDebugMessage('socket disconnect: ' + reason);\n switch (reason) {\n case 'io server disconnect' : {\n // The server disconnect using disconnectSockets (i.e. normal safe shutdown)\n this.#LogDebugMessage('The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.');\n this.#LogDebugMessage('The connection will be re-established when the server becomes available.');\n const socketDetail: ISocketDetail = this.sockets[name];\n socketDetail.socket = null;\n if (isNode) {\n if (this.#options.agentManager) {\n this.#options.agentManager.ResetAgent();\n }\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n }\n }\n break;\n case 'io client disconnect' :\n this.#LogDebugMessage('The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.');\n this.#LogDebugMessage('The connection will not be re-established automatically.');\n // Do nothing\n break;\n case 'transport close' :\n case 'ping timeout' :\n case 'transport error' : {\n this.#LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);\n this.#LogDebugMessage('The connection will be re-established when the server becomes available.');\n const socketDetail: ISocketDetail = this.sockets[name];\n if (socketDetail.socket) {\n socketDetail.socket.disconnect();\n }\n socketDetail.socket = null;\n if (isNode) {\n if (this.#options.agentManager) {\n this.#options.agentManager?.ResetAgent();\n }\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100).unref(); //@@ config\n } else {\n setTimeout(() => this.#EstablishSocketConnect(name, onConnectCallBack, socketEventsCallBack), 100); //@@ config\n }\n }\n break;\n }\n });\n }\n}\n","/* eslint @typescript-eslint/no-explicit-any: 0, @typescript-eslint/no-unused-vars: 0 */ // --> OFF\nimport { JSONObject } from '@nsshunt/stsutils'\n\nimport { Server, Namespace, Socket } from \"socket.io\";\n\nimport { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents, STSServerSocket, ISocketIoServerHelper,\n ISocketIoServerHelperOptions, STSSocketIONamespace, STSSocketIONamespaces, STSNamespace,\n InterServerEvents, ServerEventCb } from './commonTypes'\n\nexport class SocketIoServerHelper<ClientToServerEvents extends STSDefaultClientToServerEvents, ServerToClientEvents extends STSDefaultServerToClientEvents> implements ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents>\n{\n #socketIoServerHelperOptions: ISocketIoServerHelperOptions\n #namespace: STSSocketIONamespaces = { };\n\n constructor(options: ISocketIoServerHelperOptions) { // IProcessBase\n this.#socketIoServerHelperOptions = options;\n }\n\n LogMessage(namespace: STSSocketIONamespace, message: any) {\n this.#socketIoServerHelperOptions.logger.debug(`${namespace.namespace}: ${message}`);\n }\n\n LeaveRoom = (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string): void => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: Leaving room [${room}]`);\n socket.leave(room);\n };\n\n JoinRoom = (namespace: STSSocketIONamespace, socket: Socket<ClientToServerEvents, ServerToClientEvents>, room: string): void => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: Socket joining room [${room}], ID: [${socket.id}]`);\n socket.join(room);\n };\n\n #SetupStandardEvents = (namespace: STSSocketIONamespace, socket: Socket<STSDefaultClientToServerEvents, STSDefaultServerToClientEvents>): void => {\n socket.on('disconnect', (reason: string) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnect, ID: [${socket.id}] [${reason}]`);\n });\n\n socket.on('disconnecting', (reason: string) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket disconnecting, ID: [${socket.id}] [${reason}]`);\n });\n\n socket.on('error', (error: Error) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: socket error, ID: [${socket.id}] [${error}]`);\n });\n\n socket.on(\"__STSdisconnect\", (reason: string) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnect: socket disconnect, ID: [${socket.id}] [${reason}]`);\n });\n\n socket.on(\"__STSdisconnecting\", (reason, callBackResult) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}: __STSdisconnecting: socket disconnecting, ID: [${socket.id}] [${reason}]`);\n callBackResult(\"__STSdisconnecting accepted by server.\");\n });\n\n socket.on('__STSjoinRoom', (rooms: string[]): void => { //@@ names\n rooms.forEach((room) => {\n this.JoinRoom(namespace, socket, room)\n });\n });\n\n socket.on('__STSleaveRoom', (rooms: string[]): void => { //@@ names\n rooms.forEach((room) => {\n this.LeaveRoom(namespace, socket, room);\n });\n });\n\n socket.on('__STSsendToRoom', (rooms: string[], payload: { command: string, payload: JSONObject }): void => {\n rooms.forEach((room) => {\n this.LogMessage(namespace, `${namespace.socketionamespace.name}:socket.on:sendToRoom: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}]`);\n \n namespace.socketionamespace.to(room).emit(payload.command as any, payload);\n });\n });\n }\n\n // Use this middleward to check every incomming connection\n #SetupConnectionMiddleware = (nameSpace: STSSocketIONamespace) => {\n nameSpace.socketionamespace.use((socket, next) => {\n //if (isValid(socket.request)) {\n const a=5; // for lint purposes\n if (a === 5) {\n next();\n } else {\n next(new Error(\"invalid\"));\n }\n });\n }\n\n // Use this middleware to check very packet being received\n #SetupMessageMiddleware = (socket: STSServerSocket) => {\n socket.use(([event, ...args], next) => {\n /*\n if (isUnauthorized(event)) {\n return next(new Error(\"unauthorized event\"));\n }\n */\n next();\n });\n }\n \n SetupNamespace = (io: Server, namespace: STSNamespace, rooms: string[], autoJoinRooms: boolean, /* serverSocketEvents: ServerSocketEvent[], */\n socketConnectCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null,\n socketEventsCallBack: ((socket: Socket<ClientToServerEvents, ServerToClientEvents, InterServerEvents>) => void) | null\n ): Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents> => {\n // Create STS Command Centre Client namespace\n this.#namespace[namespace] = {\n namespace: namespace,\n pid: process.pid,\n socketionamespace: io.of(`/${namespace}/`)\n }\n\n this.#SetupConnectionMiddleware(this.#namespace[namespace]);\n\n this.#namespace[namespace].socketionamespace.on(\"connection\", socket => {\n this.LogMessage(this.#namespace[namespace], `${namespace}: Socket connected, ID: [${socket.id}]`);\n this.LogMessage(this.#namespace[namespace], `${namespace}: Authentication Handshake: [${JSON.stringify(socket.handshake.auth)}]`);\n\n this.#SetupMessageMiddleware(socket);\n\n if (autoJoinRooms) {\n rooms.map((room) => {\n this.JoinRoom(this.#namespace[namespace], socket, room);\n });\n }\n\n this.#SetupStandardEvents(this.#namespace[namespace], socket);\n\n if (socketConnectCallBack) {\n setTimeout(() => {\n socketConnectCallBack(socket);\n }, 0);\n }\n\n if (socketEventsCallBack) {\n socketEventsCallBack(socket);\n }\n });\n\n return this.#namespace[namespace].socketionamespace as Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>;\n }\n\n GetSTSSocketIONamespace = (namespace: string): STSSocketIONamespace => {\n return this.#namespace[namespace];\n }\n\n GetSTSSocketIONamespaces = (): STSSocketIONamespaces => {\n return this.#namespace;\n }\n\n CloseAdaptors = async (): Promise<void> => {\n for (const [, namespace] of Object.entries(this.#namespace)) {\n await namespace.socketionamespace.adapter.close();\n }\n }\n\n DisconnectSockets = (): void => {\n for (const [, namespace] of Object.entries(this.#namespace)) {\n namespace.socketionamespace.disconnectSockets();\n }\n this.#namespace = { };\n }\n\n SetupEvent(event: ClientToServerEvents, eventCb: ServerEventCb): ISocketIoServerHelper<ClientToServerEvents, ServerToClientEvents> {\n return this as any;\n }\n}\n"],"names":["STSNamespace","STSRoom","STSEvent","io","socketDetail"],"mappings":"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","x_google_ignoreList":[1]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@nsshunt/stssocketioutils",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.7",
|
|
4
4
|
"description": "STS Socket.IO Utils",
|
|
5
5
|
"main": "./dist/stssocketioutils.umd.js",
|
|
6
6
|
"module": "./dist/stssocketioutils.mjs",
|
|
@@ -40,6 +40,7 @@
|
|
|
40
40
|
"devDependencies": {
|
|
41
41
|
"@eslint/eslintrc": "^3.2.0",
|
|
42
42
|
"@eslint/js": "^9.15.0",
|
|
43
|
+
"@nsshunt/stsconfig": "^1.27.6",
|
|
43
44
|
"@tsconfig/node20": "^20.1.4",
|
|
44
45
|
"@types/detect-node": "^2.0.2",
|
|
45
46
|
"@typescript-eslint/eslint-plugin": "^8.16.0",
|
|
@@ -49,11 +50,10 @@
|
|
|
49
50
|
"testcontainers": "^10.15.0",
|
|
50
51
|
"typescript": "^5.7.2",
|
|
51
52
|
"vite": "^5.4.11",
|
|
52
|
-
"vitest": "^2.1.
|
|
53
|
+
"vitest": "^2.1.6"
|
|
53
54
|
},
|
|
54
55
|
"dependencies": {
|
|
55
|
-
"@nsshunt/
|
|
56
|
-
"@nsshunt/stsutils": "^1.19.7",
|
|
56
|
+
"@nsshunt/stsutils": "^1.19.8",
|
|
57
57
|
"@socket.io/redis-streams-adapter": "^0.2.2",
|
|
58
58
|
"chalk": "^4.1.2",
|
|
59
59
|
"detect-node": "^2.1.0",
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { Socket } from 'socket.io-client';
|
|
2
|
-
import { ISTSLogger } from '@nsshunt/stsutils';
|
|
2
|
+
import { ISTSLogger, AgentManager } from '@nsshunt/stsutils';
|
|
3
3
|
import { STSDefaultClientToServerEvents, STSDefaultServerToClientEvents } from './commonTypes';
|
|
4
4
|
export type EventCb = (socket: any, data: any) => void;
|
|
5
5
|
export interface ISocketDetail {
|
|
@@ -10,14 +10,7 @@ export interface ISocketDetail {
|
|
|
10
10
|
}
|
|
11
11
|
export interface ISocketIoClientHelperOptions {
|
|
12
12
|
url?: string;
|
|
13
|
-
|
|
14
|
-
keepAlive: boolean;
|
|
15
|
-
maxSockets: number;
|
|
16
|
-
maxTotalSockets: number;
|
|
17
|
-
maxFreeSockets: number;
|
|
18
|
-
timeout: number;
|
|
19
|
-
rejectUnauthorized: boolean;
|
|
20
|
-
};
|
|
13
|
+
agentManager?: AgentManager;
|
|
21
14
|
logger?: ISTSLogger;
|
|
22
15
|
}
|
|
23
16
|
export declare class SocketIoClientHelper<ServerToClientEvents extends STSDefaultServerToClientEvents, ClientToServerEvents extends STSDefaultClientToServerEvents> {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"socketIoClientHelper.d.ts","sourceRoot":"","sources":["../src/socketIoClientHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAI5E,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;
|
|
1
|
+
{"version":3,"file":"socketIoClientHelper.d.ts","sourceRoot":"","sources":["../src/socketIoClientHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAI5E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAE5D,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAA;AAG9F,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,CAAA;AAoBtD,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAEhB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CACxC;AAED,MAAM,WAAW,4BAA4B;IAEzC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,MAAM,CAAC,EAAE,UAAU,CAAA;CACtB;AAED,qBAAa,oBAAoB,CAAC,oBAAoB,SAAS,8BAA8B,EAAE,oBAAoB,SAAS,8BAA8B;;gBAK1I,OAAO,EAAE,4BAA4B;IAcjD,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAE3C;IAED,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAC/C,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,EAChG,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,EACnG,aAAa,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GACxC,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IAWrD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IAI3E,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;CA8G/C"}
|