@nsshunt/stsfhirclient 1.1.17 → 1.1.19

package/dist/stsfhirclient.mjs

@@ -4810,21 +4810,33 @@ class SocketIoClient extends tinyEmitterExports.TinyEmitter {
   #socketIoCustomPath;
   #authToken;
   #socket;
+  #reconnectTimeout = 2e3;
+  // default
   constructor(name) {
     super();
     this.#name = name;
   }
+  get logPrefix() {
+    return `SocketIoClient[${this.#name}]:`;
+  }
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   LogDebugMessage(message) {
-    if (this.#logger) this.#logger.debug(message);
+    if (this.#logger) this.#logger.debug(`${this.logPrefix}${message}`);
   }
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   LogErrorMessage(message) {
-    if (this.#logger) this.#logger.error(message);
+    if (this.#logger) this.#logger.error(`${this.logPrefix}${message}`);
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  LogWarningMessage(message) {
+    if (this.#logger) this.#logger.warn(`${this.logPrefix}${message}`);
   }
   get name() {
     return this.#name;
   }
+  get reconnectTimeout() {
+    return this.#reconnectTimeout;
+  }
   get agentManager() {
     return this.#agentManager;
   }
@@ -4863,6 +4875,10 @@ class SocketIoClient extends tinyEmitterExports.TinyEmitter {
     this.#agentManager = agentManager;
     return this;
   }
+  WithReconnectTimeout(reconnectTimeout) {
+    this.#reconnectTimeout = reconnectTimeout;
+    return this;
+  }
   SetupSocket() {
     if (!this.#address) {
       throw new Error(`SocketIoClientHelper:SetupSocket(): Error: [address not provided]`);
@@ -4870,14 +4886,18 @@ class SocketIoClient extends tinyEmitterExports.TinyEmitter {
     this.#EstablishSocketConnect();
     return this;
   }
+  // Engine Errors / Events
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  EngineError(error) {
+  }
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  ConnectCallBack(socket) {
+  EngineReconnectError(error) {
   }
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  SocketEventsCallBack(socket) {
+  EngineConnectError(error) {
   }
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  ErrorCallBack(error) {
+  EngineReconnect(attempt) {
   }
   /*
   emit<Ev extends EventNames<ClientToServerEvents>>(ev: Ev, ...args: EventParams<ClientToServerEvents, Ev>): Socket<ServerToClientEvents, ClientToServerEvents> {
@@ -4895,9 +4915,9 @@ class SocketIoClient extends tinyEmitterExports.TinyEmitter {
       }
       this.#socket = void 0;
       if (isNode) {
-        setTimeout(() => this.#EstablishSocketConnect(), 100).unref();
+        setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
       } else {
-        setTimeout(() => this.#EstablishSocketConnect(), 100);
+        setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
       }
       return;
     }
@@ -4908,7 +4928,7 @@ class SocketIoClient extends tinyEmitterExports.TinyEmitter {
       };
       if (this.#agentManager) {
         if (!this.#address) {
-          throw new Error(`SocketIoClientHelper:SetupSocket(): Error: [address not provided when using agentManager]`);
+          throw new Error(`SocketIoClient:SetupSocket(): Error: [address not provided when using agentManager]`);
         }
         socketOptions.agent = this.#agentManager.GetAgent(this.#address);
       }
@@ -4929,58 +4949,63 @@ class SocketIoClient extends tinyEmitterExports.TinyEmitter {
     }
     this.#socket = lookup(this.#address, socketOptions);
     this.#socket.io.on("error", (err) => {
-      this.LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.io.on('error'): [${err}] Address: [${this.#address}]`);
+      this.LogErrorMessage(`socketDetail.socket.io.on('error'): [${err}] Address: [${this.#address}]`);
+      this.EngineError(err);
     });
     this.#socket.io.on("reconnect_error", (err) => {
-      this.LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);
+      this.LogErrorMessage(`socketDetail.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);
+      this.EngineReconnectError(err);
     });
     this.#socket.on("connect_error", (err) => {
-      this.LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);
+      this.LogErrorMessage(`socketDetail.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);
+      this.EngineConnectError(err);
     });
     this.#socket.io.on("reconnect", (attempt) => {
-      this.LogErrorMessage(`SocketIoClientHelper(): socketDetail.socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);
+      this.LogErrorMessage(`socketDetail.socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);
+      this.EngineReconnect(attempt);
     });
     this.#socket.on("connect", () => {
       if (this.#socket) {
-        this.LogDebugMessage(`SocketIoClientHelper(): Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);
+        this.LogDebugMessage(`Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);
         setTimeout(() => {
-          this.ConnectCallBack(this.#socket);
+          this.SocketConnect(this.#socket);
         }, 0);
-        this.SocketEventsCallBack(this.#socket);
+        this.SetupSocketEvents(this.#socket);
       } else {
-        const errorMessage = "SocketIoClientHelper(): Could not get socket object from socket.io, Address: [${socketDetail.address}]";
+        const errorMessage = "Could not get socket object from socket.io, Address: [${socketDetail.address}]";
         this.LogErrorMessage(errorMessage);
-        this.ErrorCallBack(new Error(errorMessage));
+        this.SocketConnectError(new Error(errorMessage));
       }
     });
     this.#socket.on("disconnect", (reason) => {
-      this.LogDebugMessage("SocketIoClientHelper(): socket disconnect: " + reason);
+      this.LogDebugMessage("socket disconnect: " + reason);
+      this.SocketDisconnect(reason);
       switch (reason) {
         case "io server disconnect":
           {
-            this.LogDebugMessage("SocketIoClientHelper(): The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.");
-            this.LogDebugMessage("SocketIoClientHelper(): The connection will be re-established when the server becomes available.");
+            this.LogDebugMessage("The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.");
+            this.LogDebugMessage("The connection will be re-established when the server becomes available.");
             this.#socket = void 0;
             if (isNode) {
               if (this.#agentManager) {
                 this.#agentManager.ResetAgent();
               }
-              setTimeout(() => this.#EstablishSocketConnect(), 100).unref();
+              setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
             } else {
-              setTimeout(() => this.#EstablishSocketConnect(), 100);
+              setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
             }
           }
           break;
         case "io client disconnect":
-          this.LogDebugMessage("SocketIoClientHelper(): The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.");
-          this.LogDebugMessage("SocketIoClientHelper(): The connection will not be re-established automatically.");
+          this.LogDebugMessage("The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.");
+          this.LogDebugMessage("The connection will not be re-established automatically.");
           break;
         case "transport close":
         case "ping timeout":
         case "transport error":
           {
-            this.LogDebugMessage(`SocketIoClientHelper(): Server unexpectedly disconnected. Reason: [${reason}]`);
-            this.LogDebugMessage("SocketIoClientHelper(): The connection will be re-established when the server becomes available.");
+            this.LogDebugMessage(`Server unexpectedly disconnected. Reason: [${reason}]`);
+            this.LogDebugMessage("The connection will be re-established when the server becomes available.");
             if (this.#socket) {
               this.#socket.disconnect();
             }
@@ -4989,9 +5014,9 @@ class SocketIoClient extends tinyEmitterExports.TinyEmitter {
               if (this.#agentManager) {
                 this.#agentManager?.ResetAgent();
               }
-              setTimeout(() => this.#EstablishSocketConnect(), 100).unref();
+              setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
             } else {
-              setTimeout(() => this.#EstablishSocketConnect(), 100);
+              setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
             }
           }
           break;
@@ -5043,16 +5068,20 @@ class FhirSocketClient extends SocketIoClient {
     this.#options = options;
     this.#SetupWSSClient();
   }
-  ConnectCallBack(socket) {
+  SocketConnect(socket) {
     this.LogDebugMessage(chalk.green(`FhirSocketClient:#OnSocketConnected(): ID: [${this.#id}] clientName: [${this.name}]: --> connected`));
     if (this.#options.joinRooms.length > 0 && socket) {
       socket.emit("__STSjoinRoom", this.#options.joinRooms);
     }
   }
-  ErrorCallBack(error) {
+  SocketError(error) {
     this.LogErrorMessage(`FhirSocketClient:#SetupWSSClient(): Error clientName: [${this.name}]: SetupClientSideSocket call back: Error: [${error}]`);
   }
-  SocketEventsCallBack(socket) {
+  SocketConnectError(error) {
+  }
+  SocketDisconnect(reason) {
+  }
+  SetupSocketEvents(socket) {
   }
   #SetupWSSClient = async () => {
     console.log(chalk.yellow(`FhirSocketClient:#SetupWSSClient(): ID: [${this.#id}] clientName: [${this.name}] Starting ...`));