@geekmidas/constructs 10.0.0-alpha.21 → 10.0.0-alpha.23

package/dist/adaptors/testing.d.mts

@@ -1,7 +1,7 @@
 import { t as StandardSchemaV1 } from "../index-CeEtxDmK.mjs";
 import { r as Function } from "../index-DU3Twmwh.mjs";
 import { t as HttpMethod } from "../types-DMuSQeLL.mjs";
-import { c as EndpointSchemas, i as Endpoint } from "../Endpoint-BxkRWQ8G.mjs";
+import { c as EndpointSchemas, i as Endpoint } from "../Endpoint-pTZrMs_h.mjs";
 import { t as Queue } from "../Queue-BoUA-e83.mjs";
 import { t as Subscriber } from "../Subscriber-CIO3pwji.mjs";
 import { t as KyselyDatabase } from "../kysely-D3-G5b0j.mjs";
@@ -186,20 +186,77 @@ type TestSubscriberRequest<TEventPublisher extends EventPublisher<any> | undefin
   services?: ServiceRecord<TServices>;
 };
 //#endregion
+//#region src/testing/manifest.d.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.
+ */
+/** Where an export lives: what an import statement has to say. */
+interface TestManifestSource {
+  /** Absolute path to the module. */
+  file: string;
+  /** The name it is exported as. */
+  export: string;
+}
+interface TestManifest {
+  /** The stage the environment was resolved for — `test`. */
+  stage: string;
+  /** Every construct the app declares, by id. */
+  constructs: Record<string, {
+    kind: string;
+    source: TestManifestSource;
+  }>;
+  /** Every endpoint, and the surface that serves it. */
+  endpoints: {
+    surface: string;
+    source: TestManifestSource;
+  }[];
+  /**
+   * The test stage's environment — reconcile's output, keyed as the
+   * constructs derive their keys.
+   */
+  env: Record<string, string>;
+}
+/** The environment variable `gkm test` names the manifest in. */
+export declare 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`.
+ */
+export declare function loadTestManifest(from?: string | URL): TestManifest;
+/** A feature test ran without a manifest to build itself from. */
+export declare class NoTestManifest extends Error {
+  constructor();
+}
+//#endregion
 //#region src/testing/featureTest.d.ts
-interface FeatureTestOptions<TBrowser extends Browser, DB> {
+interface FeatureTestOptions<TBrowser extends Browser> {
+  /**
+   * What the app declares and the environment its test stage resolved.
+   * Defaults to the manifest `gkm test` names in `GKM_TEST_MANIFEST`.
+   */
+  manifest?: TestManifest;
   /**
-   * The modules an app's constructs and endpoints are exported from — what
-   * `import.meta.glob(…, { eager: true })` returns, or a list of modules.
-   * Discovery reads exports, as the build does.
+   * The app's modules, already imported, by the absolute path the manifest
+   * records for them. The generated harness imports them statically, from
+   * inside the app, so they resolve the way the app's own code does — its
+   * tsconfig paths included. A module not here is imported by path.
    */
-  modules: Record<string, unknown> | readonly unknown[];
-  /** The app's own database: what a test receives as `db`. */
-  database?: KyselyDatabase<DB>;
-  /** The browser each test gets — the app's subclass, with its clients. */
+  modules?: Readonly<Record<string, Record<string, unknown>>>;
+  /** The browser each test gets — the generated one, with the app's clients. */
   browser?: new () => TBrowser;
-  /** The environment `gkm test` injected. Defaults to `process.env`. */
-  env?: Record<string, string | undefined>;
+  /**
+   * The database a test receives as `db`, by construct id. Defaults to the
+   * one the app's endpoints name with `.database()`.
+   */
+  database?: string;
 }
 interface FeatureContext<TBrowser extends Browser, DB> {
   /** This test's browser, already the global `fetch`. */
@@ -208,6 +265,31 @@ interface FeatureContext<TBrowser extends Browser, DB> {
   db: Kysely<DB>;
   /** The mail sent to an address during this test, read from Mailpit. */
   mailbox: (address: string) => Mailbox;
+  /**
+   * What this test published to a topic or enqueued on a queue, in order.
+   * Nothing is delivered — a subscriber or a worker is tested on its own, by
+   * handing it events — so this is where publishing is asserted.
+   */
+  published: (channel: {
+    id: string;
+  }) => PublishedMessage[];
+  /**
+   * A subscriber, run on its own — handed events rather than delivered them —
+   * with this test's services: its databases resolve to this test's
+   * transactions, as an endpoint's do.
+   */
+  subscriber: <S extends Subscriber<any, any, any, any, any, any>>(subscriber: S) => SubscriberAdaptorOf<S>;
+  /** A queue's worker, run on its own with this test's services. */
+  queue: <Q extends Queue<any, any, any, any>>(queue: Q) => QueueAdaptorOf<Q>;
+}
+type SubscriberAdaptorOf<S> = S extends Subscriber<infer TServices, infer TLogger, infer OutSchema, infer TEventPublisher, infer TEventPublisherServiceName, infer TSubscribedEvents> ? TestSubscriberAdaptor<TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents> : never;
+type QueueAdaptorOf<Q> = Q extends Queue<infer TName, infer TMessage, infer TServices, infer TLogger> ? TestQueueAdaptor<TName, TMessage, TServices, TLogger> : never;
+/** The schema a database construct was declared with — what `db` is typed by. */
+type DatabaseOf<C> = C extends KyselyDatabase<infer DB, any> ? DB : unknown;
+/** One message as it was published: its type and its payload. */
+interface PublishedMessage {
+  type: string;
+  payload: unknown;
 }
 type FeatureFn<TBrowser extends Browser, DB> = (context: FeatureContext<TBrowser, DB>) => unknown;
 interface FeatureIt<TBrowser extends Browser, DB> {
@@ -215,7 +297,7 @@ interface FeatureIt<TBrowser extends Browser, DB> {
   only(name: string, fn: FeatureFn<TBrowser, DB>, timeout?: number): void;
   skip(name: string, fn: FeatureFn<TBrowser, DB>, timeout?: number): void;
 }
-export declare function featureTest<TBrowser extends Browser = Browser, DB = unknown>(options: FeatureTestOptions<TBrowser, DB>): FeatureIt<TBrowser, DB>;
+export declare function featureTest<TBrowser extends Browser = Browser, DB = unknown>(options?: FeatureTestOptions<TBrowser>): FeatureIt<TBrowser, DB>;
 /** A request reached an in-process server without a test to belong to. */
 export declare class UnknownTestContext extends Error {
   readonly url: string;
@@ -226,6 +308,12 @@ export declare class UnknownTestContext extends Error {
 export declare class NoInbox extends Error {
   constructor();
 }
+/** `featureTest({ database })` named a database the app does not declare. */
+export declare class UnknownDatabase extends Error {
+  readonly id: string;
+  readonly declared: string[];
+  constructor(id: string, declared: string[]);
+}
 //#endregion
-export { type CreateMswHandlersOptions, type CreateMswHandlersResult, type FeatureContext, type FeatureIt, type FeatureTestOptions, type RegisterContextOptions, TEST_CONTEXT_HEADER };
+export { type CreateMswHandlersOptions, type CreateMswHandlersResult, type DatabaseOf, type FeatureContext, type FeatureIt, type FeatureTestOptions, type RegisterContextOptions, TEST_CONTEXT_HEADER, type TestManifest, type TestManifestSource };
 //# sourceMappingURL=testing.d.mts.map

package/dist/adaptors/testing.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.mts","names":["TestBrowser"],"sources":["../../src/endpoints/MswEndpointAdaptor.ts","../../src/endpoints/TestEndpointAdaptor.ts","../../src/functions/TestFunctionAdaptor.ts","../../src/queue/TestQueueAdaptor.ts","../../src/subscribers/TestSubscriberAdaptor.ts","../../src/testing/featureTest.ts"],"mappings":"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"}
+{"version":3,"file":"testing.d.mts","names":["TestBrowser"],"sources":["../../src/endpoints/MswEndpointAdaptor.ts","../../src/endpoints/TestEndpointAdaptor.ts","../../src/functions/TestFunctionAdaptor.ts","../../src/queue/TestQueueAdaptor.ts","../../src/subscribers/TestSubscriberAdaptor.ts","../../src/testing/manifest.ts","../../src/testing/featureTest.ts"],"mappings":"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"}

package/dist/adaptors/testing.mjs

@@ -4,6 +4,8 @@ import { n as ResponseBuilder, t as Endpoint } from "../Endpoint-DCr5tlbJ.mjs";
 import { Email } from "../email.mjs";
 import { KyselyDatabase } from "../database/kysely.mjs";
 import { c as createObjectHeaders, l as publishConstructEvents, r as createCookieHeaderAccessor, u as publishEvents } from "../lazyAccessors-BHtcqgz2.mjs";
+import { t as Queue } from "../Queue-Dfumm1WR.mjs";
+import { t as Topic } from "../Topic-QqnO_6Dl.mjs";
 import { t as HonoEndpoint } from "../HonoEndpointAdaptor-Be6UdK0r.mjs";
 import { n as executeWithAuditTransaction } from "../processAudits-BpRlPQMW.mjs";
 import { provideKey } from "@geekmidas/manifest";
@@ -20,6 +22,8 @@ import { createMailbox } from "@geekmidas/testkit/mailbox";
 import { TransactionRegistry } from "@geekmidas/testkit/transactions";
 import { setupServer } from "msw/node";
 import { afterAll, beforeAll, test } from "vitest";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 //#region src/endpoints/MswEndpointAdaptor.ts
 const MSW_HTTP_METHODS = [
 	"get",
@@ -415,6 +419,38 @@ var TestSubscriberAdaptor = class TestSubscriberAdaptor {
 	}
 };
 //#endregion
+//#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();
+	const path = location instanceof URL || location.startsWith("file:") ? fileURLToPath(location) : location;
+	return JSON.parse(readFileSync(path, "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\`, which 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.
@@ -425,15 +461,14 @@ var TestSubscriberAdaptor = class TestSubscriberAdaptor {
 * 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
-* // test/config.ts
-* export const it = featureTest({
-*   modules: import.meta.glob(['../../constructs/*.ts', '../src/endpoints/**\/*.ts'], { eager: true }),
-*   database,
-*   browser: Browser,
-* });
+* import { it } from '#test';
 *
-* // a 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!);
@@ -445,17 +480,16 @@ var TestSubscriberAdaptor = class TestSubscriberAdaptor {
 const contexts = /* @__PURE__ */ new Map();
 /** Databases already resolving to test transactions — patched once each. */
 const bound = /* @__PURE__ */ new WeakSet();
-function featureTest(options) {
-	const env = options.env ?? process.env;
-	const envParser = new EnvironmentParser({ ...env });
-	const found = discover(options.modules);
+function featureTest(options = {}) {
+	const manifest = options.manifest ?? loadTestManifest();
 	const BrowserClass = options.browser ?? Browser;
-	for (const database of found.databases) bindToTests(database);
-	const network = setupServer(...surfaceHandlers(found.endpoints, env), ...found.auths.map((auth) => authHandler(auth, env, envParser)));
-	const inbox = found.emails.map((email) => env[provideKey(email.id, "inboxUrl")]).find(Boolean);
-	const readMail = inbox ? createMailbox({ inbox }) : void 0;
+	let app;
+	let network;
 	let restoreFetch = () => {};
-	beforeAll(() => {
+	beforeAll(async () => {
+		app = await load(manifest, options.database, options.modules ?? {});
+		for (const database of app.databases) bindToTests(database);
+		network = 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();
@@ -464,18 +498,20 @@ function featureTest(options) {
 	});
 	afterAll(() => {
 		restoreFetch();
-		network.close();
+		network?.close();
 	});
 	const run = (fn) => async () => {
 		const id = randomUUID();
 		const state = {
 			transactions: new TransactionRegistry(),
-			discovery: new ServiceDiscovery(envParser),
+			discovery: new ServiceDiscovery(app.envParser),
 			surfaces: /* @__PURE__ */ new Map(),
 			auth: /* @__PURE__ */ new Map(),
-			addresses: /* @__PURE__ */ new Set()
+			addresses: /* @__PURE__ */ new Set(),
+			published: /* @__PURE__ */ new Map()
 		};
 		contexts.set(id, state);
+		await state.discovery.register(recorders(app.channels, state));
 		try {
 			await runInTestContext(id, async () => {
 				const browser = new BrowserClass();
@@ -483,12 +519,15 @@ function featureTest(options) {
 				try {
 					await fn({
 						browser,
-						db: options.database ? await state.transactions.get(options.database.id, urlOf(options.database, envParser)) : void 0,
+						db: app.database ? await state.transactions.get(app.database.id, urlOf(app.database, app.envParser)) : void 0,
 						mailbox: (address) => {
-							if (!readMail) throw new NoInbox();
+							if (!app.readMail) throw new NoInbox();
 							state.addresses.add(address);
-							return readMail(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();
@@ -496,7 +535,7 @@ function featureTest(options) {
 			});
 		} finally {
 			contexts.delete(id);
-			await Promise.all([state.transactions.rollbackAll(), ...[...state.addresses].map((address) => readMail?.(address).clear())]);
+			await Promise.all([state.transactions.rollbackAll(), ...[...state.addresses].map((address) => app.readMail?.(address).clear())]);
 		}
 	};
 	const it = ((name, fn, timeout) => test(name, run(fn), timeout));
@@ -504,17 +543,67 @@ function featureTest(options) {
 	it.skip = (name, fn, timeout) => test.skip(name, run(fn), timeout);
 	return it;
 }
-/** What an app's modules export, sorted by what a test does with it. */
-function discover(modules) {
-	const values = (Array.isArray(modules) ? modules : Object.values(modules)).flatMap((module) => module && typeof module === "object" ? Object.values(module) : []);
+/**
+* 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 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) => Endpoint.isEndpoint(value));
+	const unique = (values) => [...new Set(values)];
+	const databases = unique(constructs.filter((value) => value instanceof KyselyDatabase));
+	const auths = unique(constructs.filter((value) => value instanceof BetterAuth));
+	const emails = unique(constructs.filter((value) => value instanceof Email));
+	const channels = unique(constructs.filter((value) => value instanceof Topic || value instanceof Queue));
+	const inbox = emails.map((email) => manifest.env[provideKey(email.id, "inboxUrl")]).find(Boolean);
 	return {
-		endpoints: values.filter((value) => Endpoint.isEndpoint(value)),
-		databases: values.filter((value) => value instanceof KyselyDatabase),
-		auths: values.filter((value) => value instanceof BetterAuth),
-		emails: values.filter((value) => value instanceof Email)
+		envParser,
+		endpoints,
+		databases,
+		auths,
+		emails,
+		channels,
+		database: databaseOf(databases, endpoints, database),
+		...inbox ? { readMail: 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
@@ -565,7 +654,7 @@ function surfaceHandlers(endpoints, env) {
 /** An auth server, served at its URL, on the transaction of the test that asked. */
 function authHandler(auth, env, envParser) {
 	const base = trim(env[provideKey(auth.id, "url")] ?? "");
-	return http.all(`${base}${auth.basePath}/*`, ({ request }) => serve(request, async (state) => {
+	return http.all(`${base}/*`, ({ request }) => serve(request, async (state) => {
 		let app = state.auth.get(auth);
 		if (!app) {
 			app = auth.server({
@@ -608,7 +697,18 @@ var NoInbox = class extends Error {
 		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
-export { NoInbox, TEST_CONTEXT_HEADER, TestEndpointAdaptor, TestFunctionAdaptor, TestQueueAdaptor, TestSubscriberAdaptor, UnknownTestContext, createMswHandlers, featureTest };
+export { NoInbox, NoTestManifest, TEST_CONTEXT_HEADER, TEST_MANIFEST_ENV, TestEndpointAdaptor, TestFunctionAdaptor, TestQueueAdaptor, TestSubscriberAdaptor, UnknownDatabase, UnknownTestContext, createMswHandlers, featureTest, loadTestManifest };
 
 //# sourceMappingURL=testing.mjs.map