@jterrazz/test 6.3.0 → 6.4.2

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.
@@ -591,6 +591,7 @@ var SpecificationBuilder = class {
 	config;
 	fixtures = [];
 	intercepts = [];
+	jobName = null;
 	label;
 	mocks = [];
 	projectName = null;
@@ -750,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).
 	*
@@ -761,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();
@@ -780,11 +799,12 @@ var SpecificationBuilder = class {
 		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 });
 		let cleanupIntercepts = null;
 		if (this.intercepts.length > 0) {
-			const { registerIntercepts } = await import("./server.js");
+			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();
@@ -826,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);
@@ -859,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");
@@ -1051,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.
@@ -1098,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.
@@ -1158,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.
 */
@@ -1231,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.
@@ -1440,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.
 */
@@ -1454,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);
 		}
 	}
@@ -1472,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.
 *
@@ -1520,12 +1553,16 @@ 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 isComposite = Array.isArray(factoryResult.jobs);
+	const honoApp = isComposite ? factoryResult.server : factoryResult;
+	const jobs = isComposite ? 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 () => {
@@ -1594,7 +1631,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.
@@ -1644,7 +1681,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.
@@ -1679,7 +1716,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.
@@ -1705,7 +1742,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.