@geekmidas/constructs 10.0.0-alpha.3 → 10.0.0-alpha.30

package/dist/adaptors/testing.cjs

@@ -1,26 +1,34 @@
-const require_chunk = require('../chunk-DWy1uDak.cjs');
-require('../construct-interface-BfjcOD_E.cjs');
-require('../Construct-CyS3RpTL.cjs');
-const require_functions = require('../functions-Bd3TPxid.cjs');
-require('../clone-Dy0cR2SZ.cjs');
-const require_Endpoint = require('../Endpoint-BiaaMEn_.cjs');
-const require_lazyAccessors = require('../lazyAccessors-e3j2oE2m.cjs');
-const require_processAudits = require('../processAudits-CGqttuXm.cjs');
-const require_HonoEndpointAdaptor = require('../HonoEndpointAdaptor-D233Jvpk.cjs');
-const __geekmidas_errors = require_chunk.__toESM(require("@geekmidas/errors"));
-const __geekmidas_envkit = require_chunk.__toESM(require("@geekmidas/envkit"));
-const __geekmidas_services = require_chunk.__toESM(require("@geekmidas/services"));
-const __geekmidas_audit = require_chunk.__toESM(require("@geekmidas/audit"));
-const hono = require_chunk.__toESM(require("hono"));
-const msw = require_chunk.__toESM(require("msw"));
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("../rolldown-runtime-y5ARvAq5.cjs");
+const require_auth = require("../auth.cjs");
+const require_functions = require("../functions-DKN6aQWJ.cjs");
+const require_Endpoint = require("../Endpoint-QKuFg5gs.cjs");
+const require_email = require("../email.cjs");
+const require_database_kysely = require("../database/kysely.cjs");
+const require_lazyAccessors = require("../lazyAccessors-Dx9NLwJZ.cjs");
+const require_Queue = require("../Queue-B7yRXQmL.cjs");
+const require_Topic = require("../Topic-D5rlM9wS.cjs");
+const require_HonoEndpointAdaptor = require("../HonoEndpointAdaptor-DoEQdC3r.cjs");
+const require_processAudits = require("../processAudits-D_2W5x8k.cjs");
+let _geekmidas_manifest = require("@geekmidas/manifest");
+let _geekmidas_errors = require("@geekmidas/errors");
+let _geekmidas_envkit = require("@geekmidas/envkit");
+let _geekmidas_services = require("@geekmidas/services");
+let hono = require("hono");
+let _geekmidas_audit = require("@geekmidas/audit");
+let _geekmidas_testkit_context = require("@geekmidas/testkit/context");
+let msw = require("msw");
+let node_crypto = require("node:crypto");
+let _geekmidas_testkit_browser = require("@geekmidas/testkit/browser");
+let _geekmidas_testkit_mailbox = require("@geekmidas/testkit/mailbox");
+let _geekmidas_testkit_transactions = require("@geekmidas/testkit/transactions");
+let msw_node = require("msw/node");
+let vitest = require("vitest");
+let node_fs = require("node:fs");
+let node_tls = require("node:tls");
+node_tls = require_rolldown_runtime.__toESM(node_tls, 1);
+let node_url = require("node:url");
 //#region src/endpoints/MswEndpointAdaptor.ts
