@routecraft/testing 0.6.0-canary.8 → 0.6.0

package/dist/index.d.ts

@@ -1,21 +1,53 @@
-import { AdapterOverride, AdapterSourceCall, AdapterSendCall, SourceOverrideBehavior, SendOverrideHandler, Source, CraftContext, CraftClient, RoutecraftError, CraftConfig, EventName, EventHandler, StoreRegistry, RouteDefinition, RouteBuilder, Destination, Processor, Exchange, logger } from '@routecraft/routecraft';
-import { vi } from 'vitest';
+import { AdapterOverride, AdapterSourceCall, AdapterSendCall, SourceOverrideBehavior, SendOverrideHandler, Source, CraftContext, CraftClient, RoutecraftError, CraftConfig, EventName, EventHandler, StoreRegistry, RouteDefinition, AnyRouteBuilder, Destination, Enricher, Processor, Exchange, ExchangeHeaders, SourceFixture, logger, OnParseError, SourceMeta, Subscription } from '@routecraft/routecraft';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 
 /**
- * Spy logger with vi.fn() methods for assertions (e.g. expect(t.logger.info).toHaveBeenCalledWith(...)).
+ * Minimal runner-agnostic spy function. Records calls in the jest-compatible
+ * `mock.calls` shape so assertions like
+ * `expect(t.logger.warn.mock.calls.some(...))` work under bun:test, Vitest,
+ * and node:test without this package importing any runner.
+ *
+ * Runner mocks (`vi.fn` from Vitest, `mock` from bun:test) are structurally
+ * assignable to this interface, so they can be injected via {@link SpyFactory}
+ * when full matcher support (`expect(fn).toHaveBeenCalledWith(...)`) is
+ * wanted.
+ */
+interface SpyFn {
+    (...args: unknown[]): unknown;
+    mock: {
+        calls: unknown[][];
+    };
+    mockImplementation(impl: (...args: unknown[]) => unknown): SpyFn;
+    mockClear(): void;
+}
+/**
+ * Factory producing spy functions. Defaults to the built-in {@link createSpyFn};
+ * pass your runner's mock factory (`vi.fn`, or `mock` from bun:test) to get
+ * native mocks that work with the runner's `expect` matchers.
+ */
+type SpyFactory = () => SpyFn;
+/**
+ * Create a built-in spy function. Dependency-free; records calls in
+ * `fn.mock.calls` and supports `mockImplementation` / `mockClear`.
+ */
+declare function createSpyFn(): SpyFn;
+/**
+ * Spy logger with spy methods for assertions (e.g.
+ * `t.logger.info.mock.calls` under any runner, or
+ * `expect(t.logger.info).toHaveBeenCalledWith(...)` when built from an
+ * injected runner mock factory).
  */
 type SpyLogger = {
-    info: ReturnType<typeof vi.fn>;
-    debug: ReturnType<typeof vi.fn>;
-    warn: ReturnType<typeof vi.fn>;
-    error: ReturnType<typeof vi.fn>;
-    trace: ReturnType<typeof vi.fn>;
-    fatal: ReturnType<typeof vi.fn>;
-    child: ReturnType<typeof vi.fn>;
+    info: SpyFn;
+    debug: SpyFn;
+    warn: SpyFn;
+    error: SpyFn;
+    trace: SpyFn;
+    fatal: SpyFn;
+    child: SpyFn;
 };
-declare function createSpyLogger(): SpyLogger;
-declare function createNoopSpyLogger(): SpyLogger;
+declare function createSpyLogger(fn?: SpyFactory): SpyLogger;
+declare function createNoopSpyLogger(fn?: SpyFactory): SpyLogger;
 
 /**
  * Brand symbol stamped on the handles returned by `mockAdapter()`.
@@ -50,9 +82,13 @@ interface MockAdapterBehavior<M = unknown> {
      */
     source?: SourceOverrideBehavior<M>;
     /**
-     * Destination-role behaviour. Used when the adapter is passed to `.to()`,
-     * `.enrich()`, or `.tap()`. Receives the exchange and a meta object with
-     * the construction args; returning a value replaces the body upstream.
+     * Destination/enricher-role behaviour. Used when the adapter is passed to
+     * `.to()`, `.enrich()`, or `.tap()`. Receives the exchange and a meta
+     * object with the construction args. The handler's return value follows
+     * the step's slot resolution: a fetch-resolved step (`.enrich()`, or a
+     * fetch-only adapter in `.to()`) uses it as the fetched value (replacing
+     * the body by default), while a send-resolved `.to()` discards it (send
+     * is void) and `.tap()` always discards.
      */
     send?: SendOverrideHandler;
 }
