@geekmidas/constructs 10.0.0-alpha.1 → 10.0.0-alpha.100

package/dist/adaptors/testing.d.cts

@@ -1,30 +1,24 @@
-import "../Construct-WhCXIOPV.cjs";
-import { Function } from "../index-BTvozlUD.cjs";
-import "../construct-interface-D2nNkHUN.cjs";
-import { HttpMethod } from "../types-BlAkSuGI.cjs";
-import { Endpoint, EndpointSchemas } from "../Endpoint-BQ9O0P1w.cjs";
-import { Queue } from "../Queue-D6WeziRD.cjs";
-import { Subscriber } from "../Subscriber-DVQowdyj.cjs";
-import { EventPublisher, ExtractPublisherMessage } from "@geekmidas/events";
+import { t as StandardSchemaV1 } from "../index-CeEtxDmK.cjs";
+import { n as Function } from "../Function-Pu-1kKZz.cjs";
+import { t as HttpMethod } from "../types-DMuSQeLL.cjs";
+import { c as EndpointSchemas, i as Endpoint } from "../Endpoint-aCvBMPoH.cjs";
+import { t as Queue } from "../Queue-HPyi0e1i.cjs";
+import { t as Subscriber } from "../Subscriber-Bpp02cGr.cjs";
+import { t as KyselyDatabase } from "../kysely-D0bpzgPs.cjs";
+import { o as TestStage } from "../stages-BSCF19o2.cjs";
+import { i as Fake } from "../external-api-O107yzZJ.cjs";
 import { Logger } from "@geekmidas/logger";
 import { ComposableStandardSchema, InferComposableStandardSchema, InferStandardSchema } from "@geekmidas/schema";
 import { Service, ServiceDiscovery, ServiceRecord } from "@geekmidas/services";
-import { StandardSchemaV1 } from "@standard-schema/spec";
 import { AuditStorage, AuditableAction, Auditor } from "@geekmidas/audit";
+import { EventPublisher, ExtractPublisherMessage } from "@geekmidas/events";
+import { TEST_CONTEXT_HEADER } from "@geekmidas/testkit/context";
 import { HttpHandler } from "msw";
-
+import { Browser } from "@geekmidas/testkit/browser";
+import { FakerFactory } from "@geekmidas/testkit/faker";
+import { Mailbox } from "@geekmidas/testkit/mailbox";
+import { Kysely } from "kysely";
 //#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 +59,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 +96,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 +104,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,70 +126,374 @@ 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
 /**
  * In-memory test driver for a {@link Queue} worker. Hand it a batch of messages
  * and it registers the queue's services, runs the handler in a request context,
- * and returns the handler result — no SQS/pg-boss required.
+ * and returns the handler result — no SQS/pg-boss required. A queue with a
+ * database gets `db` registered from it, or the one the request passes.
  *
  * @example
  * 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, TDatabase = undefined, TDatabaseServiceName extends string = string> {
   private readonly queue;
   private serviceDiscovery;
-  static getDefaultServiceDiscovery(): ServiceDiscovery<any>;
-  constructor(queue: Queue<TName, TMessage, TServices, TLogger>, serviceDiscovery?: ServiceDiscovery<any>);
-  invoke(request: TestQueueRequest<TMessage, TServices>): Promise<unknown>;
+  static getDefaultServiceDiscovery(): any;
+  constructor(queue: Queue<TName, TMessage, TServices, TLogger, TDatabase, TDatabaseServiceName>, serviceDiscovery?: ServiceDiscovery<any>);
+  invoke(request: TestQueueRequest<TMessage, TServices, TDatabase>): Promise<unknown>;
+  private getDatabase;
 }
-type TestQueueRequest<TMessage extends StandardSchemaV1 = StandardSchemaV1, TServices extends Service[] = []> = {
+type TestQueueRequest<TMessage extends StandardSchemaV1 = StandardSchemaV1, TServices extends Service[] = [], TDatabase = undefined> = {
   messages: InferStandardSchema<TMessage>[];
   services?: ServiceRecord<TServices>;
+  /** Stands in for the queue's database — a transaction, say. */
+  db?: TDatabase;
 };
-//# 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'][], TDatabase = undefined, TDatabaseServiceName extends string = string> {
   private readonly subscriber;
   private serviceDiscovery;
