@jterrazz/test 5.1.0 → 5.3.1

package/dist/index.d.ts

@@ -1,17 +1,6 @@
 import { DeepMockProxy } from "vitest-mock-extended";
 
-//#region src/mocking/mock-of-date.d.ts
-interface MockDatePort {
-  reset: () => void;
-  set: (date: Date | number | string) => void;
-}
-declare const mockOfDate: MockDatePort;
-//#endregion
-//#region src/mocking/mock-of.d.ts
-type MockPort = <T>() => DeepMockProxy<T>;
-declare const mockOf: MockPort;
-//#endregion
-//#region src/specification/ports/database.port.d.ts
+//#region src/ports/database.port.d.ts
 /**
  * Abstract database interface for specification runners.
  * Implement this to plug in your database stack.
@@ -25,7 +14,7 @@ interface DatabasePort {
   reset(): Promise<void>;
 }
 //#endregion
-//#region src/infrastructure/services/service.port.d.ts
+//#region src/ports/service.port.d.ts
 /**
  * A service handle — returned by factory functions like postgres(), redis().
  * Mutable: connectionString is populated after the orchestrator starts containers.
@@ -57,60 +46,7 @@ interface ServiceHandle {
   reset(): Promise<void>;
 }
 //#endregion
-//#region src/infrastructure/orchestrator.d.ts
-interface OrchestratorOptions {
-  services: ServiceHandle[];
-  mode: "e2e" | "integration";
-  root?: string;
-}
-/**
- * Orchestrator for test infrastructure.
- * Integration: starts services via testcontainers.
- * E2E: runs full docker compose up.
- */
-declare class Orchestrator {
-  private services;
-  private mode;
-  private root;
-  private running;
-  private composeStack;
-  private composeHandles;
-  private started;
-  constructor(options: OrchestratorOptions);
-  /**
-   * Start declared services via testcontainers (integration mode).
-   * Phase 1: start all containers in parallel (the slow part).
-   * Phase 2: wire connections, healthcheck, and init sequentially (fast).
-   */
-  start(): Promise<void>;
-  /**
-   * Stop testcontainers (integration mode).
-   */
-  stop(): Promise<void>;
-  /**
-   * Start full docker compose stack (e2e mode).
-   * Auto-detects infra services and creates handles for them.
-   */
-  startCompose(): Promise<void>;
-  /**
-   * Stop docker compose stack (e2e mode).
-   */
-  stopCompose(): Promise<void>;
-  /**
-   * Get a database service by compose name, or the first one if no name given.
-   */
-  getDatabase(serviceName?: string): DatabasePort | null;
-  /**
-   * Get all database services keyed by compose name.
-   */
-  getDatabases(): Map<string, DatabasePort>;
-  /**
-   * Get app URL from compose (e2e mode).
-   */
-  getAppUrl(): null | string;
-}
-//#endregion
-//#region src/specification/ports/command.port.d.ts
+//#region src/ports/command.port.d.ts
 /**
  * Result of executing a CLI command.
  */
@@ -144,7 +80,7 @@ interface CommandPort {
   spawn(args: string, cwd: string, options: SpawnOptions, env?: CommandEnv): Promise<CommandResult>;
 }
 //#endregion
-//#region src/specification/ports/server.port.d.ts
+//#region src/ports/server.port.d.ts
 /**
  * HTTP response returned by a server port.
  */
@@ -162,28 +98,7 @@ interface ServerPort {
   request(method: string, path: string, body?: unknown): Promise<ServerResponse>;
 }
 //#endregion
