@jterrazz/test 6.2.0 → 6.4.1

package/dist/index.js

@@ -6,7 +6,7 @@ import { tmpdir } from "node:os";
 import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
 import { readdir } from "node:fs/promises";
 import { parse } from "yaml";
-//#region src/adapters/exec.adapter.ts
+//#region src/builder/cli/adapters/exec.adapter.ts
 /**
 * Build a child-process env from the parent env plus user overrides.
 * `null` overrides delete keys (e.g. `INIT_CWD: null`).
@@ -103,7 +103,7 @@ var ExecAdapter = class {
 	}
 };
 //#endregion
-//#region src/adapters/fetch.adapter.ts
+//#region src/builder/http/adapters/fetch.adapter.ts
 /**
 * Server adapter that sends real HTTP requests via the Fetch API.
 * Used by the `e2e()` specification runner to hit a live server.
@@ -136,7 +136,7 @@ var FetchAdapter = class {
 	}
 };
 //#endregion
-//#region src/adapters/hono.adapter.ts
+//#region src/builder/http/adapters/hono.adapter.ts
 /**
 * Server adapter that dispatches requests in-process through a Hono app instance.
 * Used by the `integration()` specification runner -- no network overhead.
@@ -169,21 +169,7 @@ var HonoAdapter = class {
 	}
 };
 //#endregion
-//#region src/utilities/grep.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")
-*/
-function grep(output, pattern) {
-	return output.replace(/\x1b\[[0-9;]*m/g, "").split(/\n\s*\n/).filter((block) => block.includes(pattern)).join("\n\n");
-}
-//#endregion
-//#region src/utilities/directory.ts
+//#region src/builder/common/directory.ts
 /**
 * Default ignore patterns — paths that should never appear in a tracked snapshot.
 * Each entry is matched against any path segment OR a path prefix.
@@ -252,7 +238,7 @@ async function diffDirectories(expectedRoot, actualRoot, options = {}) {
 	};
 }
 //#endregion
-//#region src/utilities/reporter.ts
+//#region src/builder/common/reporter.ts
 const GREEN = "\x1B[32m";
 const RED = "\x1B[31m";
 const DIM = "\x1B[2m";
@@ -390,7 +376,7 @@ function normalizeOutput(str) {
 	return stripAnsi(str).replace(/localhost:\d+/g, "localhost:PORT").replace(/\d+ms/g, "Xms").replace(/\d+\.\d+s/g, "X.Xs").trim();
 }
 //#endregion
-//#region src/builder/directory-accessor.ts
+//#region src/builder/common/directory-accessor.ts
 /**
 * Detect whether the user wants to update snapshots — `true` for any of:
 *   - vitest run with `-u` / `--update`
@@ -444,7 +430,21 @@ var DirectoryAccessor = class {
 	}
 };
 //#endregion
-//#region src/builder/response-accessor.ts
+//#region src/builder/common/grep.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")
+*/
+function grep(output, pattern) {
+	return output.replace(/\x1b\[[0-9;]*m/g, "").split(/\n\s*\n/).filter((block) => block.includes(pattern)).join("\n\n");
+}
+//#endregion
+//#region src/builder/common/response-accessor.ts
 /** Accessor for an HTTP response body with file-based assertion support. */
 var ResponseAccessor = class {
 	body;
@@ -465,7 +465,7 @@ var ResponseAccessor = class {
 	}
 };
 //#endregion
-//#region src/builder/table-assertion.ts
+//#region src/builder/common/table-assertion.ts
 /** Assertion helper for verifying database table contents after a specification run. */
 var TableAssertion = class {
 	tableName;
@@ -494,7 +494,7 @@ var TableAssertion = class {
 	}
 };
 //#endregion
-//#region src/builder/specification-result.ts
+//#region src/builder/common/result.ts
 /**
 * The outcome of a single specification run.
 * Provides accessors for CLI output, HTTP responses, files, directories, and database tables.
@@ -590,6 +590,8 @@ var SpecificationBuilder = class {
 	commandEnv = {};
 	config;
 	fixtures = [];
+	intercepts = [];
+	jobName = null;
 	label;
 	mocks = [];
 	projectName = null;
@@ -662,6 +664,28 @@ var SpecificationBuilder = class {
 		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
@@ -727,6 +751,18 @@ var SpecificationBuilder = class {
 		return this;
 	}
 	/**
+	* Execute a named job registered via the app() factory.
+	*
+	* @param name - The job name to trigger (must match a registered JobHandle.name).
+	*
+	* @example
+	*   spec('pipeline').intercept(openai.chat(), openai.response({...})).job('report-refresh').run();
+	*/
+	job(name) {
+		this.jobName = name;
+		return this;
+	}
+	/**
 	* Execute the specification: run seeds, copy fixtures, then perform the
 	* configured action (HTTP or CLI).
 	*
@@ -738,8 +774,14 @@ var SpecificationBuilder = class {
 	async run() {
 		const hasHttpAction = this.request !== 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/.spawn) actions`);
+		const hasJobAction = this.jobName !== null;
+		const actionCount = [
+			hasHttpAction,
+			hasCliAction,
+			hasJobAction
+		].filter(Boolean).length;
+		if (actionCount === 0) throw new Error(`Specification "${this.label}": no action defined. Call .get(), .post(), .exec(), .job(), etc. before .run()`);
+		if (actionCount > 1) throw new Error(`Specification "${this.label}": cannot mix action types (.get/.post, .exec/.spawn, .job)`);
 		let workDir = null;
 		if (hasCliAction) workDir = this.prepareWorkDir();
 		if (this.config.databases) for (const db of this.config.databases.values()) await db.reset();
@@ -755,9 +797,18 @@ 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("./intercept2.js");
+			cleanupIntercepts = await registerIntercepts(this.intercepts);
+		}
+		try {
+			if (hasHttpAction) return await this.runHttpAction();
+			if (hasJobAction) return await this.runJobAction();
+			return await this.runCliAction(workDir);
+		} finally {
+			if (cleanupIntercepts) cleanupIntercepts();
+		}
 	}
 	resolveEnv(workDir) {
 		const keys = Object.keys(this.commandEnv);
@@ -795,6 +846,19 @@ var SpecificationBuilder = class {
 			testDir: this.testDir
 		});
 	}
+	async runJobAction() {
+		if (!this.config.jobs?.length) throw new Error("Job actions require jobs registered via app(() => ({ server, jobs }))");
+		const job = this.config.jobs.find((j) => j.name === this.jobName);
+		if (!job) {
+			const available = this.config.jobs.map((j) => j.name).join(", ");
+			throw new Error(`job("${this.jobName}"): not found. Available: ${available}`);
+		}
+		await job.execute();
+		return new SpecificationResult({
+			config: this.config,
+			testDir: this.testDir
+		});
+	}
 	async runCliAction(workDir) {
 		if (!this.config.command) throw new Error("CLI actions require a command adapter (use cli())");
 		const env = this.resolveEnv(workDir);
@@ -828,7 +892,7 @@ function getCallerDir() {
 		if (!match) continue;
 		const filePath = match[1];
 		if (filePath.includes("node_modules")) continue;
-		if (filePath.includes("/src/builder/") || filePath.includes("/src/runner/")) continue;
+		if (filePath.includes("/src/builder/") || filePath.includes("/src/spec/")) continue;
 		return resolve(filePath, "..");
 	}
 	throw new Error("Cannot detect caller directory from stack trace");
@@ -1020,7 +1084,7 @@ var DockerAssertion = class {
 	}
 };
 //#endregion
-//#region src/adapters/compose.adapter.ts
+//#region src/infra/adapters/compose.adapter.ts
 /**
 * Start the full compose stack and stop it all on cleanup.
 * Supports per-worker project names for parallel execution.
@@ -1067,7 +1131,7 @@ var ComposeStackAdapter = class {
 	}
 };
 //#endregion
-//#region src/adapters/testcontainers.adapter.ts
+//#region src/infra/adapters/testcontainers.adapter.ts
 /**
 * Container adapter using testcontainers.
 * Wraps a GenericContainer for programmatic container lifecycle.
@@ -1127,7 +1191,7 @@ var TestcontainersAdapter = class {
 	}
 };
 //#endregion
-//#region src/orchestrator/compose-parser.ts
+//#region src/infra/compose-parser.ts
 /**
 * Detect the service type from the image name.
 */
@@ -1200,7 +1264,7 @@ function parseComposeFile(filePath) {
 	};
 }
 //#endregion
-//#region src/orchestrator/orchestrator.ts
+//#region src/infra/orchestrator.ts
 /**
 * Orchestrator for test infrastructure.
 * Integration: starts services via testcontainers.
@@ -1409,7 +1473,7 @@ var Orchestrator = class {
 	}
 };
 //#endregion
-//#region src/runner/resolve.ts
+//#region src/spec/resolve.ts
 /**
 * Resolve root — if relative, resolves from the caller's directory.
 */
@@ -1423,7 +1487,7 @@ function resolveProjectRoot(root) {
 			const match = line.match(/at\s+(?:.*?\()?(?:file:\/\/)?([^:)]+):\d+:\d+/);
 			if (!match) continue;
 			const filePath = match[1];
-			if (filePath.includes("node_modules") || filePath.includes("/src/runner/")) continue;
+			if (filePath.includes("node_modules") || filePath.includes("/src/spec/")) continue;
 			return resolve(filePath, "..", root);
 		}
 	}
