@copilotkit/aimock 1.43.0 → 1.45.0

package/dist/vitest.cjs

@@ -1,7 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 const require_fixture_loader = require('./fixture-loader.cjs');
+const require_mcp_fakes_report = require('./mcp-fakes-report.cjs');
 const require_llmock = require('./llmock.cjs');
+const require_fakes_plugin = require('./fakes-plugin.cjs');
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 let vitest = require("vitest");
@@ -19,12 +21,26 @@ let vitest = require("vitest");
 *     const res = await fetch(`${mock().url}/v1/chat/completions`, { ... });
 *   });
 */
+/** TI1: `<file> › <name1> › … › <nameN>`; unnamed suites add no segment. */
+function defaultVitestId(task) {
+	const names = [];
+	for (let suite = task.suite; suite !== void 0 && suite !== task.file; suite = suite.suite) if (suite.name !== "") names.unshift(suite.name);
+	return [
+		task.file.name,
+		...names,
+		task.name
+	].join(require_fakes_plugin.TEST_ID_SEPARATOR);
+}
 /**
 * Start an aimock server for the duration of the test suite.
 *
-* - `beforeAll`: starts the server and optionally loads fixtures
-* - `beforeEach`: closes Live sessions and resets fixture match counts (not fixtures)
-* - `afterEach`: closes Live sessions owned by this helper's server
+* - `beforeAll`: starts the server and optionally loads fixtures (LLM fixtures and
+*   `mcpFakes` blocks; a bad `mcpFakes` block fails `beforeAll`)
+* - `beforeEach`: closes Live sessions and resets fixture match counts and MCP fake
+*   consumption (not fixtures or fakes); under `fakesReport: "warn" | "fail"` it
+*   throws in a concurrent test, which the per-test report does not support
+* - `afterEach`: closes Live sessions owned by this helper's server, then checks
+*   the MCP fake report under `fakesReport: "warn" | "fail"`
 * - `afterAll`: stops the server
 *
 * Returns a getter function — call it inside tests to access the handle.
@@ -33,13 +49,34 @@ function useAimock(options = {}) {
 	let handle = null;
 	let origOpenaiUrl;
 	let origAnthropicUrl;
+	let state = new require_fakes_plugin.FakesPluginState("off");
+	/** TI5: default id -> the `task.id` that first used it; fresh per `beforeAll`. */
+	let idMap = /* @__PURE__ */ new Map();
+	let current = null;
+	function resolveTestId(testId) {
+		if (testId !== void 0) return testId;
+		if (current === null) throw new require_mcp_fakes_report.AimockTestIdCollisionError("fakesFor() needs a running test; pass an explicit testId");
+		if (current.concurrent === true) throw new require_mcp_fakes_report.AimockTestIdCollisionError("default test ids are not supported in concurrent tests; pass an explicit testId");
+		const id = defaultVitestId(current);
+		const owner = idMap.get(id);
+		if (owner !== void 0 && owner !== current.id) throw new require_mcp_fakes_report.AimockTestIdCollisionError(`two tests share the default test id ${JSON.stringify(id)}; pass an explicit testId`);
+		idMap.set(id, current.id);
+		return id;
+	}
+	/**
+	* The report keeps one state per `useAimock`, so concurrent tests would
+	* clear and read each other's identities: under `"warn"` or `"fail"`, a
+	* concurrent test is refused in `beforeEach` (and not reported on).
+	*/
+	function refusesConcurrent(task) {
+		return state.mode !== "off" && task.concurrent === true;
+	}
 	(0, vitest.beforeAll)(async () => {
-		const { fixtures: fixturePath, patchEnv, ...serverOpts } = options;
+		const { fixtures: fixturePath, patchEnv, fakesReport, ...serverOpts } = options;
+		state = new require_fakes_plugin.FakesPluginState(require_fakes_plugin.fakesReportMode(fakesReport));
+		idMap = /* @__PURE__ */ new Map();
 		const llm = new require_llmock.LLMock(serverOpts);
-		if (fixturePath) {
-			const loadedFixtures = loadFixtures((0, node_path.resolve)(fixturePath), options.live);
-			for (const f of loadedFixtures) llm.addFixture(f);
-		}
+		if (fixturePath) loadFixtures(llm, (0, node_path.resolve)(fixturePath));
 		const url = await llm.start();
 		if (patchEnv !== false) {
 			origOpenaiUrl = process.env.OPENAI_BASE_URL;
@@ -49,17 +86,33 @@ function useAimock(options = {}) {
 		}
 		handle = {
 			llm,
-			url
+			url,
+			fakesFor(testId, opts = {}) {
+				const id = resolveTestId(testId);
+				state.register(id, opts.context ?? null);
+				return require_fakes_plugin.fakesTarget(url, id, opts);
+			},
+			fakesReport(testId, opts = {}) {
+				return require_fakes_plugin.fetchFakesReport(url, resolveTestId(testId), opts.context ?? null);
+			}
 		};
 	});
-	(0, vitest.beforeEach)(() => {
+	(0, vitest.beforeEach)((ctx) => {
+		current = ctx.task;
+		if (refusesConcurrent(ctx.task)) throw new Error("useAimock(): fakesReport is not supported in concurrent tests; set fakesReport: \"off\" for this suite or run it sequentially");
 		if (handle) {
 			handle.llm.closeLiveSessions();
 			handle.llm.resetMatchCounts();
+			state.beforeEach(handle.llm);
 		}
 	});
-	(0, vitest.afterEach)(() => {
-		handle?.llm.closeLiveSessions();
+	(0, vitest.afterEach)(async (ctx) => {
+		try {
+			handle?.llm.closeLiveSessions();
+			if (handle && !refusesConcurrent(ctx.task)) await state.afterEach(handle.llm, handle.url);
+		} finally {
+			current = null;
+		}
 	});
 	(0, vitest.afterAll)(async () => {
 		if (handle) {
@@ -78,13 +131,21 @@ function useAimock(options = {}) {
 		return handle;
 	};
 }
-function loadFixtures(fixturePath, liveOptions) {
+/**
+* Load a fixture file or directory into `llm`: its LLM fixtures and its
+* `mcpFakes` blocks, which the LLMock buffers and auto-mounts at start (F12).
+* A `FixtureLoadError` (a bad `mcpFakes` block) or a `MisbehaviorConfigError`
+* (a bad fixture `misbehavior` key, thrown only with `enableMisbehavior: true`)
+* propagates and fails `beforeAll`; any other load failure is only warned
+* about, as before.
+*/
+function loadFixtures(llm, fixturePath) {
 	try {
-		if ((0, node_fs.statSync)(fixturePath).isDirectory()) return require_fixture_loader.loadFixturesFromDir(fixturePath, void 0, liveOptions);
-		return require_fixture_loader.loadFixtureFile(fixturePath, void 0, liveOptions);
+		if ((0, node_fs.statSync)(fixturePath).isDirectory()) llm.loadFixtureDir(fixturePath);
+		else llm.loadFixtureFile(fixturePath);
 	} catch (err) {
+		if (err instanceof require_fixture_loader.FixtureLoadError || err instanceof require_fixture_loader.MisbehaviorConfigError) throw err;
 		console.warn(`[aimock] Failed to load fixtures from ${fixturePath}: ${err instanceof Error ? err.message : String(err)}`);
-		return [];
 	}
 }
 

package/dist/vitest.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"vitest.cjs","names":["LLMock","loadFixturesFromDir","loadFixtureFile"],"sources":["../src/vitest.ts"],"sourcesContent":["/**\n * Vitest integration for aimock.\n *\n * Usage:\n *   import { useAimock } from \"@copilotkit/aimock/vitest\";\n *\n *   const mock = useAimock({ fixtures: \"./fixtures\" });\n *\n *   it(\"responds\", async () => {\n *     const res = await fetch(`${mock().url}/v1/chat/completions`, { ... });\n *   });\n */\n\nimport { beforeAll, afterAll, beforeEach, afterEach } from \"vitest\";\nimport { LLMock } from \"./llmock.js\";\nimport { loadFixtureFile, loadFixturesFromDir } from \"./fixture-loader.js\";\nimport type { LiveOptions } from \"./live-types.js\";\nimport type { Fixture, MockServerOptions } from \"./types.js\";\nimport { statSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nexport interface UseAimockOptions extends MockServerOptions {\n  /** Path to fixture file or directory. Loaded automatically on start. */\n  fixtures?: string;\n  /** If true, sets process.env.OPENAI_BASE_URL to the mock URL + /v1. */\n  patchEnv?: boolean;\n}\n\nexport interface AimockHandle {\n  /** The LLMock instance. */\n  readonly llm: LLMock;\n  /** The server URL (e.g., http://127.0.0.1:4010). */\n  readonly url: string;\n}\n\n/**\n * Start an aimock server for the duration of the test suite.\n *\n * - `beforeAll`: starts the server and optionally loads fixtures\n * - `beforeEach`: closes Live sessions and resets fixture match counts (not fixtures)\n * - `afterEach`: closes Live sessions owned by this helper's server\n * - `afterAll`: stops the server\n *\n * Returns a getter function — call it inside tests to access the handle.\n */\nexport function useAimock(options: UseAimockOptions = {}): () => AimockHandle {\n  let handle: AimockHandle | null = null;\n  let origOpenaiUrl: string | undefined;\n  let origAnthropicUrl: string | undefined;\n\n  beforeAll(async () => {\n    const { fixtures: fixturePath, patchEnv, ...serverOpts } = options;\n    const llm = new LLMock(serverOpts);\n\n    if (fixturePath) {\n      const resolved = resolve(fixturePath);\n      const loadedFixtures = loadFixtures(resolved, options.live);\n      for (const f of loadedFixtures) {\n        llm.addFixture(f);\n      }\n    }\n\n    const url = await llm.start();\n\n    if (patchEnv !== false) {\n      origOpenaiUrl = process.env.OPENAI_BASE_URL;\n      origAnthropicUrl = process.env.ANTHROPIC_BASE_URL;\n      process.env.OPENAI_BASE_URL = `${url}/v1`;\n      process.env.ANTHROPIC_BASE_URL = `${url}/v1`;\n    }\n\n    handle = { llm, url };\n  });\n\n  beforeEach(() => {\n    if (handle) {\n      handle.llm.closeLiveSessions();\n      handle.llm.resetMatchCounts();\n    }\n  });\n\n  afterEach(() => {\n    handle?.llm.closeLiveSessions();\n  });\n\n  afterAll(async () => {\n    if (handle) {\n      if (options.patchEnv !== false) {\n        if (origOpenaiUrl !== undefined) process.env.OPENAI_BASE_URL = origOpenaiUrl;\n        else delete process.env.OPENAI_BASE_URL;\n        if (origAnthropicUrl !== undefined) process.env.ANTHROPIC_BASE_URL = origAnthropicUrl;\n        else delete process.env.ANTHROPIC_BASE_URL;\n      }\n      await handle.llm.stop();\n      handle = null;\n    }\n  });\n\n  return () => {\n    if (!handle) {\n      throw new Error(\"useAimock(): server not started — are you calling this inside a test?\");\n    }\n    return handle;\n  };\n}\n\nfunction loadFixtures(fixturePath: string, liveOptions?: LiveOptions): Fixture[] {\n  try {\n    const stat = statSync(fixturePath);\n    if (stat.isDirectory()) {\n      return loadFixturesFromDir(fixturePath, undefined, liveOptions);\n    }\n    return loadFixtureFile(fixturePath, undefined, liveOptions);\n  } catch (err) {\n    console.warn(\n      `[aimock] Failed to load fixtures from ${fixturePath}: ${err instanceof Error ? err.message : String(err)}`,\n    );\n    return [];\n  }\n}\n\nexport { LLMock } from \"./llmock.js\";\nexport type { MockServerOptions, Fixture } from \"./types.js\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,SAAgB,UAAU,UAA4B,EAAE,EAAsB;CAC5E,IAAI,SAA8B;CAClC,IAAI;CACJ,IAAI;AAEJ,uBAAU,YAAY;EACpB,MAAM,EAAE,UAAU,aAAa,UAAU,GAAG,eAAe;EAC3D,MAAM,MAAM,IAAIA,sBAAO,WAAW;AAElC,MAAI,aAAa;GAEf,MAAM,iBAAiB,oCADE,YAAY,EACS,QAAQ,KAAK;AAC3D,QAAK,MAAM,KAAK,eACd,KAAI,WAAW,EAAE;;EAIrB,MAAM,MAAM,MAAM,IAAI,OAAO;AAE7B,MAAI,aAAa,OAAO;AACtB,mBAAgB,QAAQ,IAAI;AAC5B,sBAAmB,QAAQ,IAAI;AAC/B,WAAQ,IAAI,kBAAkB,GAAG,IAAI;AACrC,WAAQ,IAAI,qBAAqB,GAAG,IAAI;;AAG1C,WAAS;GAAE;GAAK;GAAK;GACrB;AAEF,8BAAiB;AACf,MAAI,QAAQ;AACV,UAAO,IAAI,mBAAmB;AAC9B,UAAO,IAAI,kBAAkB;;GAE/B;AAEF,6BAAgB;AACd,UAAQ,IAAI,mBAAmB;GAC/B;AAEF,sBAAS,YAAY;AACnB,MAAI,QAAQ;AACV,OAAI,QAAQ,aAAa,OAAO;AAC9B,QAAI,kBAAkB,OAAW,SAAQ,IAAI,kBAAkB;QAC1D,QAAO,QAAQ,IAAI;AACxB,QAAI,qBAAqB,OAAW,SAAQ,IAAI,qBAAqB;QAChE,QAAO,QAAQ,IAAI;;AAE1B,SAAM,OAAO,IAAI,MAAM;AACvB,YAAS;;GAEX;AAEF,cAAa;AACX,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,wEAAwE;AAE1F,SAAO;;;AAIX,SAAS,aAAa,aAAqB,aAAsC;AAC/E,KAAI;AAEF,4BADsB,YAAY,CACzB,aAAa,CACpB,QAAOC,2CAAoB,aAAa,QAAW,YAAY;AAEjE,SAAOC,uCAAgB,aAAa,QAAW,YAAY;UACpD,KAAK;AACZ,UAAQ,KACN,yCAAyC,YAAY,IAAI,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAC1G;AACD,SAAO,EAAE"}
+{"version":3,"file":"vitest.cjs","names":["TEST_ID_SEPARATOR","FakesPluginState","AimockTestIdCollisionError","fakesReportMode","LLMock","fakesTarget","fetchFakesReport","FixtureLoadError","MisbehaviorConfigError"],"sources":["../src/vitest.ts"],"sourcesContent":["/**\n * Vitest integration for aimock.\n *\n * Usage:\n *   import { useAimock } from \"@copilotkit/aimock/vitest\";\n *\n *   const mock = useAimock({ fixtures: \"./fixtures\" });\n *\n *   it(\"responds\", async () => {\n *     const res = await fetch(`${mock().url}/v1/chat/completions`, { ... });\n *   });\n */\n\nimport { beforeAll, afterAll, beforeEach, afterEach } from \"vitest\";\nimport type { RunnerTestCase, RunnerTestSuite } from \"vitest\";\nimport { LLMock } from \"./llmock.js\";\nimport { FixtureLoadError, MisbehaviorConfigError } from \"./fixture-loader.js\";\nimport type { MockServerOptions } from \"./types.js\";\nimport {\n  FakesPluginState,\n  TEST_ID_SEPARATOR,\n  fakesReportMode,\n  fakesTarget,\n  fetchFakesReport,\n  type FakesForOptions,\n  type FakesReportMode,\n  type FakesTarget,\n} from \"./fakes-plugin.js\";\nimport { AimockTestIdCollisionError, type McpFakesReport } from \"./mcp-fakes-report.js\";\nimport { statSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nexport interface UseAimockOptions extends MockServerOptions {\n  /** Path to fixture file or directory. Loaded automatically on start. */\n  fixtures?: string;\n  /** If true, sets process.env.OPENAI_BASE_URL to the mock URL + /v1. */\n  patchEnv?: boolean;\n  /**\n   * The per-test MCP fake report, read in `afterEach` (RP7): `\"off\"` (the\n   * default), `\"warn\"` (print a failing report) or `\"fail\"` (throw\n   * `AimockFakesReportError`). Not supported in concurrent tests: under\n   * `\"warn\"` or `\"fail\"`, a concurrent test fails in `beforeEach`.\n   */\n  fakesReport?: FakesReportMode;\n}\n\nexport interface AimockHandle {\n  /** The LLMock instance. */\n  readonly llm: LLMock;\n  /** The server URL (e.g., http://127.0.0.1:4010). */\n  readonly url: string;\n}\n\n/**\n * The handle `useAimock` returns: an `AimockHandle` plus the MCP fakes\n * helpers (RP7). A separate type, so that `AimockHandle` stays as it was and\n * code that builds its own `AimockHandle` keeps compiling.\n */\nexport interface AimockFakesHandle extends AimockHandle {\n  /**\n   * The MCP URL and headers for the fakes scoped to `testId` (RP7), and\n   * registers that identity for this test's report. With no `testId`, the\n   * default is `<file> › <describe…> › <test>` (TI1); it is used only here and\n   * in `fakesReport`, never on LLM traffic (TI4). Throws\n   * `AimockTestIdCollisionError` when two tests share a default id, in a\n   * concurrent test, or outside a test.\n   */\n  fakesFor(testId?: string, opts?: FakesForOptions): FakesTarget;\n  /** The MCP fake report for `testId` (default as in `fakesFor`). */\n  fakesReport(testId?: string, opts?: { context?: string }): Promise<McpFakesReport>;\n}\n\n/** TI1: `<file> › <name1> › … › <nameN>`; unnamed suites add no segment. */\nfunction defaultVitestId(task: Readonly<RunnerTestCase>): string {\n  const names: string[] = [];\n  for (\n    let suite: RunnerTestSuite | undefined = task.suite;\n    suite !== undefined && suite !== task.file;\n    suite = suite.suite\n  ) {\n    if (suite.name !== \"\") names.unshift(suite.name);\n  }\n  return [task.file.name, ...names, task.name].join(TEST_ID_SEPARATOR);\n}\n\n/**\n * Start an aimock server for the duration of the test suite.\n *\n * - `beforeAll`: starts the server and optionally loads fixtures (LLM fixtures and\n *   `mcpFakes` blocks; a bad `mcpFakes` block fails `beforeAll`)\n * - `beforeEach`: closes Live sessions and resets fixture match counts and MCP fake\n *   consumption (not fixtures or fakes); under `fakesReport: \"warn\" | \"fail\"` it\n *   throws in a concurrent test, which the per-test report does not support\n * - `afterEach`: closes Live sessions owned by this helper's server, then checks\n *   the MCP fake report under `fakesReport: \"warn\" | \"fail\"`\n * - `afterAll`: stops the server\n *\n * Returns a getter function — call it inside tests to access the handle.\n */\nexport function useAimock(options: UseAimockOptions = {}): () => AimockFakesHandle {\n  let handle: AimockFakesHandle | null = null;\n  let origOpenaiUrl: string | undefined;\n  let origAnthropicUrl: string | undefined;\n  let state = new FakesPluginState(\"off\");\n  /** TI5: default id -> the `task.id` that first used it; fresh per `beforeAll`. */\n  let idMap = new Map<string, string>();\n  let current: Readonly<RunnerTestCase> | null = null;\n\n  function resolveTestId(testId: string | undefined): string {\n    if (testId !== undefined) return testId; // TI4: an explicit id wins\n    if (current === null) {\n      throw new AimockTestIdCollisionError(\n        \"fakesFor() needs a running test; pass an explicit testId\",\n      );\n    }\n    if (current.concurrent === true) {\n      throw new AimockTestIdCollisionError(\n        \"default test ids are not supported in concurrent tests; pass an explicit testId\",\n      );\n    }\n    const id = defaultVitestId(current);\n    const owner = idMap.get(id);\n    if (owner !== undefined && owner !== current.id) {\n      throw new AimockTestIdCollisionError(\n        `two tests share the default test id ${JSON.stringify(id)}; pass an explicit testId`,\n      );\n    }\n    idMap.set(id, current.id);\n    return id;\n  }\n\n  /**\n   * The report keeps one state per `useAimock`, so concurrent tests would\n   * clear and read each other's identities: under `\"warn\"` or `\"fail\"`, a\n   * concurrent test is refused in `beforeEach` (and not reported on).\n   */\n  function refusesConcurrent(task: Readonly<RunnerTestCase>): boolean {\n    return state.mode !== \"off\" && task.concurrent === true;\n  }\n\n  beforeAll(async () => {\n    const { fixtures: fixturePath, patchEnv, fakesReport, ...serverOpts } = options;\n    state = new FakesPluginState(fakesReportMode(fakesReport));\n    idMap = new Map();\n    const llm = new LLMock(serverOpts);\n\n    if (fixturePath) {\n      loadFixtures(llm, resolve(fixturePath));\n    }\n\n    const url = await llm.start();\n\n    if (patchEnv !== false) {\n      origOpenaiUrl = process.env.OPENAI_BASE_URL;\n      origAnthropicUrl = process.env.ANTHROPIC_BASE_URL;\n      process.env.OPENAI_BASE_URL = `${url}/v1`;\n      process.env.ANTHROPIC_BASE_URL = `${url}/v1`;\n    }\n\n    handle = {\n      llm,\n      url,\n      fakesFor(testId?: string, opts: FakesForOptions = {}): FakesTarget {\n        const id = resolveTestId(testId);\n        state.register(id, opts.context ?? null);\n        return fakesTarget(url, id, opts);\n      },\n      fakesReport(testId?: string, opts: { context?: string } = {}): Promise<McpFakesReport> {\n        return fetchFakesReport(url, resolveTestId(testId), opts.context ?? null);\n      },\n    };\n  });\n\n  beforeEach((ctx) => {\n    current = ctx.task;\n    if (refusesConcurrent(ctx.task)) {\n      throw new Error(\n        'useAimock(): fakesReport is not supported in concurrent tests; set fakesReport: \"off\" for this suite or run it sequentially',\n      );\n    }\n    if (handle) {\n      handle.llm.closeLiveSessions();\n      handle.llm.resetMatchCounts();\n      state.beforeEach(handle.llm);\n    }\n  });\n\n  afterEach(async (ctx) => {\n    try {\n      handle?.llm.closeLiveSessions();\n      if (handle && !refusesConcurrent(ctx.task)) await state.afterEach(handle.llm, handle.url);\n    } finally {\n      current = null;\n    }\n  });\n\n  afterAll(async () => {\n    if (handle) {\n      if (options.patchEnv !== false) {\n        if (origOpenaiUrl !== undefined) process.env.OPENAI_BASE_URL = origOpenaiUrl;\n        else delete process.env.OPENAI_BASE_URL;\n        if (origAnthropicUrl !== undefined) process.env.ANTHROPIC_BASE_URL = origAnthropicUrl;\n        else delete process.env.ANTHROPIC_BASE_URL;\n      }\n      await handle.llm.stop();\n      handle = null;\n    }\n  });\n\n  return () => {\n    if (!handle) {\n      throw new Error(\"useAimock(): server not started — are you calling this inside a test?\");\n    }\n    return handle;\n  };\n}\n\n/**\n * Load a fixture file or directory into `llm`: its LLM fixtures and its\n * `mcpFakes` blocks, which the LLMock buffers and auto-mounts at start (F12).\n * A `FixtureLoadError` (a bad `mcpFakes` block) or a `MisbehaviorConfigError`\n * (a bad fixture `misbehavior` key, thrown only with `enableMisbehavior: true`)\n * propagates and fails `beforeAll`; any other load failure is only warned\n * about, as before.\n */\nfunction loadFixtures(llm: LLMock, fixturePath: string): void {\n  try {\n    const stat = statSync(fixturePath);\n    if (stat.isDirectory()) {\n      llm.loadFixtureDir(fixturePath);\n    } else {\n      llm.loadFixtureFile(fixturePath);\n    }\n  } catch (err) {\n    if (err instanceof FixtureLoadError || err instanceof MisbehaviorConfigError) throw err;\n    console.warn(\n      `[aimock] Failed to load fixtures from ${fixturePath}: ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n}\n\nexport { LLMock } from \"./llmock.js\";\nexport type { MockServerOptions, Fixture } from \"./types.js\";\nexport type { FakesForOptions, FakesReportMode, FakesTarget } from \"./fakes-plugin.js\";\nexport type { McpFakesReport } from \"./mcp-fakes-report.js\";\n"],"mappings":"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"}

package/dist/vitest.d.cts

@@ -1,5 +1,7 @@
 import { Fixture, MockServerOptions } from "./types.cjs";
 import { LLMock } from "./llmock.cjs";
+import { McpFakesReport } from "./mcp-fakes-report.cjs";
+import { FakesForOptions, FakesReportMode, FakesTarget } from "./fakes-plugin.cjs";
 
 //#region src/vitest.d.ts
 
@@ -8,6 +10,13 @@ interface UseAimockOptions extends MockServerOptions {
   fixtures?: string;
   /** If true, sets process.env.OPENAI_BASE_URL to the mock URL + /v1. */
   patchEnv?: boolean;
+  /**
+   * The per-test MCP fake report, read in `afterEach` (RP7): `"off"` (the
+   * default), `"warn"` (print a failing report) or `"fail"` (throw
+   * `AimockFakesReportError`). Not supported in concurrent tests: under
+   * `"warn"` or `"fail"`, a concurrent test fails in `beforeEach`.
+   */
+  fakesReport?: FakesReportMode;
 }
 interface AimockHandle {
   /** The LLMock instance. */
@@ -15,17 +24,41 @@ interface AimockHandle {
   /** The server URL (e.g., http://127.0.0.1:4010). */
   readonly url: string;
 }
+/**
+ * The handle `useAimock` returns: an `AimockHandle` plus the MCP fakes
+ * helpers (RP7). A separate type, so that `AimockHandle` stays as it was and
+ * code that builds its own `AimockHandle` keeps compiling.
+ */
+interface AimockFakesHandle extends AimockHandle {
+  /**
+   * The MCP URL and headers for the fakes scoped to `testId` (RP7), and
+   * registers that identity for this test's report. With no `testId`, the
+   * default is `<file> › <describe…> › <test>` (TI1); it is used only here and
+   * in `fakesReport`, never on LLM traffic (TI4). Throws
+   * `AimockTestIdCollisionError` when two tests share a default id, in a
+   * concurrent test, or outside a test.
+   */
+  fakesFor(testId?: string, opts?: FakesForOptions): FakesTarget;
+  /** The MCP fake report for `testId` (default as in `fakesFor`). */
+  fakesReport(testId?: string, opts?: {
+    context?: string;
+  }): Promise<McpFakesReport>;
+}
 /**
  * Start an aimock server for the duration of the test suite.
  *
- * - `beforeAll`: starts the server and optionally loads fixtures
- * - `beforeEach`: closes Live sessions and resets fixture match counts (not fixtures)
- * - `afterEach`: closes Live sessions owned by this helper's server
+ * - `beforeAll`: starts the server and optionally loads fixtures (LLM fixtures and
+ *   `mcpFakes` blocks; a bad `mcpFakes` block fails `beforeAll`)
+ * - `beforeEach`: closes Live sessions and resets fixture match counts and MCP fake
+ *   consumption (not fixtures or fakes); under `fakesReport: "warn" | "fail"` it
+ *   throws in a concurrent test, which the per-test report does not support
+ * - `afterEach`: closes Live sessions owned by this helper's server, then checks
+ *   the MCP fake report under `fakesReport: "warn" | "fail"`
  * - `afterAll`: stops the server
  *
  * Returns a getter function — call it inside tests to access the handle.
  */
-declare function useAimock(options?: UseAimockOptions): () => AimockHandle;
+declare function useAimock(options?: UseAimockOptions): () => AimockFakesHandle;
 //#endregion
-export { AimockHandle, type Fixture, LLMock, type MockServerOptions, UseAimockOptions, useAimock };
+export { AimockFakesHandle, AimockHandle, type FakesForOptions, type FakesReportMode, type FakesTarget, type Fixture, LLMock, type McpFakesReport, type MockServerOptions, UseAimockOptions, useAimock };
 //# sourceMappingURL=vitest.d.cts.map

package/dist/vitest.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"vitest.d.cts","names":[],"sources":["../src/vitest.ts"],"sourcesContent":[],"mappings":";;;;;UAqBiB,gBAAA,SAAyB;;;;;;UAOzB,YAAA;;gBAED;;;;;;;;;;;;;;iBAeA,SAAA,WAAmB,yBAA8B"}
+{"version":3,"file":"vitest.d.cts","names":[],"sources":["../src/vitest.ts"],"sourcesContent":[],"mappings":";;;;;;;AAqEqE,UArCpD,gBAAA,SAAyB,iBAqC2B,CAAA;;UAX1B,CAAA,EAAA,MAAA;EAAY;EAyCvC,QAAA,CAAA,EAAA,OAAS;EAAA;;;;;;gBAxDT;;UAGC,YAAA;;gBAED;;;;;;;;;UAUC,iBAAA,SAA0B;;;;;;;;;mCASR,kBAAkB;;;;MAEQ,QAAQ;;;;;;;;;;;;;;;;iBA8BrD,SAAA,WAAmB,yBAA8B"}

package/dist/vitest.d.ts

@@ -1,5 +1,7 @@
 import { Fixture, MockServerOptions } from "./types.js";
 import { LLMock } from "./llmock.js";
+import { McpFakesReport } from "./mcp-fakes-report.js";
+import { FakesForOptions, FakesReportMode, FakesTarget } from "./fakes-plugin.js";
 
 //#region src/vitest.d.ts
 
@@ -8,6 +10,13 @@ interface UseAimockOptions extends MockServerOptions {
   fixtures?: string;
   /** If true, sets process.env.OPENAI_BASE_URL to the mock URL + /v1. */
   patchEnv?: boolean;
+  /**
+   * The per-test MCP fake report, read in `afterEach` (RP7): `"off"` (the
+   * default), `"warn"` (print a failing report) or `"fail"` (throw
+   * `AimockFakesReportError`). Not supported in concurrent tests: under
+   * `"warn"` or `"fail"`, a concurrent test fails in `beforeEach`.
+   */
+  fakesReport?: FakesReportMode;
 }
 interface AimockHandle {
   /** The LLMock instance. */
@@ -15,17 +24,41 @@ interface AimockHandle {
   /** The server URL (e.g., http://127.0.0.1:4010). */
   readonly url: string;
 }
+/**
+ * The handle `useAimock` returns: an `AimockHandle` plus the MCP fakes
+ * helpers (RP7). A separate type, so that `AimockHandle` stays as it was and
+ * code that builds its own `AimockHandle` keeps compiling.
+ */
+interface AimockFakesHandle extends AimockHandle {
+  /**
+   * The MCP URL and headers for the fakes scoped to `testId` (RP7), and
+   * registers that identity for this test's report. With no `testId`, the
+   * default is `<file> › <describe…> › <test>` (TI1); it is used only here and
+   * in `fakesReport`, never on LLM traffic (TI4). Throws
+   * `AimockTestIdCollisionError` when two tests share a default id, in a
+   * concurrent test, or outside a test.
+   */
+  fakesFor(testId?: string, opts?: FakesForOptions): FakesTarget;
+  /** The MCP fake report for `testId` (default as in `fakesFor`). */
+  fakesReport(testId?: string, opts?: {
+    context?: string;
+  }): Promise<McpFakesReport>;
+}
 /**
  * Start an aimock server for the duration of the test suite.
  *
- * - `beforeAll`: starts the server and optionally loads fixtures
- * - `beforeEach`: closes Live sessions and resets fixture match counts (not fixtures)
- * - `afterEach`: closes Live sessions owned by this helper's server
+ * - `beforeAll`: starts the server and optionally loads fixtures (LLM fixtures and
+ *   `mcpFakes` blocks; a bad `mcpFakes` block fails `beforeAll`)
+ * - `beforeEach`: closes Live sessions and resets fixture match counts and MCP fake
+ *   consumption (not fixtures or fakes); under `fakesReport: "warn" | "fail"` it
+ *   throws in a concurrent test, which the per-test report does not support
+ * - `afterEach`: closes Live sessions owned by this helper's server, then checks
+ *   the MCP fake report under `fakesReport: "warn" | "fail"`
  * - `afterAll`: stops the server
  *
  * Returns a getter function — call it inside tests to access the handle.
  */
-declare function useAimock(options?: UseAimockOptions): () => AimockHandle;
+declare function useAimock(options?: UseAimockOptions): () => AimockFakesHandle;
 //#endregion
-export { AimockHandle, type Fixture, LLMock, type MockServerOptions, UseAimockOptions, useAimock };
+export { AimockFakesHandle, AimockHandle, type FakesForOptions, type FakesReportMode, type FakesTarget, type Fixture, LLMock, type McpFakesReport, type MockServerOptions, UseAimockOptions, useAimock };
 //# sourceMappingURL=vitest.d.ts.map

package/dist/vitest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vitest.d.ts","names":[],"sources":["../src/vitest.ts"],"sourcesContent":[],"mappings":";;;;;UAqBiB,gBAAA,SAAyB;;;;;;UAOzB,YAAA;;gBAED;;;;;;;;;;;;;;iBAeA,SAAA,WAAmB,yBAA8B"}
+{"version":3,"file":"vitest.d.ts","names":[],"sources":["../src/vitest.ts"],"sourcesContent":[],"mappings":";;;;;;;AAqEqE,UArCpD,gBAAA,SAAyB,iBAqC2B,CAAA;;UAX1B,CAAA,EAAA,MAAA;EAAY;EAyCvC,QAAA,CAAA,EAAA,OAAS;EAAA;;;;;;gBAxDT;;UAGC,YAAA;;gBAED;;;;;;;;;UAUC,iBAAA,SAA0B;;;;;;;;;mCASR,kBAAkB;;;;MAEQ,QAAQ;;;;;;;;;;;;;;;;iBA8BrD,SAAA,WAAmB,yBAA8B"}

package/dist/vitest.js

@@ -1,5 +1,7 @@
-import { loadFixtureFile, loadFixturesFromDir } from "./fixture-loader.js";
+import { FixtureLoadError, MisbehaviorConfigError } from "./fixture-loader.js";
+import { AimockTestIdCollisionError } from "./mcp-fakes-report.js";
 import { LLMock } from "./llmock.js";
+import { FakesPluginState, TEST_ID_SEPARATOR, fakesReportMode, fakesTarget, fetchFakesReport } from "./fakes-plugin.js";
 import { statSync } from "node:fs";
 import { resolve } from "node:path";
 import { afterAll, afterEach, beforeAll, beforeEach } from "vitest";
@@ -17,12 +19,26 @@ import { afterAll, afterEach, beforeAll, beforeEach } from "vitest";
 *     const res = await fetch(`${mock().url}/v1/chat/completions`, { ... });
 *   });
 */
+/** TI1: `<file> › <name1> › … › <nameN>`; unnamed suites add no segment. */
+function defaultVitestId(task) {
+	const names = [];
+	for (let suite = task.suite; suite !== void 0 && suite !== task.file; suite = suite.suite) if (suite.name !== "") names.unshift(suite.name);
+	return [
+		task.file.name,
+		...names,
+		task.name
+	].join(TEST_ID_SEPARATOR);
+}
 /**
 * Start an aimock server for the duration of the test suite.
 *
-* - `beforeAll`: starts the server and optionally loads fixtures
-* - `beforeEach`: closes Live sessions and resets fixture match counts (not fixtures)
-* - `afterEach`: closes Live sessions owned by this helper's server
+* - `beforeAll`: starts the server and optionally loads fixtures (LLM fixtures and
+*   `mcpFakes` blocks; a bad `mcpFakes` block fails `beforeAll`)
+* - `beforeEach`: closes Live sessions and resets fixture match counts and MCP fake
+*   consumption (not fixtures or fakes); under `fakesReport: "warn" | "fail"` it
+*   throws in a concurrent test, which the per-test report does not support
+* - `afterEach`: closes Live sessions owned by this helper's server, then checks
+*   the MCP fake report under `fakesReport: "warn" | "fail"`
 * - `afterAll`: stops the server
 *
 * Returns a getter function — call it inside tests to access the handle.
@@ -31,13 +47,34 @@ function useAimock(options = {}) {
 	let handle = null;
 	let origOpenaiUrl;
 	let origAnthropicUrl;
+	let state = new FakesPluginState("off");
+	/** TI5: default id -> the `task.id` that first used it; fresh per `beforeAll`. */
+	let idMap = /* @__PURE__ */ new Map();
+	let current = null;
+	function resolveTestId(testId) {
+		if (testId !== void 0) return testId;
+		if (current === null) throw new AimockTestIdCollisionError("fakesFor() needs a running test; pass an explicit testId");
+		if (current.concurrent === true) throw new AimockTestIdCollisionError("default test ids are not supported in concurrent tests; pass an explicit testId");
+		const id = defaultVitestId(current);
+		const owner = idMap.get(id);
+		if (owner !== void 0 && owner !== current.id) throw new AimockTestIdCollisionError(`two tests share the default test id ${JSON.stringify(id)}; pass an explicit testId`);
+		idMap.set(id, current.id);
+		return id;
+	}
+	/**
+	* The report keeps one state per `useAimock`, so concurrent tests would
+	* clear and read each other's identities: under `"warn"` or `"fail"`, a
+	* concurrent test is refused in `beforeEach` (and not reported on).
+	*/
+	function refusesConcurrent(task) {
+		return state.mode !== "off" && task.concurrent === true;
+	}
 	beforeAll(async () => {
-		const { fixtures: fixturePath, patchEnv, ...serverOpts } = options;
+		const { fixtures: fixturePath, patchEnv, fakesReport, ...serverOpts } = options;
+		state = new FakesPluginState(fakesReportMode(fakesReport));
+		idMap = /* @__PURE__ */ new Map();
 		const llm = new LLMock(serverOpts);
-		if (fixturePath) {
-			const loadedFixtures = loadFixtures(resolve(fixturePath), options.live);
-			for (const f of loadedFixtures) llm.addFixture(f);
-		}
+		if (fixturePath) loadFixtures(llm, resolve(fixturePath));
 		const url = await llm.start();
 		if (patchEnv !== false) {
 			origOpenaiUrl = process.env.OPENAI_BASE_URL;
@@ -47,17 +84,33 @@ function useAimock(options = {}) {
 		}
 		handle = {
 			llm,
-			url
+			url,
+			fakesFor(testId, opts = {}) {
+				const id = resolveTestId(testId);
+				state.register(id, opts.context ?? null);
+				return fakesTarget(url, id, opts);
+			},
+			fakesReport(testId, opts = {}) {
+				return fetchFakesReport(url, resolveTestId(testId), opts.context ?? null);
+			}
 		};
 	});
-	beforeEach(() => {
+	beforeEach((ctx) => {
+		current = ctx.task;
+		if (refusesConcurrent(ctx.task)) throw new Error("useAimock(): fakesReport is not supported in concurrent tests; set fakesReport: \"off\" for this suite or run it sequentially");
 		if (handle) {
 			handle.llm.closeLiveSessions();
 			handle.llm.resetMatchCounts();
+			state.beforeEach(handle.llm);
 		}
 	});
-	afterEach(() => {
-		handle?.llm.closeLiveSessions();
+	afterEach(async (ctx) => {
+		try {
+			handle?.llm.closeLiveSessions();
+			if (handle && !refusesConcurrent(ctx.task)) await state.afterEach(handle.llm, handle.url);
+		} finally {
+			current = null;
+		}
 	});
 	afterAll(async () => {
 		if (handle) {
@@ -76,13 +129,21 @@ function useAimock(options = {}) {
 		return handle;
 	};
 }
-function loadFixtures(fixturePath, liveOptions) {
+/**
+* Load a fixture file or directory into `llm`: its LLM fixtures and its
+* `mcpFakes` blocks, which the LLMock buffers and auto-mounts at start (F12).
+* A `FixtureLoadError` (a bad `mcpFakes` block) or a `MisbehaviorConfigError`
+* (a bad fixture `misbehavior` key, thrown only with `enableMisbehavior: true`)
+* propagates and fails `beforeAll`; any other load failure is only warned
+* about, as before.
+*/
+function loadFixtures(llm, fixturePath) {
 	try {
-		if (statSync(fixturePath).isDirectory()) return loadFixturesFromDir(fixturePath, void 0, liveOptions);
-		return loadFixtureFile(fixturePath, void 0, liveOptions);
+		if (statSync(fixturePath).isDirectory()) llm.loadFixtureDir(fixturePath);
+		else llm.loadFixtureFile(fixturePath);
 	} catch (err) {
+		if (err instanceof FixtureLoadError || err instanceof MisbehaviorConfigError) throw err;
 		console.warn(`[aimock] Failed to load fixtures from ${fixturePath}: ${err instanceof Error ? err.message : String(err)}`);
-		return [];
 	}
 }
 

package/dist/vitest.js.map

@@ -1 +1 @@
-{"version":3,"file":"vitest.js","names":[],"sources":["../src/vitest.ts"],"sourcesContent":["/**\n * Vitest integration for aimock.\n *\n * Usage:\n *   import { useAimock } from \"@copilotkit/aimock/vitest\";\n *\n *   const mock = useAimock({ fixtures: \"./fixtures\" });\n *\n *   it(\"responds\", async () => {\n *     const res = await fetch(`${mock().url}/v1/chat/completions`, { ... });\n *   });\n */\n\nimport { beforeAll, afterAll, beforeEach, afterEach } from \"vitest\";\nimport { LLMock } from \"./llmock.js\";\nimport { loadFixtureFile, loadFixturesFromDir } from \"./fixture-loader.js\";\nimport type { LiveOptions } from \"./live-types.js\";\nimport type { Fixture, MockServerOptions } from \"./types.js\";\nimport { statSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nexport interface UseAimockOptions extends MockServerOptions {\n  /** Path to fixture file or directory. Loaded automatically on start. */\n  fixtures?: string;\n  /** If true, sets process.env.OPENAI_BASE_URL to the mock URL + /v1. */\n  patchEnv?: boolean;\n}\n\nexport interface AimockHandle {\n  /** The LLMock instance. */\n  readonly llm: LLMock;\n  /** The server URL (e.g., http://127.0.0.1:4010). */\n  readonly url: string;\n}\n\n/**\n * Start an aimock server for the duration of the test suite.\n *\n * - `beforeAll`: starts the server and optionally loads fixtures\n * - `beforeEach`: closes Live sessions and resets fixture match counts (not fixtures)\n * - `afterEach`: closes Live sessions owned by this helper's server\n * - `afterAll`: stops the server\n *\n * Returns a getter function — call it inside tests to access the handle.\n */\nexport function useAimock(options: UseAimockOptions = {}): () => AimockHandle {\n  let handle: AimockHandle | null = null;\n  let origOpenaiUrl: string | undefined;\n  let origAnthropicUrl: string | undefined;\n\n  beforeAll(async () => {\n    const { fixtures: fixturePath, patchEnv, ...serverOpts } = options;\n    const llm = new LLMock(serverOpts);\n\n    if (fixturePath) {\n      const resolved = resolve(fixturePath);\n      const loadedFixtures = loadFixtures(resolved, options.live);\n      for (const f of loadedFixtures) {\n        llm.addFixture(f);\n      }\n    }\n\n    const url = await llm.start();\n\n    if (patchEnv !== false) {\n      origOpenaiUrl = process.env.OPENAI_BASE_URL;\n      origAnthropicUrl = process.env.ANTHROPIC_BASE_URL;\n      process.env.OPENAI_BASE_URL = `${url}/v1`;\n      process.env.ANTHROPIC_BASE_URL = `${url}/v1`;\n    }\n\n    handle = { llm, url };\n  });\n\n  beforeEach(() => {\n    if (handle) {\n      handle.llm.closeLiveSessions();\n      handle.llm.resetMatchCounts();\n    }\n  });\n\n  afterEach(() => {\n    handle?.llm.closeLiveSessions();\n  });\n\n  afterAll(async () => {\n    if (handle) {\n      if (options.patchEnv !== false) {\n        if (origOpenaiUrl !== undefined) process.env.OPENAI_BASE_URL = origOpenaiUrl;\n        else delete process.env.OPENAI_BASE_URL;\n        if (origAnthropicUrl !== undefined) process.env.ANTHROPIC_BASE_URL = origAnthropicUrl;\n        else delete process.env.ANTHROPIC_BASE_URL;\n      }\n      await handle.llm.stop();\n      handle = null;\n    }\n  });\n\n  return () => {\n    if (!handle) {\n      throw new Error(\"useAimock(): server not started — are you calling this inside a test?\");\n    }\n    return handle;\n  };\n}\n\nfunction loadFixtures(fixturePath: string, liveOptions?: LiveOptions): Fixture[] {\n  try {\n    const stat = statSync(fixturePath);\n    if (stat.isDirectory()) {\n      return loadFixturesFromDir(fixturePath, undefined, liveOptions);\n    }\n    return loadFixtureFile(fixturePath, undefined, liveOptions);\n  } catch (err) {\n    console.warn(\n      `[aimock] Failed to load fixtures from ${fixturePath}: ${err instanceof Error ? err.message : String(err)}`,\n    );\n    return [];\n  }\n}\n\nexport { LLMock } from \"./llmock.js\";\nexport type { MockServerOptions, Fixture } from \"./types.js\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,SAAgB,UAAU,UAA4B,EAAE,EAAsB;CAC5E,IAAI,SAA8B;CAClC,IAAI;CACJ,IAAI;AAEJ,WAAU,YAAY;EACpB,MAAM,EAAE,UAAU,aAAa,UAAU,GAAG,eAAe;EAC3D,MAAM,MAAM,IAAI,OAAO,WAAW;AAElC,MAAI,aAAa;GAEf,MAAM,iBAAiB,aADN,QAAQ,YAAY,EACS,QAAQ,KAAK;AAC3D,QAAK,MAAM,KAAK,eACd,KAAI,WAAW,EAAE;;EAIrB,MAAM,MAAM,MAAM,IAAI,OAAO;AAE7B,MAAI,aAAa,OAAO;AACtB,mBAAgB,QAAQ,IAAI;AAC5B,sBAAmB,QAAQ,IAAI;AAC/B,WAAQ,IAAI,kBAAkB,GAAG,IAAI;AACrC,WAAQ,IAAI,qBAAqB,GAAG,IAAI;;AAG1C,WAAS;GAAE;GAAK;GAAK;GACrB;AAEF,kBAAiB;AACf,MAAI,QAAQ;AACV,UAAO,IAAI,mBAAmB;AAC9B,UAAO,IAAI,kBAAkB;;GAE/B;AAEF,iBAAgB;AACd,UAAQ,IAAI,mBAAmB;GAC/B;AAEF,UAAS,YAAY;AACnB,MAAI,QAAQ;AACV,OAAI,QAAQ,aAAa,OAAO;AAC9B,QAAI,kBAAkB,OAAW,SAAQ,IAAI,kBAAkB;QAC1D,QAAO,QAAQ,IAAI;AACxB,QAAI,qBAAqB,OAAW,SAAQ,IAAI,qBAAqB;QAChE,QAAO,QAAQ,IAAI;;AAE1B,SAAM,OAAO,IAAI,MAAM;AACvB,YAAS;;GAEX;AAEF,cAAa;AACX,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,wEAAwE;AAE1F,SAAO;;;AAIX,SAAS,aAAa,aAAqB,aAAsC;AAC/E,KAAI;AAEF,MADa,SAAS,YAAY,CACzB,aAAa,CACpB,QAAO,oBAAoB,aAAa,QAAW,YAAY;AAEjE,SAAO,gBAAgB,aAAa,QAAW,YAAY;UACpD,KAAK;AACZ,UAAQ,KACN,yCAAyC,YAAY,IAAI,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAC1G;AACD,SAAO,EAAE"}
+{"version":3,"file":"vitest.js","names":[],"sources":["../src/vitest.ts"],"sourcesContent":["/**\n * Vitest integration for aimock.\n *\n * Usage:\n *   import { useAimock } from \"@copilotkit/aimock/vitest\";\n *\n *   const mock = useAimock({ fixtures: \"./fixtures\" });\n *\n *   it(\"responds\", async () => {\n *     const res = await fetch(`${mock().url}/v1/chat/completions`, { ... });\n *   });\n */\n\nimport { beforeAll, afterAll, beforeEach, afterEach } from \"vitest\";\nimport type { RunnerTestCase, RunnerTestSuite } from \"vitest\";\nimport { LLMock } from \"./llmock.js\";\nimport { FixtureLoadError, MisbehaviorConfigError } from \"./fixture-loader.js\";\nimport type { MockServerOptions } from \"./types.js\";\nimport {\n  FakesPluginState,\n  TEST_ID_SEPARATOR,\n  fakesReportMode,\n  fakesTarget,\n  fetchFakesReport,\n  type FakesForOptions,\n  type FakesReportMode,\n  type FakesTarget,\n} from \"./fakes-plugin.js\";\nimport { AimockTestIdCollisionError, type McpFakesReport } from \"./mcp-fakes-report.js\";\nimport { statSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nexport interface UseAimockOptions extends MockServerOptions {\n  /** Path to fixture file or directory. Loaded automatically on start. */\n  fixtures?: string;\n  /** If true, sets process.env.OPENAI_BASE_URL to the mock URL + /v1. */\n  patchEnv?: boolean;\n  /**\n   * The per-test MCP fake report, read in `afterEach` (RP7): `\"off\"` (the\n   * default), `\"warn\"` (print a failing report) or `\"fail\"` (throw\n   * `AimockFakesReportError`). Not supported in concurrent tests: under\n   * `\"warn\"` or `\"fail\"`, a concurrent test fails in `beforeEach`.\n   */\n  fakesReport?: FakesReportMode;\n}\n\nexport interface AimockHandle {\n  /** The LLMock instance. */\n  readonly llm: LLMock;\n  /** The server URL (e.g., http://127.0.0.1:4010). */\n  readonly url: string;\n}\n\n/**\n * The handle `useAimock` returns: an `AimockHandle` plus the MCP fakes\n * helpers (RP7). A separate type, so that `AimockHandle` stays as it was and\n * code that builds its own `AimockHandle` keeps compiling.\n */\nexport interface AimockFakesHandle extends AimockHandle {\n  /**\n   * The MCP URL and headers for the fakes scoped to `testId` (RP7), and\n   * registers that identity for this test's report. With no `testId`, the\n   * default is `<file> › <describe…> › <test>` (TI1); it is used only here and\n   * in `fakesReport`, never on LLM traffic (TI4). Throws\n   * `AimockTestIdCollisionError` when two tests share a default id, in a\n   * concurrent test, or outside a test.\n   */\n  fakesFor(testId?: string, opts?: FakesForOptions): FakesTarget;\n  /** The MCP fake report for `testId` (default as in `fakesFor`). */\n  fakesReport(testId?: string, opts?: { context?: string }): Promise<McpFakesReport>;\n}\n\n/** TI1: `<file> › <name1> › … › <nameN>`; unnamed suites add no segment. */\nfunction defaultVitestId(task: Readonly<RunnerTestCase>): string {\n  const names: string[] = [];\n  for (\n    let suite: RunnerTestSuite | undefined = task.suite;\n    suite !== undefined && suite !== task.file;\n    suite = suite.suite\n  ) {\n    if (suite.name !== \"\") names.unshift(suite.name);\n  }\n  return [task.file.name, ...names, task.name].join(TEST_ID_SEPARATOR);\n}\n\n/**\n * Start an aimock server for the duration of the test suite.\n *\n * - `beforeAll`: starts the server and optionally loads fixtures (LLM fixtures and\n *   `mcpFakes` blocks; a bad `mcpFakes` block fails `beforeAll`)\n * - `beforeEach`: closes Live sessions and resets fixture match counts and MCP fake\n *   consumption (not fixtures or fakes); under `fakesReport: \"warn\" | \"fail\"` it\n *   throws in a concurrent test, which the per-test report does not support\n * - `afterEach`: closes Live sessions owned by this helper's server, then checks\n *   the MCP fake report under `fakesReport: \"warn\" | \"fail\"`\n * - `afterAll`: stops the server\n *\n * Returns a getter function — call it inside tests to access the handle.\n */\nexport function useAimock(options: UseAimockOptions = {}): () => AimockFakesHandle {\n  let handle: AimockFakesHandle | null = null;\n  let origOpenaiUrl: string | undefined;\n  let origAnthropicUrl: string | undefined;\n  let state = new FakesPluginState(\"off\");\n  /** TI5: default id -> the `task.id` that first used it; fresh per `beforeAll`. */\n  let idMap = new Map<string, string>();\n  let current: Readonly<RunnerTestCase> | null = null;\n\n  function resolveTestId(testId: string | undefined): string {\n    if (testId !== undefined) return testId; // TI4: an explicit id wins\n    if (current === null) {\n      throw new AimockTestIdCollisionError(\n        \"fakesFor() needs a running test; pass an explicit testId\",\n      );\n    }\n    if (current.concurrent === true) {\n      throw new AimockTestIdCollisionError(\n        \"default test ids are not supported in concurrent tests; pass an explicit testId\",\n      );\n    }\n    const id = defaultVitestId(current);\n    const owner = idMap.get(id);\n    if (owner !== undefined && owner !== current.id) {\n      throw new AimockTestIdCollisionError(\n        `two tests share the default test id ${JSON.stringify(id)}; pass an explicit testId`,\n      );\n    }\n    idMap.set(id, current.id);\n    return id;\n  }\n\n  /**\n   * The report keeps one state per `useAimock`, so concurrent tests would\n   * clear and read each other's identities: under `\"warn\"` or `\"fail\"`, a\n   * concurrent test is refused in `beforeEach` (and not reported on).\n   */\n  function refusesConcurrent(task: Readonly<RunnerTestCase>): boolean {\n    return state.mode !== \"off\" && task.concurrent === true;\n  }\n\n  beforeAll(async () => {\n    const { fixtures: fixturePath, patchEnv, fakesReport, ...serverOpts } = options;\n    state = new FakesPluginState(fakesReportMode(fakesReport));\n    idMap = new Map();\n    const llm = new LLMock(serverOpts);\n\n    if (fixturePath) {\n      loadFixtures(llm, resolve(fixturePath));\n    }\n\n    const url = await llm.start();\n\n    if (patchEnv !== false) {\n      origOpenaiUrl = process.env.OPENAI_BASE_URL;\n      origAnthropicUrl = process.env.ANTHROPIC_BASE_URL;\n      process.env.OPENAI_BASE_URL = `${url}/v1`;\n      process.env.ANTHROPIC_BASE_URL = `${url}/v1`;\n    }\n\n    handle = {\n      llm,\n      url,\n      fakesFor(testId?: string, opts: FakesForOptions = {}): FakesTarget {\n        const id = resolveTestId(testId);\n        state.register(id, opts.context ?? null);\n        return fakesTarget(url, id, opts);\n      },\n      fakesReport(testId?: string, opts: { context?: string } = {}): Promise<McpFakesReport> {\n        return fetchFakesReport(url, resolveTestId(testId), opts.context ?? null);\n      },\n    };\n  });\n\n  beforeEach((ctx) => {\n    current = ctx.task;\n    if (refusesConcurrent(ctx.task)) {\n      throw new Error(\n        'useAimock(): fakesReport is not supported in concurrent tests; set fakesReport: \"off\" for this suite or run it sequentially',\n      );\n    }\n    if (handle) {\n      handle.llm.closeLiveSessions();\n      handle.llm.resetMatchCounts();\n      state.beforeEach(handle.llm);\n    }\n  });\n\n  afterEach(async (ctx) => {\n    try {\n      handle?.llm.closeLiveSessions();\n      if (handle && !refusesConcurrent(ctx.task)) await state.afterEach(handle.llm, handle.url);\n    } finally {\n      current = null;\n    }\n  });\n\n  afterAll(async () => {\n    if (handle) {\n      if (options.patchEnv !== false) {\n        if (origOpenaiUrl !== undefined) process.env.OPENAI_BASE_URL = origOpenaiUrl;\n        else delete process.env.OPENAI_BASE_URL;\n        if (origAnthropicUrl !== undefined) process.env.ANTHROPIC_BASE_URL = origAnthropicUrl;\n        else delete process.env.ANTHROPIC_BASE_URL;\n      }\n      await handle.llm.stop();\n      handle = null;\n    }\n  });\n\n  return () => {\n    if (!handle) {\n      throw new Error(\"useAimock(): server not started — are you calling this inside a test?\");\n    }\n    return handle;\n  };\n}\n\n/**\n * Load a fixture file or directory into `llm`: its LLM fixtures and its\n * `mcpFakes` blocks, which the LLMock buffers and auto-mounts at start (F12).\n * A `FixtureLoadError` (a bad `mcpFakes` block) or a `MisbehaviorConfigError`\n * (a bad fixture `misbehavior` key, thrown only with `enableMisbehavior: true`)\n * propagates and fails `beforeAll`; any other load failure is only warned\n * about, as before.\n */\nfunction loadFixtures(llm: LLMock, fixturePath: string): void {\n  try {\n    const stat = statSync(fixturePath);\n    if (stat.isDirectory()) {\n      llm.loadFixtureDir(fixturePath);\n    } else {\n      llm.loadFixtureFile(fixturePath);\n    }\n  } catch (err) {\n    if (err instanceof FixtureLoadError || err instanceof MisbehaviorConfigError) throw err;\n    console.warn(\n      `[aimock] Failed to load fixtures from ${fixturePath}: ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n}\n\nexport { LLMock } from \"./llmock.js\";\nexport type { MockServerOptions, Fixture } from \"./types.js\";\nexport type { FakesForOptions, FakesReportMode, FakesTarget } from \"./fakes-plugin.js\";\nexport type { McpFakesReport } from \"./mcp-fakes-report.js\";\n"],"mappings":"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"}

package/dist/watcher.cjs

@@ -1,11 +1,12 @@
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 const require_fixture_loader = require('./fixture-loader.cjs');
 let node_fs = require("node:fs");
+let node_path = require("node:path");
 
 //#region src/watcher.ts
 const DEBOUNCE_MS = 500;
 function watchFixtures(fixturePath, fixtures, loadFn, opts) {
-	const { logger, validate, validateFn } = opts;
+	const { logger, validate, validateFn, ignore } = opts;
 	let debounceTimer = null;
 	function reload() {
 		logger.info(`File changed — reloading fixtures from ${fixturePath}...`);
@@ -36,7 +37,10 @@ function watchFixtures(fixturePath, fixtures, loadFn, opts) {
 		fixtures.push(...newFixtures);
 		logger.info(`Reloaded ${newFixtures.length} fixture(s)`);
 	}
-	const watcher = (0, node_fs.watch)(fixturePath, { recursive: true }, () => {
+	const watcher = (0, node_fs.watch)(fixturePath, { recursive: true }, (_event, filename) => {
+		if (ignore && filename) try {
+			if (ignore((0, node_path.join)(fixturePath, filename))) return;
+		} catch {}
 		if (debounceTimer) clearTimeout(debounceTimer);
 		debounceTimer = setTimeout(reload, DEBOUNCE_MS);
 	});

package/dist/watcher.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"watcher.cjs","names":[],"sources":["../src/watcher.ts"],"sourcesContent":["import { watch, type FSWatcher } from \"node:fs\";\nimport type { Fixture } from \"./types.js\";\nimport type { Logger } from \"./logger.js\";\nimport { clearFixtureQueue, type ValidationResult } from \"./fixture-loader.js\";\n\nconst DEBOUNCE_MS = 500;\n\nexport function watchFixtures(\n  fixturePath: string,\n  fixtures: Fixture[],\n  loadFn: () => Fixture[],\n  opts: {\n    logger: Logger;\n    validate?: boolean;\n    validateFn?: (fixtures: Fixture[]) => ValidationResult[];\n  },\n): { close: () => void } {\n  const { logger, validate, validateFn } = opts;\n  let debounceTimer: ReturnType<typeof setTimeout> | null = null;\n\n  function reload() {\n    logger.info(`File changed — reloading fixtures from ${fixturePath}...`);\n\n    let newFixtures: Fixture[];\n    try {\n      newFixtures = loadFn();\n    } catch (err) {\n      logger.error(\"Failed to reload fixtures:\", err);\n      logger.error(\"Previous fixtures remain active. Fix the error and save again to retry.\");\n      return;\n    }\n\n    if (newFixtures.length === 0 && fixtures.length > 0) {\n      logger.warn(\n        \"Reload produced 0 fixtures — keeping previous fixtures. Check fixture file for errors.\",\n      );\n      return;\n    }\n\n    if (validate && validateFn) {\n      const results = validateFn(newFixtures);\n      const errors = results.filter((r) => r.severity === \"error\");\n      const warnings = results.filter((r) => r.severity === \"warning\");\n\n      for (const w of warnings) {\n        logger.warn(`Fixture ${w.fixtureIndex}: ${w.message}`);\n      }\n\n      if (errors.length > 0) {\n        for (const e of errors) {\n          logger.error(`Fixture ${e.fixtureIndex}: ${e.message}`);\n        }\n        logger.error(`${errors.length} validation error(s) — keeping previous fixtures`);\n        return;\n      }\n    }\n\n    // Replace in-place to preserve array reference identity. Same door as\n    // reset: a one-shot claim parked across the reload must not re-arm into it.\n    clearFixtureQueue(fixtures);\n    fixtures.push(...newFixtures);\n    logger.info(`Reloaded ${newFixtures.length} fixture(s)`);\n  }\n\n  const watcher: FSWatcher = watch(fixturePath, { recursive: true }, () => {\n    if (debounceTimer) clearTimeout(debounceTimer);\n    debounceTimer = setTimeout(reload, DEBOUNCE_MS);\n  });\n\n  watcher.on(\"error\", (err: Error) => {\n    if (debounceTimer) clearTimeout(debounceTimer);\n    debounceTimer = null;\n    try {\n      watcher.close();\n    } catch {\n      /* already dead */\n    }\n    logger.error(`File watcher error on ${fixturePath}: ${err.message}`);\n    logger.error(\"Fixture auto-reload is no longer active. Restart the server to resume watching.\");\n  });\n\n  return {\n    close() {\n      if (debounceTimer) clearTimeout(debounceTimer);\n      watcher.close();\n    },\n  };\n}\n"],"mappings":";;;;;AAKA,MAAM,cAAc;AAEpB,SAAgB,cACd,aACA,UACA,QACA,MAKuB;CACvB,MAAM,EAAE,QAAQ,UAAU,eAAe;CACzC,IAAI,gBAAsD;CAE1D,SAAS,SAAS;AAChB,SAAO,KAAK,0CAA0C,YAAY,KAAK;EAEvE,IAAI;AACJ,MAAI;AACF,iBAAc,QAAQ;WACf,KAAK;AACZ,UAAO,MAAM,8BAA8B,IAAI;AAC/C,UAAO,MAAM,0EAA0E;AACvF;;AAGF,MAAI,YAAY,WAAW,KAAK,SAAS,SAAS,GAAG;AACnD,UAAO,KACL,yFACD;AACD;;AAGF,MAAI,YAAY,YAAY;GAC1B,MAAM,UAAU,WAAW,YAAY;GACvC,MAAM,SAAS,QAAQ,QAAQ,MAAM,EAAE,aAAa,QAAQ;GAC5D,MAAM,WAAW,QAAQ,QAAQ,MAAM,EAAE,aAAa,UAAU;AAEhE,QAAK,MAAM,KAAK,SACd,QAAO,KAAK,WAAW,EAAE,aAAa,IAAI,EAAE,UAAU;AAGxD,OAAI,OAAO,SAAS,GAAG;AACrB,SAAK,MAAM,KAAK,OACd,QAAO,MAAM,WAAW,EAAE,aAAa,IAAI,EAAE,UAAU;AAEzD,WAAO,MAAM,GAAG,OAAO,OAAO,kDAAkD;AAChF;;;AAMJ,2CAAkB,SAAS;AAC3B,WAAS,KAAK,GAAG,YAAY;AAC7B,SAAO,KAAK,YAAY,YAAY,OAAO,aAAa;;CAG1D,MAAM,6BAA2B,aAAa,EAAE,WAAW,MAAM,QAAQ;AACvE,MAAI,cAAe,cAAa,cAAc;AAC9C,kBAAgB,WAAW,QAAQ,YAAY;GAC/C;AAEF,SAAQ,GAAG,UAAU,QAAe;AAClC,MAAI,cAAe,cAAa,cAAc;AAC9C,kBAAgB;AAChB,MAAI;AACF,WAAQ,OAAO;UACT;AAGR,SAAO,MAAM,yBAAyB,YAAY,IAAI,IAAI,UAAU;AACpE,SAAO,MAAM,kFAAkF;GAC/F;AAEF,QAAO,EACL,QAAQ;AACN,MAAI,cAAe,cAAa,cAAc;AAC9C,UAAQ,OAAO;IAElB"}
+{"version":3,"file":"watcher.cjs","names":[],"sources":["../src/watcher.ts"],"sourcesContent":["import { watch, type FSWatcher } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { Fixture } from \"./types.js\";\nimport type { Logger } from \"./logger.js\";\nimport { clearFixtureQueue, type ValidationResult } from \"./fixture-loader.js\";\n\nconst DEBOUNCE_MS = 500;\n\nexport function watchFixtures(\n  fixturePath: string,\n  fixtures: Fixture[],\n  loadFn: () => Fixture[],\n  opts: {\n    logger: Logger;\n    validate?: boolean;\n    validateFn?: (fixtures: Fixture[]) => ValidationResult[];\n    /** MR13: an event for a path this returns true for does not reload. */\n    ignore?: (absPath: string) => boolean;\n  },\n): { close: () => void } {\n  const { logger, validate, validateFn, ignore } = opts;\n  let debounceTimer: ReturnType<typeof setTimeout> | null = null;\n\n  function reload() {\n    logger.info(`File changed — reloading fixtures from ${fixturePath}...`);\n\n    let newFixtures: Fixture[];\n    try {\n      newFixtures = loadFn();\n    } catch (err) {\n      logger.error(\"Failed to reload fixtures:\", err);\n      logger.error(\"Previous fixtures remain active. Fix the error and save again to retry.\");\n      return;\n    }\n\n    if (newFixtures.length === 0 && fixtures.length > 0) {\n      logger.warn(\n        \"Reload produced 0 fixtures — keeping previous fixtures. Check fixture file for errors.\",\n      );\n      return;\n    }\n\n    if (validate && validateFn) {\n      const results = validateFn(newFixtures);\n      const errors = results.filter((r) => r.severity === \"error\");\n      const warnings = results.filter((r) => r.severity === \"warning\");\n\n      for (const w of warnings) {\n        logger.warn(`Fixture ${w.fixtureIndex}: ${w.message}`);\n      }\n\n      if (errors.length > 0) {\n        for (const e of errors) {\n          logger.error(`Fixture ${e.fixtureIndex}: ${e.message}`);\n        }\n        logger.error(`${errors.length} validation error(s) — keeping previous fixtures`);\n        return;\n      }\n    }\n\n    // Replace in-place to preserve array reference identity. Same door as\n    // reset: a one-shot claim parked across the reload must not re-arm into it.\n    clearFixtureQueue(fixtures);\n    fixtures.push(...newFixtures);\n    logger.info(`Reloaded ${newFixtures.length} fixture(s)`);\n  }\n\n  const watcher: FSWatcher = watch(fixturePath, { recursive: true }, (_event, filename) => {\n    if (ignore && filename) {\n      try {\n        if (ignore(join(fixturePath, filename))) return;\n      } catch {\n        /* a failing ignore never kills the watcher: reload */\n      }\n    }\n    if (debounceTimer) clearTimeout(debounceTimer);\n    debounceTimer = setTimeout(reload, DEBOUNCE_MS);\n  });\n\n  watcher.on(\"error\", (err: Error) => {\n    if (debounceTimer) clearTimeout(debounceTimer);\n    debounceTimer = null;\n    try {\n      watcher.close();\n    } catch {\n      /* already dead */\n    }\n    logger.error(`File watcher error on ${fixturePath}: ${err.message}`);\n    logger.error(\"Fixture auto-reload is no longer active. Restart the server to resume watching.\");\n  });\n\n  return {\n    close() {\n      if (debounceTimer) clearTimeout(debounceTimer);\n      watcher.close();\n    },\n  };\n}\n"],"mappings":";;;;;;AAMA,MAAM,cAAc;AAEpB,SAAgB,cACd,aACA,UACA,QACA,MAOuB;CACvB,MAAM,EAAE,QAAQ,UAAU,YAAY,WAAW;CACjD,IAAI,gBAAsD;CAE1D,SAAS,SAAS;AAChB,SAAO,KAAK,0CAA0C,YAAY,KAAK;EAEvE,IAAI;AACJ,MAAI;AACF,iBAAc,QAAQ;WACf,KAAK;AACZ,UAAO,MAAM,8BAA8B,IAAI;AAC/C,UAAO,MAAM,0EAA0E;AACvF;;AAGF,MAAI,YAAY,WAAW,KAAK,SAAS,SAAS,GAAG;AACnD,UAAO,KACL,yFACD;AACD;;AAGF,MAAI,YAAY,YAAY;GAC1B,MAAM,UAAU,WAAW,YAAY;GACvC,MAAM,SAAS,QAAQ,QAAQ,MAAM,EAAE,aAAa,QAAQ;GAC5D,MAAM,WAAW,QAAQ,QAAQ,MAAM,EAAE,aAAa,UAAU;AAEhE,QAAK,MAAM,KAAK,SACd,QAAO,KAAK,WAAW,EAAE,aAAa,IAAI,EAAE,UAAU;AAGxD,OAAI,OAAO,SAAS,GAAG;AACrB,SAAK,MAAM,KAAK,OACd,QAAO,MAAM,WAAW,EAAE,aAAa,IAAI,EAAE,UAAU;AAEzD,WAAO,MAAM,GAAG,OAAO,OAAO,kDAAkD;AAChF;;;AAMJ,2CAAkB,SAAS;AAC3B,WAAS,KAAK,GAAG,YAAY;AAC7B,SAAO,KAAK,YAAY,YAAY,OAAO,aAAa;;CAG1D,MAAM,6BAA2B,aAAa,EAAE,WAAW,MAAM,GAAG,QAAQ,aAAa;AACvF,MAAI,UAAU,SACZ,KAAI;AACF,OAAI,2BAAY,aAAa,SAAS,CAAC,CAAE;UACnC;AAIV,MAAI,cAAe,cAAa,cAAc;AAC9C,kBAAgB,WAAW,QAAQ,YAAY;GAC/C;AAEF,SAAQ,GAAG,UAAU,QAAe;AAClC,MAAI,cAAe,cAAa,cAAc;AAC9C,kBAAgB;AAChB,MAAI;AACF,WAAQ,OAAO;UACT;AAGR,SAAO,MAAM,yBAAyB,YAAY,IAAI,IAAI,UAAU;AACpE,SAAO,MAAM,kFAAkF;GAC/F;AAEF,QAAO,EACL,QAAQ;AACN,MAAI,cAAe,cAAa,cAAc;AAC9C,UAAQ,OAAO;IAElB"}

package/dist/watcher.js

@@ -1,10 +1,11 @@
 import { clearFixtureQueue } from "./fixture-loader.js";
 import { watch } from "node:fs";
+import { join } from "node:path";
 
 //#region src/watcher.ts
 const DEBOUNCE_MS = 500;
 function watchFixtures(fixturePath, fixtures, loadFn, opts) {
-	const { logger, validate, validateFn } = opts;
+	const { logger, validate, validateFn, ignore } = opts;
 	let debounceTimer = null;
 	function reload() {
 		logger.info(`File changed — reloading fixtures from ${fixturePath}...`);
@@ -35,7 +36,10 @@ function watchFixtures(fixturePath, fixtures, loadFn, opts) {
 		fixtures.push(...newFixtures);
 		logger.info(`Reloaded ${newFixtures.length} fixture(s)`);
 	}
-	const watcher = watch(fixturePath, { recursive: true }, () => {
+	const watcher = watch(fixturePath, { recursive: true }, (_event, filename) => {
+		if (ignore && filename) try {
+			if (ignore(join(fixturePath, filename))) return;
+		} catch {}
 		if (debounceTimer) clearTimeout(debounceTimer);
 		debounceTimer = setTimeout(reload, DEBOUNCE_MS);
 	});

package/dist/watcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"watcher.js","names":[],"sources":["../src/watcher.ts"],"sourcesContent":["import { watch, type FSWatcher } from \"node:fs\";\nimport type { Fixture } from \"./types.js\";\nimport type { Logger } from \"./logger.js\";\nimport { clearFixtureQueue, type ValidationResult } from \"./fixture-loader.js\";\n\nconst DEBOUNCE_MS = 500;\n\nexport function watchFixtures(\n  fixturePath: string,\n  fixtures: Fixture[],\n  loadFn: () => Fixture[],\n  opts: {\n    logger: Logger;\n    validate?: boolean;\n    validateFn?: (fixtures: Fixture[]) => ValidationResult[];\n  },\n): { close: () => void } {\n  const { logger, validate, validateFn } = opts;\n  let debounceTimer: ReturnType<typeof setTimeout> | null = null;\n\n  function reload() {\n    logger.info(`File changed — reloading fixtures from ${fixturePath}...`);\n\n    let newFixtures: Fixture[];\n    try {\n      newFixtures = loadFn();\n    } catch (err) {\n      logger.error(\"Failed to reload fixtures:\", err);\n      logger.error(\"Previous fixtures remain active. Fix the error and save again to retry.\");\n      return;\n    }\n\n    if (newFixtures.length === 0 && fixtures.length > 0) {\n      logger.warn(\n        \"Reload produced 0 fixtures — keeping previous fixtures. Check fixture file for errors.\",\n      );\n      return;\n    }\n\n    if (validate && validateFn) {\n      const results = validateFn(newFixtures);\n      const errors = results.filter((r) => r.severity === \"error\");\n      const warnings = results.filter((r) => r.severity === \"warning\");\n\n      for (const w of warnings) {\n        logger.warn(`Fixture ${w.fixtureIndex}: ${w.message}`);\n      }\n\n      if (errors.length > 0) {\n        for (const e of errors) {\n          logger.error(`Fixture ${e.fixtureIndex}: ${e.message}`);\n        }\n        logger.error(`${errors.length} validation error(s) — keeping previous fixtures`);\n        return;\n      }\n    }\n\n    // Replace in-place to preserve array reference identity. Same door as\n    // reset: a one-shot claim parked across the reload must not re-arm into it.\n    clearFixtureQueue(fixtures);\n    fixtures.push(...newFixtures);\n    logger.info(`Reloaded ${newFixtures.length} fixture(s)`);\n  }\n\n  const watcher: FSWatcher = watch(fixturePath, { recursive: true }, () => {\n    if (debounceTimer) clearTimeout(debounceTimer);\n    debounceTimer = setTimeout(reload, DEBOUNCE_MS);\n  });\n\n  watcher.on(\"error\", (err: Error) => {\n    if (debounceTimer) clearTimeout(debounceTimer);\n    debounceTimer = null;\n    try {\n      watcher.close();\n    } catch {\n      /* already dead */\n    }\n    logger.error(`File watcher error on ${fixturePath}: ${err.message}`);\n    logger.error(\"Fixture auto-reload is no longer active. Restart the server to resume watching.\");\n  });\n\n  return {\n    close() {\n      if (debounceTimer) clearTimeout(debounceTimer);\n      watcher.close();\n    },\n  };\n}\n"],"mappings":";;;;AAKA,MAAM,cAAc;AAEpB,SAAgB,cACd,aACA,UACA,QACA,MAKuB;CACvB,MAAM,EAAE,QAAQ,UAAU,eAAe;CACzC,IAAI,gBAAsD;CAE1D,SAAS,SAAS;AAChB,SAAO,KAAK,0CAA0C,YAAY,KAAK;EAEvE,IAAI;AACJ,MAAI;AACF,iBAAc,QAAQ;WACf,KAAK;AACZ,UAAO,MAAM,8BAA8B,IAAI;AAC/C,UAAO,MAAM,0EAA0E;AACvF;;AAGF,MAAI,YAAY,WAAW,KAAK,SAAS,SAAS,GAAG;AACnD,UAAO,KACL,yFACD;AACD;;AAGF,MAAI,YAAY,YAAY;GAC1B,MAAM,UAAU,WAAW,YAAY;GACvC,MAAM,SAAS,QAAQ,QAAQ,MAAM,EAAE,aAAa,QAAQ;GAC5D,MAAM,WAAW,QAAQ,QAAQ,MAAM,EAAE,aAAa,UAAU;AAEhE,QAAK,MAAM,KAAK,SACd,QAAO,KAAK,WAAW,EAAE,aAAa,IAAI,EAAE,UAAU;AAGxD,OAAI,OAAO,SAAS,GAAG;AACrB,SAAK,MAAM,KAAK,OACd,QAAO,MAAM,WAAW,EAAE,aAAa,IAAI,EAAE,UAAU;AAEzD,WAAO,MAAM,GAAG,OAAO,OAAO,kDAAkD;AAChF;;;AAMJ,oBAAkB,SAAS;AAC3B,WAAS,KAAK,GAAG,YAAY;AAC7B,SAAO,KAAK,YAAY,YAAY,OAAO,aAAa;;CAG1D,MAAM,UAAqB,MAAM,aAAa,EAAE,WAAW,MAAM,QAAQ;AACvE,MAAI,cAAe,cAAa,cAAc;AAC9C,kBAAgB,WAAW,QAAQ,YAAY;GAC/C;AAEF,SAAQ,GAAG,UAAU,QAAe;AAClC,MAAI,cAAe,cAAa,cAAc;AAC9C,kBAAgB;AAChB,MAAI;AACF,WAAQ,OAAO;UACT;AAGR,SAAO,MAAM,yBAAyB,YAAY,IAAI,IAAI,UAAU;AACpE,SAAO,MAAM,kFAAkF;GAC/F;AAEF,QAAO,EACL,QAAQ;AACN,MAAI,cAAe,cAAa,cAAc;AAC9C,UAAQ,OAAO;IAElB"}
+{"version":3,"file":"watcher.js","names":[],"sources":["../src/watcher.ts"],"sourcesContent":["import { watch, type FSWatcher } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { Fixture } from \"./types.js\";\nimport type { Logger } from \"./logger.js\";\nimport { clearFixtureQueue, type ValidationResult } from \"./fixture-loader.js\";\n\nconst DEBOUNCE_MS = 500;\n\nexport function watchFixtures(\n  fixturePath: string,\n  fixtures: Fixture[],\n  loadFn: () => Fixture[],\n  opts: {\n    logger: Logger;\n    validate?: boolean;\n    validateFn?: (fixtures: Fixture[]) => ValidationResult[];\n    /** MR13: an event for a path this returns true for does not reload. */\n    ignore?: (absPath: string) => boolean;\n  },\n): { close: () => void } {\n  const { logger, validate, validateFn, ignore } = opts;\n  let debounceTimer: ReturnType<typeof setTimeout> | null = null;\n\n  function reload() {\n    logger.info(`File changed — reloading fixtures from ${fixturePath}...`);\n\n    let newFixtures: Fixture[];\n    try {\n      newFixtures = loadFn();\n    } catch (err) {\n      logger.error(\"Failed to reload fixtures:\", err);\n      logger.error(\"Previous fixtures remain active. Fix the error and save again to retry.\");\n      return;\n    }\n\n    if (newFixtures.length === 0 && fixtures.length > 0) {\n      logger.warn(\n        \"Reload produced 0 fixtures — keeping previous fixtures. Check fixture file for errors.\",\n      );\n      return;\n    }\n\n    if (validate && validateFn) {\n      const results = validateFn(newFixtures);\n      const errors = results.filter((r) => r.severity === \"error\");\n      const warnings = results.filter((r) => r.severity === \"warning\");\n\n      for (const w of warnings) {\n        logger.warn(`Fixture ${w.fixtureIndex}: ${w.message}`);\n      }\n\n      if (errors.length > 0) {\n        for (const e of errors) {\n          logger.error(`Fixture ${e.fixtureIndex}: ${e.message}`);\n        }\n        logger.error(`${errors.length} validation error(s) — keeping previous fixtures`);\n        return;\n      }\n    }\n\n    // Replace in-place to preserve array reference identity. Same door as\n    // reset: a one-shot claim parked across the reload must not re-arm into it.\n    clearFixtureQueue(fixtures);\n    fixtures.push(...newFixtures);\n    logger.info(`Reloaded ${newFixtures.length} fixture(s)`);\n  }\n\n  const watcher: FSWatcher = watch(fixturePath, { recursive: true }, (_event, filename) => {\n    if (ignore && filename) {\n      try {\n        if (ignore(join(fixturePath, filename))) return;\n      } catch {\n        /* a failing ignore never kills the watcher: reload */\n      }\n    }\n    if (debounceTimer) clearTimeout(debounceTimer);\n    debounceTimer = setTimeout(reload, DEBOUNCE_MS);\n  });\n\n  watcher.on(\"error\", (err: Error) => {\n    if (debounceTimer) clearTimeout(debounceTimer);\n    debounceTimer = null;\n    try {\n      watcher.close();\n    } catch {\n      /* already dead */\n    }\n    logger.error(`File watcher error on ${fixturePath}: ${err.message}`);\n    logger.error(\"Fixture auto-reload is no longer active. Restart the server to resume watching.\");\n  });\n\n  return {\n    close() {\n      if (debounceTimer) clearTimeout(debounceTimer);\n      watcher.close();\n    },\n  };\n}\n"],"mappings":";;;;;AAMA,MAAM,cAAc;AAEpB,SAAgB,cACd,aACA,UACA,QACA,MAOuB;CACvB,MAAM,EAAE,QAAQ,UAAU,YAAY,WAAW;CACjD,IAAI,gBAAsD;CAE1D,SAAS,SAAS;AAChB,SAAO,KAAK,0CAA0C,YAAY,KAAK;EAEvE,IAAI;AACJ,MAAI;AACF,iBAAc,QAAQ;WACf,KAAK;AACZ,UAAO,MAAM,8BAA8B,IAAI;AAC/C,UAAO,MAAM,0EAA0E;AACvF;;AAGF,MAAI,YAAY,WAAW,KAAK,SAAS,SAAS,GAAG;AACnD,UAAO,KACL,yFACD;AACD;;AAGF,MAAI,YAAY,YAAY;GAC1B,MAAM,UAAU,WAAW,YAAY;GACvC,MAAM,SAAS,QAAQ,QAAQ,MAAM,EAAE,aAAa,QAAQ;GAC5D,MAAM,WAAW,QAAQ,QAAQ,MAAM,EAAE,aAAa,UAAU;AAEhE,QAAK,MAAM,KAAK,SACd,QAAO,KAAK,WAAW,EAAE,aAAa,IAAI,EAAE,UAAU;AAGxD,OAAI,OAAO,SAAS,GAAG;AACrB,SAAK,MAAM,KAAK,OACd,QAAO,MAAM,WAAW,EAAE,aAAa,IAAI,EAAE,UAAU;AAEzD,WAAO,MAAM,GAAG,OAAO,OAAO,kDAAkD;AAChF;;;AAMJ,oBAAkB,SAAS;AAC3B,WAAS,KAAK,GAAG,YAAY;AAC7B,SAAO,KAAK,YAAY,YAAY,OAAO,aAAa;;CAG1D,MAAM,UAAqB,MAAM,aAAa,EAAE,WAAW,MAAM,GAAG,QAAQ,aAAa;AACvF,MAAI,UAAU,SACZ,KAAI;AACF,OAAI,OAAO,KAAK,aAAa,SAAS,CAAC,CAAE;UACnC;AAIV,MAAI,cAAe,cAAa,cAAc;AAC9C,kBAAgB,WAAW,QAAQ,YAAY;GAC/C;AAEF,SAAQ,GAAG,UAAU,QAAe;AAClC,MAAI,cAAe,cAAa,cAAc;AAC9C,kBAAgB;AAChB,MAAI;AACF,WAAQ,OAAO;UACT;AAGR,SAAO,MAAM,yBAAyB,YAAY,IAAI,IAAI,UAAU;AACpE,SAAO,MAAM,kFAAkF;GAC/F;AAEF,QAAO,EACL,QAAQ;AACN,MAAI,cAAe,cAAa,cAAc;AAC9C,UAAQ,OAAO;IAElB"}