@powerlines/engine 0.15.0 → 0.15.1

package/dist/helpers/execution-host-worker.mjs

@@ -0,0 +1,307 @@
+import { getDefaultMode } from "@powerlines/core/lib/config";
+import { resolve } from "@stryke/fs/resolve";
+import { appendPath } from "@stryke/path/append";
+import { isNumber } from "@stryke/type-checks/is-number";
+import { isSet } from "@stryke/type-checks/is-set";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isString } from "@stryke/type-checks/is-string";
+import { formatDuration } from "date-fns/formatDuration";
+import { Worker } from "jest-worker";
+import { Transform } from "node:stream";
+import { parseArgs } from "node:util";
+
+//#region src/helpers/execution-host-worker.ts
+const RESTARTED = Symbol("powerlines-worker:restarted");
+/**
+* Formats the debug address into a string.
+*/
+const formatDebugAddress = ({ host, port }) => {
+	return host ? `${host}:${port}` : `${port}`;
+};
+/**
+* Get's the debug address from the `NODE_OPTIONS` environment variable. If the
+* address is not found, it returns the default host (`undefined`) and port
+* (`9229`).
+*
+* @returns An object with the host and port of the debug address.
+*/
+const getParsedDebugAddress = (address) => {
+	if (!address || !isString(address)) return {
+		host: void 0,
+		port: 9229
+	};
+	if (address.includes(":")) {
+		const [host, port] = address.split(":");
+		if (!host || !port) throw new Error(`Invalid debug address: ${address}`);
+		return {
+			host,
+			port: Number.parseInt(port, 10)
+		};
+	}
+	return {
+		host: void 0,
+		port: Number.parseInt(address, 10)
+	};
+};
+/**
+* Get the debug type from the `NODE_OPTIONS` environment variable.
+*/
+function getNodeDebugType(nodeOptions) {
+	if (nodeOptions.inspect) return "inspect";
+	if (nodeOptions["inspect-brk"] || nodeOptions.inspect_brk) return "inspect-brk";
+}
+const cleanupWorkers = (worker) => {
+	for (const curWorker of worker._workerPool?._workers || []) curWorker._child?.kill("SIGINT");
+};
+var ExecutionHostWorker = class ExecutionHostWorker {
+	#worker;
+	/**
+	* Creates a new instance of the ExecutionHostWorker class, which manages a worker process for executing tasks related to the Powerlines Engine. The worker is initialized with the specified options and can be used to run tasks in an isolated environment, with support for automatic restarts and activity monitoring.
+	*
+	* @param executionHostPath - The path to the Execution Host file.
+	* @param options - The options for configuring the worker, including the execution context, exposed methods, timeout, and mode.
+	* @returns A promise that resolves to an instance of the ExecutionHostWorker class.
+	*/
+	static async from(executionHostPath, options) {
+		const mode = await getDefaultMode(options.context.cwd);
+		const resolvedPath = await resolve(executionHostPath, { paths: [options.context.cwd, options.root ? appendPath(options.root, options.context.cwd) : void 0].filter(Boolean) });
+		if (!resolvedPath) throw new Error(`Could not resolve the provided Execution Host path: \`${executionHostPath}\`.`);
+		return new ExecutionHostWorker(resolvedPath, {
+			mode,
+			...options
+		});
+	}
+	/**
+	* Create a new worker instance.
+	*
+	* @param executionHostPath - The path to the worker file.
+	* @param options - The options for the worker, including exposed methods, timeout, and hooks for activity and restart.
+	*/
+	constructor(executionHostPath, options) {
+		this.executionHostPath = executionHostPath;
+		this.options = options;
+		const { timeout = 9e5, isolatedMemory = false, mode = "production", context, executionMethods } = this.options;
+		const logger = context.extendLogger({ category: "communication" });
+		let restartPromise;
+		let resolveRestartPromise;
+		let activeTasks = 0;
+		this.#worker = void 0;
+		process.on("exit", () => {
+			this.close();
+		});
+		let nodeOptions = {};
+		const args = [...process.execArgv];
+		if (process.env.NODE_OPTIONS) {
+			let isInString = false;
+			let willStartNewArg = true;
+			for (let i = 0; i < process.env.NODE_OPTIONS.length; i++) {
+				let char = process.env.NODE_OPTIONS[i];
+				if (char) {
+					if (char === "\\" && isInString) {
+						if (process.env.NODE_OPTIONS.length === i + 1) throw new Error("Invalid escape character at the end.");
+						char = process.env.NODE_OPTIONS[++i];
+						if (!char) continue;
+					} else if (char === " " && !isInString) {
+						willStartNewArg = true;
+						continue;
+					} else if (char === "\"") {
+						isInString = !isInString;
+						continue;
+					}
+					if (willStartNewArg) {
+						args.push(char);
+						willStartNewArg = false;
+					} else args[args.length - 1] += char;
+				}
+			}
+			if (isInString) throw new Error("Unterminated string");
+		}
+		if (args.length > 0) {
+			const { values, tokens } = parseArgs({
+				args,
+				strict: false,
+				tokens: true
+			});
+			nodeOptions = values;
+			let orphan = null;
+			for (let i = 0; i < tokens.length; i++) {
+				const token = tokens[i];
+				if (!token) continue;
+				if (token.kind === "option-terminator") break;
+				if (token.kind === "option") {
+					orphan = !isSet(token.value) ? token : null;
+					continue;
+				}
+				if (token.kind !== "positional") {
+					orphan = null;
+					continue;
+				}
+				if (!orphan) continue;
+				if (orphan.name in nodeOptions && isString(nodeOptions[orphan.name])) nodeOptions[orphan.name] += ` ${token.value}`;
+				else nodeOptions[orphan.name] = token.value;
+			}
+		}
+		const originalOptions = { ...nodeOptions };
+		delete nodeOptions.inspect;
+		delete nodeOptions["inspect-brk"];
+		delete nodeOptions.inspect_brk;
+		if (mode === "development") {
+			const nodeDebugType = getNodeDebugType(originalOptions);
+			if (nodeDebugType) {
+				const debuggerAddress = getParsedDebugAddress(originalOptions[nodeDebugType]);
+				const address = {
+					host: debuggerAddress.host,
+					port: debuggerAddress.port === 0 ? 0 : debuggerAddress.port + 1 + 1
+				};
+				nodeOptions[nodeDebugType] = formatDebugAddress(address);
+			}
+			nodeOptions["enable-source-maps"] = true;
+		}
+		if (isolatedMemory) {
+			delete nodeOptions["max-old-space-size"];
+			delete nodeOptions.max_old_space_size;
+		}
+		const execArgv = [];
+		const nodeOptionsParts = [];
+		for (const [key, value] of Object.entries(nodeOptions)) {
+			let formatted = null;
+			if (value === true) formatted = `--${key}`;
+			else if (value) formatted = `--${key}=${value.includes(" ") && !value.startsWith("\"") ? JSON.stringify(value) : value}`;
+			if (formatted === null) continue;
+			if ([
+				"experimental-network-inspection",
+				"experimental-storage-inspection",
+				"experimental-worker-inspection",
+				"experimental-inspector-network-resource"
+			].includes(key)) execArgv.push(formatted);
+			else nodeOptionsParts.push(formatted);
+		}
+		const onHanging = () => {
+			const worker = this.#worker;
+			if (!worker) return;
+			const resolve = resolveRestartPromise;
+			createWorker();
+			logger.warn(`Sending SIGTERM signal to worker due to timeout${timeout ? ` of ${formatDuration({ seconds: timeout / 1e3 })}` : ""}. Subsequent errors may be a result of the worker exiting.`);
+			worker.end().then(() => {
+				resolve(RESTARTED);
+			});
+		};
+		let hangingTimer = false;
+		const onActivity = () => {
+			if (hangingTimer) clearTimeout(hangingTimer);
+			hangingTimer = activeTasks > 0 && setTimeout(onHanging, timeout);
+		};
+		const createWorker = () => {
+			const env = {
+				...process.env,
+				NODE_ENV: mode,
+				NODE_OPTIONS: nodeOptionsParts.join(" "),
+				POWERLINES_EXECUTION_HOST_WORKER: "true"
+			};
+			if (env.FORCE_COLOR === void 0) {
+				if (!env.NO_COLOR && !env.CI && env.TERM !== "dumb" && (process.stdout.isTTY || process.stderr?.isTTY)) env.FORCE_COLOR = "1";
+			}
+			this.#worker = new Worker(executionHostPath, {
+				maxRetries: 0,
+				computeWorkerKey: (_, ...args) => {
+					let executionId = "default";
+					let configIndex = 0;
+					if (args.length > 0 && isSetObject(args[0])) {
+						const arg = args[0];
+						if (isSetObject(arg.options)) {
+							configIndex = arg.options.configIndex ?? 0;
+							executionId = arg.options.executionId || "default";
+						}
+					}
+					return `${executionId}-${configIndex}`;
+				},
+				forkOptions: {
+					execArgv,
+					env
+				}
+			});
+			restartPromise = new Promise((resolve) => {
+				resolveRestartPromise = resolve;
+			});
+			for (const worker of this.#worker._workerPool?._workers || []) {
+				worker._child?.on("exit", (code, signal) => {
+					logger.debug(`Worker process exited with code ${code} and signal ${signal}`);
+					if ((code || signal && signal !== "SIGINT") && this.#worker) {
+						const error = /* @__PURE__ */ new Error(`Execution Host Worker exited unexpectedly with code ${code} and signal ${signal}`);
+						logger.error(error);
+						throw error;
+					}
+				});
+				worker._child?.on("error", (error) => {
+					logger.error({
+						meta: { category: "communication" },
+						message: `Worker process emitted an error: ${error.message}`,
+						error
+					});
+				});
+				worker._child?.on("message", (data) => {
+					onActivity();
+					if (Array.isArray(data) && data.length > 1 && isNumber(data[0])) if (data[0] === 0) logger.trace(`Received message from worker: ${JSON.stringify(data.slice(1), null, 2)}`);
+					else logger.debug(`Received error message from worker: ${JSON.stringify(data.slice(1), null, 2)}`);
+					logger.trace(`Received message from worker: ${JSON.stringify(data, null, 2)}`);
+				});
+			}
+			let aborted = false;
+			const onActivityAbort = () => {
+				if (!aborted) aborted = true;
+			};
+			const abortActivityStreamOnLog = new Transform({ transform(_chunk, _encoding, callback) {
+				onActivityAbort();
+				callback();
+			} });
+			this.#worker.getStdout().pipe(abortActivityStreamOnLog);
+			this.#worker.getStderr().pipe(abortActivityStreamOnLog);
+			this.#worker.getStdout().pipe(process.stdout);
+			this.#worker.getStderr().pipe(process.stderr);
+		};
+		createWorker();
+		for (const method of executionMethods) {
+			if (method.startsWith("_")) continue;
+			this[method] = timeout ? async (...args) => {
+				activeTasks++;
+				try {
+					let attempts = 0;
+					for (;;) {
+						onActivity();
+						const result = await Promise.race([this.#worker[method](args.length > 0 && args[0] ? args[0] : {}), restartPromise]);
+						if (result !== RESTARTED) return result;
+						logger.warn(`Execution Host Worker was restarted while calling method "${method}" (attempt ${attempts++}). Retrying the call...`);
+					}
+				} finally {
+					activeTasks--;
+					onActivity();
+				}
+			} : this.#worker[method].bind(this.#worker);
+		}
+	}
+	/**
+	* Ends the worker process and cleans up any resources associated with it. This method should be called when the worker is no longer needed, to ensure that it is properly terminated and does not continue to consume system resources. If the worker is already terminated or was never initialized, this method will throw an error.
+	*
+	* @returns A promise that resolves when the worker has been successfully terminated.
+	*/
+	async end() {
+		const worker = this.#worker;
+		if (!worker) throw new Error("Execution Host Worker is not initialized");
+		cleanupWorkers(worker);
+		this.#worker = void 0;
+		return worker.end();
+	}
+	/**
+	* Quietly end the worker if it exists
+	*/
+	close() {
+		if (this.#worker) {
+			cleanupWorkers(this.#worker);
+			this.#worker.end();
+		}
+	}
+};
+
+//#endregion
+export { ExecutionHostWorker };
+//# sourceMappingURL=execution-host-worker.mjs.map

package/dist/helpers/execution-host-worker.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-host-worker.mjs","names":["#worker","JestWorker"],"sources":["../../src/helpers/execution-host-worker.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Mode } from \"@powerlines/core\";\nimport { getDefaultMode } from \"@powerlines/core/lib/config\";\nimport { resolve } from \"@stryke/fs/resolve\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isSet } from \"@stryke/type-checks/is-set\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { formatDuration } from \"date-fns/formatDuration\";\nimport { Worker as JestWorker } from \"jest-worker\";\nimport type { ChildProcess } from \"node:child_process\";\nimport { Transform } from \"node:stream\";\nimport { parseArgs } from \"node:util\";\nimport { ExecutionHost, ExecutionHostParams } from \"../types/api\";\nimport { EngineContext } from \"../types/context\";\n\nconst RESTARTED = Symbol(\"powerlines-worker:restarted\");\n\n/**\n * The debug address is in the form of `[host:]port`. The host is optional.\n */\ninterface DebugAddress {\n  host?: string;\n  port: number;\n}\n\n/**\n * Formats the debug address into a string.\n */\nconst formatDebugAddress = ({ host, port }: DebugAddress): string => {\n  return host ? `${host}:${port}` : `${port}`;\n};\n\nexport type NodeOptions = Record<string, string | boolean | undefined>;\n\n/**\n * Get's the debug address from the `NODE_OPTIONS` environment variable. If the\n * address is not found, it returns the default host (`undefined`) and port\n * (`9229`).\n *\n * @returns An object with the host and port of the debug address.\n */\nconst getParsedDebugAddress = (\n  address: string | boolean | undefined\n): DebugAddress => {\n  if (!address || !isString(address)) {\n    return { host: undefined, port: 9229 };\n  }\n\n  // The address is in the form of `[host:]port`. Let's parse the address.\n  if (address.includes(\":\")) {\n    const [host, port] = address.split(\":\");\n    if (!host || !port) {\n      throw new Error(`Invalid debug address: ${address}`);\n    }\n\n    return { host, port: Number.parseInt(port, 10) };\n  }\n\n  return { host: undefined, port: Number.parseInt(address, 10) };\n};\n\ntype NodeInspectType = \"inspect\" | \"inspect-brk\" | undefined;\n\n/**\n * Get the debug type from the `NODE_OPTIONS` environment variable.\n */\nfunction getNodeDebugType(nodeOptions: NodeOptions): NodeInspectType {\n  if (nodeOptions.inspect) {\n    return \"inspect\";\n  }\n  if (nodeOptions[\"inspect-brk\"] || nodeOptions.inspect_brk) {\n    return \"inspect-brk\";\n  }\n\n  return undefined;\n}\n\nconst cleanupWorkers = (worker: JestWorker) => {\n  for (const curWorker of ((worker as any)._workerPool?._workers || []) as {\n    _child?: ChildProcess;\n  }[]) {\n    curWorker._child?.kill(\"SIGINT\");\n  }\n};\n\nexport interface ExecutionHostWorkerOptions<\n  TExecutionAPI extends ReadonlyArray<string>\n> {\n  // /**\n  //  * `-1` if not inspectable\n  //  */\n  // debuggerPortOffset?: number;\n\n  // /**\n  //  * Whether to enable source maps support in the worker, which can improve the quality of stack traces at the cost of increased memory usage and slower performance. Defaults to `false`.\n  //  */\n  // enableSourceMaps?: boolean;\n\n  /**\n   * The maximum time in milliseconds a worker can run before being terminated.\n   *\n   * @defaultValue 900000 (15 minutes)\n   */\n  timeout?: number;\n\n  /**\n   * True if `--max-old-space-size` should not be forwarded to the worker.\n   */\n  isolatedMemory?: boolean;\n\n  /**\n   * The mode to run the worker in, which can affect how the worker is initialized and how it behaves. This is determined based on the resolved configuration of the engine, and can be used to optimize the worker for different environments (e.g., development, production, etc.).\n   */\n  mode?: Mode;\n\n  /**\n   * An optional root to resolve the execution host path from, which can be used to specify a custom root directory for the worker to use when resolving paths and loading configuration files. If this option is not provided, the worker will use the current working directory as the root directory by default.\n   */\n  root?: string;\n\n  /**\n   * The context of the {@link @powerlines/engine#Engine | Engine instance}, which can be used to access the engine's state and services within the worker.\n   */\n  context: EngineContext;\n\n  /**\n   * An array of method names that the worker exposes. These methods will be available on the Worker instance and can be called to execute tasks in the worker process.\n   */\n  executionMethods: TExecutionAPI;\n}\n\nexport class ExecutionHostWorker<TExecutionAPI extends ReadonlyArray<string>> {\n  #worker: JestWorker | undefined;\n\n  /**\n   * Creates a new instance of the ExecutionHostWorker class, which manages a worker process for executing tasks related to the Powerlines Engine. The worker is initialized with the specified options and can be used to run tasks in an isolated environment, with support for automatic restarts and activity monitoring.\n   *\n   * @param executionHostPath - The path to the Execution Host file.\n   * @param options - The options for configuring the worker, including the execution context, exposed methods, timeout, and mode.\n   * @returns A promise that resolves to an instance of the ExecutionHostWorker class.\n   */\n  public static async from<TExecutionAPI extends ReadonlyArray<string>>(\n    executionHostPath: string,\n    options: ExecutionHostWorkerOptions<TExecutionAPI>\n  ) {\n    const mode = await getDefaultMode(options.context.cwd);\n\n    const resolvedPath = await resolve(executionHostPath, {\n      paths: [\n        options.context.cwd,\n        options.root ? appendPath(options.root, options.context.cwd) : undefined\n      ].filter(Boolean) as string[]\n    });\n    if (!resolvedPath) {\n      throw new Error(\n        `Could not resolve the provided Execution Host path: \\`${executionHostPath}\\`.`\n      );\n    }\n\n    return new ExecutionHostWorker<TExecutionAPI>(resolvedPath, {\n      mode,\n      ...options\n    }) as unknown as ExecutionHost<TExecutionAPI>;\n  }\n\n  /**\n   * Create a new worker instance.\n   *\n   * @param executionHostPath - The path to the worker file.\n   * @param options - The options for the worker, including exposed methods, timeout, and hooks for activity and restart.\n   */\n  public constructor(\n    protected executionHostPath: string,\n    protected options: ExecutionHostWorkerOptions<TExecutionAPI>\n  ) {\n    const {\n      timeout = 900_000,\n      isolatedMemory = false,\n      mode = \"production\",\n      context,\n      executionMethods\n    } = this.options;\n\n    const logger = context.extendLogger({ category: \"communication\" });\n\n    let restartPromise: Promise<typeof RESTARTED>;\n    let resolveRestartPromise: (arg: typeof RESTARTED) => void;\n    let activeTasks = 0;\n\n    this.#worker = undefined;\n\n    // ensure we end workers if they weren't before exit\n    process.on(\"exit\", () => {\n      this.close();\n    });\n\n    let nodeOptions = {} as {\n      [longOption: string]: string | boolean | undefined;\n    };\n\n    const args: string[] = [...process.execArgv];\n    if (process.env.NODE_OPTIONS) {\n      let isInString = false;\n      let willStartNewArg = true;\n      for (let i = 0; i < process.env.NODE_OPTIONS.length; i++) {\n        let char = process.env.NODE_OPTIONS[i];\n        if (char) {\n          // Skip any escaped characters in strings.\n          if (char === \"\\\\\" && isInString) {\n            // Ensure we don't have an escape character at the end.\n            if (process.env.NODE_OPTIONS.length === i + 1) {\n              throw new Error(\"Invalid escape character at the end.\");\n            }\n\n            // Skip the next character.\n            char = process.env.NODE_OPTIONS[++i];\n            if (!char) {\n              continue;\n            }\n          }\n          // If we find a space outside of a string, we should start a new argument.\n          else if (char === \" \" && !isInString) {\n            willStartNewArg = true;\n            continue;\n          }\n\n          // If we find a quote, we should toggle the string flag.\n          else if (char === '\"') {\n            isInString = !isInString;\n            continue;\n          }\n\n          // If we're starting a new argument, we should add it to the array.\n          if (willStartNewArg) {\n            args.push(char);\n            willStartNewArg = false;\n          }\n          // Otherwise, add it to the last argument.\n          else {\n            args[args.length - 1] += char;\n          }\n        }\n      }\n\n      if (isInString) {\n        throw new Error(\"Unterminated string\");\n      }\n    }\n\n    if (args.length > 0) {\n      const { values, tokens } = parseArgs({\n        args,\n        strict: false,\n        tokens: true\n      });\n      nodeOptions = values;\n\n      // For the `NODE_OPTIONS`, we support arguments with values without the `=`\n      // sign. We need to parse them manually.\n      let orphan = null;\n      for (let i = 0; i < tokens.length; i++) {\n        const token = tokens[i];\n        if (!token) continue;\n\n        if (token.kind === \"option-terminator\") {\n          break;\n        }\n\n        // When we encounter an option, if it's value is undefined, we should check\n        // to see if the following tokens are positional parameters. If they are,\n        // then the option is orphaned, and we can assign it.\n        if (token.kind === \"option\") {\n          orphan = !isSet(token.value) ? token : null;\n          continue;\n        }\n\n        // If the token isn't a positional one, then we can't assign it to the found\n        // orphaned option.\n        if (token.kind !== \"positional\") {\n          orphan = null;\n          continue;\n        }\n\n        // If we don't have an orphan, then we can skip this token.\n        if (!orphan) {\n          continue;\n        }\n\n        // If the token is a positional one, and it has a value, so add it to the\n        // values object. If it already exists, append it with a space.\n        if (orphan.name in nodeOptions && isString(nodeOptions[orphan.name])) {\n          nodeOptions[orphan.name] += ` ${token.value}`;\n        } else {\n          nodeOptions[orphan.name] = token.value;\n        }\n      }\n    }\n\n    const originalOptions = { ...nodeOptions };\n\n    delete nodeOptions.inspect;\n    delete nodeOptions[\"inspect-brk\"];\n    delete nodeOptions.inspect_brk;\n\n    if (mode === \"development\") {\n      const nodeDebugType = getNodeDebugType(originalOptions);\n      if (nodeDebugType) {\n        const debuggerAddress = getParsedDebugAddress(\n          originalOptions[nodeDebugType]\n        );\n        const address: DebugAddress = {\n          host: debuggerAddress.host,\n          // current process runs on `address.port`\n          port: debuggerAddress.port === 0 ? 0 : debuggerAddress.port + 1 + 1\n        };\n        nodeOptions[nodeDebugType] = formatDebugAddress(address);\n      }\n\n      nodeOptions[\"enable-source-maps\"] = true;\n    }\n\n    if (isolatedMemory) {\n      delete nodeOptions[\"max-old-space-size\"];\n      delete nodeOptions.max_old_space_size;\n    }\n\n    const execArgv: string[] = [];\n    const nodeOptionsParts: string[] = [];\n    for (const [key, value] of Object.entries(nodeOptions)) {\n      let formatted: string | null = null;\n      if (value === true) {\n        formatted = `--${key}`;\n      } else if (value) {\n        formatted = `--${key}=${\n          // Values with spaces need to be quoted. We use JSON.stringify to\n          // also escape any nested quotes.\n          value.includes(\" \") && !value.startsWith('\"')\n            ? JSON.stringify(value)\n            : value\n        }`;\n      }\n\n      if (formatted === null) {\n        continue;\n      }\n\n      if (\n        [\n          \"experimental-network-inspection\",\n          \"experimental-storage-inspection\",\n          \"experimental-worker-inspection\",\n          \"experimental-inspector-network-resource\"\n        ].includes(key)\n      ) {\n        execArgv.push(formatted);\n      } else {\n        nodeOptionsParts.push(formatted);\n      }\n    }\n\n    const onHanging = () => {\n      const worker = this.#worker;\n      if (!worker) {\n        return;\n      }\n\n      const resolve = resolveRestartPromise;\n      // eslint-disable-next-line ts/no-use-before-define\n      createWorker();\n\n      logger.warn(\n        `Sending SIGTERM signal to worker due to timeout${\n          timeout ? ` of ${formatDuration({ seconds: timeout / 1000 })}` : \"\"\n        }. Subsequent errors may be a result of the worker exiting.`\n      );\n\n      void worker.end().then(() => {\n        resolve(RESTARTED);\n      });\n    };\n\n    let hangingTimer: NodeJS.Timeout | false = false;\n\n    const onActivity = () => {\n      if (hangingTimer) {\n        clearTimeout(hangingTimer);\n      }\n\n      hangingTimer = activeTasks > 0 && setTimeout(onHanging, timeout);\n    };\n\n    const createWorker = () => {\n      const env: NodeJS.ProcessEnv = {\n        ...process.env,\n        NODE_ENV: mode,\n        NODE_OPTIONS: nodeOptionsParts.join(\" \"),\n        POWERLINES_EXECUTION_HOST_WORKER: \"true\"\n      };\n\n      if (env.FORCE_COLOR === undefined) {\n        // Mirror the enablement heuristic from picocolors (see https://github.com/vercel/next.js/blob/6a40da0345939fe4f7b1ae519b296a86dd103432/packages/next/src/lib/picocolors.ts#L21-L24).\n        // Picocolors snapshots `process.env`/`stdout.isTTY` at module load time, so when the worker\n        // process bootstraps with piped stdio its own check would disable colors. Re-evaluating the\n        // same conditions here lets us opt the worker into color output only when the parent would\n        // have seen colors, while still respecting explicit opt-outs like NO_COLOR.\n        const supportsColors =\n          !env.NO_COLOR &&\n          !env.CI &&\n          env.TERM !== \"dumb\" &&\n          (process.stdout.isTTY || process.stderr?.isTTY);\n\n        if (supportsColors) {\n          env.FORCE_COLOR = \"1\";\n        }\n      }\n\n      this.#worker = new JestWorker(executionHostPath, {\n        maxRetries: 0,\n        computeWorkerKey: (_, ...args: Array<unknown>) => {\n          let executionId = \"default\";\n          let configIndex = 0;\n          if (args.length > 0 && isSetObject(args[0])) {\n            const arg = args[0] as ExecutionHostParams;\n            if (isSetObject(arg.options)) {\n              configIndex = arg.options.configIndex ?? 0;\n              executionId = arg.options.executionId || \"default\";\n            }\n          }\n\n          return `${executionId}-${configIndex}`;\n        },\n        forkOptions: {\n          execArgv,\n          env\n        }\n      });\n      restartPromise = new Promise(resolve => {\n        resolveRestartPromise = resolve;\n      });\n\n      for (const worker of ((this.#worker as any)._workerPool?._workers ||\n        []) as {\n        _child?: ChildProcess;\n      }[]) {\n        worker._child?.on(\"exit\", (code, signal) => {\n          logger.debug(\n            `Worker process exited with code ${code} and signal ${signal}`\n          );\n\n          if ((code || (signal && signal !== \"SIGINT\")) && this.#worker) {\n            const error = new Error(\n              `Execution Host Worker exited unexpectedly with code ${\n                code\n              } and signal ${signal}`\n            );\n            logger.error(error);\n\n            throw error;\n          }\n        });\n\n        worker._child?.on(\"error\", error => {\n          logger.error({\n            meta: { category: \"communication\" },\n            message: `Worker process emitted an error: ${error.message}`,\n            error\n          });\n        });\n\n        // if a child process emits a particular message, we track that as activity\n        // so the parent process can keep track of progress\n        worker._child?.on(\"message\", data => {\n          onActivity();\n\n          if (Array.isArray(data) && data.length > 1 && isNumber(data[0])) {\n            if (data[0] === 0) {\n              logger.trace(\n                `Received message from worker: ${JSON.stringify(data.slice(1), null, 2)}`\n              );\n            } else {\n              logger.debug(\n                `Received error message from worker: ${JSON.stringify(\n                  data.slice(1),\n                  null,\n                  2\n                )}`\n              );\n            }\n          }\n\n          logger.trace(\n            `Received message from worker: ${JSON.stringify(data, null, 2)}`\n          );\n        });\n      }\n\n      let aborted = false;\n      const onActivityAbort = () => {\n        if (!aborted) {\n          aborted = true;\n        }\n      };\n\n      // Listen to the worker's stdout and stderr, if there's any thing logged, abort the activity first\n      const abortActivityStreamOnLog = new Transform({\n        transform(_chunk, _encoding, callback) {\n          onActivityAbort();\n          callback();\n        }\n      });\n      // Stop the activity if there's any output from the worker\n      this.#worker.getStdout().pipe(abortActivityStreamOnLog);\n      this.#worker.getStderr().pipe(abortActivityStreamOnLog);\n\n      // Pipe the worker's stdout and stderr to the parent process\n      this.#worker.getStdout().pipe(process.stdout);\n      this.#worker.getStderr().pipe(process.stderr);\n    };\n    createWorker();\n\n    for (const method of executionMethods) {\n      if (method.startsWith(\"_\")) {\n        continue;\n      }\n\n      (this as any)[method] = timeout\n        ? async (...args: any[]) => {\n            activeTasks++;\n            try {\n              let attempts = 0;\n              for (;;) {\n                onActivity();\n\n                const result = await Promise.race([\n                  // eslint-disable-next-line ts/no-unsafe-call\n                  (this.#worker as any)[method](\n                    args.length > 0 && args[0] ? args[0] : {}\n                  ),\n                  restartPromise\n                ]);\n                if (result !== RESTARTED) {\n                  return result;\n                }\n\n                logger.warn(\n                  `Execution Host Worker was restarted while calling method \"${\n                    method\n                  }\" (attempt ${attempts++}). Retrying the call...`\n                );\n              }\n            } finally {\n              activeTasks--;\n              onActivity();\n            }\n          }\n        : // eslint-disable-next-line ts/no-unsafe-call\n          (this.#worker as any)[method].bind(this.#worker);\n    }\n  }\n\n  /**\n   * Ends the worker process and cleans up any resources associated with it. This method should be called when the worker is no longer needed, to ensure that it is properly terminated and does not continue to consume system resources. If the worker is already terminated or was never initialized, this method will throw an error.\n   *\n   * @returns A promise that resolves when the worker has been successfully terminated.\n   */\n  public async end(): ReturnType<JestWorker[\"end\"]> {\n    const worker = this.#worker;\n    if (!worker) {\n      throw new Error(\"Execution Host Worker is not initialized\");\n    }\n\n    cleanupWorkers(worker);\n    this.#worker = undefined;\n    return worker.end();\n  }\n\n  /**\n   * Quietly end the worker if it exists\n   */\n  public close(): void {\n    if (this.#worker) {\n      cleanupWorkers(this.#worker);\n      void this.#worker.end();\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/helpers/finalize.cjs

@@ -0,0 +1,27 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_chunk = require('../chunk-C0xms8kb.cjs');
+let _powerlines_core_lib_environment = require("@powerlines/core/lib/environment");
+let node_fs = require("node:fs");
+let _stryke_fs_helpers = require("@stryke/fs/helpers");
+let _stryke_path_join = require("@stryke/path/join");
+let _stryke_fs_list_files = require("@stryke/fs/list-files");
+let _powerlines_core_lib_hooks = require("@powerlines/core/lib/hooks");
+
+//#region src/helpers/finalize.ts
+/**
+* Finalize the execution context by disposing resources and cleaning up.
+*
+* @param context - The execution context to finalize
+*/
+async function finalize(context) {
+	const timer = context.timer("Finalization");
+	await (0, _powerlines_core_lib_environment.executeEnvironments)(context, async (env) => {
+		await (0, _powerlines_core_lib_hooks.callHook)(context, "finalize", { environment: env });
+		await env.fs.dispose();
+		if ((0, node_fs.existsSync)(env.cachePath) && !(await (0, _stryke_fs_list_files.listFiles)((0, _stryke_path_join.joinPaths)(env.cachePath, "**/*")))?.length) await (0, _stryke_fs_helpers.removeDirectory)(env.cachePath);
+	});
+	timer();
+}
+
+//#endregion
+exports.finalize = finalize;

package/dist/helpers/finalize.d.cts

@@ -0,0 +1,12 @@
+import { ExecutionContext, ResolvedConfig } from "@powerlines/core";
+
+//#region src/helpers/finalize.d.ts
+/**
+ * Finalize the execution context by disposing resources and cleaning up.
+ *
+ * @param context - The execution context to finalize
+ */
+declare function finalize<TResolvedConfig extends ResolvedConfig = ResolvedConfig>(context: ExecutionContext<TResolvedConfig>): Promise<void>;
+//#endregion
+export { finalize };
+//# sourceMappingURL=finalize.d.cts.map

package/dist/helpers/finalize.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize.d.cts","names":[],"sources":["../../src/helpers/finalize.ts"],"mappings":";;;;;AA+BA;;;iBAAsB,QAAA,yBACI,cAAA,GAAiB,cAAA,CAAA,CACzC,OAAA,EAAS,gBAAA,CAAiB,eAAA,IAAgB,OAAA"}

package/dist/helpers/finalize.d.mts

@@ -0,0 +1,12 @@
+import { ExecutionContext, ResolvedConfig } from "@powerlines/core";
+
+//#region src/helpers/finalize.d.ts
+/**
+ * Finalize the execution context by disposing resources and cleaning up.
+ *
+ * @param context - The execution context to finalize
+ */
+declare function finalize<TResolvedConfig extends ResolvedConfig = ResolvedConfig>(context: ExecutionContext<TResolvedConfig>): Promise<void>;
+//#endregion
+export { finalize };
+//# sourceMappingURL=finalize.d.mts.map

package/dist/helpers/finalize.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize.d.mts","names":[],"sources":["../../src/helpers/finalize.ts"],"mappings":";;;;;AA+BA;;;iBAAsB,QAAA,yBACI,cAAA,GAAiB,cAAA,CAAA,CACzC,OAAA,EAAS,gBAAA,CAAiB,eAAA,IAAgB,OAAA"}

package/dist/helpers/finalize.mjs

@@ -0,0 +1,26 @@
+import { executeEnvironments } from "@powerlines/core/lib/environment";
+import { existsSync } from "node:fs";
+import { removeDirectory } from "@stryke/fs/helpers";
+import { joinPaths } from "@stryke/path/join";
+import { listFiles } from "@stryke/fs/list-files";
+import { callHook } from "@powerlines/core/lib/hooks";
+
+//#region src/helpers/finalize.ts
+/**
+* Finalize the execution context by disposing resources and cleaning up.
+*
+* @param context - The execution context to finalize
+*/
+async function finalize(context) {
+	const timer = context.timer("Finalization");
+	await executeEnvironments(context, async (env) => {
+		await callHook(context, "finalize", { environment: env });
+		await env.fs.dispose();
+		if (existsSync(env.cachePath) && !(await listFiles(joinPaths(env.cachePath, "**/*")))?.length) await removeDirectory(env.cachePath);
+	});
+	timer();
+}
+
+//#endregion
+export { finalize };
+//# sourceMappingURL=finalize.mjs.map

package/dist/helpers/finalize.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize.mjs","names":[],"sources":["../../src/helpers/finalize.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { ExecutionContext, ResolvedConfig } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { callHook } from \"@powerlines/core/lib/hooks\";\nimport { removeDirectory } from \"@stryke/fs/helpers\";\nimport { listFiles } from \"@stryke/fs/list-files\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { existsSync } from \"node:fs\";\n\n/**\n * Finalize the execution context by disposing resources and cleaning up.\n *\n * @param context - The execution context to finalize\n */\nexport async function finalize<\n  TResolvedConfig extends ResolvedConfig = ResolvedConfig\n>(context: ExecutionContext<TResolvedConfig>) {\n  const timer = context.timer(\"Finalization\");\n\n  await executeEnvironments(context, async env => {\n    await callHook(context, \"finalize\", { environment: env });\n    await env.fs.dispose();\n\n    if (\n      existsSync(env.cachePath) &&\n      !(await listFiles(joinPaths(env.cachePath, \"**/*\")))?.length\n    ) {\n      await removeDirectory(env.cachePath);\n    }\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;;AA+BA,eAAsB,SAEpB,SAA4C;CAC5C,MAAM,QAAQ,QAAQ,MAAM,eAAe;AAE3C,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,QAAM,SAAS,SAAS,YAAY,EAAE,aAAa,KAAK,CAAC;AACzD,QAAM,IAAI,GAAG,SAAS;AAEtB,MACE,WAAW,IAAI,UAAU,IACzB,EAAE,MAAM,UAAU,UAAU,IAAI,WAAW,OAAO,CAAC,GAAG,OAEtD,OAAM,gBAAgB,IAAI,UAAU;GAEtC;AAEF,QAAO"}

