@copilotkit/aimock 1.7.0

package/dist/vector-types.d.ts

@@ -0,0 +1,32 @@
+//#region src/vector-types.d.ts
+interface VectorMockOptions {
+  port?: number;
+  host?: string;
+}
+interface VectorCollection {
+  name: string;
+  dimension: number;
+  vectors: Map<string, VectorEntry>;
+}
+interface VectorEntry {
+  id: string;
+  values: number[];
+  metadata?: Record<string, unknown>;
+}
+interface QueryResult {
+  id: string;
+  score: number;
+  metadata?: Record<string, unknown>;
+  values?: number[];
+}
+interface VectorQuery {
+  vector?: number[];
+  topK?: number;
+  filter?: unknown;
+  collection: string;
+}
+type QueryHandler = QueryResult[] | ((query: VectorQuery) => QueryResult[]);
+//# sourceMappingURL=vector-types.d.ts.map
+//#endregion
+export { QueryHandler, QueryResult, VectorCollection, VectorEntry, VectorMockOptions, VectorQuery };
+//# sourceMappingURL=vector-types.d.ts.map

package/dist/vector-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-types.d.ts","names":[],"sources":["../src/vector-types.ts"],"sourcesContent":[],"mappings":";UAAiB,iBAAA;EAAA,IAAA,CAAA,EAAA,MAAA;EAKA,IAAA,CAAA,EAAA,MAAA;;AAGM,UAHN,gBAAA,CAGM;MAAZ,EAAA,MAAA;EAAG,SAAA,EAAA,MAAA;EAGG,OAAA,EAHN,GAGM,CAAA,MAAW,EAHL,WAMJ,CAAA;AAGnB;AAOiB,UAbA,WAAA,CAaW;EAOhB,EAAA,EAAA,MAAA;EAAY,MAAA,EAAA,MAAA,EAAA;UAAG,CAAA,EAjBd,MAiBc,CAAA,MAAA,EAAA,OAAA,CAAA;;AAAyC,UAdnD,WAAA,CAcmD;EAAW,EAAA,EAAA,MAAA;;aAXlE;;;UAII,WAAA;;;;;;KAOL,YAAA,GAAe,yBAAyB,gBAAgB"}

package/dist/watcher.cjs

@@ -0,0 +1,59 @@
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+let node_fs = require("node:fs");
+
+//#region src/watcher.ts
+const DEBOUNCE_MS = 500;
+function watchFixtures(fixturePath, fixtures, loadFn, opts) {
+	const { logger, validate, validateFn } = opts;
+	let debounceTimer = null;
+	function reload() {
+		logger.info(`File changed — reloading fixtures from ${fixturePath}...`);
+		let newFixtures;
+		try {
+			newFixtures = loadFn();
+		} catch (err) {
+			logger.error("Failed to reload fixtures:", err);
+			logger.error("Previous fixtures remain active. Fix the error and save again to retry.");
+			return;
+		}
+		if (newFixtures.length === 0 && fixtures.length > 0) {
+			logger.warn("Reload produced 0 fixtures — keeping previous fixtures. Check fixture file for errors.");
+			return;
+		}
+		if (validate && validateFn) {
+			const results = validateFn(newFixtures);
+			const errors = results.filter((r) => r.severity === "error");
+			const warnings = results.filter((r) => r.severity === "warning");
+			for (const w of warnings) logger.warn(`Fixture ${w.fixtureIndex}: ${w.message}`);
+			if (errors.length > 0) {
+				for (const e of errors) logger.error(`Fixture ${e.fixtureIndex}: ${e.message}`);
+				logger.error(`${errors.length} validation error(s) — keeping previous fixtures`);
+				return;
+			}
+		}
+		fixtures.length = 0;
+		fixtures.push(...newFixtures);
+		logger.info(`Reloaded ${newFixtures.length} fixture(s)`);
+	}
+	const watcher = (0, node_fs.watch)(fixturePath, { recursive: true }, () => {
+		if (debounceTimer) clearTimeout(debounceTimer);
+		debounceTimer = setTimeout(reload, DEBOUNCE_MS);
+	});
+	watcher.on("error", (err) => {
+		if (debounceTimer) clearTimeout(debounceTimer);
+		debounceTimer = null;
+		try {
+			watcher.close();
+		} catch {}
+		logger.error(`File watcher error on ${fixturePath}: ${err.message}`);
+		logger.error("Fixture auto-reload is no longer active. Restart the server to resume watching.");
+	});
+	return { close() {
+		if (debounceTimer) clearTimeout(debounceTimer);
+		watcher.close();
+	} };
+}
+
+//#endregion
+exports.watchFixtures = watchFixtures;
+//# sourceMappingURL=watcher.cjs.map

package/dist/watcher.cjs.map

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

package/dist/watcher.js

