@routecraft/testing 0.5.0-canary.3 → 0.5.0-canary.5

package/README.md

@@ -58,16 +58,16 @@ Wrapper around `CraftContext` with:
 - **`logger`** -- A spy logger (Vitest `vi.fn()` methods) for asserting on log calls.
 - **`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.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.send()` to send to a direct endpoint, then call `stop()` when done.
 - **`stop()`** / **`drain()`** -- Lifecycle helpers.
 
-### `t.send(endpoint, body, headers?)`
+### `t.client.send(endpoint, body, headers?)`
 
-Send a message to a direct endpoint and return the result. Use with `startAndWaitReady()`.
+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.send('send-email', { to: 'user@example.com' });
+const result = await t.client.send('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 m(){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 R(){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 k=200,f=class{ctx;logger;errors=[];routesReadyTimeoutMs;restoreLoggerChild;loggerChildRestored=false;startedPromise;constructor(e,r){this.ctx=e,this.logger=r?.spyLogger??R(),r?.restoreLoggerChild&&(this.restoreLoggerChild=r.restoreLoggerChild),this.routesReadyTimeoutMs=r?.routesReadyTimeoutMs??k;let o=n=>{this.errors.push(routecraft.isRoutecraftError(n)?n:routecraft.rcError("RC9901",n));};e.on("context:error",n=>{o(n.details.error);});}async startAndWaitReady(){let e=this.ctx,r=e.getRoutes().length,o=r===0?Promise.resolve():new Promise((n,a)=>{let i=0,s=false,p=setTimeout(()=>{s||(s=true,d(),c(),a(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),d=e.on("route:*:started",(()=>{s||(i++,i>=r&&(s=true,clearTimeout(p),d(),c(),n()));})),c=e.on("context:error",g=>{s||(s=true,clearTimeout(p),d(),c(),a(g.details.error));});});this.startedPromise=e.start(),await Promise.all([this.startedPromise,o]);}async test(e){let r=this.ctx,o=r.getRoutes().length,n=o===0?Promise.resolve():new Promise((i,s)=>{let p=0,d=false,c=setTimeout(()=>{d||(h(),s(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),g=r.on("route:*:started",(()=>{d||(p++,p>=o&&(h(),i()));})),T=r.on("context:error",w=>{d||(h(),s(w.details.error));});function h(){d||(d=true,g(),T(),c!==void 0&&(clearTimeout(c),c=void 0));}}),a=r.start();try{await n;let i=e?.delayBeforeDrainMs??0;i>0&&await new Promise(s=>setTimeout(s,i)),await r.drain();}finally{try{await r.stop(),await a;}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);}async send(e,r,o){let n=this.ctx.getStore(routecraft.ADAPTER_DIRECT_STORE),a=routecraft.sanitizeEndpoint(e),i=n?.get(a);if(!i)throw new Error(`No direct channel for endpoint "${e}". Did you call startAndWaitReady() first?`);let s=new routecraft.DefaultExchange(this.ctx,{body:r,...o!==void 0&&{headers:o}});return (await i.send(a,s)).body}},l=class{builder=new routecraft.ContextBuilder;routesReadyTimeoutMs;routesReadyTimeout(e){return this.routesReadyTimeoutMs=e,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=m(),r=routecraft.logger.child.bind(routecraft.logger);routecraft.logger.child=vitest.vi.fn(()=>e);let o=await this.builder.build(),n={...this.routesReadyTimeoutMs!==void 0?{routesReadyTimeoutMs:this.routesReadyTimeoutMs}:{},spyLogger:e,restoreLoggerChild:()=>{routecraft.logger.child=r;}};return new f(o,n)}};function A(){return new l}function x(t,e){let r=()=>{throw new Error(`Pseudo adapter "${t}" is not implemented. Replace with a real adapter.`)},o=()=>Promise.resolve(void 0),n=i=>i,a=(i,s,p,d)=>(d?.(),Promise.resolve());return {adapterId:`routecraft.adapter.pseudo.${t}`,subscribe:e==="noop"?a:r,send:e==="noop"?o:r,process:e==="noop"?n:r}}function F(t="pseudo",e){let r=e?.runtime??"throw";return e&&"args"in e&&e.args==="keyed"?(n,a)=>x(t,r):n=>x(t,r)}function v(){return {received:[],calls:{send:0,process:0,enrich:0}}}function N(){let t=v();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)}}}function I(t){return JSON.parse(fs.readFileSync(t,"utf-8"))}function Z(t,e){let r=I(t);if(!Array.isArray(r))throw new Error(`fixture.each: expected JSON array at "${t}", got ${typeof r}`);for(let o of r){if(typeof o?.name!="string")throw new Error(`fixture.each: each entry must have a "name" field (string). Got: ${JSON.stringify(o)}`);vitest.test(o.name,()=>e(o));}}exports.TestContext=f;exports.TestContextBuilder=l;exports.createNoopSpyLogger=R;exports.createSpyLogger=m;exports.fixture=I;exports.fixtureEach=Z;exports.pseudo=F;exports.spy=N;exports.testContext=A;//# sourceMappingURL=index.cjs.map
+'use strict';var fs=require('fs'),vitest=require('vitest'),routecraft=require('@routecraft/routecraft');function h(){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 R(){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 O=200,f=class{ctx;client;logger;errors=[];routesReadyTimeoutMs;restoreLoggerChild;loggerChildRestored=false;startedPromise;constructor(e,r,o){this.ctx=e,this.client=r,this.logger=o?.spyLogger??R(),o?.restoreLoggerChild&&(this.restoreLoggerChild=o.restoreLoggerChild),this.routesReadyTimeoutMs=o?.routesReadyTimeoutMs??O;let s=n=>{this.errors.push(routecraft.isRoutecraftError(n)?n:routecraft.rcError("RC9901",n));};e.on("context:error",n=>{s(n.details.error);});}async startAndWaitReady(){let e=this.ctx,r=e.getRoutes().length,o=r===0?Promise.resolve():new Promise((s,n)=>{let d=0,i=false,c=setTimeout(()=>{i||(i=true,a(),p(),n(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),a=e.on("route:*:started",(()=>{i||(d++,d>=r&&(i=true,clearTimeout(c),a(),p(),s()));})),p=e.on("context:error",g=>{i||(i=true,clearTimeout(c),a(),p(),n(g.details.error));});});this.startedPromise=e.start(),await Promise.all([this.startedPromise,o]);}async test(e){let r=this.ctx,o=r.getRoutes().length,s=o===0?Promise.resolve():new Promise((d,i)=>{let c=0,a=false,p=setTimeout(()=>{a||(m(),i(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),g=r.on("route:*:started",(()=>{a||(c++,c>=o&&(m(),d()));})),T=r.on("context:error",w=>{a||(m(),i(w.details.error));});function m(){a||(a=true,g(),T(),p!==void 0&&(clearTimeout(p),p=void 0));}}),n=r.start();try{await s;let d=e?.delayBeforeDrainMs??0;d>0&&await new Promise(i=>setTimeout(i,d)),await r.drain();}finally{try{await r.stop(),await n;}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;routesReadyTimeout(e){return this.routesReadyTimeoutMs=e,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=h(),r=routecraft.logger.child.bind(routecraft.logger);routecraft.logger.child=vitest.vi.fn(()=>e);let{context:o,client:s}=await this.builder.build(),n={...this.routesReadyTimeoutMs!==void 0?{routesReadyTimeoutMs:this.routesReadyTimeoutMs}:{},spyLogger:e,restoreLoggerChild:()=>{routecraft.logger.child=r;}};return new f(o,s,n)}};function b(){return new l}function v(t,e){let r=()=>{throw new Error(`Pseudo adapter "${t}" is not implemented. Replace with a real adapter.`)},o=()=>Promise.resolve(void 0),s=d=>d,n=(d,i,c,a)=>(a?.(),Promise.resolve());return {adapterId:`routecraft.adapter.pseudo.${t}`,subscribe:e==="noop"?n:r,send:e==="noop"?o: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,n)=>v(t,r):s=>v(t,r)}function x(){return {received:[],calls:{send:0,process:0,enrich:0}}}function F(){let t=x();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)}}}function M(t){return JSON.parse(fs.readFileSync(t,"utf-8"))}function V(t,e){let r=M(t);if(!Array.isArray(r))throw new Error(`fixture.each: expected JSON array at "${t}", got ${typeof r}`);for(let o of r){if(typeof o?.name!="string")throw new Error(`fixture.each: each entry must have a "name" field (string). Got: ${JSON.stringify(o)}`);vitest.test(o.name,()=>e(o));}}exports.TestContext=f;exports.TestContextBuilder=l;exports.createNoopSpyLogger=R;exports.createSpyLogger=h;exports.fixture=M;exports.fixtureEach=V;exports.pseudo=L;exports.spy=F;exports.testContext=b;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/spy-logger.ts","../src/test-context.ts","../src/adapters/pseudo/index.ts","../src/adapters/spy/shared.ts","../src/adapters/spy/index.ts","../src/index.ts"],"names":["createSpyLogger","spy","vi","createNoopSpyLogger","noop","childFn","noopLogger","DEFAULT_ROUTES_READY_TIMEOUT_MS","TestContext","ctx","options","pushError","err","isRoutecraftError","rcError","payload","total","allReady","resolve","reject","ready","settled","timeoutId","offRouteStarted","offError","cleanup","started","delayMs","endpoint","body","headers","store","ADAPTER_DIRECT_STORE","sanitized","sanitizeEndpoint","channel","exchange","DefaultExchange","TestContextBuilder","ContextBuilder","ms","config","event","handler","key","value","routes","spyLogger","originalChild","logger","testContext","createAdapter","name","runtime","fail","noopSend","noopProcess","noopSubscribe","_context","_handler","_abortController","onReady","pseudo","opts","createSpyState","state","HeadersKeys","fixture","path","readFileSync","fixtureEach","run","entries","entry","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 *\n * @beta\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\n/** @beta */\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\n/** @beta */\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 { vi } from \"vitest\";\nimport type {\n  CraftContext,\n  CraftConfig,\n  StoreRegistry,\n  EventName,\n  EventHandler,\n  RouteDefinition,\n  RouteBuilder,\n  Exchange,\n  ExchangeHeaders,\n} from \"@routecraft/routecraft\";\nimport {\n  ContextBuilder,\n  DefaultExchange,\n  ADAPTER_DIRECT_STORE,\n  sanitizeEndpoint,\n  isRoutecraftError,\n  RoutecraftError,\n  rcError,\n  logger,\n} from \"@routecraft/routecraft\";\nimport type { SpyLogger } from \"./spy-logger\";\nimport { createSpyLogger, createNoopSpyLogger } from \"./spy-logger\";\n\nconst DEFAULT_ROUTES_READY_TIMEOUT_MS = 200;\n\nexport interface TestContextOptions {\n  /** Timeout in ms for waiting for all routes to emit routeStarted. Default 200. */\n  routesReadyTimeoutMs?: number;\n}\n\n/** Options for TestContext.test(). */\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 *\n * @beta\n */\nexport class TestContext {\n  readonly ctx: CraftContext;\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    options?: TestContextOptions & {\n      spyLogger?: SpyLogger;\n      restoreLoggerChild?: () => void;\n    },\n  ) {\n    this.ctx = ctx;\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   * Start context and wait for all routes to be ready. Does not drain or stop.\n   * Use with invoke() to send to a route by id, then call drain()/stop() when done.\n   */\n  async startAndWaitReady(): Promise<void> {\n    const ctx = this.ctx;\n    const total = ctx.getRoutes().length;\n    const allReady =\n      total === 0\n        ? Promise.resolve()\n        : new Promise<void>((resolve, reject) => {\n            let ready = 0;\n            let settled = false;\n            const timeoutId = setTimeout(() => {\n              if (settled) return;\n              settled = true;\n              offRouteStarted();\n              offError();\n              reject(new Error(\"Timeout waiting for routes to start\"));\n            }, this.routesReadyTimeoutMs);\n\n            const offRouteStarted = ctx.on(\n              \"route:*:started\" as EventName,\n              (() => {\n                if (settled) return;\n                ready++;\n                if (ready >= total) {\n                  settled = true;\n                  clearTimeout(timeoutId);\n                  offRouteStarted();\n                  offError();\n                  resolve();\n                }\n              }) as EventHandler<EventName>,\n            );\n            const offError = ctx.on(\"context:error\", (payload) => {\n              if (settled) return;\n              settled = true;\n              clearTimeout(timeoutId);\n              offRouteStarted();\n              offError();\n              reject(payload.details.error);\n            });\n          });\n    this.startedPromise = ctx.start();\n    await Promise.all([this.startedPromise, 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 total = ctx.getRoutes().length;\n    const allReady =\n      total === 0\n        ? Promise.resolve()\n        : new Promise<void>((resolve, reject) => {\n            let ready = 0;\n            let settled = false;\n            let timeoutId: ReturnType<typeof setTimeout> | undefined =\n              setTimeout(() => {\n                if (settled) return;\n                cleanup();\n                reject(new Error(\"Timeout waiting for routes to start\"));\n              }, this.routesReadyTimeoutMs);\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    const started = ctx.start();\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   * Send a message to a direct endpoint and return the result.\n   * Use after {@link startAndWaitReady} so the channel exists.\n   *\n   * @param endpoint Direct endpoint name (must match the endpoint string passed to `direct(endpoint, options)`)\n   * @param body Request body\n   * @param headers Optional exchange headers\n   * @returns The response body from the route\n   */\n  async send<T = unknown, R = T>(\n    endpoint: string,\n    body: T,\n    headers?: ExchangeHeaders,\n  ): Promise<R> {\n    const store = this.ctx.getStore(ADAPTER_DIRECT_STORE);\n    const sanitized = sanitizeEndpoint(endpoint);\n    const channel = store?.get(sanitized);\n    if (!channel) {\n      throw new Error(\n        `No direct channel for endpoint \"${endpoint}\". Did you call startAndWaitReady() first?`,\n      );\n    }\n    const exchange = new DefaultExchange(this.ctx, {\n      body,\n      ...(headers !== undefined && { headers }),\n    });\n    const result = await channel.send(sanitized, exchange);\n    return (result as Exchange).body as R;\n  }\n}\n\n/**\n * Builder that returns TestContext instead of CraftContext.\n * Same API as ContextBuilder (routes, on, with, store).\n *\n * @beta\n */\nexport class TestContextBuilder {\n  private builder = new ContextBuilder();\n  private routesReadyTimeoutMs: number | undefined;\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  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 ctx = await this.builder.build();\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, options);\n  }\n}\n\n/**\n * Create a test context builder. Use .routes(...).build(), await the result, then await t.test().\n *\n * @beta\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 * @experimental\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 * @experimental\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 { 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 PseudoAdapter,\n  type PseudoFactory,\n  type PseudoKeyedFactory,\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/**\n * Load a JSON fixture file and return the parsed value.\n *\n * @beta\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/** Fixture entry must have a `name` field used as the vitest test name. */\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 * @beta\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/test-context.ts","../src/adapters/pseudo/index.ts","../src/adapters/spy/shared.ts","../src/adapters/spy/index.ts","../src/index.ts"],"names":["createSpyLogger","spy","vi","createNoopSpyLogger","noop","childFn","noopLogger","DEFAULT_ROUTES_READY_TIMEOUT_MS","TestContext","ctx","client","options","pushError","err","isRoutecraftError","rcError","payload","total","allReady","resolve","reject","ready","settled","timeoutId","offRouteStarted","offError","cleanup","started","delayMs","TestContextBuilder","ContextBuilder","ms","config","event","handler","key","value","routes","spyLogger","originalChild","logger","testContext","createAdapter","name","runtime","fail","noopSend","noopProcess","exchange","noopSubscribe","_context","_handler","_abortController","onReady","pseudo","opts","createSpyState","state","HeadersKeys","fixture","path","readFileSync","fixtureEach","run","entries","entry","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 *\n * @beta\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\n/** @beta */\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\n/** @beta */\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 { vi } from \"vitest\";\nimport type {\n  CraftContext,\n  CraftConfig,\n  StoreRegistry,\n  EventName,\n  EventHandler,\n  RouteDefinition,\n  RouteBuilder,\n} from \"@routecraft/routecraft\";\nimport {\n  ContextBuilder,\n  CraftClient,\n  isRoutecraftError,\n  RoutecraftError,\n  rcError,\n  logger,\n} from \"@routecraft/routecraft\";\nimport type { SpyLogger } from \"./spy-logger\";\nimport { createSpyLogger, createNoopSpyLogger } from \"./spy-logger\";\n\nconst DEFAULT_ROUTES_READY_TIMEOUT_MS = 200;\n\nexport interface TestContextOptions {\n  /** Timeout in ms for waiting for all routes to emit routeStarted. Default 200. */\n  routesReadyTimeoutMs?: number;\n}\n\n/** Options for TestContext.test(). */\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 *\n * @beta\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   * Start context and wait for all routes to be ready. Does not drain or stop.\n   * Use with invoke() to send to a route by id, then call drain()/stop() when done.\n   */\n  async startAndWaitReady(): Promise<void> {\n    const ctx = this.ctx;\n    const total = ctx.getRoutes().length;\n    const allReady =\n      total === 0\n        ? Promise.resolve()\n        : new Promise<void>((resolve, reject) => {\n            let ready = 0;\n            let settled = false;\n            const timeoutId = setTimeout(() => {\n              if (settled) return;\n              settled = true;\n              offRouteStarted();\n              offError();\n              reject(new Error(\"Timeout waiting for routes to start\"));\n            }, this.routesReadyTimeoutMs);\n\n            const offRouteStarted = ctx.on(\n              \"route:*:started\" as EventName,\n              (() => {\n                if (settled) return;\n                ready++;\n                if (ready >= total) {\n                  settled = true;\n                  clearTimeout(timeoutId);\n                  offRouteStarted();\n                  offError();\n                  resolve();\n                }\n              }) as EventHandler<EventName>,\n            );\n            const offError = ctx.on(\"context:error\", (payload) => {\n              if (settled) return;\n              settled = true;\n              clearTimeout(timeoutId);\n              offRouteStarted();\n              offError();\n              reject(payload.details.error);\n            });\n          });\n    this.startedPromise = ctx.start();\n    await Promise.all([this.startedPromise, 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 total = ctx.getRoutes().length;\n    const allReady =\n      total === 0\n        ? Promise.resolve()\n        : new Promise<void>((resolve, reject) => {\n            let ready = 0;\n            let settled = false;\n            let timeoutId: ReturnType<typeof setTimeout> | undefined =\n              setTimeout(() => {\n                if (settled) return;\n                cleanup();\n                reject(new Error(\"Timeout waiting for routes to start\"));\n              }, this.routesReadyTimeoutMs);\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    const started = ctx.start();\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 *\n * @beta\n */\nexport class TestContextBuilder {\n  private builder = new ContextBuilder();\n  private routesReadyTimeoutMs: number | undefined;\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  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    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 * @beta\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 * @experimental\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 * @experimental\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 { 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 PseudoAdapter,\n  type PseudoFactory,\n  type PseudoKeyedFactory,\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/**\n * Load a JSON fixture file and return the parsed value.\n *\n * @beta\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/** Fixture entry must have a `name` field used as the vitest test name. */\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 * @beta\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"]}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { CraftContext, RoutecraftError, ExchangeHeaders, CraftConfig, EventName, EventHandler, StoreRegistry, RouteDefinition, RouteBuilder, Source, Destination, Processor, Exchange } from '@routecraft/routecraft';
+import { CraftContext, CraftClient, RoutecraftError, CraftConfig, EventName, EventHandler, StoreRegistry, RouteDefinition, RouteBuilder, Source, Destination, Processor, Exchange } from '@routecraft/routecraft';
 import { vi } from 'vitest';
 
 /**
@@ -42,6 +42,8 @@ interface TestOptions {
  */
 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(...) */
     readonly logger: SpyLogger;
     readonly errors: RoutecraftError[];
@@ -49,7 +51,7 @@ declare class TestContext {
     private restoreLoggerChild?;
     private loggerChildRestored;
     private startedPromise?;
-    constructor(ctx: CraftContext, options?: TestContextOptions & {
+    constructor(ctx: CraftContext, client: CraftClient, options?: TestContextOptions & {
         spyLogger?: SpyLogger;
         restoreLoggerChild?: () => void;
     });
@@ -69,16 +71,6 @@ declare class TestContext {
     drain(): Promise<void>;
     stop(): Promise<void>;
     private restoreLoggerChildOnce;
-    /**
-     * Send a message to a direct endpoint and return the result.
-     * Use after {@link startAndWaitReady} so the channel exists.
-     *
-     * @param endpoint Direct endpoint name (must match the endpoint string passed to `direct(endpoint, options)`)
-     * @param body Request body
-     * @param headers Optional exchange headers
-     * @returns The response body from the route
-     */
-    send<T = unknown, R = T>(endpoint: string, body: T, headers?: ExchangeHeaders): Promise<R>;
 }
 /**
  * Builder that returns TestContext instead of CraftContext.

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { CraftContext, RoutecraftError, ExchangeHeaders, CraftConfig, EventName, EventHandler, StoreRegistry, RouteDefinition, RouteBuilder, Source, Destination, Processor, Exchange } from '@routecraft/routecraft';
+import { CraftContext, CraftClient, RoutecraftError, CraftConfig, EventName, EventHandler, StoreRegistry, RouteDefinition, RouteBuilder, Source, Destination, Processor, Exchange } from '@routecraft/routecraft';
 import { vi } from 'vitest';
 
 /**
@@ -42,6 +42,8 @@ interface TestOptions {
  */
 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(...) */
     readonly logger: SpyLogger;
     readonly errors: RoutecraftError[];
@@ -49,7 +51,7 @@ declare class TestContext {
     private restoreLoggerChild?;
     private loggerChildRestored;
     private startedPromise?;
-    constructor(ctx: CraftContext, options?: TestContextOptions & {
+    constructor(ctx: CraftContext, client: CraftClient, options?: TestContextOptions & {
         spyLogger?: SpyLogger;
         restoreLoggerChild?: () => void;
     });
@@ -69,16 +71,6 @@ declare class TestContext {
     drain(): Promise<void>;
     stop(): Promise<void>;
     private restoreLoggerChildOnce;
-    /**
-     * Send a message to a direct endpoint and return the result.
-     * Use after {@link startAndWaitReady} so the channel exists.
-     *
-     * @param endpoint Direct endpoint name (must match the endpoint string passed to `direct(endpoint, options)`)
-     * @param body Request body
-     * @param headers Optional exchange headers
-     * @returns The response body from the route
-     */
-    send<T = unknown, R = T>(endpoint: string, body: T, headers?: ExchangeHeaders): Promise<R>;
 }
 /**
  * Builder that returns TestContext instead of CraftContext.

package/dist/index.js

@@ -1,2 +1,2 @@
-import {readFileSync}from'fs';import {vi,test}from'vitest';import {ADAPTER_DIRECT_STORE,sanitizeEndpoint,DefaultExchange,ContextBuilder,logger,HeadersKeys,isRoutecraftError,rcError}from'@routecraft/routecraft';function m(){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 R(){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 k=200,f=class{ctx;logger;errors=[];routesReadyTimeoutMs;restoreLoggerChild;loggerChildRestored=false;startedPromise;constructor(e,r){this.ctx=e,this.logger=r?.spyLogger??R(),r?.restoreLoggerChild&&(this.restoreLoggerChild=r.restoreLoggerChild),this.routesReadyTimeoutMs=r?.routesReadyTimeoutMs??k;let o=n=>{this.errors.push(isRoutecraftError(n)?n:rcError("RC9901",n));};e.on("context:error",n=>{o(n.details.error);});}async startAndWaitReady(){let e=this.ctx,r=e.getRoutes().length,o=r===0?Promise.resolve():new Promise((n,a)=>{let i=0,s=false,p=setTimeout(()=>{s||(s=true,d(),c(),a(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),d=e.on("route:*:started",(()=>{s||(i++,i>=r&&(s=true,clearTimeout(p),d(),c(),n()));})),c=e.on("context:error",g=>{s||(s=true,clearTimeout(p),d(),c(),a(g.details.error));});});this.startedPromise=e.start(),await Promise.all([this.startedPromise,o]);}async test(e){let r=this.ctx,o=r.getRoutes().length,n=o===0?Promise.resolve():new Promise((i,s)=>{let p=0,d=false,c=setTimeout(()=>{d||(h(),s(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),g=r.on("route:*:started",(()=>{d||(p++,p>=o&&(h(),i()));})),T=r.on("context:error",w=>{d||(h(),s(w.details.error));});function h(){d||(d=true,g(),T(),c!==void 0&&(clearTimeout(c),c=void 0));}}),a=r.start();try{await n;let i=e?.delayBeforeDrainMs??0;i>0&&await new Promise(s=>setTimeout(s,i)),await r.drain();}finally{try{await r.stop(),await a;}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);}async send(e,r,o){let n=this.ctx.getStore(ADAPTER_DIRECT_STORE),a=sanitizeEndpoint(e),i=n?.get(a);if(!i)throw new Error(`No direct channel for endpoint "${e}". Did you call startAndWaitReady() first?`);let s=new DefaultExchange(this.ctx,{body:r,...o!==void 0&&{headers:o}});return (await i.send(a,s)).body}},l=class{builder=new ContextBuilder;routesReadyTimeoutMs;routesReadyTimeout(e){return this.routesReadyTimeoutMs=e,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=m(),r=logger.child.bind(logger);logger.child=vi.fn(()=>e);let o=await this.builder.build(),n={...this.routesReadyTimeoutMs!==void 0?{routesReadyTimeoutMs:this.routesReadyTimeoutMs}:{},spyLogger:e,restoreLoggerChild:()=>{logger.child=r;}};return new f(o,n)}};function A(){return new l}function x(t,e){let r=()=>{throw new Error(`Pseudo adapter "${t}" is not implemented. Replace with a real adapter.`)},o=()=>Promise.resolve(void 0),n=i=>i,a=(i,s,p,d)=>(d?.(),Promise.resolve());return {adapterId:`routecraft.adapter.pseudo.${t}`,subscribe:e==="noop"?a:r,send:e==="noop"?o:r,process:e==="noop"?n:r}}function F(t="pseudo",e){let r=e?.runtime??"throw";return e&&"args"in e&&e.args==="keyed"?(n,a)=>x(t,r):n=>x(t,r)}function v(){return {received:[],calls:{send:0,process:0,enrich:0}}}function N(){let t=v();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)}}}function I(t){return JSON.parse(readFileSync(t,"utf-8"))}function Z(t,e){let r=I(t);if(!Array.isArray(r))throw new Error(`fixture.each: expected JSON array at "${t}", got ${typeof r}`);for(let o of r){if(typeof o?.name!="string")throw new Error(`fixture.each: each entry must have a "name" field (string). Got: ${JSON.stringify(o)}`);test(o.name,()=>e(o));}}export{f as TestContext,l as TestContextBuilder,R as createNoopSpyLogger,m as createSpyLogger,I as fixture,Z as fixtureEach,F as pseudo,N as spy,A as testContext};//# sourceMappingURL=index.js.map
+import {readFileSync}from'fs';import {vi,test}from'vitest';import {ContextBuilder,logger,HeadersKeys,isRoutecraftError,rcError}from'@routecraft/routecraft';function h(){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 R(){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 O=200,f=class{ctx;client;logger;errors=[];routesReadyTimeoutMs;restoreLoggerChild;loggerChildRestored=false;startedPromise;constructor(e,r,o){this.ctx=e,this.client=r,this.logger=o?.spyLogger??R(),o?.restoreLoggerChild&&(this.restoreLoggerChild=o.restoreLoggerChild),this.routesReadyTimeoutMs=o?.routesReadyTimeoutMs??O;let s=n=>{this.errors.push(isRoutecraftError(n)?n:rcError("RC9901",n));};e.on("context:error",n=>{s(n.details.error);});}async startAndWaitReady(){let e=this.ctx,r=e.getRoutes().length,o=r===0?Promise.resolve():new Promise((s,n)=>{let d=0,i=false,c=setTimeout(()=>{i||(i=true,a(),p(),n(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),a=e.on("route:*:started",(()=>{i||(d++,d>=r&&(i=true,clearTimeout(c),a(),p(),s()));})),p=e.on("context:error",g=>{i||(i=true,clearTimeout(c),a(),p(),n(g.details.error));});});this.startedPromise=e.start(),await Promise.all([this.startedPromise,o]);}async test(e){let r=this.ctx,o=r.getRoutes().length,s=o===0?Promise.resolve():new Promise((d,i)=>{let c=0,a=false,p=setTimeout(()=>{a||(m(),i(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),g=r.on("route:*:started",(()=>{a||(c++,c>=o&&(m(),d()));})),T=r.on("context:error",w=>{a||(m(),i(w.details.error));});function m(){a||(a=true,g(),T(),p!==void 0&&(clearTimeout(p),p=void 0));}}),n=r.start();try{await s;let d=e?.delayBeforeDrainMs??0;d>0&&await new Promise(i=>setTimeout(i,d)),await r.drain();}finally{try{await r.stop(),await n;}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;routesReadyTimeout(e){return this.routesReadyTimeoutMs=e,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=h(),r=logger.child.bind(logger);logger.child=vi.fn(()=>e);let{context:o,client:s}=await this.builder.build(),n={...this.routesReadyTimeoutMs!==void 0?{routesReadyTimeoutMs:this.routesReadyTimeoutMs}:{},spyLogger:e,restoreLoggerChild:()=>{logger.child=r;}};return new f(o,s,n)}};function b(){return new l}function v(t,e){let r=()=>{throw new Error(`Pseudo adapter "${t}" is not implemented. Replace with a real adapter.`)},o=()=>Promise.resolve(void 0),s=d=>d,n=(d,i,c,a)=>(a?.(),Promise.resolve());return {adapterId:`routecraft.adapter.pseudo.${t}`,subscribe:e==="noop"?n:r,send:e==="noop"?o: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,n)=>v(t,r):s=>v(t,r)}function x(){return {received:[],calls:{send:0,process:0,enrich:0}}}function F(){let t=x();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)}}}function M(t){return JSON.parse(readFileSync(t,"utf-8"))}function V(t,e){let r=M(t);if(!Array.isArray(r))throw new Error(`fixture.each: expected JSON array at "${t}", got ${typeof r}`);for(let o of r){if(typeof o?.name!="string")throw new Error(`fixture.each: each entry must have a "name" field (string). Got: ${JSON.stringify(o)}`);test(o.name,()=>e(o));}}export{f as TestContext,l as TestContextBuilder,R as createNoopSpyLogger,h as createSpyLogger,M as fixture,V as fixtureEach,L as pseudo,F as spy,b as testContext};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/spy-logger.ts","../src/test-context.ts","../src/adapters/pseudo/index.ts","../src/adapters/spy/shared.ts","../src/adapters/spy/index.ts","../src/index.ts"],"names":["createSpyLogger","spy","vi","createNoopSpyLogger","noop","childFn","noopLogger","DEFAULT_ROUTES_READY_TIMEOUT_MS","TestContext","ctx","options","pushError","err","isRoutecraftError","rcError","payload","total","allReady","resolve","reject","ready","settled","timeoutId","offRouteStarted","offError","cleanup","started","delayMs","endpoint","body","headers","store","ADAPTER_DIRECT_STORE","sanitized","sanitizeEndpoint","channel","exchange","DefaultExchange","TestContextBuilder","ContextBuilder","ms","config","event","handler","key","value","routes","spyLogger","originalChild","logger","testContext","createAdapter","name","runtime","fail","noopSend","noopProcess","noopSubscribe","_context","_handler","_abortController","onReady","pseudo","opts","createSpyState","state","HeadersKeys","fixture","path","readFileSync","fixtureEach","run","entries","entry","test"],"mappings":"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","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 *\n * @beta\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\n/** @beta */\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\n/** @beta */\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 { vi } from \"vitest\";\nimport type {\n  CraftContext,\n  CraftConfig,\n  StoreRegistry,\n  EventName,\n  EventHandler,\n  RouteDefinition,\n  RouteBuilder,\n  Exchange,\n  ExchangeHeaders,\n} from \"@routecraft/routecraft\";\nimport {\n  ContextBuilder,\n  DefaultExchange,\n  ADAPTER_DIRECT_STORE,\n  sanitizeEndpoint,\n  isRoutecraftError,\n  RoutecraftError,\n  rcError,\n  logger,\n} from \"@routecraft/routecraft\";\nimport type { SpyLogger } from \"./spy-logger\";\nimport { createSpyLogger, createNoopSpyLogger } from \"./spy-logger\";\n\nconst DEFAULT_ROUTES_READY_TIMEOUT_MS = 200;\n\nexport interface TestContextOptions {\n  /** Timeout in ms for waiting for all routes to emit routeStarted. Default 200. */\n  routesReadyTimeoutMs?: number;\n}\n\n/** Options for TestContext.test(). */\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 *\n * @beta\n */\nexport class TestContext {\n  readonly ctx: CraftContext;\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    options?: TestContextOptions & {\n      spyLogger?: SpyLogger;\n      restoreLoggerChild?: () => void;\n    },\n  ) {\n    this.ctx = ctx;\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   * Start context and wait for all routes to be ready. Does not drain or stop.\n   * Use with invoke() to send to a route by id, then call drain()/stop() when done.\n   */\n  async startAndWaitReady(): Promise<void> {\n    const ctx = this.ctx;\n    const total = ctx.getRoutes().length;\n    const allReady =\n      total === 0\n        ? Promise.resolve()\n        : new Promise<void>((resolve, reject) => {\n            let ready = 0;\n            let settled = false;\n            const timeoutId = setTimeout(() => {\n              if (settled) return;\n              settled = true;\n              offRouteStarted();\n              offError();\n              reject(new Error(\"Timeout waiting for routes to start\"));\n            }, this.routesReadyTimeoutMs);\n\n            const offRouteStarted = ctx.on(\n              \"route:*:started\" as EventName,\n              (() => {\n                if (settled) return;\n                ready++;\n                if (ready >= total) {\n                  settled = true;\n                  clearTimeout(timeoutId);\n                  offRouteStarted();\n                  offError();\n                  resolve();\n                }\n              }) as EventHandler<EventName>,\n            );\n            const offError = ctx.on(\"context:error\", (payload) => {\n              if (settled) return;\n              settled = true;\n              clearTimeout(timeoutId);\n              offRouteStarted();\n              offError();\n              reject(payload.details.error);\n            });\n          });\n    this.startedPromise = ctx.start();\n    await Promise.all([this.startedPromise, 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 total = ctx.getRoutes().length;\n    const allReady =\n      total === 0\n        ? Promise.resolve()\n        : new Promise<void>((resolve, reject) => {\n            let ready = 0;\n            let settled = false;\n            let timeoutId: ReturnType<typeof setTimeout> | undefined =\n              setTimeout(() => {\n                if (settled) return;\n                cleanup();\n                reject(new Error(\"Timeout waiting for routes to start\"));\n              }, this.routesReadyTimeoutMs);\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    const started = ctx.start();\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   * Send a message to a direct endpoint and return the result.\n   * Use after {@link startAndWaitReady} so the channel exists.\n   *\n   * @param endpoint Direct endpoint name (must match the endpoint string passed to `direct(endpoint, options)`)\n   * @param body Request body\n   * @param headers Optional exchange headers\n   * @returns The response body from the route\n   */\n  async send<T = unknown, R = T>(\n    endpoint: string,\n    body: T,\n    headers?: ExchangeHeaders,\n  ): Promise<R> {\n    const store = this.ctx.getStore(ADAPTER_DIRECT_STORE);\n    const sanitized = sanitizeEndpoint(endpoint);\n    const channel = store?.get(sanitized);\n    if (!channel) {\n      throw new Error(\n        `No direct channel for endpoint \"${endpoint}\". Did you call startAndWaitReady() first?`,\n      );\n    }\n    const exchange = new DefaultExchange(this.ctx, {\n      body,\n      ...(headers !== undefined && { headers }),\n    });\n    const result = await channel.send(sanitized, exchange);\n    return (result as Exchange).body as R;\n  }\n}\n\n/**\n * Builder that returns TestContext instead of CraftContext.\n * Same API as ContextBuilder (routes, on, with, store).\n *\n * @beta\n */\nexport class TestContextBuilder {\n  private builder = new ContextBuilder();\n  private routesReadyTimeoutMs: number | undefined;\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  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 ctx = await this.builder.build();\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, options);\n  }\n}\n\n/**\n * Create a test context builder. Use .routes(...).build(), await the result, then await t.test().\n *\n * @beta\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 * @experimental\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 * @experimental\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 { 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 PseudoAdapter,\n  type PseudoFactory,\n  type PseudoKeyedFactory,\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/**\n * Load a JSON fixture file and return the parsed value.\n *\n * @beta\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/** Fixture entry must have a `name` field used as the vitest test name. */\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 * @beta\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/test-context.ts","../src/adapters/pseudo/index.ts","../src/adapters/spy/shared.ts","../src/adapters/spy/index.ts","../src/index.ts"],"names":["createSpyLogger","spy","vi","createNoopSpyLogger","noop","childFn","noopLogger","DEFAULT_ROUTES_READY_TIMEOUT_MS","TestContext","ctx","client","options","pushError","err","isRoutecraftError","rcError","payload","total","allReady","resolve","reject","ready","settled","timeoutId","offRouteStarted","offError","cleanup","started","delayMs","TestContextBuilder","ContextBuilder","ms","config","event","handler","key","value","routes","spyLogger","originalChild","logger","testContext","createAdapter","name","runtime","fail","noopSend","noopProcess","exchange","noopSubscribe","_context","_handler","_abortController","onReady","pseudo","opts","createSpyState","state","HeadersKeys","fixture","path","readFileSync","fixtureEach","run","entries","entry","test"],"mappings":"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","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 *\n * @beta\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\n/** @beta */\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\n/** @beta */\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 { vi } from \"vitest\";\nimport type {\n  CraftContext,\n  CraftConfig,\n  StoreRegistry,\n  EventName,\n  EventHandler,\n  RouteDefinition,\n  RouteBuilder,\n} from \"@routecraft/routecraft\";\nimport {\n  ContextBuilder,\n  CraftClient,\n  isRoutecraftError,\n  RoutecraftError,\n  rcError,\n  logger,\n} from \"@routecraft/routecraft\";\nimport type { SpyLogger } from \"./spy-logger\";\nimport { createSpyLogger, createNoopSpyLogger } from \"./spy-logger\";\n\nconst DEFAULT_ROUTES_READY_TIMEOUT_MS = 200;\n\nexport interface TestContextOptions {\n  /** Timeout in ms for waiting for all routes to emit routeStarted. Default 200. */\n  routesReadyTimeoutMs?: number;\n}\n\n/** Options for TestContext.test(). */\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 *\n * @beta\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   * Start context and wait for all routes to be ready. Does not drain or stop.\n   * Use with invoke() to send to a route by id, then call drain()/stop() when done.\n   */\n  async startAndWaitReady(): Promise<void> {\n    const ctx = this.ctx;\n    const total = ctx.getRoutes().length;\n    const allReady =\n      total === 0\n        ? Promise.resolve()\n        : new Promise<void>((resolve, reject) => {\n            let ready = 0;\n            let settled = false;\n            const timeoutId = setTimeout(() => {\n              if (settled) return;\n              settled = true;\n              offRouteStarted();\n              offError();\n              reject(new Error(\"Timeout waiting for routes to start\"));\n            }, this.routesReadyTimeoutMs);\n\n            const offRouteStarted = ctx.on(\n              \"route:*:started\" as EventName,\n              (() => {\n                if (settled) return;\n                ready++;\n                if (ready >= total) {\n                  settled = true;\n                  clearTimeout(timeoutId);\n                  offRouteStarted();\n                  offError();\n                  resolve();\n                }\n              }) as EventHandler<EventName>,\n            );\n            const offError = ctx.on(\"context:error\", (payload) => {\n              if (settled) return;\n              settled = true;\n              clearTimeout(timeoutId);\n              offRouteStarted();\n              offError();\n              reject(payload.details.error);\n            });\n          });\n    this.startedPromise = ctx.start();\n    await Promise.all([this.startedPromise, 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 total = ctx.getRoutes().length;\n    const allReady =\n      total === 0\n        ? Promise.resolve()\n        : new Promise<void>((resolve, reject) => {\n            let ready = 0;\n            let settled = false;\n            let timeoutId: ReturnType<typeof setTimeout> | undefined =\n              setTimeout(() => {\n                if (settled) return;\n                cleanup();\n                reject(new Error(\"Timeout waiting for routes to start\"));\n              }, this.routesReadyTimeoutMs);\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    const started = ctx.start();\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 *\n * @beta\n */\nexport class TestContextBuilder {\n  private builder = new ContextBuilder();\n  private routesReadyTimeoutMs: number | undefined;\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  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    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 * @beta\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 * @experimental\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 * @experimental\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 { 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 PseudoAdapter,\n  type PseudoFactory,\n  type PseudoKeyedFactory,\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/**\n * Load a JSON fixture file and return the parsed value.\n *\n * @beta\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/** Fixture entry must have a `name` field used as the vitest test name. */\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 * @beta\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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@routecraft/testing",
-  "version": "0.5.0-canary.3",
+  "version": "0.5.0-canary.5",
   "description": "Test utilities for Routecraft routes",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -23,10 +23,10 @@
     "prepublishOnly": "pnpm run build"
   },
   "dependencies": {
-    "@routecraft/routecraft": "^0.5.0"
+    "@routecraft/routecraft": "^0.5.0-canary.5"
   },
   "devDependencies": {
-    "vitest": "^4.1.0"
+    "vitest": "^4.1.4"
   },
   "peerDependencies": {
     "@routecraft/routecraft": "*",