@storm-software/config-tools 1.190.153 → 1.190.154

package/dist/utilities/run.cjs

@@ -41,10 +41,10 @@ const run = (config, command, cwd = config.workspaceRoot ?? process.cwd(), stdio
 * @param command - The command to run
 * @param cwd - The current working directory
 * @param env - The environment variables
-* @returns A promise with the result of the command
+* @returns The child process. It is thenable and settles when the process exits.
 */
 const runAsync = (config, command, cwd = config.workspaceRoot ?? process.cwd(), env = process.env) => {
-	return (0, node_child_process.exec)(command, {
+	const child = (0, node_child_process.exec)(command, {
 		cwd,
 		env: {
 			...process.env,
@@ -57,6 +57,23 @@ const runAsync = (config, command, cwd = config.workspaceRoot ?? process.cwd(),
 		killSignal: "SIGTERM",
 		encoding: "utf8"
 	});
+	child.stdout?.pipe(process.stdout);
+	child.stderr?.pipe(process.stderr);
+	const done = new Promise((resolve, reject) => {
+		child.once("error", reject);
+		child.once("close", (code) => {
+			if (code === 0) {
+				resolve();
+				return;
+			}
+			reject(/* @__PURE__ */ new Error(`Command failed with exit code ${code ?? "null"}: ${command}`));
+		});
+	});
+	return Object.assign(child, {
+		then: done.then.bind(done),
+		catch: done.catch.bind(done),
+		finally: done.finally.bind(done)
+	});
 };
 exports.LARGE_BUFFER = LARGE_BUFFER;
 exports.run = run;

package/dist/utilities/run.d.cts

@@ -1,4 +1,5 @@
 import { StormWorkspaceConfig } from "@storm-software/config";
+import { ChildProcess } from "node:child_process";
 declare const LARGE_BUFFER: number;
 type IOType = "overlapped" | "pipe" | "ignore" | "inherit";
 type StdioOptions = IOType | Array<IOType | "ipc" | number | null | undefined>;
@@ -26,7 +27,7 @@ declare const run: (config: Partial<StormWorkspaceConfig>, command: string, cwd?
  * @param command - The command to run
  * @param cwd - The current working directory
  * @param env - The environment variables
- * @returns A promise with the result of the command
+ * @returns The child process. It is thenable and settles when the process exits.
  */
-declare const runAsync: (config: Partial<StormWorkspaceConfig>, command: string, cwd?: string, env?: NodeJS.ProcessEnv) => import("node:child_process").ChildProcess;
+declare const runAsync: (config: Partial<StormWorkspaceConfig>, command: string, cwd?: string, env?: NodeJS.ProcessEnv) => ChildProcess & PromiseLike<void>;
 export { IOType, LARGE_BUFFER, StdioOptions, run, runAsync };

package/dist/utilities/run.d.mts

@@ -1,6 +1,7 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { StormWorkspaceConfig } from "@storm-software/config";
+import { ChildProcess } from "node:child_process";
 declare const LARGE_BUFFER: number;
 type IOType = "overlapped" | "pipe" | "ignore" | "inherit";
 type StdioOptions = IOType | Array<IOType | "ipc" | number | null | undefined>;
@@ -28,7 +29,7 @@ declare const run: (config: Partial<StormWorkspaceConfig>, command: string, cwd?
  * @param command - The command to run
  * @param cwd - The current working directory
  * @param env - The environment variables
- * @returns A promise with the result of the command
+ * @returns The child process. It is thenable and settles when the process exits.
  */
-declare const runAsync: (config: Partial<StormWorkspaceConfig>, command: string, cwd?: string, env?: NodeJS.ProcessEnv) => import("node:child_process").ChildProcess;
+declare const runAsync: (config: Partial<StormWorkspaceConfig>, command: string, cwd?: string, env?: NodeJS.ProcessEnv) => ChildProcess & PromiseLike<void>;
 export { IOType, LARGE_BUFFER, StdioOptions, run, runAsync };

package/dist/utilities/run.mjs

@@ -43,10 +43,10 @@ const run = (config, command, cwd = config.workspaceRoot ?? process.cwd(), stdio
 * @param command - The command to run
 * @param cwd - The current working directory
 * @param env - The environment variables
-* @returns A promise with the result of the command
+* @returns The child process. It is thenable and settles when the process exits.
 */
 const runAsync = (config, command, cwd = config.workspaceRoot ?? process.cwd(), env = process.env) => {
-	return exec(command, {
+	const child = exec(command, {
 		cwd,
 		env: {
 			...process.env,
@@ -59,5 +59,22 @@ const runAsync = (config, command, cwd = config.workspaceRoot ?? process.cwd(),
 		killSignal: "SIGTERM",
 		encoding: "utf8"
 	});
+	child.stdout?.pipe(process.stdout);
+	child.stderr?.pipe(process.stderr);
+	const done = new Promise((resolve, reject) => {
+		child.once("error", reject);
+		child.once("close", (code) => {
+			if (code === 0) {
+				resolve();
+				return;
+			}
+			reject(/* @__PURE__ */ new Error(`Command failed with exit code ${code ?? "null"}: ${command}`));
+		});
+	});
+	return Object.assign(child, {
+		then: done.then.bind(done),
+		catch: done.catch.bind(done),
+		finally: done.finally.bind(done)
+	});
 };
 export { LARGE_BUFFER, run, runAsync };

package/dist/utilities/run.spec.cjs

@@ -0,0 +1,12 @@
+const require_utilities_run = require("./run.cjs");
+// src/utilities/run.spec.ts
+describe("runAsync", () => {
+	it("settles after the command exits", async () => {
+		const started = Date.now();
+		await require_utilities_run.runAsync({}, "node -e \"setTimeout(() => {}, 300)\"");
+		expect(Date.now() - started).toBeGreaterThanOrEqual(250);
+	});
+	it("rejects when the command exits non-zero", async () => {
+		await expect(require_utilities_run.runAsync({}, "node -e \"process.exit(2)\"")).rejects.toThrow(/exit code 2/);
+	});
+});

package/dist/utilities/run.spec.d.cts

@@ -0,0 +1 @@
+export {}

package/dist/utilities/run.spec.d.mts

@@ -0,0 +1,2 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';

package/dist/utilities/run.spec.mjs

@@ -0,0 +1,16 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { runAsync } from "./run.mjs";
+// src/utilities/run.spec.ts
+describe("runAsync", () => {
+	it("settles after the command exits", async () => {
+		const started = Date.now();
+		await runAsync({}, "node -e \"setTimeout(() => {}, 300)\"");
+		expect(Date.now() - started).toBeGreaterThanOrEqual(250);
+	});
+	it("rejects when the command exits non-zero", async () => {
+		await expect(runAsync({}, "node -e \"process.exit(2)\"")).rejects.toThrow(/exit code 2/);
+	});
+});
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storm-software/config-tools",
-  "version": "1.190.153",
+  "version": "1.190.154",
   "private": false,
   "description": "A package containing various utilities to support custom workspace configurations and environment management for Storm Software projects, including configuration file handling, environment variable management, and logging utilities.",
   "keywords": [
@@ -147,6 +147,10 @@
       "import": "./dist/utilities/run.mjs",
       "require": "./dist/utilities/run.cjs"
     },
+    "./utilities/run.spec": {
+      "import": "./dist/utilities/run.spec.mjs",
+      "require": "./dist/utilities/run.spec.cjs"
+    },
     "./utilities/toml": {
       "import": "./dist/utilities/toml.mjs",
       "require": "./dist/utilities/toml.cjs"
@@ -164,7 +168,7 @@
   "files": ["dist"],
   "dependencies": {
     "@ltd/j-toml": "1.38.0",
-    "@storm-software/config": "1.138.89",
+    "@storm-software/config": "1.138.90",
     "c12": "^2.0.4",
     "chalk": "^4.1.2",
     "commander": "^12.1.0",
@@ -182,5 +186,5 @@
   "peerDependencies": { "zod": "^3.25.0 || ^4.0.0" },
   "peerDependenciesMeta": { "zod": { "optional": false } },
   "publishConfig": { "access": "public" },
-  "gitHead": "7a502e974b390096b201737b87f85e793499bad2"
+  "gitHead": "669ee54da1367f7049b6e5b5f6e27ab208940a47"
 }