@copilotkit/aimock 1.45.1 → 1.47.0

package/dist/raw-validation.cjs

@@ -0,0 +1,177 @@
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+let node_http = require("node:http");
+
+//#region src/raw-validation.ts
+/**
+* @internal Shape checks for raw passthrough responses (#549). One pure
+* checker serves load-time validation (`validateFixtures`) and the serve-time
+* check, which runs on every raw fixture served (including factories and
+* `on()` fixtures, which skip load validation). Not exported from the package
+* entry point.
+*/
+/** Every {@link RawWireId}; the `satisfies` + exhaustiveness check keep it in sync. */
+const RAW_WIRE_IDS = [
+	"openai-responses",
+	"openai-chat",
+	"anthropic",
+	"gemini",
+	"gemini-interactions",
+	"cohere",
+	"ollama",
+	"ollama-generate",
+	"bedrock-invoke",
+	"bedrock-converse"
+];
+function isRawWireId(value) {
+	return typeof value === "string" && RAW_WIRE_IDS.includes(value);
+}
+/** Headers that break or misdescribe a body aimock frames itself. */
+const FORBIDDEN_HEADERS = new Set([
+	"content-length",
+	"transfer-encoding",
+	"connection",
+	"content-encoding"
+]);
+/** Wires whose framing takes the SSE event name from the event's string `type`. */
+const TYPE_NAMED_WIRES = new Set([
+	"openai-responses",
+	"anthropic",
+	"cohere"
+]);
+/** The fields of `raw`; any other key is reported as ignored. */
+const RAW_FIELDS = [
+	"wire",
+	"events",
+	"json",
+	"status",
+	"headers",
+	"done"
+];
+/** Statuses whose replies carry no body: Node drops anything written for them. */
+const BODYLESS_STATUSES = new Set([204, 304]);
+/**
+* The longest AWS event-stream header value, in bytes. The encoder writes the
+* length as a uint16 (aws-event-stream.ts), so it cannot frame a longer one.
+*/
+const EVENT_STREAM_HEADER_VALUE_MAX_BYTES = 65535;
+/** A plain object, as JSON.parse makes one: not an array, Date, Map or class instance. */
+function isPlainObject(value) {
+	if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null;
+}
+/**
+* The first part of `value` that JSON.parse cannot produce (a sparse-array
+* hole, `undefined`, a non-finite number, a function, a Date or other
+* non-plain object, a cycle), as `[path, problem]`. Undefined for plain JSON.
+*/
+function jsonProblem(value, path, ancestors = []) {
+	if (value === null || typeof value === "string" || typeof value === "boolean") return void 0;
+	if (typeof value === "number") return Number.isFinite(value) ? void 0 : [path, "must be a finite number"];
+	if (typeof value !== "object") return [path, `must be a JSON value; got ${typeof value}`];
+	if (ancestors.includes(value)) return [path, "must not contain itself"];
+	const inner = [...ancestors, value];
+	if (Array.isArray(value)) {
+		for (let i = 0; i < value.length; i++) {
+			if (!(i in value)) return [`${path}[${i}]`, "must not be a hole in a sparse array"];
+			const problem = jsonProblem(value[i], `${path}[${i}]`, inner);
+			if (problem) return problem;
+		}
+		return;
+	}
+	if (!isPlainObject(value)) return [path, "must be a plain JSON object"];
+	for (const [key, item] of Object.entries(value)) {
+		const problem = jsonProblem(item, `${path}[${JSON.stringify(key)}]`, inner);
+		if (problem) return problem;
+	}
+}
+/**
+* Check a raw response's `raw` value and the fixture facts in `context`.
+* Returns every finding. The fixture is servable when no finding has severity
+* `"error"`: an empty array or one with only warnings. Pure: no logging, no
+* throwing. Load validation and serve time both call it, so they agree on
+* what a valid raw fixture is.
+*/
+function checkRawResponse(raw, context = {}) {
+	const findings = [];
+	const error = (message) => findings.push({
+		severity: "error",
+		message
+	});
+	for (const key of context.otherResponseKeys ?? []) error(`raw cannot be combined with ${JSON.stringify(key)}: a raw fixture has no other response type`);
+	if (context.fixtureMisbehavior) error("misbehavior does not apply to raw fixtures");
+	if (!isPlainObject(raw)) {
+		error("raw must be an object");
+		return findings;
+	}
+	for (const key of Object.keys(raw)) if (!RAW_FIELDS.includes(key)) findings.push({
+		severity: "warning",
+		message: `raw[${JSON.stringify(key)}] is ignored: not a raw field (${RAW_FIELDS.join(", ")})`
+	});
+	const wire = isRawWireId(raw.wire) ? raw.wire : void 0;
+	if (wire === void 0) error(`raw.wire must be one of ${RAW_WIRE_IDS.join(", ")}; got ${JSON.stringify(raw.wire)}`);
+	const events = raw.events;
+	if (events === void 0 && raw.json === void 0) error("raw needs \"events\" (streaming), \"json\" (non-streaming), or both");
+	if (events !== void 0) if (!Array.isArray(events)) error("raw.events must be an array");
+	else {
+		if (events.length === 0) findings.push({
+			severity: "warning",
+			message: "raw.events is empty; a streaming request gets no frames"
+		});
+		for (let i = 0; i < events.length; i++) {
+			const event = events[i];
+			if (!isPlainObject(event)) {
+				error(`raw.events[${i}] must be a JSON object`);
+				continue;
+			}
+			const problem = jsonProblem(event, `raw.events[${i}]`);
+			if (problem) {
+				error(`${problem[0]} ${problem[1]}`);
+				continue;
+			}
+			if (wire !== void 0 && TYPE_NAMED_WIRES.has(wire)) {
+				if (typeof event.type !== "string") error(`raw.events[${i}] needs a string "type" on ${wire}`);
+				else if (/[\r\n]/.test(event.type)) error(`raw.events[${i}].type must not contain a line break (CR or LF) on ${wire}`);
+			}
+			if (wire === "bedrock-converse") {
+				const keys = Object.keys(event);
+				if (keys.length !== 1) error(`raw.events[${i}] must have exactly one top-level key (the event type) on bedrock-converse`);
+				else if (Buffer.byteLength(keys[0], "utf8") > EVENT_STREAM_HEADER_VALUE_MAX_BYTES) error(`raw.events[${i}] has an event type key over ${EVENT_STREAM_HEADER_VALUE_MAX_BYTES} bytes, the event-stream header limit, on bedrock-converse`);
+				else if (!isPlainObject(event[keys[0]])) error(`raw.events[${i}].${keys[0]} must be a JSON object (the frame payload) on bedrock-converse`);
+			}
+		}
+	}
+	if (raw.status !== void 0) {
+		const status = raw.status;
+		if (typeof status !== "number" || !Number.isInteger(status) || status < 200 || status > 599) error(`raw.status must be an integer from 200 to 599; got ${JSON.stringify(status)}`);
+		else if (BODYLESS_STATUSES.has(status)) error(`raw.status ${status} cannot carry a body, so "events" and "json" would be dropped; use a status that allows a body`);
+	}
+	if (raw.headers !== void 0) if (!isPlainObject(raw.headers)) error("raw.headers must be an object of string values");
+	else for (const [name, value] of Object.entries(raw.headers)) {
+		const label = `raw.headers[${JSON.stringify(name)}]`;
+		if (typeof value !== "string") {
+			error(`${label} must be a string`);
+			continue;
+		}
+		try {
+			(0, node_http.validateHeaderName)(name);
+		} catch {
+			error(`${label} is not a valid header name`);
+			continue;
+		}
+		try {
+			(0, node_http.validateHeaderValue)(name, value);
+		} catch {
+			error(`${label} has an invalid header value`);
+			continue;
+		}
+		if (FORBIDDEN_HEADERS.has(name.toLowerCase())) error(`${label} is not allowed: aimock frames the body and sets this header itself`);
+	}
+	if (raw.done !== void 0 && typeof raw.done !== "boolean") error(`raw.done must be a boolean; got ${JSON.stringify(raw.done)}`);
+	else if (raw.done !== void 0 && wire !== void 0 && wire !== "openai-chat") error(`raw.done applies only to openai-chat (the only wire with a [DONE] terminal), not ${wire}`);
+	return findings;
+}
+
+//#endregion
+exports.checkRawResponse = checkRawResponse;
+//# sourceMappingURL=raw-validation.cjs.map

