@routecraft/testing 0.6.0-canary.8 → 0.6.0

package/README.md

@@ -1,6 +1,6 @@
 # @routecraft/testing
 
-Test utilities for Routecraft capabilities. Use with [Vitest](https://vitest.dev) to run capability lifecycles and assert on output, logs, and errors.
+Test utilities for Routecraft capabilities. Runner-agnostic: works with `bun test`, [Vitest](https://vitest.dev), and `node:test` to run capability lifecycles and assert on output, logs, and errors.
 
 ## Installation
 
@@ -14,12 +14,12 @@ pnpm add -D @routecraft/testing
 yarn add -D @routecraft/testing
 ```
 
-Install as a devDependency. Requires `vitest` (>=4.0.0) and `@routecraft/routecraft`.
+Install as a devDependency. Requires `@routecraft/routecraft`. No test runner dependency: bun test, Vitest, and node:test all work out of the box.
 
 ## Quick Start
 
 ```typescript
-import { describe, it, expect, afterEach } from 'vitest';
+import { describe, it, expect, afterEach, vi } from 'vitest';
 import { testContext, type TestContext } from '@routecraft/testing';
 import { craft, simple, log } from '@routecraft/routecraft';
 
@@ -36,7 +36,10 @@ describe('send-email capability', () => {
       .from(simple({ to: 'user@example.com', subject: 'Hello' }))
       .to(log());
 
-    t = await testContext().routes(capability).build();
+    // Pass your runner's mock factory for native matcher support
+    // (vi.fn for Vitest, mock from bun:test). Omit { fn } to use the
+    // built-in runner-agnostic spy and assert via t.logger.info.mock.calls.
+    t = await testContext({ fn: vi.fn }).routes(capability).build();
     await t.test();
 
     expect(t.logger.info).toHaveBeenCalled();
@@ -46,28 +49,29 @@ describe('send-email capability', () => {
 
 ## API
 
-### `testContext()`
+### `testContext(options?)`
 
-Returns a builder. Call `.routes(...).build()` to get a `TestContext`.
+Returns a builder. Call `.routes(...).build()` to get a `TestContext`. Options include `fn` (your runner's mock factory, for native matcher support on `t.logger`) and `routesReadyTimeoutMs`.
 
 ### `TestContext`
 
 Wrapper around `CraftContext` with:
 
 - **`ctx`** -- The underlying context.
-- **`logger`** -- A spy logger (Vitest `vi.fn()` methods) for asserting on log calls.
+- **`logger`** -- A runner-agnostic spy logger. Inspect calls via `t.logger.info.mock.calls`, or build the context with your runner's mock factory (`testContext({ fn: vi.fn })` for Vitest, `testContext({ fn: mock })` for bun:test) to use native matchers like `toHaveBeenCalledWith`.
 - **`errors`** -- Collected capability errors.
 - **`test(options?)`** -- Runs start, waits for capabilities to be ready, optionally delays, drains, then stops. Assert after `await t.test()`.
-- **`startAndWaitReady()`** -- Starts the context and waits for all capabilities to be ready without draining. Use with `t.client.send()` to send to a direct endpoint, then call `stop()` when done.
+- **`startAndWaitReady()`** -- Starts the context and waits for all capabilities to be ready without draining. Use with `t.client.sendDirect()` to send to a direct endpoint, then call `stop()` when done.
+- **`client`** -- The `CraftClient` for the context; `t.client.sendDirect(endpoint, body, headers?)` dispatches to a direct endpoint (see below).
 - **`stop()`** / **`drain()`** -- Lifecycle helpers.
 
-### `t.client.send(endpoint, body, headers?)`
+### `t.client.sendDirect(endpoint, body, headers?)`
 
 Send a message to a direct endpoint and return the result via the `CraftClient`. Use with `startAndWaitReady()`.
 
 ```typescript
 await t.startAndWaitReady();
-const result = await t.client.send('send-email', { to: 'user@example.com' });
+const result = await t.client.sendDirect('send-email', { to: 'user@example.com' });
 await t.stop();
 ```
 

package/dist/index.cjs

@@ -1,2 +1,2 @@
-'use strict';var fs=require('fs'),vitest=require('vitest'),routecraft=require('@routecraft/routecraft');function y(){let t={info:vitest.vi.fn(),debug:vitest.vi.fn(),warn:vitest.vi.fn(),error:vitest.vi.fn(),trace:vitest.vi.fn(),fatal:vitest.vi.fn(),child:vitest.vi.fn()};return t.child.mockImplementation(()=>t),t}function g(){let t=vitest.vi.fn(),e=vitest.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(routecraft.isRoutecraftError(o)?o:routecraft.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 routecraft.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=routecraft.logger.child.bind(routecraft.logger);routecraft.logger.child=vitest.vi.fn(()=>e);let{context:n,client:s}=await this.builder.build();if(this.adapterOverrides.length>0){let i=n.getStore(routecraft.RC_ADAPTER_OVERRIDES)??[];n.setStore(routecraft.RC_ADAPTER_OVERRIDES,[...i,...this.adapterOverrides]);}let o={...this.routesReadyTimeoutMs!==void 0?{routesReadyTimeoutMs:this.routesReadyTimeoutMs}:{},spyLogger:e,restoreLoggerChild:()=>{routecraft.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?.[routecraft.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 routecraft.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 routecraft.rcError("RC5002",void 0,{message:`testFn: input validation failed: ${routecraft.formatSchemaIssues(o.issues)}`});let i={logger:r.logger??routecraft.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(fs.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)}`);vitest.test(n.name,()=>e(n));}}exports.TestContext=p;exports.TestContextBuilder=c;exports.createNoopSpyLogger=g;exports.createSpyLogger=y;exports.fixture=H;exports.fixtureEach=ie;exports.mockAdapter=O;exports.pseudo=L;exports.spy=K;exports.testContext=M;exports.testFn=B;//# sourceMappingURL=index.cjs.map
+'use strict';var fs=require('fs'),routecraft=require('@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(routecraft.isRoutecraftError(n)?n:routecraft.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 routecraft.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=routecraft.logger.child.bind(routecraft.logger),o=this.spyFactory();o.mockImplementation(()=>e),routecraft.logger.child=o;let s;try{s=await this.builder.build();}catch(d){throw routecraft.logger.child=r,d}let{context:n,client:i}=s;if(this.adapterOverrides.length>0){let d=n.getStore(routecraft.RC_ADAPTER_OVERRIDES)??[];n.setStore(routecraft.RC_ADAPTER_OVERRIDES,[...d,...this.adapterOverrides]);}let a={...this.routesReadyTimeoutMs!==void 0?{routesReadyTimeoutMs:this.routesReadyTimeoutMs}:{},spyLogger:e,restoreLoggerChild:()=>{routecraft.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?{[routecraft.SOURCE_FIXTURE]:true,body:t}:{[routecraft.SOURCE_FIXTURE]:true,body:t,headers:e}}async function N(t,e,r={}){let o=t.input["~standard"];if(typeof o?.validate!="function")throw routecraft.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 routecraft.rcError("RC5002",void 0,{message:`testFn: input validation failed: ${routecraft.formatSchemaIssues(n.issues)}`});let i={logger:r.logger??routecraft.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(fs.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));}}exports.TestContext=p;exports.TestContextBuilder=l;exports.createNoopSpyLogger=g;exports.createSpyFn=u;exports.createSpyLogger=f;exports.fixture=$;exports.fixtureEach=de;exports.mockAdapter=F;exports.pseudo=L;exports.sourceMessage=K;exports.spy=I;exports.testContext=M;exports.testFn=N;exports.testSubscription=H;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.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":"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","file":"index.cjs","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.cjs","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"]}