package/dist/helpers/rpc.cjs

@@ -0,0 +1,140 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_chunk = require('../chunk-C0xms8kb.cjs');
+let node_events = require("node:events");
+let _stryke_type_checks_is_number = require("@stryke/type-checks/is-number");
+let _stryke_type_checks_is_set = require("@stryke/type-checks/is-set");
+let _powerlines_core_lib_events = require("@powerlines/core/lib/events");
+let _stryke_url = require("@stryke/url");
+let devframe_client = require("devframe/client");
+let devframe_rpc = require("devframe/rpc");
+let devframe_rpc_client = require("devframe/rpc/client");
+let devframe_rpc_transports_ws_client = require("devframe/rpc/transports/ws-client");
+let devframe_utils_promise = require("devframe/utils/promise");
+let human_id = require("human-id");
+
+//#region src/helpers/rpc.ts
+function createWsRpcClientMode(baseURL, connectionMeta, events, clientRpc, authToken = (0, human_id.humanId)({
+	separator: "-",
+	capitalize: false
+}), rpcOptions = {}, wsOptions = {}) {
+	let isTrusted = false;
+	const trustedPromise = (0, devframe_utils_promise.promiseWithResolver)();
+	const url = (0, _stryke_type_checks_is_number.isNumber)(connectionMeta.websocket) || (0, _stryke_type_checks_is_set.isSet)(connectionMeta.websocket) && `${+connectionMeta.websocket}` === `${connectionMeta.websocket}` ? `${baseURL.protocol.replace("http", "ws")}//${baseURL.hostname}:${connectionMeta.websocket}` : connectionMeta.websocket;
+	const definitions = /* @__PURE__ */ new Map();
+	for (const name of connectionMeta.jsonSerializableMethods ?? []) definitions.set(name, { jsonSerializable: true });
+	const serverRpc = (0, devframe_rpc_client.createRpcClient)(clientRpc.functions, {
+		channel: (0, devframe_rpc_transports_ws_client.createWsRpcChannel)({
+			url,
+			authToken,
+			definitions,
+			...wsOptions
+		}),
+		rpcOptions
+	});
+	clientRpc.register({
+		name: "devframe:auth:revoked",
+		type: "event",
+		handler: () => {
+			isTrusted = false;
+			events.emit("rpc:is-trusted:updated", false);
+		}
+	});
+	let currentAuthToken = authToken;
+	async function requestTrustWithToken(token) {
+		currentAuthToken = token;
+		return true;
+	}
+	async function requestTrust() {
+		if (isTrusted) return true;
+		return requestTrustWithToken(currentAuthToken);
+	}
+	async function ensureTrusted(timeout = 6e4) {
+		if (isTrusted) trustedPromise.resolve(true);
+		if (timeout <= 0) return trustedPromise.promise;
+		let clear = () => {};
+		await Promise.race([trustedPromise.promise.then(clear), new Promise((resolve, reject) => {
+			const id = setTimeout(() => {
+				reject(/* @__PURE__ */ new Error("Timeout waiting for rpc to be trusted"));
+			}, timeout);
+			clear = () => clearTimeout(id);
+		})]);
+		return isTrusted;
+	}
+	return {
+		get isTrusted() {
+			return isTrusted;
+		},
+		requestTrust,
+		requestTrustWithToken,
+		ensureTrusted,
+		call: (...args) => {
+			return serverRpc.$call(...args);
+		},
+		callEvent: (...args) => {
+			return serverRpc.$callEvent(...args);
+		},
+		callOptional: (...args) => {
+			return serverRpc.$callOptional(...args);
+		}
+	};
+}
+const CONNECTION_AUTH_TOKEN_KEY = "__DEVTOOLS_CONNECTION_AUTH_TOKEN__";
+function createRpcClient(options) {
+	const baseURL = new _stryke_url.StormURL(options.baseURL);
+	const cacheManager = new devframe_rpc.RpcCacheManager({
+		functions: [],
+		...typeof options.cacheOptions === "object" ? options.cacheOptions : {}
+	});
+	const context = { rpc: void 0 };
+	const clientRpc = new devframe_rpc.RpcFunctionsCollectorBase(context);
+	node_events.EventEmitter.setMaxListeners(100);
+	const events = (0, _powerlines_core_lib_events.createEventEmitter)();
+	const mode = createWsRpcClientMode(baseURL, options.connection, events, clientRpc, void 0, {
+		...options.rpcOptions,
+		async onRequest(req, next, resolve) {
+			await options.rpcOptions?.onRequest?.call(this, req, next, resolve);
+			if (options.cacheOptions && cacheManager?.validate(req.m)) {
+				const cached = cacheManager.cached(req.m, req.a);
+				if (cached) return resolve(cached);
+				else {
+					const res = await next(req);
+					cacheManager?.apply(req, res);
+				}
+			} else await next(req);
+		}
+	}, options.wsOptions);
+	const rpc = {
+		events,
+		get isTrusted() {
+			return mode.isTrusted;
+		},
+		connectionMeta: options.connection,
+		ensureTrusted: mode.ensureTrusted,
+		requestTrust: mode.requestTrust,
+		requestTrustWithToken: async (token) => {
+			localStorage.setItem(CONNECTION_AUTH_TOKEN_KEY, token);
+			globalThis[CONNECTION_AUTH_TOKEN_KEY] = token;
+			return mode.requestTrustWithToken(token);
+		},
+		call: mode.call,
+		callEvent: mode.callEvent,
+		callOptional: mode.callOptional,
+		client: clientRpc,
+		sharedState: void 0,
+		streaming: void 0,
+		cacheManager
+	};
+	rpc.streaming = (0, devframe_client.createRpcStreamingClientHost)(rpc);
+	context.rpc = rpc;
+	mode.requestTrust();
+	try {
+		const bc = new BroadcastChannel("vite-devtools-auth");
+		bc.onmessage = (event) => {
+			if (event.data?.type === "auth-update" && event.data.authToken) rpc.requestTrustWithToken(event.data.authToken);
+		};
+	} catch {}
+	return rpc;
+}
+
+//#endregion
+exports.createRpcClient = createRpcClient;