-  static getDefaultServiceDiscovery(): ServiceDiscovery<any>;
-  constructor(subscriber: Subscriber<TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TSubscribedEvents>, serviceDiscovery?: ServiceDiscovery<any>);
-  invoke(request: TestSubscriberRequest<TEventPublisher, TSubscribedEvents, TServices>): Promise<InferStandardSchema<OutSchema>>;
+  static getDefaultServiceDiscovery(): any;
+  constructor(subscriber: Subscriber<TServices, TLogger, OutSchema, TEventPublisher, TSubscribedEvents, TDatabase, TDatabaseServiceName>, serviceDiscovery?: ServiceDiscovery<any>);
+  invoke(request: TestSubscriberRequest<TEventPublisher, TSubscribedEvents, TServices, TDatabase>): Promise<InferStandardSchema<OutSchema>>;
+  private getDatabase;
   private filterEvents;
 }
-type TestSubscriberRequest<TEventPublisher extends EventPublisher<any> | undefined = undefined, TSubscribedEvents extends any[] = [], TServices extends Service[] = []> = {
+type TestSubscriberRequest<TEventPublisher extends EventPublisher<any> | undefined = undefined, TSubscribedEvents extends any[] = [], TServices extends Service[] = [], TDatabase = undefined> = {
   events: ExtractEventPayloads<TEventPublisher, TSubscribedEvents>[];
   services?: ServiceRecord<TServices>;
+  /** Stands in for the subscriber's database — a transaction, say. */
+  db?: TDatabase;
 };
 //#endregion
-export { CreateMswHandlersOptions, CreateMswHandlersResult, RegisterContextOptions, TEST_CONTEXT_HEADER, TestEndpointAdaptor, TestFunctionAdaptor, TestQueueAdaptor, TestSubscriberAdaptor, createMswHandlers };
+//#region src/testing/manifest.d.ts
+/** 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: TestStage;
+  /** 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;
+  }[];
+  /**
+   * Every topic subscriber — what a topic's events are delivered to. Not a
+   * construct, so not in `constructs`: the build finds them, as it finds
+   * endpoints.
+   */
+  subscribers?: {
+    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>;
+/** Each construct's client, keyed by its service name — what `services` types. */
+type ServiceClients = Record<string, unknown>;
+/** The client a construct's service registers — what a handler is handed. */
+type ClientOf<C> = C extends {
+  service: {
+    register: (...args: any[]) => infer TClient;
+  };
+} ? Awaited<TClient> : never;
+/**
+ * The app's services for this test, by service name — `services.get('shipping')`.
+ *
+ * What a handler that depends on the construct is handed, resolved the way the
+ * test's endpoints resolve it: an external API's client aimed at whatever the
+ * test stage resolved (its fake, which the test never sees), a topic or queue's
+ * recorder, a database's transaction for this test.
+ */
+interface TestServices<TServices extends ServiceClients> {
+  get<K extends keyof TServices & string>(name: K): Promise<TServices[K]>;
+}
+/**
+ * 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 = {}, TServices extends ServiceClients = {}> {
+  /** 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.
+   *
+   * Also delivered: once each request the test makes has answered, a queue's
+   * messages reach its consumer and a topic's events every subscriber that
+   * named them, in this test's transaction — see {@link deliver}.
+   */
+  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, any>>(subscriber: S) => SubscriberAdaptorOf<S>;
+  /**
+   * The app's services, by service name — `await services.get('shipping')` —
+   * as a handler is handed them. Assert on an external API through its own
+   * client: the fake behind it stays hidden, and the same assertion holds
+   * against the real API.
+   */
+  services: TestServices<TServices>;
+  /** A queue's worker, run on its own with this test's services. */
+  queue: <Q extends Queue<any, any, any, any, any, any>>(queue: Q) => QueueAdaptorOf<Q>;
+}
+type SubscriberAdaptorOf<S> = S extends Subscriber<infer TServices, infer TLogger, infer OutSchema, infer TEventPublisher, infer TSubscribedEvents, infer TDatabase, infer TDatabaseServiceName> ? TestSubscriberAdaptor<TServices, TLogger, OutSchema, TEventPublisher, TSubscribedEvents, TDatabase, TDatabaseServiceName> : never;
+type QueueAdaptorOf<Q> = Q extends Queue<infer TName, infer TMessage, infer TServices, infer TLogger, infer TDatabase, infer TDatabaseServiceName> ? TestQueueAdaptor<TName, TMessage, TServices, TLogger, TDatabase, TDatabaseServiceName> : 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, TServices extends ServiceClients> = (context: FeatureContext<TBrowser, TDatabases, TFactories, TServices>) => unknown;
+interface FeatureIt<TBrowser extends Browser, TDatabases extends DatabaseSchemas = {}, TFactories extends FactoryBuilders = {}, TServices extends ServiceClients = {}> {
+  (name: string, fn: FeatureFn<TBrowser, TDatabases, TFactories, TServices>, timeout?: number): void;
+  only(name: string, fn: FeatureFn<TBrowser, TDatabases, TFactories, TServices>, timeout?: number): void;
+  skip(name: string, fn: FeatureFn<TBrowser, TDatabases, TFactories, TServices>, timeout?: number): void;
+}
+export declare function featureTest<TBrowser extends Browser = Browser, TDatabases extends DatabaseSchemas = {}, TFactories extends FactoryBuilders = {}, TServices extends ServiceClients = {}>(options?: FeatureTestOptions<TBrowser, TFactories>): FeatureIt<TBrowser, TDatabases, TFactories, TServices>;
+/** 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[]);
+}
+/** A published message the consumer's own schema refuses. */
+export declare class MessageRejected extends Error {
+  readonly consumer: string;
+  readonly published: PublishedMessage;
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(consumer: string, published: PublishedMessage, issues: ReadonlyArray<StandardSchemaV1.Issue>);
+}
+/** A consumer that threw while handling what the test published. */
+export declare class DeliveryFailed extends Error {
+  readonly consumer: string;
+  readonly messages: readonly PublishedMessage[];
+  readonly cause: unknown;
+  constructor(consumer: string, messages: readonly PublishedMessage[], cause: unknown);
+}
+/** Consumers that kept publishing to each other without settling. */
+export declare class DeliveryDidNotSettle extends Error {
+  readonly rounds: number;
+  readonly channels: readonly string[];
+  constructor(rounds: number, channels: readonly string[]);
+}
+/** `services.get(name)` for a name no construct of the app is served by. */
+export declare class UnknownService extends Error {
+  readonly serviceName: string;
+  readonly available: readonly string[];
+  constructor(serviceName: string, available: readonly string[]);
+}
+//#endregion
+//#region src/testing/peer.d.ts
+/**
+ * The TCP peer a test's in-process requests arrive from.
+ *
+ * A feature test hands a request straight to a surface's Hono app — no
+ * socket, no server — so the app's bindings have no peer to read. Deployed,
+ * every request has one, and what a surface trusts follows from it: the auth
+ * server honours `x-gkm-client-ip` only from an internal caller, a loopback
+ * or private peer with no `Origin` and no forwarding header. With no peer at
+ * all the header was dropped, and every test's session check became the same
+ * client to Better Auth's rate limiter.
+ *
+ * So an in-process dispatch says where it came from, the way
+ * `@hono/node-server` does: its bindings carry `incoming.socket.remoteAddress`.
+ * The address is loopback because that is the truth — the request came from
+ * this process. A browser's own address still travels in its
+ * `x-forwarded-for`, which makes it outside traffic exactly as it would be
+ * behind the stack's proxy.
+ *
+ * Only a test's dispatch passes these. A runtime with no socket of its own
+ * (Lambda, Bun) still has no peer, and a request with no peer is still not an
+ * internal caller's.
+ */
+/** The address an in-process request presents as its peer. */
+export declare const IN_PROCESS_PEER_ADDRESS = "127.0.0.1";
+/** The part of `@hono/node-server`'s bindings a surface reads its peer from. */
+interface InProcessBindings {
+  incoming: {
+    socket: {
+      remoteAddress: string;
+    };
+  };
+}
+/** Bindings for `app.fetch(request, bindings)` from inside this process. */
+export declare function inProcessBindings(): InProcessBindings;
+//#endregion
+export { type ClientOf, type CreateMswHandlersOptions, type CreateMswHandlersResult, type DatabaseOf, type DatabaseSchemas, type FactoryBuilders, type FeatureContext, type FeatureIt, type FeatureTestOptions, type InProcessBindings, type MagicLinkAuthClient, type RegisterContextOptions, type ServiceClients, TEST_CONTEXT_HEADER, type TestDatabases, type TestFactories, type TestManifest, type TestManifestSource, type TestServices };
 //# sourceMappingURL=testing.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"testing.d.cts","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,CAAA,YAAA,SAAA,CAAA,GC2RwC,SD3RxC,SAAA,SAAA,GAAA,CAAA,CAAA,GAAA;EAAwB;EACR,QAAA,EC8Rb,SD9Ra;;KCiSd,kCACI,wCACG,wCACM,uHAEF;YAKZ,cAAc;EAzXb,OAAA,EA0XF,MA1XE,CAAA,MAAgB,EAAA,MAAA,CAAA;EAAA,SAAA,CAAA,EA2Xf,OA3Xe,CA2XP,0BA3XO,EA2XqB,eA3XrB,CAAA;CAAA,GA4XxB,6BA3XG,CA2X2B,MA3X3B,CAAA,GA4XN,uBA5XM,CA4XkB,aA5XlB,CAAA,GA6XN,mBA7XM,CA6Xc,SA7Xd,CAAA;;;cCnBM,mCACG,qEACI,4DACD,gCACF,SAAS,gCACD,uHAEF,kLAID,mCAAmC;;;mDAMxC,qEACI,4DACD,gCACF,SAAS,gCACD,uHAEF,kLAID,mCAAmC,uCAKnD,SACJ,QACA,WACA,SACA,YACA,iBACA,4BACA,eACA,0BACA,WACA,sBACA,qBAEA;kBAMoB,SACpB,QACA,WACA,SACA,YACA,iBACA,4BACA,eACA,0BACA,WACA,sBACA,uCAGyB;cAMrB,oBACJ,QACA,WACA,iBACA,4BACA,WACA,gBAEC,QAAQ,oBAAoB;;KAoGpB,mCACI,oEACG,wCACM,6IAGH,mCAAmC;SAKjD,8BAA8B;EFtMzB,QAAA,EEuMF,aFvMqB,CEuMP,SFvMO,CAAA;EA4Cf,SAAA,CAAA,EE4JJ,OF5JI,CE4JI,0BF5JoB,EE4JQ,eF5JR,CAAA;EAUxB,EAAA,CAAA,EEmJX,SFnJW;EAAsB,OAAA,CAAA,EEoJ5B,OFpJ4B,CEoJpB,YFpJoB,CAAA;CAAA,GEqJnC,6BFnJQ,CAAA;EAAM,KAIL,EE+I8B,MF/I9B;AAAO,CAAA,CAAA;AAmBpB;;;;;;;;;;;;cG3Ea,iEAEK,mBAAmB,oCAClB,gCACF,SAAS;EHRb,iBAAA,KAAmB;EA4Cf,QAAA,gBAAA;EAUA,OAAA,0BAAsB,CAAA,CAAA,EG5CL,gBH4CK,CAAA,GAAA,CAAA;EAAA,WAAA,CAAA,KAAA,EGvCb,KHuCa,CGvCP,KHuCO,EGvCA,QHuCA,EGvCU,SHuCV,EGvCqB,OHuCrB,CAAA,EAAA,gBAAA,CAAA,EGtCX,gBHsCW,CAAA,GAAA,CAAA;EAAA,MAE3B,CAAA,OAAA,EGpCD,gBHoCC,CGpCgB,QHoChB,EGpC0B,SHoC1B,CAAA,CAAA,EGnCR,OHmCQ,CAAA,OAAA,CAAA;;AAIQ,KGjBR,gBHiBQ,CAAA,iBGhBF,gBHgBE,GGhBiB,gBHgBjB,EAAA,kBGfD,OHeC,EAAA,GAAA,EAAA,CAAA,GAAA;EAmBH,QAAA,EGhCN,mBHgC6B,CGhCT,QHgCS,CAAA,EAAA;EAAA,QAAA,CAAA,EG/B5B,aH+B4B,CG/Bd,SH+Bc,CAAA;CAAA;;;;KI9EnC,wCACe,8DAEhB,mBAAmB,sBACpB,QAAQ,wBAAwB;QAAqB;;cAG3C,wCACM,gCACF,SAAS,0BACP,kEACM,2HAGvB,wBAAwB,6BAA6B,wBAAwB;;;uCAE7C;0BAKH,WAC5B,WACA,SACA,WACA,iBACA,4BACA,uCAEyB;kBAIjB,sBACR,iBACA,mBACA,aAEC,QAAQ,oBAAoB;EJvCnB,QAAA,YAAA;AA4Cb;AAUiB,KI0DL,qBJ1D2B,CAAA,wBI2Dd,cJ3Dc,CAAA,GAAA,CAAA,GAAA,SAAA,GAAA,SAAA,EAAA,0BAAA,GAAA,EAAA,GAAA,EAAA,EAAA,kBI6DpB,OJ7DoB,EAAA,GAAA,EAAA,CAAA,GAAA;EAAA,MAAA,EI+D9B,oBJ/D8B,CI+DT,eJ/DS,EI+DQ,iBJ/DR,CAAA,EAAA;EAAA,QAE3B,CAAA,EI8DA,aJ9DA,CI8Dc,SJ9Dd,CAAA;CAAM"}
+{"version":3,"file":"testing.d.cts","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","../../src/testing/peer.ts"],"mappings":"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"}