@copilotkit/aimock 1.7.0

package/dist/chaos.cjs

@@ -0,0 +1,114 @@
+const require_sse_writer = require('./sse-writer.cjs');
+
+//#region src/chaos.ts
+/**
+* Resolve chaos config from headers, fixture, and server defaults.
+* Header values override fixture values, which override server defaults.
+*/
+function resolveChaosConfig(fixture, serverDefaults, rawHeaders, logger) {
+	const base = { ...serverDefaults };
+	if (fixture?.chaos) {
+		if (fixture.chaos.dropRate !== void 0) base.dropRate = fixture.chaos.dropRate;
+		if (fixture.chaos.malformedRate !== void 0) base.malformedRate = fixture.chaos.malformedRate;
+		if (fixture.chaos.disconnectRate !== void 0) base.disconnectRate = fixture.chaos.disconnectRate;
+	}
+	if (rawHeaders) {
+		const dropHeader = rawHeaders["x-aimock-chaos-drop"];
+		const malformedHeader = rawHeaders["x-aimock-chaos-malformed"];
+		const disconnectHeader = rawHeaders["x-aimock-chaos-disconnect"];
+		if (typeof dropHeader === "string") {
+			const val = parseFloat(dropHeader);
+			if (isNaN(val)) logger?.warn(`[chaos] x-aimock-chaos-drop: invalid value "${dropHeader}", ignoring`);
+			else {
+				if (val < 0 || val > 1) logger?.warn(`[chaos] x-aimock-chaos-drop: value ${val} out of range [0,1], clamping`);
+				base.dropRate = Math.min(1, Math.max(0, val));
+			}
+		}
+		if (typeof malformedHeader === "string") {
+			const val = parseFloat(malformedHeader);
+			if (isNaN(val)) logger?.warn(`[chaos] x-aimock-chaos-malformed: invalid value "${malformedHeader}", ignoring`);
+			else {
+				if (val < 0 || val > 1) logger?.warn(`[chaos] x-aimock-chaos-malformed: value ${val} out of range [0,1], clamping`);
+				base.malformedRate = Math.min(1, Math.max(0, val));
+			}
+		}
+		if (typeof disconnectHeader === "string") {
+			const val = parseFloat(disconnectHeader);
+			if (isNaN(val)) logger?.warn(`[chaos] x-aimock-chaos-disconnect: invalid value "${disconnectHeader}", ignoring`);
+			else {
+				if (val < 0 || val > 1) logger?.warn(`[chaos] x-aimock-chaos-disconnect: value ${val} out of range [0,1], clamping`);
+				base.disconnectRate = Math.min(1, Math.max(0, val));
+			}
+		}
+	}
+	if (base.dropRate !== void 0) base.dropRate = Math.min(1, Math.max(0, base.dropRate));
+	if (base.malformedRate !== void 0) base.malformedRate = Math.min(1, Math.max(0, base.malformedRate));
+	if (base.disconnectRate !== void 0) base.disconnectRate = Math.min(1, Math.max(0, base.disconnectRate));
+	return base;
+}
+/**
+* Evaluate chaos config and return the triggered action, or null if none.
+* Checks in order: drop, malformed, disconnect — first hit wins.
+*/
+function evaluateChaos(fixture, serverDefaults, rawHeaders, logger) {
+	const config = resolveChaosConfig(fixture, serverDefaults, rawHeaders, logger);
+	if (config.dropRate !== void 0 && config.dropRate > 0 && Math.random() < config.dropRate) return "drop";
+	if (config.malformedRate !== void 0 && config.malformedRate > 0 && Math.random() < config.malformedRate) return "malformed";
+	if (config.disconnectRate !== void 0 && config.disconnectRate > 0 && Math.random() < config.disconnectRate) return "disconnect";
+	return null;
+}
+/**
+* Apply chaos to a request. Returns true if chaos was applied (caller should
+* return early), false if the request should proceed normally.
+*/
+function applyChaos(res, fixture, serverDefaults, rawHeaders, journal, context, registry, logger) {
+	const action = evaluateChaos(fixture, serverDefaults, rawHeaders, logger);
+	if (!action) return false;
+	if (registry) registry.incrementCounter("aimock_chaos_triggered_total", { action });
+	switch (action) {
+		case "drop":
+			journal.add({
+				...context,
+				response: {
+					status: 500,
+					fixture,
+					chaosAction: "drop"
+				}
+			});
+			require_sse_writer.writeErrorResponse(res, 500, JSON.stringify({ error: {
+				message: "Chaos: request dropped",
+				type: "server_error",
+				code: "chaos_drop"
+			} }));
+			return true;
+		case "malformed":
+			journal.add({
+				...context,
+				response: {
+					status: 200,
+					fixture,
+					chaosAction: "malformed"
+				}
+			});
+			res.writeHead(200, { "Content-Type": "application/json" });
+			res.end("{malformed json: <<<chaos>>>");
+			return true;
+		case "disconnect":
+			journal.add({
+				...context,
+				response: {
+					status: 0,
+					fixture,
+					chaosAction: "disconnect"
+				}
+			});
+			res.destroy();
+			return true;
+		default: return false;
+	}
+}
+
+//#endregion
+exports.applyChaos = applyChaos;
+exports.evaluateChaos = evaluateChaos;
+//# sourceMappingURL=chaos.cjs.map