@@ -0,0 +1,58 @@
+import { watch } from "node:fs";
+
+//#region src/watcher.ts
+const DEBOUNCE_MS = 500;
+function watchFixtures(fixturePath, fixtures, loadFn, opts) {
+	const { logger, validate, validateFn } = opts;
+	let debounceTimer = null;
+	function reload() {
+		logger.info(`File changed — reloading fixtures from ${fixturePath}...`);
+		let newFixtures;
+		try {
+			newFixtures = loadFn();
+		} catch (err) {
+			logger.error("Failed to reload fixtures:", err);
+			logger.error("Previous fixtures remain active. Fix the error and save again to retry.");
+			return;
+		}
+		if (newFixtures.length === 0 && fixtures.length > 0) {
+			logger.warn("Reload produced 0 fixtures — keeping previous fixtures. Check fixture file for errors.");
+			return;
+		}
+		if (validate && validateFn) {
+			const results = validateFn(newFixtures);
+			const errors = results.filter((r) => r.severity === "error");
+			const warnings = results.filter((r) => r.severity === "warning");
+			for (const w of warnings) logger.warn(`Fixture ${w.fixtureIndex}: ${w.message}`);
+			if (errors.length > 0) {
+				for (const e of errors) logger.error(`Fixture ${e.fixtureIndex}: ${e.message}`);
+				logger.error(`${errors.length} validation error(s) — keeping previous fixtures`);
+				return;
+			}
+		}
+		fixtures.length = 0;
+		fixtures.push(...newFixtures);
+		logger.info(`Reloaded ${newFixtures.length} fixture(s)`);
+	}
+	const watcher = watch(fixturePath, { recursive: true }, () => {
+		if (debounceTimer) clearTimeout(debounceTimer);
+		debounceTimer = setTimeout(reload, DEBOUNCE_MS);
+	});
+	watcher.on("error", (err) => {
+		if (debounceTimer) clearTimeout(debounceTimer);
+		debounceTimer = null;
+		try {
+			watcher.close();
+		} catch {}
+		logger.error(`File watcher error on ${fixturePath}: ${err.message}`);
+		logger.error("Fixture auto-reload is no longer active. Restart the server to resume watching.");
+	});
+	return { close() {
+		if (debounceTimer) clearTimeout(debounceTimer);
+		watcher.close();
+	} };
+}
+
+//#endregion
+export { watchFixtures };
+//# sourceMappingURL=watcher.js.map

package/dist/watcher.js.map

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

package/dist/ws-framing.cjs

