@nsshunt/stsrunnerframework 2.0.30 → 2.0.32

package/dist/index.mjs

@@ -63,6 +63,8 @@ var eIWMessageCommands = /* @__PURE__ */ function(eIWMessageCommands) {
 	eIWMessageCommands["RunnerStateChange"] = "__STS__RunnerStateChange";
 	eIWMessageCommands["GetRunners"] = "__STS__GetRunners";
 	eIWMessageCommands["GetRunnersResponse"] = "__STS__GetRunnersResponse";
+	eIWMessageCommands["PostWorkerMessage"] = "__STS__PostWorkerMessage";
+	eIWMessageCommands["PostWorkerMessageResponse"] = "__STS__PostWorkerMessageResponse";
 	return eIWMessageCommands;
 }({});
 var IRunnerState = /* @__PURE__ */ function(IRunnerState) {
@@ -1015,6 +1017,25 @@ var AbstractRunnerExecutionWorker = class {
 			this.#error(`#PostRunnersToWorkerManager(): [${error}]`);
 		}
 	};
+	#PostWorkerMessageToWorkerManager = async (messagePayload) => {
+		try {
+			if (this.#collectorCollectorPort) {
+				const response = await this.ProcessGenericWorkerMessage(messagePayload);
+				const message = {
+					command: eIWMessageCommands.PostWorkerMessageResponse,
+					payload: {
+						messageId: messagePayload.payload.messageId,
+						workerId: this.#workerId,
+						response
+					}
+				};
+				this.#collectorCollectorPort.postMessage(message);
+				await Sleep(0);
+			}
+		} catch (error) {
+			this.#error(`#PostWorkerMessageToWorkerManager(): [${error}]`);
+		}
+	};
 	/**
 	* Start a runner and, if valid, launch its execution loop.
 	*
@@ -1395,6 +1416,9 @@ var AbstractRunnerExecutionWorker = class {
 		}
 		this.#SendRunnerCommandResponse(eIWMessageCommands.UpdateRunnerResponse, testRunnerTelemetryPayload, result);
 	};
+	async ProcessGenericWorkerMessage(messagePayload) {
+		return {};
+	}
 	/**
 	* Main inbound message dispatcher for this worker runtime.
 	*
@@ -1474,6 +1498,10 @@ var AbstractRunnerExecutionWorker = class {
 					this.#silly(`ProcessMessage::GetRunners`);
 					this.#PostRunnersToWorkerManager(eIWMessageCommands.GetRunners, payloadMessage);
 					break;
+				case eIWMessageCommands.PostWorkerMessage:
+					this.#silly(`ProcessMessage::PostWorkerMessage`);
+					this.#PostWorkerMessageToWorkerManager(payloadMessage);
+					break;
 				default: this.#warn(`ProcessMessage::default: Invalid payloadMessage.command: [${payloadMessage.command}] - Ignoring`);
 			}
 		} catch (error) {
@@ -3234,10 +3262,11 @@ var STSMessageBroker = class {
 	* @param command Worker-level command to send.
 	* @returns Promise resolving with the response payload returned by the worker.
 	*/