package/dist/chaos.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chaos.cjs","names":[],"sources":["../src/chaos.ts"],"sourcesContent":["/**\n * Chaos testing support for LLMock.\n *\n * Provides probabilistic failure injection — requests can be dropped (500),\n * returned with malformed JSON, or have the connection forcibly disconnected.\n *\n * Precedence: per-request headers > fixture-level config > server-level defaults.\n */\n\nimport type * as http from \"node:http\";\nimport type { ChaosAction, ChaosConfig, ChatCompletionRequest, Fixture } from \"./types.js\";\nimport { writeErrorResponse } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport type { Logger } from \"./logger.js\";\nimport type { MetricsRegistry } from \"./metrics.js\";\n\n/**\n * Resolve chaos config from headers, fixture, and server defaults.\n * Header values override fixture values, which override server defaults.\n */\nfunction resolveChaosConfig(\n  fixture: Fixture | null,\n  serverDefaults?: ChaosConfig,\n  rawHeaders?: http.IncomingHttpHeaders,\n  logger?: Logger,\n): ChaosConfig {\n  const base: ChaosConfig = { ...serverDefaults };\n\n  // Fixture-level overrides server defaults\n  if (fixture?.chaos) {\n    if (fixture.chaos.dropRate !== undefined) base.dropRate = fixture.chaos.dropRate;\n    if (fixture.chaos.malformedRate !== undefined) base.malformedRate = fixture.chaos.malformedRate;\n    if (fixture.chaos.disconnectRate !== undefined)\n      base.disconnectRate = fixture.chaos.disconnectRate;\n  }\n\n  // Header overrides everything\n  if (rawHeaders) {\n    const dropHeader = rawHeaders[\"x-aimock-chaos-drop\"];\n    const malformedHeader = rawHeaders[\"x-aimock-chaos-malformed\"];\n    const disconnectHeader = rawHeaders[\"x-aimock-chaos-disconnect\"];\n\n    if (typeof dropHeader === \"string\") {\n      const val = parseFloat(dropHeader);\n      if (isNaN(val)) {\n        logger?.warn(`[chaos] x-aimock-chaos-drop: invalid value \"${dropHeader}\", ignoring`);\n      } else {\n        if (val < 0 || val > 1) {\n          logger?.warn(`[chaos] x-aimock-chaos-drop: value ${val} out of range [0,1], clamping`);\n        }\n        base.dropRate = Math.min(1, Math.max(0, val));\n      }\n    }\n    if (typeof malformedHeader === \"string\") {\n      const val = parseFloat(malformedHeader);\n      if (isNaN(val)) {\n        logger?.warn(\n          `[chaos] x-aimock-chaos-malformed: invalid value \"${malformedHeader}\", ignoring`,\n        );\n      } else {\n        if (val < 0 || val > 1) {\n          logger?.warn(\n            `[chaos] x-aimock-chaos-malformed: value ${val} out of range [0,1], clamping`,\n          );\n        }\n        base.malformedRate = Math.min(1, Math.max(0, val));\n      }\n    }\n    if (typeof disconnectHeader === \"string\") {\n      const val = parseFloat(disconnectHeader);\n      if (isNaN(val)) {\n        logger?.warn(\n          `[chaos] x-aimock-chaos-disconnect: invalid value \"${disconnectHeader}\", ignoring`,\n        );\n      } else {\n        if (val < 0 || val > 1) {\n          logger?.warn(\n            `[chaos] x-aimock-chaos-disconnect: value ${val} out of range [0,1], clamping`,\n          );\n        }\n        base.disconnectRate = Math.min(1, Math.max(0, val));\n      }\n    }\n  }\n\n  // Clamp all resolved rates to [0, 1] regardless of source.\n  // Header values are already clamped above; this covers fixture-level and server defaults.\n  if (base.dropRate !== undefined) base.dropRate = Math.min(1, Math.max(0, base.dropRate));\n  if (base.malformedRate !== undefined)\n    base.malformedRate = Math.min(1, Math.max(0, base.malformedRate));\n  if (base.disconnectRate !== undefined)\n    base.disconnectRate = Math.min(1, Math.max(0, base.disconnectRate));\n\n  return base;\n}\n\n/**\n * Evaluate chaos config and return the triggered action, or null if none.\n * Checks in order: drop, malformed, disconnect — first hit wins.\n */\nexport function evaluateChaos(\n  fixture: Fixture | null,\n  serverDefaults?: ChaosConfig,\n  rawHeaders?: http.IncomingHttpHeaders,\n  logger?: Logger,\n): ChaosAction | null {\n  const config = resolveChaosConfig(fixture, serverDefaults, rawHeaders, logger);\n\n  if (config.dropRate !== undefined && config.dropRate > 0 && Math.random() < config.dropRate) {\n    return \"drop\";\n  }\n  if (\n    config.malformedRate !== undefined &&\n    config.malformedRate > 0 &&\n    Math.random() < config.malformedRate\n  ) {\n    return \"malformed\";\n  }\n  if (\n    config.disconnectRate !== undefined &&\n    config.disconnectRate > 0 &&\n    Math.random() < config.disconnectRate\n  ) {\n    return \"disconnect\";\n  }\n\n  return null;\n}\n\ninterface ChaosJournalContext {\n  method: string;\n  path: string;\n  headers: Record<string, string>;\n  body: ChatCompletionRequest;\n}\n\n/**\n * Apply chaos to a request. Returns true if chaos was applied (caller should\n * return early), false if the request should proceed normally.\n */\nexport function applyChaos(\n  res: http.ServerResponse,\n  fixture: Fixture | null,\n  serverDefaults: ChaosConfig | undefined,\n  rawHeaders: http.IncomingHttpHeaders,\n  journal: Journal,\n  context: ChaosJournalContext,\n  registry?: MetricsRegistry,\n  logger?: Logger,\n): boolean {\n  const action = evaluateChaos(fixture, serverDefaults, rawHeaders, logger);\n  if (!action) return false;\n\n  if (registry) {\n    registry.incrementCounter(\"aimock_chaos_triggered_total\", { action });\n  }\n\n  switch (action) {\n    case \"drop\": {\n      journal.add({\n        ...context,\n        response: { status: 500, fixture, chaosAction: \"drop\" },\n      });\n      writeErrorResponse(\n        res,\n        500,\n        JSON.stringify({\n          error: {\n            message: \"Chaos: request dropped\",\n            type: \"server_error\",\n            code: \"chaos_drop\",\n          },\n        }),\n      );\n      return true;\n    }\n    case \"malformed\": {\n      journal.add({\n        ...context,\n        response: { status: 200, fixture, chaosAction: \"malformed\" },\n      });\n      res.writeHead(200, { \"Content-Type\": \"application/json\" });\n      res.end(\"{malformed json: <<<chaos>>>\");\n      return true;\n    }\n    case \"disconnect\": {\n      journal.add({\n        ...context,\n        response: { status: 0, fixture, chaosAction: \"disconnect\" },\n      });\n      res.destroy();\n      return true;\n    }\n    default: {\n      const _exhaustive: never = action;\n      void _exhaustive;\n      return false;\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/chaos.d.cts

