@jterrazz/test 6.0.0 → 6.2.0

package/README.md

@@ -35,13 +35,13 @@ afterAll(() => run.cleanup());
 import { run } from '../../setup/integration.specification.js';
 
 test('creates a user', async () => {
-    // Given — one existing user
+    // Given - one existing user
     const result = await run('creates user')
         .seed('initial-users.sql')
         .post('/users', 'new-user.json')
         .run();
 
-    // Then — user created
+    // Then - user created
     expect(result.status).toBe(201);
     await result.table('users').toMatch({
         columns: ['name'],
@@ -67,10 +67,10 @@ export const run = await spec(command(resolve(import.meta.dirname, '../../bin/my
 import { run } from '../../setup/cli.specification.js';
 
 test('builds the project', async () => {
-    // Given — sample app project
+    // Given - sample app project
     const result = await run('build').project('sample-app').exec('build').run();
 
-    // Then — ESM output with source maps
+    // Then - ESM output with source maps
     expect(result.exitCode).toBe(0);
     expect(result.stdout).toContain('Build completed');
     expect(result.file('dist/index.js').exists).toBe(true);
@@ -83,7 +83,7 @@ test('builds the project', async () => {
 
 Three modes, same builder API. Each handles infrastructure and cleanup automatically.
 
-### `spec(app(...))` — testcontainers + in-process app
+### `spec(app(...))` - testcontainers + in-process app
 
 Starts real containers via testcontainers. App runs in-process (Hono). Fastest feedback loop.
 
@@ -103,7 +103,7 @@ export const run = await spec(
 );
 ```
 
-### `spec(stack(...))` — docker compose up + real HTTP
+### `spec(stack(...))` - docker compose up + real HTTP
 
 Starts the full `docker/compose.test.yaml` stack. App URL and databases auto-detected.
 
@@ -113,7 +113,7 @@ import { spec, stack } from '@jterrazz/test';
 export const run = await spec(stack('../../'));
 ```
 
-### `spec(command(...))` — local command execution
+### `spec(command(...))` - local command execution
 
 Runs CLI commands against fixture projects in temp directories. Optionally starts infrastructure.
 
@@ -331,13 +331,13 @@ Every test uses `// Given` and `// Then` comments. Always both, never one withou
 
 ```typescript
 test('creates a user and returns 201', async () => {
-    // Given — two existing users
+    // Given - two existing users
     const result = await run('creates user')
         .seed('initial-users.sql')
         .post('/users', 'new-user.json')
         .run();
 
-    // Then — user created with all three in table
+    // Then - user created with all three in table
     expect(result.status).toBe(201);
     await result.table('users').toMatch({
         columns: ['name'],

package/dist/chunk.cjs

@@ -0,0 +1,28 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});

package/dist/index.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./chunk.cjs");
+const require_sqlite_adapter = require("./sqlite.adapter.cjs");
 const require_mock_of = require("./mock-of.cjs");
-const require_redis_adapter = require("./redis.adapter.cjs");
 let node_child_process = require("node:child_process");
 let node_fs = require("node:fs");
 let node_os = require("node:os");
@@ -114,22 +115,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
 		};
 	}
 };
@@ -144,22 +148,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
 		};
 	}
 };
@@ -589,6 +596,7 @@ var SpecificationBuilder = class {
 	mocks = [];
 	projectName = null;
 	request = null;
+	requestHeaders = {};
 	seeds = [];
 	spawnConfig = null;
 	testDir;
@@ -643,6 +651,19 @@ 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;
+	}
+	/**
 	* Send a GET request to the server adapter.
 	*
 	* @example
@@ -763,7 +784,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((0, node_fs.readFileSync)((0, node_path.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: {
@@ -1211,7 +1233,13 @@ var Orchestrator = class {
 		const composePath = findComposeFile(this.root);
 		const composeDir = composePath ? (0, node_path.dirname)(composePath) : this.root;
 		const composeConfig = composePath ? parseComposeFile(composePath) : null;
-		const containerTasks = this.services.map((handle) => {
+		const containerServices = [];
+		const embeddedServices = [];
+		for (const handle of this.services) {
+			if (handle.defaultPort === 0) {
+				embeddedServices.push(handle);
+				continue;
+			}
 			let image = handle.defaultImage;
 			let env = { ...handle.environment };
 			if (handle.composeName && composeConfig) {
@@ -1225,18 +1253,26 @@ var Orchestrator = class {
 					Object.assign(handle.environment, composeService.environment);
 				}
 			}
-			return {
-				container: new TestcontainersAdapter({
-					image,
-					port: handle.defaultPort,
-					env
-				}),
+			const container = new TestcontainersAdapter({
+				image,
+				port: handle.defaultPort,
+				env
+			});
+			containerServices.push({
+				container,
 				handle
-			};
-		});
-		await Promise.all(containerTasks.map(({ container }) => container.start()));
+			});
+		}
+		await Promise.all([...containerServices.map(({ container }) => container.start()), ...embeddedServices.map(async (handle) => {
+			await handle.initialize(composeDir);
+			handle.started = true;
+			this.running.push({
+				handle,
+				container: null
+			});
+		})]);
 		const reports = [];
-		for (const { container, handle } of containerTasks) {
+		for (const { container, handle } of containerServices) {
 			const serviceStartTime = Date.now();
 			try {
 				const host = container.getHost();
@@ -1302,7 +1338,7 @@ var Orchestrator = class {
 		for (const service of composeConfig.infraServices) {
 			const type = detectServiceType(service.image);
 			if (type === "postgres") {
-				const handle = require_redis_adapter.postgres({
+				const handle = require_sqlite_adapter.postgres({
 					compose: service.name,
 					env: service.environment
 				});
@@ -1312,7 +1348,7 @@ var Orchestrator = class {
 				handle.started = true;
 				this.composeHandles.push(handle);
 			} else if (type === "redis") {
-				const handle = require_redis_adapter.redis({ compose: service.name });
+				const handle = require_sqlite_adapter.redis({ compose: service.name });
 				const port = this.composeStack.getMappedPort(service.name, 6379);
 				handle.connectionString = handle.buildConnectionString("localhost", port);
 				handle.started = true;
@@ -1450,7 +1486,12 @@ async function startApp(target, options) {
 	});
 	await orchestrator.start();
 	await acquireIsolation(services);
-	const honoApp = target.factory();
+	const servicesMap = {};
+	for (const svc of services) {
+		const key = svc.composeName ?? svc.type;
+		servicesMap[key] = svc;
+	}
+	const honoApp = target.factory(servicesMap);
 	const database = orchestrator.getDatabase() ?? void 0;
 	const databases = orchestrator.getDatabases();
 	const runner = createSpecificationRunner({
@@ -1526,13 +1567,17 @@ async function startCommand(target, options) {
 //#endregion
 //#region src/runner/targets.ts
 /**
-* Test against an in-process Hono app. Services are started via testcontainers
-* and the app runs without network overhead.
+* Test against an in-process Hono app. The factory receives started services
+* so you can wire connection strings into your app/DI container.
 *
-* @param factory - Function that returns a Hono app instance (called after services start).
+* @param factory - Function that receives services and returns a Hono app instance.
 *
 * @example
-*   await spec(app(() => createApp(db)), { services: [db] });
+*   const db = postgres({ compose: 'db' });
+*   await spec(
+*       app((services) => createApp({ databaseUrl: services.db.connectionString })),
+*       { services: [db] },
+*   );
 */
 function app(factory) {
 	return {
@@ -1677,9 +1722,10 @@ exports.integration = integration;
 exports.mockOf = require_mock_of.mockOf;
 exports.mockOfDate = require_mock_of.mockOfDate;
 exports.normalizeOutput = normalizeOutput;
-exports.postgres = require_redis_adapter.postgres;
-exports.redis = require_redis_adapter.redis;
+exports.postgres = require_sqlite_adapter.postgres;
+exports.redis = require_sqlite_adapter.redis;
 exports.spec = spec;
+exports.sqlite = require_sqlite_adapter.sqlite;
 exports.stack = stack;
 exports.stripAnsi = stripAnsi;