@jshookmcp/jshook 0.3.0 → 0.3.1

package/dist/mojo-ipc-DXNEXEqb.mjs

@@ -1,640 +0,0 @@
-import { n as __require } from "./chunk-CjcI7cDX.mjs";
-import { Ut as MOJO_MONITOR_TIMEOUT_MS } from "./constants-CDZLOoVv.mjs";
-import { a as argString, r as argNumber } from "./parse-args-B4cY5Vx5.mjs";
-import { n as capabilityReport, t as capabilityFailure } from "./capabilities-CcHlvWgK.mjs";
-import "./manifest-6lNTMZAB2.mjs";
-import { execFile, spawn } from "node:child_process";
-//#region src/modules/mojo-ipc/MojoMonitor.ts
-function getDefaultInterfaces() {
-	return [
-		{
-			name: "blink.mojom.WidgetHost",
-			version: 1,
-			pendingMessages: 0
-		},
-		{
-			name: "content.mojom.FrameHost",
-			version: 2,
-			pendingMessages: 0
-		},
-		{
-			name: "network.mojom.URLLoaderFactory",
-			version: 3,
-			pendingMessages: 0
-		}
-	];
-}
-function detectFridaNpmPackage() {
-	try {
-		__require.resolve("frida");
-		return true;
-	} catch {
-		return false;
-	}
-}
-async function probeFridaCli() {
-	return new Promise((resolve) => {
-		const child = spawn("frida", ["--version"], {
-			timeout: MOJO_MONITOR_TIMEOUT_MS,
-			windowsHide: true
-		});
-		let stdout = "";
-		child.stdout?.on("data", (chunk) => {
-			stdout += chunk.toString();
-		});
-		child.on("close", (code) => {
-			if (code === 0 && stdout.trim().length > 0) {
-				resolve("frida");
-				return;
-			}
-			resolve(null);
-		});
-		child.on("error", () => {
-			resolve(null);
-		});
-	});
-}
-async function detectAvailability() {
-	const flag = process.env["JSHOOK_ENABLE_MOJO_IPC"];
-	const fridaNpm = detectFridaNpmPackage();
-	const fridaCli = await probeFridaCli();
-	const fridaAvailable = fridaNpm || fridaCli !== null;
-	if (flag === "0" || flag === "false") return {
-		available: false,
-		fridaAvailable,
-		fridaCliAvailable: fridaCli !== null,
-		reason: "Mojo IPC disabled by JSHOOK_ENABLE_MOJO_IPC=0."
-	};
-	return {
-		available: fridaAvailable,
-		fridaAvailable,
-		fridaCliAvailable: fridaCli !== null,
-		reason: fridaAvailable ? void 0 : "Mojo IPC backend is not connected. Install Frida for real IPC monitoring: https://frida.re/docs/installation/"
-	};
-}
-function matchesFilter(message, filter) {
-	if (filter.interfaceName && message.interfaceName !== filter.interfaceName) return false;
-	if (filter.messageType && message.messageType !== filter.messageType) return false;
-	if (typeof filter.pid === "number" && message.sourcePid !== filter.pid && message.targetPid !== filter.pid) return false;
-	return true;
-}
-function buildFridaScript() {
-	return `
-const messages = [];
-recv('message', () => {});
-rpc.exports = {
-  flush() {
-    return messages;
-  },
-};
-`;
-}
-var MojoMonitor = class {
-	active = false;
-	simulationMode = false;
-	fridaProbeSucceeded = false;
-	deviceId;
-	messages = [];
-	interfaces = /* @__PURE__ */ new Map();
-	observedInterfaceNames = /* @__PURE__ */ new Set();
-	availability = {
-		available: false,
-		fridaAvailable: false,
-		fridaCliAvailable: false,
-		reason: "Not yet initialized. Call start() to probe availability."
-	};
-	constructor() {
-		this.resetInterfaces();
-	}
-	isAvailable() {
-		return this.availability.available;
-	}
-	getUnavailableReason() {
-		return this.availability.reason;
-	}
-	getAvailabilitySnapshot() {
-		return { ...this.availability };
-	}
-	async probeAvailability() {
-		this.availability = await detectAvailability();
-		return this.getAvailabilitySnapshot();
-	}
-	isSimulationMode() {
-		return this.simulationMode;
-	}
-	didFridaProbeSucceed() {
-		return this.fridaProbeSucceeded;
-	}
-	setSimulationMode(enabled) {
-		this.simulationMode = enabled;
-	}
-	isActive() {
-		return this.active;
-	}
-	getDeviceId() {
-		return this.deviceId;
-	}
-	async start(deviceId) {
-		this.deviceId = deviceId;
-		this.availability = await detectAvailability();
-		this.resetInterfaces();
-		this.simulationMode = false;
-		this.fridaProbeSucceeded = false;
-		if (!this.availability.available) {
-			this.active = false;
-			return;
-		}
-		this.active = true;
-		if (this.availability.fridaCliAvailable) await this.captureWithFrida(deviceId);
-		else this.simulationMode = true;
-	}
-	async stop() {
-		this.active = false;
-		this.deviceId = void 0;
-		this.fridaProbeSucceeded = false;
-		this.resetInterfaces();
-	}
-	async captureMessages(filter = {}) {
-		if (!this.active) return [];
-		const captured = [];
-		const remaining = [];
-		for (const message of this.messages) if (matchesFilter(message, filter)) captured.push({ ...message });
-		else remaining.push(message);
-		this.messages.length = 0;
-		this.messages.push(...remaining);
-		this.recomputePendingCounts();
-		return captured;
-	}
-	async listInterfaces() {
-		return [...this.interfaces.values()].map((item) => ({
-			name: item.name,
-			version: item.version,
-			pendingMessages: item.pendingMessages
-		})).toSorted((left, right) => left.name.localeCompare(right.name));
-	}
-	hasObservedInterfaces() {
-		return this.observedInterfaceNames.size > 0;
-	}
-	getObservedInterfaceCount() {
-		return this.observedInterfaceNames.size;
-	}
-	getInterfaceCatalogSource() {
-		if (this.observedInterfaceNames.size === 0) return "seeded-defaults";
-		if (this.observedInterfaceNames.size >= this.interfaces.size) return "observed";
-		return "mixed";
-	}
-	async getMessages(options) {
-		if (!this.active) return {
-			messages: [],
-			totalAvailable: 0,
-			filtered: false,
-			simulation: this.simulationMode
-		};
-		const filter = {};
-		if (options?.interfaceName) filter.interfaceName = options.interfaceName;
-		const allMessages = await this.captureMessages(filter);
-		const limit = options?.limit ?? 100;
-		return {
-			messages: allMessages.slice(0, limit),
-			totalAvailable: allMessages.length,
-			filtered: !!options?.interfaceName,
-			simulation: this.simulationMode
-		};
-	}
-	recordMessage(message, version = 1) {
-		if (!this.active) return;
-		this.messages.push({ ...message });
-		this.observedInterfaceNames.add(message.interfaceName);
-		const existing = this.interfaces.get(message.interfaceName);
-		if (existing) {
-			existing.pendingMessages += 1;
-			return;
-		}
-		this.interfaces.set(message.interfaceName, {
-			name: message.interfaceName,
-			version,
-			pendingMessages: 1
-		});
-	}
-	async captureWithFrida(deviceId) {
-		const targetProcess = deviceId ?? "chrome";
-		const script = buildFridaScript();
-		await new Promise((resolve, reject) => {
-			execFile("frida", [
-				"-q",
-				"-n",
-				targetProcess,
-				"-l",
-				"-",
-				"--runtime=v8"
-			], {
-				timeout: MOJO_MONITOR_TIMEOUT_MS,
-				windowsHide: true
-			}, (error) => {
-				if (error) {
-					reject(error);
-					return;
-				}
-				resolve();
-			}).stdin?.end(script);
-		}).then(() => {
-			this.fridaProbeSucceeded = true;
-		}).catch(() => {
-			this.fridaProbeSucceeded = false;
-		});
-		this.simulationMode = true;
-	}
-	recomputePendingCounts() {
-		this.resetPendingCounts();
-		for (const message of this.messages) {
-			this.observedInterfaceNames.add(message.interfaceName);
-			const item = this.interfaces.get(message.interfaceName);
-			if (item) item.pendingMessages += 1;
-			else this.interfaces.set(message.interfaceName, {
-				name: message.interfaceName,
-				version: 1,
-				pendingMessages: 1
-			});
-		}
-	}
-	resetPendingCounts() {
-		for (const item of this.interfaces.values()) item.pendingMessages = 0;
-	}
-	resetInterfaces() {
-		this.messages.length = 0;
-		this.interfaces.clear();
-		this.observedInterfaceNames.clear();
-		for (const item of getDefaultInterfaces()) this.interfaces.set(item.name, { ...item });
-	}
-};
-//#endregion
-//#region src/modules/mojo-ipc/MojoDecoder.ts
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-const FIELD_TYPE_BOOL = 1;
-const FIELD_TYPE_INT32 = 6;
-const FIELD_TYPE_UINT32 = 8;
-const FIELD_TYPE_STRING = 12;
-const FIELD_TYPE_HANDLE = 16;
-function isHandleField(value) {
-	if (!isRecord(value)) return false;
-	return typeof value["handle"] === "number";
-}
-function normalizeHexInput(hex) {
-	const cleaned = hex.replace(/\s+/g, "");
-	if (cleaned.length % 2 === 0) return cleaned.toLowerCase();
-	return `0${cleaned.toLowerCase()}`;
-}
-var MojoDecoder = class {
-	decodePayload(hex, context) {
-		const raw = this.cleanHex(hex);
-		const bytes = Buffer.from(raw, "hex");
-		const version = this.readUInt8(bytes, 0);
-		const flags = this.readUInt8(bytes, 1);
-		const messageType = this.readUInt8(bytes, 2);
-		const numFields = this.readUInt8(bytes, 3);
-		const declaredHandles = this.readUInt16LE(bytes, 4);
-		const fields = {};
-		const summaryParts = [];
-		let cursor = 6;
-		let actualHandles = 0;
-		for (let index = 0; index < numFields; index += 1) {
-			if (cursor >= bytes.length) {
-				summaryParts.push("payload ended before all fields were decoded");
-				break;
-			}
-			const typeCode = this.readUInt8(bytes, cursor);
-			cursor += 1;
-			const fieldName = `field${index}`;
-			if (typeCode === FIELD_TYPE_BOOL) {
-				if (!this.hasBytes(bytes, cursor, 1)) {
-					summaryParts.push(`${fieldName} truncated`);
-					break;
-				}
-				fields[fieldName] = this.readUInt8(bytes, cursor) !== 0;
-				cursor += 1;
-				continue;
-			}
-			if (typeCode === FIELD_TYPE_INT32) {
-				if (!this.hasBytes(bytes, cursor, 4)) {
-					summaryParts.push(`${fieldName} truncated`);
-					break;
-				}
-				fields[fieldName] = bytes.readInt32LE(cursor);
-				cursor += 4;
-				continue;
-			}
-			if (typeCode === FIELD_TYPE_UINT32) {
-				if (!this.hasBytes(bytes, cursor, 4)) {
-					summaryParts.push(`${fieldName} truncated`);
-					break;
-				}
-				fields[fieldName] = bytes.readUInt32LE(cursor);
-				cursor += 4;
-				continue;
-			}
-			if (typeCode === FIELD_TYPE_STRING) {
-				if (!this.hasBytes(bytes, cursor, 2)) {
-					summaryParts.push(`${fieldName} length prefix truncated`);
-					break;
-				}
-				const length = this.readUInt16LE(bytes, cursor);
-				cursor += 2;
-				if (!this.hasBytes(bytes, cursor, length)) {
-					summaryParts.push(`${fieldName} string data truncated`);
-					break;
-				}
-				fields[fieldName] = bytes.subarray(cursor, cursor + length).toString("utf8");
-				cursor += length;
-				continue;
-			}
-			if (typeCode === FIELD_TYPE_HANDLE) {
-				if (!this.hasBytes(bytes, cursor, 4)) {
-					summaryParts.push(`${fieldName} handle truncated`);
-					break;
-				}
-				fields[fieldName] = { handle: bytes.readUInt32LE(cursor) };
-				actualHandles += 1;
-				cursor += 4;
-				continue;
-			}
-			summaryParts.push(`unknown field type 0x${typeCode.toString(16).padStart(2, "0")}`);
-			break;
-		}
-		const summary = summaryParts.length > 0 ? summaryParts.join("; ") : this.buildSummary(context, Object.keys(fields).length, numFields, actualHandles);
-		return {
-			header: {
-				version,
-				flags,
-				messageType,
-				numFields,
-				handles: declaredHandles
-			},
-			fields,
-			handles: actualHandles,
-			raw,
-			_raw_summary: summary
-		};
-	}
-	encodeMessage(interfaceName, messageType, fields) {
-		const encodedParts = [];
-		let handles = 0;
-		for (const field of fields) {
-			if (typeof field === "boolean") {
-				encodedParts.push(Buffer.from([FIELD_TYPE_BOOL, field ? 1 : 0]));
-				continue;
-			}
-			if (typeof field === "number" && Number.isInteger(field) && field >= 0) {
-				const chunk = Buffer.alloc(5);
-				chunk.writeUInt8(FIELD_TYPE_UINT32, 0);
-				chunk.writeUInt32LE(field, 1);
-				encodedParts.push(chunk);
-				continue;
-			}
-			if (typeof field === "number" && Number.isInteger(field)) {
-				const chunk = Buffer.alloc(5);
-				chunk.writeUInt8(FIELD_TYPE_INT32, 0);
-				chunk.writeInt32LE(field, 1);
-				encodedParts.push(chunk);
-				continue;
-			}
-			if (isHandleField(field)) {
-				const chunk = Buffer.alloc(5);
-				chunk.writeUInt8(FIELD_TYPE_HANDLE, 0);
-				chunk.writeUInt32LE(field.handle, 1);
-				encodedParts.push(chunk);
-				handles += 1;
-				continue;
-			}
-			const text = typeof field === "string" ? field : JSON.stringify(field);
-			const textBuffer = Buffer.from(text, "utf8");
-			const header = Buffer.alloc(3);
-			header.writeUInt8(FIELD_TYPE_STRING, 0);
-			header.writeUInt16LE(textBuffer.length, 1);
-			encodedParts.push(header, textBuffer);
-		}
-		const messageTypeCode = this.resolveMessageType(interfaceName, messageType);
-		const fieldCount = Math.min(fields.length, 255);
-		const header = Buffer.alloc(6);
-		header.writeUInt8(1, 0);
-		header.writeUInt8(0, 1);
-		header.writeUInt8(messageTypeCode, 2);
-		header.writeUInt8(fieldCount, 3);
-		header.writeUInt16LE(handles, 4);
-		return Buffer.concat([header, ...encodedParts]).toString("hex");
-	}
-	cleanHex(hex) {
-		return normalizeHexInput(hex);
-	}
-	resolveMessageType(interfaceName, messageType) {
-		if (/^[0-9]+$/.test(messageType)) return Number.parseInt(messageType, 10) & 255;
-		if (/^0x[0-9a-f]+$/i.test(messageType)) return Number.parseInt(messageType.slice(2), 16) & 255;
-		let hash = 0;
-		const seed = `${interfaceName}:${messageType}`;
-		for (const char of seed) hash = hash * 31 + char.charCodeAt(0) & 255;
-		return hash;
-	}
-	buildSummary(context, decodedFields, declaredFields, handles) {
-		return `${context ? `${context}: ` : ""}decoded ${decodedFields}/${declaredFields} fields, ${handles} handle(s)`;
-	}
-	readUInt8(bytes, offset) {
-		if (!this.hasBytes(bytes, offset, 1)) return 0;
-		return bytes.readUInt8(offset);
-	}
-	readUInt16LE(bytes, offset) {
-		if (!this.hasBytes(bytes, offset, 2)) return 0;
-		return bytes.readUInt16LE(offset);
-	}
-	hasBytes(bytes, offset, length) {
-		return offset >= 0 && length >= 0 && offset + length <= bytes.length;
-	}
-};
-//#endregion
-//#region src/server/domains/mojo-ipc/handlers.impl.ts
-function getMojoFix(reason) {
-	return reason.includes("JSHOOK_ENABLE_MOJO_IPC") ? "Unset JSHOOK_ENABLE_MOJO_IPC or set it to 1, then retry." : "Install Frida and ensure the Chromium target is running.";
-}
-function unavailablePayload(reason, tool) {
-	return {
-		...capabilityFailure(tool, "mojo_ipc_monitoring", reason, getMojoFix(reason)),
-		error: reason
-	};
-}
-const LIVE_CAPTURE_REASON = "Current Mojo IPC backend only exposes a seeded interface catalog and simulated capture. Live Chromium Mojo hooks are not implemented in this build.";
-const LIVE_CAPTURE_FIX = "No user-side fix is available in this build. Treat mojo_monitor/mojo_list_interfaces/mojo_messages_get as simulation-only until real Frida hooks are implemented.";
-function getFridaProbeSucceeded(monitor) {
-	const maybeMonitor = monitor;
-	return typeof maybeMonitor.didFridaProbeSucceed === "function" ? maybeMonitor.didFridaProbeSucceed() : false;
-}
-var MojoIPCHandlers = class {
-	constructor(monitor, decoder, eventBus) {
-		this.monitor = monitor;
-		this.decoder = decoder;
-		this.eventBus = eventBus;
-	}
-	async handleMojoMonitorDispatch(args) {
-		return String(args["action"] ?? "") === "stop" ? this.handleMojoMonitorStop() : this.handleMojoMonitorStart(args);
-	}
-	async handleMojoIpcCapabilities() {
-		const monitor = this.getMonitor();
-		const fridaProbeSucceeded = getFridaProbeSucceeded(monitor);
-		const availability = typeof monitor.probeAvailability === "function" ? await monitor.probeAvailability() : {
-			available: monitor.isAvailable(),
-			reason: monitor.getUnavailableReason(),
-			fridaAvailable: monitor.isAvailable(),
-			fridaCliAvailable: false
-		};
-		return capabilityReport("mojo_ipc_capabilities", [
-			{
-				capability: "mojo_ipc_monitoring",
-				status: availability.available ? "available" : "unavailable",
-				reason: availability.reason,
-				fix: availability.available ? void 0 : getMojoFix(availability.reason ?? ""),
-				details: {
-					tools: [
-						"mojo_monitor",
-						"mojo_list_interfaces",
-						"mojo_messages_get"
-					],
-					fridaAvailable: availability.fridaAvailable,
-					fridaCliAvailable: availability.fridaCliAvailable,
-					fridaProbeSucceeded,
-					active: monitor.isActive(),
-					simulationMode: monitor.isSimulationMode(),
-					interfaceCatalogSource: monitor.getInterfaceCatalogSource(),
-					observedInterfaceCount: monitor.getObservedInterfaceCount(),
-					liveCaptureImplemented: false
-				}
-			},
-			{
-				capability: "mojo_live_capture",
-				status: "unavailable",
-				reason: LIVE_CAPTURE_REASON,
-				fix: LIVE_CAPTURE_FIX,
-				details: {
-					tools: [
-						"mojo_monitor",
-						"mojo_list_interfaces",
-						"mojo_messages_get"
-					],
-					fridaAvailable: availability.fridaAvailable,
-					fridaCliAvailable: availability.fridaCliAvailable,
-					fridaProbeSucceeded,
-					active: monitor.isActive(),
-					simulationMode: monitor.isSimulationMode(),
-					interfaceCatalogSource: monitor.getInterfaceCatalogSource(),
-					observedInterfaceCount: monitor.getObservedInterfaceCount(),
-					fallbackMode: availability.available ? "simulation" : "none",
-					liveCaptureImplemented: false
-				}
-			},
-			{
-				capability: "mojo_payload_decode",
-				status: "available",
-				details: { tools: ["mojo_decode_message"] }
-			}
-		]);
-	}
-	async handleMojoMonitorStart(args) {
-		const monitor = this.getMonitor();
-		const deviceId = argString(args, "deviceId");
-		await monitor.start(deviceId);
-		if (!monitor.isAvailable()) return unavailablePayload(monitor.getUnavailableReason() ?? "Mojo IPC monitoring is not available", "mojo_monitor");
-		const response = {
-			success: true,
-			available: true,
-			started: monitor.isActive(),
-			deviceId: monitor.getDeviceId() ?? null,
-			simulation: monitor.isSimulationMode(),
-			interfaceCatalogSource: monitor.getInterfaceCatalogSource(),
-			observedInterfaceCount: monitor.getObservedInterfaceCount()
-		};
-		if (monitor.isSimulationMode()) response.warningMessage = "Mojo IPC monitor is running in simulation mode. Real Frida-backed message capture is not active.";
-		return response;
-	}
-	async handleMojoMonitorStop() {
-		const monitor = this.getMonitor();
-		if (!monitor.isAvailable()) return unavailablePayload(monitor.getUnavailableReason() ?? "Mojo IPC monitoring is not available", "mojo_monitor");
-		await monitor.stop();
-		return {
-			success: true,
-			available: true,
-			started: false,
-			simulation: monitor.isSimulationMode()
-		};
-	}
-	async handleMojoDecodeMessage(args) {
-		const hexPayload = argString(args, "hexPayload", "");
-		if (hexPayload.length === 0) return {
-			success: false,
-			error: "hexPayload is required"
-		};
-		return {
-			success: true,
-			decoded: this.getDecoder().decodePayload(hexPayload)
-		};
-	}
-	async handleMojoListInterfaces() {
-		const monitor = this.getMonitor();
-		if (!monitor.isAvailable()) return {
-			...unavailablePayload(monitor.getUnavailableReason() ?? "Mojo IPC monitoring is not available", "mojo_list_interfaces"),
-			interfaces: []
-		};
-		const response = {
-			success: true,
-			available: true,
-			active: monitor.isActive(),
-			interfaces: await monitor.listInterfaces(),
-			simulation: monitor.isSimulationMode(),
-			interfaceCatalogSource: monitor.getInterfaceCatalogSource(),
-			observedInterfaceCount: monitor.getObservedInterfaceCount()
-		};
-		if (monitor.getInterfaceCatalogSource() === "seeded-defaults") response.warningMessage = "Interface list currently comes from the seeded default catalog; no live observed Mojo interfaces have been captured yet.";
-		else if (monitor.isSimulationMode()) response.warningMessage = "Mojo IPC monitor is running in simulation mode. Interface counts may not reflect live traffic.";
-		return response;
-	}
-	async handleMojoMessagesGet(args) {
-		const monitor = this.getMonitor();
-		if (!monitor.isAvailable()) return {
-			...unavailablePayload(monitor.getUnavailableReason() ?? "Mojo IPC monitoring is not available", "mojo_messages_get"),
-			messages: [],
-			totalAvailable: 0,
-			filtered: false,
-			simulation: true
-		};
-		const limit = argNumber(args, "limit");
-		const interfaceName = argString(args, "interface");
-		const result = await monitor.getMessages({
-			limit: limit !== void 0 ? Math.min(limit, 1e4) : 100,
-			interfaceName
-		});
-		const response = {
-			success: true,
-			available: true,
-			active: monitor.isActive(),
-			messages: result.messages,
-			totalAvailable: result.totalAvailable,
-			filtered: result.filtered,
-			simulation: result.simulation,
-			interfaceCatalogSource: monitor.getInterfaceCatalogSource(),
-			observedInterfaceCount: monitor.getObservedInterfaceCount()
-		};
-		if (result.messages && Array.isArray(result.messages) && result.messages.length > 0) this.eventBus?.emit("mojo:message_captured", {
-			messageCount: result.messages.length,
-			timestamp: (/* @__PURE__ */ new Date()).toISOString()
-		});
-		if (monitor.isSimulationMode()) response.warningMessage = "Mojo IPC is operating in simulation mode. Messages are not captured from real Frida hooks. Install Frida for live IPC monitoring.";
-		return response;
-	}
-	getMonitor() {
-		if (!this.monitor) this.monitor = new MojoMonitor();
-		return this.monitor;
-	}
-	getDecoder() {
-		if (!this.decoder) this.decoder = new MojoDecoder();
-		return this.decoder;
-	}
-};
-//#endregion
-export { MojoIPCHandlers };