@jterrazz/test 3.3.1 → 3.5.0

package/dist/index.d.cts

@@ -79,7 +79,8 @@ declare class Orchestrator {
   constructor(options: OrchestratorOptions);
   /**
    * Start declared services via testcontainers (integration mode).
-   * Reads image/env config from docker-compose.test.yaml if a service has compose: "name".
+   * Phase 1: start all containers in parallel (the slow part).
+   * Phase 2: wire connections, healthcheck, and init sequentially (fast).
    */
   start(): Promise<void>;
   /**
@@ -118,6 +119,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 +135,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 +212,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 +225,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;
@@ -237,6 +251,7 @@ declare class PostgresHandle implements DatabasePort, ServiceHandle {
   readonly environment: Record<string, string>;
   connectionString: string;
   started: boolean;
+  private client;
   constructor(options?: PostgresOptions);
   buildConnectionString(host: string, port: number): string;
   createDatabaseAdapter(): DatabasePort;
@@ -289,13 +304,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

@@ -79,7 +79,8 @@ declare class Orchestrator {
   constructor(options: OrchestratorOptions);
   /**
    * Start declared services via testcontainers (integration mode).
-   * Reads image/env config from docker-compose.test.yaml if a service has compose: "name".
+   * Phase 1: start all containers in parallel (the slow part).
+   * Phase 2: wire connections, healthcheck, and init sequentially (fast).
    */
   start(): Promise<void>;
   /**
@@ -118,6 +119,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 +135,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 +212,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 +225,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;
@@ -237,6 +251,7 @@ declare class PostgresHandle implements DatabasePort, ServiceHandle {
   readonly environment: Record<string, string>;
   connectionString: string;
   started: boolean;
+  private client;
   constructor(options?: PostgresOptions);
   buildConnectionString(host: string, port: number): string;
   createDatabaseAdapter(): DatabasePort;
@@ -289,13 +304,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