@jterrazz/test 6.1.0 → 6.3.0

package/dist/index.d.cts

@@ -1,3 +1,4 @@
+import { n as InterceptResponse, r as InterceptTrigger } from "./types.cjs";
 import { a as PostgresOptions, c as IsolationStrategy, i as redis, l as DatabasePort, n as sqlite, o as postgres, r as RedisOptions, s as ServiceHandle, t as SqliteOptions } from "./sqlite.adapter.cjs";
 import { i as mockOfDate, n as mockOf, r as MockDatePort, t as MockPort } from "./mock-of.cjs";
 
@@ -56,7 +57,7 @@ interface ServerResponse {
  */
 interface ServerPort {
   /** Send an HTTP request and return the parsed response. */
-  request(method: string, path: string, body?: unknown): Promise<ServerResponse>;
+  request(method: string, path: string, body?: unknown, headers?: Record<string, string>): Promise<ServerResponse>;
 }
 //#endregion
 //#region src/builder/directory-accessor.d.ts
@@ -210,10 +211,12 @@ declare class SpecificationBuilder {
   private commandEnv;
   private config;
   private fixtures;
+  private intercepts;
   private label;
   private mocks;
   private projectName;
   private request;
+  private requestHeaders;
   private seeds;
   private spawnConfig;
   private testDir;
@@ -244,6 +247,29 @@ declare class SpecificationBuilder {
    *   spec("...").env({ HOME: "$WORKDIR", TZ: "UTC" }).exec("status").run();
    */
   env(env: CommandEnv): this;
+  /**
+   * Set HTTP headers for the request. Multiple calls merge.
+   *
+   * @example
+   *   spec("french").headers({ 'Accept-Language': 'fr' }).get("/articles").run();
+   */
+  headers(headers: Record<string, string>): this;
+  /**
+   * Intercept an outgoing HTTP request and return a controlled response.
+   * Uses MSW under the hood. Intercepts are queued — multiple calls with the
+   * same trigger fire sequentially (first match consumed first).
+   *
+   * @param trigger - What to match (use openai.chat(), anthropic.messages(), http.get(), etc.)
+   * @param response - What to return (use openai.response(), http.json(), etc.)
+   *
+   * @example
+   *   spec('pipeline')
+   *       .intercept(openai.chat(), openai.response({ categories: ['TECH'] }))
+   *       .intercept(openai.chat(), openai.response({ headline: 'AI News' }))
+   *       .exec('process')
+   *       .run();
+   */
+  intercept(trigger: InterceptTrigger, response: InterceptResponse): this;
   /**
    * Send a GET request to the server adapter.
    *
@@ -440,8 +466,8 @@ declare class Orchestrator {
 }
 //#endregion
 //#region src/runner/targets.d.ts
+/** Any object with a request method compatible with Hono's app.request(). */
 type HonoApp$1 = {
-  fetch: (...args: any[]) => any;
   request: (path: string, init?: RequestInit) => Promise<Response> | Response;
 };
 /** Services map passed to the app factory after infrastructure starts. */
@@ -582,7 +608,7 @@ declare class ExecAdapter implements CommandPort {
 declare class FetchAdapter implements ServerPort {
   private baseUrl;
   constructor(url: string);
-  request(method: string, path: string, body?: unknown): Promise<ServerResponse>;
+  request(method: string, path: string, body?: unknown, headers?: Record<string, string>): Promise<ServerResponse>;
 }
 //#endregion
 //#region src/adapters/hono.adapter.d.ts
@@ -595,7 +621,7 @@ declare class HonoAdapter implements ServerPort {
   constructor(app: {
     request: (path: string, init?: RequestInit) => Promise<Response> | Response;
   });
-  request(method: string, path: string, body?: unknown): Promise<ServerResponse>;
+  request(method: string, path: string, body?: unknown, headers?: Record<string, string>): Promise<ServerResponse>;
 }
 //#endregion
 //#region src/runner/integration.d.ts

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { n as InterceptResponse, r as InterceptTrigger } from "./types.js";
 import { a as PostgresOptions, c as IsolationStrategy, i as redis, l as DatabasePort, n as sqlite, o as postgres, r as RedisOptions, s as ServiceHandle, t as SqliteOptions } from "./sqlite.adapter.js";
 import { i as mockOfDate, n as mockOf, r as MockDatePort, t as MockPort } from "./mock-of.js";
 
@@ -56,7 +57,7 @@ interface ServerResponse {
  */
 interface ServerPort {
   /** Send an HTTP request and return the parsed response. */
-  request(method: string, path: string, body?: unknown): Promise<ServerResponse>;
+  request(method: string, path: string, body?: unknown, headers?: Record<string, string>): Promise<ServerResponse>;
 }
 //#endregion
 //#region src/builder/directory-accessor.d.ts
@@ -210,10 +211,12 @@ declare class SpecificationBuilder {
   private commandEnv;
   private config;
   private fixtures;
+  private intercepts;
   private label;
   private mocks;
   private projectName;
   private request;
+  private requestHeaders;
   private seeds;
   private spawnConfig;
   private testDir;
@@ -244,6 +247,29 @@ declare class SpecificationBuilder {
    *   spec("...").env({ HOME: "$WORKDIR", TZ: "UTC" }).exec("status").run();
    */
   env(env: CommandEnv): this;
+  /**
+   * Set HTTP headers for the request. Multiple calls merge.
+   *
+   * @example
+   *   spec("french").headers({ 'Accept-Language': 'fr' }).get("/articles").run();
+   */
+  headers(headers: Record<string, string>): this;
+  /**
+   * Intercept an outgoing HTTP request and return a controlled response.
+   * Uses MSW under the hood. Intercepts are queued — multiple calls with the
+   * same trigger fire sequentially (first match consumed first).
+   *
+   * @param trigger - What to match (use openai.chat(), anthropic.messages(), http.get(), etc.)
+   * @param response - What to return (use openai.response(), http.json(), etc.)
+   *
+   * @example
+   *   spec('pipeline')
+   *       .intercept(openai.chat(), openai.response({ categories: ['TECH'] }))
+   *       .intercept(openai.chat(), openai.response({ headline: 'AI News' }))
+   *       .exec('process')
+   *       .run();
+   */
+  intercept(trigger: InterceptTrigger, response: InterceptResponse): this;
   /**
    * Send a GET request to the server adapter.
    *
@@ -440,8 +466,8 @@ declare class Orchestrator {
 }
 //#endregion
 //#region src/runner/targets.d.ts
+/** Any object with a request method compatible with Hono's app.request(). */
 type HonoApp$1 = {
-  fetch: (...args: any[]) => any;
   request: (path: string, init?: RequestInit) => Promise<Response> | Response;
 };
 /** Services map passed to the app factory after infrastructure starts. */
@@ -582,7 +608,7 @@ declare class ExecAdapter implements CommandPort {
 declare class FetchAdapter implements ServerPort {
   private baseUrl;
   constructor(url: string);
-  request(method: string, path: string, body?: unknown): Promise<ServerResponse>;
+  request(method: string, path: string, body?: unknown, headers?: Record<string, string>): Promise<ServerResponse>;
 }
 //#endregion
 //#region src/adapters/hono.adapter.d.ts
@@ -595,7 +621,7 @@ declare class HonoAdapter implements ServerPort {
   constructor(app: {
     request: (path: string, init?: RequestInit) => Promise<Response> | Response;
   });
-  request(method: string, path: string, body?: unknown): Promise<ServerResponse>;
+  request(method: string, path: string, body?: unknown, headers?: Record<string, string>): Promise<ServerResponse>;
 }
 //#endregion
 //#region src/runner/integration.d.ts

package/dist/index.js

@@ -113,22 +113,25 @@ var FetchAdapter = class {
 	constructor(url) {
 		this.baseUrl = url.replace(/\/$/, "");
 	}
-	async request(method, path, body) {
+	async request(method, path, body, headers) {
 		const init = {
 			method,
-			headers: { "Content-Type": "application/json" }
+			headers: {
+				"Content-Type": "application/json",
+				...headers
+			}
 		};
 		if (body !== void 0) init.body = JSON.stringify(body);
 		const response = await fetch(`${this.baseUrl}${path}`, init);
 		const responseBody = await response.json().catch(() => null);
-		const headers = {};
+		const responseHeaders = {};
 		response.headers.forEach((value, key) => {
-			headers[key] = value;
+			responseHeaders[key] = value;
 		});
 		return {
 			status: response.status,
 			body: responseBody,
-			headers
+			headers: responseHeaders
 		};
 	}
 };
@@ -143,22 +146,25 @@ var HonoAdapter = class {
 	constructor(app) {
 		this.app = app;
 	}
-	async request(method, path, body) {
+	async request(method, path, body, headers) {
 		const init = {
 			method,
-			headers: { "Content-Type": "application/json" }
+			headers: {
+				"Content-Type": "application/json",
+				...headers
+			}
 		};
 		if (body !== void 0) init.body = JSON.stringify(body);
 		const response = await this.app.request(path, init);
 		const responseBody = await response.json().catch(() => null);
-		const headers = {};
+		const responseHeaders = {};
 		response.headers.forEach((value, key) => {
-			headers[key] = value;
+			responseHeaders[key] = value;
 		});
 		return {
 			status: response.status,
 			body: responseBody,
-			headers
+			headers: responseHeaders
 		};
 	}
 };
@@ -584,10 +590,12 @@ var SpecificationBuilder = class {
 	commandEnv = {};
 	config;
 	fixtures = [];
+	intercepts = [];
 	label;
 	mocks = [];
 	projectName = null;
 	request = null;
+	requestHeaders = {};
 	seeds = [];
 	spawnConfig = null;
 	testDir;
@@ -642,6 +650,41 @@ var SpecificationBuilder = class {
 		return this;
 	}
 	/**
+	* Set HTTP headers for the request. Multiple calls merge.
+	*
+	* @example
+	*   spec("french").headers({ 'Accept-Language': 'fr' }).get("/articles").run();
+	*/
+	headers(headers) {
+		this.requestHeaders = {
+			...this.requestHeaders,
+			...headers
+		};
+		return this;
+	}
+	/**
+	* Intercept an outgoing HTTP request and return a controlled response.
+	* Uses MSW under the hood. Intercepts are queued — multiple calls with the
+	* same trigger fire sequentially (first match consumed first).
+	*
+	* @param trigger - What to match (use openai.chat(), anthropic.messages(), http.get(), etc.)
+	* @param response - What to return (use openai.response(), http.json(), etc.)
+	*
+	* @example
+	*   spec('pipeline')
+	*       .intercept(openai.chat(), openai.response({ categories: ['TECH'] }))
+	*       .intercept(openai.chat(), openai.response({ headline: 'AI News' }))
+	*       .exec('process')
+	*       .run();
+	*/
+	intercept(trigger, response) {
+		this.intercepts.push({
+			trigger,
+			response
+		});
+		return this;
+	}
+	/**
 	* Send a GET request to the server adapter.
 	*
 	* @example
@@ -735,9 +778,17 @@ var SpecificationBuilder = class {
 			await db.seed(sql);
 		}
 		if (this.fixtures.length > 0 && workDir) for (const entry of this.fixtures) cpSync(resolve(this.testDir, "fixtures", entry.file), resolve(workDir, entry.file), { recursive: true });
-		for (const entry of this.mocks) JSON.parse(readFileSync(resolve(this.testDir, "mock", entry.file), "utf8"));
-		if (hasHttpAction) return this.runHttpAction();
-		return this.runCliAction(workDir);
+		let cleanupIntercepts = null;
+		if (this.intercepts.length > 0) {
+			const { registerIntercepts } = await import("./server.js");
+			cleanupIntercepts = await registerIntercepts(this.intercepts);
+		}
+		try {
+			if (hasHttpAction) return await this.runHttpAction();
+			return await this.runCliAction(workDir);
+		} finally {
+			if (cleanupIntercepts) cleanupIntercepts();
+		}
 	}
 	resolveEnv(workDir) {
 		const keys = Object.keys(this.commandEnv);
@@ -762,7 +813,8 @@ var SpecificationBuilder = class {
 		if (!this.config.server) throw new Error("HTTP actions require a server adapter (use integration() or e2e())");
 		let body;
 		if (this.request.bodyFile) body = JSON.parse(readFileSync(resolve(this.testDir, "requests", this.request.bodyFile), "utf8"));
-		const response = await this.config.server.request(this.request.method, this.request.path, body);
+		const headers = Object.keys(this.requestHeaders).length > 0 ? this.requestHeaders : void 0;
+		const response = await this.config.server.request(this.request.method, this.request.path, body, headers);
 		return new SpecificationResult({
 			config: this.config,
 			requestInfo: {