package/dist/raw-validation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-validation.cjs","names":[],"sources":["../src/raw-validation.ts"],"sourcesContent":["/**\n * @internal Shape checks for raw passthrough responses (#549). One pure\n * checker serves load-time validation (`validateFixtures`) and the serve-time\n * check, which runs on every raw fixture served (including factories and\n * `on()` fixtures, which skip load validation). Not exported from the package\n * entry point.\n */\nimport { validateHeaderName, validateHeaderValue } from \"node:http\";\nimport type { RawResponse, RawWireId } from \"./types.js\";\n\nexport interface RawFinding {\n  severity: \"error\" | \"warning\";\n  message: string;\n}\n\n/** Every {@link RawWireId}; the `satisfies` + exhaustiveness check keep it in sync. */\nexport const RAW_WIRE_IDS = [\n  \"openai-responses\",\n  \"openai-chat\",\n  \"anthropic\",\n  \"gemini\",\n  \"gemini-interactions\",\n  \"cohere\",\n  \"ollama\",\n  \"ollama-generate\",\n  \"bedrock-invoke\",\n  \"bedrock-converse\",\n] as const satisfies readonly RawWireId[];\n\n// Compile-time: fails if RawWireId gains a member RAW_WIRE_IDS lacks.\ntype MissingRawWire = Exclude<RawWireId, (typeof RAW_WIRE_IDS)[number]>;\nconst rawWireIdsComplete: MissingRawWire extends never ? true : never = true;\nvoid rawWireIdsComplete;\n\nexport function isRawWireId(value: unknown): value is RawWireId {\n  return typeof value === \"string\" && (RAW_WIRE_IDS as readonly string[]).includes(value);\n}\n\n/** Headers that break or misdescribe a body aimock frames itself. */\nconst FORBIDDEN_HEADERS = new Set([\n  \"content-length\",\n  \"transfer-encoding\",\n  \"connection\",\n  \"content-encoding\",\n]);\n\n/** Wires whose framing takes the SSE event name from the event's string `type`. */\nconst TYPE_NAMED_WIRES: ReadonlySet<RawWireId> = new Set([\n  \"openai-responses\",\n  \"anthropic\",\n  \"cohere\",\n]);\n\n/** The fields of `raw`; any other key is reported as ignored. */\nconst RAW_FIELDS: readonly string[] = [\n  \"wire\",\n  \"events\",\n  \"json\",\n  \"status\",\n  \"headers\",\n  \"done\",\n] satisfies (keyof RawResponse[\"raw\"])[];\n\n/** Statuses whose replies carry no body: Node drops anything written for them. */\nconst BODYLESS_STATUSES: ReadonlySet<number> = new Set([204, 304]);\n\n/**\n * The longest AWS event-stream header value, in bytes. The encoder writes the\n * length as a uint16 (aws-event-stream.ts), so it cannot frame a longer one.\n */\nconst EVENT_STREAM_HEADER_VALUE_MAX_BYTES = 0xffff;\n\n/** A plain object, as JSON.parse makes one: not an array, Date, Map or class instance. */\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) return false;\n  const proto: unknown = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n}\n\n/**\n * The first part of `value` that JSON.parse cannot produce (a sparse-array\n * hole, `undefined`, a non-finite number, a function, a Date or other\n * non-plain object, a cycle), as `[path, problem]`. Undefined for plain JSON.\n */\nfunction jsonProblem(\n  value: unknown,\n  path: string,\n  ancestors: readonly object[] = [],\n): [string, string] | undefined {\n  if (value === null || typeof value === \"string\" || typeof value === \"boolean\") return undefined;\n  if (typeof value === \"number\") {\n    return Number.isFinite(value) ? undefined : [path, \"must be a finite number\"];\n  }\n  if (typeof value !== \"object\") return [path, `must be a JSON value; got ${typeof value}`];\n  if (ancestors.includes(value)) return [path, \"must not contain itself\"];\n  const inner = [...ancestors, value];\n  if (Array.isArray(value)) {\n    for (let i = 0; i < value.length; i++) {\n      if (!(i in value)) return [`${path}[${i}]`, \"must not be a hole in a sparse array\"];\n      const problem = jsonProblem(value[i], `${path}[${i}]`, inner);\n      if (problem) return problem;\n    }\n    return undefined;\n  }\n  if (!isPlainObject(value)) return [path, \"must be a plain JSON object\"];\n  for (const [key, item] of Object.entries(value)) {\n    const problem = jsonProblem(item, `${path}[${JSON.stringify(key)}]`, inner);\n    if (problem) return problem;\n  }\n  return undefined;\n}\n\n/** What the caller knows about the fixture around `raw`. */\nexport interface RawCheckContext {\n  /**\n   * Response-type keys written next to `raw`, such as `customToolCalls` or\n   * `responsesBlocks` (a legacy server drops these two before serving).\n   */\n  otherResponseKeys?: readonly string[];\n  /** Whether the fixture sets its own `misbehavior`. */\n  fixtureMisbehavior?: boolean;\n}\n\n/**\n * Check a raw response's `raw` value and the fixture facts in `context`.\n * Returns every finding. The fixture is servable when no finding has severity\n * `\"error\"`: an empty array or one with only warnings. Pure: no logging, no\n * throwing. Load validation and serve time both call it, so they agree on\n * what a valid raw fixture is.\n */\nexport function checkRawResponse(raw: unknown, context: RawCheckContext = {}): RawFinding[] {\n  const findings: RawFinding[] = [];\n  const error = (message: string) => findings.push({ severity: \"error\", message });\n\n  for (const key of context.otherResponseKeys ?? []) {\n    error(\n      `raw cannot be combined with ${JSON.stringify(key)}: a raw fixture has no other response type`,\n    );\n  }\n  if (context.fixtureMisbehavior) {\n    error(\"misbehavior does not apply to raw fixtures\");\n  }\n\n  if (!isPlainObject(raw)) {\n    error(\"raw must be an object\");\n    return findings;\n  }\n\n  for (const key of Object.keys(raw)) {\n    if (!RAW_FIELDS.includes(key)) {\n      findings.push({\n        severity: \"warning\",\n        message: `raw[${JSON.stringify(key)}] is ignored: not a raw field (${RAW_FIELDS.join(\", \")})`,\n      });\n    }\n  }\n\n  const wire = isRawWireId(raw.wire) ? raw.wire : undefined;\n  if (wire === undefined) {\n    error(`raw.wire must be one of ${RAW_WIRE_IDS.join(\", \")}; got ${JSON.stringify(raw.wire)}`);\n  }\n\n  const events = raw.events;\n  if (events === undefined && raw.json === undefined) {\n    error('raw needs \"events\" (streaming), \"json\" (non-streaming), or both');\n  }\n  if (events !== undefined) {\n    if (!Array.isArray(events)) {\n      error(\"raw.events must be an array\");\n    } else {\n      if (events.length === 0) {\n        findings.push({\n          severity: \"warning\",\n          message: \"raw.events is empty; a streaming request gets no frames\",\n        });\n      }\n      // An index loop, not forEach: forEach skips the holes of a sparse array.\n      for (let i = 0; i < events.length; i++) {\n        const event: unknown = events[i];\n        if (!isPlainObject(event)) {\n          error(`raw.events[${i}] must be a JSON object`);\n          continue;\n        }\n        const problem = jsonProblem(event, `raw.events[${i}]`);\n        if (problem) {\n          error(`${problem[0]} ${problem[1]}`);\n          continue;\n        }\n        if (wire !== undefined && TYPE_NAMED_WIRES.has(wire)) {\n          if (typeof event.type !== \"string\") {\n            error(`raw.events[${i}] needs a string \"type\" on ${wire}`);\n          } else if (/[\\r\\n]/.test(event.type)) {\n            // The type is written as the SSE `event:` line; a line break\n            // would start another SSE field or frame.\n            error(`raw.events[${i}].type must not contain a line break (CR or LF) on ${wire}`);\n          }\n        }\n        if (wire === \"bedrock-converse\") {\n          const keys = Object.keys(event);\n          if (keys.length !== 1) {\n            error(\n              `raw.events[${i}] must have exactly one top-level key (the event type) on bedrock-converse`,\n            );\n          } else if (Buffer.byteLength(keys[0], \"utf8\") > EVENT_STREAM_HEADER_VALUE_MAX_BYTES) {\n            error(\n              `raw.events[${i}] has an event type key over ${EVENT_STREAM_HEADER_VALUE_MAX_BYTES} bytes, the event-stream header limit, on bedrock-converse`,\n            );\n          } else if (!isPlainObject(event[keys[0]])) {\n            error(\n              `raw.events[${i}].${keys[0]} must be a JSON object (the frame payload) on bedrock-converse`,\n            );\n          }\n        }\n      }\n    }\n  }\n\n  if (raw.status !== undefined) {\n    const status = raw.status;\n    if (typeof status !== \"number\" || !Number.isInteger(status) || status < 200 || status > 599) {\n      error(`raw.status must be an integer from 200 to 599; got ${JSON.stringify(status)}`);\n    } else if (BODYLESS_STATUSES.has(status)) {\n      error(\n        `raw.status ${status} cannot carry a body, so \"events\" and \"json\" would be dropped; use a status that allows a body`,\n      );\n    }\n  }\n\n  if (raw.headers !== undefined) {\n    if (!isPlainObject(raw.headers)) {\n      error(\"raw.headers must be an object of string values\");\n    } else {\n      for (const [name, value] of Object.entries(raw.headers)) {\n        const label = `raw.headers[${JSON.stringify(name)}]`;\n        if (typeof value !== \"string\") {\n          error(`${label} must be a string`);\n          continue;\n        }\n        try {\n          validateHeaderName(name);\n        } catch {\n          error(`${label} is not a valid header name`);\n          continue;\n        }\n        try {\n          validateHeaderValue(name, value);\n        } catch {\n          error(`${label} has an invalid header value`);\n          continue;\n        }\n        if (FORBIDDEN_HEADERS.has(name.toLowerCase())) {\n          error(`${label} is not allowed: aimock frames the body and sets this header itself`);\n        }\n      }\n    }\n  }\n\n  if (raw.done !== undefined && typeof raw.done !== \"boolean\") {\n    error(`raw.done must be a boolean; got ${JSON.stringify(raw.done)}`);\n  } else if (raw.done !== undefined && wire !== undefined && wire !== \"openai-chat\") {\n    error(\n      `raw.done applies only to openai-chat (the only wire with a [DONE] terminal), not ${wire}`,\n    );\n  }\n\n  return findings;\n}\n"],"mappings":"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"}

