@geekmidas/constructs 10.0.0-alpha.4 → 10.0.0-alpha.40

package/dist/adaptors/testing.d.mts

@@ -1,30 +1,23 @@
-import "../Construct-Ct8nalEi.mjs";
-import { Function } from "../index-CubPzHd9.mjs";
-import "../construct-interface-g5GM5pwR.mjs";
-import { HttpMethod } from "../types-aKksMEWL.mjs";
-import { Endpoint, EndpointSchemas } from "../Endpoint-2Wg7T7Cq.mjs";
-import { Queue } from "../Queue-gVGfi2Yk.mjs";
-import { Subscriber } from "../Subscriber-xTJ9ayPN.mjs";
+import { t as StandardSchemaV1 } from "../index-CeEtxDmK.mjs";
+import { r as Function } from "../index-CjVEjOw0.mjs";
+import { t as HttpMethod } from "../types-DMuSQeLL.mjs";
+import { c as EndpointSchemas, i as Endpoint } from "../Endpoint-DtI7heFm.mjs";
+import { t as Queue } from "../Queue-YmvN2vEP.mjs";
+import { t as Subscriber } from "../Subscriber-BjHYe5hK.mjs";
+import { t as KyselyDatabase } from "../kysely-BJ8IQ_1P.mjs";
+import { r as Fake } from "../external-api-DS3mujT5.mjs";
+import { EventPublisher, ExtractPublisherMessage } from "@geekmidas/events";
+import { Kysely } from "kysely";
 import { Service, ServiceDiscovery, ServiceRecord } from "@geekmidas/services";
 import { AuditStorage, AuditableAction, Auditor } from "@geekmidas/audit";
+import { TEST_CONTEXT_HEADER } from "@geekmidas/testkit/context";
 import { HttpHandler } from "msw";
-import { EventPublisher, ExtractPublisherMessage } from "@geekmidas/events";
+import { Browser } from "@geekmidas/testkit/browser";
+import { FakerFactory } from "@geekmidas/testkit/faker";
+import { Mailbox } from "@geekmidas/testkit/mailbox";
 import { Logger } from "@geekmidas/logger";
 import { ComposableStandardSchema, InferComposableStandardSchema, InferStandardSchema } from "@geekmidas/schema";
-import { StandardSchemaV1 } from "@standard-schema/spec";
-
 //#region src/endpoints/MswEndpointAdaptor.d.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.
- */
-declare const TEST_CONTEXT_HEADER = "x-test-context-id";
-/**
- * Per-test context containing an isolated ServiceDiscovery instance.
- * Registered in the context map and looked up per-request via the context ID header.
- */
-
 /**
  * Options for creating MSW handlers from endpoint constructs.
  *
@@ -65,16 +58,16 @@ interface CreateMswHandlersOptions {
 }
 /**
  * Options for registering a per-test context.
- * Follows the same pattern as TestRequestAdaptor — services, database,
- * publisher, and auditorStorage are provided explicitly.
+ * Follows the same pattern as TestRequestAdaptor — services, database and
+ * auditorStorage are provided explicitly. A topic is a service under its own
+ * name, so a recorder in `services` (`{ users: recorder }`) captures what an
+ * endpoint publishes to it.
  */
 interface RegisterContextOptions {
   /** Service instances keyed by serviceName */
   services?: Record<string, unknown>;
   /** Database instance — required when endpoints use .database() */
   database?: unknown;
-  /** Event publisher service definition */
-  publisher?: Service;
   /** Audit storage instance — required when endpoints use .auditor() */
   auditorStorage?: unknown;
 }