-//#region src/specification/specification.d.ts
-interface SpecificationConfig {
-  command?: CommandPort;
-  database?: DatabasePort;
-  databases?: Map<string, DatabasePort>;
-  fixturesRoot?: string;
-  server?: ServerPort;
-}
-interface FileAccessor {
-  readonly content: string;
-  readonly exists: boolean;
-}
-declare class TableAssertion {
-  private tableName;
-  private db;
-  constructor(tableName: string, db: DatabasePort);
-  toMatch(expected: {
-    columns: string[];
-    rows: unknown[][];
-  }): Promise<void>;
-  toBeEmpty(): Promise<void>;
-}
+//#region src/builder/directory-accessor.d.ts
 interface DirectorySnapshotOptions {
   /** Extra path segments to ignore (in addition to default: .git, node_modules, etc.). */
   ignore?: string[];
@@ -211,12 +126,32 @@ declare class DirectoryAccessor {
     ignore?: string[];
   }): Promise<string[]>;
 }
+//#endregion
+//#region src/builder/response-accessor.d.ts
 declare class ResponseAccessor {
   readonly body: unknown;
   private testDir;
   constructor(body: unknown, testDir: string);
   toMatchFile(file: string): void;
 }
+//#endregion
+//#region src/builder/table-assertion.d.ts
+declare class TableAssertion {
+  private tableName;
+  private db;
+  constructor(tableName: string, db: DatabasePort);
+  toMatch(expected: {
+    columns: string[];
+    rows: unknown[][];
+  }): Promise<void>;
+  toBeEmpty(): Promise<void>;
+}
+//#endregion
+//#region src/builder/specification-result.d.ts
+interface FileAccessor {
+  readonly content: string;
+  readonly exists: boolean;
+}
 declare class SpecificationResult {
   private commandResult?;
   private config;
@@ -248,6 +183,15 @@ declare class SpecificationResult {
   }): TableAssertion;
   private resolveDatabase;
 }