@@ -0,0 +1,187 @@
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+let node_crypto = require("node:crypto");
+let node_events = require("node:events");
+
+//#region src/ws-framing.ts
+/**
+* Minimal RFC 6455 WebSocket server implementation.
+*
+* Zero dependencies — uses only Node.js builtins (node:crypto, node:events).
+* Supports text frames, ping/pong, close handshake, and client frame unmasking.
+* Designed for a mock server — no extensions, no binary frames, no compression.
+*/
+const WS_GUID = "258EAFA5-E914-47DA-95CA-5AB5DC799C07";
+const OP_CONTINUATION = 0;
+const OP_TEXT = 1;
+const OP_CLOSE = 8;
+const OP_PING = 9;
+const OP_PONG = 10;
+var WebSocketConnection = class extends node_events.EventEmitter {
+	socket;
+	buffer = Buffer.alloc(0);
+	closed = false;
+	fragments = [];
+	constructor(socket) {
+		super();
+		this.socket = socket;
+		socket.on("data", (data) => {
+			this.buffer = Buffer.concat([this.buffer, data]);
+			this.parseFrames();
+		});
+		socket.on("close", () => {
+			if (!this.closed) {
+				this.closed = true;
+				this.emit("close", 1006, "Connection lost");
+			}
+		});
+		socket.on("error", (err) => {
+			this.emit("error", err);
+		});
+	}
+	send(data) {
+		if (this.closed) return;
+		const payload = Buffer.from(data, "utf-8");
+		this.writeFrame(OP_TEXT, payload);
+	}
+	close(code = 1e3, reason = "") {
+		if (this.closed) return;
+		this.closed = true;
+		const reasonBuf = Buffer.from(reason, "utf-8");
+		const payload = Buffer.alloc(2 + reasonBuf.length);
+		payload.writeUInt16BE(code, 0);
+		reasonBuf.copy(payload, 2);
+		this.writeFrame(OP_CLOSE, payload);
+		setTimeout(() => {
+			if (!this.socket.destroyed) this.socket.destroy();
+			this.emit("close", code, reason);
+		}, 100);
+	}
+	destroy() {
+		if (this.closed) return;
+		this.closed = true;
+		if (!this.socket.destroyed) this.socket.destroy();
+		this.emit("close", 1006, "Connection destroyed");
+	}
+	get isClosed() {
+		return this.closed;
+	}
+	writeFrame(opcode, payload) {
+		if (this.socket.destroyed) return;
+		const length = payload.length;
+		let header;
+		if (length < 126) {
+			header = Buffer.alloc(2);
+			header[0] = 128 | opcode;
+			header[1] = length;
+		} else if (length < 65536) {
+			header = Buffer.alloc(4);
+			header[0] = 128 | opcode;
+			header[1] = 126;
+			header.writeUInt16BE(length, 2);
+		} else {
+			header = Buffer.alloc(10);
+			header[0] = 128 | opcode;
+			header[1] = 127;
+			header.writeUInt32BE(0, 2);
+			header.writeUInt32BE(length, 6);
+		}
+		try {
+			this.socket.write(Buffer.concat([header, payload]));
+		} catch (err) {
+			if (!this.socket.destroyed) {
+				const msg = err instanceof Error ? err.message : String(err);
+				console.error(`[LLMock] Unexpected writeFrame error: ${msg}`);
+			}
+		}
+	}
+	parseFrames() {
+		while (this.buffer.length >= 2 && !this.closed) {
+			const byte0 = this.buffer[0];
+			const byte1 = this.buffer[1];
+			const fin = (byte0 & 128) !== 0;
+			const opcode = byte0 & 15;
+			const masked = (byte1 & 128) !== 0;
+			let payloadLength = byte1 & 127;
+			let offset = 2;
+			if (payloadLength === 126) {
+				if (this.buffer.length < 4) return;
+				payloadLength = this.buffer.readUInt16BE(2);
+				offset = 4;
+			} else if (payloadLength === 127) {
+				if (this.buffer.length < 10) return;
+				payloadLength = this.buffer.readUInt32BE(6) + this.buffer.readUInt32BE(2) * 4294967296;
+				offset = 10;
+			}
+			const totalFrameSize = offset + (masked ? 4 : 0) + payloadLength;
+			if (this.buffer.length < totalFrameSize) return;
+			let maskKey = null;
+			if (masked) {
+				maskKey = this.buffer.subarray(offset, offset + 4);
+				offset += 4;
+			}
+			let payload = this.buffer.subarray(offset, offset + payloadLength);
+			if (maskKey) {
+				payload = Buffer.from(payload);
+				for (let i = 0; i < payload.length; i++) payload[i] ^= maskKey[i % 4];
+			}
+			this.buffer = this.buffer.subarray(totalFrameSize);
+			this.handleFrame(fin, opcode, payload);
+		}
+	}
+	handleFrame(fin, opcode, payload) {
+		if (opcode === OP_PING) {
+			this.writeFrame(OP_PONG, payload);
+			return;
+		}
+		if (opcode === OP_PONG) return;
+		if (opcode === OP_CLOSE) {
+			const code = payload.length >= 2 ? payload.readUInt16BE(0) : 1005;
+			const reason = payload.length > 2 ? payload.subarray(2).toString("utf-8") : "";
+			if (!this.closed) {
+				this.closed = true;
+				this.writeFrame(OP_CLOSE, payload);
+				this.socket.end();
+				this.emit("close", code, reason);
+			}
+			return;
+		}
+		if (opcode === OP_TEXT || opcode === OP_CONTINUATION) {
+			this.fragments.push(payload);
+			if (fin) {
+				const message = Buffer.concat(this.fragments).toString("utf-8");
+				this.fragments = [];
+				this.emit("message", message);
+			}
+			return;
+		}
+	}
+};
+function computeAcceptKey(wsKey) {
+	return (0, node_crypto.createHash)("sha1").update(wsKey + WS_GUID).digest("base64");
+}
+function upgradeToWebSocket(req, socket) {
+	const key = req.headers["sec-websocket-key"];
+	if (!key) {
+		socket.write("HTTP/1.1 400 Bad Request\r\n\r\n");
+		socket.destroy();
+		throw new Error("Missing Sec-WebSocket-Key header");
+	}
+	let responseHeaders = `HTTP/1.1 101 Switching Protocols\r
+Upgrade: websocket\r
+Connection: Upgrade\r
+Sec-WebSocket-Accept: ${computeAcceptKey(key)}\r\n`;
+	const protocol = req.headers["sec-websocket-protocol"];
+	if (protocol) {
+		const first = protocol.split(",")[0].trim();
+		responseHeaders += `Sec-WebSocket-Protocol: ${first}\r\n`;
+	}
+	responseHeaders += "\r\n";
+	socket.write(responseHeaders);
+	return new WebSocketConnection(socket);
+}
+
+//#endregion
+exports.WebSocketConnection = WebSocketConnection;
+exports.computeAcceptKey = computeAcceptKey;
+exports.upgradeToWebSocket = upgradeToWebSocket;
+//# sourceMappingURL=ws-framing.cjs.map