@@ -102,8 +95,7 @@ interface CreateMswHandlersResult {
  * @param options - Configuration including baseURL
  * @returns MSW handlers, the Hono app, and context management functions
  */
-declare function createMswHandlers(endpoints: Endpoint<any, any, any, any, any, any>[], options: CreateMswHandlersOptions): CreateMswHandlersResult;
-//# sourceMappingURL=MswEndpointAdaptor.d.ts.map
+export declare function createMswHandlers(endpoints: Endpoint<any, any, any, any, any, any>[], options: CreateMswHandlersOptions): CreateMswHandlersResult;
 //#endregion
 //#region src/endpoints/TestEndpointAdaptor.d.ts
 type TestHttpResponse<TBody = any> = {
@@ -111,13 +103,13 @@ type TestHttpResponse<TBody = any> = {
   status: number;
   headers: Record<string, string | string[]>;
 };
-declare class TestEndpointAdaptor<TRoute extends string, TMethod extends HttpMethod, TInput extends EndpointSchemas = {}, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TSession = unknown, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>, TDatabase = undefined, TDatabaseServiceName extends string = string> {
+export declare class TestEndpointAdaptor<TRoute extends string, TMethod extends HttpMethod, TInput extends EndpointSchemas = {}, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TSession = unknown, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>, TDatabase = undefined, TDatabaseServiceName extends string = string> {
   private readonly endpoint;
   private serviceDiscovery;
-  static getDefaultServiceDiscover<TRoute extends string, TMethod extends HttpMethod, TInput extends EndpointSchemas = {}, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TSession = unknown, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>, TDatabase = undefined, TDatabaseServiceName extends string = string>(_endpoint: Endpoint<TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TAuditAction, TDatabase, TDatabaseServiceName>): ServiceDiscovery<any>;
-  constructor(endpoint: Endpoint<TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TAuditAction, TDatabase, TDatabaseServiceName>, serviceDiscovery?: ServiceDiscovery<any>);
-  fullRequest(ctx: TestRequestAdaptor<TInput, TServices, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName>): Promise<TestHttpResponse<InferStandardSchema<TOutSchema>>>;
-  request(ctx: TestRequestAdaptor<TInput, TServices, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName>): Promise<InferStandardSchema<TOutSchema>>;
+  static getDefaultServiceDiscover<TRoute extends string, TMethod extends HttpMethod, TInput extends EndpointSchemas = {}, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TSession = unknown, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>, TDatabase = undefined, TDatabaseServiceName extends string = string>(_endpoint: Endpoint<TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession, TAuditStorage, TAuditStorageServiceName, TAuditAction, TDatabase, TDatabaseServiceName>): any;
+  constructor(endpoint: Endpoint<TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession, TAuditStorage, TAuditStorageServiceName, TAuditAction, TDatabase, TDatabaseServiceName>, serviceDiscovery?: ServiceDiscovery<any>);
+  fullRequest(ctx: TestRequestAdaptor<TInput, TServices, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName>): Promise<TestHttpResponse<InferStandardSchema<TOutSchema>>>;
+  request(ctx: TestRequestAdaptor<TInput, TServices, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName>): Promise<InferStandardSchema<TOutSchema>>;
 }
 /**
  * Conditional audit storage requirement - required when TAuditStorage is configured
@@ -133,30 +125,27 @@ type DatabaseRequirement<TDatabase = undefined> = TDatabase extends undefined ?
   /** Database instance - required when endpoint uses .database() */
   database: TDatabase;
 };
-type TestRequestAdaptor<TInput extends EndpointSchemas = {}, TServices extends Service[] = [], TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TAuditStorage extends AuditStorage | undefined = undefined, _TAuditStorageServiceName extends string = string, TDatabase = undefined, _TDatabaseServiceName extends string = string> = {
+type TestRequestAdaptor<TInput extends EndpointSchemas = {}, TServices extends Service[] = [], TAuditStorage extends AuditStorage | undefined = undefined, _TAuditStorageServiceName extends string = string, TDatabase = undefined, _TDatabaseServiceName extends string = string> = {
   services: ServiceRecord<TServices>;
   headers: Record<string, string>;
-  publisher?: Service<TEventPublisherServiceName, TEventPublisher>;
 } & InferComposableStandardSchema<TInput> & AuditStorageRequirement<TAuditStorage> & DatabaseRequirement<TDatabase>;
 //#endregion
 //#region src/functions/TestFunctionAdaptor.d.ts
-declare class TestFunctionAdaptor<TInput extends ComposableStandardSchema | undefined = undefined, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> {
+export declare class TestFunctionAdaptor<TInput extends ComposableStandardSchema | undefined = undefined, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> {
   private readonly fn;
   private serviceDiscovery;
-  static getDefaultServiceDiscovery<TInput extends ComposableStandardSchema | undefined = undefined, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>>(_fn: Function<TInput, TServices, TLogger, TOutSchema, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction, any>): ServiceDiscovery<any>;
-  constructor(fn: Function<TInput, TServices, TLogger, TOutSchema, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction, any>, serviceDiscovery?: ServiceDiscovery<any>);
-  invoke(ctx: TestFunctionRequest<TInput, TServices, TEventPublisher, TEventPublisherServiceName, TDatabase, TAuditAction>): Promise<InferStandardSchema<TOutSchema>>;
+  static getDefaultServiceDiscovery<TInput extends ComposableStandardSchema | undefined = undefined, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>>(_fn: Function<TInput, TServices, TLogger, TOutSchema, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction, any>): any;
+  constructor(fn: Function<TInput, TServices, TLogger, TOutSchema, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction, any>, serviceDiscovery?: ServiceDiscovery<any>);
+  invoke(ctx: TestFunctionRequest<TInput, TServices, TDatabase, TAuditAction>): Promise<InferStandardSchema<TOutSchema>>;
 }
-type TestFunctionRequest<TInput extends ComposableStandardSchema | undefined = undefined, TServices extends Service[] = [], TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TDatabase = undefined, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> = {
+type TestFunctionRequest<TInput extends ComposableStandardSchema | undefined = undefined, TServices extends Service[] = [], TDatabase = undefined, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> = {
   input: InferComposableStandardSchema<TInput>;
   services: ServiceRecord<TServices>;
-  publisher?: Service<TEventPublisherServiceName, TEventPublisher>;
   db?: TDatabase;
   auditor?: Auditor<TAuditAction>;
 } & InferComposableStandardSchema<{
   input: TInput;
 }>;
-//# sourceMappingURL=TestFunctionAdaptor.d.ts.map
 //#endregion
 //#region src/queue/TestQueueAdaptor.d.ts
 /**
@@ -168,10 +157,10 @@ type TestFunctionRequest<TInput extends ComposableStandardSchema | undefined = u
  * const adapter = new TestQueueAdaptor(ordersQueue);
  * await adapter.invoke({ messages: [{ orderId: '123' }] });
  */
-declare class TestQueueAdaptor<TName extends string = string, TMessage extends StandardSchemaV1 = StandardSchemaV1, TServices extends Service[] = [], TLogger extends Logger = Logger> {
+export declare class TestQueueAdaptor<TName extends string = string, TMessage extends StandardSchemaV1 = StandardSchemaV1, TServices extends Service[] = [], TLogger extends Logger = Logger> {
   private readonly queue;
   private serviceDiscovery;
-  static getDefaultServiceDiscovery(): ServiceDiscovery<any>;
+  static getDefaultServiceDiscovery(): any;
   constructor(queue: Queue<TName, TMessage, TServices, TLogger>, serviceDiscovery?: ServiceDiscovery<any>);
   invoke(request: TestQueueRequest<TMessage, TServices>): Promise<unknown>;
 }
@@ -179,17 +168,16 @@ type TestQueueRequest<TMessage extends StandardSchemaV1 = StandardSchemaV1, TSer
   messages: InferStandardSchema<TMessage>[];
   services?: ServiceRecord<TServices>;
 };
-//# sourceMappingURL=TestQueueAdaptor.d.ts.map
 //#endregion
 //#region src/subscribers/TestSubscriberAdaptor.d.ts
 type ExtractEventPayloads<TPublisher extends EventPublisher<any> | undefined, TEventTypes extends any[]> = TPublisher extends EventPublisher<any> ? Extract<ExtractPublisherMessage<TPublisher>, {
   type: TEventTypes[number];
 }> : never;
-declare class TestSubscriberAdaptor<TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TSubscribedEvents extends ExtractPublisherMessage<TEventPublisher>['type'][] = ExtractPublisherMessage<TEventPublisher>['type'][]> {
+export declare class TestSubscriberAdaptor<TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TEventPublisher extends EventPublisher<any> | undefined = undefined, TSubscribedEvents extends ExtractPublisherMessage<TEventPublisher>['type'][] = ExtractPublisherMessage<TEventPublisher>['type'][]> {
   private readonly subscriber;
   private serviceDiscovery;
-  static getDefaultServiceDiscovery(): ServiceDiscovery<any>;
-  constructor(subscriber: Subscriber<TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>, serviceDiscovery?: ServiceDiscovery<any>);
+  static getDefaultServiceDiscovery(): any;
+  constructor(subscriber: Subscriber<TServices, TLogger, OutSchema, TEventPublisher, TSubscribedEvents>, serviceDiscovery?: ServiceDiscovery<any>);
   invoke(request: TestSubscriberRequest<TEventPublisher, TSubscribedEvents, TServices>): Promise<InferStandardSchema<OutSchema>>;
   private filterEvents;
 }
@@ -198,5 +186,219 @@ type TestSubscriberRequest<TEventPublisher extends EventPublisher<any> | undefin
   services?: ServiceRecord<TServices>;
 };
 //#endregion
-export { CreateMswHandlersOptions, CreateMswHandlersResult, RegisterContextOptions, TEST_CONTEXT_HEADER, TestEndpointAdaptor, TestFunctionAdaptor, TestQueueAdaptor, TestSubscriberAdaptor, createMswHandlers };
+//#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
+/** How each database's test factory is built, keyed by its service name. */
+type FactoryBuilders = Record<string, (db: Kysely<any>) => unknown>;
+interface FeatureTestOptions<TBrowser extends Browser, TFactories extends FactoryBuilders = {}> {
+  /**
+   * 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 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?: Readonly<Record<string, Record<string, unknown>>>;
+  /** The browser each test gets — the generated one, with the app's clients. */
+  browser?: new () => TBrowser;
+  /**
+   * Each database's test factory — `createFactory` from
+   * `test/factories/<construct>.ts`, which the generated harness imports —
+   * keyed by the database's service name. Each is called once per test with
+   * that database's transaction, so what a test inserts through it is rolled
+   * back with everything else, and seen by the endpoints it calls.
+   */
+  factories?: TFactories;
+  /**
+   * Each external API's fake — the default export of `test/fakes/<id>.ts`,
+   * which the generated harness imports — keyed by the API's construct id.
+   * An app fake is served at the URL the test stage resolved for it.
+   */
+  fakes?: Readonly<Record<string, Fake>>;
+}
+/** Each database's schema, keyed by its service name. */
+type DatabaseSchemas = Record<string, unknown>;
+/**
+ * The app's databases for this test, by service name — `db.get('database')`.
+ *
+ * Each is this test's transaction on that database: opened by whatever reaches
+ * it first — the test, a factory, an endpoint — and the same one for all of
+ * them, rolled back after the test.
+ */
+interface TestDatabases<TDatabases extends DatabaseSchemas> {
+  get<K extends keyof TDatabases & string>(name: K): Promise<Kysely<TDatabases[K]>>;
+}
+/**
+ * Each of the app's databases' test factory, by service name —
+ * `await factories.get('database')`. Built on first use, on that database's
+ * transaction for this test — the one `db.get` returns — and the same factory
+ * for the rest of the test.
+ */
+interface TestFactories<TFactories extends FactoryBuilders> {
+  get<K extends keyof TFactories & string>(name: K): Promise<ReturnType<TFactories[K]>>;
+}
+interface FeatureContext<TBrowser extends Browser, TDatabases extends DatabaseSchemas = {}, TFactories extends FactoryBuilders = {}> {
+  /** This test's browser, already the global `fetch`. */
+  browser: TBrowser;
+  /**
+   * The app's own databases — not a tenant an auth server owns, not a
+   * reader — by service name: `await db.get('database')`. The same
+   * transaction the test's endpoints and factories use.
+   */
+  db: TestDatabases<TDatabases>;
+  /**
+   * Each of the app's databases' test factory, by service name —
+   * `await factories.get('database')` — on the same transaction `db.get`
+   * returns.
+   */
+  factories: TestFactories<TFactories>;
+  /**
+   * Testkit's faker — the one factories are handed — seeded from this test's
+   * name, so a failing test fails again with the same data, and so a test
+   * imports nothing to make some.
+   */
+  faker: FakerFactory;
+  /** 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>>(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 TSubscribedEvents> ? TestSubscriberAdaptor<TServices, TLogger, OutSchema, TEventPublisher, 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, TDatabases extends DatabaseSchemas, TFactories extends FactoryBuilders> = (context: FeatureContext<TBrowser, TDatabases, TFactories>) => unknown;
+interface FeatureIt<TBrowser extends Browser, TDatabases extends DatabaseSchemas = {}, TFactories extends FactoryBuilders = {}> {
+  (name: string, fn: FeatureFn<TBrowser, TDatabases, TFactories>, timeout?: number): void;
+  only(name: string, fn: FeatureFn<TBrowser, TDatabases, TFactories>, timeout?: number): void;
+  skip(name: string, fn: FeatureFn<TBrowser, TDatabases, TFactories>, timeout?: number): void;
+}
+export declare function featureTest<TBrowser extends Browser = Browser, TDatabases extends DatabaseSchemas = {}, TFactories extends FactoryBuilders = {}>(options?: FeatureTestOptions<TBrowser, TFactories>): FeatureIt<TBrowser, TDatabases, TFactories>;
+/** What `signInWithMagicLink` uses of a better-auth client. */
+interface MagicLinkAuthClient<TSession> {
+  signIn: {
+    magicLink(input: {
+      email: string;
+    }): Promise<{
+      error?: {
+        message?: string;
+      } | null;
+    }>;
+  };
+  getSession(): Promise<{
+    data: TSession | null;
+  }>;
+}
+/**
+ * Sign a test's browser in the way a person does: ask the auth server for a
+ * magic link, open the email it sent, follow the link.
+ *
+ * What the generated `browser.signIn(email)` calls. The address's mail is
+ * cleared first — so the link is this request's, not one an earlier test left
+ * — and cleared again after the test, like any address a test reads. Returns
+ * the session the auth server then reports, as better-auth hands it back.
+ */
+export declare function signInWithMagicLink<TSession>(browser: Browser, auth: MagicLinkAuthClient<TSession>, email?: string): Promise<TSession>;
+/** `browser.signIn` finished without a session. */
+export declare class SignInFailed extends Error {
+  readonly email: string;
+  readonly reason: string;
+  constructor(email: string, reason: string);
+}
+/** A request reached an in-process server without a test to belong to. */
+export declare class UnknownTestContext extends Error {
+  readonly url: string;
+  readonly id: string | undefined;
+  constructor(url: string, id: string | undefined);
+}
+/** `mailbox` was used in an app that declares no Email construct. */
+export declare class NoInbox extends Error {
+  constructor();
+}
+/** `db.get(name)` named no database the test is handed. */
+export declare class UnknownDatabase extends Error {
+  readonly database: string;
+  readonly known: readonly string[];
+  constructor(database: string, known: readonly string[]);
+}
+/** A factory keyed by a service name no database the app declares has. */
+export declare class UnknownFactory extends Error {
+  readonly factory: string;
+  readonly known: readonly string[];
+  constructor(factory: string, known: readonly string[]);
+}
+//#endregion
+export { type CreateMswHandlersOptions, type CreateMswHandlersResult, type DatabaseOf, type DatabaseSchemas, type FactoryBuilders, type FeatureContext, type FeatureIt, type FeatureTestOptions, type MagicLinkAuthClient, type RegisterContextOptions, TEST_CONTEXT_HEADER, type TestDatabases, type TestFactories, 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":[],"sources":["../../src/endpoints/MswEndpointAdaptor.ts","../../src/endpoints/TestEndpointAdaptor.ts","../../src/functions/TestFunctionAdaptor.ts","../../src/queue/TestQueueAdaptor.ts","../../src/subscribers/TestSubscriberAdaptor.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;cAaa,mBAAA;;;;;;AA4Cb;AAUA;;;;AAMoB;AAmBpB;;;;AAI8D;AAkB9D;;;;;AAG0B;;;;AC9E1B;;;;AAGgB;AAwChB;;;;;;;;;AAUuB,UDnCN,wBAAA,CCmCM;EAAY;EAEE,OAAoB,EAAA,MAAA;;;;;;;AAe/B,UD1CT,sBAAA,CC0CS;EAAc;EAEJ,QAEb,CAAA,ED5CX,MC4CW,CAAA,MAAA,EAAA,OAAA,CAAA;EAAe;EAAmC,QAQtE,CAAA,EAAA,OAAA;EAAM;EACC,SACP,CAAA,EDlDU,OCkDV;EAAM;EACI,cACV,CAAA,EAAA,OAAA;;;;;AAKA,UDtCc,uBAAA,CCsCd;EAAa;EACW,QACxB,EDtCQ,WCsCR,EAAA;EAAY;EACH,eACT,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,OAAA,EDtCqC,sBCsCrC,EAAA,GAAA,IAAA;;;;;;;;;;;;;;;;;AAM0B,iBD1Bb,iBAAA,CC0Ba,SAAA,EDzBjB,QCyBiB,CAAA,GAAA,EAAA,GAAA,EAAA,GAAA,EAAA,GAAA,EAAA,GAAA,EAAA,GAAA,CAAA,EAAA,EAAA,OAAA,EDxBnB,wBCwBmB,CAAA,EDvB1B,uBCuB0B;;;;KArGjB;QACL;;WAEG;;cAwCG,2DAEI,2BACD,yCACI,4DACD,gCACF,SAAS,oDAED,uHAEF,6GAED,mCAAmC;;;EDjF5C,OAAA,yBAAmB,CAAA,eAAA,MAAA,EAAA,gBC0Fd,UD1Fc,EAAA,eC2Ff,eD3Fe,GAAA,CAAA,CAAA,EAAA,mBC4FX,gBD5FW,GAAA,SAAA,GAAA,SAAA,EAAA,kBC6FZ,OD7FY,EAAA,GAAA,EAAA,EAAA,gBC8Fd,MD9Fc,GC8FL,MD9FK,EAAA,WAAA,OAAA,EAAA,wBCgGN,cDhGM,CAAA,GAAA,CAAA,GAAA,SAAA,GAAA,SAAA,EAAA,mCAAA,MAAA,GAAA,MAAA,EAAA,sBCkGR,YDlGQ,GAAA,SAAA,GAAA,SAAA,EAAA,iCAAA,MAAA,GAAA,MAAA,EAAA,qBCoGT,eDpGS,CAAA,MAAA,EAAA,OAAA,CAAA,GCoG0B,eDpG1B,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,YAAA,SAAA,EAAA,6BAAA,MAAA,GAAA,MAAA,CAAA,CAAA,SAAA,EC2GnB,QD3GmB,CC4G7B,MD5G6B,EC6G7B,OD7G6B,EC8G7B,MD9G6B,EC+G7B,UD/G6B,ECgH7B,SDhH6B,ECiH7B,ODjH6B,ECkH7B,QDlH6B,ECmH7B,eDnH6B,ECoH7B,0BDpH6B,ECqH7B,aDrH6B,ECsH7B,wBDtH6B,ECuH7B,YDvH6B,ECwH7B,SDxH6B,ECyH7B,oBDzH6B,CAAA,CAAA,EC0H7B,gBD1H6B,CAAA,GAAA,CAAA;EA4Cf,WAAA,CAAA,QAAA,ECmFY,QDnFY,CCoFtC,MDpFsC,ECqFtC,ODrFsC,ECsFtC,MDtFsC,ECuFtC,UDvFsC,ECwFtC,SDxFsC,ECyFtC,ODzFsC,EC0FtC,QD1FsC,EC2FtC,eD3FsC,EC4FtC,0BD5FsC,EC6FtC,aD7FsC,EC8FtC,wBD9FsC,EC+FtC,YD/FsC,ECgGtC,SDhGsC,ECiGtC,oBDjGsC,CAAA,EAAA,gBAAA,CAAA,ECmGb,gBDnGa,CAAA,GAAA,CAAA;EAUxB,WAAA,CAAA,GAAA,EC+FV,kBD/FgC,CCgGpC,MDhGoC,ECiGpC,SDjGoC,ECkGpC,eDlGoC,ECmGpC,0BDnGoC,ECoGpC,aDpGoC,ECqGpC,wBDrGoC,ECsGpC,SDtGoC,ECuGpC,oBDvGoC,CAAA,CAAA,ECyGnC,ODzGmC,CCyG3B,gBDzG2B,CCyGV,mBDzGU,CCyGU,UDzGV,CAAA,CAAA,CAAA;EAAA,OAAA,CAAA,GAAA,EC6ShC,kBD7SgC,CC8SpC,MD9SoC,EC+SpC,SD/SoC,ECgTpC,eDhToC,ECiTpC,0BDjToC,ECkTpC,aDlToC,ECmTpC,wBDnToC,ECoTpC,SDpToC,ECqTpC,oBDrToC,CAAA,CAAA,ECuTnC,ODvTmC,CCuT3B,mBDvT2B,CCuTP,UDvTO,CAAA,CAAA;;;AAMnB;AAmBpB;KCuSK,uBDvSmC,CAAA,sBCwSjB,YDxSiB,GAAA,SAAA,GAAA,SAAA,CAAA,GCySpC,aDzSoC,SAAA,SAAA,GAAA,CAAA,CAAA,GAAA;EAAA;EAElB,cAEkB,ECySrB,aDzSqB;AAAsB,CAAA;AAkB9D;;;KC6RK,mBD3RK,CA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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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"}