@@ -0,0 +1,27 @@
+import { Journal } from "./journal.cjs";
+import { Logger } from "./logger.cjs";
+import { MetricsRegistry } from "./metrics.cjs";
+import { ChaosAction, ChaosConfig, ChatCompletionRequest, Fixture } from "./types.cjs";
+import * as http from "node:http";
+
+//#region src/chaos.d.ts
+
+/**
+ * Evaluate chaos config and return the triggered action, or null if none.
+ * Checks in order: drop, malformed, disconnect — first hit wins.
+ */
+declare function evaluateChaos(fixture: Fixture | null, serverDefaults?: ChaosConfig, rawHeaders?: http.IncomingHttpHeaders, logger?: Logger): ChaosAction | null;
+interface ChaosJournalContext {
+  method: string;
+  path: string;
+  headers: Record<string, string>;
+  body: ChatCompletionRequest;
+}
+/**
+ * Apply chaos to a request. Returns true if chaos was applied (caller should
+ * return early), false if the request should proceed normally.
+ */
+declare function applyChaos(res: http.ServerResponse, fixture: Fixture | null, serverDefaults: ChaosConfig | undefined, rawHeaders: http.IncomingHttpHeaders, journal: Journal, context: ChaosJournalContext, registry?: MetricsRegistry, logger?: Logger): boolean;
+//#endregion
+export { applyChaos, evaluateChaos };
+//# sourceMappingURL=chaos.d.cts.map

package/dist/chaos.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chaos.d.cts","names":[],"sources":["../src/chaos.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AA+HC;;AAKU,iBAhCK,aAAA,CAgCL,OAAA,EA/BA,OA+BA,GAAA,IAAA,EAAA,cAAA,CAAA,EA9BQ,WA8BR,EAAA,UAAA,CAAA,EA7BI,IAAA,CAAK,mBA6BT,EAAA,MAAA,CAAA,EA5BA,MA4BA,CAAA,EA3BR,WA2BQ,GAAA,IAAA;UAHD,mBAAA,CAIF;EAAqB,MAAA,EAAA,MAAA;EAOb,IAAA,EAAA,MAAA;EAAU,OAAA,EARf,MAQe,CAAA,MAAA,EAAA,MAAA,CAAA;MACnB,EARC,qBAQI;;;;;;AAMC,iBAPG,UAAA,CAOH,GAAA,EANN,IAAA,CAAK,cAMC,EAAA,OAAA,EALF,OAKE,GAAA,IAAA,EAAA,cAAA,EAJK,WAIL,GAAA,SAAA,EAAA,UAAA,EAHC,IAAA,CAAK,mBAGN,EAAA,OAAA,EAFF,OAEE,EAAA,OAAA,EADF,mBACE,EAAA,QAAA,CAAA,EAAA,eAAA,EAAA,MAAA,CAAA,EACF,MADE,CAAA,EAAA,OAAA"}

package/dist/chaos.d.ts

@@ -0,0 +1,27 @@
+import { Journal } from "./journal.js";
+import { Logger } from "./logger.js";
+import { MetricsRegistry } from "./metrics.js";
+import { ChaosAction, ChaosConfig, ChatCompletionRequest, Fixture } from "./types.js";
+import * as http from "node:http";
+
+//#region src/chaos.d.ts
+
+/**
+ * Evaluate chaos config and return the triggered action, or null if none.
+ * Checks in order: drop, malformed, disconnect — first hit wins.
+ */
+declare function evaluateChaos(fixture: Fixture | null, serverDefaults?: ChaosConfig, rawHeaders?: http.IncomingHttpHeaders, logger?: Logger): ChaosAction | null;
+interface ChaosJournalContext {
+  method: string;
+  path: string;
+  headers: Record<string, string>;
+  body: ChatCompletionRequest;
+}
+/**
+ * Apply chaos to a request. Returns true if chaos was applied (caller should
+ * return early), false if the request should proceed normally.
+ */
+declare function applyChaos(res: http.ServerResponse, fixture: Fixture | null, serverDefaults: ChaosConfig | undefined, rawHeaders: http.IncomingHttpHeaders, journal: Journal, context: ChaosJournalContext, registry?: MetricsRegistry, logger?: Logger): boolean;
+//#endregion
+export { applyChaos, evaluateChaos };
+//# sourceMappingURL=chaos.d.ts.map

package/dist/chaos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chaos.d.ts","names":[],"sources":["../src/chaos.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AA+HC;;AAKU,iBAhCK,aAAA,CAgCL,OAAA,EA/BA,OA+BA,GAAA,IAAA,EAAA,cAAA,CAAA,EA9BQ,WA8BR,EAAA,UAAA,CAAA,EA7BI,IAAA,CAAK,mBA6BT,EAAA,MAAA,CAAA,EA5BA,MA4BA,CAAA,EA3BR,WA2BQ,GAAA,IAAA;UAHD,mBAAA,CAIF;EAAqB,MAAA,EAAA,MAAA;EAOb,IAAA,EAAA,MAAA;EAAU,OAAA,EARf,MAQe,CAAA,MAAA,EAAA,MAAA,CAAA;MACnB,EARC,qBAQI;;;;;;AAMC,iBAPG,UAAA,CAOH,GAAA,EANN,IAAA,CAAK,cAMC,EAAA,OAAA,EALF,OAKE,GAAA,IAAA,EAAA,cAAA,EAJK,WAIL,GAAA,SAAA,EAAA,UAAA,EAHC,IAAA,CAAK,mBAGN,EAAA,OAAA,EAFF,OAEE,EAAA,OAAA,EADF,mBACE,EAAA,QAAA,CAAA,EAAA,eAAA,EAAA,MAAA,CAAA,EACF,MADE,CAAA,EAAA,OAAA"}

package/dist/chaos.js