package/dist/ws-framing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-framing.cjs","names":["EventEmitter"],"sources":["../src/ws-framing.ts"],"sourcesContent":["/**\n * Minimal RFC 6455 WebSocket server implementation.\n *\n * Zero dependencies — uses only Node.js builtins (node:crypto, node:events).\n * Supports text frames, ping/pong, close handshake, and client frame unmasking.\n * Designed for a mock server — no extensions, no binary frames, no compression.\n */\n\nimport { createHash } from \"node:crypto\";\nimport { EventEmitter } from \"node:events\";\nimport type * as net from \"node:net\";\nimport type * as http from \"node:http\";\n\nconst WS_GUID = \"258EAFA5-E914-47DA-95CA-5AB5DC799C07\";\n\n// Opcodes\nconst OP_CONTINUATION = 0x0;\nconst OP_TEXT = 0x1;\nconst OP_CLOSE = 0x8;\nconst OP_PING = 0x9;\nconst OP_PONG = 0xa;\n\nexport class WebSocketConnection extends EventEmitter {\n  private socket: net.Socket;\n  private buffer: Buffer = Buffer.alloc(0);\n  private closed = false;\n\n  // For fragmented messages (continuation frames)\n  private fragments: Buffer[] = [];\n\n  constructor(socket: net.Socket) {\n    super();\n    this.socket = socket;\n\n    socket.on(\"data\", (data: Buffer) => {\n      this.buffer = Buffer.concat([this.buffer, data]);\n      this.parseFrames();\n    });\n\n    socket.on(\"close\", () => {\n      if (!this.closed) {\n        this.closed = true;\n        this.emit(\"close\", 1006, \"Connection lost\");\n      }\n    });\n\n    socket.on(\"error\", (err: Error) => {\n      this.emit(\"error\", err);\n    });\n  }\n\n  send(data: string): void {\n    if (this.closed) return;\n    const payload = Buffer.from(data, \"utf-8\");\n    this.writeFrame(OP_TEXT, payload);\n  }\n\n  close(code = 1000, reason = \"\"): void {\n    if (this.closed) return;\n    this.closed = true;\n\n    const reasonBuf = Buffer.from(reason, \"utf-8\");\n    const payload = Buffer.alloc(2 + reasonBuf.length);\n    payload.writeUInt16BE(code, 0);\n    reasonBuf.copy(payload, 2);\n    this.writeFrame(OP_CLOSE, payload);\n\n    // Give the client a moment to receive the close frame before destroying.\n    // If writeFrame failed (socket already destroyed), this is a no-op.\n    setTimeout(() => {\n      if (!this.socket.destroyed) {\n        this.socket.destroy();\n      }\n      // Emit close event for server-initiated closes so listeners\n      // (e.g. activeConnections.delete) always fire.\n      this.emit(\"close\", code, reason);\n    }, 100);\n  }\n\n  destroy(): void {\n    if (this.closed) return;\n    this.closed = true;\n    if (!this.socket.destroyed) {\n      this.socket.destroy();\n    }\n    this.emit(\"close\", 1006, \"Connection destroyed\");\n  }\n\n  get isClosed(): boolean {\n    return this.closed;\n  }\n\n  private writeFrame(opcode: number, payload: Buffer): void {\n    if (this.socket.destroyed) return;\n\n    // Server-to-client frames are NOT masked (per RFC 6455 §5.1)\n    const length = payload.length;\n    let header: Buffer;\n\n    if (length < 126) {\n      header = Buffer.alloc(2);\n      header[0] = 0x80 | opcode; // FIN + opcode\n      header[1] = length;\n    } else if (length < 65536) {\n      header = Buffer.alloc(4);\n      header[0] = 0x80 | opcode;\n      header[1] = 126;\n      header.writeUInt16BE(length, 2);\n    } else {\n      header = Buffer.alloc(10);\n      header[0] = 0x80 | opcode;\n      header[1] = 127;\n      header.writeUInt32BE(0, 2);\n      header.writeUInt32BE(length, 6);\n    }\n\n    try {\n      this.socket.write(Buffer.concat([header, payload]));\n    } catch (err: unknown) {\n      // Expected when socket is destroyed between our check and write.\n      // Log unexpected errors so they don't vanish silently.\n      if (!this.socket.destroyed) {\n        const msg = err instanceof Error ? err.message : String(err);\n        console.error(`[LLMock] Unexpected writeFrame error: ${msg}`);\n      }\n    }\n  }\n\n  private parseFrames(): void {\n    while (this.buffer.length >= 2 && !this.closed) {\n      const byte0 = this.buffer[0];\n      const byte1 = this.buffer[1];\n\n      const fin = (byte0 & 0x80) !== 0;\n      const opcode = byte0 & 0x0f;\n      const masked = (byte1 & 0x80) !== 0;\n      let payloadLength = byte1 & 0x7f;\n      let offset = 2;\n\n      if (payloadLength === 126) {\n        if (this.buffer.length < 4) return; // need more data\n        payloadLength = this.buffer.readUInt16BE(2);\n        offset = 4;\n      } else if (payloadLength === 127) {\n        if (this.buffer.length < 10) return;\n        // Read lower 32 bits (upper 32 should be 0 for reasonable payloads)\n        payloadLength = this.buffer.readUInt32BE(6) + this.buffer.readUInt32BE(2) * 0x100000000;\n        offset = 10;\n      }\n\n      const maskSize = masked ? 4 : 0;\n      const totalFrameSize = offset + maskSize + payloadLength;\n\n      if (this.buffer.length < totalFrameSize) return; // need more data\n\n      let maskKey: Buffer | null = null;\n      if (masked) {\n        maskKey = this.buffer.subarray(offset, offset + 4);\n        offset += 4;\n      }\n\n      let payload = this.buffer.subarray(offset, offset + payloadLength);\n\n      // Unmask client payload\n      if (maskKey) {\n        payload = Buffer.from(payload); // copy before mutating\n        for (let i = 0; i < payload.length; i++) {\n          payload[i] ^= maskKey[i % 4];\n        }\n      }\n\n      // Consume the frame from the buffer\n      this.buffer = this.buffer.subarray(totalFrameSize);\n\n      this.handleFrame(fin, opcode, payload);\n    }\n  }\n\n  private handleFrame(fin: boolean, opcode: number, payload: Buffer): void {\n    // Control frames (opcode >= 0x8) must not be fragmented\n    if (opcode === OP_PING) {\n      this.writeFrame(OP_PONG, payload);\n      return;\n    }\n\n    if (opcode === OP_PONG) {\n      // Ignore unsolicited pongs\n      return;\n    }\n\n    if (opcode === OP_CLOSE) {\n      const code = payload.length >= 2 ? payload.readUInt16BE(0) : 1005;\n      const reason = payload.length > 2 ? payload.subarray(2).toString(\"utf-8\") : \"\";\n\n      if (!this.closed) {\n        this.closed = true;\n        // Echo close frame back\n        this.writeFrame(OP_CLOSE, payload);\n        this.socket.end();\n        this.emit(\"close\", code, reason);\n      }\n      // If already closed (server-initiated or duplicate), ignore — the\n      // close event was already emitted by close() or the first OP_CLOSE.\n      return;\n    }\n\n    // Text or continuation frames\n    if (opcode === OP_TEXT || opcode === OP_CONTINUATION) {\n      this.fragments.push(payload);\n\n      if (fin) {\n        const message = Buffer.concat(this.fragments).toString(\"utf-8\");\n        this.fragments = [];\n        this.emit(\"message\", message);\n      }\n      // If !fin, wait for more continuation frames\n      return;\n    }\n\n    // Binary or unknown — just ignore for a mock server\n  }\n}\n\nexport function computeAcceptKey(wsKey: string): string {\n  return createHash(\"sha1\")\n    .update(wsKey + WS_GUID)\n    .digest(\"base64\");\n}\n\nexport function upgradeToWebSocket(\n  req: http.IncomingMessage,\n  socket: net.Socket,\n): WebSocketConnection {\n  const key = req.headers[\"sec-websocket-key\"];\n  if (!key) {\n    socket.write(\"HTTP/1.1 400 Bad Request\\r\\n\\r\\n\");\n    socket.destroy();\n    throw new Error(\"Missing Sec-WebSocket-Key header\");\n  }\n\n  const acceptKey = computeAcceptKey(key);\n\n  let responseHeaders =\n    \"HTTP/1.1 101 Switching Protocols\\r\\n\" +\n    \"Upgrade: websocket\\r\\n\" +\n    \"Connection: Upgrade\\r\\n\" +\n    `Sec-WebSocket-Accept: ${acceptKey}\\r\\n`;\n\n  // Echo back requested subprotocol if present\n  const protocol = req.headers[\"sec-websocket-protocol\"];\n  if (protocol) {\n    // Take the first offered protocol\n    const first = protocol.split(\",\")[0].trim();\n    responseHeaders += `Sec-WebSocket-Protocol: ${first}\\r\\n`;\n  }\n\n  responseHeaders += \"\\r\\n\";\n\n  socket.write(responseHeaders);\n\n  return new WebSocketConnection(socket);\n}\n"],"mappings":"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"}

