@copilotkit/aimock 1.46.0 → 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":"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"}

package/dist/response/deliver.cjs

@@ -0,0 +1,144 @@
+const require_frame_loop = require('./frame-loop.cjs');
+const require_sse_writer = require('../sse-writer.cjs');
+const require_chaos = require('../chaos.cjs');
+const require_lifecycle = require('./lifecycle.cjs');
+const require_timing = require('./timing.cjs');
+
+//#region src/response/deliver.ts
+/**
+* Journal a delivery that ended early. The reason is always set: the
+* lifecycle's first cause when it fired, else {@link teardownReason} for the
+* response that is gone. When no byte of the response reached the socket
+* ({@link statusLineSent}), the status is 0, the rule the server and the
+* chaos `disconnect` apply to a torn socket. A fixture interruption
+* (`disconnectAfterMs`, `truncateAfterChunks`) keeps the status it was
+* journaled with, as base recorded it.
+*/
+function journalTeardown(entry, res, lifecycle) {
+	require_lifecycle.markInterrupted(entry, lifecycle?.reason() ?? require_lifecycle.teardownReason(res));
+	if (lifecycle?.cause() !== "fixture" && !require_lifecycle.statusLineSent(res)) entry.response.status = 0;
+}
+/**
+* Whether the response was torn down: the lifecycle fired, the response is
+* destroyed or chaos disconnected it, or the client closed the socket.
+*/
+function tornDown(res, lifecycle) {
+	const socket = require_lifecycle.requestSocket(res);
+	const gone = require_chaos.responseGoneReason(res);
+	return lifecycle?.reason() !== void 0 || gone === "client-gone" || gone === "chaos-disconnected" || !res.writableEnded && !!socket && require_lifecycle.closedByClient(socket);
+}
+/**
+* Journal a response that something else on aimock's side already answered
+* (head committed or body ended) as aimock's teardown, with the status the
+* client actually got.
+*/
+function journalAnsweredElsewhere(entry, res) {
+	require_lifecycle.markInterrupted(entry, require_lifecycle.AIMOCK_DISCONNECTED);
+	entry.response.status = require_lifecycle.statusLineSent(res) ? res.statusCode : 0;
+}
+/**
+* Whether `deliverJson` can no longer write its reply, journaling why when it
+* cannot. Torn down ({@link tornDown}): {@link journalTeardown}. Already
+* answered by something else on aimock's side (head committed or body
+* ended): writing again would throw `ERR_HTTP_HEADERS_SENT`, so it is
+* journaled by {@link journalAnsweredElsewhere}, and a body that never ended
+* is destroyed so the client does not hang.
+*/
+function journalUnwritable(entry, res, lifecycle) {
+	if (tornDown(res, lifecycle)) {
+		journalTeardown(entry, res, lifecycle);
+		return true;
+	}
+	if (res.headersSent || res.writableEnded) {
+		journalAnsweredElsewhere(entry, res);
+		if (!res.writableEnded) res.destroy();
+		return true;
+	}
+	return false;
+}
+/**
+* Deliver one streamed reply and journal how it ended. Builds the HTTP
+* lifecycle (client close + fixture interruption) and runs the frame loop on
+* it. When the loop stops early it destroys `res` (if it has not ended) and
+* marks the entry with the first cause's reason (or, when no cause fired, who
+* tore the response down). A response other code already answered (head
+* committed before the stream, or body ended) is journaled as
+* {@link deliverJson} journals it. It disposes the lifecycle on every path.
+*/
+async function deliverStream(res, entry, fixture, codec, frames, timing, opts) {
+	require_lifecycle.noteDeliveryStart(res);
+	const headSentBefore = res.headersSent;
+	const lifecycle = require_lifecycle.httpLifecycle(res, fixture, { streaming: true });
+	try {
+		if (!await require_frame_loop.runFrameLoop(require_frame_loop.httpSink(res), frames, codec, timing, {
+			lifecycle,
+			onChunkSent: lifecycle.tick,
+			status: opts?.status,
+			headers: opts?.headers
+		})) {
+			const answeredElsewhere = (headSentBefore || res.writableEnded) && !tornDown(res, lifecycle);
+			if (!res.writableEnded) res.destroy();
+			if (answeredElsewhere) journalAnsweredElsewhere(entry, res);
+			else journalTeardown(entry, res, lifecycle);
+		}
+	} finally {
+		lifecycle.dispose();
+	}
+}
+/**
+* Deliver one non-streaming JSON reply. The body is a thunk.
+*
+* On both paths it first checks {@link journalUnwritable}, before any wait. A
+* response that can no longer take the reply (torn down, or already answered)
+* is not written, the thunk is never called, and the entry is marked
+* interrupted. An already-answered response whose body never ended is
+* destroyed, so the client does not hang.
+*
+* With non-streaming timing off (the default) it then runs
+* `JSON.stringify(body())`, then `writeHead`, then `end`: the body is built
+* before anything is written, so a builder that throws leaves the response
+* unwritten.
+*
+* With timing on, it waits the non-streaming delay on the client's close
+* signal, checks {@link journalUnwritable} again (the response can be torn
+* down or answered during the wait), then runs the thunk, so a `created`
+* timestamp reflects the write time.
+*
+* Rejects with a `RangeError` when `chunkSize` is a number below 1: that is
+* a programming error, and the delay math divides by it. No user input reaches
+* it, because every caller clamps with `Math.max(1, ...)`. A user value that
+* is not a number clamps to `NaN`: the reply is still served, with a zero
+* wait when timing is on.
+*/
+async function deliverJson(res, entry, fixture, body, opts) {
+	if (opts.chunkSize < 1) throw new RangeError(`deliverJson: chunkSize must be >= 1, got ${opts.chunkSize}`);
+	const write = () => {
+		const text = JSON.stringify(body());
+		res.writeHead(opts.status ?? 200, {
+			"Content-Type": "application/json",
+			...opts.headers
+		});
+		res.end(text);
+	};
+	require_lifecycle.noteDeliveryStart(res);
+	if (journalUnwritable(entry, res, void 0)) return;
+	if (!require_timing.nonStreamingTimingEnabled(fixture, opts.surface)) {
+		write();
+		return;
+	}
+	const lifecycle = require_lifecycle.httpLifecycle(res, fixture, { streaming: false });
+	try {
+		const fixtureTimings = require_timing.nonStreamingRecordedTimings(fixture, opts.surface, opts.recordedTimings);
+		const recordedTimings = opts.duplicateId ? require_timing.extendRecordedTimings(fixtureTimings, Math.max(1, Math.ceil(opts.payloadLength / opts.chunkSize)), true) : fixtureTimings;
+		await require_sse_writer.delay(require_timing.nonStreamingDelayMs(fixture, opts.payloadLength, opts.chunkSize, recordedTimings, opts.replaySpeed), lifecycle.signal);
+		if (journalUnwritable(entry, res, lifecycle)) return;
+		write();
+	} finally {
+		lifecycle.dispose();
+	}
+}
+
+//#endregion
+exports.deliverJson = deliverJson;
+exports.deliverStream = deliverStream;
+//# sourceMappingURL=deliver.cjs.map