-	SendMessageToWorkerForWorkerWithCallBack = async (workerEx, command) => {
+	SendMessageToWorkerForWorkerWithCallBack = async (workerEx, command, data) => {
 		return new Promise((resolve, reject) => {
 			try {
 				const payload = { messageId: this._SetupCallbackMessage(resolve, reject, command) };
+				if (data !== void 0) payload.data = data;
 				workerEx.messagePort.postMessage({
 					command,
 					payload
@@ -6630,6 +6659,27 @@ var STSWorkerManager = class {
 	GetNextAvailableWorker = () => {
 		return this.#workerRegistry.GetNextAvailableWorker();
 	};
+	PostWorkerMessage = async (workerIds, data) => {
+		try {
+			/**
+			* Resolve all live workers.
+			*
+			* Passing `[]` means "all workers" according to the registry convention.
+			*/
+			const workersEx = this.#workerRegistry.GetWorkersEx(workerIds);
+			/**
+			* Build a broker request promise for each worker.
+			*
+			* Each worker is asked to return its full current runner list.
+			*/
+			const promArray = [];
+			workersEx.forEach((workerEx) => promArray.push(this.#messageBroker.SendMessageToWorkerForWorkerWithCallBack(workerEx, eIWMessageCommands.PostWorkerMessage, data)));
+			return await Promise.all(promArray);
+		} catch (error) {
+			this.options.logger.error(`_SyncWorkerDataFromWorkers(): Error: [${error}]`);
+			throw error;
+		}
+	};
 };
 //#endregion
 //#region node_modules/@nsshunt/stssocketioutils/dist/tiny-emitter-DcZ69ZvJ.js
@@ -9974,6 +10024,7 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 	#socket;
 	#reconnectTimeout = 2e3;
 	#ackTimeout = 5e3;
+	#reconnectTimeoutVal = void 0;
 	constructor(name) {
 		super();
 		this.#name = name;
@@ -10046,7 +10097,7 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 		return this;
 	}
 	SetupSocket() {
-		if (!this.#address) throw new Error(`SocketIoClientHelper:SetupSocket(): Error: [address not provided]`);
+		if (!this.#address) throw new Error(`SocketIoClient:SetupSocket(): Error: [address not provided]`);
 		this.#EstablishSocketConnect();
 		return this;
 	}
@@ -10056,17 +10107,20 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 	EngineReconnect(attempt) {}
 	#EstablishSocketConnect() {
 		if (this.#socket !== void 0) {
-			if (this.#socket.connected === true) this.#socket.disconnect();
-			this.#socket = void 0;
-			if (isNode) setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
-			else setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
+			this.ResetSocket();
+			if (isNode) this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
+			else this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
 			return;
 		}
 		let socketOptions;
 		if (isNode) {
 			socketOptions = { transports: ["websocket"] };
 			if (this.#agentManager) {
-				if (!this.#address) throw new Error(`SocketIoClient:SetupSocket(): Error: [address not provided when using agentManager]`);
+				if (!this.#address) {
+					const message = `SocketIoClient:#EstablishSocketConnect(): Error: [address not provided when using agentManager]`;
+					this.LogErrorMessage(message);
+					throw new Error(message);
+				}
 				socketOptions.agent = this.#agentManager.GetAgent(this.#address);
 			}
 		} else socketOptions = { transports: ["websocket"] };
@@ -10077,30 +10131,30 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 		if (this.#socketIoCustomPath && this.#socketIoCustomPath.localeCompare("") !== 0) socketOptions.path = this.#socketIoCustomPath;
 		this.#socket = lookup(this.#address, socketOptions);
 		this.#socket.io.on("error", (err) => {
-			this.LogErrorMessage(`socketDetail.socket.io.on('error'): [${err}] Address: [${this.#address}]`);
+			this.LogErrorMessage(`SocketIoClient.socket.io.on('error'): [${err}] Address: [${this.#address}]`);
 			this.EngineError(err);
 		});
 		this.#socket.io.on("reconnect_error", (err) => {
-			this.LogErrorMessage(`socketDetail.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);
+			this.LogErrorMessage(`SocketIoClient.socket.io.on('reconnect_error'): [${err}] Address: [${this.#address}]`);
 			this.EngineReconnectError(err);
 		});
 		this.#socket.on("connect_error", (err) => {
-			this.LogErrorMessage(`socketDetail.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);
+			this.LogErrorMessage(`SocketIoClient.socket.on('connect_error'): [${err}] Address: [${this.#address}]`);
 			this.EngineConnectError(err);
 		});
 		this.#socket.io.on("reconnect", (attempt) => {
-			this.LogErrorMessage(`socketDetail.socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);
+			this.LogErrorMessage(`SocketIoClient:socket.io.on('reconnect'): Number: [${attempt}] Address: [${this.#address}]`);
 			this.EngineReconnect(attempt);
 		});
 		this.#socket.on("connect", () => {
 			if (this.#socket) {
-				this.LogDebugMessage(`Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);
+				this.LogDebugMessage(`SocketIoClient:on("connect"): Socket: [${this.#socket.id}]: connected, Address: [${this.#address}]`);
 				setTimeout(() => {
 					this.SocketConnect(this.#socket);
 				}, 0);
 				this.SetupSocketEvents(this.#socket);
 			} else {
-				const errorMessage = "Could not get socket object from socket.io, Address: [${socketDetail.address}]";
+				const errorMessage = "SocketIoClient:on(\"connect\"): Could not get socket object from socket.io, Address: [${socketDetail.address}]";
 				this.LogErrorMessage(errorMessage);
 				this.SocketConnectError(new Error(errorMessage));
 			}
@@ -10110,33 +10164,50 @@ var SocketIoClient = class extends import_tiny_emitter.TinyEmitter {
 			this.SocketDisconnect(reason);
 			switch (reason) {
 				case "io server disconnect":
-					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(), this.#reconnectTimeout).unref();
-					} else setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
+					this.LogDebugMessage("SocketIoClient:on(\"disconnect\"): The server disconnected using disconnectSockets, i.e. normal safe shutdown from explicit disconnection by the server.");
+					this.LogDebugMessage("SocketIoClient:on(\"disconnect\"): The connection will be re-established when the server becomes available.");
+					this.ResetSocket();
+					if (isNode) this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
+					else this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
 					break;
 				case "io client disconnect":
-					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.");
+					this.LogDebugMessage("SocketIoClient:on(\"disconnect\"): The client disconnected using disconnectSockets, i.e. normal safe disconnection from explicit disconnection by the client.");
+					this.LogDebugMessage("SocketIoClient:on(\"disconnect\"): The connection will not be re-established automatically.");
+					this.ResetSocket();
 					break;
 				case "transport close":
 				case "ping timeout":
 				case "transport error":
-					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();
-					this.#socket = void 0;
-					if (isNode) {
-						if (this.#agentManager) this.#agentManager?.ResetAgent();
-						setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
-					} else setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
+					this.LogDebugMessage(`SocketIoClient:on("disconnect"): Server unexpectedly disconnected. Reason: [${reason}]`);
+					this.LogDebugMessage("SocketIoClient:on(\"disconnect\"): The connection will be re-established when the server becomes available.");
+					this.ResetSocket();
+					if (isNode) this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout).unref();
+					else this.#reconnectTimeoutVal = setTimeout(() => this.#EstablishSocketConnect(), this.#reconnectTimeout);
 					break;
 			}
 		});
 	}
+	ResetSocket = () => {
+		try {
+			if (this.#reconnectTimeoutVal !== void 0) {
+				clearTimeout(this.#reconnectTimeoutVal);
+				this.#reconnectTimeoutVal = void 0;
+			}
+			if (this.#socket) {
+				this.#socket.removeAllListeners();
+				this.#socket.io.removeAllListeners();
+				if (this.#socket.connected === true) this.#socket.disconnect();
+				if (isNode) {
+					if (this.#agentManager) this.#agentManager.ResetAgent();
+				}
+				this.#socket = void 0;
+			}
+		} catch (error) {
+			const errorMessage = `SocketIoClient:ResetSocket(): Error: [${error}]`;
+			this.LogErrorMessage(errorMessage);
+			this.SocketConnectError(new Error(errorMessage));
+		}
+	};
 };
 //#endregion
 //#region src/wsevents.ts