@@ -80,7 +116,7 @@ interface AdapterMock {
  * - An adapter factory (e.g. `mail`, `http`, `mcp`). The mock matches every
  *   adapter instance produced by that factory. Requires the factory to stamp
  *   its adapters via `tagAdapter()`.
- * - An adapter class (e.g. `MailSourceAdapter`, `HttpDestinationAdapter`).
+ * - An adapter class (e.g. `MailSourceAdapter`, `HttpEnricherAdapter`).
  *   The mock matches any adapter whose `constructor === target`. Works for
  *   every adapter without opt-in tagging, including third-party ones.
  *
@@ -104,7 +140,7 @@ interface AdapterMock {
  *
  * const mailMock = mockAdapter(mail, {
  *   source: [{ uid: 1, from: "a@b", subject: "hi", ... }],
- *   send: async () => ({ messageId: "<fake>" }),
+ *   send: async () => undefined,
  * });
  *
  * // Class form (works for any adapter, including third-party ones)
@@ -128,6 +164,13 @@ declare function mockAdapter<T extends ((...args: never[]) => unknown) | (new (.
 interface TestContextOptions {
     /** Timeout in ms for waiting for all routes to emit routeStarted. Default 200. */
     routesReadyTimeoutMs?: number;
+    /**
+     * Mock factory used to build the spy logger. Defaults to the built-in
+     * runner-agnostic spy. Pass your runner's factory (`vi.fn` from Vitest, or
+     * `mock` from bun:test) to get native mocks that work with the runner's
+     * `expect` matchers, e.g. `testContext({ fn: vi.fn })`.
+     */
+    fn?: SpyFactory;
 }
 /**
  * Options for TestContext.test().
@@ -143,13 +186,13 @@ interface TestOptions {
 /**
  * Test-friendly wrapper around CraftContext. Runs the real context but manages
  * lifecycle (start, wait routes ready, drain, stop) and collects errors.
- * t.logger is a spy logger (vi.fn() methods) for asserting on log calls.
+ * t.logger is a spy logger for asserting on log calls.
  */
 declare class TestContext {
     readonly ctx: CraftContext;
     /** Client for dispatching messages to direct endpoints in tests. */
     readonly client: CraftClient;
-    /** Spy logger; e.g. expect(t.logger.info).toHaveBeenCalledWith(...) */
+    /** Spy logger; e.g. t.logger.info.mock.calls, or expect(t.logger.info).toHaveBeenCalledWith(...) with an injected runner mock factory */
     readonly logger: SpyLogger;
     readonly errors: RoutecraftError[];
     private readonly routesReadyTimeoutMs;
@@ -162,23 +205,23 @@ declare class TestContext {
     });
     /**
      * Build a promise that resolves once every route has emitted
-     * `route:*:started`, or rejects on `context:error` or the configured
+     * `route:started`, or rejects on `context:error` or the configured
      * routes-ready timeout. Shared by {@link startAndWaitReady} and {@link test}.
      */
     private awaitRoutesReady;
     /**
-     * Start context and resolve once every route has emitted `route:*:started`.
+     * Start context and resolve once every route has emitted `route:started`.
      * Does not drain or stop. Does not await `ctx.start()` completion, which
      * lets this method work with long-running sources (direct, mcp, HTTP, etc.)
      * whose subscribe blocks until the route is aborted. The start promise is
      * stored internally and awaited by {@link stop} for clean shutdown.
      *
-     * Use with {@link CraftClient.send} (via `t.client`) for direct endpoints,
+     * Use with {@link CraftClient.sendDirect} (via `t.client`) for direct endpoints,
      * or drive sources directly via the context store, then call `drain()` /
      * `stop()` when done.
      *
      * If `ctx.start()` rejects (synchronously or before any route emits
-     * `route:*:started`), the rejection surfaces here via the
+     * `route:started`), the rejection surfaces here via the
      * `context:error` listener installed by `awaitRoutesReady`. A no-op
      * catch is attached to `startedPromise` as a safety net so that a
      * slow rejection does not trigger an `unhandledRejection` before
@@ -205,6 +248,8 @@ declare class TestContextBuilder {
     private builder;
     private routesReadyTimeoutMs;
     private adapterOverrides;
+    private readonly spyFactory;
+    constructor(options?: TestContextOptions);
     /** Override timeout for waiting for routes to start (ms). Used by tests that assert timeout behavior. */
     routesReadyTimeout(ms: number): this;
     /**
@@ -218,18 +263,27 @@ declare class TestContextBuilder {
     on<K extends EventName>(event: K, handler: EventHandler<K>): this;
     once<K extends EventName>(event: K, handler: EventHandler<K>): this;
     store<K extends keyof StoreRegistry>(key: K, value: StoreRegistry[K]): this;
-    routes(routes: RouteDefinition[] | RouteBuilder<unknown>[] | RouteDefinition | RouteBuilder<unknown>): this;
+    routes(routes: RouteDefinition[] | AnyRouteBuilder[] | RouteDefinition | AnyRouteBuilder): this;
     build(): Promise<TestContext>;
 }
 /**
  * Create a test context builder. Use .routes(...).build(), await the result, then await t.test().
  *
+ * Runner-agnostic by default: the spy logger uses a built-in spy that records
+ * calls in the jest-compatible `mock.calls` shape. Pass `{ fn }` with your
+ * runner's mock factory (`vi.fn` from Vitest, `mock` from bun:test) when you
+ * want `expect(t.logger.info).toHaveBeenCalledWith(...)` matcher support.
+ *
  * @example
  * const builder = testContext();
  * const t = await builder.routes(myRoutes).build();
  * await t.test();
+ *
+ * @example
+ * // Vitest, with native matcher support:
+ * const t = await testContext({ fn: vi.fn }).routes(myRoutes).build();
  */
-declare function testContext(): TestContextBuilder;
+declare function testContext(options?: TestContextOptions): TestContextBuilder;
 
 interface PseudoOptions {
     runtime?: "throw" | "noop";
@@ -243,7 +297,7 @@ interface PseudoKeyedOptions extends PseudoOptions {
  */
 type PseudoAdapter<R> = {
     adapterId: string;
-} & Source<R> & Destination<any, R> & Processor<any, R>;
+} & Source<R> & Destination<any> & Enricher<any, R> & Processor<any, R>;
 /** @internal */
 type PseudoFactory<Opts> = <R = unknown>(opts: Opts) => PseudoAdapter<R>;
 /** @internal */
@@ -256,8 +310,10 @@ declare function pseudo<Opts extends Record<string, unknown> = Record<string, un
 
 /**
  * A spy adapter that records all exchanges passing through it.
- * Implements both {@link Destination} and {@link Processor} so it can be used
- * with `.to()`, `.enrich()`, `.tap()`, and `.process()`.
+ * Implements {@link Destination} (send), {@link Enricher} (fetch), and
+ * {@link Processor} so it can be used with `.to()`, `.tap()`, `.enrich()`,
+ * and `.process()`. The fetch face returns the current body, so a bare
+ * `.enrich(spy())` observes without changing the body.
  */
 type SpyAdapter<T = unknown> = {
     /** Stable identifier for this adapter. */
@@ -276,7 +332,7 @@ type SpyAdapter<T = unknown> = {
     lastReceived(): Exchange<T>;
     /** Array of just the body values from received exchanges. */
     receivedBodies(): T[];
-} & Destination<any, void> & Processor<any, T>;
+} & Destination<any> & Enricher<any, T> & Processor<any, T>;
 /**
  * Creates a spy adapter that records all exchanges for test assertions.
  *
@@ -299,6 +355,37 @@ type SpyAdapter<T = unknown> = {
  */
 declare function spy<T = unknown>(): SpyAdapter<T>;
 
+/**
+ * Wrap a message body with the headers a real source would have attached, for
+ * use as a `mockAdapter(..., { source: [...] })` fixture.
+ *
+ * Envelope-carrying sources (mail, http) split each incoming message into a
+ * payload on `exchange.body` and metadata on `routecraft.<adapter>.*` headers.
+ * A bare fixture array only sets the body, so a route that reads those headers
+ * cannot be exercised through the mock. `sourceMessage(body, headers)` lets the
+ * mock reproduce that split.
+ *
+ * @example
+ * ```typescript
+ * const mailMock = mockAdapter(mail, {
+ *   source: [
+ *     sourceMessage(
+ *       { text: "Tracking: ABC123" },
+ *       {
+ *         "routecraft.mail.from": "noreply@acme.test",
+ *         "routecraft.mail.subject": "Your order has shipped",
+ *       },
+ *     ),
+ *   ],
+ * });
+ * ```
+ *
+ * @param body - The body the source would deliver on the exchange
+ * @param headers - Headers the source would attach (omit for a body-only fixture)
+ * @returns A branded fixture recognised by the source-mock dispatcher
+ */
+declare function sourceMessage<M>(body: M, headers?: ExchangeHeaders): SourceFixture<M>;
+
 /**
  * Structural shape of a fn-like spec for testing. Does not import
  * `FnOptions` from `@routecraft/ai` so this package stays free of
@@ -357,6 +444,43 @@ interface TestFnOptions {
  */
 declare function testFn<TIn, TOut>(spec: TestFnSpec<TIn, TOut>, input: unknown, options?: TestFnOptions): Promise<TOut>;
 
+/**
+ * Options for {@link testSubscription}. The `handler` mirrors the message
+ * fields the engine receives, flattened into positional arguments so test
+ * assertions read naturally.
+ */
+interface TestSubscriptionOptions<T = unknown> {
+    /** Context handed to the source (store access, logger). */
+    context: CraftContext;
+    /** Receives each emitted message; its return value resolves `emit`. */
+    handler: (message: T, headers?: ExchangeHeaders, parse?: (raw: unknown) => unknown | Promise<unknown>, parseFailureMode?: OnParseError) => Promise<unknown> | unknown;
+    /** Abort to stop the source; `complete()` calls its `abort`. */
+    abortController?: AbortController;
+    /** Called when the source signals readiness. */
+    onReady?: () => void;
+    /** Source meta; defaults to `{ routeId: "test" }`. */
+    meta?: SourceMeta;
+}
+/**
+ * Build a {@link Subscription} for driving a source adapter directly in a
+ * unit test, without a running route. Wire-up mirrors the engine: `emit`
+ * forwards to `handler`, `ready` to `onReady`, `complete` aborts the
+ * controller, and `signal` observes it.
+ *
+ * @example
+ * ```typescript
+ * const received: unknown[] = [];
+ * await adapter.subscribe(
+ *   testSubscription({
+ *     context: t.ctx,
+ *     handler: (message) => void received.push(message),
+ *     abortController,
+ *   }),
+ * );
+ * ```
+ */
+declare function testSubscription<T = unknown>(options: TestSubscriptionOptions<T>): Subscription<T>;
+
 /**
  * Load a JSON fixture file and return the parsed value.
  *
@@ -365,18 +489,32 @@ declare function testFn<TIn, TOut>(spec: TestFnSpec<TIn, TOut>, input: unknown,
  */
 declare function fixture<T = unknown>(path: string): T;
 /**
- * Fixture entry must have a `name` field used as the vitest test name.
+ * Fixture entry must have a `name` field used as the test name.
  */
 interface FixtureWithName {
     name: string;
     [key: string]: unknown;
 }
 /**
- * Load a JSON array fixture and run one vitest test per entry. Each entry must have a `name` field (used as the test name).
+ * A test runner's `test` function, as accepted by {@link fixtureEach}.
+ * Both `test` from bun:test and `test` from Vitest satisfy this shape.
+ */
+type FixtureTestFn = (name: string, fn: () => void | Promise<void>) => unknown;
+/**
+ * Load a JSON array fixture and run one test per entry. Each entry must have
+ * a `name` field (used as the test name). Runner-agnostic: pass your runner's
+ * `test` function (bun:test, Vitest, node:test).
  *
  * @param path Path to a JSON file that parses to an array
+ * @param test The runner's `test` function used to register each entry
  * @param run Callback invoked per entry; use for assertions. Receives the fixture entry.
+ *
+ * @example
+ * import { test } from "bun:test";
+ * fixtureEach("./cases.json", test, (entry) => {
+ *   expect(run(entry.input)).toEqual(entry.expected);
+ * });
  */
-declare function fixtureEach<T extends FixtureWithName>(path: string, run: (entry: T) => void | Promise<void>): void;
+declare function fixtureEach<T extends FixtureWithName>(path: string, test: FixtureTestFn, run: (entry: T) => void | Promise<void>): void;
 
-export { type AdapterMock, type FixtureWithName, type MockAdapterBehavior, type PseudoKeyedOptions, type PseudoOptions, type SpyAdapter, type SpyLogger, TestContext, TestContextBuilder, type TestContextOptions, type TestFnHandlerContext, type TestFnOptions, type TestFnSpec, type TestOptions, createNoopSpyLogger, createSpyLogger, fixture, fixtureEach, mockAdapter, pseudo, spy, testContext, testFn };
+export { type AdapterMock, type FixtureTestFn, type FixtureWithName, type MockAdapterBehavior, type PseudoKeyedOptions, type PseudoOptions, type SpyAdapter, type SpyFactory, type SpyFn, type SpyLogger, TestContext, TestContextBuilder, type TestContextOptions, type TestFnHandlerContext, type TestFnOptions, type TestFnSpec, type TestOptions, type TestSubscriptionOptions, createNoopSpyLogger, createSpyFn, createSpyLogger, fixture, fixtureEach, mockAdapter, pseudo, sourceMessage, spy, testContext, testFn, testSubscription };

package/dist/index.js

@@ -1,2 +1,2 @@
-import {readFileSync}from'fs';import {vi,test}from'vitest';import {ContextBuilder,logger,RC_ADAPTER_OVERRIDES,HeadersKeys,rcError,formatSchemaIssues,isRoutecraftError}from'@routecraft/routecraft';function y(){let t={info:vi.fn(),debug:vi.fn(),warn:vi.fn(),error:vi.fn(),trace:vi.fn(),fatal:vi.fn(),child:vi.fn()};return t.child.mockImplementation(()=>t),t}function g(){let t=vi.fn(),e=vi.fn(),r={info:t,debug:t,warn:t,error:t,trace:t,fatal:t,child:e};return e.mockImplementation(()=>r),r}var m=Symbol.for("routecraft.testing.adapter-mock");function v(t){return typeof t=="object"&&t!==null&&t[m]===true}function O(t,e){let r={target:t,calls:{source:[],send:[]}};return e.source!==void 0&&(r.source=e.source),e.send!==void 0&&(r.send=e.send),{[m]:true,override:r,get calls(){return {source:[...r.calls.source],send:[...r.calls.send]}}}}var b=200;function E(t){return typeof t=="function"&&typeof t.name=="string"?`${/^[A-Z]/.test(t.name)&&t.prototype!==void 0?"class":"factory"} ${t.name||"<anonymous>"}`:"target"}var p=class{ctx;client;logger;errors=[];routesReadyTimeoutMs;restoreLoggerChild;loggerChildRestored=false;startedPromise;constructor(e,r,n){this.ctx=e,this.client=r,this.logger=n?.spyLogger??g(),n?.restoreLoggerChild&&(this.restoreLoggerChild=n.restoreLoggerChild),this.routesReadyTimeoutMs=n?.routesReadyTimeoutMs??b;let s=o=>{this.errors.push(isRoutecraftError(o)?o:rcError("RC9901",o));};e.on("context:error",o=>{s(o.details.error);});}awaitRoutesReady(){let e=this.ctx,r=e.getRoutes().length;return r===0?Promise.resolve():new Promise((n,s)=>{let o=0,i=false,d=setTimeout(()=>{i||(f(),s(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),h=e.on("route:*:started",(()=>{i||(o++,o>=r&&(f(),n()));})),l=e.on("context:error",S=>{i||(f(),s(S.details.error));});function f(){i||(i=true,h(),l(),d!==void 0&&(clearTimeout(d),d=void 0));}})}async startAndWaitReady(){let e=this.awaitRoutesReady();this.startedPromise=this.ctx.start(),this.startedPromise.catch(()=>{}),await e;}async test(e){let r=this.ctx,n=this.awaitRoutesReady(),s=r.start();s.catch(()=>{});try{await n;let o=e?.delayBeforeDrainMs??0;o>0&&await new Promise(i=>setTimeout(i,o)),await r.drain();}finally{try{await r.stop(),await s;}finally{this.restoreLoggerChildOnce();}}}drain(){return this.ctx.drain()}async stop(){try{await this.ctx.stop(),this.startedPromise!==void 0&&await this.startedPromise;}finally{this.restoreLoggerChildOnce();}}restoreLoggerChildOnce(){this.loggerChildRestored||(this.restoreLoggerChild?.(),this.loggerChildRestored=true);}},c=class{builder=new ContextBuilder;routesReadyTimeoutMs;adapterOverrides=[];routesReadyTimeout(e){return this.routesReadyTimeoutMs=e,this}override(e){let r=v(e)?e.override:e;if(this.adapterOverrides.find(s=>s.target===r.target)!==void 0){let s=E(r.target);throw new Error(`testContext().override(): duplicate override for ${s}. Each target may only be registered once; remove the redundant override() call.`)}return this.adapterOverrides.push(r),this}with(e){return this.builder.with(e),this}on(e,r){return this.builder.on(e,r),this}once(e,r){return this.builder.once(e,r),this}store(e,r){return this.builder.store(e,r),this}routes(e){return this.builder.routes(e),this}async build(){let e=y(),r=logger.child.bind(logger);logger.child=vi.fn(()=>e);let{context:n,client:s}=await this.builder.build();if(this.adapterOverrides.length>0){let i=n.getStore(RC_ADAPTER_OVERRIDES)??[];n.setStore(RC_ADAPTER_OVERRIDES,[...i,...this.adapterOverrides]);}let o={...this.routesReadyTimeoutMs!==void 0?{routesReadyTimeoutMs:this.routesReadyTimeoutMs}:{},spyLogger:e,restoreLoggerChild:()=>{logger.child=r;}};return new p(n,s,o)}};function M(){return new c}function x(t,e){let r=()=>{throw new Error(`Pseudo adapter "${t}" is not implemented. Replace with a real adapter.`)},n=()=>Promise.resolve(void 0),s=i=>i,o=(i,d,h,l)=>(l?.(),Promise.resolve());return {adapterId:`routecraft.adapter.pseudo.${t}`,subscribe:e==="noop"?o:r,send:e==="noop"?n:r,process:e==="noop"?s:r}}function L(t="pseudo",e){let r=e?.runtime??"throw";return e&&"args"in e&&e.args==="keyed"?(s,o)=>x(t,r):s=>x(t,r)}function R(){return {received:[],calls:{send:0,process:0,enrich:0}}}function K(){let t=R();return {adapterId:"routecraft.adapter.spy",received:t.received,calls:t.calls,send(e){t.received.push(e),e.headers?.[HeadersKeys.OPERATION]==="enrich"?t.calls.enrich++:t.calls.send++;},process(e){return t.received.push(e),t.calls.process++,e},reset(){t.received.length=0,t.calls.send=0,t.calls.process=0,t.calls.enrich=0;},lastReceived(){if(t.received.length===0)throw new Error("SpyAdapter: no exchanges recorded");return t.received[t.received.length-1]},receivedBodies(){return t.received.map(e=>e.body)}}}async function B(t,e,r={}){let n=t.input["~standard"];if(typeof n?.validate!="function")throw rcError("RC5003",void 0,{message:"testFn: spec.input must be a Standard Schema with a callable validate."});let s=n.validate,o=s(e);if(o instanceof Promise&&(o=await o),o.issues!==void 0&&o.issues!==null)throw rcError("RC5002",void 0,{message:`testFn: input validation failed: ${formatSchemaIssues(o.issues)}`});let i={logger:r.logger??logger.child({test:"fn"}),abortSignal:r.signal??new AbortController().signal},d="value"in o?o.value:e;return await t.handler(d,i)}function H(t){return JSON.parse(readFileSync(t,"utf-8"))}function ie(t,e){let r=H(t);if(!Array.isArray(r))throw new Error(`fixture.each: expected JSON array at "${t}", got ${typeof r}`);for(let n of r){if(typeof n?.name!="string")throw new Error(`fixture.each: each entry must have a "name" field (string). Got: ${JSON.stringify(n)}`);test(n.name,()=>e(n));}}export{p as TestContext,c as TestContextBuilder,g as createNoopSpyLogger,y as createSpyLogger,H as fixture,ie as fixtureEach,O as mockAdapter,L as pseudo,K as spy,M as testContext,B as testFn};//# sourceMappingURL=index.js.map
+import {readFileSync}from'fs';import {ContextBuilder,logger,RC_ADAPTER_OVERRIDES,SOURCE_FIXTURE,rcError,formatSchemaIssues,isRoutecraftError}from'@routecraft/routecraft';function u(){let t,e=[],r=((...o)=>(e.push(o),t?.(...o)));return r.mock={calls:e},r.mockImplementation=o=>(t=o,r),r.mockClear=()=>{e.length=0;},r}function f(t=u){let e={info:t(),debug:t(),warn:t(),error:t(),trace:t(),fatal:t(),child:t()};return e.child.mockImplementation(()=>e),e}function g(t=u){let e=t(),r=t(),o={info:e,debug:e,warn:e,error:e,trace:e,fatal:e,child:r};return r.mockImplementation(()=>o),o}var h=Symbol.for("routecraft.testing.adapter-mock");function m(t){return typeof t=="object"&&t!==null&&t[h]===true}function F(t,e){let r={target:t,calls:{source:[],send:[]}};return e.source!==void 0&&(r.source=e.source),e.send!==void 0&&(r.send=e.send),{[h]:true,override:r,get calls(){return {source:[...r.calls.source],send:[...r.calls.send]}}}}var b=200;function E(t){return typeof t=="function"&&typeof t.name=="string"?`${/^[A-Z]/.test(t.name)&&t.prototype!==void 0?"class":"factory"} ${t.name||"<anonymous>"}`:"target"}var p=class{ctx;client;logger;errors=[];routesReadyTimeoutMs;restoreLoggerChild;loggerChildRestored=false;startedPromise;constructor(e,r,o){this.ctx=e,this.client=r,this.logger=o?.spyLogger??g(),o?.restoreLoggerChild&&(this.restoreLoggerChild=o.restoreLoggerChild),this.routesReadyTimeoutMs=o?.routesReadyTimeoutMs??b;let s=n=>{this.errors.push(isRoutecraftError(n)?n:rcError("RC9901",n));};e.on("context:error",n=>{s(n.details.error);});}awaitRoutesReady(){let e=this.ctx,r=e.getRoutes().length;return r===0?Promise.resolve():new Promise((o,s)=>{let n=0,i=false,a=setTimeout(()=>{i||(y(),s(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),d=e.on("route:started",(()=>{i||(n++,n>=r&&(y(),o()));})),k=e.on("context:error",O=>{i||(y(),s(O.details.error));});function y(){i||(i=true,d(),k(),a!==void 0&&(clearTimeout(a),a=void 0));}})}async startAndWaitReady(){let e=this.awaitRoutesReady();this.startedPromise=this.ctx.start(),this.startedPromise.catch(()=>{}),await e;}async test(e){let r=this.ctx,o=this.awaitRoutesReady(),s=r.start();s.catch(()=>{});try{await o;let n=e?.delayBeforeDrainMs??0;n>0&&await new Promise(i=>setTimeout(i,n)),await r.drain();}finally{try{await r.stop(),await s;}finally{this.restoreLoggerChildOnce();}}}drain(){return this.ctx.drain()}async stop(){try{await this.ctx.stop(),this.startedPromise!==void 0&&await this.startedPromise;}finally{this.restoreLoggerChildOnce();}}restoreLoggerChildOnce(){this.loggerChildRestored||(this.restoreLoggerChild?.(),this.loggerChildRestored=true);}},l=class{builder=new ContextBuilder;routesReadyTimeoutMs;adapterOverrides=[];spyFactory;constructor(e){this.spyFactory=e?.fn??u,this.routesReadyTimeoutMs=e?.routesReadyTimeoutMs;}routesReadyTimeout(e){return this.routesReadyTimeoutMs=e,this}override(e){let r=m(e)?e.override:e;if(this.adapterOverrides.find(s=>s.target===r.target)!==void 0){let s=E(r.target);throw new Error(`testContext().override(): duplicate override for ${s}. Each target may only be registered once; remove the redundant override() call.`)}return this.adapterOverrides.push(r),this}with(e){return this.builder.with(e),this}on(e,r){return this.builder.on(e,r),this}once(e,r){return this.builder.once(e,r),this}store(e,r){return this.builder.store(e,r),this}routes(e){return this.builder.routes(e),this}async build(){let e=f(this.spyFactory),r=logger.child.bind(logger),o=this.spyFactory();o.mockImplementation(()=>e),logger.child=o;let s;try{s=await this.builder.build();}catch(d){throw logger.child=r,d}let{context:n,client:i}=s;if(this.adapterOverrides.length>0){let d=n.getStore(RC_ADAPTER_OVERRIDES)??[];n.setStore(RC_ADAPTER_OVERRIDES,[...d,...this.adapterOverrides]);}let a={...this.routesReadyTimeoutMs!==void 0?{routesReadyTimeoutMs:this.routesReadyTimeoutMs}:{},spyLogger:e,restoreLoggerChild:()=>{logger.child=r;}};return new p(n,i,a)}};function M(t){return new l(t)}function S(){return t=>(t.ready(),Promise.resolve())}function v(t,e){let r=()=>{throw new Error(`Pseudo adapter "${t}" is not implemented. Replace with a real adapter.`)},o=()=>Promise.resolve(),s=()=>Promise.resolve(void 0),n=a=>a,i=S();return {adapterId:`routecraft.adapter.pseudo.${t}`,subscribe:e==="noop"?i:r,send:e==="noop"?o:r,fetch:e==="noop"?s:r,process:e==="noop"?n:r}}function L(t="pseudo",e){let r=e?.runtime??"throw";return e&&"args"in e&&e.args==="keyed"?(s,n)=>v(t,r):s=>v(t,r)}function T(){return {received:[],calls:{send:0,process:0,enrich:0}}}function I(){let t=T();return {adapterId:"routecraft.adapter.spy",received:t.received,calls:t.calls,send(e){t.received.push(e),t.calls.send++;},fetch(e){return t.received.push(e),t.calls.enrich++,e.body},process(e){return t.received.push(e),t.calls.process++,e},reset(){t.received.length=0,t.calls.send=0,t.calls.process=0,t.calls.enrich=0;},lastReceived(){if(t.received.length===0)throw new Error("SpyAdapter: no exchanges recorded");return t.received[t.received.length-1]},receivedBodies(){return t.received.map(e=>e.body)}}}function K(t,e){return e===void 0?{[SOURCE_FIXTURE]:true,body:t}:{[SOURCE_FIXTURE]:true,body:t,headers:e}}async function N(t,e,r={}){let o=t.input["~standard"];if(typeof o?.validate!="function")throw rcError("RC5003",void 0,{message:"testFn: spec.input must be a Standard Schema with a callable validate."});let s=o.validate,n=s(e);if(n instanceof Promise&&(n=await n),n.issues!==void 0&&n.issues!==null)throw rcError("RC5002",void 0,{message:`testFn: input validation failed: ${formatSchemaIssues(n.issues)}`});let i={logger:r.logger??logger.child({test:"fn"}),abortSignal:r.signal??new AbortController().signal},a="value"in n?n.value:e;return await t.handler(a,i)}function H(t){let e=t.abortController??new AbortController;return {context:t.context,signal:e.signal,meta:t.meta??{routeId:"test"},ready:t.onReady??(()=>{}),complete:r=>e.abort(r),emit:async r=>await t.handler(r.message,r.headers,r.parse,r.parseFailureMode)}}function $(t){return JSON.parse(readFileSync(t,"utf-8"))}function de(t,e,r){let o=$(t);if(!Array.isArray(o))throw new Error(`fixture.each: expected JSON array at "${t}", got ${typeof o}`);for(let s of o){if(typeof s?.name!="string")throw new Error(`fixture.each: each entry must have a "name" field (string). Got: ${JSON.stringify(s)}`);e(s.name,()=>r(s));}}export{p as TestContext,l as TestContextBuilder,g as createNoopSpyLogger,u as createSpyFn,f as createSpyLogger,$ as fixture,de as fixtureEach,F as mockAdapter,L as pseudo,K as sourceMessage,I as spy,M as testContext,N as testFn,H as testSubscription};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/spy-logger.ts","../src/mock-adapter.ts","../src/test-context.ts","../src/adapters/pseudo/index.ts","../src/adapters/spy/shared.ts","../src/adapters/spy/index.ts","../src/test-fn.ts","../src/index.ts"],"names":["createSpyLogger","spy","vi","createNoopSpyLogger","noop","childFn","noopLogger","ADAPTER_MOCK_BRAND","isAdapterMock","value","mockAdapter","target","behavior","override","DEFAULT_ROUTES_READY_TIMEOUT_MS","describeOverrideTarget","TestContext","ctx","client","options","pushError","err","isRoutecraftError","rcError","payload","total","resolve","reject","ready","settled","timeoutId","cleanup","offRouteStarted","offError","allReady","started","delayMs","TestContextBuilder","ContextBuilder","ms","mock","entry","o","name","config","event","handler","key","routes","spyLogger","originalChild","logger","existing","RC_ADAPTER_OVERRIDES","testContext","createAdapter","runtime","fail","noopSend","noopProcess","exchange","noopSubscribe","_context","_handler","_abortController","onReady","pseudo","opts","createSpyState","state","HeadersKeys","testFn","spec","input","standard","validate","result","formatSchemaIssues","defaultLogger","validated","fixture","path","readFileSync","fixtureEach","run","entries","test"],"mappings":"oMAeO,SAASA,CAAAA,EAA6B,CAC3C,IAAMC,CAAAA,CAAiB,CACrB,IAAA,CAAMC,EAAAA,CAAG,EAAA,EAAG,CACZ,KAAA,CAAOA,EAAAA,CAAG,IAAG,CACb,IAAA,CAAMA,EAAAA,CAAG,EAAA,EAAG,CACZ,KAAA,CAAOA,EAAAA,CAAG,EAAA,GACV,KAAA,CAAOA,EAAAA,CAAG,EAAA,EAAG,CACb,KAAA,CAAOA,EAAAA,CAAG,EAAA,EAAG,CACb,MAAOA,EAAAA,CAAG,EAAA,EACZ,CAAA,CACA,OAAAD,CAAAA,CAAI,KAAA,CAAM,kBAAA,CAAmB,IAAMA,CAAG,CAAA,CAC/BA,CACT,CAEO,SAASE,CAAAA,EAAiC,CAC/C,IAAMC,CAAAA,CAAOF,EAAAA,CAAG,EAAA,EAAG,CACbG,CAAAA,CAAUH,EAAAA,CAAG,EAAA,EAAG,CAChBI,EAAwB,CAC5B,IAAA,CAAMF,CAAAA,CACN,KAAA,CAAOA,CAAAA,CACP,IAAA,CAAMA,CAAAA,CACN,KAAA,CAAOA,EACP,KAAA,CAAOA,CAAAA,CACP,KAAA,CAAOA,CAAAA,CACP,KAAA,CAAOC,CACT,CAAA,CACA,OAAAA,EAAQ,kBAAA,CAAmB,IAAMC,CAAU,CAAA,CACpCA,CACT,CCvBO,IAAMC,CAAAA,CAAoC,OAAO,GAAA,CACtD,iCACF,CAAA,CAgEO,SAASC,CAAAA,CACdC,CAAAA,CACsB,CACtB,OACE,OAAOA,CAAAA,EAAU,QAAA,EACjBA,CAAAA,GAAU,IAAA,EACTA,CAAAA,CAA6CF,CAAkB,CAAA,GAAM,IAE1E,CAmDO,SAASG,CAAAA,CAKdC,CAAAA,CAAWC,CAAAA,CAA+C,CAC1D,IAAMC,CAAAA,CAA4B,CAChC,OAAAF,CAAAA,CACA,KAAA,CAAO,CAAE,MAAA,CAAQ,EAAC,CAAG,IAAA,CAAM,EAAG,CAChC,CAAA,CACA,OAAIC,CAAAA,CAAS,MAAA,GAAW,MAAA,GACtBC,CAAAA,CAAS,OAASD,CAAAA,CAAS,MAAA,CAAA,CAEzBA,CAAAA,CAAS,IAAA,GAAS,MAAA,GACpBC,CAAAA,CAAS,IAAA,CAAOD,CAAAA,CAAS,MAEpB,CACL,CAACL,CAAkB,EAAG,IAAA,CACtB,QAAA,CAAAM,CAAAA,CACA,IAAI,OAAQ,CAIV,OAAO,CACL,MAAA,CAAQ,CAAC,GAAGA,CAAAA,CAAS,KAAA,CAAM,MAAM,CAAA,CACjC,IAAA,CAAM,CAAC,GAAGA,CAAAA,CAAS,KAAA,CAAM,IAAI,CAC/B,CACF,CACF,CACF,CCtJA,IAAMC,CAAAA,CAAkC,GAAA,CAExC,SAASC,CAAAA,CAAuBJ,EAAyB,CACvD,OAAI,OAAOA,CAAAA,EAAW,UAAA,EAAc,OAAOA,CAAAA,CAAO,IAAA,EAAS,SAKlD,CAAA,EAHL,QAAA,CAAS,IAAA,CAAKA,CAAAA,CAAO,IAAI,CAAA,EAAKA,CAAAA,CAAO,SAAA,GAAc,MAAA,CAC/C,OAAA,CACA,SACQ,CAAA,CAAA,EAAIA,CAAAA,CAAO,IAAA,EAAQ,aAAa,CAAA,CAAA,CAEzC,QACT,CAwBO,IAAMK,CAAAA,CAAN,KAAkB,CACd,GAAA,CAEA,MAAA,CAEA,MAAA,CACA,OAA4B,EAAC,CACrB,oBAAA,CAET,kBAAA,CACA,mBAAA,CAAsB,KAAA,CACtB,cAAA,CAER,WAAA,CACEC,EACAC,CAAAA,CACAC,CAAAA,CAIA,CACA,IAAA,CAAK,GAAA,CAAMF,CAAAA,CACX,IAAA,CAAK,MAAA,CAASC,EACd,IAAA,CAAK,MAAA,CAASC,CAAAA,EAAS,SAAA,EAAahB,CAAAA,EAAoB,CACpDgB,CAAAA,EAAS,kBAAA,GACX,KAAK,kBAAA,CAAqBA,CAAAA,CAAQ,kBAAA,CAAA,CACpC,IAAA,CAAK,oBAAA,CACHA,CAAAA,EAAS,oBAAA,EAAwBL,CAAAA,CACnC,IAAMM,CAAAA,CAAaC,CAAAA,EAAiB,CAClC,IAAA,CAAK,MAAA,CAAO,IAAA,CACVC,iBAAAA,CAAkBD,CAAG,EAChBA,CAAAA,CACDE,OAAAA,CAAQ,QAAA,CAAUF,CAAG,CAC3B,EACF,CAAA,CACAJ,CAAAA,CAAI,EAAA,CAAG,eAAA,CAAkBO,CAAAA,EAAY,CACnCJ,CAAAA,CAAUI,CAAAA,CAAQ,OAAA,CAAQ,KAAK,EACjC,CAAC,EACH,CAOQ,gBAAA,EAAkC,CACxC,IAAMP,CAAAA,CAAM,IAAA,CAAK,IACXQ,CAAAA,CAAQR,CAAAA,CAAI,SAAA,EAAU,CAAE,MAAA,CAC9B,OAAIQ,CAAAA,GAAU,CAAA,CAAU,QAAQ,OAAA,EAAQ,CACjC,IAAI,OAAA,CAAc,CAACC,CAAAA,CAASC,CAAAA,GAAW,CAC5C,IAAIC,CAAAA,CAAQ,CAAA,CACRC,CAAAA,CAAU,KAAA,CACVC,CAAAA,CAAuD,UAAA,CACzD,IAAM,CACAD,IACJE,CAAAA,EAAQ,CACRJ,CAAAA,CAAO,IAAI,KAAA,CAAM,qCAAqC,CAAC,CAAA,EACzD,EACA,IAAA,CAAK,oBACP,CAAA,CAEMK,CAAAA,CAAkBf,CAAAA,CAAI,EAAA,CAC1B,iBAAA,EACC,IAAM,CACDY,CAAAA,GACJD,CAAAA,EAAAA,CACIA,CAAAA,EAASH,CAAAA,GACXM,CAAAA,EAAQ,CACRL,CAAAA,EAAQ,CAAA,EAEZ,CAAA,EACF,CACMO,CAAAA,CAAWhB,CAAAA,CAAI,EAAA,CAAG,eAAA,CAAkBO,CAAAA,EAAY,CAChDK,IACJE,CAAAA,EAAQ,CACRJ,CAAAA,CAAOH,CAAAA,CAAQ,OAAA,CAAQ,KAAK,CAAA,EAC9B,CAAC,EAED,SAASO,CAAAA,EAAgB,CACnBF,CAAAA,GACJA,CAAAA,CAAU,IAAA,CACVG,CAAAA,EAAgB,CAChBC,GAAS,CACLH,CAAAA,GAAc,MAAA,GAChB,YAAA,CAAaA,CAAS,CAAA,CACtBA,CAAAA,CAAY,MAAA,CAAA,EAEhB,CACF,CAAC,CACH,CAoBA,MAAM,iBAAA,EAAmC,CACvC,IAAMI,CAAAA,CAAW,KAAK,gBAAA,EAAiB,CACvC,IAAA,CAAK,cAAA,CAAiB,IAAA,CAAK,GAAA,CAAI,KAAA,EAAM,CAGrC,KAAK,cAAA,CAAe,KAAA,CAAM,IAAM,CAAC,CAAC,CAAA,CAClC,MAAMA,EACR,CASA,MAAM,IAAA,CAAKf,CAAAA,CAAsC,CAC/C,IAAMF,CAAAA,CAAM,IAAA,CAAK,GAAA,CACXiB,CAAAA,CAAW,IAAA,CAAK,gBAAA,EAAiB,CACjCC,CAAAA,CAAUlB,CAAAA,CAAI,KAAA,EAAM,CAG1BkB,EAAQ,KAAA,CAAM,IAAM,CAAC,CAAC,CAAA,CACtB,GAAI,CACF,MAAMD,EACN,IAAME,CAAAA,CAAUjB,CAAAA,EAAS,kBAAA,EAAsB,CAAA,CAC3CiB,CAAAA,CAAU,CAAA,EACZ,MAAM,IAAI,OAAA,CAASV,CAAAA,EAAY,UAAA,CAAWA,CAAAA,CAASU,CAAO,CAAC,CAAA,CAE7D,MAAMnB,EAAI,KAAA,GACZ,CAAA,OAAE,CACA,GAAI,CACF,MAAMA,CAAAA,CAAI,MAAK,CACf,MAAMkB,EACR,CAAA,OAAE,CACA,IAAA,CAAK,sBAAA,GACP,CACF,CACF,CAEA,KAAA,EAAuB,CACrB,OAAO,IAAA,CAAK,GAAA,CAAI,KAAA,EAClB,CAEA,MAAM,IAAA,EAAsB,CAC1B,GAAI,CACF,MAAM,IAAA,CAAK,IAAI,IAAA,EAAK,CAChB,IAAA,CAAK,cAAA,GAAmB,KAAA,CAAA,EAC1B,MAAM,IAAA,CAAK,eAEf,QAAE,CACA,IAAA,CAAK,sBAAA,GACP,CACF,CAEQ,sBAAA,EAA+B,CACjC,KAAK,mBAAA,GACT,IAAA,CAAK,kBAAA,IAAqB,CAC1B,IAAA,CAAK,mBAAA,CAAsB,IAAA,EAC7B,CACF,EAMaE,CAAAA,CAAN,KAAyB,CACtB,OAAA,CAAU,IAAIC,cAAAA,CACd,oBAAA,CACA,gBAAA,CAAsC,EAAC,CAG/C,kBAAA,CAAmBC,CAAAA,CAAkB,CACnC,OAAA,IAAA,CAAK,oBAAA,CAAuBA,CAAAA,CACrB,IACT,CAQA,QAAA,CAASC,CAAAA,CAA2C,CAClD,IAAMC,CAAAA,CAAyBjC,CAAAA,CAAcgC,CAAI,CAAA,CAAIA,EAAK,QAAA,CAAWA,CAAAA,CAQrE,GAHkB,IAAA,CAAK,gBAAA,CAAiB,IAAA,CACrCE,CAAAA,EAAMA,CAAAA,CAAE,SAAWD,CAAAA,CAAM,MAC5B,CAAA,GACkB,MAAA,CAAW,CAC3B,IAAME,CAAAA,CAAO5B,CAAAA,CAAuB0B,CAAAA,CAAM,MAAM,CAAA,CAChD,MAAM,IAAI,KAAA,CACR,CAAA,iDAAA,EAAoDE,CAAI,kFAC1D,CACF,CACA,OAAA,IAAA,CAAK,gBAAA,CAAiB,IAAA,CAAKF,CAAK,CAAA,CACzB,IACT,CAEA,IAAA,CAAKG,CAAAA,CAA2B,CAC9B,OAAA,IAAA,CAAK,OAAA,CAAQ,IAAA,CAAKA,CAAM,CAAA,CACjB,IACT,CAEA,EAAA,CAAwBC,CAAAA,CAAUC,CAAAA,CAAgC,CAChE,OAAA,IAAA,CAAK,OAAA,CAAQ,EAAA,CAAGD,EAAOC,CAAO,CAAA,CACvB,IACT,CAEA,IAAA,CAA0BD,CAAAA,CAAUC,CAAAA,CAAgC,CAClE,YAAK,OAAA,CAAQ,IAAA,CAAKD,CAAAA,CAAOC,CAAO,CAAA,CACzB,IACT,CAEA,KAAA,CAAqCC,EAAQtC,CAAAA,CAA+B,CAC1E,OAAA,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAMsC,CAAAA,CAAKtC,CAAK,CAAA,CACtB,IACT,CAEA,MAAA,CACEuC,CAAAA,CAKM,CACN,OAAA,IAAA,CAAK,OAAA,CAAQ,MAAA,CAAOA,CAAM,CAAA,CACnB,IACT,CAEA,MAAM,KAAA,EAA8B,CAClC,IAAMC,CAAAA,CAAYjD,GAAgB,CAC5BkD,CAAAA,CAAgBC,MAAAA,CAAO,KAAA,CAAM,IAAA,CAAKA,MAAM,CAAA,CAC9CA,MAAAA,CAAO,MAAQjD,EAAAA,CAAG,EAAA,CAChB,IAAM+C,CACR,CAAA,CACA,GAAM,CAAE,OAAA,CAAShC,EAAK,MAAA,CAAAC,CAAO,CAAA,CAAI,MAAM,IAAA,CAAK,OAAA,CAAQ,KAAA,EAAM,CAI1D,GAAI,IAAA,CAAK,gBAAA,CAAiB,MAAA,CAAS,CAAA,CAAG,CACpC,IAAMkC,CAAAA,CAAWnC,CAAAA,CAAI,SAASoC,oBAAoB,CAAA,EAAK,EAAC,CACxDpC,CAAAA,CAAI,QAAA,CAASoC,oBAAAA,CAAsB,CACjC,GAAGD,CAAAA,CACH,GAAG,IAAA,CAAK,gBACV,CAAC,EACH,CAEA,IAAMjC,EAGF,CACF,GAAI,IAAA,CAAK,oBAAA,GAAyB,MAAA,CAC9B,CAAE,oBAAA,CAAsB,IAAA,CAAK,oBAAqB,CAAA,CAClD,EAAC,CACL,SAAA,CAAA8B,CAAAA,CACA,kBAAA,CAAoB,IAAM,CACxBE,MAAAA,CAAO,KAAA,CAAQD,EACjB,CACF,CAAA,CACA,OAAO,IAAIlC,CAAAA,CAAYC,EAAKC,CAAAA,CAAQC,CAAO,CAC7C,CACF,EAUO,SAASmC,CAAAA,EAAkC,CAChD,OAAO,IAAIjB,CACb,CClUA,SAASkB,CAAAA,CACPZ,CAAAA,CACAa,CAAAA,CACkB,CAClB,IAAMC,CAAAA,CAAO,IAAa,CACxB,MAAM,IAAI,KAAA,CACR,CAAA,gBAAA,EAAmBd,CAAI,oDACzB,CACF,CAAA,CACMe,CAAAA,CAAW,IAAkB,OAAA,CAAQ,OAAA,CAAQ,MAAyB,CAAA,CACtEC,EAAeC,CAAAA,EAA+BA,CAAAA,CAC9CC,CAAAA,CAAgB,CACpBC,CAAAA,CACAC,CAAAA,CACAC,CAAAA,CACAC,CAAAA,IAEAA,KAAU,CACH,OAAA,CAAQ,OAAA,EAAQ,CAAA,CAOzB,OAAO,CACL,SAAA,CAAW,CAAA,0BAAA,EAA6BtB,CAAI,CAAA,CAAA,CAC5C,SAAA,CACEa,CAAAA,GAAY,MAAA,CACPK,CAAAA,CACAJ,CAAAA,CACP,IAAA,CAAMD,CAAAA,GAAY,OAAUE,CAAAA,CAAuBD,CAAAA,CACnD,OAAA,CACED,CAAAA,GAAY,MAAA,CAAUG,CAAAA,CAA6BF,CACvD,CACF,CAgBO,SAASS,CAAAA,CAGdvB,CAAAA,CAAO,QAAA,CACPxB,CAAAA,CACgD,CAChD,IAAMqC,CAAAA,CAAUrC,GAAS,OAAA,EAAW,OAAA,CAGpC,OAFgBA,CAAAA,EAAW,MAAA,GAAUA,CAAAA,EAAWA,CAAAA,CAAQ,IAAA,GAAS,QAGxD,CAAc4B,CAAAA,CAAaoB,CAAAA,GAGzBZ,CAAAA,CAAiBZ,CAAAA,CAAMa,CAAO,CAAA,CAGpBW,CAAAA,EAEZZ,EAAiBZ,CAAAA,CAAMa,CAAO,CAEzC,CCjFO,SAASY,CAAAA,EAAiC,CAC/C,OAAO,CACL,QAAA,CAAU,EAAC,CACX,KAAA,CAAO,CAAE,IAAA,CAAM,CAAA,CAAG,OAAA,CAAS,CAAA,CAAG,MAAA,CAAQ,CAAE,CAC1C,CACF,CCsCO,SAASnE,CAAAA,EAAkC,CAChD,IAAMoE,CAAAA,CAAQD,CAAAA,EAAkB,CAEhC,OAAO,CACL,SAAA,CAAW,wBAAA,CACX,QAAA,CAAUC,CAAAA,CAAM,QAAA,CAChB,KAAA,CAAOA,CAAAA,CAAM,MAEb,IAAA,CAAKT,CAAAA,CAA6B,CAChCS,CAAAA,CAAM,QAAA,CAAS,IAAA,CAAKT,CAAQ,CAAA,CAEVA,EAAS,OAAA,GAAUU,WAAAA,CAAY,SAAS,CAAA,GACxC,QAAA,CAChBD,CAAAA,CAAM,KAAA,CAAM,MAAA,EAAA,CAEZA,EAAM,KAAA,CAAM,IAAA,GAEhB,CAAA,CAEA,OAAA,CAAQT,CAAAA,CAAoC,CAC1C,OAAAS,CAAAA,CAAM,SAAS,IAAA,CAAKT,CAAQ,CAAA,CAC5BS,CAAAA,CAAM,KAAA,CAAM,OAAA,EAAA,CACLT,CACT,CAAA,CAEA,OAAc,CACZS,CAAAA,CAAM,QAAA,CAAS,MAAA,CAAS,CAAA,CACxBA,CAAAA,CAAM,KAAA,CAAM,IAAA,CAAO,EACnBA,CAAAA,CAAM,KAAA,CAAM,OAAA,CAAU,CAAA,CACtBA,CAAAA,CAAM,KAAA,CAAM,MAAA,CAAS,EACvB,CAAA,CAEA,YAAA,EAA4B,CAC1B,GAAIA,CAAAA,CAAM,QAAA,CAAS,MAAA,GAAW,CAAA,CAC5B,MAAM,IAAI,KAAA,CAAM,mCAAmC,CAAA,CAErD,OAAOA,CAAAA,CAAM,QAAA,CAASA,CAAAA,CAAM,SAAS,MAAA,CAAS,CAAC,CACjD,CAAA,CAEA,cAAA,EAAsB,CACpB,OAAOA,CAAAA,CAAM,SAAS,GAAA,CAAK,CAAA,EAAM,CAAA,CAAE,IAAI,CACzC,CACF,CACF,CCjCA,eAAsBE,EACpBC,CAAAA,CACAC,CAAAA,CACAtD,CAAAA,CAAyB,EAAC,CACX,CACf,IAAMuD,CAAAA,CAAYF,EAAK,KAAA,CACrB,WACF,CAAA,CACA,GAAI,OAAOE,CAAAA,EAAU,QAAA,EAAa,UAAA,CAChC,MAAMnD,OAAAA,CAAQ,QAAA,CAAU,MAAA,CAAW,CACjC,OAAA,CAAS,wEACX,CAAC,CAAA,CAGH,IAAMoD,CAAAA,CAAWD,CAAAA,CAAS,QAAA,CAKtBE,CAAAA,CAASD,CAAAA,CAASF,CAAK,CAAA,CAE3B,GADIG,CAAAA,YAAkB,OAAA,GAASA,CAAAA,CAAS,MAAMA,CAAAA,CAAAA,CAC1CA,CAAAA,CAAO,MAAA,GAAW,MAAA,EAAaA,EAAO,MAAA,GAAW,IAAA,CACnD,MAAMrD,OAAAA,CAAQ,QAAA,CAAU,MAAA,CAAW,CACjC,OAAA,CAAS,oCAAoCsD,kBAAAA,CAAmBD,CAAAA,CAAO,MAAM,CAAC,CAAA,CAChF,CAAC,CAAA,CAGH,IAAM3D,EAA4B,CAChC,MAAA,CAAQE,CAAAA,CAAQ,MAAA,EAAU2D,MAAAA,CAAc,KAAA,CAAM,CAAE,IAAA,CAAM,IAAK,CAAC,CAAA,CAC5D,WAAA,CAAa3D,CAAAA,CAAQ,MAAA,EAAU,IAAI,eAAA,EAAgB,CAAE,MACvD,CAAA,CAEM4D,CAAAA,CAAY,OAAA,GAAWH,CAAAA,CAAUA,CAAAA,CAAO,KAAA,CAAiBH,CAAAA,CAC/D,OAAQ,MAAMD,CAAAA,CAAK,OAAA,CAAQO,CAAAA,CAAW9D,CAAG,CAC3C,CChDO,SAAS+D,CAAAA,CAAqBC,EAAiB,CACpD,OAAO,IAAA,CAAK,KAAA,CAAMC,YAAAA,CAAaD,CAAAA,CAAM,OAAO,CAAC,CAC/C,CAgBO,SAASE,EAAAA,CACdF,CAAAA,CACAG,CAAAA,CACM,CACN,IAAMC,CAAAA,CAAUL,EAAaC,CAAI,CAAA,CACjC,GAAI,CAAC,KAAA,CAAM,OAAA,CAAQI,CAAO,CAAA,CACxB,MAAM,IAAI,KAAA,CACR,CAAA,sCAAA,EAAyCJ,CAAI,CAAA,OAAA,EAAU,OAAOI,CAAO,CAAA,CACvE,EAEF,IAAA,IAAW5C,CAAAA,IAAS4C,CAAAA,CAAS,CAC3B,GAAI,OAAO5C,CAAAA,EAAO,IAAA,EAAS,SACzB,MAAM,IAAI,KAAA,CACR,CAAA,iEAAA,EAAoE,IAAA,CAAK,SAAA,CAAUA,CAAK,CAAC,EAC3F,CAAA,CAEF6C,IAAAA,CAAK7C,CAAAA,CAAM,IAAA,CAAM,IAAM2C,CAAAA,CAAI3C,CAAK,CAAC,EACnC,CACF","file":"index.js","sourcesContent":["import { vi } from \"vitest\";\n\n/**\n * Spy logger with vi.fn() methods for assertions (e.g. expect(t.logger.info).toHaveBeenCalledWith(...)).\n */\nexport type SpyLogger = {\n  info: ReturnType<typeof vi.fn>;\n  debug: ReturnType<typeof vi.fn>;\n  warn: ReturnType<typeof vi.fn>;\n  error: ReturnType<typeof vi.fn>;\n  trace: ReturnType<typeof vi.fn>;\n  fatal: ReturnType<typeof vi.fn>;\n  child: ReturnType<typeof vi.fn>;\n};\n\nexport function createSpyLogger(): SpyLogger {\n  const spy: SpyLogger = {\n    info: vi.fn(),\n    debug: vi.fn(),\n    warn: vi.fn(),\n    error: vi.fn(),\n    trace: vi.fn(),\n    fatal: vi.fn(),\n    child: vi.fn(),\n  };\n  spy.child.mockImplementation(() => spy);\n  return spy;\n}\n\nexport function createNoopSpyLogger(): SpyLogger {\n  const noop = vi.fn();\n  const childFn = vi.fn();\n  const noopLogger: SpyLogger = {\n    info: noop,\n    debug: noop,\n    warn: noop,\n    error: noop,\n    trace: noop,\n    fatal: noop,\n    child: childFn,\n  };\n  childFn.mockImplementation(() => noopLogger);\n  return noopLogger;\n}\n","import type {\n  AdapterOverride,\n  AdapterSendCall,\n  AdapterSourceCall,\n  SendOverrideHandler,\n  Source,\n  SourceOverrideBehavior,\n} from \"@routecraft/routecraft\";\n\n/**\n * Brand symbol stamped on the handles returned by `mockAdapter()`.\n *\n * `testContext().override()` uses this symbol to distinguish a mock handle\n * from a raw `AdapterOverride` (both objects carry a `calls` field, so a\n * structural check on a non-branded key would be fragile).\n *\n * Use `Symbol.for` so cross-realm / multi-package-load equality holds.\n *\n * @internal\n */\nexport const ADAPTER_MOCK_BRAND: unique symbol = Symbol.for(\n  \"routecraft.testing.adapter-mock\",\n);\n\n/**\n * Extract the message type `M` from an adapter factory or adapter class,\n * so `mockAdapter(target, { source: [...] })` can check fixtures against\n * the real adapter shape. Falls back to `unknown` when `target` has no\n * inferable Source role (e.g. destination-only factories, or overloaded\n * factories where TypeScript cannot pick the source overload).\n */\ntype InferAdapterMessage<T> = T extends new (...args: never[]) => infer I\n  ? I extends Source<infer M>\n    ? M\n    : unknown\n  : T extends (...args: never[]) => infer R\n    ? R extends Source<infer M>\n      ? M\n      : unknown\n    : unknown;\n\n/**\n * Behaviour description for a mock adapter. A mock may stub the source side,\n * the destination side, or both. The framework picks the matching behaviour\n * based on the call site's role in the route.\n */\nexport interface MockAdapterBehavior<M = unknown> {\n  /**\n   * Source-role behaviour. Used when the adapter is the `.from()` of a route.\n   * Pass an array of fixtures, an async iterable, or a callable that receives\n   * the construction args and returns the stream to emit.\n   */\n  source?: SourceOverrideBehavior<M>;\n  /**\n   * Destination-role behaviour. Used when the adapter is passed to `.to()`,\n   * `.enrich()`, or `.tap()`. Receives the exchange and a meta object with\n   * the construction args; returning a value replaces the body upstream.\n   */\n  send?: SendOverrideHandler;\n}\n\n/**\n * Handle returned by `mockAdapter(factory, behaviour)`. Carries the resolved\n * override the framework should install on the context, plus `calls` for\n * assertions.\n */\nexport interface AdapterMock {\n  /** Brand used by `testContext().override()` to discriminate handles from raw overrides. */\n  readonly [ADAPTER_MOCK_BRAND]: true;\n  readonly override: AdapterOverride;\n  /**\n   * Recorded calls, populated as the route runs. Assert on these after\n   * awaiting `t.test()`.\n   */\n  readonly calls: {\n    source: readonly AdapterSourceCall[];\n    send: readonly AdapterSendCall[];\n  };\n}\n\n/**\n * Type guard that distinguishes an `AdapterMock` (handle returned by\n * `mockAdapter()`) from a raw `AdapterOverride` value.\n *\n * @internal\n */\nexport function isAdapterMock(\n  value: AdapterMock | AdapterOverride,\n): value is AdapterMock {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as { [ADAPTER_MOCK_BRAND]?: unknown })[ADAPTER_MOCK_BRAND] === true\n  );\n}\n\n/**\n * Create a mock for an adapter. The `target` may be either:\n *\n * - An adapter factory (e.g. `mail`, `http`, `mcp`). The mock matches every\n *   adapter instance produced by that factory. Requires the factory to stamp\n *   its adapters via `tagAdapter()`.\n * - An adapter class (e.g. `MailSourceAdapter`, `HttpDestinationAdapter`).\n *   The mock matches any adapter whose `constructor === target`. Works for\n *   every adapter without opt-in tagging, including third-party ones.\n *\n * Pass the result to `testContext().override(mock)` and run the route\n * under test as-is; the framework invokes the mock's `source` / `send`\n * handlers in place of the real adapter at every matching call site.\n *\n * @param target - The adapter factory or adapter class to intercept\n * @param behavior - Source and/or destination-role handlers\n * @returns A handle with `calls` for assertions and an internal `override`\n *\n * @example\n * ```ts\n * // Factory form (preferred for single-role factories)\n * import { http, mail } from \"@routecraft/routecraft\";\n * import { mockAdapter, testContext } from \"@routecraft/testing\";\n *\n * const httpMock = mockAdapter(http, {\n *   send: async () => ({ status: 200, body: { ok: true } }),\n * });\n *\n * const mailMock = mockAdapter(mail, {\n *   source: [{ uid: 1, from: \"a@b\", subject: \"hi\", ... }],\n *   send: async () => ({ messageId: \"<fake>\" }),\n * });\n *\n * // Class form (works for any adapter, including third-party ones)\n * import { SomeAdapterClass } from \"third-party-adapter\";\n *\n * const thirdPartyMock = mockAdapter(SomeAdapterClass, {\n *   send: async () => ({ ok: true }),\n * });\n *\n * const t = await testContext()\n *   .override(httpMock)\n *   .override(mailMock)\n *   .override(thirdPartyMock)\n *   .routes(route)\n *   .build();\n * await t.test();\n * ```\n */\nexport function mockAdapter<\n  T extends\n    | ((...args: never[]) => unknown)\n    | (new (...args: never[]) => unknown),\n  M = InferAdapterMessage<T>,\n>(target: T, behavior: MockAdapterBehavior<M>): AdapterMock {\n  const override: AdapterOverride = {\n    target,\n    calls: { source: [], send: [] },\n  };\n  if (behavior.source !== undefined) {\n    override.source = behavior.source as SourceOverrideBehavior;\n  }\n  if (behavior.send !== undefined) {\n    override.send = behavior.send;\n  }\n  return {\n    [ADAPTER_MOCK_BRAND]: true,\n    override,\n    get calls() {\n      // Snapshot the live arrays so the `readonly` contract on AdapterMock.calls\n      // is honoured at runtime (users cannot mutate the recorded calls via\n      // the returned reference).\n      return {\n        source: [...override.calls.source],\n        send: [...override.calls.send],\n      };\n    },\n  };\n}\n","import { vi } from \"vitest\";\nimport type {\n  CraftContext,\n  CraftConfig,\n  StoreRegistry,\n  EventName,\n  EventHandler,\n  RouteDefinition,\n  RouteBuilder,\n  AdapterOverride,\n} from \"@routecraft/routecraft\";\nimport {\n  ContextBuilder,\n  CraftClient,\n  isRoutecraftError,\n  RoutecraftError,\n  rcError,\n  logger,\n  RC_ADAPTER_OVERRIDES,\n} from \"@routecraft/routecraft\";\nimport type { SpyLogger } from \"./spy-logger\";\nimport { createSpyLogger, createNoopSpyLogger } from \"./spy-logger\";\nimport { isAdapterMock, type AdapterMock } from \"./mock-adapter\";\n\nconst DEFAULT_ROUTES_READY_TIMEOUT_MS = 200;\n\nfunction describeOverrideTarget(target: unknown): string {\n  if (typeof target === \"function\" && typeof target.name === \"string\") {\n    const kind =\n      /^[A-Z]/.test(target.name) && target.prototype !== undefined\n        ? \"class\"\n        : \"factory\";\n    return `${kind} ${target.name || \"<anonymous>\"}`;\n  }\n  return \"target\";\n}\n\nexport interface TestContextOptions {\n  /** Timeout in ms for waiting for all routes to emit routeStarted. Default 200. */\n  routesReadyTimeoutMs?: number;\n}\n\n/**\n * Options for TestContext.test().\n */\nexport interface TestOptions {\n  /**\n   * Delay in ms after all routes are ready, before draining.\n   * Use for timer (or other deferred) sources so at least one message is processed before drain/stop.\n   * E.g. `await t.test({ delayBeforeDrainMs: 50 })` for a timer with intervalMs >= 50.\n   */\n  delayBeforeDrainMs?: number;\n}\n\n/**\n * Test-friendly wrapper around CraftContext. Runs the real context but manages\n * lifecycle (start, wait routes ready, drain, stop) and collects errors.\n * t.logger is a spy logger (vi.fn() methods) for asserting on log calls.\n */\nexport class TestContext {\n  readonly ctx: CraftContext;\n  /** Client for dispatching messages to direct endpoints in tests. */\n  readonly client: CraftClient;\n  /** Spy logger; e.g. expect(t.logger.info).toHaveBeenCalledWith(...) */\n  readonly logger: SpyLogger;\n  readonly errors: RoutecraftError[] = [];\n  private readonly routesReadyTimeoutMs: number;\n\n  private restoreLoggerChild?: () => void;\n  private loggerChildRestored = false;\n  private startedPromise?: Promise<void>;\n\n  constructor(\n    ctx: CraftContext,\n    client: CraftClient,\n    options?: TestContextOptions & {\n      spyLogger?: SpyLogger;\n      restoreLoggerChild?: () => void;\n    },\n  ) {\n    this.ctx = ctx;\n    this.client = client;\n    this.logger = options?.spyLogger ?? createNoopSpyLogger();\n    if (options?.restoreLoggerChild)\n      this.restoreLoggerChild = options.restoreLoggerChild;\n    this.routesReadyTimeoutMs =\n      options?.routesReadyTimeoutMs ?? DEFAULT_ROUTES_READY_TIMEOUT_MS;\n    const pushError = (err: unknown) => {\n      this.errors.push(\n        isRoutecraftError(err)\n          ? (err as RoutecraftError)\n          : rcError(\"RC9901\", err),\n      );\n    };\n    ctx.on(\"context:error\", (payload) => {\n      pushError(payload.details.error);\n    });\n  }\n\n  /**\n   * Build a promise that resolves once every route has emitted\n   * `route:*:started`, or rejects on `context:error` or the configured\n   * routes-ready timeout. Shared by {@link startAndWaitReady} and {@link test}.\n   */\n  private awaitRoutesReady(): Promise<void> {\n    const ctx = this.ctx;\n    const total = ctx.getRoutes().length;\n    if (total === 0) return Promise.resolve();\n    return new Promise<void>((resolve, reject) => {\n      let ready = 0;\n      let settled = false;\n      let timeoutId: ReturnType<typeof setTimeout> | undefined = setTimeout(\n        () => {\n          if (settled) return;\n          cleanup();\n          reject(new Error(\"Timeout waiting for routes to start\"));\n        },\n        this.routesReadyTimeoutMs,\n      );\n\n      const offRouteStarted = ctx.on(\n        \"route:*:started\" as EventName,\n        (() => {\n          if (settled) return;\n          ready++;\n          if (ready >= total) {\n            cleanup();\n            resolve();\n          }\n        }) as EventHandler<EventName>,\n      );\n      const offError = ctx.on(\"context:error\", (payload) => {\n        if (settled) return;\n        cleanup();\n        reject(payload.details.error);\n      });\n\n      function cleanup(): void {\n        if (settled) return;\n        settled = true;\n        offRouteStarted();\n        offError();\n        if (timeoutId !== undefined) {\n          clearTimeout(timeoutId);\n          timeoutId = undefined;\n        }\n      }\n    });\n  }\n\n  /**\n   * Start context and resolve once every route has emitted `route:*:started`.\n   * Does not drain or stop. Does not await `ctx.start()` completion, which\n   * lets this method work with long-running sources (direct, mcp, HTTP, etc.)\n   * whose subscribe blocks until the route is aborted. The start promise is\n   * stored internally and awaited by {@link stop} for clean shutdown.\n   *\n   * Use with {@link CraftClient.send} (via `t.client`) for direct endpoints,\n   * or drive sources directly via the context store, then call `drain()` /\n   * `stop()` when done.\n   *\n   * If `ctx.start()` rejects (synchronously or before any route emits\n   * `route:*:started`), the rejection surfaces here via the\n   * `context:error` listener installed by `awaitRoutesReady`. A no-op\n   * catch is attached to `startedPromise` as a safety net so that a\n   * slow rejection does not trigger an `unhandledRejection` before\n   * `stop()` awaits the promise for teardown.\n   */\n  async startAndWaitReady(): Promise<void> {\n    const allReady = this.awaitRoutesReady();\n    this.startedPromise = this.ctx.start();\n    // Attach a no-op handler so Node does not report the rejection as\n    // unhandled before `stop()` re-awaits the promise.\n    this.startedPromise.catch(() => {});\n    await allReady;\n  }\n\n  /**\n   * Start context, wait for all routes ready, optionally delay, drain in-flight, then stop.\n   * Assert after this returns (mocks, t.errors, t.ctx.getStore() all valid).\n   *\n   * @param options.delayBeforeDrainMs If set, wait this many ms after routes are ready before draining.\n   *   Use for timer (or other deferred) sources so at least one message is processed before drain/stop.\n   */\n  async test(options?: TestOptions): Promise<void> {\n    const ctx = this.ctx;\n    const allReady = this.awaitRoutesReady();\n    const started = ctx.start();\n    // Shield a synchronous rejection of `started` from becoming an\n    // unhandled rejection before the `finally` block re-awaits it.\n    started.catch(() => {});\n    try {\n      await allReady;\n      const delayMs = options?.delayBeforeDrainMs ?? 0;\n      if (delayMs > 0) {\n        await new Promise((resolve) => setTimeout(resolve, delayMs));\n      }\n      await ctx.drain();\n    } finally {\n      try {\n        await ctx.stop();\n        await started;\n      } finally {\n        this.restoreLoggerChildOnce();\n      }\n    }\n  }\n\n  drain(): Promise<void> {\n    return this.ctx.drain();\n  }\n\n  async stop(): Promise<void> {\n    try {\n      await this.ctx.stop();\n      if (this.startedPromise !== undefined) {\n        await this.startedPromise;\n      }\n    } finally {\n      this.restoreLoggerChildOnce();\n    }\n  }\n\n  private restoreLoggerChildOnce(): void {\n    if (this.loggerChildRestored) return;\n    this.restoreLoggerChild?.();\n    this.loggerChildRestored = true;\n  }\n}\n\n/**\n * Builder that returns TestContext instead of CraftContext.\n * Same API as ContextBuilder (routes, on, with, store).\n */\nexport class TestContextBuilder {\n  private builder = new ContextBuilder();\n  private routesReadyTimeoutMs: number | undefined;\n  private adapterOverrides: AdapterOverride[] = [];\n\n  /** Override timeout for waiting for routes to start (ms). Used by tests that assert timeout behavior. */\n  routesReadyTimeout(ms: number): this {\n    this.routesReadyTimeoutMs = ms;\n    return this;\n  }\n\n  /**\n   * Register an adapter mock. At route execution time, calls to adapters\n   * produced by the same factory are routed through the mock's handlers\n   * instead of invoking the real adapter. Accepts either the handle returned\n   * by `mockAdapter()` or a raw `AdapterOverride`.\n   */\n  override(mock: AdapterMock | AdapterOverride): this {\n    const entry: AdapterOverride = isAdapterMock(mock) ? mock.override : mock;\n    // Fail fast if two overrides target the same factory/class. The framework\n    // uses first-match semantics at execution time, so silently accepting a\n    // duplicate would mean the second mock's assertions always see zero calls\n    // and the user has no signal that their new override is being shadowed.\n    const duplicate = this.adapterOverrides.find(\n      (o) => o.target === entry.target,\n    );\n    if (duplicate !== undefined) {\n      const name = describeOverrideTarget(entry.target);\n      throw new Error(\n        `testContext().override(): duplicate override for ${name}. Each target may only be registered once; remove the redundant override() call.`,\n      );\n    }\n    this.adapterOverrides.push(entry);\n    return this;\n  }\n\n  with(config: CraftConfig): this {\n    this.builder.with(config);\n    return this;\n  }\n\n  on<K extends EventName>(event: K, handler: EventHandler<K>): this {\n    this.builder.on(event, handler);\n    return this;\n  }\n\n  once<K extends EventName>(event: K, handler: EventHandler<K>): this {\n    this.builder.once(event, handler);\n    return this;\n  }\n\n  store<K extends keyof StoreRegistry>(key: K, value: StoreRegistry[K]): this {\n    this.builder.store(key, value);\n    return this;\n  }\n\n  routes(\n    routes:\n      | RouteDefinition[]\n      | RouteBuilder<unknown>[]\n      | RouteDefinition\n      | RouteBuilder<unknown>,\n  ): this {\n    this.builder.routes(routes);\n    return this;\n  }\n\n  async build(): Promise<TestContext> {\n    const spyLogger = createSpyLogger();\n    const originalChild = logger.child.bind(logger);\n    logger.child = vi.fn(\n      () => spyLogger as unknown as ReturnType<typeof logger.child>,\n    ) as typeof logger.child;\n    const { context: ctx, client } = await this.builder.build();\n\n    // Install registered adapter overrides onto the context store so that\n    // ToStep / EnrichStep / Route source can resolve them at execution time.\n    if (this.adapterOverrides.length > 0) {\n      const existing = ctx.getStore(RC_ADAPTER_OVERRIDES) ?? [];\n      ctx.setStore(RC_ADAPTER_OVERRIDES, [\n        ...existing,\n        ...this.adapterOverrides,\n      ]);\n    }\n\n    const options: TestContextOptions & {\n      spyLogger: SpyLogger;\n      restoreLoggerChild: () => void;\n    } = {\n      ...(this.routesReadyTimeoutMs !== undefined\n        ? { routesReadyTimeoutMs: this.routesReadyTimeoutMs }\n        : {}),\n      spyLogger,\n      restoreLoggerChild: () => {\n        logger.child = originalChild;\n      },\n    };\n    return new TestContext(ctx, client, options);\n  }\n}\n\n/**\n * Create a test context builder. Use .routes(...).build(), await the result, then await t.test().\n *\n * @example\n * const builder = testContext();\n * const t = await builder.routes(myRoutes).build();\n * await t.test();\n */\nexport function testContext(): TestContextBuilder {\n  return new TestContextBuilder();\n}\n","import type { Source, Destination, Processor } from \"@routecraft/routecraft\";\nimport type { PseudoOptions, PseudoKeyedOptions } from \"./shared\";\n\n/**\n * @internal\n */\n/* eslint-disable @typescript-eslint/no-explicit-any -- input position must accept any exchange for DSL assignability */\nexport type PseudoAdapter<R> = {\n  adapterId: string;\n} & Source<R> &\n  Destination<any, R> &\n  Processor<any, R>;\n/* eslint-enable @typescript-eslint/no-explicit-any */\n\n/** @internal */\nexport type PseudoFactory<Opts> = <R = unknown>(opts: Opts) => PseudoAdapter<R>;\n\n/** @internal */\nexport type PseudoKeyedFactory<Opts> = <R = unknown>(\n  key: string,\n  opts?: Opts,\n) => PseudoAdapter<R>;\n\nfunction createAdapter<R>(\n  name: string,\n  runtime: \"throw\" | \"noop\",\n): PseudoAdapter<R> {\n  const fail = (): never => {\n    throw new Error(\n      `Pseudo adapter \"${name}\" is not implemented. Replace with a real adapter.`,\n    );\n  };\n  const noopSend = (): Promise<R> => Promise.resolve(undefined as unknown as R);\n  const noopProcess = (exchange: unknown): unknown => exchange;\n  const noopSubscribe = (\n    _context: unknown,\n    _handler: unknown,\n    _abortController: unknown,\n    onReady?: () => void,\n  ): Promise<void> => {\n    onReady?.();\n    return Promise.resolve();\n  };\n\n  type SendFn = PseudoAdapter<R>[\"send\"];\n  type ProcessFn = PseudoAdapter<R>[\"process\"];\n  type SubscribeFn = Source<R>[\"subscribe\"];\n\n  return {\n    adapterId: `routecraft.adapter.pseudo.${name}`,\n    subscribe:\n      runtime === \"noop\"\n        ? (noopSubscribe as SubscribeFn)\n        : (fail as SubscribeFn),\n    send: runtime === \"noop\" ? (noopSend as SendFn) : (fail as SendFn),\n    process:\n      runtime === \"noop\" ? (noopProcess as ProcessFn) : (fail as ProcessFn),\n  };\n}\n\n/**\n * Creates a pseudo (placeholder) adapter for use in tests or as a stub during development.\n */\n// Overload: string-first (keyed) factory\nexport function pseudo<\n  Opts extends Record<string, unknown> = Record<string, unknown>,\n>(name: string, options: PseudoKeyedOptions): PseudoKeyedFactory<Opts>;\n\n// Overload: object-only factory (default)\nexport function pseudo<\n  Opts extends Record<string, unknown> = Record<string, unknown>,\n>(name?: string, options?: PseudoOptions): PseudoFactory<Opts>;\n\n// Implementation\nexport function pseudo<\n  Opts extends Record<string, unknown> = Record<string, unknown>,\n>(\n  name = \"pseudo\",\n  options?: PseudoOptions | PseudoKeyedOptions,\n): PseudoFactory<Opts> | PseudoKeyedFactory<Opts> {\n  const runtime = options?.runtime ?? \"throw\";\n  const isKeyed = options && \"args\" in options && options.args === \"keyed\";\n\n  if (isKeyed) {\n    return <R = unknown>(key: string, opts?: Opts): PseudoAdapter<R> => {\n      void key;\n      void opts;\n      return createAdapter<R>(name, runtime);\n    };\n  }\n  return <R = unknown>(opts: Opts): PseudoAdapter<R> => {\n    void opts;\n    return createAdapter<R>(name, runtime);\n  };\n}\n\n// Re-export types\nexport type { PseudoOptions, PseudoKeyedOptions } from \"./shared\";\n","import type { Exchange } from \"@routecraft/routecraft\";\n\n/**\n * Internal state container for the spy adapter.\n */\nexport interface SpyState<T> {\n  received: Exchange<T>[];\n  calls: { send: number; process: number; enrich: number };\n}\n\n/**\n * Creates fresh spy state with empty received array and zeroed counters.\n */\nexport function createSpyState<T>(): SpyState<T> {\n  return {\n    received: [],\n    calls: { send: 0, process: 0, enrich: 0 },\n  };\n}\n","import {\n  HeadersKeys,\n  type Destination,\n  type Processor,\n  type Exchange,\n} from \"@routecraft/routecraft\";\nimport { createSpyState } from \"./shared.ts\";\n\n/**\n * A spy adapter that records all exchanges passing through it.\n * Implements both {@link Destination} and {@link Processor} so it can be used\n * with `.to()`, `.enrich()`, `.tap()`, and `.process()`.\n */\nexport type SpyAdapter<T = unknown> = {\n  /** Stable identifier for this adapter. */\n  adapterId: string;\n\n  /** All exchanges recorded, in order. */\n  received: Exchange<T>[];\n\n  /** Per-operation call counters. */\n  calls: { send: number; process: number; enrich: number };\n\n  /** Clear all recorded data and reset counters. */\n  reset(): void;\n\n  /** Most recent exchange. Throws if none recorded. */\n  lastReceived(): Exchange<T>;\n\n  /** Array of just the body values from received exchanges. */\n  receivedBodies(): T[];\n  /* eslint-disable @typescript-eslint/no-explicit-any -- both positions use any: Destination so the spy is assignable regardless of body type, Processor so spy<unknown>() is assignable in typed pipelines */\n} & Destination<any, void> &\n  Processor<any, T>;\n/* eslint-enable @typescript-eslint/no-explicit-any */\n\n/**\n * Creates a spy adapter that records all exchanges for test assertions.\n *\n * Use as a destination (`.to()`, `.enrich()`, `.tap()`) or processor (`.process()`)\n * to capture pipeline output without side effects.\n *\n * @returns A spy adapter that records exchanges and tracks call counts\n *\n * @example\n * ```ts\n * const s = spy();\n * const route = craft().id(\"test\").from(simple(\"hello\")).to(s);\n * const t = await testContext().routes(route).build();\n * await t.test();\n *\n * expect(s.received).toHaveLength(1);\n * expect(s.received[0].body).toBe(\"hello\");\n * expect(s.calls.send).toBe(1);\n * ```\n */\nexport function spy<T = unknown>(): SpyAdapter<T> {\n  const state = createSpyState<T>();\n\n  return {\n    adapterId: \"routecraft.adapter.spy\",\n    received: state.received,\n    calls: state.calls,\n\n    send(exchange: Exchange<T>): void {\n      state.received.push(exchange);\n\n      const operation = exchange.headers?.[HeadersKeys.OPERATION];\n      if (operation === \"enrich\") {\n        state.calls.enrich++;\n      } else {\n        state.calls.send++;\n      }\n    },\n\n    process(exchange: Exchange<T>): Exchange<T> {\n      state.received.push(exchange);\n      state.calls.process++;\n      return exchange;\n    },\n\n    reset(): void {\n      state.received.length = 0;\n      state.calls.send = 0;\n      state.calls.process = 0;\n      state.calls.enrich = 0;\n    },\n\n    lastReceived(): Exchange<T> {\n      if (state.received.length === 0) {\n        throw new Error(\"SpyAdapter: no exchanges recorded\");\n      }\n      return state.received[state.received.length - 1];\n    },\n\n    receivedBodies(): T[] {\n      return state.received.map((e) => e.body);\n    },\n  };\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport {\n  formatSchemaIssues,\n  logger as defaultLogger,\n  rcError,\n} from \"@routecraft/routecraft\";\n\n/**\n * Structural shape of a fn-like spec for testing. Does not import\n * `FnOptions` from `@routecraft/ai` so this package stays free of\n * a reverse dependency. Real `FnOptions` values are structurally\n * assignable here -- the extra `description` field is ignored.\n */\nexport interface TestFnSpec<TIn, TOut> {\n  /** Schema whose validated/coerced output is passed to `handler`. */\n  input: StandardSchemaV1<unknown, TIn>;\n  handler: (input: TIn, ctx: TestFnHandlerContext) => Promise<TOut> | TOut;\n}\n\n/**\n * Synthetic context handed to a fn handler under `testFn`. Mirrors the\n * minimum shape `agentPlugin` provides at production dispatch time\n * (without coupling to that implementation). Extra fields a handler may\n * read at runtime can be added here in follow-ups without breaking the\n * structural contract.\n */\nexport interface TestFnHandlerContext {\n  logger: ReturnType<typeof defaultLogger.child>;\n  abortSignal: AbortSignal;\n}\n\n/**\n * Options for {@link testFn}.\n */\nexport interface TestFnOptions {\n  /** Caller-supplied abort signal. Defaults to a never-firing signal. */\n  signal?: AbortSignal;\n  /** Caller-supplied logger. Defaults to a child of the framework logger bound to `{ test: \"fn\" }`. */\n  logger?: ReturnType<typeof defaultLogger.child>;\n}\n\n/**\n * Run a fn-like spec end-to-end in tests. Validates `input` against the\n * spec's Standard Schema, then calls the handler with a synthetic\n * context. Designed to mirror what `agentPlugin` does internally at\n * production dispatch time, without exposing or depending on that\n * dispatcher.\n *\n * Throws `RC5002` (Validation failed) if the input does not pass the\n * schema. Errors thrown from the handler propagate as-is.\n *\n * @example\n * ```typescript\n * import { testFn } from \"@routecraft/testing\";\n * import { z } from \"zod\";\n *\n * const greet = {\n *   description: \"...\",\n *   input: z.object({ name: z.string() }),\n *   handler: async (input, ctx) => `hello ${input.name}`,\n * };\n *\n * const out = await testFn(greet, { name: \"alice\" });\n * expect(out).toBe(\"hello alice\");\n * ```\n */\nexport async function testFn<TIn, TOut>(\n  spec: TestFnSpec<TIn, TOut>,\n  input: unknown,\n  options: TestFnOptions = {},\n): Promise<TOut> {\n  const standard = (spec.input as { [\"~standard\"]?: { validate?: unknown } })[\n    \"~standard\"\n  ];\n  if (typeof standard?.validate !== \"function\") {\n    throw rcError(\"RC5003\", undefined, {\n      message: `testFn: spec.input must be a Standard Schema with a callable validate.`,\n    });\n  }\n\n  const validate = standard.validate as (\n    value: unknown,\n  ) =>\n    | { value?: unknown; issues?: unknown }\n    | Promise<{ value?: unknown; issues?: unknown }>;\n  let result = validate(input);\n  if (result instanceof Promise) result = await result;\n  if (result.issues !== undefined && result.issues !== null) {\n    throw rcError(\"RC5002\", undefined, {\n      message: `testFn: input validation failed: ${formatSchemaIssues(result.issues)}`,\n    });\n  }\n\n  const ctx: TestFnHandlerContext = {\n    logger: options.logger ?? defaultLogger.child({ test: \"fn\" }),\n    abortSignal: options.signal ?? new AbortController().signal,\n  };\n\n  const validated = \"value\" in result ? (result.value as TIn) : (input as TIn);\n  return (await spec.handler(validated, ctx)) as TOut;\n}\n","import { readFileSync } from \"node:fs\";\nimport { test } from \"vitest\";\n\n// Re-export test context utilities\nexport {\n  TestContext,\n  TestContextBuilder,\n  testContext,\n  type TestContextOptions,\n  type TestOptions,\n} from \"./test-context\";\n\n// Re-export spy logger utilities\nexport {\n  createSpyLogger,\n  createNoopSpyLogger,\n  type SpyLogger,\n} from \"./spy-logger\";\n\n// Re-export pseudo adapter\nexport {\n  pseudo,\n  type PseudoOptions,\n  type PseudoKeyedOptions,\n} from \"./adapters/pseudo\";\n\n// Re-export spy adapter\nexport { spy, type SpyAdapter } from \"./adapters/spy\";\n\n// Adapter mocking API\nexport {\n  mockAdapter,\n  type AdapterMock,\n  type MockAdapterBehavior,\n} from \"./mock-adapter\";\n\n// Test helper for fn-like specs (schema + handler). Used to exercise\n// fns registered in `@routecraft/ai`'s agentPlugin without depending on\n// any non-public dispatcher.\nexport {\n  testFn,\n  type TestFnHandlerContext,\n  type TestFnOptions,\n  type TestFnSpec,\n} from \"./test-fn\";\n\n/**\n * Load a JSON fixture file and return the parsed value.\n *\n * @param path Absolute or relative path to the JSON file\n * @returns Parsed JSON as T\n */\nexport function fixture<T = unknown>(path: string): T {\n  return JSON.parse(readFileSync(path, \"utf-8\")) as T;\n}\n\n/**\n * Fixture entry must have a `name` field used as the vitest test name.\n */\nexport interface FixtureWithName {\n  name: string;\n  [key: string]: unknown;\n}\n\n/**\n * Load a JSON array fixture and run one vitest test per entry. Each entry must have a `name` field (used as the test name).\n *\n * @param path Path to a JSON file that parses to an array\n * @param run Callback invoked per entry; use for assertions. Receives the fixture entry.\n */\nexport function fixtureEach<T extends FixtureWithName>(\n  path: string,\n  run: (entry: T) => void | Promise<void>,\n): void {\n  const entries = fixture<T[]>(path);\n  if (!Array.isArray(entries)) {\n    throw new Error(\n      `fixture.each: expected JSON array at \"${path}\", got ${typeof entries}`,\n    );\n  }\n  for (const entry of entries) {\n    if (typeof entry?.name !== \"string\") {\n      throw new Error(\n        `fixture.each: each entry must have a \"name\" field (string). Got: ${JSON.stringify(entry)}`,\n      );\n    }\n    test(entry.name, () => run(entry));\n  }\n}\n"]}
+{"version":3,"sources":["../src/spy-logger.ts","../src/mock-adapter.ts","../src/test-context.ts","../src/adapters/pseudo/shared.ts","../src/adapters/pseudo/index.ts","../src/adapters/spy/shared.ts","../src/adapters/spy/index.ts","../src/source-message.ts","../src/test-fn.ts","../src/test-subscription.ts","../src/index.ts"],"names":["createSpyFn","impl","calls","fn","args","next","createSpyLogger","spy","createNoopSpyLogger","noop","childFn","noopLogger","ADAPTER_MOCK_BRAND","isAdapterMock","value","mockAdapter","target","behavior","override","DEFAULT_ROUTES_READY_TIMEOUT_MS","describeOverrideTarget","TestContext","ctx","client","options","pushError","err","isRoutecraftError","rcError","payload","total","resolve","reject","ready","settled","timeoutId","cleanup","offRouteStarted","offError","allReady","started","delayMs","TestContextBuilder","ContextBuilder","ms","mock","entry","o","name","config","event","handler","key","routes","spyLogger","originalChild","logger","childSpy","built","error","existing","RC_ADAPTER_OVERRIDES","testContext","createNoopSubscribe","sub","createAdapter","runtime","fail","noopSend","noopFetch","noopProcess","exchange","noopSubscribe","pseudo","opts","createSpyState","state","sourceMessage","body","headers","SOURCE_FIXTURE","testFn","spec","input","standard","validate","result","formatSchemaIssues","defaultLogger","validated","testSubscription","controller","reason","msg","fixture","path","readFileSync","fixtureEach","test","run","entries"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Minimal runner-agnostic spy function. Records calls in the jest-compatible\n * `mock.calls` shape so assertions like\n * `expect(t.logger.warn.mock.calls.some(...))` work under bun:test, Vitest,\n * and node:test without this package importing any runner.\n *\n * Runner mocks (`vi.fn` from Vitest, `mock` from bun:test) are structurally\n * assignable to this interface, so they can be injected via {@link SpyFactory}\n * when full matcher support (`expect(fn).toHaveBeenCalledWith(...)`) is\n * wanted.\n */\nexport interface SpyFn {\n  (...args: unknown[]): unknown;\n  mock: { calls: unknown[][] };\n  mockImplementation(impl: (...args: unknown[]) => unknown): SpyFn;\n  mockClear(): void;\n}\n\n/**\n * Factory producing spy functions. Defaults to the built-in {@link createSpyFn};\n * pass your runner's mock factory (`vi.fn`, or `mock` from bun:test) to get\n * native mocks that work with the runner's `expect` matchers.\n */\nexport type SpyFactory = () => SpyFn;\n\n/**\n * Create a built-in spy function. Dependency-free; records calls in\n * `fn.mock.calls` and supports `mockImplementation` / `mockClear`.\n */\nexport function createSpyFn(): SpyFn {\n  let impl: ((...args: unknown[]) => unknown) | undefined;\n  const calls: unknown[][] = [];\n  const fn = ((...args: unknown[]): unknown => {\n    calls.push(args);\n    return impl?.(...args);\n  }) as SpyFn;\n  fn.mock = { calls };\n  fn.mockImplementation = (next) => {\n    impl = next;\n    return fn;\n  };\n  fn.mockClear = () => {\n    calls.length = 0;\n  };\n  return fn;\n}\n\n/**\n * Spy logger with spy methods for assertions (e.g.\n * `t.logger.info.mock.calls` under any runner, or\n * `expect(t.logger.info).toHaveBeenCalledWith(...)` when built from an\n * injected runner mock factory).\n */\nexport type SpyLogger = {\n  info: SpyFn;\n  debug: SpyFn;\n  warn: SpyFn;\n  error: SpyFn;\n  trace: SpyFn;\n  fatal: SpyFn;\n  child: SpyFn;\n};\n\nexport function createSpyLogger(fn: SpyFactory = createSpyFn): SpyLogger {\n  const spy: SpyLogger = {\n    info: fn(),\n    debug: fn(),\n    warn: fn(),\n    error: fn(),\n    trace: fn(),\n    fatal: fn(),\n    child: fn(),\n  };\n  spy.child.mockImplementation(() => spy);\n  return spy;\n}\n\nexport function createNoopSpyLogger(fn: SpyFactory = createSpyFn): SpyLogger {\n  const noop = fn();\n  const childFn = fn();\n  const noopLogger: SpyLogger = {\n    info: noop,\n    debug: noop,\n    warn: noop,\n    error: noop,\n    trace: noop,\n    fatal: noop,\n    child: childFn,\n  };\n  childFn.mockImplementation(() => noopLogger);\n  return noopLogger;\n}\n","import type {\n  AdapterOverride,\n  AdapterSendCall,\n  AdapterSourceCall,\n  SendOverrideHandler,\n  Source,\n  SourceOverrideBehavior,\n} from \"@routecraft/routecraft\";\n\n/**\n * Brand symbol stamped on the handles returned by `mockAdapter()`.\n *\n * `testContext().override()` uses this symbol to distinguish a mock handle\n * from a raw `AdapterOverride` (both objects carry a `calls` field, so a\n * structural check on a non-branded key would be fragile).\n *\n * Use `Symbol.for` so cross-realm / multi-package-load equality holds.\n *\n * @internal\n */\nexport const ADAPTER_MOCK_BRAND: unique symbol = Symbol.for(\n  \"routecraft.testing.adapter-mock\",\n);\n\n/**\n * Extract the message type `M` from an adapter factory or adapter class,\n * so `mockAdapter(target, { source: [...] })` can check fixtures against\n * the real adapter shape. Falls back to `unknown` when `target` has no\n * inferable Source role (e.g. destination-only factories, or overloaded\n * factories where TypeScript cannot pick the source overload).\n */\ntype InferAdapterMessage<T> = T extends new (...args: never[]) => infer I\n  ? I extends Source<infer M>\n    ? M\n    : unknown\n  : T extends (...args: never[]) => infer R\n    ? R extends Source<infer M>\n      ? M\n      : unknown\n    : unknown;\n\n/**\n * Behaviour description for a mock adapter. A mock may stub the source side,\n * the destination side, or both. The framework picks the matching behaviour\n * based on the call site's role in the route.\n */\nexport interface MockAdapterBehavior<M = unknown> {\n  /**\n   * Source-role behaviour. Used when the adapter is the `.from()` of a route.\n   * Pass an array of fixtures, an async iterable, or a callable that receives\n   * the construction args and returns the stream to emit.\n   */\n  source?: SourceOverrideBehavior<M>;\n  /**\n   * Destination/enricher-role behaviour. Used when the adapter is passed to\n   * `.to()`, `.enrich()`, or `.tap()`. Receives the exchange and a meta\n   * object with the construction args. The handler's return value follows\n   * the step's slot resolution: a fetch-resolved step (`.enrich()`, or a\n   * fetch-only adapter in `.to()`) uses it as the fetched value (replacing\n   * the body by default), while a send-resolved `.to()` discards it (send\n   * is void) and `.tap()` always discards.\n   */\n  send?: SendOverrideHandler;\n}\n\n/**\n * Handle returned by `mockAdapter(factory, behaviour)`. Carries the resolved\n * override the framework should install on the context, plus `calls` for\n * assertions.\n */\nexport interface AdapterMock {\n  /** Brand used by `testContext().override()` to discriminate handles from raw overrides. */\n  readonly [ADAPTER_MOCK_BRAND]: true;\n  readonly override: AdapterOverride;\n  /**\n   * Recorded calls, populated as the route runs. Assert on these after\n   * awaiting `t.test()`.\n   */\n  readonly calls: {\n    source: readonly AdapterSourceCall[];\n    send: readonly AdapterSendCall[];\n  };\n}\n\n/**\n * Type guard that distinguishes an `AdapterMock` (handle returned by\n * `mockAdapter()`) from a raw `AdapterOverride` value.\n *\n * @internal\n */\nexport function isAdapterMock(\n  value: AdapterMock | AdapterOverride,\n): value is AdapterMock {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as { [ADAPTER_MOCK_BRAND]?: unknown })[ADAPTER_MOCK_BRAND] === true\n  );\n}\n\n/**\n * Create a mock for an adapter. The `target` may be either:\n *\n * - An adapter factory (e.g. `mail`, `http`, `mcp`). The mock matches every\n *   adapter instance produced by that factory. Requires the factory to stamp\n *   its adapters via `tagAdapter()`.\n * - An adapter class (e.g. `MailSourceAdapter`, `HttpEnricherAdapter`).\n *   The mock matches any adapter whose `constructor === target`. Works for\n *   every adapter without opt-in tagging, including third-party ones.\n *\n * Pass the result to `testContext().override(mock)` and run the route\n * under test as-is; the framework invokes the mock's `source` / `send`\n * handlers in place of the real adapter at every matching call site.\n *\n * @param target - The adapter factory or adapter class to intercept\n * @param behavior - Source and/or destination-role handlers\n * @returns A handle with `calls` for assertions and an internal `override`\n *\n * @example\n * ```ts\n * // Factory form (preferred for single-role factories)\n * import { http, mail } from \"@routecraft/routecraft\";\n * import { mockAdapter, testContext } from \"@routecraft/testing\";\n *\n * const httpMock = mockAdapter(http, {\n *   send: async () => ({ status: 200, body: { ok: true } }),\n * });\n *\n * const mailMock = mockAdapter(mail, {\n *   source: [{ uid: 1, from: \"a@b\", subject: \"hi\", ... }],\n *   send: async () => undefined,\n * });\n *\n * // Class form (works for any adapter, including third-party ones)\n * import { SomeAdapterClass } from \"third-party-adapter\";\n *\n * const thirdPartyMock = mockAdapter(SomeAdapterClass, {\n *   send: async () => ({ ok: true }),\n * });\n *\n * const t = await testContext()\n *   .override(httpMock)\n *   .override(mailMock)\n *   .override(thirdPartyMock)\n *   .routes(route)\n *   .build();\n * await t.test();\n * ```\n */\nexport function mockAdapter<\n  T extends\n    ((...args: never[]) => unknown) | (new (...args: never[]) => unknown),\n  M = InferAdapterMessage<T>,\n>(target: T, behavior: MockAdapterBehavior<M>): AdapterMock {\n  const override: AdapterOverride = {\n    target,\n    calls: { source: [], send: [] },\n  };\n  if (behavior.source !== undefined) {\n    override.source = behavior.source as SourceOverrideBehavior;\n  }\n  if (behavior.send !== undefined) {\n    override.send = behavior.send;\n  }\n  return {\n    [ADAPTER_MOCK_BRAND]: true,\n    override,\n    get calls() {\n      // Snapshot the live arrays so the `readonly` contract on AdapterMock.calls\n      // is honoured at runtime (users cannot mutate the recorded calls via\n      // the returned reference).\n      return {\n        source: [...override.calls.source],\n        send: [...override.calls.send],\n      };\n    },\n  };\n}\n","import type {\n  CraftContext,\n  CraftConfig,\n  StoreRegistry,\n  EventName,\n  EventHandler,\n  RouteDefinition,\n  AnyRouteBuilder,\n  AdapterOverride,\n} from \"@routecraft/routecraft\";\nimport {\n  ContextBuilder,\n  CraftClient,\n  isRoutecraftError,\n  RoutecraftError,\n  rcError,\n  logger,\n  RC_ADAPTER_OVERRIDES,\n} from \"@routecraft/routecraft\";\nimport type { SpyFactory, SpyLogger } from \"./spy-logger\";\nimport {\n  createSpyFn,\n  createSpyLogger,\n  createNoopSpyLogger,\n} from \"./spy-logger\";\nimport { isAdapterMock, type AdapterMock } from \"./mock-adapter\";\n\nconst DEFAULT_ROUTES_READY_TIMEOUT_MS = 200;\n\nfunction describeOverrideTarget(target: unknown): string {\n  if (typeof target === \"function\" && typeof target.name === \"string\") {\n    const kind =\n      /^[A-Z]/.test(target.name) && target.prototype !== undefined\n        ? \"class\"\n        : \"factory\";\n    return `${kind} ${target.name || \"<anonymous>\"}`;\n  }\n  return \"target\";\n}\n\nexport interface TestContextOptions {\n  /** Timeout in ms for waiting for all routes to emit routeStarted. Default 200. */\n  routesReadyTimeoutMs?: number;\n  /**\n   * Mock factory used to build the spy logger. Defaults to the built-in\n   * runner-agnostic spy. Pass your runner's factory (`vi.fn` from Vitest, or\n   * `mock` from bun:test) to get native mocks that work with the runner's\n   * `expect` matchers, e.g. `testContext({ fn: vi.fn })`.\n   */\n  fn?: SpyFactory;\n}\n\n/**\n * Options for TestContext.test().\n */\nexport interface TestOptions {\n  /**\n   * Delay in ms after all routes are ready, before draining.\n   * Use for timer (or other deferred) sources so at least one message is processed before drain/stop.\n   * E.g. `await t.test({ delayBeforeDrainMs: 50 })` for a timer with intervalMs >= 50.\n   */\n  delayBeforeDrainMs?: number;\n}\n\n/**\n * Test-friendly wrapper around CraftContext. Runs the real context but manages\n * lifecycle (start, wait routes ready, drain, stop) and collects errors.\n * t.logger is a spy logger for asserting on log calls.\n */\nexport class TestContext {\n  readonly ctx: CraftContext;\n  /** Client for dispatching messages to direct endpoints in tests. */\n  readonly client: CraftClient;\n  /** Spy logger; e.g. t.logger.info.mock.calls, or expect(t.logger.info).toHaveBeenCalledWith(...) with an injected runner mock factory */\n  readonly logger: SpyLogger;\n  readonly errors: RoutecraftError[] = [];\n  private readonly routesReadyTimeoutMs: number;\n\n  private restoreLoggerChild?: () => void;\n  private loggerChildRestored = false;\n  private startedPromise?: Promise<void>;\n\n  constructor(\n    ctx: CraftContext,\n    client: CraftClient,\n    options?: TestContextOptions & {\n      spyLogger?: SpyLogger;\n      restoreLoggerChild?: () => void;\n    },\n  ) {\n    this.ctx = ctx;\n    this.client = client;\n    this.logger = options?.spyLogger ?? createNoopSpyLogger();\n    if (options?.restoreLoggerChild)\n      this.restoreLoggerChild = options.restoreLoggerChild;\n    this.routesReadyTimeoutMs =\n      options?.routesReadyTimeoutMs ?? DEFAULT_ROUTES_READY_TIMEOUT_MS;\n    const pushError = (err: unknown) => {\n      this.errors.push(\n        isRoutecraftError(err)\n          ? (err as RoutecraftError)\n          : rcError(\"RC9901\", err),\n      );\n    };\n    ctx.on(\"context:error\", (payload) => {\n      pushError(payload.details.error);\n    });\n  }\n\n  /**\n   * Build a promise that resolves once every route has emitted\n   * `route:started`, or rejects on `context:error` or the configured\n   * routes-ready timeout. Shared by {@link startAndWaitReady} and {@link test}.\n   */\n  private awaitRoutesReady(): Promise<void> {\n    const ctx = this.ctx;\n    const total = ctx.getRoutes().length;\n    if (total === 0) return Promise.resolve();\n    return new Promise<void>((resolve, reject) => {\n      let ready = 0;\n      let settled = false;\n      let timeoutId: ReturnType<typeof setTimeout> | undefined = setTimeout(\n        () => {\n          if (settled) return;\n          cleanup();\n          reject(new Error(\"Timeout waiting for routes to start\"));\n        },\n        this.routesReadyTimeoutMs,\n      );\n\n      const offRouteStarted = ctx.on(\"route:started\", (() => {\n        if (settled) return;\n        ready++;\n        if (ready >= total) {\n          cleanup();\n          resolve();\n        }\n      }) as EventHandler<EventName>);\n      const offError = ctx.on(\"context:error\", (payload) => {\n        if (settled) return;\n        cleanup();\n        reject(payload.details.error);\n      });\n\n      function cleanup(): void {\n        if (settled) return;\n        settled = true;\n        offRouteStarted();\n        offError();\n        if (timeoutId !== undefined) {\n          clearTimeout(timeoutId);\n          timeoutId = undefined;\n        }\n      }\n    });\n  }\n\n  /**\n   * Start context and resolve once every route has emitted `route:started`.\n   * Does not drain or stop. Does not await `ctx.start()` completion, which\n   * lets this method work with long-running sources (direct, mcp, HTTP, etc.)\n   * whose subscribe blocks until the route is aborted. The start promise is\n   * stored internally and awaited by {@link stop} for clean shutdown.\n   *\n   * Use with {@link CraftClient.sendDirect} (via `t.client`) for direct endpoints,\n   * or drive sources directly via the context store, then call `drain()` /\n   * `stop()` when done.\n   *\n   * If `ctx.start()` rejects (synchronously or before any route emits\n   * `route:started`), the rejection surfaces here via the\n   * `context:error` listener installed by `awaitRoutesReady`. A no-op\n   * catch is attached to `startedPromise` as a safety net so that a\n   * slow rejection does not trigger an `unhandledRejection` before\n   * `stop()` awaits the promise for teardown.\n   */\n  async startAndWaitReady(): Promise<void> {\n    const allReady = this.awaitRoutesReady();\n    this.startedPromise = this.ctx.start();\n    // Attach a no-op handler so Node does not report the rejection as\n    // unhandled before `stop()` re-awaits the promise.\n    this.startedPromise.catch(() => {});\n    await allReady;\n  }\n\n  /**\n   * Start context, wait for all routes ready, optionally delay, drain in-flight, then stop.\n   * Assert after this returns (mocks, t.errors, t.ctx.getStore() all valid).\n   *\n   * @param options.delayBeforeDrainMs If set, wait this many ms after routes are ready before draining.\n   *   Use for timer (or other deferred) sources so at least one message is processed before drain/stop.\n   */\n  async test(options?: TestOptions): Promise<void> {\n    const ctx = this.ctx;\n    const allReady = this.awaitRoutesReady();\n    const started = ctx.start();\n    // Shield a synchronous rejection of `started` from becoming an\n    // unhandled rejection before the `finally` block re-awaits it.\n    started.catch(() => {});\n    try {\n      await allReady;\n      const delayMs = options?.delayBeforeDrainMs ?? 0;\n      if (delayMs > 0) {\n        await new Promise((resolve) => setTimeout(resolve, delayMs));\n      }\n      await ctx.drain();\n    } finally {\n      try {\n        await ctx.stop();\n        await started;\n      } finally {\n        this.restoreLoggerChildOnce();\n      }\n    }\n  }\n\n  drain(): Promise<void> {\n    return this.ctx.drain();\n  }\n\n  async stop(): Promise<void> {\n    try {\n      await this.ctx.stop();\n      if (this.startedPromise !== undefined) {\n        await this.startedPromise;\n      }\n    } finally {\n      this.restoreLoggerChildOnce();\n    }\n  }\n\n  private restoreLoggerChildOnce(): void {\n    if (this.loggerChildRestored) return;\n    this.restoreLoggerChild?.();\n    this.loggerChildRestored = true;\n  }\n}\n\n/**\n * Builder that returns TestContext instead of CraftContext.\n * Same API as ContextBuilder (routes, on, with, store).\n */\nexport class TestContextBuilder {\n  private builder = new ContextBuilder();\n  private routesReadyTimeoutMs: number | undefined;\n  private adapterOverrides: AdapterOverride[] = [];\n  private readonly spyFactory: SpyFactory;\n\n  constructor(options?: TestContextOptions) {\n    this.spyFactory = options?.fn ?? createSpyFn;\n    this.routesReadyTimeoutMs = options?.routesReadyTimeoutMs;\n  }\n\n  /** Override timeout for waiting for routes to start (ms). Used by tests that assert timeout behavior. */\n  routesReadyTimeout(ms: number): this {\n    this.routesReadyTimeoutMs = ms;\n    return this;\n  }\n\n  /**\n   * Register an adapter mock. At route execution time, calls to adapters\n   * produced by the same factory are routed through the mock's handlers\n   * instead of invoking the real adapter. Accepts either the handle returned\n   * by `mockAdapter()` or a raw `AdapterOverride`.\n   */\n  override(mock: AdapterMock | AdapterOverride): this {\n    const entry: AdapterOverride = isAdapterMock(mock) ? mock.override : mock;\n    // Fail fast if two overrides target the same factory/class. The framework\n    // uses first-match semantics at execution time, so silently accepting a\n    // duplicate would mean the second mock's assertions always see zero calls\n    // and the user has no signal that their new override is being shadowed.\n    const duplicate = this.adapterOverrides.find(\n      (o) => o.target === entry.target,\n    );\n    if (duplicate !== undefined) {\n      const name = describeOverrideTarget(entry.target);\n      throw new Error(\n        `testContext().override(): duplicate override for ${name}. Each target may only be registered once; remove the redundant override() call.`,\n      );\n    }\n    this.adapterOverrides.push(entry);\n    return this;\n  }\n\n  with(config: CraftConfig): this {\n    this.builder.with(config);\n    return this;\n  }\n\n  on<K extends EventName>(event: K, handler: EventHandler<K>): this {\n    this.builder.on(event, handler);\n    return this;\n  }\n\n  once<K extends EventName>(event: K, handler: EventHandler<K>): this {\n    this.builder.once(event, handler);\n    return this;\n  }\n\n  store<K extends keyof StoreRegistry>(key: K, value: StoreRegistry[K]): this {\n    this.builder.store(key, value);\n    return this;\n  }\n\n  routes(\n    routes:\n      RouteDefinition[] | AnyRouteBuilder[] | RouteDefinition | AnyRouteBuilder,\n  ): this {\n    this.builder.routes(routes);\n    return this;\n  }\n\n  async build(): Promise<TestContext> {\n    const spyLogger = createSpyLogger(this.spyFactory);\n    const originalChild = logger.child.bind(logger);\n    const childSpy = this.spyFactory();\n    childSpy.mockImplementation(\n      () => spyLogger as unknown as ReturnType<typeof logger.child>,\n    );\n    logger.child = childSpy as unknown as typeof logger.child;\n    // Restore the patched child on build failure: the restore hook is only\n    // handed to TestContext after a successful build, so without this a\n    // rejected build (e.g. an invalid route) would leak the stub into every\n    // later test in the process.\n    let built: Awaited<ReturnType<ContextBuilder[\"build\"]>>;\n    try {\n      built = await this.builder.build();\n    } catch (error) {\n      logger.child = originalChild;\n      throw error;\n    }\n    const { context: ctx, client } = built;\n\n    // Install registered adapter overrides onto the context store so that\n    // ToStep / EnrichStep / Route source can resolve them at execution time.\n    if (this.adapterOverrides.length > 0) {\n      const existing = ctx.getStore(RC_ADAPTER_OVERRIDES) ?? [];\n      ctx.setStore(RC_ADAPTER_OVERRIDES, [\n        ...existing,\n        ...this.adapterOverrides,\n      ]);\n    }\n\n    const options: TestContextOptions & {\n      spyLogger: SpyLogger;\n      restoreLoggerChild: () => void;\n    } = {\n      ...(this.routesReadyTimeoutMs !== undefined\n        ? { routesReadyTimeoutMs: this.routesReadyTimeoutMs }\n        : {}),\n      spyLogger,\n      restoreLoggerChild: () => {\n        logger.child = originalChild;\n      },\n    };\n    return new TestContext(ctx, client, options);\n  }\n}\n\n/**\n * Create a test context builder. Use .routes(...).build(), await the result, then await t.test().\n *\n * Runner-agnostic by default: the spy logger uses a built-in spy that records\n * calls in the jest-compatible `mock.calls` shape. Pass `{ fn }` with your\n * runner's mock factory (`vi.fn` from Vitest, `mock` from bun:test) when you\n * want `expect(t.logger.info).toHaveBeenCalledWith(...)` matcher support.\n *\n * @example\n * const builder = testContext();\n * const t = await builder.routes(myRoutes).build();\n * await t.test();\n *\n * @example\n * // Vitest, with native matcher support:\n * const t = await testContext({ fn: vi.fn }).routes(myRoutes).build();\n */\nexport function testContext(options?: TestContextOptions): TestContextBuilder {\n  return new TestContextBuilder(options);\n}\n","import type { Exchange } from \"@routecraft/routecraft\";\n\nexport interface PseudoOptions {\n  runtime?: \"throw\" | \"noop\";\n}\n\nexport interface PseudoKeyedOptions extends PseudoOptions {\n  args: \"keyed\";\n}\n\n/**\n * Creates a noop send function that resolves to undefined.\n */\nexport function createNoopSend<R>(): () => Promise<R> {\n  return (): Promise<R> => Promise.resolve(undefined as unknown as R);\n}\n\n/**\n * Creates a noop process function that returns the exchange as-is.\n */\nexport function createNoopProcess<R>(): <T>(\n  exchange: Exchange<T>,\n) => Exchange<R> {\n  return <T>(exchange: Exchange<T>): Exchange<R> =>\n    exchange as unknown as Exchange<R>;\n}\n\n/**\n * Creates a noop subscribe function that signals readiness immediately.\n */\nexport function createNoopSubscribe(): (\n  sub: import(\"@routecraft/routecraft\").Subscription,\n) => Promise<void> {\n  return (sub): Promise<void> => {\n    sub.ready();\n    return Promise.resolve();\n  };\n}\n\n/**\n * Creates a function that throws an error indicating the adapter is not implemented.\n */\nexport function createFailFunction(name: string): () => never {\n  return (): never => {\n    throw new Error(\n      `Pseudo adapter \"${name}\" is not implemented. Replace with a real adapter.`,\n    );\n  };\n}\n","import type {\n  Source,\n  Destination,\n  Enricher,\n  Processor,\n} from \"@routecraft/routecraft\";\nimport {\n  createNoopSubscribe,\n  type PseudoOptions,\n  type PseudoKeyedOptions,\n} from \"./shared\";\n\n/**\n * @internal\n */\n/* eslint-disable @typescript-eslint/no-explicit-any -- input position must accept any exchange for DSL assignability */\nexport type PseudoAdapter<R> = {\n  adapterId: string;\n} & Source<R> &\n  Destination<any> &\n  Enricher<any, R> &\n  Processor<any, R>;\n/* eslint-enable @typescript-eslint/no-explicit-any */\n\n/** @internal */\nexport type PseudoFactory<Opts> = <R = unknown>(opts: Opts) => PseudoAdapter<R>;\n\n/** @internal */\nexport type PseudoKeyedFactory<Opts> = <R = unknown>(\n  key: string,\n  opts?: Opts,\n) => PseudoAdapter<R>;\n\nfunction createAdapter<R>(\n  name: string,\n  runtime: \"throw\" | \"noop\",\n): PseudoAdapter<R> {\n  const fail = (): never => {\n    throw new Error(\n      `Pseudo adapter \"${name}\" is not implemented. Replace with a real adapter.`,\n    );\n  };\n  const noopSend = (): Promise<void> => Promise.resolve();\n  const noopFetch = (): Promise<R> =>\n    Promise.resolve(undefined as unknown as R);\n  const noopProcess = (exchange: unknown): unknown => exchange;\n  const noopSubscribe = createNoopSubscribe();\n\n  type SendFn = PseudoAdapter<R>[\"send\"];\n  type FetchFn = PseudoAdapter<R>[\"fetch\"];\n  type ProcessFn = PseudoAdapter<R>[\"process\"];\n  type SubscribeFn = Source<R>[\"subscribe\"];\n\n  return {\n    adapterId: `routecraft.adapter.pseudo.${name}`,\n    subscribe:\n      runtime === \"noop\"\n        ? (noopSubscribe as SubscribeFn)\n        : (fail as SubscribeFn),\n    send: runtime === \"noop\" ? (noopSend as SendFn) : (fail as SendFn),\n    fetch: runtime === \"noop\" ? (noopFetch as FetchFn) : (fail as FetchFn),\n    process:\n      runtime === \"noop\" ? (noopProcess as ProcessFn) : (fail as ProcessFn),\n  };\n}\n\n/**\n * Creates a pseudo (placeholder) adapter for use in tests or as a stub during development.\n */\n// Overload: string-first (keyed) factory\nexport function pseudo<\n  Opts extends Record<string, unknown> = Record<string, unknown>,\n>(name: string, options: PseudoKeyedOptions): PseudoKeyedFactory<Opts>;\n\n// Overload: object-only factory (default)\nexport function pseudo<\n  Opts extends Record<string, unknown> = Record<string, unknown>,\n>(name?: string, options?: PseudoOptions): PseudoFactory<Opts>;\n\n// Implementation\nexport function pseudo<\n  Opts extends Record<string, unknown> = Record<string, unknown>,\n>(\n  name = \"pseudo\",\n  options?: PseudoOptions | PseudoKeyedOptions,\n): PseudoFactory<Opts> | PseudoKeyedFactory<Opts> {\n  const runtime = options?.runtime ?? \"throw\";\n  const isKeyed = options && \"args\" in options && options.args === \"keyed\";\n\n  if (isKeyed) {\n    return <R = unknown>(key: string, opts?: Opts): PseudoAdapter<R> => {\n      void key;\n      void opts;\n      return createAdapter<R>(name, runtime);\n    };\n  }\n  return <R = unknown>(opts: Opts): PseudoAdapter<R> => {\n    void opts;\n    return createAdapter<R>(name, runtime);\n  };\n}\n\n// Re-export types\nexport type { PseudoOptions, PseudoKeyedOptions } from \"./shared\";\n","import type { Exchange } from \"@routecraft/routecraft\";\n\n/**\n * Internal state container for the spy adapter.\n */\nexport interface SpyState<T> {\n  received: Exchange<T>[];\n  calls: { send: number; process: number; enrich: number };\n}\n\n/**\n * Creates fresh spy state with empty received array and zeroed counters.\n */\nexport function createSpyState<T>(): SpyState<T> {\n  return {\n    received: [],\n    calls: { send: 0, process: 0, enrich: 0 },\n  };\n}\n","import type {\n  Destination,\n  Enricher,\n  Processor,\n  Exchange,\n} from \"@routecraft/routecraft\";\nimport { createSpyState } from \"./shared.ts\";\n\n/**\n * A spy adapter that records all exchanges passing through it.\n * Implements {@link Destination} (send), {@link Enricher} (fetch), and\n * {@link Processor} so it can be used with `.to()`, `.tap()`, `.enrich()`,\n * and `.process()`. The fetch face returns the current body, so a bare\n * `.enrich(spy())` observes without changing the body.\n */\nexport type SpyAdapter<T = unknown> = {\n  /** Stable identifier for this adapter. */\n  adapterId: string;\n\n  /** All exchanges recorded, in order. */\n  received: Exchange<T>[];\n\n  /** Per-operation call counters. */\n  calls: { send: number; process: number; enrich: number };\n\n  /** Clear all recorded data and reset counters. */\n  reset(): void;\n\n  /** Most recent exchange. Throws if none recorded. */\n  lastReceived(): Exchange<T>;\n\n  /** Array of just the body values from received exchanges. */\n  receivedBodies(): T[];\n  /* eslint-disable @typescript-eslint/no-explicit-any -- input positions use any: Destination/Enricher so the spy is assignable regardless of body type, Processor so spy<unknown>() is assignable in typed pipelines */\n} & Destination<any> &\n  Enricher<any, T> &\n  Processor<any, T>;\n/* eslint-enable @typescript-eslint/no-explicit-any */\n\n/**\n * Creates a spy adapter that records all exchanges for test assertions.\n *\n * Use as a destination (`.to()`, `.enrich()`, `.tap()`) or processor (`.process()`)\n * to capture pipeline output without side effects.\n *\n * @returns A spy adapter that records exchanges and tracks call counts\n *\n * @example\n * ```ts\n * const s = spy();\n * const route = craft().id(\"test\").from(simple(\"hello\")).to(s);\n * const t = await testContext().routes(route).build();\n * await t.test();\n *\n * expect(s.received).toHaveLength(1);\n * expect(s.received[0].body).toBe(\"hello\");\n * expect(s.calls.send).toBe(1);\n * ```\n */\nexport function spy<T = unknown>(): SpyAdapter<T> {\n  const state = createSpyState<T>();\n\n  return {\n    adapterId: \"routecraft.adapter.spy\",\n    received: state.received,\n    calls: state.calls,\n\n    send(exchange: Exchange<T>): void {\n      state.received.push(exchange);\n      state.calls.send++;\n    },\n\n    fetch(exchange: Exchange<T>): T {\n      state.received.push(exchange);\n      state.calls.enrich++;\n      // Return the current body: a bare `.enrich(spy())` replaces the body\n      // with itself, so the spy observes without altering the flow.\n      return exchange.body;\n    },\n\n    process(exchange: Exchange<T>): Exchange<T> {\n      state.received.push(exchange);\n      state.calls.process++;\n      return exchange;\n    },\n\n    reset(): void {\n      state.received.length = 0;\n      state.calls.send = 0;\n      state.calls.process = 0;\n      state.calls.enrich = 0;\n    },\n\n    lastReceived(): Exchange<T> {\n      if (state.received.length === 0) {\n        throw new Error(\"SpyAdapter: no exchanges recorded\");\n      }\n      return state.received[state.received.length - 1];\n    },\n\n    receivedBodies(): T[] {\n      return state.received.map((e) => e.body);\n    },\n  };\n}\n","import {\n  SOURCE_FIXTURE,\n  type ExchangeHeaders,\n  type SourceFixture,\n} from \"@routecraft/routecraft\";\n\n/**\n * Wrap a message body with the headers a real source would have attached, for\n * use as a `mockAdapter(..., { source: [...] })` fixture.\n *\n * Envelope-carrying sources (mail, http) split each incoming message into a\n * payload on `exchange.body` and metadata on `routecraft.<adapter>.*` headers.\n * A bare fixture array only sets the body, so a route that reads those headers\n * cannot be exercised through the mock. `sourceMessage(body, headers)` lets the\n * mock reproduce that split.\n *\n * @example\n * ```typescript\n * const mailMock = mockAdapter(mail, {\n *   source: [\n *     sourceMessage(\n *       { text: \"Tracking: ABC123\" },\n *       {\n *         \"routecraft.mail.from\": \"noreply@acme.test\",\n *         \"routecraft.mail.subject\": \"Your order has shipped\",\n *       },\n *     ),\n *   ],\n * });\n * ```\n *\n * @param body - The body the source would deliver on the exchange\n * @param headers - Headers the source would attach (omit for a body-only fixture)\n * @returns A branded fixture recognised by the source-mock dispatcher\n */\nexport function sourceMessage<M>(\n  body: M,\n  headers?: ExchangeHeaders,\n): SourceFixture<M> {\n  return headers === undefined\n    ? { [SOURCE_FIXTURE]: true, body }\n    : { [SOURCE_FIXTURE]: true, body, headers };\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport {\n  formatSchemaIssues,\n  logger as defaultLogger,\n  rcError,\n} from \"@routecraft/routecraft\";\n\n/**\n * Structural shape of a fn-like spec for testing. Does not import\n * `FnOptions` from `@routecraft/ai` so this package stays free of\n * a reverse dependency. Real `FnOptions` values are structurally\n * assignable here -- the extra `description` field is ignored.\n */\nexport interface TestFnSpec<TIn, TOut> {\n  /** Schema whose validated/coerced output is passed to `handler`. */\n  input: StandardSchemaV1<unknown, TIn>;\n  handler: (input: TIn, ctx: TestFnHandlerContext) => Promise<TOut> | TOut;\n}\n\n/**\n * Synthetic context handed to a fn handler under `testFn`. Mirrors the\n * minimum shape `agentPlugin` provides at production dispatch time\n * (without coupling to that implementation). Extra fields a handler may\n * read at runtime can be added here in follow-ups without breaking the\n * structural contract.\n */\nexport interface TestFnHandlerContext {\n  logger: ReturnType<typeof defaultLogger.child>;\n  abortSignal: AbortSignal;\n}\n\n/**\n * Options for {@link testFn}.\n */\nexport interface TestFnOptions {\n  /** Caller-supplied abort signal. Defaults to a never-firing signal. */\n  signal?: AbortSignal;\n  /** Caller-supplied logger. Defaults to a child of the framework logger bound to `{ test: \"fn\" }`. */\n  logger?: ReturnType<typeof defaultLogger.child>;\n}\n\n/**\n * Run a fn-like spec end-to-end in tests. Validates `input` against the\n * spec's Standard Schema, then calls the handler with a synthetic\n * context. Designed to mirror what `agentPlugin` does internally at\n * production dispatch time, without exposing or depending on that\n * dispatcher.\n *\n * Throws `RC5002` (Validation failed) if the input does not pass the\n * schema. Errors thrown from the handler propagate as-is.\n *\n * @example\n * ```typescript\n * import { testFn } from \"@routecraft/testing\";\n * import { z } from \"zod\";\n *\n * const greet = {\n *   description: \"...\",\n *   input: z.object({ name: z.string() }),\n *   handler: async (input, ctx) => `hello ${input.name}`,\n * };\n *\n * const out = await testFn(greet, { name: \"alice\" });\n * expect(out).toBe(\"hello alice\");\n * ```\n */\nexport async function testFn<TIn, TOut>(\n  spec: TestFnSpec<TIn, TOut>,\n  input: unknown,\n  options: TestFnOptions = {},\n): Promise<TOut> {\n  const standard = (spec.input as { [\"~standard\"]?: { validate?: unknown } })[\n    \"~standard\"\n  ];\n  if (typeof standard?.validate !== \"function\") {\n    throw rcError(\"RC5003\", undefined, {\n      message: `testFn: spec.input must be a Standard Schema with a callable validate.`,\n    });\n  }\n\n  const validate = standard.validate as (\n    value: unknown,\n  ) =>\n    | { value?: unknown; issues?: unknown }\n    | Promise<{ value?: unknown; issues?: unknown }>;\n  let result = validate(input);\n  if (result instanceof Promise) result = await result;\n  if (result.issues !== undefined && result.issues !== null) {\n    throw rcError(\"RC5002\", undefined, {\n      message: `testFn: input validation failed: ${formatSchemaIssues(result.issues)}`,\n    });\n  }\n\n  const ctx: TestFnHandlerContext = {\n    logger: options.logger ?? defaultLogger.child({ test: \"fn\" }),\n    abortSignal: options.signal ?? new AbortController().signal,\n  };\n\n  const validated = \"value\" in result ? (result.value as TIn) : (input as TIn);\n  return (await spec.handler(validated, ctx)) as TOut;\n}\n","import type {\n  CraftContext,\n  Exchange,\n  ExchangeHeaders,\n  OnParseError,\n  SourceMeta,\n  Subscription,\n} from \"@routecraft/routecraft\";\n\n/**\n * Options for {@link testSubscription}. The `handler` mirrors the message\n * fields the engine receives, flattened into positional arguments so test\n * assertions read naturally.\n */\nexport interface TestSubscriptionOptions<T = unknown> {\n  /** Context handed to the source (store access, logger). */\n  context: CraftContext;\n  /** Receives each emitted message; its return value resolves `emit`. */\n  handler: (\n    message: T,\n    headers?: ExchangeHeaders,\n    parse?: (raw: unknown) => unknown | Promise<unknown>,\n    parseFailureMode?: OnParseError,\n  ) => Promise<unknown> | unknown;\n  /** Abort to stop the source; `complete()` calls its `abort`. */\n  abortController?: AbortController;\n  /** Called when the source signals readiness. */\n  onReady?: () => void;\n  /** Source meta; defaults to `{ routeId: \"test\" }`. */\n  meta?: SourceMeta;\n}\n\n/**\n * Build a {@link Subscription} for driving a source adapter directly in a\n * unit test, without a running route. Wire-up mirrors the engine: `emit`\n * forwards to `handler`, `ready` to `onReady`, `complete` aborts the\n * controller, and `signal` observes it.\n *\n * @example\n * ```typescript\n * const received: unknown[] = [];\n * await adapter.subscribe(\n *   testSubscription({\n *     context: t.ctx,\n *     handler: (message) => void received.push(message),\n *     abortController,\n *   }),\n * );\n * ```\n */\nexport function testSubscription<T = unknown>(\n  options: TestSubscriptionOptions<T>,\n): Subscription<T> {\n  const controller = options.abortController ?? new AbortController();\n  return {\n    context: options.context,\n    signal: controller.signal,\n    meta: options.meta ?? { routeId: \"test\" },\n    ready: options.onReady ?? (() => {}),\n    complete: (reason?: unknown) => controller.abort(reason),\n    emit: async (msg) =>\n      (await options.handler(\n        msg.message,\n        msg.headers,\n        msg.parse,\n        msg.parseFailureMode,\n      )) as Exchange,\n  };\n}\n","import { readFileSync } from \"node:fs\";\n\n// Re-export test context utilities\nexport {\n  TestContext,\n  TestContextBuilder,\n  testContext,\n  type TestContextOptions,\n  type TestOptions,\n} from \"./test-context\";\n\n// Re-export spy logger utilities\nexport {\n  createSpyFn,\n  createSpyLogger,\n  createNoopSpyLogger,\n  type SpyFn,\n  type SpyFactory,\n  type SpyLogger,\n} from \"./spy-logger\";\n\n// Re-export pseudo adapter\nexport {\n  pseudo,\n  type PseudoOptions,\n  type PseudoKeyedOptions,\n} from \"./adapters/pseudo\";\n\n// Re-export spy adapter\nexport { spy, type SpyAdapter } from \"./adapters/spy\";\n\n// Adapter mocking API\nexport {\n  mockAdapter,\n  type AdapterMock,\n  type MockAdapterBehavior,\n} from \"./mock-adapter\";\n\n// Source fixture helper: attach headers to a source-role mock fixture so\n// routes that read `routecraft.<adapter>.*` headers can be exercised.\nexport { sourceMessage } from \"./source-message\";\n\n// Test helper for fn-like specs (schema + handler). Used to exercise\n// fns registered in `@routecraft/ai`'s agentPlugin without depending on\n// any non-public dispatcher.\nexport {\n  testFn,\n  type TestFnHandlerContext,\n  type TestFnOptions,\n  type TestFnSpec,\n} from \"./test-fn\";\n\n/**\n * Load a JSON fixture file and return the parsed value.\n *\n * @param path Absolute or relative path to the JSON file\n * @returns Parsed JSON as T\n */\nexport function fixture<T = unknown>(path: string): T {\n  return JSON.parse(readFileSync(path, \"utf-8\")) as T;\n}\n\n/**\n * Fixture entry must have a `name` field used as the test name.\n */\nexport interface FixtureWithName {\n  name: string;\n  [key: string]: unknown;\n}\n\n/**\n * A test runner's `test` function, as accepted by {@link fixtureEach}.\n * Both `test` from bun:test and `test` from Vitest satisfy this shape.\n */\nexport type FixtureTestFn = (\n  name: string,\n  fn: () => void | Promise<void>,\n) => unknown;\n\n/**\n * Load a JSON array fixture and run one test per entry. Each entry must have\n * a `name` field (used as the test name). Runner-agnostic: pass your runner's\n * `test` function (bun:test, Vitest, node:test).\n *\n * @param path Path to a JSON file that parses to an array\n * @param test The runner's `test` function used to register each entry\n * @param run Callback invoked per entry; use for assertions. Receives the fixture entry.\n *\n * @example\n * import { test } from \"bun:test\";\n * fixtureEach(\"./cases.json\", test, (entry) => {\n *   expect(run(entry.input)).toEqual(entry.expected);\n * });\n */\nexport function fixtureEach<T extends FixtureWithName>(\n  path: string,\n  test: FixtureTestFn,\n  run: (entry: T) => void | Promise<void>,\n): void {\n  const entries = fixture<T[]>(path);\n  if (!Array.isArray(entries)) {\n    throw new Error(\n      `fixture.each: expected JSON array at \"${path}\", got ${typeof entries}`,\n    );\n  }\n  for (const entry of entries) {\n    if (typeof entry?.name !== \"string\") {\n      throw new Error(\n        `fixture.each: each entry must have a \"name\" field (string). Got: ${JSON.stringify(entry)}`,\n      );\n    }\n    test(entry.name, () => run(entry));\n  }\n}\n\n// Subscription builder for driving source adapters directly in unit tests\nexport {\n  testSubscription,\n  type TestSubscriptionOptions,\n} from \"./test-subscription\";\n"]}