package/dist/response/deliver.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver.cjs","names":["teardownReason","statusLineSent","requestSocket","responseGoneReason","closedByClient","AIMOCK_DISCONNECTED","httpLifecycle","runFrameLoop","httpSink","nonStreamingTimingEnabled","nonStreamingRecordedTimings","extendRecordedTimings","delay","nonStreamingDelayMs"],"sources":["../../src/response/deliver.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type { Fixture, JournalEntry, RecordedTimings } from \"../types.js\";\nimport { delay } from \"../sse-writer.js\";\nimport { httpSink, runFrameLoop, type FrameCodec, type FrameTiming } from \"./frame-loop.js\";\nimport { responseGoneReason } from \"../chaos.js\";\nimport {\n  AIMOCK_DISCONNECTED,\n  closedByClient,\n  httpLifecycle,\n  markInterrupted,\n  noteDeliveryStart,\n  statusLineSent,\n  teardownReason,\n  requestSocket,\n  type DeliveryLifecycle,\n} from \"./lifecycle.js\";\nimport {\n  extendRecordedTimings,\n  nonStreamingDelayMs,\n  nonStreamingRecordedTimings,\n  nonStreamingTimingEnabled,\n  type NonStreamingSurface,\n} from \"./timing.js\";\n\n/** The lifecycle fields the teardown journal reads. */\ntype TeardownSource = Pick<DeliveryLifecycle, \"cause\" | \"reason\">;\n\n/**\n * Journal a delivery that ended early. The reason is always set: the\n * lifecycle's first cause when it fired, else {@link teardownReason} for the\n * response that is gone. When no byte of the response reached the socket\n * ({@link statusLineSent}), the status is 0, the rule the server and the\n * chaos `disconnect` apply to a torn socket. A fixture interruption\n * (`disconnectAfterMs`, `truncateAfterChunks`) keeps the status it was\n * journaled with, as base recorded it.\n */\nfunction journalTeardown(\n  entry: JournalEntry,\n  res: http.ServerResponse,\n  lifecycle: TeardownSource | undefined,\n): void {\n  markInterrupted(entry, lifecycle?.reason() ?? teardownReason(res));\n  if (lifecycle?.cause() !== \"fixture\" && !statusLineSent(res)) entry.response.status = 0;\n}\n\n/**\n * Whether the response was torn down: the lifecycle fired, the response is\n * destroyed or chaos disconnected it, or the client closed the socket.\n */\nfunction tornDown(res: http.ServerResponse, lifecycle: TeardownSource | undefined): boolean {\n  const socket = requestSocket(res);\n  const gone = responseGoneReason(res);\n  return (\n    lifecycle?.reason() !== undefined ||\n    gone === \"client-gone\" ||\n    gone === \"chaos-disconnected\" ||\n    (!res.writableEnded && !!socket && closedByClient(socket))\n  );\n}\n\n/**\n * Journal a response that something else on aimock's side already answered\n * (head committed or body ended) as aimock's teardown, with the status the\n * client actually got.\n */\nfunction journalAnsweredElsewhere(entry: JournalEntry, res: http.ServerResponse): void {\n  markInterrupted(entry, AIMOCK_DISCONNECTED);\n  entry.response.status = statusLineSent(res) ? res.statusCode : 0;\n}\n\n/**\n * Whether `deliverJson` can no longer write its reply, journaling why when it\n * cannot. Torn down ({@link tornDown}): {@link journalTeardown}. Already\n * answered by something else on aimock's side (head committed or body\n * ended): writing again would throw `ERR_HTTP_HEADERS_SENT`, so it is\n * journaled by {@link journalAnsweredElsewhere}, and a body that never ended\n * is destroyed so the client does not hang.\n */\nfunction journalUnwritable(\n  entry: JournalEntry,\n  res: http.ServerResponse,\n  lifecycle: TeardownSource | undefined,\n): boolean {\n  if (tornDown(res, lifecycle)) {\n    journalTeardown(entry, res, lifecycle);\n    return true;\n  }\n  if (res.headersSent || res.writableEnded) {\n    journalAnsweredElsewhere(entry, res);\n    if (!res.writableEnded) res.destroy();\n    return true;\n  }\n  return false;\n}\n\n/**\n * Deliver one streamed reply and journal how it ended. Builds the HTTP\n * lifecycle (client close + fixture interruption) and runs the frame loop on\n * it. When the loop stops early it destroys `res` (if it has not ended) and\n * marks the entry with the first cause's reason (or, when no cause fired, who\n * tore the response down). A response other code already answered (head\n * committed before the stream, or body ended) is journaled as\n * {@link deliverJson} journals it. It disposes the lifecycle on every path.\n */\nexport async function deliverStream<F>(\n  res: http.ServerResponse,\n  entry: JournalEntry,\n  fixture: Fixture,\n  codec: FrameCodec<F>,\n  frames: readonly F[],\n  timing: FrameTiming,\n  opts?: {\n    status?: number; // When set, sent with `writeHead` before the first frame (issue #549).\n    headers?: Record<string, string>; // Merged over the codec's headers (issue #549).\n  },\n): Promise<void> {\n  noteDeliveryStart(res);\n  const headSentBefore = res.headersSent;\n  const lifecycle = httpLifecycle(res, fixture, { streaming: true });\n  try {\n    const completed = await runFrameLoop(httpSink(res), frames, codec, timing, {\n      lifecycle,\n      onChunkSent: lifecycle.tick,\n      status: opts?.status,\n      headers: opts?.headers,\n    });\n    if (!completed) {\n      // Read before the destroy below, which makes any response look torn down.\n      const answeredElsewhere = (headSentBefore || res.writableEnded) && !tornDown(res, lifecycle);\n      if (!res.writableEnded) res.destroy();\n      if (answeredElsewhere) journalAnsweredElsewhere(entry, res);\n      else journalTeardown(entry, res, lifecycle);\n    }\n  } finally {\n    lifecycle.dispose();\n  }\n}\n\nexport interface DeliverJsonOptions {\n  /**\n   * Passed to `nonStreamingTimingEnabled` and `nonStreamingRecordedTimings`:\n   * OpenAI chat, or any other provider.\n   */\n  surface: NonStreamingSurface;\n  status?: number; // The response status, 200 when unset (issue #549).\n  headers?: Record<string, string>; // Merged over the JSON `Content-Type` header (issue #549).\n  /** The served payload length the wait is sized from. */\n  payloadLength: number;\n  /**\n   * The wait is sized in chunks of this many characters. Callers pass\n   * `Math.max(1, <fixture or server chunkSize>)`: 1 or more, or `NaN` for a\n   * non-numeric value. `NaN` gives a zero wait.\n   */\n  chunkSize: number;\n  recordedTimings?: RecordedTimings;\n  /** A K4 duplicate-id plan: extend the recorded gaps before sizing the wait. */\n  duplicateId?: boolean;\n  replaySpeed?: number;\n}\n\n/**\n * Deliver one non-streaming JSON reply. The body is a thunk.\n *\n * On both paths it first checks {@link journalUnwritable}, before any wait. A\n * response that can no longer take the reply (torn down, or already answered)\n * is not written, the thunk is never called, and the entry is marked\n * interrupted. An already-answered response whose body never ended is\n * destroyed, so the client does not hang.\n *\n * With non-streaming timing off (the default) it then runs\n * `JSON.stringify(body())`, then `writeHead`, then `end`: the body is built\n * before anything is written, so a builder that throws leaves the response\n * unwritten.\n *\n * With timing on, it waits the non-streaming delay on the client's close\n * signal, checks {@link journalUnwritable} again (the response can be torn\n * down or answered during the wait), then runs the thunk, so a `created`\n * timestamp reflects the write time.\n *\n * Rejects with a `RangeError` when `chunkSize` is a number below 1: that is\n * a programming error, and the delay math divides by it. No user input reaches\n * it, because every caller clamps with `Math.max(1, ...)`. A user value that\n * is not a number clamps to `NaN`: the reply is still served, with a zero\n * wait when timing is on.\n */\nexport async function deliverJson(\n  res: http.ServerResponse,\n  entry: JournalEntry,\n  fixture: Fixture,\n  body: () => unknown,\n  opts: DeliverJsonOptions,\n): Promise<void> {\n  if (opts.chunkSize < 1) {\n    throw new RangeError(`deliverJson: chunkSize must be >= 1, got ${opts.chunkSize}`);\n  }\n  const write = (): void => {\n    const text = JSON.stringify(body());\n    res.writeHead(opts.status ?? 200, { \"Content-Type\": \"application/json\", ...opts.headers });\n    res.end(text);\n  };\n  noteDeliveryStart(res);\n  // Checked before the lifecycle and the wait on both paths: a response that\n  // cannot take the reply is journaled at once, with no wait.\n  if (journalUnwritable(entry, res, undefined)) return;\n  if (!nonStreamingTimingEnabled(fixture, opts.surface)) {\n    write();\n    return;\n  }\n  const lifecycle = httpLifecycle(res, fixture, { streaming: false });\n  try {\n    const fixtureTimings = nonStreamingRecordedTimings(fixture, opts.surface, opts.recordedTimings);\n    const recordedTimings = opts.duplicateId\n      ? extendRecordedTimings(\n          fixtureTimings,\n          Math.max(1, Math.ceil(opts.payloadLength / opts.chunkSize)),\n          true,\n        )\n      : fixtureTimings;\n    await delay(\n      nonStreamingDelayMs(\n        fixture,\n        opts.payloadLength,\n        opts.chunkSize,\n        recordedTimings,\n        opts.replaySpeed,\n      ),\n      lifecycle.signal,\n    );\n    if (journalUnwritable(entry, res, lifecycle)) return;\n    write();\n  } finally {\n    lifecycle.dispose();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAoCA,SAAS,gBACP,OACA,KACA,WACM;AACN,mCAAgB,OAAO,WAAW,QAAQ,IAAIA,iCAAe,IAAI,CAAC;AAClE,KAAI,WAAW,OAAO,KAAK,aAAa,CAACC,iCAAe,IAAI,CAAE,OAAM,SAAS,SAAS;;;;;;AAOxF,SAAS,SAAS,KAA0B,WAAgD;CAC1F,MAAM,SAASC,gCAAc,IAAI;CACjC,MAAM,OAAOC,iCAAmB,IAAI;AACpC,QACE,WAAW,QAAQ,KAAK,UACxB,SAAS,iBACT,SAAS,wBACR,CAAC,IAAI,iBAAiB,CAAC,CAAC,UAAUC,iCAAe,OAAO;;;;;;;AAS7D,SAAS,yBAAyB,OAAqB,KAAgC;AACrF,mCAAgB,OAAOC,sCAAoB;AAC3C,OAAM,SAAS,SAASJ,iCAAe,IAAI,GAAG,IAAI,aAAa;;;;;;;;;;AAWjE,SAAS,kBACP,OACA,KACA,WACS;AACT,KAAI,SAAS,KAAK,UAAU,EAAE;AAC5B,kBAAgB,OAAO,KAAK,UAAU;AACtC,SAAO;;AAET,KAAI,IAAI,eAAe,IAAI,eAAe;AACxC,2BAAyB,OAAO,IAAI;AACpC,MAAI,CAAC,IAAI,cAAe,KAAI,SAAS;AACrC,SAAO;;AAET,QAAO;;;;;;;;;;;AAYT,eAAsB,cACpB,KACA,OACA,SACA,OACA,QACA,QACA,MAIe;AACf,qCAAkB,IAAI;CACtB,MAAM,iBAAiB,IAAI;CAC3B,MAAM,YAAYK,gCAAc,KAAK,SAAS,EAAE,WAAW,MAAM,CAAC;AAClE,KAAI;AAOF,MAAI,CANc,MAAMC,gCAAaC,4BAAS,IAAI,EAAE,QAAQ,OAAO,QAAQ;GACzE;GACA,aAAa,UAAU;GACvB,QAAQ,MAAM;GACd,SAAS,MAAM;GAChB,CAAC,EACc;GAEd,MAAM,qBAAqB,kBAAkB,IAAI,kBAAkB,CAAC,SAAS,KAAK,UAAU;AAC5F,OAAI,CAAC,IAAI,cAAe,KAAI,SAAS;AACrC,OAAI,kBAAmB,0BAAyB,OAAO,IAAI;OACtD,iBAAgB,OAAO,KAAK,UAAU;;WAErC;AACR,YAAU,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDvB,eAAsB,YACpB,KACA,OACA,SACA,MACA,MACe;AACf,KAAI,KAAK,YAAY,EACnB,OAAM,IAAI,WAAW,4CAA4C,KAAK,YAAY;CAEpF,MAAM,cAAoB;EACxB,MAAM,OAAO,KAAK,UAAU,MAAM,CAAC;AACnC,MAAI,UAAU,KAAK,UAAU,KAAK;GAAE,gBAAgB;GAAoB,GAAG,KAAK;GAAS,CAAC;AAC1F,MAAI,IAAI,KAAK;;AAEf,qCAAkB,IAAI;AAGtB,KAAI,kBAAkB,OAAO,KAAK,OAAU,CAAE;AAC9C,KAAI,CAACC,yCAA0B,SAAS,KAAK,QAAQ,EAAE;AACrD,SAAO;AACP;;CAEF,MAAM,YAAYH,gCAAc,KAAK,SAAS,EAAE,WAAW,OAAO,CAAC;AACnE,KAAI;EACF,MAAM,iBAAiBI,2CAA4B,SAAS,KAAK,SAAS,KAAK,gBAAgB;EAC/F,MAAM,kBAAkB,KAAK,cACzBC,qCACE,gBACA,KAAK,IAAI,GAAG,KAAK,KAAK,KAAK,gBAAgB,KAAK,UAAU,CAAC,EAC3D,KACD,GACD;AACJ,QAAMC,yBACJC,mCACE,SACA,KAAK,eACL,KAAK,WACL,iBACA,KAAK,YACN,EACD,UAAU,OACX;AACD,MAAI,kBAAkB,OAAO,KAAK,UAAU,CAAE;AAC9C,SAAO;WACC;AACR,YAAU,SAAS"}