@jterrazz/test 3.3.1 → 3.4.0

package/dist/index.d.cts

@@ -118,6 +118,15 @@ interface CommandResult {
   stdout: string;
   stderr: string;
 }
+/**
+ * Options for spawning a long-running process.
+ */
+interface SpawnOptions {
+  /** Resolve when stdout/stderr contains this string. */
+  waitFor: string;
+  /** Kill the process after this many milliseconds. */
+  timeout: number;
+}
 /**
  * Abstract CLI interface for specification runners.
  * Implement this to plug in your command execution strategy.
@@ -125,6 +134,8 @@ interface CommandResult {
 interface CommandPort {
   /** Execute a CLI command with the given arguments in the given working directory. */
   exec(args: string, cwd: string): Promise<CommandResult>;
+  /** Spawn a long-running process and wait for a pattern or timeout. */
+  spawn(args: string, cwd: string, options: SpawnOptions): Promise<CommandResult>;
 }
 //#endregion
 //#region src/specification/ports/server.port.d.ts
@@ -200,6 +211,7 @@ declare class SpecificationBuilder {
   private projectName;
   private request;
   private seeds;
+  private spawnConfig;
   private testDir;
   constructor(config: SpecificationConfig, testDir: string, label: string);
   seed(file: string, options?: {
@@ -212,7 +224,8 @@ declare class SpecificationBuilder {
   post(path: string, bodyFile?: string): this;
   put(path: string, bodyFile?: string): this;
   delete(path: string): this;
-  exec(args: string): this;
+  exec(args: string | string[]): this;
+  spawn(args: string, options: SpawnOptions): this;
   run(): Promise<SpecificationResult>;
   private prepareWorkDir;
   private runHttpAction;
@@ -289,13 +302,14 @@ declare function redis(options?: RedisOptions): RedisHandle;
 //#endregion
 //#region src/specification/adapters/exec.adapter.d.ts
 /**
- * Executes CLI commands via execSync.
+ * Executes CLI commands via execSync (blocking) or spawn (long-running).
  * Used by cli() for local command execution.
  */
 declare class ExecAdapter implements CommandPort {
   private command;
   constructor(command: string);
   exec(args: string, cwd: string): Promise<CommandResult>;
+  spawn(args: string, cwd: string, options: SpawnOptions): Promise<CommandResult>;
 }
 //#endregion
 //#region src/specification/adapters/fetch.adapter.d.ts

package/dist/index.d.ts

@@ -118,6 +118,15 @@ interface CommandResult {
   stdout: string;
   stderr: string;
 }
+/**
+ * Options for spawning a long-running process.
+ */
+interface SpawnOptions {
+  /** Resolve when stdout/stderr contains this string. */
+  waitFor: string;
+  /** Kill the process after this many milliseconds. */
+  timeout: number;
+}
 /**
  * Abstract CLI interface for specification runners.
  * Implement this to plug in your command execution strategy.
@@ -125,6 +134,8 @@ interface CommandResult {
 interface CommandPort {
   /** Execute a CLI command with the given arguments in the given working directory. */
   exec(args: string, cwd: string): Promise<CommandResult>;
+  /** Spawn a long-running process and wait for a pattern or timeout. */
+  spawn(args: string, cwd: string, options: SpawnOptions): Promise<CommandResult>;
 }
 //#endregion
 //#region src/specification/ports/server.port.d.ts
@@ -200,6 +211,7 @@ declare class SpecificationBuilder {
   private projectName;
   private request;
   private seeds;
+  private spawnConfig;
   private testDir;
   constructor(config: SpecificationConfig, testDir: string, label: string);
   seed(file: string, options?: {
@@ -212,7 +224,8 @@ declare class SpecificationBuilder {
   post(path: string, bodyFile?: string): this;
   put(path: string, bodyFile?: string): this;
   delete(path: string): this;
-  exec(args: string): this;
+  exec(args: string | string[]): this;
+  spawn(args: string, options: SpawnOptions): this;
   run(): Promise<SpecificationResult>;
   private prepareWorkDir;
   private runHttpAction;
@@ -289,13 +302,14 @@ declare function redis(options?: RedisOptions): RedisHandle;
 //#endregion
 //#region src/specification/adapters/exec.adapter.d.ts
 /**
- * Executes CLI commands via execSync.
+ * Executes CLI commands via execSync (blocking) or spawn (long-running).
  * Used by cli() for local command execution.
  */
 declare class ExecAdapter implements CommandPort {
   private command;
   constructor(command: string);
   exec(args: string, cwd: string): Promise<CommandResult>;
+  spawn(args: string, cwd: string, options: SpawnOptions): Promise<CommandResult>;
 }
 //#endregion
 //#region src/specification/adapters/fetch.adapter.d.ts

package/dist/index.js

@@ -4,7 +4,7 @@ import MockDatePackage from "mockdate";
 import { mockDeep } from "vitest-mock-extended";
 import { cpSync, existsSync, mkdtempSync, readFileSync } from "node:fs";
 import { dirname, isAbsolute, resolve } from "node:path";
-import { execSync } from "node:child_process";
+import { execSync, spawn } from "node:child_process";
 import { tmpdir } from "node:os";
 //#region src/mocking/mock-of-date.ts
 const mockOfDate = MockDatePackage;
@@ -4899,7 +4899,7 @@ var Orchestrator = class {
 //#endregion
 //#region src/specification/adapters/exec.adapter.ts
 /**
-* Executes CLI commands via execSync.
+* Executes CLI commands via execSync (blocking) or spawn (long-running).
 * Used by cli() for local command execution.
 */
 var ExecAdapter = class {
@@ -4935,6 +4935,55 @@ var ExecAdapter = class {
 			};
 		}
 	}
+	async spawn(args, cwd, options) {
+		const env = {
+			...process.env,
+			INIT_CWD: void 0
+		};
+		return new Promise((resolve) => {
+			let stdout = "";
+			let stderr = "";
+			let resolved = false;
+			const child = spawn(this.command, args.split(/\s+/).filter(Boolean), {
+				cwd,
+				env,
+				stdio: [
+					"pipe",
+					"pipe",
+					"pipe"
+				]
+			});
+			const finish = (exitCode) => {
+				if (resolved) return;
+				resolved = true;
+				child.kill("SIGTERM");
+				resolve({
+					exitCode,
+					stdout,
+					stderr
+				});
+			};
+			let patternMatched = false;
+			const checkPattern = () => {
+				if (!patternMatched && (stdout.includes(options.waitFor) || stderr.includes(options.waitFor))) {
+					patternMatched = true;
+					finish(0);
+				}
+			};
+			child.stdout?.on("data", (data) => {
+				stdout += data.toString();
+				checkPattern();
+			});
+			child.stderr?.on("data", (data) => {
+				stderr += data.toString();
+				checkPattern();
+			});
+			child.on("exit", (code) => {
+				if (!patternMatched) finish(code === 0 ? 1 : code ?? 1);
+			});
+			setTimeout(() => finish(124), options.timeout);
+		});
+	}
 };
 //#endregion
 //#region src/specification/adapters/fetch.adapter.ts
@@ -5093,6 +5142,7 @@ var SpecificationBuilder = class {
 	projectName = null;
 	request = null;
 	seeds = [];
+	spawnConfig = null;
 	testDir;
 	constructor(config, testDir, label) {
 		this.config = config;
@@ -5152,11 +5202,18 @@ var SpecificationBuilder = class {
 		this.commandArgs = args;
 		return this;
 	}
+	spawn(args, options) {
+		this.spawnConfig = {
+			args,
+			options
+		};
+		return this;
+	}
 	async run() {
 		const hasHttpAction = this.request !== null;
-		const hasCliAction = this.commandArgs !== null;
+		const hasCliAction = this.commandArgs !== null || this.spawnConfig !== null;
 		if (!hasHttpAction && !hasCliAction) throw new Error(`Specification "${this.label}": no action defined. Call .get(), .post(), .exec(), etc. before .run()`);
-		if (hasHttpAction && hasCliAction) throw new Error(`Specification "${this.label}": cannot mix HTTP (.get/.post) and CLI (.exec) actions`);
+		if (hasHttpAction && hasCliAction) throw new Error(`Specification "${this.label}": cannot mix HTTP (.get/.post) and CLI (.exec/.spawn) actions`);
 		let workDir = null;
 		if (hasCliAction) workDir = this.prepareWorkDir();
 		if (this.config.databases) for (const db of this.config.databases.values()) await db.reset();
@@ -5203,8 +5260,21 @@ var SpecificationBuilder = class {
 	}
 	async runCliAction(workDir) {
 		if (!this.config.command) throw new Error("CLI actions require a command adapter (use cli())");
+		let commandResult;
+		if (this.spawnConfig) commandResult = await this.config.command.spawn(this.spawnConfig.args, workDir, this.spawnConfig.options);
+		else if (Array.isArray(this.commandArgs)) {
+			commandResult = {
+				exitCode: 0,
+				stdout: "",
+				stderr: ""
+			};
+			for (const args of this.commandArgs) {
+				commandResult = await this.config.command.exec(args, workDir);
+				if (commandResult.exitCode !== 0) break;
+			}
+		} else commandResult = await this.config.command.exec(this.commandArgs, workDir);
 		return new SpecificationResult({
-			commandResult: await this.config.command.exec(this.commandArgs, workDir),
+			commandResult,
 			config: this.config,
 			testDir: this.testDir,
 			workDir