@jterrazz/test 3.4.0 → 4.0.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>;
   /**
@@ -109,6 +110,99 @@ declare class Orchestrator {
   getAppUrl(): null | string;
 }
 //#endregion
+//#region src/specification/assertions/base.d.ts
+/**
+ * Base assertion that handles .not negation.
+ * Subclasses call this.assert(condition, message, negatedMessage) for each predicate.
+ */
+declare class BaseAssertion {
+  protected negated: boolean;
+  get not(): this;
+  protected assert(condition: boolean, message: string, negatedMessage: string): void;
+}
+//#endregion
+//#region src/specification/assertions/file.d.ts
+/**
+ * Assertions on a file in the working directory.
+ * Usage: result.file("dist/index.js").toExist()
+ */
+declare class FileAssertion extends BaseAssertion {
+  private filePath;
+  private resolvedPath;
+  constructor(filePath: string, workDir: string);
+  toExist(): void;
+  toContain(expected: string): void;
+  toMatch(pattern: RegExp): void;
+}
+//#endregion
+//#region src/specification/assertions/response.d.ts
+/**
+ * Assertions on an HTTP response body.
+ * Usage: result.response.toMatchFile("expected.json")
+ */
+declare class ResponseAssertion extends BaseAssertion {
+  private body;
+  private testDir;
+  constructor(body: unknown, testDir: string);
+  toMatchFile(file: string): void;
+  toContain(subset: Record<string, unknown>): void;
+}
+//#endregion
+//#region src/specification/assertions/string.d.ts
+/**
+ * Assertions on a string (stdout, stderr, response body).
+ * Usage: result.stdout.toContain("hello")
+ */
+declare class StringAssertion extends BaseAssertion {
+  private actual;
+  private label;
+  private testDir?;
+  constructor(actual: string, label: string, testDir?: string);
+  toContain(expected: string, options?: {
+    near?: string;
+  }): void;
+  toMatch(pattern: RegExp): void;
+  toMatchFile(file: string): void;
+  toBeEmpty(): void;
+  private containsNear;
+  private stripAnsi;
+  private truncate;
+}
+//#endregion
+//#region src/specification/assertions/table.d.ts
+/**
+ * Assertions on a database table.
+ * Usage: await result.table("users").toMatch({ columns: ["name"], rows: [["Alice"]] })
+ */
+declare class TableAssertion extends BaseAssertion {
+  private tableName;
+  private db;
+  constructor(tableName: string, db: DatabasePort);
+  toMatch(expected: {
+    columns: string[];
+    rows: unknown[][];
+  }): Promise<void>;
+  toBeEmpty(): Promise<void>;
+}
+//#endregion
+//#region src/specification/assertions/value.d.ts
+/**
+ * Assertions on a single value (exit code, status code).
+ * Usage: result.exitCode.toBe(0)
+ */
+declare class ValueAssertion extends BaseAssertion {
+  private actual;
+  private label;
+  private context?;
+  constructor(actual: number, label: string, context?: {
+    request?: any;
+    responseBody?: unknown;
+    stdout?: string;
+    stderr?: string;
+  });
+  toBe(expected: number): void;
+}
+//#endregion
 //#region src/specification/ports/command.port.d.ts
 /**
  * Result of executing a CLI command.
@@ -173,7 +267,7 @@ declare class SpecificationResult {
   private commandResult?;
   private config;
   private requestInfo?;
-  private response?;
+  private responseData?;
   private testDir;
   private workDir?;
   constructor(options: {
@@ -184,23 +278,16 @@ declare class SpecificationResult {
     testDir: string;
     workDir?: string;
   });
-  expectStatus(code: number): this;
-  expectResponse(file: string): this;
-  expectExitCode(code: number): this;
-  expectStdout(file: string): this;
-  expectStdoutContains(str: string): this;
-  expectStderr(file: string): this;
-  expectStderrContains(str: string): this;
-  expectTable(table: string, options: {
-    columns: string[];
-    rows: unknown[][];
+  get exitCode(): ValueAssertion;
+  get status(): ValueAssertion;
+  get response(): ResponseAssertion;
+  get stdout(): StringAssertion;
+  get stderr(): StringAssertion;
+  file(path: string): FileAssertion;
+  table(tableName: string, options?: {
     service?: string;
-  }): Promise<this>;
-  expectFile(path: string): this;
-  expectNoFile(path: string): this;
-  expectFileContains(path: string, content: string): this;
+  }): TableAssertion;
   private resolveDatabase;
-  private resolveWorkPath;
 }
 declare class SpecificationBuilder {
   private commandArgs;
@@ -250,6 +337,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;

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>;
   /**
@@ -109,6 +110,99 @@ declare class Orchestrator {
   getAppUrl(): null | string;
 }
 //#endregion
+//#region src/specification/assertions/base.d.ts
+/**
+ * Base assertion that handles .not negation.
+ * Subclasses call this.assert(condition, message, negatedMessage) for each predicate.
+ */
+declare class BaseAssertion {
+  protected negated: boolean;
+  get not(): this;
+  protected assert(condition: boolean, message: string, negatedMessage: string): void;
+}
+//#endregion
+//#region src/specification/assertions/file.d.ts
+/**
+ * Assertions on a file in the working directory.
+ * Usage: result.file("dist/index.js").toExist()
+ */
+declare class FileAssertion extends BaseAssertion {
+  private filePath;
+  private resolvedPath;
+  constructor(filePath: string, workDir: string);
+  toExist(): void;
+  toContain(expected: string): void;
+  toMatch(pattern: RegExp): void;
+}
+//#endregion
+//#region src/specification/assertions/response.d.ts
+/**
+ * Assertions on an HTTP response body.
+ * Usage: result.response.toMatchFile("expected.json")
+ */
+declare class ResponseAssertion extends BaseAssertion {
+  private body;
+  private testDir;
+  constructor(body: unknown, testDir: string);
+  toMatchFile(file: string): void;
+  toContain(subset: Record<string, unknown>): void;
+}
+//#endregion
+//#region src/specification/assertions/string.d.ts
+/**
+ * Assertions on a string (stdout, stderr, response body).
+ * Usage: result.stdout.toContain("hello")
+ */
+declare class StringAssertion extends BaseAssertion {
+  private actual;
+  private label;
+  private testDir?;
+  constructor(actual: string, label: string, testDir?: string);
+  toContain(expected: string, options?: {
+    near?: string;
+  }): void;
+  toMatch(pattern: RegExp): void;
+  toMatchFile(file: string): void;
+  toBeEmpty(): void;
+  private containsNear;
+  private stripAnsi;
+  private truncate;
+}
+//#endregion
+//#region src/specification/assertions/table.d.ts
+/**
+ * Assertions on a database table.
+ * Usage: await result.table("users").toMatch({ columns: ["name"], rows: [["Alice"]] })
+ */
+declare class TableAssertion extends BaseAssertion {
+  private tableName;
+  private db;
+  constructor(tableName: string, db: DatabasePort);
+  toMatch(expected: {
+    columns: string[];
+    rows: unknown[][];
+  }): Promise<void>;
+  toBeEmpty(): Promise<void>;
+}
+//#endregion
+//#region src/specification/assertions/value.d.ts
+/**
+ * Assertions on a single value (exit code, status code).
+ * Usage: result.exitCode.toBe(0)
+ */
+declare class ValueAssertion extends BaseAssertion {
+  private actual;
+  private label;
+  private context?;
+  constructor(actual: number, label: string, context?: {
+    request?: any;
+    responseBody?: unknown;
+    stdout?: string;
+    stderr?: string;
+  });
+  toBe(expected: number): void;
+}
+//#endregion
 //#region src/specification/ports/command.port.d.ts
 /**
  * Result of executing a CLI command.
@@ -173,7 +267,7 @@ declare class SpecificationResult {
   private commandResult?;
   private config;
   private requestInfo?;
-  private response?;
+  private responseData?;
   private testDir;
   private workDir?;
   constructor(options: {
@@ -184,23 +278,16 @@ declare class SpecificationResult {
     testDir: string;
     workDir?: string;
   });
-  expectStatus(code: number): this;
-  expectResponse(file: string): this;
-  expectExitCode(code: number): this;
-  expectStdout(file: string): this;
-  expectStdoutContains(str: string): this;
-  expectStderr(file: string): this;
-  expectStderrContains(str: string): this;
-  expectTable(table: string, options: {
-    columns: string[];
-    rows: unknown[][];
+  get exitCode(): ValueAssertion;
+  get status(): ValueAssertion;
+  get response(): ResponseAssertion;
+  get stdout(): StringAssertion;
+  get stderr(): StringAssertion;
+  file(path: string): FileAssertion;
+  table(tableName: string, options?: {
     service?: string;
-  }): Promise<this>;
-  expectFile(path: string): this;
-  expectNoFile(path: string): this;
-  expectFileContains(path: string, content: string): this;
+  }): TableAssertion;
   private resolveDatabase;
-  private resolveWorkPath;
 }
 declare class SpecificationBuilder {
   private commandArgs;
@@ -250,6 +337,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;