package/dist/raw-validation.js

@@ -0,0 +1,176 @@
+import { validateHeaderName, validateHeaderValue } from "node:http";
+
+//#region src/raw-validation.ts
+/**
+* @internal Shape checks for raw passthrough responses (#549). One pure
+* checker serves load-time validation (`validateFixtures`) and the serve-time
+* check, which runs on every raw fixture served (including factories and
+* `on()` fixtures, which skip load validation). Not exported from the package
+* entry point.
+*/
+/** Every {@link RawWireId}; the `satisfies` + exhaustiveness check keep it in sync. */
+const RAW_WIRE_IDS = [
+	"openai-responses",
+	"openai-chat",
+	"anthropic",
+	"gemini",
+	"gemini-interactions",
+	"cohere",
+	"ollama",
+	"ollama-generate",
+	"bedrock-invoke",
+	"bedrock-converse"
+];
+function isRawWireId(value) {
+	return typeof value === "string" && RAW_WIRE_IDS.includes(value);
+}
+/** Headers that break or misdescribe a body aimock frames itself. */
+const FORBIDDEN_HEADERS = new Set([
+	"content-length",
+	"transfer-encoding",
+	"connection",
+	"content-encoding"
+]);
+/** Wires whose framing takes the SSE event name from the event's string `type`. */
+const TYPE_NAMED_WIRES = new Set([
+	"openai-responses",
+	"anthropic",
+	"cohere"
+]);
+/** The fields of `raw`; any other key is reported as ignored. */
+const RAW_FIELDS = [
+	"wire",
+	"events",
+	"json",
+	"status",
+	"headers",
+	"done"
+];
+/** Statuses whose replies carry no body: Node drops anything written for them. */
+const BODYLESS_STATUSES = new Set([204, 304]);
+/**
+* The longest AWS event-stream header value, in bytes. The encoder writes the
+* length as a uint16 (aws-event-stream.ts), so it cannot frame a longer one.
+*/
+const EVENT_STREAM_HEADER_VALUE_MAX_BYTES = 65535;
+/** A plain object, as JSON.parse makes one: not an array, Date, Map or class instance. */
+function isPlainObject(value) {
+	if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null;
+}
+/**
+* The first part of `value` that JSON.parse cannot produce (a sparse-array
+* hole, `undefined`, a non-finite number, a function, a Date or other
+* non-plain object, a cycle), as `[path, problem]`. Undefined for plain JSON.
+*/
+function jsonProblem(value, path, ancestors = []) {
+	if (value === null || typeof value === "string" || typeof value === "boolean") return void 0;
+	if (typeof value === "number") return Number.isFinite(value) ? void 0 : [path, "must be a finite number"];
+	if (typeof value !== "object") return [path, `must be a JSON value; got ${typeof value}`];
+	if (ancestors.includes(value)) return [path, "must not contain itself"];
+	const inner = [...ancestors, value];
+	if (Array.isArray(value)) {
+		for (let i = 0; i < value.length; i++) {
+			if (!(i in value)) return [`${path}[${i}]`, "must not be a hole in a sparse array"];
+			const problem = jsonProblem(value[i], `${path}[${i}]`, inner);
+			if (problem) return problem;
+		}
+		return;
+	}
+	if (!isPlainObject(value)) return [path, "must be a plain JSON object"];
+	for (const [key, item] of Object.entries(value)) {
+		const problem = jsonProblem(item, `${path}[${JSON.stringify(key)}]`, inner);
+		if (problem) return problem;
+	}
+}
+/**
+* Check a raw response's `raw` value and the fixture facts in `context`.
+* Returns every finding. The fixture is servable when no finding has severity
+* `"error"`: an empty array or one with only warnings. Pure: no logging, no
+* throwing. Load validation and serve time both call it, so they agree on
+* what a valid raw fixture is.
+*/
+function checkRawResponse(raw, context = {}) {
+	const findings = [];
+	const error = (message) => findings.push({
+		severity: "error",
+		message
+	});
+	for (const key of context.otherResponseKeys ?? []) error(`raw cannot be combined with ${JSON.stringify(key)}: a raw fixture has no other response type`);
+	if (context.fixtureMisbehavior) error("misbehavior does not apply to raw fixtures");
+	if (!isPlainObject(raw)) {
+		error("raw must be an object");
+		return findings;
+	}
+	for (const key of Object.keys(raw)) if (!RAW_FIELDS.includes(key)) findings.push({
+		severity: "warning",
+		message: `raw[${JSON.stringify(key)}] is ignored: not a raw field (${RAW_FIELDS.join(", ")})`
+	});
+	const wire = isRawWireId(raw.wire) ? raw.wire : void 0;
+	if (wire === void 0) error(`raw.wire must be one of ${RAW_WIRE_IDS.join(", ")}; got ${JSON.stringify(raw.wire)}`);
+	const events = raw.events;
+	if (events === void 0 && raw.json === void 0) error("raw needs \"events\" (streaming), \"json\" (non-streaming), or both");
+	if (events !== void 0) if (!Array.isArray(events)) error("raw.events must be an array");
+	else {
+		if (events.length === 0) findings.push({
+			severity: "warning",
+			message: "raw.events is empty; a streaming request gets no frames"
+		});
+		for (let i = 0; i < events.length; i++) {
+			const event = events[i];
+			if (!isPlainObject(event)) {
+				error(`raw.events[${i}] must be a JSON object`);
+				continue;
+			}
+			const problem = jsonProblem(event, `raw.events[${i}]`);
+			if (problem) {
+				error(`${problem[0]} ${problem[1]}`);
+				continue;
+			}
+			if (wire !== void 0 && TYPE_NAMED_WIRES.has(wire)) {
+				if (typeof event.type !== "string") error(`raw.events[${i}] needs a string "type" on ${wire}`);
+				else if (/[\r\n]/.test(event.type)) error(`raw.events[${i}].type must not contain a line break (CR or LF) on ${wire}`);
+			}
+			if (wire === "bedrock-converse") {
+				const keys = Object.keys(event);
+				if (keys.length !== 1) error(`raw.events[${i}] must have exactly one top-level key (the event type) on bedrock-converse`);
+				else if (Buffer.byteLength(keys[0], "utf8") > EVENT_STREAM_HEADER_VALUE_MAX_BYTES) error(`raw.events[${i}] has an event type key over ${EVENT_STREAM_HEADER_VALUE_MAX_BYTES} bytes, the event-stream header limit, on bedrock-converse`);
+				else if (!isPlainObject(event[keys[0]])) error(`raw.events[${i}].${keys[0]} must be a JSON object (the frame payload) on bedrock-converse`);
+			}
+		}
+	}
+	if (raw.status !== void 0) {
+		const status = raw.status;
+		if (typeof status !== "number" || !Number.isInteger(status) || status < 200 || status > 599) error(`raw.status must be an integer from 200 to 599; got ${JSON.stringify(status)}`);
+		else if (BODYLESS_STATUSES.has(status)) error(`raw.status ${status} cannot carry a body, so "events" and "json" would be dropped; use a status that allows a body`);
+	}
+	if (raw.headers !== void 0) if (!isPlainObject(raw.headers)) error("raw.headers must be an object of string values");
+	else for (const [name, value] of Object.entries(raw.headers)) {
+		const label = `raw.headers[${JSON.stringify(name)}]`;
+		if (typeof value !== "string") {
+			error(`${label} must be a string`);
+			continue;
+		}
+		try {
+			validateHeaderName(name);
+		} catch {
+			error(`${label} is not a valid header name`);
+			continue;
+		}
+		try {
+			validateHeaderValue(name, value);
+		} catch {
+			error(`${label} has an invalid header value`);
+			continue;
+		}
+		if (FORBIDDEN_HEADERS.has(name.toLowerCase())) error(`${label} is not allowed: aimock frames the body and sets this header itself`);
+	}
+	if (raw.done !== void 0 && typeof raw.done !== "boolean") error(`raw.done must be a boolean; got ${JSON.stringify(raw.done)}`);
+	else if (raw.done !== void 0 && wire !== void 0 && wire !== "openai-chat") error(`raw.done applies only to openai-chat (the only wire with a [DONE] terminal), not ${wire}`);
+	return findings;
+}
+
+//#endregion
+export { checkRawResponse };
+//# sourceMappingURL=raw-validation.js.map