@@ -1441,7 +1505,7 @@ function resolveCommand(command, root) {
 	return command;
 }
 //#endregion
-//#region src/runner/spec.ts
+//#region src/spec/spec.ts
 /**
 * Create a specification runner for the given target.
 *
@@ -1489,12 +1553,15 @@ async function startApp(target, options) {
 		const key = svc.composeName ?? svc.type;
 		servicesMap[key] = svc;
 	}
-	const honoApp = target.factory(servicesMap);
+	const factoryResult = target.factory(servicesMap);
+	const honoApp = "server" in factoryResult ? factoryResult.server : factoryResult;
+	const jobs = "jobs" in factoryResult ? factoryResult.jobs : void 0;
 	const database = orchestrator.getDatabase() ?? void 0;
 	const databases = orchestrator.getDatabases();
 	const runner = createSpecificationRunner({
 		database,
 		databases: databases.size > 0 ? databases : void 0,
+		jobs,
 		server: new HonoAdapter(honoApp)
 	});
 	runner.cleanup = async () => {
@@ -1563,7 +1630,7 @@ async function startCommand(target, options) {
 	return runner;
 }
 //#endregion
-//#region src/runner/targets.ts
+//#region src/spec/targets.ts
 /**
 * Test against an in-process Hono app. The factory receives started services
 * so you can wire connection strings into your app/DI container.
@@ -1613,7 +1680,7 @@ function command(bin) {
 	};
 }
 //#endregion
-//#region src/runner/cli.ts
+//#region src/spec/legacy-cli.ts
 /**
 * Create a CLI specification runner.
 * Runs CLI commands against fixture projects. Optionally starts infrastructure.
@@ -1648,7 +1715,7 @@ async function cli(options) {
 	return runner;
 }
 //#endregion
-//#region src/runner/e2e.ts
+//#region src/spec/legacy-e2e.ts
 /**
 * Create an E2E specification runner.
 * Starts full docker compose stack. App URL and database auto-detected.
@@ -1674,7 +1741,7 @@ async function e2e(options = {}) {
 	return runner;
 }
 //#endregion
-//#region src/runner/integration.ts
+//#region src/spec/legacy-integration.ts
 /**
 * Create an integration specification runner.
 * Starts infra containers via testcontainers, app runs in-process.