@routecraft/testing 0.3.0-canary.9 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @routecraft/testing
 
-Test utilities for RouteCraft routes. Use with [Vitest](https://vitest.dev) to run route lifecycles and assert on logs and errors.
+Test utilities for RouteCraft capabilities. Use with [Vitest](https://vitest.dev) to run capability lifecycles and assert on output, logs, and errors.
 
 ## Installation
 
@@ -14,26 +14,29 @@ or
 pnpm add -D @routecraft/testing
 ```
 
-Install as a **devDependency** and ensure `vitest` (>=4.0.0) and `@routecraft/routecraft` are available.
+Install as a devDependency. Requires `vitest` (>=4.0.0) and `@routecraft/routecraft`.
 
 ## Quick Start
 
 ```typescript
-import { describe, it, expect, afterEach } from "vitest";
-import { testContext, type TestContext } from "@routecraft/testing";
-import { craft, simple, log } from "@routecraft/routecraft";
+import { describe, it, expect, afterEach } from 'vitest';
+import { testContext, type TestContext } from '@routecraft/testing';
+import { craft, simple, log } from '@routecraft/routecraft';
 
-describe("my route", () => {
+describe('send-email capability', () => {
   let t: TestContext | undefined;
 
   afterEach(async () => {
     if (t) await t.stop();
   });
 
-  it("runs and logs", async () => {
-    const route = craft().id("example").from(simple("hello")).to(log());
+  it('processes and logs the exchange', async () => {
+    const capability = craft()
+      .id('send-email')
+      .from(simple({ to: 'user@example.com', subject: 'Hello' }))
+      .to(log());
 
-    t = await testContext().routes(route).build();
+    t = await testContext().routes(capability).build();
     await t.test();
 
     expect(t.logger.info).toHaveBeenCalled();
@@ -43,19 +46,38 @@ describe("my route", () => {
 
 ## API
 
-- **`testContext()`** — Returns a builder. Call `.routes(...).build()` to get a `TestContext`.
-- **`TestContext`** — Wrapper around `CraftContext` with:
-  - **`ctx`** — The underlying context.
-  - **`logger`** — A spy logger (Vitest `vi.fn()` methods) for asserting on log calls.
-  - **`errors`** — Collected route errors.
-  - **`test(options?)`** — Runs start → wait for routes ready → (optional delay) → drain → stop. Assert after `await t.test()`. Options:
-  - **`delayBeforeDrainMs`** — Wait this many ms after routes are ready before draining. Use for **timer** (or other deferred) sources so at least one message is processed; e.g. `await t.test({ delayBeforeDrainMs: 50 })` for a timer with `intervalMs: 50`.
-- **`startAndWaitReady()`** — Start context and wait for all routes to be ready (no drain/stop). Use with **`invoke()`** to call a route by id, then call **`stop()`** (or **`drain()`** then **`stop()`**) when done.
-- **`stop()`** / **`drain()`** — Lifecycle helpers.
-- **`TestContextOptions`** — Builder options (e.g. `routesReadyTimeoutMs`).
-- **`TestOptions`** — Options for `test()` (e.g. `delayBeforeDrainMs`).
-- **`SpyLogger`** — Type for the spy logger on `t.logger`.
-- **`invoke(ctx, routeIdOrDestination, body, headers?)`** — Invoke a route by id (string) or send to a Destination instance; returns the result. Use route id when the route's source implements Destination (e.g. direct adapter): `await invoke(t.ctx, "my-route-id", { ... })`.
+### `testContext()`
+
+Returns a builder. Call `.routes(...).build()` to get a `TestContext`.
+
+### `TestContext`
+
+Wrapper around `CraftContext` with:
+
+- **`ctx`** -- The underlying context.
+- **`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 `invoke()` to call a capability by ID, then call `stop()` when done.
+- **`stop()`** / **`drain()`** -- Lifecycle helpers.
+
+### `invoke(ctx, routeIdOrDestination, body, headers?)`
+
+Invoke a capability by ID or send to a `Destination` instance. Returns the result.
+
+```typescript
+const result = await invoke(t.ctx, 'send-email', { to: 'user@example.com' });
+```
+
+### Options
+
+- **`TestContextOptions`** -- Builder options, e.g. `routesReadyTimeoutMs`.
+- **`TestOptions`** -- Options for `test()`, e.g. `delayBeforeDrainMs` -- useful for timer-based capabilities so at least one message is processed before drain.
+
+```typescript
+// Wait 50ms after ready before draining (e.g. for a timer with intervalMs: 50)
+await t.test({ delayBeforeDrainMs: 50 });
+```
 
 ## Documentation
 

package/dist/index.cjs

@@ -1,2 +1,2 @@
-'use strict';var fs=require('fs'),vitest=require('vitest'),routecraft=require('@routecraft/routecraft');function h(){let o={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 o.child.mockImplementation(()=>o),o}function R(){let o=vitest.vi.fn(),e=vitest.vi.fn(),t={info:o,debug:o,warn:o,error:o,trace:o,fatal:o,child:e};return e.mockImplementation(()=>t),t}var k=200,y=class{ctx;logger;errors=[];routesReadyTimeoutMs;restoreLoggerChild;startedPromise;constructor(e,t){this.ctx=e,this.logger=t?.spyLogger??R(),t?.restoreLoggerChild&&(this.restoreLoggerChild=t.restoreLoggerChild),this.routesReadyTimeoutMs=t?.routesReadyTimeoutMs??k,e.on("error",r=>{let n=r.details.error;this.errors.push(routecraft.isRouteCraftError(n)?n:routecraft.rcError("RC9901",n));});}async startAndWaitReady(){let e=this.ctx,t=e.getRoutes().length,r=t===0?Promise.resolve():new Promise((n,i)=>{let a=0,s=false,d=setTimeout(()=>{s||(s=true,u(),f(),i(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),u=e.on("route:started",()=>{s||(a++,a>=t&&(s=true,clearTimeout(d),u(),f(),n()));}),f=e.on("error",l=>{s||(s=true,clearTimeout(d),u(),f(),i(l.details.error));});});this.startedPromise=e.start(),await Promise.all([this.startedPromise,r]);}async test(e){let t=this.ctx,r=t.getRoutes().length,n=r===0?Promise.resolve():new Promise((a,s)=>{let d=0,u=false,f=setTimeout(()=>{u||(m(),s(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),l=t.on("route:started",()=>{u||(d++,d>=r&&(m(),a()));}),x=t.on("error",P=>{u||(m(),s(P.details.error));});function m(){u||(u=true,l(),x(),f!==void 0&&(clearTimeout(f),f=void 0));}}),i=t.start();try{await n;let a=e?.delayBeforeDrainMs??0;a>0&&await new Promise(s=>setTimeout(s,a)),await t.drain();}finally{try{await t.stop(),await i;}finally{this.restoreLoggerChild?.();}}}drain(){return this.ctx.drain()}async stop(){await this.ctx.stop(),this.startedPromise!==void 0&&await this.startedPromise;}},g=class{builder=new routecraft.ContextBuilder;routesReadyTimeoutMs;routesReadyTimeout(e){return this.routesReadyTimeoutMs=e,this}with(e){return this.builder.with(e),this}on(e,t){return this.builder.on(e,t),this}store(e,t){return this.builder.store(e,t),this}routes(e){return this.builder.routes(e),this}async build(){let e=h(),t=routecraft.logger.child.bind(routecraft.logger);routecraft.logger.child=vitest.vi.fn(()=>e);let r=await this.builder.build(),n={...this.routesReadyTimeoutMs!==void 0?{routesReadyTimeoutMs:this.routesReadyTimeoutMs}:{},spyLogger:e,restoreLoggerChild:()=>{routecraft.logger.child=t;}};return new y(r,n)}};function b(){return new g}function L(o){return typeof o=="object"&&o!==null&&typeof o.send=="function"}async function E(o,e,t,r){let n=new routecraft.DefaultExchange(o,{body:t,...r!==void 0&&{headers:r}}),i;if(typeof e=="string"){let s=o.getRouteById(e);if(!s)throw new Error(`No route with id "${e}". Did you start the context (e.g. await t.test())?`);let d=s.definition.source;if(!L(d))throw new Error(`Route "${e}" is not invokable: source must implement Destination (e.g. direct adapter).`);i=d;}else i=e;return await i.send(n)}function w(o,e){let t=()=>{throw new Error(`Pseudo adapter "${o}" is not implemented. Replace with a real adapter.`)},r=()=>Promise.resolve(void 0),n=a=>a,i=(a,s,d,u)=>(u?.(),Promise.resolve());return {adapterId:`routecraft.adapter.pseudo.${o}`,subscribe:e==="noop"?i:t,send:e==="noop"?r:t,process:e==="noop"?n:t}}function F(o="pseudo",e){let t=e?.runtime??"throw";return e&&"args"in e&&e.args==="keyed"?(n,i)=>w(o,t):n=>w(o,t)}function A(o){return JSON.parse(fs.readFileSync(o,"utf-8"))}function q(o,e){let t=A(o);if(!Array.isArray(t))throw new Error(`fixture.each: expected JSON array at "${o}", got ${typeof t}`);for(let r of t){if(typeof r?.name!="string")throw new Error(`fixture.each: each entry must have a "name" field (string). Got: ${JSON.stringify(r)}`);vitest.test(r.name,()=>e(r));}}exports.TestContext=y;exports.TestContextBuilder=g;exports.createNoopSpyLogger=R;exports.createSpyLogger=h;exports.fixture=A;exports.fixtureEach=q;exports.invoke=E;exports.pseudo=F;exports.testContext=b;//# sourceMappingURL=index.cjs.map
+'use strict';var fs=require('fs'),vitest=require('vitest'),routecraft=require('@routecraft/routecraft');function h(){let r={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 r.child.mockImplementation(()=>r),r}function R(){let r=vitest.vi.fn(),e=vitest.vi.fn(),t={info:r,debug:r,warn:r,error:r,trace:r,fatal:r,child:e};return e.mockImplementation(()=>t),t}var k=200,y=class{ctx;logger;errors=[];routesReadyTimeoutMs;restoreLoggerChild;startedPromise;constructor(e,t){this.ctx=e,this.logger=t?.spyLogger??R(),t?.restoreLoggerChild&&(this.restoreLoggerChild=t.restoreLoggerChild),this.routesReadyTimeoutMs=t?.routesReadyTimeoutMs??k,e.on("error",o=>{let n=o.details.error;this.errors.push(routecraft.isRouteCraftError(n)?n:routecraft.rcError("RC9901",n));});}async startAndWaitReady(){let e=this.ctx,t=e.getRoutes().length,o=t===0?Promise.resolve():new Promise((n,i)=>{let a=0,s=false,d=setTimeout(()=>{s||(s=true,u(),f(),i(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),u=e.on("route:started",()=>{s||(a++,a>=t&&(s=true,clearTimeout(d),u(),f(),n()));}),f=e.on("error",l=>{s||(s=true,clearTimeout(d),u(),f(),i(l.details.error));});});this.startedPromise=e.start(),await Promise.all([this.startedPromise,o]);}async test(e){let t=this.ctx,o=t.getRoutes().length,n=o===0?Promise.resolve():new Promise((a,s)=>{let d=0,u=false,f=setTimeout(()=>{u||(m(),s(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),l=t.on("route:started",()=>{u||(d++,d>=o&&(m(),a()));}),x=t.on("error",P=>{u||(m(),s(P.details.error));});function m(){u||(u=true,l(),x(),f!==void 0&&(clearTimeout(f),f=void 0));}}),i=t.start();try{await n;let a=e?.delayBeforeDrainMs??0;a>0&&await new Promise(s=>setTimeout(s,a)),await t.drain();}finally{try{await t.stop(),await i;}finally{this.restoreLoggerChild?.();}}}drain(){return this.ctx.drain()}async stop(){await this.ctx.stop(),this.startedPromise!==void 0&&await this.startedPromise;}},g=class{builder=new routecraft.ContextBuilder;routesReadyTimeoutMs;routesReadyTimeout(e){return this.routesReadyTimeoutMs=e,this}with(e){return this.builder.with(e),this}on(e,t){return this.builder.on(e,t),this}once(e,t){return this.builder.once(e,t),this}store(e,t){return this.builder.store(e,t),this}routes(e){return this.builder.routes(e),this}async build(){let e=h(),t=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=t;}};return new y(o,n)}};function b(){return new g}function L(r){return typeof r=="object"&&r!==null&&typeof r.send=="function"}async function E(r,e,t,o){let n=new routecraft.DefaultExchange(r,{body:t,...o!==void 0&&{headers:o}}),i;if(typeof e=="string"){let s=r.getRouteById(e);if(!s)throw new Error(`No route with id "${e}". Did you start the context (e.g. await t.test())?`);let d=s.definition.source;if(!L(d))throw new Error(`Route "${e}" is not invokable: source must implement Destination (e.g. direct adapter).`);i=d;}else i=e;return await i.send(n)}function w(r,e){let t=()=>{throw new Error(`Pseudo adapter "${r}" is not implemented. Replace with a real adapter.`)},o=()=>Promise.resolve(void 0),n=a=>a,i=(a,s,d,u)=>(u?.(),Promise.resolve());return {adapterId:`routecraft.adapter.pseudo.${r}`,subscribe:e==="noop"?i:t,send:e==="noop"?o:t,process:e==="noop"?n:t}}function F(r="pseudo",e){let t=e?.runtime??"throw";return e&&"args"in e&&e.args==="keyed"?(n,i)=>w(r,t):n=>w(r,t)}function A(r){return JSON.parse(fs.readFileSync(r,"utf-8"))}function q(r,e){let t=A(r);if(!Array.isArray(t))throw new Error(`fixture.each: expected JSON array at "${r}", got ${typeof t}`);for(let o of t){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=y;exports.TestContextBuilder=g;exports.createNoopSpyLogger=R;exports.createSpyLogger=h;exports.fixture=A;exports.fixtureEach=q;exports.invoke=E;exports.pseudo=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/invoke.ts","../src/adapters/pseudo/index.ts","../src/index.ts"],"names":["createSpyLogger","spy","vi","createNoopSpyLogger","noop","childFn","noopLogger","DEFAULT_ROUTES_READY_TIMEOUT_MS","TestContext","ctx","options","payload","err","isRouteCraftError","rcError","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","isDestination","obj","invoke","routeIdOrDestination","body","headers","exchange","DefaultExchange","dest","route","source","createAdapter","name","runtime","fail","noopSend","noopProcess","noopSubscribe","_context","_handler","_abortController","onReady","pseudo","opts","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 */\nexport type SpyLogger = {\n  info: ReturnType<typeof vi.fn>;\n  debug: ReturnType<typeof vi.fn>;\n  warn: ReturnType<typeof vi.fn>;\n  error: ReturnType<typeof vi.fn>;\n  trace: ReturnType<typeof vi.fn>;\n  fatal: ReturnType<typeof vi.fn>;\n  child: ReturnType<typeof vi.fn>;\n};\n\nexport function createSpyLogger(): SpyLogger {\n  const spy: SpyLogger = {\n    info: vi.fn(),\n    debug: vi.fn(),\n    warn: vi.fn(),\n    error: vi.fn(),\n    trace: vi.fn(),\n    fatal: vi.fn(),\n    child: vi.fn(),\n  };\n  spy.child.mockImplementation(() => spy);\n  return spy;\n}\n\nexport function createNoopSpyLogger(): SpyLogger {\n  const noop = vi.fn();\n  const childFn = vi.fn();\n  const noopLogger: SpyLogger = {\n    info: noop,\n    debug: noop,\n    warn: noop,\n    error: noop,\n    trace: noop,\n    fatal: noop,\n    child: childFn,\n  };\n  childFn.mockImplementation(() => noopLogger);\n  return noopLogger;\n}\n","import { 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  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 */\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 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    ctx.on(\"error\", (payload) => {\n      const err = payload.details.error;\n      this.errors.push(\n        isRouteCraftError(err)\n          ? (err as RouteCraftError)\n          : rcError(\"RC9901\", err),\n      );\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(\"route:started\", () => {\n              if (settled) return;\n              ready++;\n              if (ready >= total) {\n                settled = true;\n                clearTimeout(timeoutId);\n                offRouteStarted();\n                offError();\n                resolve();\n              }\n            });\n            const offError = ctx.on(\"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(\"route:started\", () => {\n              if (settled) return;\n              ready++;\n              if (ready >= total) {\n                cleanup();\n                resolve();\n              }\n            });\n            const offError = ctx.on(\"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.restoreLoggerChild?.();\n      }\n    }\n  }\n\n  drain(): Promise<void> {\n    return this.ctx.drain();\n  }\n\n  async stop(): Promise<void> {\n    await this.ctx.stop();\n    if (this.startedPromise !== undefined) {\n      await this.startedPromise;\n    }\n  }\n}\n\n/**\n * Builder that returns TestContext instead of CraftContext.\n * Same API as ContextBuilder (routes, on, with, store).\n */\nexport class TestContextBuilder {\n  private builder = new ContextBuilder();\n  private routesReadyTimeoutMs: number | undefined;\n\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  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 * @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 {\n  CraftContext,\n  Destination,\n  ExchangeHeaders,\n} from \"@routecraft/routecraft\";\nimport { DefaultExchange } from \"@routecraft/routecraft\";\n\n/** Duck-type: object with send(exchange) returning Promise. */\nfunction isDestination(obj: unknown): obj is Destination<unknown, unknown> {\n  return (\n    typeof obj === \"object\" &&\n    obj !== null &&\n    typeof (obj as { send?: unknown }).send === \"function\"\n  );\n}\n\n/**\n * Invoke a route by id or send to a destination and return the result.\n *\n * - **By route id:** Pass a string. The route is looked up with ctx.getRouteById(routeId).\n *   The route's source must implement Destination (e.g. DirectAdapter). Works with multiple\n *   routes in the default export — use the route's id.\n *\n * - **By destination:** Pass a Destination instance (e.g. direct(\"endpoint\")). Builds an\n *   exchange and calls destination.send(exchange).\n *\n * @param ctx CraftContext (e.g. t.ctx from TestContext) with routes started\n * @param routeIdOrDestination Route id string or a Destination adapter instance\n * @param body Request body\n * @param headers Optional headers for the exchange\n * @returns The result from the route or destination (e.g. response body for DirectAdapter)\n */\nexport async function invoke<T = unknown, R = T>(\n  ctx: CraftContext,\n  routeIdOrDestination: string | Destination<T, R>,\n  body: T,\n  headers?: ExchangeHeaders,\n): Promise<R> {\n  const exchange = new DefaultExchange(ctx, {\n    body,\n    ...(headers !== undefined && { headers }),\n  });\n  let dest: Destination<T, R>;\n\n  if (typeof routeIdOrDestination === \"string\") {\n    const route = ctx.getRouteById(routeIdOrDestination);\n    if (!route) {\n      throw new Error(\n        `No route with id \"${routeIdOrDestination}\". Did you start the context (e.g. await t.test())?`,\n      );\n    }\n    const source = route.definition.source;\n    if (!isDestination(source)) {\n      throw new Error(\n        `Route \"${routeIdOrDestination}\" is not invokable: source must implement Destination (e.g. direct adapter).`,\n      );\n    }\n    dest = source as Destination<T, R>;\n  } else {\n    dest = routeIdOrDestination;\n  }\n\n  const result = await dest.send(exchange as Parameters<typeof dest.send>[0]);\n  return result as R;\n}\n","import type { Source, Destination, Processor } from \"@routecraft/routecraft\";\nimport type { PseudoOptions, PseudoKeyedOptions } from \"./shared\";\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\nexport type PseudoFactory<Opts> = <R = unknown>(opts: Opts) => PseudoAdapter<R>;\n\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// 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 { 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 invoke utility\nexport { invoke } from \"./invoke\";\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/**\n * Load a JSON fixture file and return the parsed value.\n *\n * @param path Absolute or relative path to the JSON file\n * @returns Parsed JSON as T\n */\nexport function fixture<T = unknown>(path: string): T {\n  return JSON.parse(readFileSync(path, \"utf-8\")) as T;\n}\n\n/** 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 * @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/invoke.ts","../src/adapters/pseudo/index.ts","../src/index.ts"],"names":["createSpyLogger","spy","vi","createNoopSpyLogger","noop","childFn","noopLogger","DEFAULT_ROUTES_READY_TIMEOUT_MS","TestContext","ctx","options","payload","err","isRouteCraftError","rcError","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","isDestination","obj","invoke","routeIdOrDestination","body","headers","exchange","DefaultExchange","dest","route","source","createAdapter","name","runtime","fail","noopSend","noopProcess","noopSubscribe","_context","_handler","_abortController","onReady","pseudo","opts","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 */\nexport type SpyLogger = {\n  info: ReturnType<typeof vi.fn>;\n  debug: ReturnType<typeof vi.fn>;\n  warn: ReturnType<typeof vi.fn>;\n  error: ReturnType<typeof vi.fn>;\n  trace: ReturnType<typeof vi.fn>;\n  fatal: ReturnType<typeof vi.fn>;\n  child: ReturnType<typeof vi.fn>;\n};\n\nexport function createSpyLogger(): SpyLogger {\n  const spy: SpyLogger = {\n    info: vi.fn(),\n    debug: vi.fn(),\n    warn: vi.fn(),\n    error: vi.fn(),\n    trace: vi.fn(),\n    fatal: vi.fn(),\n    child: vi.fn(),\n  };\n  spy.child.mockImplementation(() => spy);\n  return spy;\n}\n\nexport function createNoopSpyLogger(): SpyLogger {\n  const noop = vi.fn();\n  const childFn = vi.fn();\n  const noopLogger: SpyLogger = {\n    info: noop,\n    debug: noop,\n    warn: noop,\n    error: noop,\n    trace: noop,\n    fatal: noop,\n    child: childFn,\n  };\n  childFn.mockImplementation(() => noopLogger);\n  return noopLogger;\n}\n","import { 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  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 */\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 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    ctx.on(\"error\", (payload) => {\n      const err = payload.details.error;\n      this.errors.push(\n        isRouteCraftError(err)\n          ? (err as RouteCraftError)\n          : rcError(\"RC9901\", err),\n      );\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(\"route:started\", () => {\n              if (settled) return;\n              ready++;\n              if (ready >= total) {\n                settled = true;\n                clearTimeout(timeoutId);\n                offRouteStarted();\n                offError();\n                resolve();\n              }\n            });\n            const offError = ctx.on(\"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(\"route:started\", () => {\n              if (settled) return;\n              ready++;\n              if (ready >= total) {\n                cleanup();\n                resolve();\n              }\n            });\n            const offError = ctx.on(\"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.restoreLoggerChild?.();\n      }\n    }\n  }\n\n  drain(): Promise<void> {\n    return this.ctx.drain();\n  }\n\n  async stop(): Promise<void> {\n    await this.ctx.stop();\n    if (this.startedPromise !== undefined) {\n      await this.startedPromise;\n    }\n  }\n}\n\n/**\n * Builder that returns TestContext instead of CraftContext.\n * Same API as ContextBuilder (routes, on, with, store).\n */\nexport class TestContextBuilder {\n  private builder = new ContextBuilder();\n  private routesReadyTimeoutMs: number | undefined;\n\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 * @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 {\n  CraftContext,\n  Destination,\n  ExchangeHeaders,\n} from \"@routecraft/routecraft\";\nimport { DefaultExchange } from \"@routecraft/routecraft\";\n\n/** Duck-type: object with send(exchange) returning Promise. */\nfunction isDestination(obj: unknown): obj is Destination<unknown, unknown> {\n  return (\n    typeof obj === \"object\" &&\n    obj !== null &&\n    typeof (obj as { send?: unknown }).send === \"function\"\n  );\n}\n\n/**\n * Invoke a route by id or send to a destination and return the result.\n *\n * - **By route id:** Pass a string. The route is looked up with ctx.getRouteById(routeId).\n *   The route's source must implement Destination (e.g. DirectAdapter). Works with multiple\n *   routes in the default export — use the route's id.\n *\n * - **By destination:** Pass a Destination instance (e.g. direct(\"endpoint\")). Builds an\n *   exchange and calls destination.send(exchange).\n *\n * @param ctx CraftContext (e.g. t.ctx from TestContext) with routes started\n * @param routeIdOrDestination Route id string or a Destination adapter instance\n * @param body Request body\n * @param headers Optional headers for the exchange\n * @returns The result from the route or destination (e.g. response body for DirectAdapter)\n */\nexport async function invoke<T = unknown, R = T>(\n  ctx: CraftContext,\n  routeIdOrDestination: string | Destination<T, R>,\n  body: T,\n  headers?: ExchangeHeaders,\n): Promise<R> {\n  const exchange = new DefaultExchange(ctx, {\n    body,\n    ...(headers !== undefined && { headers }),\n  });\n  let dest: Destination<T, R>;\n\n  if (typeof routeIdOrDestination === \"string\") {\n    const route = ctx.getRouteById(routeIdOrDestination);\n    if (!route) {\n      throw new Error(\n        `No route with id \"${routeIdOrDestination}\". Did you start the context (e.g. await t.test())?`,\n      );\n    }\n    const source = route.definition.source;\n    if (!isDestination(source)) {\n      throw new Error(\n        `Route \"${routeIdOrDestination}\" is not invokable: source must implement Destination (e.g. direct adapter).`,\n      );\n    }\n    dest = source as Destination<T, R>;\n  } else {\n    dest = routeIdOrDestination;\n  }\n\n  const result = await dest.send(exchange as Parameters<typeof dest.send>[0]);\n  return result as R;\n}\n","import type { Source, Destination, Processor } from \"@routecraft/routecraft\";\nimport type { PseudoOptions, PseudoKeyedOptions } from \"./shared\";\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\nexport type PseudoFactory<Opts> = <R = unknown>(opts: Opts) => PseudoAdapter<R>;\n\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// 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 { 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 invoke utility\nexport { invoke } from \"./invoke\";\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/**\n * Load a JSON fixture file and return the parsed value.\n *\n * @param path Absolute or relative path to the JSON file\n * @returns Parsed JSON as T\n */\nexport function fixture<T = unknown>(path: string): T {\n  return JSON.parse(readFileSync(path, \"utf-8\")) as T;\n}\n\n/** 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 * @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

@@ -73,6 +73,7 @@ declare class TestContextBuilder {
     routesReadyTimeout(ms: number): this;
     with(config: CraftConfig): this;
     on<K extends EventName>(event: K, handler: EventHandler<K>): this;
+    once<K extends EventName>(event: K, handler: EventHandler<K>): this;
     store<K extends keyof StoreRegistry>(key: K, value: StoreRegistry[K]): this;
     routes(routes: RouteDefinition[] | RouteBuilder<unknown>[] | RouteDefinition | RouteBuilder<unknown>): this;
     build(): Promise<TestContext>;

package/dist/index.d.ts

@@ -73,6 +73,7 @@ declare class TestContextBuilder {
     routesReadyTimeout(ms: number): this;
     with(config: CraftConfig): this;
     on<K extends EventName>(event: K, handler: EventHandler<K>): this;
+    once<K extends EventName>(event: K, handler: EventHandler<K>): this;
     store<K extends keyof StoreRegistry>(key: K, value: StoreRegistry[K]): this;
     routes(routes: RouteDefinition[] | RouteBuilder<unknown>[] | RouteDefinition | RouteBuilder<unknown>): this;
     build(): Promise<TestContext>;

package/dist/index.js

@@ -1,2 +1,2 @@
-import {readFileSync}from'fs';import {vi,test}from'vitest';import {isRouteCraftError,rcError,ContextBuilder,logger,DefaultExchange}from'@routecraft/routecraft';function h(){let o={info:vi.fn(),debug:vi.fn(),warn:vi.fn(),error:vi.fn(),trace:vi.fn(),fatal:vi.fn(),child:vi.fn()};return o.child.mockImplementation(()=>o),o}function R(){let o=vi.fn(),e=vi.fn(),t={info:o,debug:o,warn:o,error:o,trace:o,fatal:o,child:e};return e.mockImplementation(()=>t),t}var k=200,y=class{ctx;logger;errors=[];routesReadyTimeoutMs;restoreLoggerChild;startedPromise;constructor(e,t){this.ctx=e,this.logger=t?.spyLogger??R(),t?.restoreLoggerChild&&(this.restoreLoggerChild=t.restoreLoggerChild),this.routesReadyTimeoutMs=t?.routesReadyTimeoutMs??k,e.on("error",r=>{let n=r.details.error;this.errors.push(isRouteCraftError(n)?n:rcError("RC9901",n));});}async startAndWaitReady(){let e=this.ctx,t=e.getRoutes().length,r=t===0?Promise.resolve():new Promise((n,i)=>{let a=0,s=false,d=setTimeout(()=>{s||(s=true,u(),f(),i(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),u=e.on("route:started",()=>{s||(a++,a>=t&&(s=true,clearTimeout(d),u(),f(),n()));}),f=e.on("error",l=>{s||(s=true,clearTimeout(d),u(),f(),i(l.details.error));});});this.startedPromise=e.start(),await Promise.all([this.startedPromise,r]);}async test(e){let t=this.ctx,r=t.getRoutes().length,n=r===0?Promise.resolve():new Promise((a,s)=>{let d=0,u=false,f=setTimeout(()=>{u||(m(),s(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),l=t.on("route:started",()=>{u||(d++,d>=r&&(m(),a()));}),x=t.on("error",P=>{u||(m(),s(P.details.error));});function m(){u||(u=true,l(),x(),f!==void 0&&(clearTimeout(f),f=void 0));}}),i=t.start();try{await n;let a=e?.delayBeforeDrainMs??0;a>0&&await new Promise(s=>setTimeout(s,a)),await t.drain();}finally{try{await t.stop(),await i;}finally{this.restoreLoggerChild?.();}}}drain(){return this.ctx.drain()}async stop(){await this.ctx.stop(),this.startedPromise!==void 0&&await this.startedPromise;}},g=class{builder=new ContextBuilder;routesReadyTimeoutMs;routesReadyTimeout(e){return this.routesReadyTimeoutMs=e,this}with(e){return this.builder.with(e),this}on(e,t){return this.builder.on(e,t),this}store(e,t){return this.builder.store(e,t),this}routes(e){return this.builder.routes(e),this}async build(){let e=h(),t=logger.child.bind(logger);logger.child=vi.fn(()=>e);let r=await this.builder.build(),n={...this.routesReadyTimeoutMs!==void 0?{routesReadyTimeoutMs:this.routesReadyTimeoutMs}:{},spyLogger:e,restoreLoggerChild:()=>{logger.child=t;}};return new y(r,n)}};function b(){return new g}function L(o){return typeof o=="object"&&o!==null&&typeof o.send=="function"}async function E(o,e,t,r){let n=new DefaultExchange(o,{body:t,...r!==void 0&&{headers:r}}),i;if(typeof e=="string"){let s=o.getRouteById(e);if(!s)throw new Error(`No route with id "${e}". Did you start the context (e.g. await t.test())?`);let d=s.definition.source;if(!L(d))throw new Error(`Route "${e}" is not invokable: source must implement Destination (e.g. direct adapter).`);i=d;}else i=e;return await i.send(n)}function w(o,e){let t=()=>{throw new Error(`Pseudo adapter "${o}" is not implemented. Replace with a real adapter.`)},r=()=>Promise.resolve(void 0),n=a=>a,i=(a,s,d,u)=>(u?.(),Promise.resolve());return {adapterId:`routecraft.adapter.pseudo.${o}`,subscribe:e==="noop"?i:t,send:e==="noop"?r:t,process:e==="noop"?n:t}}function F(o="pseudo",e){let t=e?.runtime??"throw";return e&&"args"in e&&e.args==="keyed"?(n,i)=>w(o,t):n=>w(o,t)}function A(o){return JSON.parse(readFileSync(o,"utf-8"))}function q(o,e){let t=A(o);if(!Array.isArray(t))throw new Error(`fixture.each: expected JSON array at "${o}", got ${typeof t}`);for(let r of t){if(typeof r?.name!="string")throw new Error(`fixture.each: each entry must have a "name" field (string). Got: ${JSON.stringify(r)}`);test(r.name,()=>e(r));}}export{y as TestContext,g as TestContextBuilder,R as createNoopSpyLogger,h as createSpyLogger,A as fixture,q as fixtureEach,E as invoke,F as pseudo,b as testContext};//# sourceMappingURL=index.js.map
+import {readFileSync}from'fs';import {vi,test}from'vitest';import {isRouteCraftError,rcError,ContextBuilder,logger,DefaultExchange}from'@routecraft/routecraft';function h(){let r={info:vi.fn(),debug:vi.fn(),warn:vi.fn(),error:vi.fn(),trace:vi.fn(),fatal:vi.fn(),child:vi.fn()};return r.child.mockImplementation(()=>r),r}function R(){let r=vi.fn(),e=vi.fn(),t={info:r,debug:r,warn:r,error:r,trace:r,fatal:r,child:e};return e.mockImplementation(()=>t),t}var k=200,y=class{ctx;logger;errors=[];routesReadyTimeoutMs;restoreLoggerChild;startedPromise;constructor(e,t){this.ctx=e,this.logger=t?.spyLogger??R(),t?.restoreLoggerChild&&(this.restoreLoggerChild=t.restoreLoggerChild),this.routesReadyTimeoutMs=t?.routesReadyTimeoutMs??k,e.on("error",o=>{let n=o.details.error;this.errors.push(isRouteCraftError(n)?n:rcError("RC9901",n));});}async startAndWaitReady(){let e=this.ctx,t=e.getRoutes().length,o=t===0?Promise.resolve():new Promise((n,i)=>{let a=0,s=false,d=setTimeout(()=>{s||(s=true,u(),f(),i(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),u=e.on("route:started",()=>{s||(a++,a>=t&&(s=true,clearTimeout(d),u(),f(),n()));}),f=e.on("error",l=>{s||(s=true,clearTimeout(d),u(),f(),i(l.details.error));});});this.startedPromise=e.start(),await Promise.all([this.startedPromise,o]);}async test(e){let t=this.ctx,o=t.getRoutes().length,n=o===0?Promise.resolve():new Promise((a,s)=>{let d=0,u=false,f=setTimeout(()=>{u||(m(),s(new Error("Timeout waiting for routes to start")));},this.routesReadyTimeoutMs),l=t.on("route:started",()=>{u||(d++,d>=o&&(m(),a()));}),x=t.on("error",P=>{u||(m(),s(P.details.error));});function m(){u||(u=true,l(),x(),f!==void 0&&(clearTimeout(f),f=void 0));}}),i=t.start();try{await n;let a=e?.delayBeforeDrainMs??0;a>0&&await new Promise(s=>setTimeout(s,a)),await t.drain();}finally{try{await t.stop(),await i;}finally{this.restoreLoggerChild?.();}}}drain(){return this.ctx.drain()}async stop(){await this.ctx.stop(),this.startedPromise!==void 0&&await this.startedPromise;}},g=class{builder=new ContextBuilder;routesReadyTimeoutMs;routesReadyTimeout(e){return this.routesReadyTimeoutMs=e,this}with(e){return this.builder.with(e),this}on(e,t){return this.builder.on(e,t),this}once(e,t){return this.builder.once(e,t),this}store(e,t){return this.builder.store(e,t),this}routes(e){return this.builder.routes(e),this}async build(){let e=h(),t=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=t;}};return new y(o,n)}};function b(){return new g}function L(r){return typeof r=="object"&&r!==null&&typeof r.send=="function"}async function E(r,e,t,o){let n=new DefaultExchange(r,{body:t,...o!==void 0&&{headers:o}}),i;if(typeof e=="string"){let s=r.getRouteById(e);if(!s)throw new Error(`No route with id "${e}". Did you start the context (e.g. await t.test())?`);let d=s.definition.source;if(!L(d))throw new Error(`Route "${e}" is not invokable: source must implement Destination (e.g. direct adapter).`);i=d;}else i=e;return await i.send(n)}function w(r,e){let t=()=>{throw new Error(`Pseudo adapter "${r}" is not implemented. Replace with a real adapter.`)},o=()=>Promise.resolve(void 0),n=a=>a,i=(a,s,d,u)=>(u?.(),Promise.resolve());return {adapterId:`routecraft.adapter.pseudo.${r}`,subscribe:e==="noop"?i:t,send:e==="noop"?o:t,process:e==="noop"?n:t}}function F(r="pseudo",e){let t=e?.runtime??"throw";return e&&"args"in e&&e.args==="keyed"?(n,i)=>w(r,t):n=>w(r,t)}function A(r){return JSON.parse(readFileSync(r,"utf-8"))}function q(r,e){let t=A(r);if(!Array.isArray(t))throw new Error(`fixture.each: expected JSON array at "${r}", got ${typeof t}`);for(let o of t){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{y as TestContext,g as TestContextBuilder,R as createNoopSpyLogger,h as createSpyLogger,A as fixture,q as fixtureEach,E as invoke,F as pseudo,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/invoke.ts","../src/adapters/pseudo/index.ts","../src/index.ts"],"names":["createSpyLogger","spy","vi","createNoopSpyLogger","noop","childFn","noopLogger","DEFAULT_ROUTES_READY_TIMEOUT_MS","TestContext","ctx","options","payload","err","isRouteCraftError","rcError","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","isDestination","obj","invoke","routeIdOrDestination","body","headers","exchange","DefaultExchange","dest","route","source","createAdapter","name","runtime","fail","noopSend","noopProcess","noopSubscribe","_context","_handler","_abortController","onReady","pseudo","opts","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 */\nexport type SpyLogger = {\n  info: ReturnType<typeof vi.fn>;\n  debug: ReturnType<typeof vi.fn>;\n  warn: ReturnType<typeof vi.fn>;\n  error: ReturnType<typeof vi.fn>;\n  trace: ReturnType<typeof vi.fn>;\n  fatal: ReturnType<typeof vi.fn>;\n  child: ReturnType<typeof vi.fn>;\n};\n\nexport function createSpyLogger(): SpyLogger {\n  const spy: SpyLogger = {\n    info: vi.fn(),\n    debug: vi.fn(),\n    warn: vi.fn(),\n    error: vi.fn(),\n    trace: vi.fn(),\n    fatal: vi.fn(),\n    child: vi.fn(),\n  };\n  spy.child.mockImplementation(() => spy);\n  return spy;\n}\n\nexport function createNoopSpyLogger(): SpyLogger {\n  const noop = vi.fn();\n  const childFn = vi.fn();\n  const noopLogger: SpyLogger = {\n    info: noop,\n    debug: noop,\n    warn: noop,\n    error: noop,\n    trace: noop,\n    fatal: noop,\n    child: childFn,\n  };\n  childFn.mockImplementation(() => noopLogger);\n  return noopLogger;\n}\n","import { 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  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 */\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 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    ctx.on(\"error\", (payload) => {\n      const err = payload.details.error;\n      this.errors.push(\n        isRouteCraftError(err)\n          ? (err as RouteCraftError)\n          : rcError(\"RC9901\", err),\n      );\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(\"route:started\", () => {\n              if (settled) return;\n              ready++;\n              if (ready >= total) {\n                settled = true;\n                clearTimeout(timeoutId);\n                offRouteStarted();\n                offError();\n                resolve();\n              }\n            });\n            const offError = ctx.on(\"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(\"route:started\", () => {\n              if (settled) return;\n              ready++;\n              if (ready >= total) {\n                cleanup();\n                resolve();\n              }\n            });\n            const offError = ctx.on(\"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.restoreLoggerChild?.();\n      }\n    }\n  }\n\n  drain(): Promise<void> {\n    return this.ctx.drain();\n  }\n\n  async stop(): Promise<void> {\n    await this.ctx.stop();\n    if (this.startedPromise !== undefined) {\n      await this.startedPromise;\n    }\n  }\n}\n\n/**\n * Builder that returns TestContext instead of CraftContext.\n * Same API as ContextBuilder (routes, on, with, store).\n */\nexport class TestContextBuilder {\n  private builder = new ContextBuilder();\n  private routesReadyTimeoutMs: number | undefined;\n\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  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 * @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 {\n  CraftContext,\n  Destination,\n  ExchangeHeaders,\n} from \"@routecraft/routecraft\";\nimport { DefaultExchange } from \"@routecraft/routecraft\";\n\n/** Duck-type: object with send(exchange) returning Promise. */\nfunction isDestination(obj: unknown): obj is Destination<unknown, unknown> {\n  return (\n    typeof obj === \"object\" &&\n    obj !== null &&\n    typeof (obj as { send?: unknown }).send === \"function\"\n  );\n}\n\n/**\n * Invoke a route by id or send to a destination and return the result.\n *\n * - **By route id:** Pass a string. The route is looked up with ctx.getRouteById(routeId).\n *   The route's source must implement Destination (e.g. DirectAdapter). Works with multiple\n *   routes in the default export — use the route's id.\n *\n * - **By destination:** Pass a Destination instance (e.g. direct(\"endpoint\")). Builds an\n *   exchange and calls destination.send(exchange).\n *\n * @param ctx CraftContext (e.g. t.ctx from TestContext) with routes started\n * @param routeIdOrDestination Route id string or a Destination adapter instance\n * @param body Request body\n * @param headers Optional headers for the exchange\n * @returns The result from the route or destination (e.g. response body for DirectAdapter)\n */\nexport async function invoke<T = unknown, R = T>(\n  ctx: CraftContext,\n  routeIdOrDestination: string | Destination<T, R>,\n  body: T,\n  headers?: ExchangeHeaders,\n): Promise<R> {\n  const exchange = new DefaultExchange(ctx, {\n    body,\n    ...(headers !== undefined && { headers }),\n  });\n  let dest: Destination<T, R>;\n\n  if (typeof routeIdOrDestination === \"string\") {\n    const route = ctx.getRouteById(routeIdOrDestination);\n    if (!route) {\n      throw new Error(\n        `No route with id \"${routeIdOrDestination}\". Did you start the context (e.g. await t.test())?`,\n      );\n    }\n    const source = route.definition.source;\n    if (!isDestination(source)) {\n      throw new Error(\n        `Route \"${routeIdOrDestination}\" is not invokable: source must implement Destination (e.g. direct adapter).`,\n      );\n    }\n    dest = source as Destination<T, R>;\n  } else {\n    dest = routeIdOrDestination;\n  }\n\n  const result = await dest.send(exchange as Parameters<typeof dest.send>[0]);\n  return result as R;\n}\n","import type { Source, Destination, Processor } from \"@routecraft/routecraft\";\nimport type { PseudoOptions, PseudoKeyedOptions } from \"./shared\";\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\nexport type PseudoFactory<Opts> = <R = unknown>(opts: Opts) => PseudoAdapter<R>;\n\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// 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 { 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 invoke utility\nexport { invoke } from \"./invoke\";\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/**\n * Load a JSON fixture file and return the parsed value.\n *\n * @param path Absolute or relative path to the JSON file\n * @returns Parsed JSON as T\n */\nexport function fixture<T = unknown>(path: string): T {\n  return JSON.parse(readFileSync(path, \"utf-8\")) as T;\n}\n\n/** 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 * @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/invoke.ts","../src/adapters/pseudo/index.ts","../src/index.ts"],"names":["createSpyLogger","spy","vi","createNoopSpyLogger","noop","childFn","noopLogger","DEFAULT_ROUTES_READY_TIMEOUT_MS","TestContext","ctx","options","payload","err","isRouteCraftError","rcError","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","isDestination","obj","invoke","routeIdOrDestination","body","headers","exchange","DefaultExchange","dest","route","source","createAdapter","name","runtime","fail","noopSend","noopProcess","noopSubscribe","_context","_handler","_abortController","onReady","pseudo","opts","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 */\nexport type SpyLogger = {\n  info: ReturnType<typeof vi.fn>;\n  debug: ReturnType<typeof vi.fn>;\n  warn: ReturnType<typeof vi.fn>;\n  error: ReturnType<typeof vi.fn>;\n  trace: ReturnType<typeof vi.fn>;\n  fatal: ReturnType<typeof vi.fn>;\n  child: ReturnType<typeof vi.fn>;\n};\n\nexport function createSpyLogger(): SpyLogger {\n  const spy: SpyLogger = {\n    info: vi.fn(),\n    debug: vi.fn(),\n    warn: vi.fn(),\n    error: vi.fn(),\n    trace: vi.fn(),\n    fatal: vi.fn(),\n    child: vi.fn(),\n  };\n  spy.child.mockImplementation(() => spy);\n  return spy;\n}\n\nexport function createNoopSpyLogger(): SpyLogger {\n  const noop = vi.fn();\n  const childFn = vi.fn();\n  const noopLogger: SpyLogger = {\n    info: noop,\n    debug: noop,\n    warn: noop,\n    error: noop,\n    trace: noop,\n    fatal: noop,\n    child: childFn,\n  };\n  childFn.mockImplementation(() => noopLogger);\n  return noopLogger;\n}\n","import { 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  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 */\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 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    ctx.on(\"error\", (payload) => {\n      const err = payload.details.error;\n      this.errors.push(\n        isRouteCraftError(err)\n          ? (err as RouteCraftError)\n          : rcError(\"RC9901\", err),\n      );\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(\"route:started\", () => {\n              if (settled) return;\n              ready++;\n              if (ready >= total) {\n                settled = true;\n                clearTimeout(timeoutId);\n                offRouteStarted();\n                offError();\n                resolve();\n              }\n            });\n            const offError = ctx.on(\"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(\"route:started\", () => {\n              if (settled) return;\n              ready++;\n              if (ready >= total) {\n                cleanup();\n                resolve();\n              }\n            });\n            const offError = ctx.on(\"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.restoreLoggerChild?.();\n      }\n    }\n  }\n\n  drain(): Promise<void> {\n    return this.ctx.drain();\n  }\n\n  async stop(): Promise<void> {\n    await this.ctx.stop();\n    if (this.startedPromise !== undefined) {\n      await this.startedPromise;\n    }\n  }\n}\n\n/**\n * Builder that returns TestContext instead of CraftContext.\n * Same API as ContextBuilder (routes, on, with, store).\n */\nexport class TestContextBuilder {\n  private builder = new ContextBuilder();\n  private routesReadyTimeoutMs: number | undefined;\n\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 * @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 {\n  CraftContext,\n  Destination,\n  ExchangeHeaders,\n} from \"@routecraft/routecraft\";\nimport { DefaultExchange } from \"@routecraft/routecraft\";\n\n/** Duck-type: object with send(exchange) returning Promise. */\nfunction isDestination(obj: unknown): obj is Destination<unknown, unknown> {\n  return (\n    typeof obj === \"object\" &&\n    obj !== null &&\n    typeof (obj as { send?: unknown }).send === \"function\"\n  );\n}\n\n/**\n * Invoke a route by id or send to a destination and return the result.\n *\n * - **By route id:** Pass a string. The route is looked up with ctx.getRouteById(routeId).\n *   The route's source must implement Destination (e.g. DirectAdapter). Works with multiple\n *   routes in the default export — use the route's id.\n *\n * - **By destination:** Pass a Destination instance (e.g. direct(\"endpoint\")). Builds an\n *   exchange and calls destination.send(exchange).\n *\n * @param ctx CraftContext (e.g. t.ctx from TestContext) with routes started\n * @param routeIdOrDestination Route id string or a Destination adapter instance\n * @param body Request body\n * @param headers Optional headers for the exchange\n * @returns The result from the route or destination (e.g. response body for DirectAdapter)\n */\nexport async function invoke<T = unknown, R = T>(\n  ctx: CraftContext,\n  routeIdOrDestination: string | Destination<T, R>,\n  body: T,\n  headers?: ExchangeHeaders,\n): Promise<R> {\n  const exchange = new DefaultExchange(ctx, {\n    body,\n    ...(headers !== undefined && { headers }),\n  });\n  let dest: Destination<T, R>;\n\n  if (typeof routeIdOrDestination === \"string\") {\n    const route = ctx.getRouteById(routeIdOrDestination);\n    if (!route) {\n      throw new Error(\n        `No route with id \"${routeIdOrDestination}\". Did you start the context (e.g. await t.test())?`,\n      );\n    }\n    const source = route.definition.source;\n    if (!isDestination(source)) {\n      throw new Error(\n        `Route \"${routeIdOrDestination}\" is not invokable: source must implement Destination (e.g. direct adapter).`,\n      );\n    }\n    dest = source as Destination<T, R>;\n  } else {\n    dest = routeIdOrDestination;\n  }\n\n  const result = await dest.send(exchange as Parameters<typeof dest.send>[0]);\n  return result as R;\n}\n","import type { Source, Destination, Processor } from \"@routecraft/routecraft\";\nimport type { PseudoOptions, PseudoKeyedOptions } from \"./shared\";\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\nexport type PseudoFactory<Opts> = <R = unknown>(opts: Opts) => PseudoAdapter<R>;\n\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// 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 { 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 invoke utility\nexport { invoke } from \"./invoke\";\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/**\n * Load a JSON fixture file and return the parsed value.\n *\n * @param path Absolute or relative path to the JSON file\n * @returns Parsed JSON as T\n */\nexport function fixture<T = unknown>(path: string): T {\n  return JSON.parse(readFileSync(path, \"utf-8\")) as T;\n}\n\n/** 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 * @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.3.0-canary.9",
+  "version": "0.3.0",
   "description": "Test utilities for RouteCraft routes",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -23,7 +23,7 @@
     "prepublishOnly": "pnpm run build"
   },
   "dependencies": {
-    "@routecraft/routecraft": "^0.3.0-canary.9"
+    "@routecraft/routecraft": "^0.4.0"
   },
   "devDependencies": {
     "vitest": "^4.0.18"