@@ -0,0 +1,113 @@
+import { writeErrorResponse } from "./sse-writer.js";
+
+//#region src/chaos.ts
+/**
+* Resolve chaos config from headers, fixture, and server defaults.
+* Header values override fixture values, which override server defaults.
+*/
+function resolveChaosConfig(fixture, serverDefaults, rawHeaders, logger) {
+	const base = { ...serverDefaults };
+	if (fixture?.chaos) {
+		if (fixture.chaos.dropRate !== void 0) base.dropRate = fixture.chaos.dropRate;
+		if (fixture.chaos.malformedRate !== void 0) base.malformedRate = fixture.chaos.malformedRate;
+		if (fixture.chaos.disconnectRate !== void 0) base.disconnectRate = fixture.chaos.disconnectRate;
+	}
+	if (rawHeaders) {
+		const dropHeader = rawHeaders["x-aimock-chaos-drop"];
+		const malformedHeader = rawHeaders["x-aimock-chaos-malformed"];
+		const disconnectHeader = rawHeaders["x-aimock-chaos-disconnect"];
+		if (typeof dropHeader === "string") {
+			const val = parseFloat(dropHeader);
+			if (isNaN(val)) logger?.warn(`[chaos] x-aimock-chaos-drop: invalid value "${dropHeader}", ignoring`);
+			else {
+				if (val < 0 || val > 1) logger?.warn(`[chaos] x-aimock-chaos-drop: value ${val} out of range [0,1], clamping`);
+				base.dropRate = Math.min(1, Math.max(0, val));
+			}
+		}
+		if (typeof malformedHeader === "string") {
+			const val = parseFloat(malformedHeader);
+			if (isNaN(val)) logger?.warn(`[chaos] x-aimock-chaos-malformed: invalid value "${malformedHeader}", ignoring`);
+			else {
+				if (val < 0 || val > 1) logger?.warn(`[chaos] x-aimock-chaos-malformed: value ${val} out of range [0,1], clamping`);
+				base.malformedRate = Math.min(1, Math.max(0, val));
+			}
+		}
+		if (typeof disconnectHeader === "string") {
+			const val = parseFloat(disconnectHeader);
+			if (isNaN(val)) logger?.warn(`[chaos] x-aimock-chaos-disconnect: invalid value "${disconnectHeader}", ignoring`);
+			else {
+				if (val < 0 || val > 1) logger?.warn(`[chaos] x-aimock-chaos-disconnect: value ${val} out of range [0,1], clamping`);
+				base.disconnectRate = Math.min(1, Math.max(0, val));
+			}
+		}
+	}
+	if (base.dropRate !== void 0) base.dropRate = Math.min(1, Math.max(0, base.dropRate));
+	if (base.malformedRate !== void 0) base.malformedRate = Math.min(1, Math.max(0, base.malformedRate));
+	if (base.disconnectRate !== void 0) base.disconnectRate = Math.min(1, Math.max(0, base.disconnectRate));
+	return base;
+}
+/**
+* Evaluate chaos config and return the triggered action, or null if none.
+* Checks in order: drop, malformed, disconnect — first hit wins.
+*/
+function evaluateChaos(fixture, serverDefaults, rawHeaders, logger) {
+	const config = resolveChaosConfig(fixture, serverDefaults, rawHeaders, logger);
+	if (config.dropRate !== void 0 && config.dropRate > 0 && Math.random() < config.dropRate) return "drop";
+	if (config.malformedRate !== void 0 && config.malformedRate > 0 && Math.random() < config.malformedRate) return "malformed";
+	if (config.disconnectRate !== void 0 && config.disconnectRate > 0 && Math.random() < config.disconnectRate) return "disconnect";
+	return null;
+}
+/**
+* Apply chaos to a request. Returns true if chaos was applied (caller should
+* return early), false if the request should proceed normally.
+*/
+function applyChaos(res, fixture, serverDefaults, rawHeaders, journal, context, registry, logger) {
+	const action = evaluateChaos(fixture, serverDefaults, rawHeaders, logger);
+	if (!action) return false;
+	if (registry) registry.incrementCounter("aimock_chaos_triggered_total", { action });
+	switch (action) {
+		case "drop":
+			journal.add({
+				...context,
+				response: {
+					status: 500,
+					fixture,
+					chaosAction: "drop"
+				}
+			});
+			writeErrorResponse(res, 500, JSON.stringify({ error: {
+				message: "Chaos: request dropped",
+				type: "server_error",
+				code: "chaos_drop"
+			} }));
+			return true;
+		case "malformed":
+			journal.add({
+				...context,
+				response: {
+					status: 200,
+					fixture,
+					chaosAction: "malformed"
+				}
+			});
+			res.writeHead(200, { "Content-Type": "application/json" });
+			res.end("{malformed json: <<<chaos>>>");
+			return true;
+		case "disconnect":
+			journal.add({
+				...context,
+				response: {
+					status: 0,
+					fixture,
+					chaosAction: "disconnect"
+				}
+			});
+			res.destroy();
+			return true;
+		default: return false;
+	}
+}
+
+//#endregion
+export { applyChaos, evaluateChaos };
+//# sourceMappingURL=chaos.js.map