+//#endregion
+//#region src/builder/specification-builder.d.ts
+interface SpecificationConfig {
+  command?: CommandPort;
+  database?: DatabasePort;
+  databases?: Map<string, DatabasePort>;
+  fixturesRoot?: string;
+  server?: ServerPort;
+}
 declare class SpecificationBuilder {
   private commandArgs;
   private commandEnv;
@@ -291,8 +235,167 @@ declare class SpecificationBuilder {
   private runCliAction;
 }
 type SpecificationRunner = (label: string) => SpecificationBuilder;
+declare function createSpecificationRunner(config: SpecificationConfig): SpecificationRunner;
+//#endregion
+//#region src/orchestrator/orchestrator.d.ts
+interface OrchestratorOptions {
+  services: ServiceHandle[];
+  mode: 'e2e' | 'integration';
+  root?: string;
+}
+/**
+ * Orchestrator for test infrastructure.
+ * Integration: starts services via testcontainers.
+ * E2E: runs full docker compose up.
+ */
+declare class Orchestrator {
+  private services;
+  private mode;
+  private root;
+  private running;
+  private composeStack;
+  private composeHandles;
+  private started;
+  constructor(options: OrchestratorOptions);
+  /**
+   * Start declared services via testcontainers (integration mode).
+   * Phase 1: start all containers in parallel (the slow part).
+   * Phase 2: wire connections, healthcheck, and init sequentially (fast).
+   */
+  start(): Promise<void>;
+  /**
+   * Stop testcontainers (integration mode).
+   */
+  stop(): Promise<void>;
+  /**
+   * Start full docker compose stack (e2e mode).
+   * Auto-detects infra services and creates handles for them.
+   */
+  startCompose(): Promise<void>;
+  /**
+   * Stop docker compose stack (e2e mode).
+   */
+  stopCompose(): Promise<void>;
+  /**
+   * Get a database service by compose name, or the first one if no name given.
+   */
+  getDatabase(serviceName?: string): DatabasePort | null;
+  /**
+   * Get all database services keyed by compose name.
+   */
+  getDatabases(): Map<string, DatabasePort>;
+  /**
+   * Get app URL from compose (e2e mode).
+   */
+  getAppUrl(): null | string;
+}
+//#endregion
+//#region src/runner/integration.d.ts
+type HonoApp = {
+  fetch: (...args: any[]) => any;
+  request: (path: string, init?: RequestInit) => Promise<Response> | Response;
+};
+interface IntegrationOptions {
+  /** Factory that returns a Hono app — called after services start. */
+  app: () => HonoApp;
+  /** Project root for compose detection (relative paths supported). */
+  root?: string;
+  /** Declared services — started via testcontainers. */
+  services: ServiceHandle[];
+}
+interface SpecificationRunnerWithCleanup extends SpecificationRunner {
+  cleanup: () => Promise<void>;
+  orchestrator: Orchestrator;
+}
+/**
+ * Create an integration specification runner.
+ * Starts infra containers via testcontainers, app runs in-process.
+ */
+declare function integration(options: IntegrationOptions): Promise<SpecificationRunnerWithCleanup>;
 //#endregion
-//#region src/infrastructure/services/postgres.d.ts
+//#region src/runner/cli.d.ts
+interface CliOptions {
+  /** CLI command to run (resolved from node_modules/.bin or PATH). */
+  command: string;
+  /** Project root — base dir for .project() fixture lookup (relative paths supported). */
+  root?: string;
+  /** Optional infrastructure services (started via testcontainers). */
+  services?: ServiceHandle[];
+}
+/**
+ * Create a CLI specification runner.
+ * Runs CLI commands against fixture projects. Optionally starts infrastructure.
+ */
+declare function cli(options: CliOptions): Promise<SpecificationRunnerWithCleanup>;
+//#endregion
+//#region src/runner/e2e.d.ts
+interface E2eOptions {
+  /** Project root — must contain docker/compose.test.yaml. */
+  root?: string;
+}
+/**
+ * Create an E2E specification runner.
+ * Starts full docker compose stack. App URL and database auto-detected.
+ */
+declare function e2e(options?: E2eOptions): Promise<SpecificationRunnerWithCleanup>;
+//#endregion
+//#region src/ports/container.port.d.ts
+/**
+ * Abstract container interface.
+ * Represents a running service (database, cache, etc.)
+ */
+interface ContainerPort {
+  /** Start the container and wait until ready. */
+  start(): Promise<void>;
+  /** Stop and remove the container. */
+  stop(): Promise<void>;
+  /** Get the mapped host port for a container port. */
+  getMappedPort(containerPort: number): number;
+  /** Get the host to connect to. */
+  getHost(): string;
+  /** Get a full connection string for this service. */
+  getConnectionString(): string;
+  /** Get container logs (stdout + stderr). */
+  getLogs(): Promise<string>;
+}
+//#endregion
+//#region src/adapters/exec.adapter.d.ts
+/**
+ * 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, extraEnv?: CommandEnv): Promise<CommandResult>;
+  spawn(args: string, cwd: string, options: SpawnOptions, extraEnv?: CommandEnv): Promise<CommandResult>;
+}
+//#endregion
+//#region src/adapters/fetch.adapter.d.ts
+/**
+ * Server adapter for real HTTP — sends actual fetch requests.
+ * Used by e2e() specification runner.
+ */
+declare class FetchAdapter implements ServerPort {
+  private baseUrl;
+  constructor(url: string);
+  request(method: string, path: string, body?: unknown): Promise<ServerResponse>;
+}
+//#endregion
+//#region src/adapters/hono.adapter.d.ts
+/**
+ * Server adapter for Hono — in-process requests, no real HTTP.
+ * Used by integration() specification runner.
+ */
+declare class HonoAdapter implements ServerPort {
+  private app;
+  constructor(app: {
+    request: (path: string, init?: RequestInit) => Promise<Response> | Response;
+  });
+  request(method: string, path: string, body?: unknown): Promise<ServerResponse>;
+}
+//#endregion
+//#region src/adapters/postgres.adapter.d.ts
 interface PostgresOptions {
   /** Map to a service in docker-compose.test.yaml. */
   compose?: string;
@@ -329,7 +432,7 @@ declare class PostgresHandle implements DatabasePort, ServiceHandle {
  */
 declare function postgres(options?: PostgresOptions): PostgresHandle;
 //#endregion
-//#region src/infrastructure/services/redis.d.ts
+//#region src/adapters/redis.adapter.d.ts
 interface RedisOptions {
   /** Map to a service in docker-compose.test.yaml. */
   compose?: string;
@@ -360,110 +463,7 @@ declare class RedisHandle implements ServiceHandle {
  */
 declare function redis(options?: RedisOptions): RedisHandle;
 //#endregion
-//#region src/specification/adapters/exec.adapter.d.ts
-/**
- * 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, extraEnv?: CommandEnv): Promise<CommandResult>;
-  spawn(args: string, cwd: string, options: SpawnOptions, extraEnv?: CommandEnv): Promise<CommandResult>;
-}
-//#endregion
-//#region src/specification/adapters/fetch.adapter.d.ts
-/**
- * Server adapter for real HTTP — sends actual fetch requests.
- * Used by e2e() specification runner.
- */
-declare class FetchAdapter implements ServerPort {
-  private baseUrl;
-  constructor(url: string);
-  request(method: string, path: string, body?: unknown): Promise<ServerResponse>;
-}
-//#endregion
-//#region src/specification/adapters/hono.adapter.d.ts
-/**
- * Server adapter for Hono — in-process requests, no real HTTP.
- * Used by integration() specification runner.
- */
-declare class HonoAdapter implements ServerPort {
-  private app;
-  constructor(app: {
-    request: (path: string, init?: RequestInit) => Promise<Response> | Response;
-  });
-  request(method: string, path: string, body?: unknown): Promise<ServerResponse>;
-}
-//#endregion
-//#region src/specification/grep.d.ts
-/**
- * Extract text blocks from output that contain a pattern.
- * Splits by blank lines (how linter/compiler output is structured),
- * returns only blocks matching the pattern.
- *
- * @example
- * expect(grep(result.stdout, "unused-var.ts")).toContain("no-unused-vars")
- * expect(grep(result.stdout, "valid/sorted.ts")).not.toContain("sort-imports")
- */
-declare function grep(output: string, pattern: string): string;
-//#endregion
-//#region src/infrastructure/reporter.d.ts
-declare function stripAnsi(str: string): string;
-declare function normalizeOutput(str: string): string;
-//#endregion
-//#region src/specification/index.d.ts
-type HonoApp = {
-  fetch: (...args: any[]) => any;
-  request: (path: string, init?: RequestInit) => Promise<Response> | Response;
-};
-interface IntegrationOptions {
-  /** Factory that returns a Hono app — called after services start. */
-  app: () => HonoApp;
-  /** Project root for compose detection (relative paths supported). */
-  root?: string;
-  /** Declared services — started via testcontainers. */
-  services: ServiceHandle[];
-}
-interface E2eOptions {
-  /** Project root — must contain docker/compose.test.yaml. */
-  root?: string;
-}
-interface CliOptions {
-  /** CLI command to run (resolved from node_modules/.bin or PATH). */
-  command: string;
-  /** Project root — base dir for .project() fixture lookup (relative paths supported). */
-  root?: string;
-  /** Optional infrastructure services (started via testcontainers). */
-  services?: ServiceHandle[];
-}
-interface SpecificationRunnerWithCleanup extends SpecificationRunner {
-  cleanup: () => Promise<void>;
-  orchestrator: Orchestrator;
-}
-/**
- * Create an integration specification runner.
- * Starts infra containers via testcontainers, app runs in-process.
- */
-declare function integration(options: IntegrationOptions): Promise<SpecificationRunnerWithCleanup>;
-/**
- * Create an E2E specification runner.
- * Starts full docker compose stack. App URL and database auto-detected.
- */
-declare function e2e(options?: E2eOptions): Promise<SpecificationRunnerWithCleanup>;
-/**
- * Create a CLI specification runner.
- * Runs CLI commands against fixture projects. Optionally starts infrastructure.
- *
- * @example
- * export const spec = await cli({
- *     command: resolve(import.meta.dirname, "../../bin/my-cli.sh"),
- *     root: "../fixtures",
- * });
- */
-declare function cli(options: CliOptions): Promise<SpecificationRunnerWithCleanup>;
-//#endregion
-//#region src/infrastructure/docker/docker-port.d.ts
+//#region src/docker/docker-port.d.ts
 interface DockerContainerPort {
   /** Execute a command inside the container, return stdout */
   exec(cmd: string[]): Promise<string>;
@@ -511,11 +511,11 @@ interface DockerInspectResult {
   };
 }
 //#endregion
-//#region src/infrastructure/docker/docker-adapter.d.ts
+//#region src/docker/docker-adapter.d.ts
 /** Create a Docker container port for an existing container */
 declare function dockerContainer(containerId: string): DockerContainerPort;
 //#endregion
-//#region src/infrastructure/docker/docker-assertion.d.ts
+//#region src/docker/docker-assertion.d.ts
 /** Fluent assertion builder for Docker containers */
 declare class DockerAssertion {
   private container;
@@ -548,5 +548,32 @@ declare class DockerAssertion {
   getLogs(tail?: number): Promise<string>;
 }
 //#endregion
-export { type CommandEnv, type CommandPort, type CommandResult, type DatabasePort, type DirectoryAccessor, type DirectorySnapshotOptions, DockerAssertion, type DockerContainerPort, type DockerInspectResult, ExecAdapter, FetchAdapter, HonoAdapter, type MockDatePort, type MockPort, Orchestrator, type ServerPort, type ServerResponse, type SpecificationResult, cli, dockerContainer, e2e, grep, integration, mockOf, mockOfDate, normalizeOutput, postgres, redis, stripAnsi };
+//#region src/utilities/grep.d.ts
+/**
+ * Extract text blocks from output that contain a pattern.
+ * Splits by blank lines (how linter/compiler output is structured),
+ * returns only blocks matching the pattern.
+ *
+ * @example
+ * expect(grep(result.stdout, "unused-var.ts")).toContain("no-unused-vars")
+ * expect(grep(result.stdout, "valid/sorted.ts")).not.toContain("sort-imports")
+ */
+declare function grep(output: string, pattern: string): string;
+//#endregion
+//#region src/utilities/reporter.d.ts
+declare function stripAnsi(str: string): string;
+declare function normalizeOutput(str: string): string;
+//#endregion
+//#region src/mocking/mock-of-date.d.ts
+interface MockDatePort {
+  reset: () => void;
+  set: (date: Date | number | string) => void;
+}
+declare const mockOfDate: MockDatePort;
+//#endregion
+//#region src/mocking/mock-of.d.ts
+type MockPort = <T>() => DeepMockProxy<T>;
+declare const mockOf: MockPort;
+//#endregion
+export { type CliOptions, type CommandEnv, type CommandPort, type CommandResult, type ContainerPort, type DatabasePort, DirectoryAccessor, type DirectorySnapshotOptions, DockerAssertion, type DockerContainerPort, type DockerInspectResult, type E2eOptions, ExecAdapter, FetchAdapter, type FileAccessor, HonoAdapter, type IntegrationOptions, type MockDatePort, type MockPort, Orchestrator, type PostgresOptions, type RedisOptions, ResponseAccessor, type ServerPort, type ServerResponse, type ServiceHandle, type SpawnOptions, SpecificationBuilder, type SpecificationConfig, SpecificationResult, type SpecificationRunner, type SpecificationRunnerWithCleanup, TableAssertion, cli, createSpecificationRunner, dockerContainer, e2e, grep, integration, mockOf, mockOfDate, normalizeOutput, postgres, redis, stripAnsi };
 //# sourceMappingURL=index.d.ts.map