package/dist/helpers/rpc.d.cts

@@ -0,0 +1,7 @@
+import { i as RpcClientOptions, u as RpcClient } from "../config-D6xUniHh.cjs";
+
+//#region src/helpers/rpc.d.ts
+declare function createRpcClient(options: RpcClientOptions): RpcClient;
+//#endregion
+export { createRpcClient };
+//# sourceMappingURL=rpc.d.cts.map

package/dist/helpers/rpc.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.cts","names":[],"sources":["../../src/helpers/rpc.ts"],"mappings":";;;iBA0LgB,eAAA,CAAgB,OAAA,EAAS,gBAAA,GAAgB,SAAA"}

package/dist/helpers/rpc.d.mts

@@ -0,0 +1,7 @@
+import { i as RpcClientOptions, u as RpcClient } from "../config-BNe23XHx.mjs";
+
+//#region src/helpers/rpc.d.ts
+declare function createRpcClient(options: RpcClientOptions): RpcClient;
+//#endregion
+export { createRpcClient };
+//# sourceMappingURL=rpc.d.mts.map

package/dist/helpers/rpc.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.mts","names":[],"sources":["../../src/helpers/rpc.ts"],"mappings":";;;iBA0LgB,eAAA,CAAgB,OAAA,EAAS,gBAAA,GAAgB,SAAA"}