package/dist/chaos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chaos.js","names":[],"sources":["../src/chaos.ts"],"sourcesContent":["/**\n * Chaos testing support for LLMock.\n *\n * Provides probabilistic failure injection — requests can be dropped (500),\n * returned with malformed JSON, or have the connection forcibly disconnected.\n *\n * Precedence: per-request headers > fixture-level config > server-level defaults.\n */\n\nimport type * as http from \"node:http\";\nimport type { ChaosAction, ChaosConfig, ChatCompletionRequest, Fixture } from \"./types.js\";\nimport { writeErrorResponse } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport type { Logger } from \"./logger.js\";\nimport type { MetricsRegistry } from \"./metrics.js\";\n\n/**\n * Resolve chaos config from headers, fixture, and server defaults.\n * Header values override fixture values, which override server defaults.\n */\nfunction resolveChaosConfig(\n  fixture: Fixture | null,\n  serverDefaults?: ChaosConfig,\n  rawHeaders?: http.IncomingHttpHeaders,\n  logger?: Logger,\n): ChaosConfig {\n  const base: ChaosConfig = { ...serverDefaults };\n\n  // Fixture-level overrides server defaults\n  if (fixture?.chaos) {\n    if (fixture.chaos.dropRate !== undefined) base.dropRate = fixture.chaos.dropRate;\n    if (fixture.chaos.malformedRate !== undefined) base.malformedRate = fixture.chaos.malformedRate;\n    if (fixture.chaos.disconnectRate !== undefined)\n      base.disconnectRate = fixture.chaos.disconnectRate;\n  }\n\n  // Header overrides everything\n  if (rawHeaders) {\n    const dropHeader = rawHeaders[\"x-aimock-chaos-drop\"];\n    const malformedHeader = rawHeaders[\"x-aimock-chaos-malformed\"];\n    const disconnectHeader = rawHeaders[\"x-aimock-chaos-disconnect\"];\n\n    if (typeof dropHeader === \"string\") {\n      const val = parseFloat(dropHeader);\n      if (isNaN(val)) {\n        logger?.warn(`[chaos] x-aimock-chaos-drop: invalid value \"${dropHeader}\", ignoring`);\n      } else {\n        if (val < 0 || val > 1) {\n          logger?.warn(`[chaos] x-aimock-chaos-drop: value ${val} out of range [0,1], clamping`);\n        }\n        base.dropRate = Math.min(1, Math.max(0, val));\n      }\n    }\n    if (typeof malformedHeader === \"string\") {\n      const val = parseFloat(malformedHeader);\n      if (isNaN(val)) {\n        logger?.warn(\n          `[chaos] x-aimock-chaos-malformed: invalid value \"${malformedHeader}\", ignoring`,\n        );\n      } else {\n        if (val < 0 || val > 1) {\n          logger?.warn(\n            `[chaos] x-aimock-chaos-malformed: value ${val} out of range [0,1], clamping`,\n          );\n        }\n        base.malformedRate = Math.min(1, Math.max(0, val));\n      }\n    }\n    if (typeof disconnectHeader === \"string\") {\n      const val = parseFloat(disconnectHeader);\n      if (isNaN(val)) {\n        logger?.warn(\n          `[chaos] x-aimock-chaos-disconnect: invalid value \"${disconnectHeader}\", ignoring`,\n        );\n      } else {\n        if (val < 0 || val > 1) {\n          logger?.warn(\n            `[chaos] x-aimock-chaos-disconnect: value ${val} out of range [0,1], clamping`,\n          );\n        }\n        base.disconnectRate = Math.min(1, Math.max(0, val));\n      }\n    }\n  }\n\n  // Clamp all resolved rates to [0, 1] regardless of source.\n  // Header values are already clamped above; this covers fixture-level and server defaults.\n  if (base.dropRate !== undefined) base.dropRate = Math.min(1, Math.max(0, base.dropRate));\n  if (base.malformedRate !== undefined)\n    base.malformedRate = Math.min(1, Math.max(0, base.malformedRate));\n  if (base.disconnectRate !== undefined)\n    base.disconnectRate = Math.min(1, Math.max(0, base.disconnectRate));\n\n  return base;\n}\n\n/**\n * Evaluate chaos config and return the triggered action, or null if none.\n * Checks in order: drop, malformed, disconnect — first hit wins.\n */\nexport function evaluateChaos(\n  fixture: Fixture | null,\n  serverDefaults?: ChaosConfig,\n  rawHeaders?: http.IncomingHttpHeaders,\n  logger?: Logger,\n): ChaosAction | null {\n  const config = resolveChaosConfig(fixture, serverDefaults, rawHeaders, logger);\n\n  if (config.dropRate !== undefined && config.dropRate > 0 && Math.random() < config.dropRate) {\n    return \"drop\";\n  }\n  if (\n    config.malformedRate !== undefined &&\n    config.malformedRate > 0 &&\n    Math.random() < config.malformedRate\n  ) {\n    return \"malformed\";\n  }\n  if (\n    config.disconnectRate !== undefined &&\n    config.disconnectRate > 0 &&\n    Math.random() < config.disconnectRate\n  ) {\n    return \"disconnect\";\n  }\n\n  return null;\n}\n\ninterface ChaosJournalContext {\n  method: string;\n  path: string;\n  headers: Record<string, string>;\n  body: ChatCompletionRequest;\n}\n\n/**\n * Apply chaos to a request. Returns true if chaos was applied (caller should\n * return early), false if the request should proceed normally.\n */\nexport function applyChaos(\n  res: http.ServerResponse,\n  fixture: Fixture | null,\n  serverDefaults: ChaosConfig | undefined,\n  rawHeaders: http.IncomingHttpHeaders,\n  journal: Journal,\n  context: ChaosJournalContext,\n  registry?: MetricsRegistry,\n  logger?: Logger,\n): boolean {\n  const action = evaluateChaos(fixture, serverDefaults, rawHeaders, logger);\n  if (!action) return false;\n\n  if (registry) {\n    registry.incrementCounter(\"aimock_chaos_triggered_total\", { action });\n  }\n\n  switch (action) {\n    case \"drop\": {\n      journal.add({\n        ...context,\n        response: { status: 500, fixture, chaosAction: \"drop\" },\n      });\n      writeErrorResponse(\n        res,\n        500,\n        JSON.stringify({\n          error: {\n            message: \"Chaos: request dropped\",\n            type: \"server_error\",\n            code: \"chaos_drop\",\n          },\n        }),\n      );\n      return true;\n    }\n    case \"malformed\": {\n      journal.add({\n        ...context,\n        response: { status: 200, fixture, chaosAction: \"malformed\" },\n      });\n      res.writeHead(200, { \"Content-Type\": \"application/json\" });\n      res.end(\"{malformed json: <<<chaos>>>\");\n      return true;\n    }\n    case \"disconnect\": {\n      journal.add({\n        ...context,\n        response: { status: 0, fixture, chaosAction: \"disconnect\" },\n      });\n      res.destroy();\n      return true;\n    }\n    default: {\n      const _exhaustive: never = action;\n      void _exhaustive;\n      return false;\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/cli.cjs

