@nsshunt/stssocketioutils 2.0.32 → 2.0.34

package/dist/node.cjs

@@ -1,449 +1,382 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const stsutils = require("@nsshunt/stsutils");
-const socket_io = require("socket.io");
-const ioredis = require("ioredis");
-const clusterAdapter = require("@socket.io/cluster-adapter");
-const redisStreamsAdapter = require("@socket.io/redis-streams-adapter");
-const index = require("./index-CbgYj2D4.js");
-class SocketIoServer extends index.tinyEmitterExports.TinyEmitter {
-  namespace;
-  socketionamespace;
-  //protected socketionamespace?: Namespace<ClientToServerEvents, ServerToClientEvents, InterServerEvents>
-  logger;
-  io;
-  //#redisClient: RedisClientType | Redis | null = null;
-  redisClient;
-  listenPort;
-  socketIoCustomPath;
-  ioRedisMessageProcessorUrl;
-  serverClusterMode;
-  rooms;
-  serverName;
-  draining = false;
-  attached = false;
-  constructor(serverName) {
-    super();
-    this.serverName = serverName;
-  }
-  get logPrefix() {
-    if (this.namespace) {
-      return `SocketIoServer[${this.serverName}:${this.namespace}]: `;
-    } else {
-      return `SocketIoServer[${this.serverName}:<No Namespace>]: `;
-    }
-  }
-  LogErrorMessage(message) {
-    if (this.logger) {
-      this.logger.error(`${this.logPrefix}${message}`);
-    }
-  }
-  LogDebugMessage(message) {
-    if (this.logger) {
-      this.logger.debug(`${this.logPrefix}${message}`);
-    }
-  }
-  LogInfoMessage(message) {
-    if (this.logger) {
-      this.logger.info(`${this.logPrefix}${message}`);
-    }
-  }
-  LogWarnMessage(message) {
-    if (this.logger) {
-      this.logger.warn(`${this.logPrefix}${message}`);
-    }
-  }
-  LogSillyMessage(message) {
-    if (this.logger) {
-      this.logger.silly(`${this.logPrefix}${message}`);
-    }
-  }
-  LogVerboseMessage(message) {
-    if (this.logger) {
-      this.logger.verbose(`${this.logPrefix}${message}`);
-    }
-  }
-  LogHttpMessage(message) {
-    if (this.logger) {
-      this.logger.http(`${this.logPrefix}${message}`);
-    }
-  }
-  // https://socket.io/docs/v4/middlewares/
-  // https://socket.io/docs/v4/server-socket-instance/#sockethandshake
-  // https://socket.io/docs/v4/server-socket-instance/#socket-middlewares
-  // Use this middleward to check every incomming connection
-  SetupConnectionMiddleware = () => {
-  };
-  // Use this middleware to check every packet being received
-  SetupMessageMiddleware = (socket) => {
-  };
-  /*
-      protected GetConfig = (socketIoServeroptions: ISocketIoServerOpitons): Partial<ServerOptions> => {
-          //this.#redisClient = createClient({url: this.#options.ioRedisMessageProcessorUrl});
-          //await this.#redisClient.connect();
-          this.LogDebugMessage(`GetConfig() transports: [ [websocket] ]`);
-          const options: Partial<ServerOptions> = {
-              transports: [ "websocket" ], // or [ "websocket", "polling" ] (to use long-poolling. Note that the order matters)
-          }
-  
-          if (socketIoServeroptions.ioRedisMessageProcessorUrl && socketIoServeroptions.ioRedisMessageProcessorUrl !== '') {
-              this.redisClient = new Redis(socketIoServeroptions.ioRedisMessageProcessorUrl);
-              this.LogDebugMessage(`GetConfig() createAdapter(redis): redis url: [${socketIoServeroptions.ioRedisMessageProcessorUrl}]`);
-              options.adapter = createAdapter(this.redisClient) as any;
-          } else if (socketIoServeroptions.serverClusterMode && socketIoServeroptions.serverClusterMode === true) {
-              this.LogDebugMessage(`GetConfig() createAdapter(cluster)`);
-              options.adapter = clusterCreateAdapter() as any;
-          }
-  
-          if (socketIoServeroptions.wssCustomPath && socketIoServeroptions.wssCustomPath.localeCompare('') !== 0) {
-              this.LogDebugMessage(`GetConfig() wssCustomPath: [${socketIoServeroptions.wssCustomPath}]`);
-              options.path = socketIoServeroptions.wssCustomPath;
-          }
-  
-          return options;
-      }
-      */
-  SetEngineEvents = () => {
-    if (this.io) {
-      this.io.engine.on("connection_error", (err) => {
-        this.LogWarnMessage(`SetEngineEvents(): connection_error`);
-        this.LogWarnMessage(err.req);
-        this.LogWarnMessage(err.code);
-        this.LogWarnMessage(err.message);
-        this.LogWarnMessage(err.context);
-      });
-    }
-  };
-  WithLogger = (logger) => {
-    this.logger = logger;
-    return this;
-  };
-  WithListenPort = (listenPort) => {
-    this.listenPort = listenPort;
-    return this;
-  };
-  WithSocketIoCustomPath = (socketIoCustomPath) => {
-    this.socketIoCustomPath = socketIoCustomPath;
-    return this;
-  };
-  WithIoRedisMessageProcessorUrl = (ioRedisMessageProcessorUrl) => {
-    this.ioRedisMessageProcessorUrl = ioRedisMessageProcessorUrl;
-    return this;
-  };
-  WithClusterMode = (serverClusterMode) => {
-    this.serverClusterMode = serverClusterMode;
-    return this;
-  };
-  WithRooms = (rooms) => {
-    this.rooms = rooms;
-    return this;
-  };
-  WithNamespace = (namespace) => {
-    this.namespace = namespace;
-    return this;
-  };
-  AttachSocketIoServer = async (server) => {
-    if (!this.io) {
-      this.LogInfoMessage(`AttachServer(): io = server`);
-      this.io = server;
-      this.LogInfoMessage(`AttachServer(): attached = true`);
-      this.attached = true;
-      this.LogInfoMessage(`AttachServer(): SetupNamespace()`);
-      this.SetupNamespace();
-    } else {
-      const errorMessage = this.attached === true ? `AttachServer(): Server already exists (from AttachServer())` : `AttachServer(): Server already exists (from StartServer())`;
-      this.LogErrorMessage(errorMessage);
-      throw new Error(errorMessage);
-    }
-    return this;
-  };
-  StartSocketIoServer = async () => {
-    if (!this.namespace) {
-      const errorMessage = `StartServer(): Error: [namespace not specified]`;
-      this.LogErrorMessage(errorMessage);
-      throw new Error(errorMessage);
-    }
-    if (!this.io) {
-      if (!this.listenPort) {
-        const errorMessage = `StartServer(): Error: [listenPort not specified]`;
-        this.LogErrorMessage(errorMessage);
-        throw new Error(errorMessage);
-      }
-      this.LogDebugMessage(`StartServer(): draining = false`);
-      this.draining = false;
-      this.LogDebugMessage(`StartServer(): transports: [ [websocket] ]`);
-      const options = {
-        transports: ["websocket"]
-        // or [ "websocket", "polling" ] (to use long-poolling. Note that the order matters)
-      };
-      if (this.ioRedisMessageProcessorUrl && this.ioRedisMessageProcessorUrl !== "") {
-        this.redisClient = new ioredis.Redis(this.ioRedisMessageProcessorUrl);
-        this.LogDebugMessage(`StartServer(): createAdapter(redis): redis url: [${this.ioRedisMessageProcessorUrl}]`);
-        options.adapter = redisStreamsAdapter.createAdapter(this.redisClient);
-      } else if (this.serverClusterMode && this.serverClusterMode === true) {
-        this.LogDebugMessage(`StartServer(): createAdapter(cluster)`);
-        options.adapter = clusterAdapter.createAdapter();
-      }
-      if (this.socketIoCustomPath && this.socketIoCustomPath.localeCompare("") !== 0) {
-        this.LogDebugMessage(`StartServer(): socketIoCustomPath: [${this.socketIoCustomPath}]`);
-        options.path = this.socketIoCustomPath;
-      }
-      this.LogDebugMessage(`StartServer(): new Server(): listenPort: [${this.listenPort}]`);
-      this.io = new socket_io.Server(this.listenPort, options);
-      this.LogDebugMessage(`StartServer(): SetEngineEvents()`);
-      this.SetEngineEvents();
-      this.LogDebugMessage(`StartServer(): Sleeping ...`);
-      await stsutils.Sleep(500);
-      this.LogDebugMessage(`StartServer(): Done Sleeping`);
-      this.LogInfoMessage(`AttachServer(): attached = false`);
-      this.attached = false;
-      this.LogInfoMessage(`StartServer(): SetupNamespace()`);
-      this.SetupNamespace();
-    } else {
-      const errorMessage = this.attached === true ? `StartServer(): Server already exists (from AttachServer())` : `StartServer(): Server already exists (from StartServer())`;
-      this.LogErrorMessage(errorMessage);
-      throw new Error(errorMessage);
-    }
-    return this;
-  };
-  DetachSockerIoServer = async () => {
-    if (this.io) {
-      if (this.attached === true) {
-        this.LogInfoMessage(`DetachServer(): StopNamespace()`);
-        await this.StopNamespace();
-        this.io = void 0;
-        this.LogInfoMessage(`DetachServer(): attached = false`);
-        this.attached = false;
-      } else {
-        const errorMessage = `DetachServer(): Error: [Server has not been attached. Use StopServer() to stop the socker.io server.]`;
-        this.LogErrorMessage(errorMessage);
-        throw new Error(errorMessage);
-      }
-    } else {
-      const errorMessage = `DetachServer(): Error: [no server exists to DetachServer()]`;
-      this.LogErrorMessage(errorMessage);
-      throw new Error(errorMessage);
-    }
-  };
-  StopSocketIoServer = async () => {
-    if (this.io) {
-      if (this.attached === false) {
-        this.LogInfoMessage(`StopServer(): draining = true`);
-        this.draining = true;
-        this.LogInfoMessage(`StopServer(): StopNamespace()`);
-        await this.StopNamespace();
-        this.LogInfoMessage(`StopServer(): io.of('/').adapter.close()`);
-        await this.io.of("/").adapter.close();
-        if (this.redisClient) {
-          this.LogInfoMessage(`StopServer(): redisClient.disconnect()`);
-          await this.redisClient.disconnect();
-          this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Sleeping...)`);
-          await stsutils.Sleep(50);
-          this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Done Sleeping)`);
-        }
-        this.LogInfoMessage(`StopServer(): io.disconnectSockets()`);
-        this.io.disconnectSockets();
-        this.LogInfoMessage(`StopServer(): io.close()`);
-        this.io.close();
-        this.LogInfoMessage(`StopServer(): io = undefined`);
-        this.io = void 0;
-      } else {
-        const errorMessage = `StopServer(): Cannot stop an attached server. The server created must handle stop/disconnections. Use StopNamespace() instead.`;
-        this.LogErrorMessage(errorMessage);
-        throw new Error(errorMessage);
-      }
-    } else {
-      const errorMessage = `StopServer(): Error: [no server exists to StopServer()]`;
-      this.LogErrorMessage(errorMessage);
-      throw new Error(errorMessage);
-    }
-  };
-  LeaveRoom = (socket, room) => {
-    this.LogDebugMessage(`LeaveRoom(): Leaving room [${room}]`);
-    socket.leave(room);
-  };
-  JoinRoom = (socket, room) => {
-    this.LogDebugMessage(`JoinRoom(): Socket joining room [${room}], ID: [${socket.id}]`);
-    socket.join(room);
-  };
-  StopNamespace = async () => {
-    this.LogInfoMessage(`StopServer(): CloseNamespaceAdaptors()`);
-    await this.CloseNamespaceAdaptors();
-    this.LogInfoMessage(`StopServer(): DisconnectNamespaceSockets()`);
-    this.DisconnectNamespaceSockets();
-  };
-  SetupStandardEvents = (socket) => {
-    socket.on("disconnect", (reason) => {
-      this.LogDebugMessage(`SetupStandardEvents(): socket disconnect, ID: [${socket.id}], reason: [${reason}]`);
-      this.SocketDisconnect(socket, reason);
-    });
-    socket.on("disconnecting", (reason) => {
-      this.LogDebugMessage(`SetupStandardEvents(): socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);
-      this.SocketDisconnecting(socket, reason);
-    });
-    socket.on("error", (error) => {
-      this.LogDebugMessage(`SetupStandardEvents(): socket error, ID: [${socket.id}], Error: [${error}]`);
-      this.SocketError(socket, error);
-    });
-    socket.on("__STSdisconnect", (reason) => {
-      this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnect: socket disconnect, ID: [${socket.id}], reason: [${reason}]`);
-    });
-    socket.on("__STSdisconnecting", (reason, callBackResult) => {
-      this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnecting: socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);
-      callBackResult("__STSdisconnecting accepted by server.");
-    });
-    socket.on("__STSjoinRoom", (rooms) => {
-      rooms.forEach((room) => {
-        this.LogDebugMessage(`SetupStandardEvents(): __STSjoinRoom: room: [${room}], socket: [${socket.id}]`);
-        this.JoinRoom(socket, room);
-      });
-    });
-    socket.on("__STSleaveRoom", (rooms) => {
-      rooms.forEach((room) => {
-        this.LogDebugMessage(`SetupStandardEvents(): __STSleaveRoom: room: [${room}], socket: [${socket.id}]`);
-        this.LeaveRoom(socket, room);
-      });
-    });
-    socket.on("__STSsendToRoom", (rooms, payload) => {
-      rooms.forEach((room) => {
-        if (this.socketionamespace) {
-          this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}], Command: [${payload.command}]`);
-          this.socketionamespace.to(room).emit(payload.command, payload);
-        }
-      });
-    });
-    socket.on("__STSsendToRoomWithCallback", (room, timeout, payload, cb) => {
-      if (this.socketionamespace) {
-        this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);
-        this.socketionamespace.to(room).timeout(timeout).emit(payload.command, payload, (err, dataResponse) => {
-          if (err) {
-            console.error(err);
-            const errorResponse = {
-              error: true,
-              errorName: err.name,
-              errorMessage: err.message
-              //errorCause: err.cause,
-              //errorStack: err.stack
-            };
-            this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`);
-            cb(errorResponse);
-          } else {
-            this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`);
-            cb(dataResponse);
-          }
-        });
-      }
-    });
-    socket.on("__STSsendToRoomsWithCallback", (rooms, timeout, payload, cb) => {
-      const responses = [];
-      const timeoutForComplete = setTimeout(() => {
-        responses.push({
-          room: "",
-          responses: {
-            error: true,
-            errorName: "timeout",
-            errorMessage: `__STSsendToRoomsWithCallback timeout: [${timeout}] before all responses received`
-          }
-        });
-        cb(responses);
-      }, timeout).unref();
-      rooms.forEach((room) => {
-        if (this.socketionamespace) {
-          this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);
-          this.socketionamespace.to(room).timeout(timeout).emit(payload.command, payload, (err, dataResponse) => {
-            if (err) {
-              console.error(err);
-              const errorResponse = {
-                error: true,
-                errorName: err.name,
-                errorMessage: err.message
-                //errorCause: err.cause,
-                //errorStack: err.stack
-              };
-              this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`);
-              responses.push({
-                room,
-                responses: errorResponse
-              });
-            } else {
-              this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`);
-              responses.push({
-                room,
-                responses: dataResponse
-              });
-            }
-            if (responses.length === rooms.length) {
-              clearTimeout(timeoutForComplete);
-              this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: All complete, Responses Count: [${responses.length}] Invoke call back(responses)`);
-              cb(responses);
-            }
-          });
-        }
-      });
-    });
-  };
-  ConnectionDrainingConnectionMiddleware = () => {
-    if (this.socketionamespace) {
-      this.socketionamespace.use((socket, next) => {
-        if (this.draining === true) {
-          next(new Error(`ConnectionDrainingConnectionMiddleware(): Error: [server connections draining (from a server disconnect)]`));
-        } else {
-          next();
-        }
-      });
-    }
-  };
-  SetupNamespace = () => {
-    if (this.io) {
-      this.LogDebugMessage(`SetupNamespace(): socketionamespace = io.of('/${this.namespace}/'`);
-      this.socketionamespace = this.io.of(`/${this.namespace}/`);
-      this.LogDebugMessage(`SetupNamespace(): ConnectionDrainingConnectionMiddleware()`);
-      this.ConnectionDrainingConnectionMiddleware();
-      this.LogDebugMessage(`SetupNamespace(): SetupConnectionMiddleware()`);
-      this.SetupConnectionMiddleware();
-      this.socketionamespace.on("connection", (socket) => {
-        this.LogDebugMessage(`SetupNamespace(): Socket connected, ID: [${socket.id}]`);
-        this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (auth): [${JSON.stringify(socket.handshake.auth)}]`);
-        this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (host): [${JSON.stringify(socket.handshake.headers.host)}]`);
-        this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (url): [${JSON.stringify(socket.handshake.url)}]`);
-        this.LogDebugMessage(`SetupNamespace(): Authentication Handshake: [${JSON.stringify(socket.handshake)}]`);
-        this.LogDebugMessage(`SetupNamespace(): SetupMessageMiddleware(): Socket: [${socket.id}]`);
-        this.SetupMessageMiddleware(socket);
-        if (this.rooms && this.rooms.length > 0) {
-          this.rooms.map((room) => {
-            this.LogDebugMessage(`SetupNamespace(): Joining Room: [${room}], Socket: [${socket.id}]`);
-            this.JoinRoom(socket, room);
-          });
-        }
-        this.LogDebugMessage(`SetupNamespace(): SetupStandardEvents: Socket: [${socket.id}]`);
-        this.SetupStandardEvents(socket);
-        setTimeout(() => {
-          this.LogDebugMessage(`SetupNamespace(): SocketConnectCallBack(): Socket: [${socket.id}]`);
-          this.SocketConnect(socket);
-        }, 0);
-        this.LogDebugMessage(`SetupNamespace(): SocketEventsCallBack(): Socket: [${socket.id}]`);
-        this.SetupSocketEvents(socket);
-      });
-    } else {
-      const errorMessage = `SetupNamespace(): Error: [No server attached]`;
-      this.LogErrorMessage(errorMessage);
-      throw new Error(errorMessage);
-    }
-    return this;
-  };
-  CloseNamespaceAdaptors = async () => {
-    if (this.socketionamespace) {
-      this.LogDebugMessage(`CloseNamespaceAdaptors(): this.socketionamespace.adapter.close()`);
-      await this.socketionamespace.adapter.close();
-    }
-  };
-  DisconnectNamespaceSockets = () => {
-    if (this.socketionamespace) {
-      this.LogDebugMessage(`DisconnectNamespaceSockets(): this.socketionamespace.disconnectSockets()`);
-      this.socketionamespace.disconnectSockets();
-      this.socketionamespace = void 0;
-    }
-  };
-}
+const require_tiny_emitter$1 = require("./tiny-emitter-CL5wv3N6.js");
+let _nsshunt_stsutils = require("@nsshunt/stsutils");
+let socket_io = require("socket.io");
+let ioredis = require("ioredis");
+let _socket_io_cluster_adapter = require("@socket.io/cluster-adapter");
+let _socket_io_redis_streams_adapter = require("@socket.io/redis-streams-adapter");
+//#region src/socketIoServer.ts
+var import_tiny_emitter = require_tiny_emitter$1.require_tiny_emitter();
+var SocketIoServer = class extends import_tiny_emitter.TinyEmitter {
+	namespace;
+	socketionamespace;
+	logger;
+	io;
+	redisClient;
+	listenPort;
+	socketIoCustomPath;
+	ioRedisMessageProcessorUrl;
+	serverClusterMode;
+	rooms;
+	serverName;
+	draining = false;
+	attached = false;
+	constructor(serverName) {
+		super();
+		this.serverName = serverName;
+	}
+	get logPrefix() {
+		if (this.namespace) return `SocketIoServer[${this.serverName}:${this.namespace}]: `;
+		else return `SocketIoServer[${this.serverName}:<No Namespace>]: `;
+	}
+	LogErrorMessage(message) {
+		if (this.logger) this.logger.error(`${this.logPrefix}${message}`);
+	}
+	LogDebugMessage(message) {
+		if (this.logger) this.logger.debug(`${this.logPrefix}${message}`);
+	}
+	LogInfoMessage(message) {
+		if (this.logger) this.logger.info(`${this.logPrefix}${message}`);
+	}
+	LogWarnMessage(message) {
+		if (this.logger) this.logger.warn(`${this.logPrefix}${message}`);
+	}
+	LogSillyMessage(message) {
+		if (this.logger) this.logger.silly(`${this.logPrefix}${message}`);
+	}
+	LogVerboseMessage(message) {
+		if (this.logger) this.logger.verbose(`${this.logPrefix}${message}`);
+	}
+	LogHttpMessage(message) {
+		if (this.logger) this.logger.http(`${this.logPrefix}${message}`);
+	}
+	SetupConnectionMiddleware = () => {};
+	SetupMessageMiddleware = (socket) => {};
+	SetEngineEvents = () => {
+		if (this.io) this.io.engine.on("connection_error", (err) => {
+			this.LogWarnMessage(`SetEngineEvents(): connection_error`);
+			this.LogWarnMessage(err.req);
+			this.LogWarnMessage(err.code);
+			this.LogWarnMessage(err.message);
+			this.LogWarnMessage(err.context);
+		});
+	};
+	WithLogger = (logger) => {
+		this.logger = logger;
+		return this;
+	};
+	WithListenPort = (listenPort) => {
+		this.listenPort = listenPort;
+		return this;
+	};
+	WithSocketIoCustomPath = (socketIoCustomPath) => {
+		this.socketIoCustomPath = socketIoCustomPath;
+		return this;
+	};
+	WithIoRedisMessageProcessorUrl = (ioRedisMessageProcessorUrl) => {
+		this.ioRedisMessageProcessorUrl = ioRedisMessageProcessorUrl;
+		return this;
+	};
+	WithClusterMode = (serverClusterMode) => {
+		this.serverClusterMode = serverClusterMode;
+		return this;
+	};
+	WithRooms = (rooms) => {
+		this.rooms = rooms;
+		return this;
+	};
+	WithNamespace = (namespace) => {
+		this.namespace = namespace;
+		return this;
+	};
+	AttachSocketIoServer = async (server) => {
+		if (!this.io) {
+			this.LogInfoMessage(`AttachServer(): io = server`);
+			this.io = server;
+			this.LogInfoMessage(`AttachServer(): attached = true`);
+			this.attached = true;
+			this.LogInfoMessage(`AttachServer(): SetupNamespace()`);
+			this.SetupNamespace();
+		} else {
+			const errorMessage = this.attached === true ? `AttachServer(): Server already exists (from AttachServer())` : `AttachServer(): Server already exists (from StartServer())`;
+			this.LogErrorMessage(errorMessage);
+			throw new Error(errorMessage);
+		}
+		return this;
+	};
+	StartSocketIoServer = async () => {
+		if (!this.namespace) {
+			const errorMessage = `StartServer(): Error: [namespace not specified]`;
+			this.LogErrorMessage(errorMessage);
+			throw new Error(errorMessage);
+		}
+		if (!this.io) {
+			if (!this.listenPort) {
+				const errorMessage = `StartServer(): Error: [listenPort not specified]`;
+				this.LogErrorMessage(errorMessage);
+				throw new Error(errorMessage);
+			}
+			this.LogDebugMessage(`StartServer(): draining = false`);
+			this.draining = false;
+			this.LogDebugMessage(`StartServer(): transports: [ [websocket] ]`);
+			const options = { transports: ["websocket"] };
+			if (this.ioRedisMessageProcessorUrl && this.ioRedisMessageProcessorUrl !== "") {
+				this.redisClient = new ioredis.Redis(this.ioRedisMessageProcessorUrl);
+				this.LogDebugMessage(`StartServer(): createAdapter(redis): redis url: [${this.ioRedisMessageProcessorUrl}]`);
+				options.adapter = (0, _socket_io_redis_streams_adapter.createAdapter)(this.redisClient);
+			} else if (this.serverClusterMode && this.serverClusterMode === true) {
+				this.LogDebugMessage(`StartServer(): createAdapter(cluster)`);
+				options.adapter = (0, _socket_io_cluster_adapter.createAdapter)();
+			}
+			if (this.socketIoCustomPath && this.socketIoCustomPath.localeCompare("") !== 0) {
+				this.LogDebugMessage(`StartServer(): socketIoCustomPath: [${this.socketIoCustomPath}]`);
+				options.path = this.socketIoCustomPath;
+			}
+			this.LogDebugMessage(`StartServer(): new Server(): listenPort: [${this.listenPort}]`);
+			this.io = new socket_io.Server(this.listenPort, options);
+			this.LogDebugMessage(`StartServer(): SetEngineEvents()`);
+			this.SetEngineEvents();
+			this.LogDebugMessage(`StartServer(): Sleeping ...`);
+			await (0, _nsshunt_stsutils.Sleep)(500);
+			this.LogDebugMessage(`StartServer(): Done Sleeping`);
+			this.LogInfoMessage(`AttachServer(): attached = false`);
+			this.attached = false;
+			this.LogInfoMessage(`StartServer(): SetupNamespace()`);
+			this.SetupNamespace();
+		} else {
+			const errorMessage = this.attached === true ? `StartServer(): Server already exists (from AttachServer())` : `StartServer(): Server already exists (from StartServer())`;
+			this.LogErrorMessage(errorMessage);
+			throw new Error(errorMessage);
+		}
+		return this;
+	};
+	DetachSockerIoServer = async () => {
+		if (this.io) if (this.attached === true) {
+			this.LogInfoMessage(`DetachServer(): StopNamespace()`);
+			await this.StopNamespace();
+			this.io = void 0;
+			this.LogInfoMessage(`DetachServer(): attached = false`);
+			this.attached = false;
+		} else {
+			const errorMessage = `DetachServer(): Error: [Server has not been attached. Use StopServer() to stop the socker.io server.]`;
+			this.LogErrorMessage(errorMessage);
+			throw new Error(errorMessage);
+		}
+		else {
+			const errorMessage = `DetachServer(): Error: [no server exists to DetachServer()]`;
+			this.LogErrorMessage(errorMessage);
+			throw new Error(errorMessage);
+		}
+	};
+	StopSocketIoServer = async () => {
+		if (this.io) if (this.attached === false) {
+			this.LogInfoMessage(`StopServer(): draining = true`);
+			this.draining = true;
+			this.LogInfoMessage(`StopServer(): StopNamespace()`);
+			await this.StopNamespace();
+			this.LogInfoMessage(`StopServer(): io.of('/').adapter.close()`);
+			await this.io.of("/").adapter.close();
+			if (this.redisClient) {
+				this.LogInfoMessage(`StopServer(): redisClient.disconnect()`);
+				await this.redisClient.disconnect();
+				this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Sleeping...)`);
+				await (0, _nsshunt_stsutils.Sleep)(50);
+				this.LogInfoMessage(`StopServer(): redisClient.disconnect() (Done Sleeping)`);
+			}
+			this.LogInfoMessage(`StopServer(): io.disconnectSockets()`);
+			this.io.disconnectSockets();
+			this.LogInfoMessage(`StopServer(): io.close()`);
+			this.io.close();
+			this.LogInfoMessage(`StopServer(): io = undefined`);
+			this.io = void 0;
+		} else {
+			const errorMessage = `StopServer(): Cannot stop an attached server. The server created must handle stop/disconnections. Use StopNamespace() instead.`;
+			this.LogErrorMessage(errorMessage);
+			throw new Error(errorMessage);
+		}
+		else {
+			const errorMessage = `StopServer(): Error: [no server exists to StopServer()]`;
+			this.LogErrorMessage(errorMessage);
+			throw new Error(errorMessage);
+		}
+	};
+	LeaveRoom = (socket, room) => {
+		this.LogDebugMessage(`LeaveRoom(): Leaving room [${room}]`);
+		socket.leave(room);
+	};
+	JoinRoom = (socket, room) => {
+		this.LogDebugMessage(`JoinRoom(): Socket joining room [${room}], ID: [${socket.id}]`);
+		socket.join(room);
+	};
+	StopNamespace = async () => {
+		this.LogInfoMessage(`StopServer(): CloseNamespaceAdaptors()`);
+		await this.CloseNamespaceAdaptors();
+		this.LogInfoMessage(`StopServer(): DisconnectNamespaceSockets()`);
+		this.DisconnectNamespaceSockets();
+	};
+	SetupStandardEvents = (socket) => {
+		socket.on("disconnect", (reason) => {
+			this.LogDebugMessage(`SetupStandardEvents(): socket disconnect, ID: [${socket.id}], reason: [${reason}]`);
+			this.SocketDisconnect(socket, reason);
+		});
+		socket.on("disconnecting", (reason) => {
+			this.LogDebugMessage(`SetupStandardEvents(): socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);
+			this.SocketDisconnecting(socket, reason);
+		});
+		socket.on("error", (error) => {
+			this.LogDebugMessage(`SetupStandardEvents(): socket error, ID: [${socket.id}], Error: [${error}]`);
+			this.SocketError(socket, error);
+		});
+		socket.on("__STSdisconnect", (reason) => {
+			this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnect: socket disconnect, ID: [${socket.id}], reason: [${reason}]`);
+		});
+		socket.on("__STSdisconnecting", (reason, callBackResult) => {
+			this.LogDebugMessage(`SetupStandardEvents(): __STSdisconnecting: socket disconnecting, ID: [${socket.id}], reason: [${reason}]`);
+			callBackResult("__STSdisconnecting accepted by server.");
+		});
+		socket.on("__STSjoinRoom", (rooms) => {
+			rooms.forEach((room) => {
+				this.LogDebugMessage(`SetupStandardEvents(): __STSjoinRoom: room: [${room}], socket: [${socket.id}]`);
+				this.JoinRoom(socket, room);
+			});
+		});
+		socket.on("__STSleaveRoom", (rooms) => {
+			rooms.forEach((room) => {
+				this.LogDebugMessage(`SetupStandardEvents(): __STSleaveRoom: room: [${room}], socket: [${socket.id}]`);
+				this.LeaveRoom(socket, room);
+			});
+		});
+		socket.on("__STSsendToRoom", (rooms, payload) => {
+			rooms.forEach((room) => {
+				if (this.socketionamespace) {
+					this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoom: Sending to room [${room}], ID: [${socket.id}], Command: [${payload.command}]`);
+					this.socketionamespace.to(room).emit(payload.command, payload);
+				}
+			});
+		});
+		socket.on("__STSsendToRoomWithCallback", (room, timeout, payload, cb) => {
+			if (this.socketionamespace) {
+				this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);
+				this.socketionamespace.to(room).timeout(timeout).emit(payload.command, payload, (err, dataResponse) => {
+					if (err) {
+						console.error(err);
+						const errorResponse = {
+							error: true,
+							errorName: err.name,
+							errorMessage: err.message
+						};
+						this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`);
+						cb(errorResponse);
+					} else {
+						this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`);
+						cb(dataResponse);
+					}
+				});
+			}
+		});
+		socket.on("__STSsendToRoomsWithCallback", (rooms, timeout, payload, cb) => {
+			const responses = [];
+			const timeoutForComplete = setTimeout(() => {
+				responses.push({
+					room: "",
+					responses: {
+						error: true,
+						errorName: "timeout",
+						errorMessage: `__STSsendToRoomsWithCallback timeout: [${timeout}] before all responses received`
+					}
+				});
+				cb(responses);
+			}, timeout).unref();
+			rooms.forEach((room) => {
+				if (this.socketionamespace) {
+					this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: Sending to room [${room}], ID: [${socket.id}], timeout: [${timeout}], Command: [${payload.command}]`);
+					this.socketionamespace.to(room).timeout(timeout).emit(payload.command, payload, (err, dataResponse) => {
+						if (err) {
+							console.error(err);
+							const errorResponse = {
+								error: true,
+								errorName: err.name,
+								errorMessage: err.message
+							};
+							this.LogErrorMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast (error): [${JSON.stringify(errorResponse)}]`);
+							responses.push({
+								room,
+								responses: errorResponse
+							});
+						} else {
+							this.LogDebugMessage(`SetupStandardEvents(): __STSsendToRoomWithCallback broadcast: [${JSON.stringify(dataResponse)}]`);
+							responses.push({
+								room,
+								responses: dataResponse
+							});
+						}
+						if (responses.length === rooms.length) {
+							clearTimeout(timeoutForComplete);
+							this.LogDebugMessage(`SetupStandardEvents(): socket.on: __STSsendToRoomsWithCallback: All complete, Responses Count: [${responses.length}] Invoke call back(responses)`);
+							cb(responses);
+						}
+					});
+				}
+			});
+		});
+	};
+	ConnectionDrainingConnectionMiddleware = () => {
+		if (this.socketionamespace) this.socketionamespace.use((socket, next) => {
+			if (this.draining === true) next(/* @__PURE__ */ new Error(`ConnectionDrainingConnectionMiddleware(): Error: [server connections draining (from a server disconnect)]`));
+			else next();
+		});
+	};
+	SetupNamespace = () => {
+		if (this.io) {
+			this.LogDebugMessage(`SetupNamespace(): socketionamespace = io.of('/${this.namespace}/'`);
+			this.socketionamespace = this.io.of(`/${this.namespace}/`);
+			this.LogDebugMessage(`SetupNamespace(): ConnectionDrainingConnectionMiddleware()`);
+			this.ConnectionDrainingConnectionMiddleware();
+			this.LogDebugMessage(`SetupNamespace(): SetupConnectionMiddleware()`);
+			this.SetupConnectionMiddleware();
+			this.socketionamespace.on("connection", (socket) => {
+				this.LogDebugMessage(`SetupNamespace(): Socket connected, ID: [${socket.id}]`);
+				this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (auth): [${JSON.stringify(socket.handshake.auth)}]`);
+				this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (host): [${JSON.stringify(socket.handshake.headers.host)}]`);
+				this.LogDebugMessage(`SetupNamespace(): Authentication Handshake (url): [${JSON.stringify(socket.handshake.url)}]`);
+				this.LogDebugMessage(`SetupNamespace(): Authentication Handshake: [${JSON.stringify(socket.handshake)}]`);
+				this.LogDebugMessage(`SetupNamespace(): SetupMessageMiddleware(): Socket: [${socket.id}]`);
+				this.SetupMessageMiddleware(socket);
+				if (this.rooms && this.rooms.length > 0) this.rooms.map((room) => {
+					this.LogDebugMessage(`SetupNamespace(): Joining Room: [${room}], Socket: [${socket.id}]`);
+					this.JoinRoom(socket, room);
+				});
+				this.LogDebugMessage(`SetupNamespace(): SetupStandardEvents: Socket: [${socket.id}]`);
+				this.SetupStandardEvents(socket);
+				setTimeout(() => {
+					this.LogDebugMessage(`SetupNamespace(): SocketConnectCallBack(): Socket: [${socket.id}]`);
+					this.SocketConnect(socket);
+				}, 0);
+				this.LogDebugMessage(`SetupNamespace(): SocketEventsCallBack(): Socket: [${socket.id}]`);
+				this.SetupSocketEvents(socket);
+			});
+		} else {
+			const errorMessage = `SetupNamespace(): Error: [No server attached]`;
+			this.LogErrorMessage(errorMessage);
+			throw new Error(errorMessage);
+		}
+		return this;
+	};
+	CloseNamespaceAdaptors = async () => {
+		if (this.socketionamespace) {
+			this.LogDebugMessage(`CloseNamespaceAdaptors(): this.socketionamespace.adapter.close()`);
+			await this.socketionamespace.adapter.close();
+		}
+	};
+	DisconnectNamespaceSockets = () => {
+		if (this.socketionamespace) {
+			this.LogDebugMessage(`DisconnectNamespaceSockets(): this.socketionamespace.disconnectSockets()`);
+			this.socketionamespace.disconnectSockets();
+			this.socketionamespace = void 0;
+		}
+	};
+};
+//#endregion
 exports.SocketIoServer = SocketIoServer;
-//# sourceMappingURL=node.cjs.map
+
+//# sourceMappingURL=node.cjs.map