package/dist/raw-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-validation.js","names":[],"sources":["../src/raw-validation.ts"],"sourcesContent":["/**\n * @internal Shape checks for raw passthrough responses (#549). One pure\n * checker serves load-time validation (`validateFixtures`) and the serve-time\n * check, which runs on every raw fixture served (including factories and\n * `on()` fixtures, which skip load validation). Not exported from the package\n * entry point.\n */\nimport { validateHeaderName, validateHeaderValue } from \"node:http\";\nimport type { RawResponse, RawWireId } from \"./types.js\";\n\nexport interface RawFinding {\n  severity: \"error\" | \"warning\";\n  message: string;\n}\n\n/** Every {@link RawWireId}; the `satisfies` + exhaustiveness check keep it in sync. */\nexport const RAW_WIRE_IDS = [\n  \"openai-responses\",\n  \"openai-chat\",\n  \"anthropic\",\n  \"gemini\",\n  \"gemini-interactions\",\n  \"cohere\",\n  \"ollama\",\n  \"ollama-generate\",\n  \"bedrock-invoke\",\n  \"bedrock-converse\",\n] as const satisfies readonly RawWireId[];\n\n// Compile-time: fails if RawWireId gains a member RAW_WIRE_IDS lacks.\ntype MissingRawWire = Exclude<RawWireId, (typeof RAW_WIRE_IDS)[number]>;\nconst rawWireIdsComplete: MissingRawWire extends never ? true : never = true;\nvoid rawWireIdsComplete;\n\nexport function isRawWireId(value: unknown): value is RawWireId {\n  return typeof value === \"string\" && (RAW_WIRE_IDS as readonly string[]).includes(value);\n}\n\n/** Headers that break or misdescribe a body aimock frames itself. */\nconst FORBIDDEN_HEADERS = new Set([\n  \"content-length\",\n  \"transfer-encoding\",\n  \"connection\",\n  \"content-encoding\",\n]);\n\n/** Wires whose framing takes the SSE event name from the event's string `type`. */\nconst TYPE_NAMED_WIRES: ReadonlySet<RawWireId> = new Set([\n  \"openai-responses\",\n  \"anthropic\",\n  \"cohere\",\n]);\n\n/** The fields of `raw`; any other key is reported as ignored. */\nconst RAW_FIELDS: readonly string[] = [\n  \"wire\",\n  \"events\",\n  \"json\",\n  \"status\",\n  \"headers\",\n  \"done\",\n] satisfies (keyof RawResponse[\"raw\"])[];\n\n/** Statuses whose replies carry no body: Node drops anything written for them. */\nconst BODYLESS_STATUSES: ReadonlySet<number> = new Set([204, 304]);\n\n/**\n * The longest AWS event-stream header value, in bytes. The encoder writes the\n * length as a uint16 (aws-event-stream.ts), so it cannot frame a longer one.\n */\nconst EVENT_STREAM_HEADER_VALUE_MAX_BYTES = 0xffff;\n\n/** A plain object, as JSON.parse makes one: not an array, Date, Map or class instance. */\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) return false;\n  const proto: unknown = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n}\n\n/**\n * The first part of `value` that JSON.parse cannot produce (a sparse-array\n * hole, `undefined`, a non-finite number, a function, a Date or other\n * non-plain object, a cycle), as `[path, problem]`. Undefined for plain JSON.\n */\nfunction jsonProblem(\n  value: unknown,\n  path: string,\n  ancestors: readonly object[] = [],\n): [string, string] | undefined {\n  if (value === null || typeof value === \"string\" || typeof value === \"boolean\") return undefined;\n  if (typeof value === \"number\") {\n    return Number.isFinite(value) ? undefined : [path, \"must be a finite number\"];\n  }\n  if (typeof value !== \"object\") return [path, `must be a JSON value; got ${typeof value}`];\n  if (ancestors.includes(value)) return [path, \"must not contain itself\"];\n  const inner = [...ancestors, value];\n  if (Array.isArray(value)) {\n    for (let i = 0; i < value.length; i++) {\n      if (!(i in value)) return [`${path}[${i}]`, \"must not be a hole in a sparse array\"];\n      const problem = jsonProblem(value[i], `${path}[${i}]`, inner);\n      if (problem) return problem;\n    }\n    return undefined;\n  }\n  if (!isPlainObject(value)) return [path, \"must be a plain JSON object\"];\n  for (const [key, item] of Object.entries(value)) {\n    const problem = jsonProblem(item, `${path}[${JSON.stringify(key)}]`, inner);\n    if (problem) return problem;\n  }\n  return undefined;\n}\n\n/** What the caller knows about the fixture around `raw`. */\nexport interface RawCheckContext {\n  /**\n   * Response-type keys written next to `raw`, such as `customToolCalls` or\n   * `responsesBlocks` (a legacy server drops these two before serving).\n   */\n  otherResponseKeys?: readonly string[];\n  /** Whether the fixture sets its own `misbehavior`. */\n  fixtureMisbehavior?: boolean;\n}\n\n/**\n * Check a raw response's `raw` value and the fixture facts in `context`.\n * Returns every finding. The fixture is servable when no finding has severity\n * `\"error\"`: an empty array or one with only warnings. Pure: no logging, no\n * throwing. Load validation and serve time both call it, so they agree on\n * what a valid raw fixture is.\n */\nexport function checkRawResponse(raw: unknown, context: RawCheckContext = {}): RawFinding[] {\n  const findings: RawFinding[] = [];\n  const error = (message: string) => findings.push({ severity: \"error\", message });\n\n  for (const key of context.otherResponseKeys ?? []) {\n    error(\n      `raw cannot be combined with ${JSON.stringify(key)}: a raw fixture has no other response type`,\n    );\n  }\n  if (context.fixtureMisbehavior) {\n    error(\"misbehavior does not apply to raw fixtures\");\n  }\n\n  if (!isPlainObject(raw)) {\n    error(\"raw must be an object\");\n    return findings;\n  }\n\n  for (const key of Object.keys(raw)) {\n    if (!RAW_FIELDS.includes(key)) {\n      findings.push({\n        severity: \"warning\",\n        message: `raw[${JSON.stringify(key)}] is ignored: not a raw field (${RAW_FIELDS.join(\", \")})`,\n      });\n    }\n  }\n\n  const wire = isRawWireId(raw.wire) ? raw.wire : undefined;\n  if (wire === undefined) {\n    error(`raw.wire must be one of ${RAW_WIRE_IDS.join(\", \")}; got ${JSON.stringify(raw.wire)}`);\n  }\n\n  const events = raw.events;\n  if (events === undefined && raw.json === undefined) {\n    error('raw needs \"events\" (streaming), \"json\" (non-streaming), or both');\n  }\n  if (events !== undefined) {\n    if (!Array.isArray(events)) {\n      error(\"raw.events must be an array\");\n    } else {\n      if (events.length === 0) {\n        findings.push({\n          severity: \"warning\",\n          message: \"raw.events is empty; a streaming request gets no frames\",\n        });\n      }\n      // An index loop, not forEach: forEach skips the holes of a sparse array.\n      for (let i = 0; i < events.length; i++) {\n        const event: unknown = events[i];\n        if (!isPlainObject(event)) {\n          error(`raw.events[${i}] must be a JSON object`);\n          continue;\n        }\n        const problem = jsonProblem(event, `raw.events[${i}]`);\n        if (problem) {\n          error(`${problem[0]} ${problem[1]}`);\n          continue;\n        }\n        if (wire !== undefined && TYPE_NAMED_WIRES.has(wire)) {\n          if (typeof event.type !== \"string\") {\n            error(`raw.events[${i}] needs a string \"type\" on ${wire}`);\n          } else if (/[\\r\\n]/.test(event.type)) {\n            // The type is written as the SSE `event:` line; a line break\n            // would start another SSE field or frame.\n            error(`raw.events[${i}].type must not contain a line break (CR or LF) on ${wire}`);\n          }\n        }\n        if (wire === \"bedrock-converse\") {\n          const keys = Object.keys(event);\n          if (keys.length !== 1) {\n            error(\n              `raw.events[${i}] must have exactly one top-level key (the event type) on bedrock-converse`,\n            );\n          } else if (Buffer.byteLength(keys[0], \"utf8\") > EVENT_STREAM_HEADER_VALUE_MAX_BYTES) {\n            error(\n              `raw.events[${i}] has an event type key over ${EVENT_STREAM_HEADER_VALUE_MAX_BYTES} bytes, the event-stream header limit, on bedrock-converse`,\n            );\n          } else if (!isPlainObject(event[keys[0]])) {\n            error(\n              `raw.events[${i}].${keys[0]} must be a JSON object (the frame payload) on bedrock-converse`,\n            );\n          }\n        }\n      }\n    }\n  }\n\n  if (raw.status !== undefined) {\n    const status = raw.status;\n    if (typeof status !== \"number\" || !Number.isInteger(status) || status < 200 || status > 599) {\n      error(`raw.status must be an integer from 200 to 599; got ${JSON.stringify(status)}`);\n    } else if (BODYLESS_STATUSES.has(status)) {\n      error(\n        `raw.status ${status} cannot carry a body, so \"events\" and \"json\" would be dropped; use a status that allows a body`,\n      );\n    }\n  }\n\n  if (raw.headers !== undefined) {\n    if (!isPlainObject(raw.headers)) {\n      error(\"raw.headers must be an object of string values\");\n    } else {\n      for (const [name, value] of Object.entries(raw.headers)) {\n        const label = `raw.headers[${JSON.stringify(name)}]`;\n        if (typeof value !== \"string\") {\n          error(`${label} must be a string`);\n          continue;\n        }\n        try {\n          validateHeaderName(name);\n        } catch {\n          error(`${label} is not a valid header name`);\n          continue;\n        }\n        try {\n          validateHeaderValue(name, value);\n        } catch {\n          error(`${label} has an invalid header value`);\n          continue;\n        }\n        if (FORBIDDEN_HEADERS.has(name.toLowerCase())) {\n          error(`${label} is not allowed: aimock frames the body and sets this header itself`);\n        }\n      }\n    }\n  }\n\n  if (raw.done !== undefined && typeof raw.done !== \"boolean\") {\n    error(`raw.done must be a boolean; got ${JSON.stringify(raw.done)}`);\n  } else if (raw.done !== undefined && wire !== undefined && wire !== \"openai-chat\") {\n    error(\n      `raw.done applies only to openai-chat (the only wire with a [DONE] terminal), not ${wire}`,\n    );\n  }\n\n  return findings;\n}\n"],"mappings":";;;;;;;;;;;AAgBA,MAAa,eAAe;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAOD,SAAgB,YAAY,OAAoC;AAC9D,QAAO,OAAO,UAAU,YAAa,aAAmC,SAAS,MAAM;;;AAIzF,MAAM,oBAAoB,IAAI,IAAI;CAChC;CACA;CACA;CACA;CACD,CAAC;;AAGF,MAAM,mBAA2C,IAAI,IAAI;CACvD;CACA;CACA;CACD,CAAC;;AAGF,MAAM,aAAgC;CACpC;CACA;CACA;CACA;CACA;CACA;CACD;;AAGD,MAAM,oBAAyC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC;;;;;AAMlE,MAAM,sCAAsC;;AAG5C,SAAS,cAAc,OAAkD;AACvE,KAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,MAAM,QAAQ,MAAM,CAAE,QAAO;CAChF,MAAM,QAAiB,OAAO,eAAe,MAAM;AACnD,QAAO,UAAU,OAAO,aAAa,UAAU;;;;;;;AAQjD,SAAS,YACP,OACA,MACA,YAA+B,EAAE,EACH;AAC9B,KAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,OAAO,UAAU,UAAW,QAAO;AACtF,KAAI,OAAO,UAAU,SACnB,QAAO,OAAO,SAAS,MAAM,GAAG,SAAY,CAAC,MAAM,0BAA0B;AAE/E,KAAI,OAAO,UAAU,SAAU,QAAO,CAAC,MAAM,6BAA6B,OAAO,QAAQ;AACzF,KAAI,UAAU,SAAS,MAAM,CAAE,QAAO,CAAC,MAAM,0BAA0B;CACvE,MAAM,QAAQ,CAAC,GAAG,WAAW,MAAM;AACnC,KAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,OAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,OAAI,EAAE,KAAK,OAAQ,QAAO,CAAC,GAAG,KAAK,GAAG,EAAE,IAAI,uCAAuC;GACnF,MAAM,UAAU,YAAY,MAAM,IAAI,GAAG,KAAK,GAAG,EAAE,IAAI,MAAM;AAC7D,OAAI,QAAS,QAAO;;AAEtB;;AAEF,KAAI,CAAC,cAAc,MAAM,CAAE,QAAO,CAAC,MAAM,8BAA8B;AACvE,MAAK,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,MAAM,EAAE;EAC/C,MAAM,UAAU,YAAY,MAAM,GAAG,KAAK,GAAG,KAAK,UAAU,IAAI,CAAC,IAAI,MAAM;AAC3E,MAAI,QAAS,QAAO;;;;;;;;;;AAuBxB,SAAgB,iBAAiB,KAAc,UAA2B,EAAE,EAAgB;CAC1F,MAAM,WAAyB,EAAE;CACjC,MAAM,SAAS,YAAoB,SAAS,KAAK;EAAE,UAAU;EAAS;EAAS,CAAC;AAEhF,MAAK,MAAM,OAAO,QAAQ,qBAAqB,EAAE,CAC/C,OACE,+BAA+B,KAAK,UAAU,IAAI,CAAC,4CACpD;AAEH,KAAI,QAAQ,mBACV,OAAM,6CAA6C;AAGrD,KAAI,CAAC,cAAc,IAAI,EAAE;AACvB,QAAM,wBAAwB;AAC9B,SAAO;;AAGT,MAAK,MAAM,OAAO,OAAO,KAAK,IAAI,CAChC,KAAI,CAAC,WAAW,SAAS,IAAI,CAC3B,UAAS,KAAK;EACZ,UAAU;EACV,SAAS,OAAO,KAAK,UAAU,IAAI,CAAC,iCAAiC,WAAW,KAAK,KAAK,CAAC;EAC5F,CAAC;CAIN,MAAM,OAAO,YAAY,IAAI,KAAK,GAAG,IAAI,OAAO;AAChD,KAAI,SAAS,OACX,OAAM,2BAA2B,aAAa,KAAK,KAAK,CAAC,QAAQ,KAAK,UAAU,IAAI,KAAK,GAAG;CAG9F,MAAM,SAAS,IAAI;AACnB,KAAI,WAAW,UAAa,IAAI,SAAS,OACvC,OAAM,sEAAkE;AAE1E,KAAI,WAAW,OACb,KAAI,CAAC,MAAM,QAAQ,OAAO,CACxB,OAAM,8BAA8B;MAC/B;AACL,MAAI,OAAO,WAAW,EACpB,UAAS,KAAK;GACZ,UAAU;GACV,SAAS;GACV,CAAC;AAGJ,OAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;GACtC,MAAM,QAAiB,OAAO;AAC9B,OAAI,CAAC,cAAc,MAAM,EAAE;AACzB,UAAM,cAAc,EAAE,yBAAyB;AAC/C;;GAEF,MAAM,UAAU,YAAY,OAAO,cAAc,EAAE,GAAG;AACtD,OAAI,SAAS;AACX,UAAM,GAAG,QAAQ,GAAG,GAAG,QAAQ,KAAK;AACpC;;AAEF,OAAI,SAAS,UAAa,iBAAiB,IAAI,KAAK,EAClD;QAAI,OAAO,MAAM,SAAS,SACxB,OAAM,cAAc,EAAE,6BAA6B,OAAO;aACjD,SAAS,KAAK,MAAM,KAAK,CAGlC,OAAM,cAAc,EAAE,qDAAqD,OAAO;;AAGtF,OAAI,SAAS,oBAAoB;IAC/B,MAAM,OAAO,OAAO,KAAK,MAAM;AAC/B,QAAI,KAAK,WAAW,EAClB,OACE,cAAc,EAAE,4EACjB;aACQ,OAAO,WAAW,KAAK,IAAI,OAAO,GAAG,oCAC9C,OACE,cAAc,EAAE,+BAA+B,oCAAoC,4DACpF;aACQ,CAAC,cAAc,MAAM,KAAK,IAAI,CACvC,OACE,cAAc,EAAE,IAAI,KAAK,GAAG,gEAC7B;;;;AAOX,KAAI,IAAI,WAAW,QAAW;EAC5B,MAAM,SAAS,IAAI;AACnB,MAAI,OAAO,WAAW,YAAY,CAAC,OAAO,UAAU,OAAO,IAAI,SAAS,OAAO,SAAS,IACtF,OAAM,sDAAsD,KAAK,UAAU,OAAO,GAAG;WAC5E,kBAAkB,IAAI,OAAO,CACtC,OACE,cAAc,OAAO,gGACtB;;AAIL,KAAI,IAAI,YAAY,OAClB,KAAI,CAAC,cAAc,IAAI,QAAQ,CAC7B,OAAM,iDAAiD;KAEvD,MAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,IAAI,QAAQ,EAAE;EACvD,MAAM,QAAQ,eAAe,KAAK,UAAU,KAAK,CAAC;AAClD,MAAI,OAAO,UAAU,UAAU;AAC7B,SAAM,GAAG,MAAM,mBAAmB;AAClC;;AAEF,MAAI;AACF,sBAAmB,KAAK;UAClB;AACN,SAAM,GAAG,MAAM,6BAA6B;AAC5C;;AAEF,MAAI;AACF,uBAAoB,MAAM,MAAM;UAC1B;AACN,SAAM,GAAG,MAAM,8BAA8B;AAC7C;;AAEF,MAAI,kBAAkB,IAAI,KAAK,aAAa,CAAC,CAC3C,OAAM,GAAG,MAAM,qEAAqE;;AAM5F,KAAI,IAAI,SAAS,UAAa,OAAO,IAAI,SAAS,UAChD,OAAM,mCAAmC,KAAK,UAAU,IAAI,KAAK,GAAG;UAC3D,IAAI,SAAS,UAAa,SAAS,UAAa,SAAS,cAClE,OACE,oFAAoF,OACrF;AAGH,QAAO"}