-/**
-* Header used to identify which test context a request belongs to.
-* Each concurrent test registers its own context (services, db transaction, etc.)
-* and the MSW handler looks it up by this header value.
-*/
-const TEST_CONTEXT_HEADER = "x-test-context-id";
 const MSW_HTTP_METHODS = [
 	"get",
 	"post",
@@ -52,8 +60,8 @@ function createMswHandlers(endpoints, options) {
 	* Creates a fresh ServiceDiscovery and pre-registers all provided services.
 	*/
 	function registerContext(id, ctxOptions) {
-		const envParser = new __geekmidas_envkit.EnvironmentParser({});
-		const serviceDiscovery = new __geekmidas_services.ServiceDiscovery(envParser);
+		const envParser = new _geekmidas_envkit.EnvironmentParser({});
+		const serviceDiscovery = new _geekmidas_services.ServiceDiscovery(envParser);
 		const serviceDefs = [];
 		if (ctxOptions.services) for (const [name, instance] of Object.entries(ctxOptions.services)) serviceDefs.push({
 			serviceName: name,
@@ -88,11 +96,11 @@ function createMswHandlers(endpoints, options) {
 		const mswUrl = `${baseURL}${endpoint.route}`;
 		const mswMethod = msw.http[method];
 		handlers.push(mswMethod(mswUrl, async ({ request }) => {
-			const contextId = request.headers.get(TEST_CONTEXT_HEADER);
+			const contextId = request.headers.get(_geekmidas_testkit_context.TEST_CONTEXT_HEADER);
 			const ctx = contextId ? contexts.get(contextId) : void 0;
 			if (!ctx) return new Response(JSON.stringify({
 				error: "Missing or unknown test context ID",
-				hint: `Set the '${TEST_CONTEXT_HEADER}' header to a registered context ID`
+				hint: `Set the '${_geekmidas_testkit_context.TEST_CONTEXT_HEADER}' header to a registered context ID`
 			}), {
 				status: 500,
 				headers: { "content-type": "application/json" }
@@ -112,7 +120,6 @@ function createMswHandlers(endpoints, options) {
 		registerContext
 	};
 }
-
 //#endregion
 //#region src/endpoints/TestEndpointAdaptor.ts
 /**
@@ -132,8 +139,10 @@ function serializeCookie(name, value, options) {
 	return cookieString;
 }
 var TestEndpointAdaptor = class TestEndpointAdaptor {
+	endpoint;
+	serviceDiscovery;
 	static getDefaultServiceDiscover(_endpoint) {
-		return __geekmidas_services.ServiceDiscovery.getInstance(new __geekmidas_envkit.EnvironmentParser({}));
+		return _geekmidas_services.ServiceDiscovery.getInstance(new _geekmidas_envkit.EnvironmentParser({}));
 	}
 	constructor(endpoint, serviceDiscovery = TestEndpointAdaptor.getDefaultServiceDiscover(endpoint)) {
 		this.endpoint = endpoint;
@@ -154,7 +163,7 @@ var TestEndpointAdaptor = class TestEndpointAdaptor {
 			method: this.endpoint.method
 		});
 		const rawDb = ctx.database;
-		return (0, __geekmidas_services.runWithRequestContext)({
+		return (0, _geekmidas_services.runWithRequestContext)({
 			logger,
 			requestId,
 			startTime
@@ -166,7 +175,7 @@ var TestEndpointAdaptor = class TestEndpointAdaptor {
 				cookie,
 				...rawDb !== void 0 && { db: rawDb }
 			});
-			const isAuthorized = await this.endpoint.authorize({
+			if (!await this.endpoint.authorize({
 				header,
 				cookie,
 				services: ctx.services,
@@ -176,10 +185,9 @@ var TestEndpointAdaptor = class TestEndpointAdaptor {
 				body,
 				query,
 				params
-			});
-			if (!isAuthorized) {
+			})) {
 				logger.warn("Forbidden access attempt");
-				throw new __geekmidas_errors.ForbiddenError("Forbidden access to the endpoint", "You do not have permission to access this resource.");
+				throw new _geekmidas_errors.ForbiddenError("Forbidden access to the endpoint", "You do not have permission to access this resource.");
 			}
 			const auditorStorage = ctx.auditorStorage;
 			let auditContext;
@@ -199,24 +207,22 @@ var TestEndpointAdaptor = class TestEndpointAdaptor {
 				} catch (error) {
 					logger.error(error, "Failed to extract actor for audits");
 				}
-				const auditor = new __geekmidas_audit.DefaultAuditor({
-					actor,
-					storage: auditorStorage,
-					metadata: {
-						endpoint: this.endpoint.route,
-						method: this.endpoint.method
-					}
-				});
 				auditContext = {
-					auditor,
+					auditor: new _geekmidas_audit.DefaultAuditor({
+						actor,
+						storage: auditorStorage,
+						metadata: {
+							endpoint: this.endpoint.route,
+							method: this.endpoint.method
+						}
+					}),
 					storage: auditorStorage
 				};
 			}
 			const audits = this.endpoint.audits;
 			if (!auditContext && audits?.length) logger.warn("No auditor storage service available");
-			const result = await require_processAudits.executeWithAuditTransaction(auditContext, async (auditor) => {
-				const trx = auditor?.getTransaction?.();
-				const db = trx ?? rawDb;
+			const { output, metadata } = await require_processAudits.executeWithAuditTransaction(auditContext, async (auditor) => {
+				const db = auditor?.getTransaction?.() ?? rawDb;
 				const responseBuilder = new require_Endpoint.ResponseBuilder();
 				const response = await this.endpoint.handler({
 					body,
@@ -231,36 +237,34 @@ var TestEndpointAdaptor = class TestEndpointAdaptor {
 					db
 				}, responseBuilder);
 				let data = response;
-				let metadata$1 = responseBuilder.getMetadata();
+				let metadata = responseBuilder.getMetadata();
 				if (require_Endpoint.Endpoint.hasMetadata(response)) {
 					data = response.data;
-					metadata$1 = response.metadata;
+					metadata = response.metadata;
 				}
-				const output$1 = await this.endpoint.parseOutput(data);
 				return {
-					output: output$1,
-					metadata: metadata$1,
+					output: await this.endpoint.parseOutput(data),
+					metadata,
 					responseBuilder
 				};
-			}, async (result$1, auditor) => {
+			}, async (result, auditor) => {
 				if (!audits?.length) return;
 				for (const audit of audits) {
-					if (audit.when && !audit.when(result$1.output)) continue;
-					const payload = audit.payload(result$1.output);
-					const entityId = audit.entityId?.(result$1.output);
+					if (audit.when && !audit.when(result.output)) continue;
+					const payload = audit.payload(result.output);
+					const entityId = audit.entityId?.(result.output);
 					auditor.audit(audit.type, payload, {
 						table: audit.table,
 						entityId
 					});
 				}
 			}, { db: rawDb });
-			const { output, metadata } = result;
 			ctx.publisher && await this.serviceDiscovery.register([ctx.publisher]);
 			await require_lazyAccessors.publishConstructEvents(this.endpoint, output, this.serviceDiscovery);
 			const headers = { ...metadata.headers || {} };
 			if (metadata.cookies && metadata.cookies.size > 0) {
 				const setCookieValues = [];
-				for (const [name, cookie$1] of metadata.cookies.entries()) setCookieValues.push(serializeCookie(name, cookie$1.value, cookie$1.options));
+				for (const [name, cookie] of metadata.cookies.entries()) setCookieValues.push(serializeCookie(name, cookie.value, cookie.options));
 				headers["set-cookie"] = setCookieValues;
 			}
 			return {
@@ -271,16 +275,16 @@ var TestEndpointAdaptor = class TestEndpointAdaptor {
 		});
 	}
 	async request(ctx) {
-		const response = await this.fullRequest(ctx);
-		return response.body;
+		return (await this.fullRequest(ctx)).body;
 	}
 };
-
 //#endregion
 //#region src/functions/TestFunctionAdaptor.ts
 var TestFunctionAdaptor = class TestFunctionAdaptor {
+	fn;
+	serviceDiscovery;
 	static getDefaultServiceDiscovery(_fn) {
-		return __geekmidas_services.ServiceDiscovery.getInstance(new __geekmidas_envkit.EnvironmentParser({}));
+		return _geekmidas_services.ServiceDiscovery.getInstance(new _geekmidas_envkit.EnvironmentParser({}));
 	}
 	constructor(fn, serviceDiscovery = TestFunctionAdaptor.getDefaultServiceDiscovery(fn)) {
 		this.fn = fn;
@@ -294,16 +298,12 @@ var TestFunctionAdaptor = class TestFunctionAdaptor {
 		else services = await this.serviceDiscovery.register(this.fn.services);
 		let db;
 		if ("db" in ctx && ctx.db !== void 0) db = ctx.db;
-		else if (this.fn.databaseService) {
-			const dbServices = await this.serviceDiscovery.register([this.fn.databaseService]);
-			db = dbServices[this.fn.databaseService.serviceName];
-		}
+		else if (this.fn.databaseService) db = (await this.serviceDiscovery.register([this.fn.databaseService]))[this.fn.databaseService.serviceName];
 		let auditor;
 		if ("auditor" in ctx && ctx.auditor !== void 0) auditor = ctx.auditor;
 		else if (this.fn.auditorStorageService) {
-			const auditServices = await this.serviceDiscovery.register([this.fn.auditorStorageService]);
-			const storage = auditServices[this.fn.auditorStorageService.serviceName];
-			auditor = new __geekmidas_audit.DefaultAuditor({
+			const storage = (await this.serviceDiscovery.register([this.fn.auditorStorageService]))[this.fn.auditorStorageService.serviceName];
+			auditor = new _geekmidas_audit.DefaultAuditor({
 				actor: {
 					id: "system",
 					type: "system"
@@ -316,11 +316,10 @@ var TestFunctionAdaptor = class TestFunctionAdaptor {
 			});
 		}
 		const requestId = `test-${Date.now()}`;
-		const startTime = Date.now();
-		return (0, __geekmidas_services.runWithRequestContext)({
+		return (0, _geekmidas_services.runWithRequestContext)({
 			logger,
 			requestId,
-			startTime
+			startTime: Date.now()
 		}, async () => {
 			const response = await this.fn.fn({
 				input: parsedInput,
@@ -342,7 +341,6 @@ var TestFunctionAdaptor = class TestFunctionAdaptor {
 		});
 	}
 };
-
 //#endregion
 //#region src/queue/TestQueueAdaptor.ts
 /**
@@ -355,8 +353,10 @@ var TestFunctionAdaptor = class TestFunctionAdaptor {
 * await adapter.invoke({ messages: [{ orderId: '123' }] });
 */
 var TestQueueAdaptor = class TestQueueAdaptor {
+	queue;
+	serviceDiscovery;
 	static getDefaultServiceDiscovery() {
-		return __geekmidas_services.ServiceDiscovery.getInstance(new __geekmidas_envkit.EnvironmentParser({}));
+		return _geekmidas_services.ServiceDiscovery.getInstance(new _geekmidas_envkit.EnvironmentParser({}));
 	}
 	constructor(queue, serviceDiscovery = TestQueueAdaptor.getDefaultServiceDiscovery()) {
 		this.queue = queue;
@@ -366,11 +366,10 @@ var TestQueueAdaptor = class TestQueueAdaptor {
 		const logger = this.queue.logger.child({ test: true });
 		const services = request.services ?? await this.serviceDiscovery.register(this.queue.services);
 		const requestId = `test-${Date.now()}`;
-		const startTime = Date.now();
-		return (0, __geekmidas_services.runWithRequestContext)({
+		return (0, _geekmidas_services.runWithRequestContext)({
 			logger,
 			requestId,
-			startTime
+			startTime: Date.now()
 		}, () => this.queue.handler({
 			messages: request.messages,
 			services,
@@ -378,12 +377,13 @@ var TestQueueAdaptor = class TestQueueAdaptor {
 		}));
 	}
 };
-
 //#endregion
 //#region src/subscribers/TestSubscriberAdaptor.ts
 var TestSubscriberAdaptor = class TestSubscriberAdaptor {
+	subscriber;
+	serviceDiscovery;
 	static getDefaultServiceDiscovery() {
-		return __geekmidas_services.ServiceDiscovery.getInstance(new __geekmidas_envkit.EnvironmentParser({}));
+		return _geekmidas_services.ServiceDiscovery.getInstance(new _geekmidas_envkit.EnvironmentParser({}));
 	}
 	constructor(subscriber, serviceDiscovery = TestSubscriberAdaptor.getDefaultServiceDiscovery()) {
 		this.subscriber = subscriber;
@@ -397,11 +397,10 @@ var TestSubscriberAdaptor = class TestSubscriberAdaptor {
 		const filteredEvents = this.filterEvents(request.events);
 		if (filteredEvents.length === 0) return { batchItemFailures: [] };
 		const requestId = `test-${Date.now()}`;
-		const startTime = Date.now();
-		return (0, __geekmidas_services.runWithRequestContext)({
+		return (0, _geekmidas_services.runWithRequestContext)({
 			logger,
 			requestId,
-			startTime
+			startTime: Date.now()
 		}, async () => {
 			const result = await this.subscriber.handler({
 				events: filteredEvents,
@@ -423,12 +422,327 @@ var TestSubscriberAdaptor = class TestSubscriberAdaptor {
 		return events.filter((event) => this.subscriber.subscribedEvents.includes(event.type));
 	}
 };
-
 //#endregion
-exports.TEST_CONTEXT_HEADER = TEST_CONTEXT_HEADER;
+//#region src/testing/manifest.ts
+/**
+* The test manifest: what `gkm test` knows about an app, written down for the
+* suite it starts.
+*
+* `gkm test` discovers the constructs, reconciles the test stage and resolves
+* its environment — then, until this existed, threw all of it away and left a
+* test to declare it again by hand. The manifest keeps it: which construct and
+* endpoint is exported where, and the environment the test stage resolved,
+* under the keys the constructs themselves derive. A feature test is built from
+* it, so nothing a test says can drift from what the app declares.
+*/
+/** The environment variable `gkm test` names the manifest in. */
+const TEST_MANIFEST_ENV = "GKM_TEST_MANIFEST";
+/**
+* Read a test manifest: from a path, a `file:` URL, or — given nothing — the
+* one `gkm test` named in `GKM_TEST_MANIFEST`.
+*/
+function loadTestManifest(from) {
+	const location = from ?? process.env["GKM_TEST_MANIFEST"];
+	if (!location) throw new NoTestManifest();
+	trustLocalEdge();
+	const path = location instanceof URL || location.startsWith("file:") ? (0, node_url.fileURLToPath)(location) : location;
+	return JSON.parse((0, node_fs.readFileSync)(path, "utf-8"));
+}
+let trusted = false;
+/**
+* Trust the local edge's certificate authority in this thread.
+*
+* `NODE_EXTRA_CA_CERTS` does it for a process started with it — which a
+* suite started by `gkm test` is, and one started by plain `vitest` or an
+* editor is not: its setup only learns the path once Vitest is running, and a
+* worker *thread* shares that process and keeps a TLS store of its own. Every
+* feature test loads the manifest, so this is the one place each worker passes
+* through.
+*/
+function trustLocalEdge() {
+	const certificate = process.env.NODE_EXTRA_CA_CERTS;
+	if (trusted || !certificate || !(0, node_fs.existsSync)(certificate)) return;
+	trusted = true;
+	node_tls.default.setDefaultCACertificates([...node_tls.default.getCACertificates("default"), (0, node_fs.readFileSync)(certificate, "utf-8")]);
+}
+/** A feature test ran without a manifest to build itself from. */
+var NoTestManifest = class extends Error {
+	constructor() {
+		super(`No test manifest: run the suite with \`gkm test\`, or add \`globalSetup: ['@geekmidas/cli/vitest']\` to the root vitest config — either writes one and names it in ${TEST_MANIFEST_ENV}.`);
+		this.name = "NoTestManifest";
+	}
+};
+//#endregion
+//#region src/testing/featureTest.ts
+/**
+* `featureTest`: an app, driven the way it runs deployed.
+*
+* A browser signs in and calls the API; the API calls the auth server; each
+* over its URL, each database in its own transaction. Nothing runs as a server:
+* every URL an app's constructs answer on is served in-process through MSW,
+* from the real handler, for the test that made the request. Everything else
+* with a real local equivalent — Postgres, Mailpit, MinIO — is used directly.
+*
+* It is built from the test manifest `gkm test` writes — the constructs and
+* endpoints the app exports, and the environment the test stage resolved — so
+* a test declares none of it. `gkm test` also generates the configured `it`
+* and a `Browser` with a typed client per surface:
+*
+* ```ts
+* import { it } from '#test';
+*
+* it('shows the signed-in user their profile', async ({ browser, mailbox }) => {
+*   await browser.auth.signIn.magicLink({ email: 'ada@shop.test' });
+*   await browser.visit((await mailbox('ada@shop.test').last()).link!);
+*   expect(await browser.api.get('/profile')).toMatchObject({ email: 'ada@shop.test' });
+* });
+* ```
+*/
+/** Every test in flight in this process, by id. */
+const contexts = /* @__PURE__ */ new Map();
+/** Databases already resolving to test transactions — patched once each. */
+const bound = /* @__PURE__ */ new WeakSet();
+function featureTest(options = {}) {
+	const manifest = options.manifest ?? loadTestManifest();
+	const BrowserClass = options.browser ?? _geekmidas_testkit_browser.Browser;
+	let app;
+	let network;
+	let restoreFetch = () => {};
+	(0, vitest.beforeAll)(async () => {
+		app = await load(manifest, options.database, options.modules ?? {});
+		for (const database of app.databases) bindToTests(database);
+		network = (0, msw_node.setupServer)(...surfaceHandlers(app.endpoints, manifest.env), ...app.auths.map((auth) => authHandler(auth, manifest.env, app.envParser)));
+		network.listen({ onUnhandledRequest(request, print) {
+			if (isLocal(new URL(request.url))) return;
+			print.error();
+		} });
+		restoreFetch = (0, _geekmidas_testkit_context.installContextFetch)();
+	});
+	(0, vitest.afterAll)(() => {
+		restoreFetch();
+		network?.close();
+	});
+	const run = (fn) => async () => {
+		const id = (0, node_crypto.randomUUID)();
+		const state = {
+			transactions: new _geekmidas_testkit_transactions.TransactionRegistry(),
+			discovery: new _geekmidas_services.ServiceDiscovery(app.envParser),
+			surfaces: /* @__PURE__ */ new Map(),
+			auth: /* @__PURE__ */ new Map(),
+			addresses: /* @__PURE__ */ new Set(),
+			published: /* @__PURE__ */ new Map()
+		};
+		contexts.set(id, state);
+		await state.discovery.register(recorders(app.channels, state));
+		try {
+			await (0, _geekmidas_testkit_context.runInTestContext)(id, async () => {
+				const browser = new BrowserClass();
+				const restore = browser.install();
+				try {
+					await fn({
+						browser,
+						db: app.database ? await state.transactions.get(app.database.id, urlOf(app.database, app.envParser), app.database.clientConfig) : void 0,
+						mailbox: (address) => {
+							if (!app.readMail) throw new NoInbox();
+							state.addresses.add(address);
+							return app.readMail(address);
+						},
+						published: (channel) => [...state.published.get(channel.id) ?? []],
+						subscriber: (subscriber) => new TestSubscriberAdaptor(subscriber, state.discovery),
+						queue: (queue) => new TestQueueAdaptor(queue, state.discovery)
+					});
+				} finally {
+					restore();
+				}
+			});
+		} finally {
+			contexts.delete(id);
+			await Promise.all([state.transactions.rollbackAll(), ...[...state.addresses].map((address) => app.readMail?.(address).clear())]);
+		}
+	};
+	const it = ((name, fn, timeout) => (0, vitest.test)(name, run(fn), timeout));
+	it.only = (name, fn, timeout) => vitest.test.only(name, run(fn), timeout);
+	it.skip = (name, fn, timeout) => vitest.test.skip(name, run(fn), timeout);
+	return it;
+}
+/**
+* Import what the manifest points at.
+*
+* The same modules the app runs, so a construct here *is* the app's construct —
+* the one its endpoints were built from — never a copy declared again.
+*/
+async function load(manifest, database, modules) {
+	const envParser = new _geekmidas_envkit.EnvironmentParser({ ...manifest.env });
+	const imported = async ({ file, export: name }) => (modules[file] ?? await import(file))[name];
+	const constructs = await Promise.all(Object.values(manifest.constructs).map(({ source }) => imported(source)));
+	const endpoints = (await Promise.all(manifest.endpoints.map(({ source }) => imported(source)))).filter((value) => require_Endpoint.Endpoint.isEndpoint(value));
+	const unique = (values) => [...new Set(values)];
+	const databases = unique(constructs.filter((value) => value instanceof require_database_kysely.KyselyDatabase));
+	const auths = unique(constructs.filter((value) => value instanceof require_auth.BetterAuth));
+	const emails = unique(constructs.filter((value) => value instanceof require_email.Email));
+	const channels = unique(constructs.filter((value) => value instanceof require_Topic.Topic || value instanceof require_Queue.Queue));
+	const inbox = emails.map((email) => manifest.env[(0, _geekmidas_manifest.provideKey)(email.id, "inboxUrl")]).find(Boolean);
+	return {
+		envParser,
+		endpoints,
+		databases,
+		auths,
+		emails,
+		channels,
+		database: databaseOf(databases, endpoints, database),
+		...inbox ? { readMail: (0, _geekmidas_testkit_mailbox.createMailbox)({ inbox }) } : {}
+	};
+}
+/**
+* A publisher that records rather than sends, under every name a topic or
+* queue is injected by — `users`, and the older `usersPublisher`.
+*/
+function recorders(channels, state) {
+	return channels.flatMap((channel) => {
+		const publisher = { async publish(messages) {
+			state.published.set(channel.id, [...state.published.get(channel.id) ?? [], ...messages.map(({ type, payload }) => ({
+				type,
+				payload
+			}))]);
+		} };
+		return [channel.service.serviceName, channel.publisher.serviceName].map((serviceName) => ({
+			serviceName,
+			register: () => publisher
+		}));
+	});
+}
+/**
+* The database a test sees as `db`: the one named, or else the one the
+* endpoints were given with `.database()` — found by the service they hold,
+* which is the construct's own.
+*/
+function databaseOf(databases, endpoints, named) {
+	if (named) {
+		const found = databases.find(({ id }) => id === named);
+		if (!found) throw new UnknownDatabase(named, databases.map(({ id }) => id));
+		return found;
+	}
+	const services = new Set(endpoints.map((e) => e.databaseService).filter(Boolean));
+	return databases.find((database) => services.has(database.service));
+}
+/**
+* Make a database resolve, inside a test, to that test's transaction.
+*
+* Everything reaches a database through its service — an endpoint through
+* service discovery, the auth server through its tenant directly — so this is
+* the one place a test's connection can be handed over. Outside a test it is
+* the database it always was.
+*/
+function bindToTests(database) {
+	if (bound.has(database)) return;
+	bound.add(database);
+	const service = database.service;
+	const register = service.register;
+	service.register = (options) => {
+		const context = (0, _geekmidas_testkit_context.currentTestContext)();
+		const state = context && contexts.get(context.id);
+		if (!state) return register(options);
+		return state.transactions.get(database.id, urlOf(database, options.envParser), database.clientConfig);
+	};
+}
+function urlOf(database, envParser) {
+	return envParser.create((get) => ({ url: get((0, _geekmidas_manifest.provideKey)(database.id, "url")).string() })).parse().url;
+}
+/** Each surface's endpoints, served at its URL for the test that asked. */
+function surfaceHandlers(endpoints, env) {
+	const bySurface = /* @__PURE__ */ new Map();
+	for (const endpoint of endpoints) {
+		const surface = endpoint.surface?.id;
+		if (!surface) continue;
+		bySurface.set(surface, [...bySurface.get(surface) ?? [], endpoint]);
+	}
+	return [...bySurface].flatMap(([surface, served]) => {
+		const base = env[(0, _geekmidas_manifest.provideKey)(surface, "url")];
+		if (!base) return [];
+		return msw.http.all(`${trim(base)}/*`, ({ request }) => serve(request, async (state) => {
+			let app = state.surfaces.get(surface);
+			if (!app) {
+				app = Promise.resolve().then(() => {
+					const hono$1 = new hono.Hono();
+					require_HonoEndpointAdaptor.HonoEndpoint.addRoutes(served, state.discovery, hono$1);
+					return hono$1;
+				});
+				state.surfaces.set(surface, app);
+			}
+			return (await app).fetch(request);
+		}));
+	});
+}
+/** An auth server, served at its URL, on the transaction of the test that asked. */
+function authHandler(auth, env, envParser) {
+	const base = trim(env[(0, _geekmidas_manifest.provideKey)(auth.id, "url")] ?? "");
+	return msw.http.all(`${base}/*`, ({ request }) => serve(request, async (state) => {
+		let app = state.auth.get(auth);
+		if (!app) {
+			app = auth.server({
+				envParser,
+				context: _geekmidas_services.serviceContext
+			}).then(({ app }) => app);
+			state.auth.set(auth, app);
+		}
+		return (await app).fetch(request);
+	}));
+}
+/** Handle a request as the server side of the test it was made for. */
+async function serve(request, handle) {
+	const id = (0, _geekmidas_testkit_context.testContextOf)(request);
+	const state = id ? contexts.get(id) : void 0;
+	if (!id || !state) throw new UnknownTestContext(request.url, id);
+	return (0, _geekmidas_testkit_context.runAsServer)(id, () => handle(state));
+}
+function trim(url) {
+	return url.replace(/\/$/, "");
+}
+function isLocal(url) {
+	return url.hostname === "localhost" || url.hostname === "127.0.0.1" || url.hostname.endsWith(".localhost");
+}
+/** A request reached an in-process server without a test to belong to. */
+var UnknownTestContext = class extends Error {
+	url;
+	id;
+	constructor(url, id) {
+		super(id ? `${url} was requested for test ${id}, which is not running. A request that outlives its test — an un-awaited call — lands here.` : `${url} was requested outside any test. Make the request inside a featureTest, so it reaches that test's transactions.`);
+		this.url = url;
+		this.id = id;
+		this.name = "UnknownTestContext";
+	}
+};
+/** `mailbox` was used in an app that declares no Email construct. */
+var NoInbox = class extends Error {
+	constructor() {
+		super("mailbox() reads the inbox of the app's Email construct, and none was found in featureTest's modules — or `gkm test` did not inject its <ID>_INBOX_URL.");
+		this.name = "NoInbox";
+	}
+};
+/** `featureTest({ database })` named a database the app does not declare. */
+var UnknownDatabase = class extends Error {
+	id;
+	declared;
+	constructor(id, declared) {
+		super(`featureTest was asked for the database '${id}', and the app declares ${declared.length ? declared.map((d) => `'${d}'`).join(", ") : "none"}.`);
+		this.id = id;
+		this.declared = declared;
+		this.name = "UnknownDatabase";
+	}
+};
+//#endregion
+exports.NoInbox = NoInbox;
+exports.NoTestManifest = NoTestManifest;
+exports.TEST_CONTEXT_HEADER = _geekmidas_testkit_context.TEST_CONTEXT_HEADER;
+exports.TEST_MANIFEST_ENV = TEST_MANIFEST_ENV;
 exports.TestEndpointAdaptor = TestEndpointAdaptor;
 exports.TestFunctionAdaptor = TestFunctionAdaptor;
 exports.TestQueueAdaptor = TestQueueAdaptor;
 exports.TestSubscriberAdaptor = TestSubscriberAdaptor;
+exports.UnknownDatabase = UnknownDatabase;
+exports.UnknownTestContext = UnknownTestContext;
 exports.createMswHandlers = createMswHandlers;
+exports.featureTest = featureTest;
+exports.loadTestManifest = loadTestManifest;
+
 //# sourceMappingURL=testing.cjs.map