package/dist/ws-framing.d.cts

@@ -0,0 +1,26 @@
+import * as http from "node:http";
+import * as net from "node:net";
+import { EventEmitter } from "node:events";
+
+//#region src/ws-framing.d.ts
+
+declare class WebSocketConnection extends EventEmitter {
+  private socket;
+  private buffer;
+  private closed;
+  private fragments;
+  constructor(socket: net.Socket);
+  send(data: string): void;
+  close(code?: number, reason?: string): void;
+  destroy(): void;
+  get isClosed(): boolean;
+  private writeFrame;
+  private parseFrames;
+  private handleFrame;
+}
+declare function computeAcceptKey(wsKey: string): string;
+declare function upgradeToWebSocket(req: http.IncomingMessage, socket: net.Socket): WebSocketConnection;
+//# sourceMappingURL=ws-framing.d.ts.map
+//#endregion
+export { WebSocketConnection, computeAcceptKey, upgradeToWebSocket };
+//# sourceMappingURL=ws-framing.d.cts.map

package/dist/ws-framing.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-framing.d.cts","names":[],"sources":["../src/ws-framing.ts"],"sourcesContent":[],"mappings":";;;;;;AA+NgB,cAzMH,mBAAA,SAA4B,YAAA,CAyMT;EAMhB,QAAA,MAAA;EAAkB,QAAA,MAAA;UACtB,MAAA;UACE,SAAA;aACX,CAAA,MAAA,EA1MmB,GAAA,CAAI,MA0MvB;EAAmB,IAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAAA,IAAA;;;;;;;;iBATN,gBAAA;iBAMA,kBAAA,MACT,IAAA,CAAK,yBACF,GAAA,CAAI,SACX"}

package/dist/ws-framing.d.ts

@@ -0,0 +1,26 @@
+import * as http from "node:http";
+import { EventEmitter } from "node:events";
+import * as net from "node:net";
+
+//#region src/ws-framing.d.ts
+
+declare class WebSocketConnection extends EventEmitter {
+  private socket;
+  private buffer;
+  private closed;
+  private fragments;
+  constructor(socket: net.Socket);
+  send(data: string): void;
+  close(code?: number, reason?: string): void;
+  destroy(): void;
+  get isClosed(): boolean;
+  private writeFrame;
+  private parseFrames;
+  private handleFrame;
+}
+declare function computeAcceptKey(wsKey: string): string;
+declare function upgradeToWebSocket(req: http.IncomingMessage, socket: net.Socket): WebSocketConnection;
+//# sourceMappingURL=ws-framing.d.ts.map
+//#endregion
+export { WebSocketConnection, computeAcceptKey, upgradeToWebSocket };
+//# sourceMappingURL=ws-framing.d.ts.map

package/dist/ws-framing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-framing.d.ts","names":[],"sources":["../src/ws-framing.ts"],"sourcesContent":[],"mappings":";;;;;;AA+NgB,cAzMH,mBAAA,SAA4B,YAAA,CAyMT;EAMhB,QAAA,MAAA;EAAkB,QAAA,MAAA;UACtB,MAAA;UACE,SAAA;aACX,CAAA,MAAA,EA1MmB,GAAA,CAAI,MA0MvB;EAAmB,IAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAAA,IAAA;;;;;;;;iBATN,gBAAA;iBAMA,kBAAA,MACT,IAAA,CAAK,yBACF,GAAA,CAAI,SACX"}