@@ -0,0 +1,268 @@
+#!/usr/bin/env node
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_fixture_loader = require('./fixture-loader.cjs');
+const require_logger = require('./logger.cjs');
+const require_server = require('./server.cjs');
+const require_watcher = require('./watcher.cjs');
+let node_util = require("node:util");
+let node_path = require("node:path");
+let node_fs = require("node:fs");
+
+//#region src/cli.ts
+const HELP = `
+Usage: llmock [options]
+
+Options:
+  -p, --port <number>       Port to listen on (default: 4010)
+  -h, --host <string>       Host to bind to (default: 127.0.0.1)
+  -f, --fixtures <path>     Path to fixtures directory or file (default: ./fixtures)
+  -l, --latency <ms>        Latency in ms between SSE chunks (default: 0)
+  -c, --chunk-size <chars>  Chunk size in characters (default: 20)
+  -w, --watch               Watch fixture path for changes and reload
+      --log-level <level>   Log verbosity: silent, info, debug (default: info)
+      --validate-on-load    Validate fixture schemas at startup
+      --metrics             Enable Prometheus metrics at GET /metrics
+      --record              Record mode: proxy unmatched requests to real APIs
+      --strict              Strict mode: fail on unmatched requests
+      --provider-openai <url>     Upstream URL for OpenAI (used with --record)
+      --provider-anthropic <url>  Upstream URL for Anthropic
+      --provider-gemini <url>     Upstream URL for Gemini
+      --provider-vertexai <url>   Upstream URL for Vertex AI
+      --provider-bedrock <url>    Upstream URL for Bedrock
+      --provider-azure <url>      Upstream URL for Azure OpenAI
+      --provider-ollama <url>     Upstream URL for Ollama
+      --provider-cohere <url>     Upstream URL for Cohere
+      --chaos-drop <rate>   Probability (0-1) of dropping requests with 500
+      --chaos-malformed <rate>  Probability (0-1) of returning malformed JSON
+      --chaos-disconnect <rate> Probability (0-1) of destroying connection
+      --help                Show this help message
+`.trim();
+const { values } = (0, node_util.parseArgs)({
+	options: {
+		port: {
+			type: "string",
+			short: "p",
+			default: "4010"
+		},
+		host: {
+			type: "string",
+			short: "h",
+			default: "127.0.0.1"
+		},
+		fixtures: {
+			type: "string",
+			short: "f",
+			default: "./fixtures"
+		},
+		latency: {
+			type: "string",
+			short: "l",
+			default: "0"
+		},
+		"chunk-size": {
+			type: "string",
+			short: "c",
+			default: "20"
+		},
+		watch: {
+			type: "boolean",
+			short: "w",
+			default: false
+		},
+		"log-level": {
+			type: "string",
+			default: "info"
+		},
+		"validate-on-load": {
+			type: "boolean",
+			default: false
+		},
+		metrics: {
+			type: "boolean",
+			default: false
+		},
+		record: {
+			type: "boolean",
+			default: false
+		},
+		strict: {
+			type: "boolean",
+			default: false
+		},
+		"provider-openai": { type: "string" },
+		"provider-anthropic": { type: "string" },
+		"provider-gemini": { type: "string" },
+		"provider-vertexai": { type: "string" },
+		"provider-bedrock": { type: "string" },
+		"provider-azure": { type: "string" },
+		"provider-ollama": { type: "string" },
+		"provider-cohere": { type: "string" },
+		"chaos-drop": { type: "string" },
+		"chaos-malformed": { type: "string" },
+		"chaos-disconnect": { type: "string" },
+		help: {
+			type: "boolean",
+			default: false
+		}
+	},
+	strict: true
+});
+if (values.help) {
+	console.log(HELP);
+	process.exit(0);
+}
+const port = Number(values.port);
+const host = values.host;
+const latency = Number(values.latency);
+const chunkSize = Number(values["chunk-size"]);
+const fixturePath = (0, node_path.resolve)(values.fixtures);
+const watchMode = values.watch;
+const validateOnLoad = values["validate-on-load"];
+const logLevelStr = values["log-level"];
+if (![
+	"silent",
+	"info",
+	"debug"
+].includes(logLevelStr)) {
+	console.error(`Invalid log-level: ${logLevelStr} (must be silent, info, or debug)`);
+	process.exit(1);
+}
+const logLevel = logLevelStr;
+if (Number.isNaN(port) || port < 0 || port > 65535) {
+	console.error(`Invalid port: ${values.port}`);
+	process.exit(1);
+}
+if (Number.isNaN(latency) || latency < 0) {
+	console.error(`Invalid latency: ${values.latency}`);
+	process.exit(1);
+}
+if (Number.isNaN(chunkSize) || chunkSize < 1) {
+	console.error(`Invalid chunk-size: ${values["chunk-size"]}`);
+	process.exit(1);
+}
+const logger = new require_logger.Logger(logLevel);
+let chaos;
+{
+	const dropStr = values["chaos-drop"];
+	const malformedStr = values["chaos-malformed"];
+	const disconnectStr = values["chaos-disconnect"];
+	if (dropStr !== void 0 || malformedStr !== void 0 || disconnectStr !== void 0) {
+		chaos = {};
+		if (dropStr !== void 0) {
+			const val = parseFloat(dropStr);
+			if (isNaN(val) || val < 0 || val > 1) {
+				console.error(`Invalid chaos-drop: ${dropStr} (must be 0-1)`);
+				process.exit(1);
+			}
+			chaos.dropRate = val;
+		}
+		if (malformedStr !== void 0) {
+			const val = parseFloat(malformedStr);
+			if (isNaN(val) || val < 0 || val > 1) {
+				console.error(`Invalid chaos-malformed: ${malformedStr} (must be 0-1)`);
+				process.exit(1);
+			}
+			chaos.malformedRate = val;
+		}
+		if (disconnectStr !== void 0) {
+			const val = parseFloat(disconnectStr);
+			if (isNaN(val) || val < 0 || val > 1) {
+				console.error(`Invalid chaos-disconnect: ${disconnectStr} (must be 0-1)`);
+				process.exit(1);
+			}
+			chaos.disconnectRate = val;
+		}
+	}
+}
+let record;
+if (values.record) {
+	const providers = {};
+	if (values["provider-openai"]) providers.openai = values["provider-openai"];
+	if (values["provider-anthropic"]) providers.anthropic = values["provider-anthropic"];
+	if (values["provider-gemini"]) providers.gemini = values["provider-gemini"];
+	if (values["provider-vertexai"]) providers.vertexai = values["provider-vertexai"];
+	if (values["provider-bedrock"]) providers.bedrock = values["provider-bedrock"];
+	if (values["provider-azure"]) providers.azure = values["provider-azure"];
+	if (values["provider-ollama"]) providers.ollama = values["provider-ollama"];
+	if (values["provider-cohere"]) providers.cohere = values["provider-cohere"];
+	if (Object.keys(providers).length === 0) {
+		console.error("Error: --record requires at least one --provider-* flag");
+		process.exit(1);
+	}
+	record = {
+		providers,
+		fixturePath: (0, node_path.resolve)(fixturePath, "recorded")
+	};
+}
+async function main() {
+	let isDir;
+	let fixtures;
+	try {
+		isDir = (0, node_fs.statSync)(fixturePath).isDirectory();
+		if (isDir) fixtures = require_fixture_loader.loadFixturesFromDir(fixturePath, logger);
+		else fixtures = require_fixture_loader.loadFixtureFile(fixturePath, logger);
+	} catch (err) {
+		if (err.code === "ENOENT") console.error(`Fixtures path not found: ${fixturePath}`);
+		else {
+			const msg = err instanceof Error ? err.message : String(err);
+			console.error(`Failed to load fixtures from ${fixturePath}: ${msg}`);
+		}
+		process.exit(1);
+	}
+	if (fixtures.length === 0) {
+		if (validateOnLoad || values.strict) {
+			console.error("Error: No fixtures loaded and validation/strict mode is enabled — aborting.");
+			process.exit(1);
+		}
+		console.warn("Warning: No fixtures loaded. The server will return 404 for all requests.");
+	}
+	logger.info(`Loaded ${fixtures.length} fixture(s) from ${fixturePath}`);
+	if (validateOnLoad) {
+		const results = require_fixture_loader.validateFixtures(fixtures);
+		const errors = results.filter((r) => r.severity === "error");
+		const warnings = results.filter((r) => r.severity === "warning");
+		for (const w of warnings) logger.warn(`Fixture ${w.fixtureIndex}: ${w.message}`);
+		for (const e of errors) logger.error(`Fixture ${e.fixtureIndex}: ${e.message}`);
+		if (errors.length > 0) {
+			console.error(`Validation failed: ${errors.length} error(s), ${warnings.length} warning(s)`);
+			process.exit(1);
+		}
+	}
+	const instance = await require_server.createServer(fixtures, {
+		port,
+		host,
+		latency,
+		chunkSize,
+		logLevel,
+		chaos,
+		metrics: values.metrics,
+		record,
+		strict: values.strict
+	});
+	logger.info(`aimock server listening on ${instance.url}`);
+	let watcher = null;
+	if (watchMode) {
+		watcher = require_watcher.watchFixtures(fixturePath, fixtures, isDir ? () => require_fixture_loader.loadFixturesFromDir(fixturePath, logger) : () => require_fixture_loader.loadFixtureFile(fixturePath, logger), {
+			logger,
+			validate: validateOnLoad,
+			validateFn: require_fixture_loader.validateFixtures
+		});
+		logger.info(`Watching ${fixturePath} for changes`);
+	}
+	function shutdown() {
+		logger.info("Shutting down...");
+		if (watcher) watcher.close();
+		instance.server.close(() => {
+			process.exit(0);
+		});
+	}
+	process.on("SIGINT", shutdown);
+	process.on("SIGTERM", shutdown);
+}
+main().catch((err) => {
+	console.error(err);
+	process.exit(1);
+});
+
+//#endregion
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.cjs","names":["Logger","loadFixturesFromDir","loadFixtureFile","validateFixtures","createServer","watchFixtures"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { parseArgs } from \"node:util\";\nimport { statSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { createServer } from \"./server.js\";\nimport { loadFixtureFile, loadFixturesFromDir, validateFixtures } from \"./fixture-loader.js\";\nimport { Logger, type LogLevel } from \"./logger.js\";\nimport { watchFixtures } from \"./watcher.js\";\nimport type { ChaosConfig, RecordConfig } from \"./types.js\";\n\nconst HELP = `\nUsage: llmock [options]\n\nOptions:\n  -p, --port <number>       Port to listen on (default: 4010)\n  -h, --host <string>       Host to bind to (default: 127.0.0.1)\n  -f, --fixtures <path>     Path to fixtures directory or file (default: ./fixtures)\n  -l, --latency <ms>        Latency in ms between SSE chunks (default: 0)\n  -c, --chunk-size <chars>  Chunk size in characters (default: 20)\n  -w, --watch               Watch fixture path for changes and reload\n      --log-level <level>   Log verbosity: silent, info, debug (default: info)\n      --validate-on-load    Validate fixture schemas at startup\n      --metrics             Enable Prometheus metrics at GET /metrics\n      --record              Record mode: proxy unmatched requests to real APIs\n      --strict              Strict mode: fail on unmatched requests\n      --provider-openai <url>     Upstream URL for OpenAI (used with --record)\n      --provider-anthropic <url>  Upstream URL for Anthropic\n      --provider-gemini <url>     Upstream URL for Gemini\n      --provider-vertexai <url>   Upstream URL for Vertex AI\n      --provider-bedrock <url>    Upstream URL for Bedrock\n      --provider-azure <url>      Upstream URL for Azure OpenAI\n      --provider-ollama <url>     Upstream URL for Ollama\n      --provider-cohere <url>     Upstream URL for Cohere\n      --chaos-drop <rate>   Probability (0-1) of dropping requests with 500\n      --chaos-malformed <rate>  Probability (0-1) of returning malformed JSON\n      --chaos-disconnect <rate> Probability (0-1) of destroying connection\n      --help                Show this help message\n`.trim();\n\nconst { values } = parseArgs({\n  options: {\n    port: { type: \"string\", short: \"p\", default: \"4010\" },\n    host: { type: \"string\", short: \"h\", default: \"127.0.0.1\" },\n    fixtures: { type: \"string\", short: \"f\", default: \"./fixtures\" },\n    latency: { type: \"string\", short: \"l\", default: \"0\" },\n    \"chunk-size\": { type: \"string\", short: \"c\", default: \"20\" },\n    watch: { type: \"boolean\", short: \"w\", default: false },\n    \"log-level\": { type: \"string\", default: \"info\" },\n    \"validate-on-load\": { type: \"boolean\", default: false },\n    metrics: { type: \"boolean\", default: false },\n    record: { type: \"boolean\", default: false },\n    strict: { type: \"boolean\", default: false },\n    \"provider-openai\": { type: \"string\" },\n    \"provider-anthropic\": { type: \"string\" },\n    \"provider-gemini\": { type: \"string\" },\n    \"provider-vertexai\": { type: \"string\" },\n    \"provider-bedrock\": { type: \"string\" },\n    \"provider-azure\": { type: \"string\" },\n    \"provider-ollama\": { type: \"string\" },\n    \"provider-cohere\": { type: \"string\" },\n    \"chaos-drop\": { type: \"string\" },\n    \"chaos-malformed\": { type: \"string\" },\n    \"chaos-disconnect\": { type: \"string\" },\n    help: { type: \"boolean\", default: false },\n  },\n  strict: true,\n});\n\nif (values.help) {\n  console.log(HELP);\n  process.exit(0);\n}\n\nconst port = Number(values.port);\nconst host = values.host!;\nconst latency = Number(values.latency);\nconst chunkSize = Number(values[\"chunk-size\"]);\nconst fixturePath = resolve(values.fixtures!);\nconst watchMode = values.watch!;\nconst validateOnLoad = values[\"validate-on-load\"]!;\nconst logLevelStr = values[\"log-level\"]!;\n\nif (![\"silent\", \"info\", \"debug\"].includes(logLevelStr)) {\n  console.error(`Invalid log-level: ${logLevelStr} (must be silent, info, or debug)`);\n  process.exit(1);\n}\nconst logLevel = logLevelStr as LogLevel;\n\nif (Number.isNaN(port) || port < 0 || port > 65535) {\n  console.error(`Invalid port: ${values.port}`);\n  process.exit(1);\n}\n\nif (Number.isNaN(latency) || latency < 0) {\n  console.error(`Invalid latency: ${values.latency}`);\n  process.exit(1);\n}\n\nif (Number.isNaN(chunkSize) || chunkSize < 1) {\n  console.error(`Invalid chunk-size: ${values[\"chunk-size\"]}`);\n  process.exit(1);\n}\n\nconst logger = new Logger(logLevel);\n\n// Parse chaos config from CLI flags\nlet chaos: ChaosConfig | undefined;\n{\n  const dropStr = values[\"chaos-drop\"];\n  const malformedStr = values[\"chaos-malformed\"];\n  const disconnectStr = values[\"chaos-disconnect\"];\n\n  if (dropStr !== undefined || malformedStr !== undefined || disconnectStr !== undefined) {\n    chaos = {};\n    if (dropStr !== undefined) {\n      const val = parseFloat(dropStr);\n      if (isNaN(val) || val < 0 || val > 1) {\n        console.error(`Invalid chaos-drop: ${dropStr} (must be 0-1)`);\n        process.exit(1);\n      }\n      chaos.dropRate = val;\n    }\n    if (malformedStr !== undefined) {\n      const val = parseFloat(malformedStr);\n      if (isNaN(val) || val < 0 || val > 1) {\n        console.error(`Invalid chaos-malformed: ${malformedStr} (must be 0-1)`);\n        process.exit(1);\n      }\n      chaos.malformedRate = val;\n    }\n    if (disconnectStr !== undefined) {\n      const val = parseFloat(disconnectStr);\n      if (isNaN(val) || val < 0 || val > 1) {\n        console.error(`Invalid chaos-disconnect: ${disconnectStr} (must be 0-1)`);\n        process.exit(1);\n      }\n      chaos.disconnectRate = val;\n    }\n  }\n}\n\n// Parse record config from CLI flags\nlet record: RecordConfig | undefined;\nif (values.record) {\n  const providers: RecordConfig[\"providers\"] = {};\n  if (values[\"provider-openai\"]) providers.openai = values[\"provider-openai\"];\n  if (values[\"provider-anthropic\"]) providers.anthropic = values[\"provider-anthropic\"];\n  if (values[\"provider-gemini\"]) providers.gemini = values[\"provider-gemini\"];\n  if (values[\"provider-vertexai\"]) providers.vertexai = values[\"provider-vertexai\"];\n  if (values[\"provider-bedrock\"]) providers.bedrock = values[\"provider-bedrock\"];\n  if (values[\"provider-azure\"]) providers.azure = values[\"provider-azure\"];\n  if (values[\"provider-ollama\"]) providers.ollama = values[\"provider-ollama\"];\n  if (values[\"provider-cohere\"]) providers.cohere = values[\"provider-cohere\"];\n\n  if (Object.keys(providers).length === 0) {\n    console.error(\"Error: --record requires at least one --provider-* flag\");\n    process.exit(1);\n  }\n\n  record = { providers, fixturePath: resolve(fixturePath, \"recorded\") };\n}\n\nasync function main() {\n  // Load fixtures from path (detect file vs directory)\n  let isDir: boolean;\n  let fixtures;\n  try {\n    const stat = statSync(fixturePath);\n    isDir = stat.isDirectory();\n    if (isDir) {\n      fixtures = loadFixturesFromDir(fixturePath, logger);\n    } else {\n      fixtures = loadFixtureFile(fixturePath, logger);\n    }\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code === \"ENOENT\") {\n      console.error(`Fixtures path not found: ${fixturePath}`);\n    } else {\n      const msg = err instanceof Error ? err.message : String(err);\n      console.error(`Failed to load fixtures from ${fixturePath}: ${msg}`);\n    }\n    process.exit(1);\n  }\n\n  if (fixtures.length === 0) {\n    if (validateOnLoad || values.strict) {\n      console.error(\"Error: No fixtures loaded and validation/strict mode is enabled — aborting.\");\n      process.exit(1);\n    }\n    console.warn(\"Warning: No fixtures loaded. The server will return 404 for all requests.\");\n  }\n\n  logger.info(`Loaded ${fixtures.length} fixture(s) from ${fixturePath}`);\n\n  // Validate fixtures if requested\n  if (validateOnLoad) {\n    const results = validateFixtures(fixtures);\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    for (const e of errors) {\n      logger.error(`Fixture ${e.fixtureIndex}: ${e.message}`);\n    }\n\n    if (errors.length > 0) {\n      console.error(`Validation failed: ${errors.length} error(s), ${warnings.length} warning(s)`);\n      process.exit(1);\n    }\n  }\n\n  const instance = await createServer(fixtures, {\n    port,\n    host,\n    latency,\n    chunkSize,\n    logLevel,\n    chaos,\n    metrics: values.metrics,\n    record,\n    strict: values.strict,\n  });\n\n  logger.info(`aimock server listening on ${instance.url}`);\n\n  // Start file watcher if requested\n  let watcher: { close: () => void } | null = null;\n  if (watchMode) {\n    const loadFn = isDir!\n      ? () => loadFixturesFromDir(fixturePath, logger)\n      : () => loadFixtureFile(fixturePath, logger);\n\n    watcher = watchFixtures(fixturePath, fixtures, loadFn, {\n      logger,\n      validate: validateOnLoad,\n      validateFn: validateFixtures,\n    });\n    logger.info(`Watching ${fixturePath} for changes`);\n  }\n\n  function shutdown() {\n    logger.info(\"Shutting down...\");\n    if (watcher) watcher.close();\n    instance.server.close(() => {\n      process.exit(0);\n    });\n  }\n\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n}\n\nmain().catch((err) => {\n  console.error(err);\n  process.exit(1);\n});\n"],"mappings":"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"}

package/dist/cli.d.cts

@@ -0,0 +1 @@
+export {};

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export {};