package/dist/ws-framing.js

@@ -0,0 +1,184 @@
+import { createHash } from "node:crypto";
+import { EventEmitter } from "node:events";
+
+//#region src/ws-framing.ts
+/**
+* Minimal RFC 6455 WebSocket server implementation.
+*
+* Zero dependencies — uses only Node.js builtins (node:crypto, node:events).
+* Supports text frames, ping/pong, close handshake, and client frame unmasking.
+* Designed for a mock server — no extensions, no binary frames, no compression.
+*/
+const WS_GUID = "258EAFA5-E914-47DA-95CA-5AB5DC799C07";
+const OP_CONTINUATION = 0;
+const OP_TEXT = 1;
+const OP_CLOSE = 8;
+const OP_PING = 9;
+const OP_PONG = 10;
+var WebSocketConnection = class extends EventEmitter {
+	socket;
+	buffer = Buffer.alloc(0);
+	closed = false;
+	fragments = [];
+	constructor(socket) {
+		super();
+		this.socket = socket;
+		socket.on("data", (data) => {
+			this.buffer = Buffer.concat([this.buffer, data]);
+			this.parseFrames();
+		});
+		socket.on("close", () => {
+			if (!this.closed) {
+				this.closed = true;
+				this.emit("close", 1006, "Connection lost");
+			}
+		});
+		socket.on("error", (err) => {
+			this.emit("error", err);
+		});
+	}
+	send(data) {
+		if (this.closed) return;
+		const payload = Buffer.from(data, "utf-8");
+		this.writeFrame(OP_TEXT, payload);
+	}
+	close(code = 1e3, reason = "") {
+		if (this.closed) return;
+		this.closed = true;
+		const reasonBuf = Buffer.from(reason, "utf-8");
+		const payload = Buffer.alloc(2 + reasonBuf.length);
+		payload.writeUInt16BE(code, 0);
+		reasonBuf.copy(payload, 2);
+		this.writeFrame(OP_CLOSE, payload);
+		setTimeout(() => {
+			if (!this.socket.destroyed) this.socket.destroy();
+			this.emit("close", code, reason);
+		}, 100);
+	}
+	destroy() {
+		if (this.closed) return;
+		this.closed = true;
+		if (!this.socket.destroyed) this.socket.destroy();
+		this.emit("close", 1006, "Connection destroyed");
+	}
+	get isClosed() {
+		return this.closed;
+	}
+	writeFrame(opcode, payload) {
+		if (this.socket.destroyed) return;
+		const length = payload.length;
+		let header;
+		if (length < 126) {
+			header = Buffer.alloc(2);
+			header[0] = 128 | opcode;
+			header[1] = length;
+		} else if (length < 65536) {
+			header = Buffer.alloc(4);
+			header[0] = 128 | opcode;
+			header[1] = 126;
+			header.writeUInt16BE(length, 2);
+		} else {
+			header = Buffer.alloc(10);
+			header[0] = 128 | opcode;
+			header[1] = 127;
+			header.writeUInt32BE(0, 2);
+			header.writeUInt32BE(length, 6);
+		}
+		try {
+			this.socket.write(Buffer.concat([header, payload]));
+		} catch (err) {
+			if (!this.socket.destroyed) {
+				const msg = err instanceof Error ? err.message : String(err);
+				console.error(`[LLMock] Unexpected writeFrame error: ${msg}`);
+			}
+		}
+	}
+	parseFrames() {
+		while (this.buffer.length >= 2 && !this.closed) {
+			const byte0 = this.buffer[0];
+			const byte1 = this.buffer[1];
+			const fin = (byte0 & 128) !== 0;
+			const opcode = byte0 & 15;
+			const masked = (byte1 & 128) !== 0;
+			let payloadLength = byte1 & 127;
+			let offset = 2;
+			if (payloadLength === 126) {
+				if (this.buffer.length < 4) return;
+				payloadLength = this.buffer.readUInt16BE(2);
+				offset = 4;
+			} else if (payloadLength === 127) {
+				if (this.buffer.length < 10) return;
+				payloadLength = this.buffer.readUInt32BE(6) + this.buffer.readUInt32BE(2) * 4294967296;
+				offset = 10;
+			}
+			const totalFrameSize = offset + (masked ? 4 : 0) + payloadLength;
+			if (this.buffer.length < totalFrameSize) return;
+			let maskKey = null;
+			if (masked) {
+				maskKey = this.buffer.subarray(offset, offset + 4);
+				offset += 4;
+			}
+			let payload = this.buffer.subarray(offset, offset + payloadLength);
+			if (maskKey) {
+				payload = Buffer.from(payload);
+				for (let i = 0; i < payload.length; i++) payload[i] ^= maskKey[i % 4];
+			}
+			this.buffer = this.buffer.subarray(totalFrameSize);
+			this.handleFrame(fin, opcode, payload);
+		}
+	}
+	handleFrame(fin, opcode, payload) {
+		if (opcode === OP_PING) {
+			this.writeFrame(OP_PONG, payload);
+			return;
+		}
+		if (opcode === OP_PONG) return;
+		if (opcode === OP_CLOSE) {
+			const code = payload.length >= 2 ? payload.readUInt16BE(0) : 1005;
+			const reason = payload.length > 2 ? payload.subarray(2).toString("utf-8") : "";
+			if (!this.closed) {
+				this.closed = true;
+				this.writeFrame(OP_CLOSE, payload);
+				this.socket.end();
+				this.emit("close", code, reason);
+			}
+			return;
+		}
+		if (opcode === OP_TEXT || opcode === OP_CONTINUATION) {
+			this.fragments.push(payload);
+			if (fin) {
+				const message = Buffer.concat(this.fragments).toString("utf-8");
+				this.fragments = [];
+				this.emit("message", message);
+			}
+			return;
+		}
+	}
+};
+function computeAcceptKey(wsKey) {
+	return createHash("sha1").update(wsKey + WS_GUID).digest("base64");
+}
+function upgradeToWebSocket(req, socket) {
+	const key = req.headers["sec-websocket-key"];
+	if (!key) {
+		socket.write("HTTP/1.1 400 Bad Request\r\n\r\n");
+		socket.destroy();
+		throw new Error("Missing Sec-WebSocket-Key header");
+	}
+	let responseHeaders = `HTTP/1.1 101 Switching Protocols\r
+Upgrade: websocket\r
+Connection: Upgrade\r
+Sec-WebSocket-Accept: ${computeAcceptKey(key)}\r\n`;
+	const protocol = req.headers["sec-websocket-protocol"];
+	if (protocol) {
+		const first = protocol.split(",")[0].trim();
+		responseHeaders += `Sec-WebSocket-Protocol: ${first}\r\n`;
+	}
+	responseHeaders += "\r\n";
+	socket.write(responseHeaders);
+	return new WebSocketConnection(socket);
+}
+
+//#endregion
+export { WebSocketConnection, computeAcceptKey, upgradeToWebSocket };
+//# sourceMappingURL=ws-framing.js.map

package/dist/ws-framing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-framing.js","names":[],"sources":["../src/ws-framing.ts"],"sourcesContent":["/**\n * Minimal RFC 6455 WebSocket server implementation.\n *\n * Zero dependencies — uses only Node.js builtins (node:crypto, node:events).\n * Supports text frames, ping/pong, close handshake, and client frame unmasking.\n * Designed for a mock server — no extensions, no binary frames, no compression.\n */\n\nimport { createHash } from \"node:crypto\";\nimport { EventEmitter } from \"node:events\";\nimport type * as net from \"node:net\";\nimport type * as http from \"node:http\";\n\nconst WS_GUID = \"258EAFA5-E914-47DA-95CA-5AB5DC799C07\";\n\n// Opcodes\nconst OP_CONTINUATION = 0x0;\nconst OP_TEXT = 0x1;\nconst OP_CLOSE = 0x8;\nconst OP_PING = 0x9;\nconst OP_PONG = 0xa;\n\nexport class WebSocketConnection extends EventEmitter {\n  private socket: net.Socket;\n  private buffer: Buffer = Buffer.alloc(0);\n  private closed = false;\n\n  // For fragmented messages (continuation frames)\n  private fragments: Buffer[] = [];\n\n  constructor(socket: net.Socket) {\n    super();\n    this.socket = socket;\n\n    socket.on(\"data\", (data: Buffer) => {\n      this.buffer = Buffer.concat([this.buffer, data]);\n      this.parseFrames();\n    });\n\n    socket.on(\"close\", () => {\n      if (!this.closed) {\n        this.closed = true;\n        this.emit(\"close\", 1006, \"Connection lost\");\n      }\n    });\n\n    socket.on(\"error\", (err: Error) => {\n      this.emit(\"error\", err);\n    });\n  }\n\n  send(data: string): void {\n    if (this.closed) return;\n    const payload = Buffer.from(data, \"utf-8\");\n    this.writeFrame(OP_TEXT, payload);\n  }\n\n  close(code = 1000, reason = \"\"): void {\n    if (this.closed) return;\n    this.closed = true;\n\n    const reasonBuf = Buffer.from(reason, \"utf-8\");\n    const payload = Buffer.alloc(2 + reasonBuf.length);\n    payload.writeUInt16BE(code, 0);\n    reasonBuf.copy(payload, 2);\n    this.writeFrame(OP_CLOSE, payload);\n\n    // Give the client a moment to receive the close frame before destroying.\n    // If writeFrame failed (socket already destroyed), this is a no-op.\n    setTimeout(() => {\n      if (!this.socket.destroyed) {\n        this.socket.destroy();\n      }\n      // Emit close event for server-initiated closes so listeners\n      // (e.g. activeConnections.delete) always fire.\n      this.emit(\"close\", code, reason);\n    }, 100);\n  }\n\n  destroy(): void {\n    if (this.closed) return;\n    this.closed = true;\n    if (!this.socket.destroyed) {\n      this.socket.destroy();\n    }\n    this.emit(\"close\", 1006, \"Connection destroyed\");\n  }\n\n  get isClosed(): boolean {\n    return this.closed;\n  }\n\n  private writeFrame(opcode: number, payload: Buffer): void {\n    if (this.socket.destroyed) return;\n\n    // Server-to-client frames are NOT masked (per RFC 6455 §5.1)\n    const length = payload.length;\n    let header: Buffer;\n\n    if (length < 126) {\n      header = Buffer.alloc(2);\n      header[0] = 0x80 | opcode; // FIN + opcode\n      header[1] = length;\n    } else if (length < 65536) {\n      header = Buffer.alloc(4);\n      header[0] = 0x80 | opcode;\n      header[1] = 126;\n      header.writeUInt16BE(length, 2);\n    } else {\n      header = Buffer.alloc(10);\n      header[0] = 0x80 | opcode;\n      header[1] = 127;\n      header.writeUInt32BE(0, 2);\n      header.writeUInt32BE(length, 6);\n    }\n\n    try {\n      this.socket.write(Buffer.concat([header, payload]));\n    } catch (err: unknown) {\n      // Expected when socket is destroyed between our check and write.\n      // Log unexpected errors so they don't vanish silently.\n      if (!this.socket.destroyed) {\n        const msg = err instanceof Error ? err.message : String(err);\n        console.error(`[LLMock] Unexpected writeFrame error: ${msg}`);\n      }\n    }\n  }\n\n  private parseFrames(): void {\n    while (this.buffer.length >= 2 && !this.closed) {\n      const byte0 = this.buffer[0];\n      const byte1 = this.buffer[1];\n\n      const fin = (byte0 & 0x80) !== 0;\n      const opcode = byte0 & 0x0f;\n      const masked = (byte1 & 0x80) !== 0;\n      let payloadLength = byte1 & 0x7f;\n      let offset = 2;\n\n      if (payloadLength === 126) {\n        if (this.buffer.length < 4) return; // need more data\n        payloadLength = this.buffer.readUInt16BE(2);\n        offset = 4;\n      } else if (payloadLength === 127) {\n        if (this.buffer.length < 10) return;\n        // Read lower 32 bits (upper 32 should be 0 for reasonable payloads)\n        payloadLength = this.buffer.readUInt32BE(6) + this.buffer.readUInt32BE(2) * 0x100000000;\n        offset = 10;\n      }\n\n      const maskSize = masked ? 4 : 0;\n      const totalFrameSize = offset + maskSize + payloadLength;\n\n      if (this.buffer.length < totalFrameSize) return; // need more data\n\n      let maskKey: Buffer | null = null;\n      if (masked) {\n        maskKey = this.buffer.subarray(offset, offset + 4);\n        offset += 4;\n      }\n\n      let payload = this.buffer.subarray(offset, offset + payloadLength);\n\n      // Unmask client payload\n      if (maskKey) {\n        payload = Buffer.from(payload); // copy before mutating\n        for (let i = 0; i < payload.length; i++) {\n          payload[i] ^= maskKey[i % 4];\n        }\n      }\n\n      // Consume the frame from the buffer\n      this.buffer = this.buffer.subarray(totalFrameSize);\n\n      this.handleFrame(fin, opcode, payload);\n    }\n  }\n\n  private handleFrame(fin: boolean, opcode: number, payload: Buffer): void {\n    // Control frames (opcode >= 0x8) must not be fragmented\n    if (opcode === OP_PING) {\n      this.writeFrame(OP_PONG, payload);\n      return;\n    }\n\n    if (opcode === OP_PONG) {\n      // Ignore unsolicited pongs\n      return;\n    }\n\n    if (opcode === OP_CLOSE) {\n      const code = payload.length >= 2 ? payload.readUInt16BE(0) : 1005;\n      const reason = payload.length > 2 ? payload.subarray(2).toString(\"utf-8\") : \"\";\n\n      if (!this.closed) {\n        this.closed = true;\n        // Echo close frame back\n        this.writeFrame(OP_CLOSE, payload);\n        this.socket.end();\n        this.emit(\"close\", code, reason);\n      }\n      // If already closed (server-initiated or duplicate), ignore — the\n      // close event was already emitted by close() or the first OP_CLOSE.\n      return;\n    }\n\n    // Text or continuation frames\n    if (opcode === OP_TEXT || opcode === OP_CONTINUATION) {\n      this.fragments.push(payload);\n\n      if (fin) {\n        const message = Buffer.concat(this.fragments).toString(\"utf-8\");\n        this.fragments = [];\n        this.emit(\"message\", message);\n      }\n      // If !fin, wait for more continuation frames\n      return;\n    }\n\n    // Binary or unknown — just ignore for a mock server\n  }\n}\n\nexport function computeAcceptKey(wsKey: string): string {\n  return createHash(\"sha1\")\n    .update(wsKey + WS_GUID)\n    .digest(\"base64\");\n}\n\nexport function upgradeToWebSocket(\n  req: http.IncomingMessage,\n  socket: net.Socket,\n): WebSocketConnection {\n  const key = req.headers[\"sec-websocket-key\"];\n  if (!key) {\n    socket.write(\"HTTP/1.1 400 Bad Request\\r\\n\\r\\n\");\n    socket.destroy();\n    throw new Error(\"Missing Sec-WebSocket-Key header\");\n  }\n\n  const acceptKey = computeAcceptKey(key);\n\n  let responseHeaders =\n    \"HTTP/1.1 101 Switching Protocols\\r\\n\" +\n    \"Upgrade: websocket\\r\\n\" +\n    \"Connection: Upgrade\\r\\n\" +\n    `Sec-WebSocket-Accept: ${acceptKey}\\r\\n`;\n\n  // Echo back requested subprotocol if present\n  const protocol = req.headers[\"sec-websocket-protocol\"];\n  if (protocol) {\n    // Take the first offered protocol\n    const first = protocol.split(\",\")[0].trim();\n    responseHeaders += `Sec-WebSocket-Protocol: ${first}\\r\\n`;\n  }\n\n  responseHeaders += \"\\r\\n\";\n\n  socket.write(responseHeaders);\n\n  return new WebSocketConnection(socket);\n}\n"],"mappings":"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"}