@jshookmcp/jshook 0.2.9 → 0.3.0

package/dist/{HeapAnalyzer-BLDH0dCv.mjs → HeapAnalyzer-DruMgsgj.mjs}

@@ -1,7 +1,7 @@
 import { t as logger } from "./logger-Dh_xb7_2.mjs";
-import { at as HEAP_ENUMERATE_MAX_BLOCKS, ct as HEAP_SUSPICIOUS_BLOCK_SIZE, ot as HEAP_SPRAY_SIZE_TOLERANCE, st as HEAP_SPRAY_THRESHOLD } from "./constants-B0OANIBL.mjs";
-import { b as openProcessForMemory, d as ReadProcessMemory, t as CloseHandle } from "./Win32API-CePkipZY.mjs";
-import { m as TH32CS } from "./Win32Debug-BvKs-gxc.mjs";
+import { ct as HEAP_SPRAY_THRESHOLD, lt as HEAP_SUSPICIOUS_BLOCK_SIZE, ot as HEAP_ENUMERATE_MAX_BLOCKS, st as HEAP_SPRAY_SIZE_TOLERANCE } from "./constants-CDZLOoVv.mjs";
+import { b as openProcessForMemory, d as ReadProcessMemory, t as CloseHandle } from "./Win32API-C2kjj0ze.mjs";
+import { m as TH32CS } from "./Win32Debug-CKrGOTpo.mjs";
 import koffi from "koffi";
 //#region src/native/HeapAnalyzer.types.ts
 /** Heap block flags */
@@ -25,7 +25,7 @@ const HF32 = {
 *
 * @module HeapAnalyzer
 */
-let _heapApis = null;
+let heapApisCache = null;
 function loadHeapApis() {
 	const k32 = koffi.load("kernel32.dll");
 	return {
@@ -44,8 +44,8 @@ function loadHeapApis() {
 	};
 }
 function getHeapApis() {
-	if (!_heapApis) _heapApis = loadHeapApis();
-	return _heapApis;
+	if (!heapApisCache) heapApisCache = loadHeapApis();
+	return heapApisCache;
 }
 const SIZE_RANGES = [
 	[
@@ -113,7 +113,7 @@ var HeapAnalyzer = class {
 				const processId = hlBuf.readUInt32LE(8);
 				const heapId = hlBuf.readBigUInt64LE(12);
 				const flags = hlBuf.readUInt32LE(20);
-				const blocks = await this._enumerateBlocksInternal(pid, heapId, HEAP_ENUMERATE_MAX_BLOCKS);
+				const blocks = await this.enumerateBlocksInternal(pid, heapId, HEAP_ENUMERATE_MAX_BLOCKS);
 				heaps.push({
 					heapId: `0x${heapId.toString(16)}`,
 					processId,
@@ -130,7 +130,7 @@ var HeapAnalyzer = class {
 		}
 		return {
 			heaps,
-			stats: this._computeStats(heaps, [])
+			stats: this.computeStats(heaps, [])
 		};
 	}
 	/**
@@ -139,7 +139,7 @@ var HeapAnalyzer = class {
 	async enumerateBlocks(pid, heapId, options) {
 		const id = BigInt(heapId);
 		const max = options?.maxBlocks ?? HEAP_ENUMERATE_MAX_BLOCKS;
-		return this._enumerateBlocksInternal(pid, id, max);
+		return this.enumerateBlocksInternal(pid, id, max);
 	}
 	/**
 	* Get full statistical breakdown for all heaps.
@@ -148,10 +148,10 @@ var HeapAnalyzer = class {
 		const { heaps } = await this.enumerateHeaps(pid);
 		const allBlocks = [];
 		for (const heap of heaps) {
-			const blocks = await this._enumerateBlocksInternal(pid, BigInt(heap.heapId), HEAP_ENUMERATE_MAX_BLOCKS);
+			const blocks = await this.enumerateBlocksInternal(pid, BigInt(heap.heapId), HEAP_ENUMERATE_MAX_BLOCKS);
 			allBlocks.push(...blocks);
 		}
-		return this._computeStats(heaps, allBlocks);
+		return this.computeStats(heaps, allBlocks);
 	}
 	/**
 	* Detect heap anomalies: spray, UAF heuristic, suspicious sizes.
@@ -160,14 +160,14 @@ var HeapAnalyzer = class {
 		const anomalies = [];
 		const { heaps } = await this.enumerateHeaps(pid);
 		for (const heap of heaps) {
-			const blocks = await this._enumerateBlocksInternal(pid, BigInt(heap.heapId), HEAP_ENUMERATE_MAX_BLOCKS);
-			this._detectSpray(blocks, heap.heapId, anomalies);
-			this._detectSuspiciousSizes(blocks, heap.heapId, anomalies);
-			await this._detectPossibleUAF(pid, blocks, heap.heapId, anomalies);
+			const blocks = await this.enumerateBlocksInternal(pid, BigInt(heap.heapId), HEAP_ENUMERATE_MAX_BLOCKS);
+			this.detectSpray(blocks, heap.heapId, anomalies);
+			this.detectSuspiciousSizes(blocks, heap.heapId, anomalies);
+			await this.detectPossibleUaf(pid, blocks, heap.heapId, anomalies);
 		}
 		return anomalies;
 	}
-	async _enumerateBlocksInternal(pid, heapId, maxBlocks) {
+	async enumerateBlocksInternal(pid, heapId, maxBlocks) {
 		const apis = getHeapApis();
 		const blocks = [];
 		const heBuf = Buffer.alloc(apis.HEAPENTRY32_SIZE);
@@ -189,7 +189,7 @@ var HeapAnalyzer = class {
 		}
 		return blocks;
 	}
-	_computeStats(heaps, blocks) {
+	computeStats(heaps, blocks) {
 		const buckets = SIZE_RANGES.map(([range]) => ({
 			range,
 			count: 0,
@@ -223,7 +223,7 @@ var HeapAnalyzer = class {
 			fragmentationRatio: totalSize > 0 ? freeSize / totalSize : 0
 		};
 	}
-	_detectSpray(blocks, heapId, anomalies) {
+	detectSpray(blocks, heapId, anomalies) {
 		const sizeGroups = /* @__PURE__ */ new Map();
 		for (const block of blocks) {
 			if (block.isFree) continue;
@@ -240,7 +240,7 @@ var HeapAnalyzer = class {
 			heapId
 		});
 	}
-	_detectSuspiciousSizes(blocks, heapId, anomalies) {
+	detectSuspiciousSizes(blocks, heapId, anomalies) {
 		for (const block of blocks) if (block.size === 0) anomalies.push({
 			type: "suspicious_size",
 			severity: "medium",
@@ -256,7 +256,7 @@ var HeapAnalyzer = class {
 			heapId
 		});
 	}
-	async _detectPossibleUAF(pid, blocks, heapId, anomalies) {
+	async detectPossibleUaf(pid, blocks, heapId, anomalies) {
 		const sampled = blocks.filter((b) => b.isFree && b.size >= 8).slice(0, 100);
 		let hProcess = null;
 		try {

package/dist/{HookGeneratorBuilders.core.generators.storage-CtcdK78Q.mjs → HookGeneratorBuilders.core.generators.storage-CTbB4Lcx.mjs}

@@ -1,76 +1,3 @@
-import { t as logger } from "./logger-Dh_xb7_2.mjs";
-import { W as EXTERNAL_TOOL_FORCE_KILL_GRACE_MS } from "./constants-B0OANIBL.mjs";
-//#region src/utils/ProcessRegistry.ts
-/**
-* Global singleton registry to track and safely terminate orphaned child
-* processes and worker threads upon server shutdown.
-*/
-var ProcessRegistrySingleton = class {
-	processes = /* @__PURE__ */ new Set();
-	/**
-	* Register a ChildProcess or Worker for automatic cleanup on shutdown.
-	*/
-	register(proc) {
-		if (!proc) return;
-		this.processes.add(proc);
-		if ("kill" in proc) proc.once("close", () => this.unregister(proc));
-		else if ("terminate" in proc) {
-			if (typeof proc.once === "function") proc.once("exit", () => this.unregister(proc));
-			else if (typeof proc.on === "function") proc.on("exit", () => this.unregister(proc));
-		}
-	}
-	/**
-	* Unregister a process/worker.
-	*/
-	unregister(proc) {
-		if (!proc) return;
-		this.processes.delete(proc);
-	}
-	/**
-	* Terminate all tracked processes and workers.
-	* Sends SIGTERM, then after a grace period sends SIGKILL.
-	*/
-	async terminateAll() {
-		if (this.processes.size === 0) return;
-		logger.debug(`[ProcessRegistry] Attempting to terminate ${this.processes.size} active processes/workers...`);
-		const terminationPromises = [];
-		for (const proc of this.processes) if ("terminate" in proc) terminationPromises.push(proc.terminate().then(() => {
-			this.processes.delete(proc);
-		}).catch((err) => {
-			logger.warn(`[ProcessRegistry] Error terminating worker: ${err.message}`);
-		}));
-		else if ("kill" in proc) terminationPromises.push(new Promise((resolve) => {
-			if (proc.killed || proc.exitCode !== null || proc.signalCode !== null) {
-				this.processes.delete(proc);
-				return resolve();
-			}
-			proc.kill("SIGTERM");
-			let settled = false;
-			const handleExit = () => {
-				if (settled) return;
-				settled = true;
-				this.processes.delete(proc);
-				resolve();
-			};
-			proc.once("exit", handleExit);
-			proc.once("close", handleExit);
-			setTimeout(() => {
-				if (!settled && !proc.killed && proc.exitCode === null) {
-					logger.debug(`[ProcessRegistry] Force killing child process PID ${proc.pid}`);
-					try {
-						proc.kill("SIGKILL");
-					} catch {}
-					handleExit();
-				}
-			}, EXTERNAL_TOOL_FORCE_KILL_GRACE_MS).unref();
-		}));
-		await Promise.race([Promise.all(terminationPromises), new Promise((resolve) => setTimeout(resolve, EXTERNAL_TOOL_FORCE_KILL_GRACE_MS + 1e3).unref())]);
-		this.processes.clear();
-		logger.debug(`[ProcessRegistry] Termination sweep complete.`);
-	}
-};
-const ProcessRegistry = new ProcessRegistrySingleton();
-//#endregion
 //#region src/modules/hook/HookGeneratorBuilders.core.generators.runtime.ts
 function generateFunctionHook(target, action, customCode, condition, performance = false) {
 	return `
@@ -636,4 +563,4 @@ function getInjectionInstructions(type) {
 	return `This hook script monitors ${type} operations. Inject it into the target page via page_evaluate or console_execute to activate.`;
 }
 //#endregion
-export { generateEvalHook as a, generateObjectMethodHook as c, generateAntiDebugBypass as i, ProcessRegistry as l, generateLocalStorageHook as n, generateFunctionHook as o, getInjectionInstructions as r, generateHookTemplate as s, generateCookieHook as t };
+export { generateEvalHook as a, generateObjectMethodHook as c, generateAntiDebugBypass as i, generateLocalStorageHook as n, generateFunctionHook as o, getInjectionInstructions as r, generateHookTemplate as s, generateCookieHook as t };

package/dist/{InstrumentationSession-CvPC7Jwy.mjs → InstrumentationSession-DLH0vd-z.mjs}

@@ -1,7 +1,7 @@
 //#region src/server/instrumentation/InstrumentationSession.ts
-let _nextId = 0;
+let nextId = 0;
 function uid(prefix) {
-	return `${prefix}-${Date.now().toString(36)}-${(++_nextId).toString(36)}`;
+	return `${prefix}-${Date.now().toString(36)}-${(++nextId).toString(36)}`;
 }
 function isRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);

package/dist/{MemoryController-CbVdCIJF.mjs → MemoryController-CMtviNW_.mjs}

@@ -1,6 +1,6 @@
-import { Or as WRITE_HISTORY_MAX, X as FREEZE_DEFAULT_INTERVAL_MS } from "./constants-B0OANIBL.mjs";
-import { _ as WriteProcessMemory, b as openProcessForMemory, d as ReadProcessMemory, m as VirtualProtectEx, t as CloseHandle, u as PAGE } from "./Win32API-CePkipZY.mjs";
-import { i as parsePattern } from "./NativeMemoryManager.utils-B-FjA2mJ.mjs";
+import { Vr as WRITE_HISTORY_MAX, Z as FREEZE_DEFAULT_INTERVAL_MS } from "./constants-CDZLOoVv.mjs";
+import { _ as WriteProcessMemory, b as openProcessForMemory, d as ReadProcessMemory, m as VirtualProtectEx, t as CloseHandle, u as PAGE } from "./Win32API-C2kjj0ze.mjs";
+import { i as parsePattern } from "./NativeMemoryManager.utils-BBlAixF5.mjs";
 import { randomUUID } from "node:crypto";
 //#region src/native/MemoryController.ts
 /**

package/dist/{MemoryScanSession-BsDZbLYm.mjs → MemoryScanSession-ITgb_NMi.mjs}

@@ -1,5 +1,5 @@
-import { gn as SCAN_SESSION_TTL_MS, hn as SCAN_SESSION_MAX_COUNT } from "./constants-B0OANIBL.mjs";
-import { n as parseAddress, t as formatAddress } from "./formatAddress-DVkj9kpI.mjs";
+import { Sn as SCAN_SESSION_TTL_MS, xn as SCAN_SESSION_MAX_COUNT } from "./constants-CDZLOoVv.mjs";
+import { n as parseAddress, t as formatAddress } from "./formatAddress-nnMvEohD.mjs";
 import { randomUUID } from "node:crypto";
 //#region src/native/ScanComparators.ts
 const FLOAT_EPSILON = 1e-6;

package/dist/{MemoryScanner-Bcpml6II.mjs → MemoryScanner-CiL7Z3ey.mjs}

@@ -1,9 +1,9 @@
-import { _n as SCAN_UNKNOWN_INITIAL_MAX_ADDRESSES, dn as SCAN_DISPLAY_RESULTS_LIMIT, fn as SCAN_GROUP_MAX_PATTERN_SIZE, mn as SCAN_POINTER_MAX_RESULTS, pn as SCAN_MAX_RESULTS_PER_SCAN } from "./constants-B0OANIBL.mjs";
-import { t as createPlatformProvider } from "./factory-DxlGh9Xf.mjs";
-import { i as parsePattern } from "./NativeMemoryManager.utils-B-FjA2mJ.mjs";
-import { t as nativeMemoryManager } from "./NativeMemoryManager.impl-dZtA1ZGn.mjs";
-import { n as parseAddress, t as formatAddress } from "./formatAddress-DVkj9kpI.mjs";
-import { n as getDefaultAlignment, r as getValueSize, scanSessionManager, t as compareScanValues } from "./MemoryScanSession-BsDZbLYm.mjs";
+import { Cn as SCAN_UNKNOWN_INITIAL_MAX_ADDRESSES, _n as SCAN_DISPLAY_RESULTS_LIMIT, bn as SCAN_POINTER_MAX_RESULTS, vn as SCAN_GROUP_MAX_PATTERN_SIZE, yn as SCAN_MAX_RESULTS_PER_SCAN } from "./constants-CDZLOoVv.mjs";
+import { t as createPlatformProvider } from "./factory-C90tBff6.mjs";
+import { i as parsePattern } from "./NativeMemoryManager.utils-BBlAixF5.mjs";
+import { t as nativeMemoryManager } from "./NativeMemoryManager.impl-D9Lkovvn.mjs";
+import { n as parseAddress, t as formatAddress } from "./formatAddress-nnMvEohD.mjs";
+import { n as getDefaultAlignment, r as getValueSize, scanSessionManager, t as compareScanValues } from "./MemoryScanSession-ITgb_NMi.mjs";
 //#region src/native/MemoryScanner.ts
 /**
 * Memory Scanner — orchestrates iterative scan workflows.
@@ -21,10 +21,13 @@ import { n as getDefaultAlignment, r as getValueSize, scanSessionManager, t as c
 */
 var MemoryScanner = class {
 	nmm;
-	_provider = null;
+	providerCache = null;
 	get provider() {
-		if (!this._provider) this._provider = createPlatformProvider();
-		return this._provider;
+		if (!this.providerCache) this.providerCache = createPlatformProvider();
+		return this.providerCache;
+	}
+	set provider(value) {
+		this.providerCache = value;
 	}
 	constructor(nmm) {
 		this.nmm = nmm;

package/dist/{NativeMemoryManager.impl-dZtA1ZGn.mjs → NativeMemoryManager.impl-D9Lkovvn.mjs}

@@ -1,8 +1,8 @@
 import { t as logger } from "./logger-Dh_xb7_2.mjs";
-import { v as isKoffiAvailable, y as isWindows } from "./Win32API-CePkipZY.mjs";
-import { n as cpuLimit } from "./concurrency-Bt0yv1kJ.mjs";
-import { t as createPlatformProvider } from "./factory-DxlGh9Xf.mjs";
-import { i as parsePattern, t as findPatternInBuffer } from "./NativeMemoryManager.utils-B-FjA2mJ.mjs";
+import { v as isKoffiAvailable, y as isWindows } from "./Win32API-C2kjj0ze.mjs";
+import { n as cpuLimit } from "./concurrency-Drev_Vz9.mjs";
+import { t as createPlatformProvider } from "./factory-C90tBff6.mjs";
+import { i as parsePattern, t as findPatternInBuffer } from "./NativeMemoryManager.utils-BBlAixF5.mjs";
 import { exec } from "node:child_process";
 import { promisify } from "node:util";
 //#region src/native/NativeMemoryManager.availability.ts
@@ -96,11 +96,14 @@ function scanRegionInChunks(region, patternBytes, mask, readChunk, chunkSize = S
 * Win32-only methods (injection, debug) are guarded by platform checks.
 */
 var NativeMemoryManager = class {
-	_provider = null;
+	providerCache = null;
 	/** Lazily create the platform memory provider */
 	get provider() {
-		if (!this._provider) this._provider = createPlatformProvider();
-		return this._provider;
+		if (!this.providerCache) this.providerCache = createPlatformProvider();
+		return this.providerCache;
+	}
+	set provider(value) {
+		this.providerCache = value;
 	}
 	async checkAvailability() {
 		return checkNativeMemoryAvailability(execAsync);
@@ -324,7 +327,7 @@ var NativeMemoryManager = class {
 			error: "DLL injection is only supported on Windows"
 		};
 		try {
-			const { openProcessForMemory, CloseHandle, WriteProcessMemory, VirtualAllocEx, CreateRemoteThread, GetModuleHandle, GetProcAddress, PAGE, MEM } = await import("./Win32API-CePkipZY.mjs").then((n) => n.g);
+			const { openProcessForMemory, CloseHandle, WriteProcessMemory, VirtualAllocEx, CreateRemoteThread, GetModuleHandle, GetProcAddress, PAGE, MEM } = await import("./Win32API-C2kjj0ze.mjs").then((n) => n.g);
 			const handle = openProcessForMemory(pid, true);
 			try {
 				const loadLibraryAddr = GetProcAddress(GetModuleHandle("kernel32.dll"), "LoadLibraryA");
@@ -374,7 +377,7 @@ var NativeMemoryManager = class {
 			let buffer;
 			if (encoding === "base64") buffer = Buffer.from(shellcode, "base64");
 			else buffer = Buffer.from(shellcode.replace(/\s/g, ""), "hex");
-			const { openProcessForMemory, CloseHandle, WriteProcessMemory, VirtualAllocEx, VirtualProtectEx, CreateRemoteThread, PAGE, MEM } = await import("./Win32API-CePkipZY.mjs").then((n) => n.g);
+			const { openProcessForMemory, CloseHandle, WriteProcessMemory, VirtualAllocEx, VirtualProtectEx, CreateRemoteThread, PAGE, MEM } = await import("./Win32API-C2kjj0ze.mjs").then((n) => n.g);
 			const handle = openProcessForMemory(pid, true);
 			try {
 				const remoteMem = VirtualAllocEx(handle, 0n, buffer.length, MEM.COMMIT | MEM.RESERVE, PAGE.READWRITE);
@@ -421,7 +424,7 @@ var NativeMemoryManager = class {
 			error: "Debug port check is only supported on Windows"
 		};
 		try {
-			const { openProcessForMemory, CloseHandle, NtQueryInformationProcess } = await import("./Win32API-CePkipZY.mjs").then((n) => n.g);
+			const { openProcessForMemory, CloseHandle, NtQueryInformationProcess } = await import("./Win32API-C2kjj0ze.mjs").then((n) => n.g);
 			const handle = openProcessForMemory(pid, false);
 			try {
 				const { status, debugPort } = NtQueryInformationProcess(handle, 7);

package/dist/{NativeMemoryManager.utils-B-FjA2mJ.mjs → NativeMemoryManager.utils-BBlAixF5.mjs}

@@ -1,4 +1,4 @@
-import { u as PAGE, v as isKoffiAvailable$1 } from "./Win32API-CePkipZY.mjs";
+import { u as PAGE, v as isKoffiAvailable$1 } from "./Win32API-C2kjj0ze.mjs";
 //#region src/native/NativeMemoryManager.utils.ts
 function isKoffiAvailable() {
 	return isKoffiAvailable$1();

package/dist/{PEAnalyzer-D1lzJ_VG.mjs → PEAnalyzer-DMQ44gen.mjs}

@@ -1,5 +1,5 @@
 import { t as logger } from "./logger-Dh_xb7_2.mjs";
-import { a as GetModuleFileNameEx, b as openProcessForMemory, d as ReadProcessMemory, i as GetModuleBaseName, n as EnumProcessModules, s as GetModuleInformation, t as CloseHandle } from "./Win32API-CePkipZY.mjs";
+import { a as GetModuleFileNameEx, b as openProcessForMemory, d as ReadProcessMemory, i as GetModuleBaseName, n as EnumProcessModules, s as GetModuleInformation, t as CloseHandle } from "./Win32API-C2kjj0ze.mjs";
 import { promises } from "node:fs";
 //#region src/native/PEAnalyzer.types.ts
 /** PE section characteristic flags */
@@ -104,7 +104,7 @@ var PEAnalyzer = class {
 		const base = BigInt(moduleBase);
 		const hProcess = openProcessForMemory(pid);
 		try {
-			const headers = await this._readCoreHeaders(hProcess, base);
+			const headers = await this.readCoreHeaders(hProcess, base);
 			const sections = [];
 			for (let i = 0; i < headers.numSections; i++) {
 				const off = headers.firstSectionOffset + i * SECTION_HEADER_SIZE;
@@ -138,7 +138,7 @@ var PEAnalyzer = class {
 		const base = BigInt(moduleBase);
 		const hProcess = openProcessForMemory(pid);
 		try {
-			const headers = await this._readCoreHeaders(hProcess, base);
+			const headers = await this.readCoreHeaders(hProcess, base);
 			const importRva = headers.dataDirectories[IMAGE_DIRECTORY_ENTRY.IMPORT];
 			if (!importRva || importRva.rva === 0) return [];
 			const imports = [];
@@ -151,7 +151,7 @@ var PEAnalyzer = class {
 				const nullIdx = nameData.indexOf(0);
 				const dllName = nameData.subarray(0, nullIdx > 0 ? nullIdx : 256).toString("ascii");
 				const originalFirstThunkRva = desc.readUInt32LE(0) || desc.readUInt32LE(16);
-				const functions = this._readThunkArray(hProcess, base, originalFirstThunkRva, headers.isPE32Plus);
+				const functions = this.readThunkArray(hProcess, base, originalFirstThunkRva, headers.isPE32Plus);
 				imports.push({
 					dllName,
 					functions
@@ -170,7 +170,7 @@ var PEAnalyzer = class {
 		const base = BigInt(moduleBase);
 		const hProcess = openProcessForMemory(pid);
 		try {
-			const exportDir = (await this._readCoreHeaders(hProcess, base)).dataDirectories[IMAGE_DIRECTORY_ENTRY.EXPORT];
+			const exportDir = (await this.readCoreHeaders(hProcess, base)).dataDirectories[IMAGE_DIRECTORY_ENTRY.EXPORT];
 			if (!exportDir || exportDir.rva === 0) return [];
 			const expData = ReadProcessMemory(hProcess, base + BigInt(exportDir.rva), 40);
 			const numberOfNames = expData.readUInt32LE(24);
@@ -213,7 +213,7 @@ var PEAnalyzer = class {
 		const hProcess = openProcessForMemory(pid);
 		const detections = [];
 		try {
-			const modules = this._enumerateModulesInternal(hProcess);
+			const modules = this.enumerateModulesInternal(hProcess);
 			const targets = moduleName ? modules.filter((m) => m.name.toLowerCase().includes(moduleName.toLowerCase())) : modules;
 			for (const mod of targets) try {
 				const diskData = await promises.readFile(mod.path);
@@ -222,12 +222,12 @@ var PEAnalyzer = class {
 					const funcRva = parseInt(exp.rva, 16);
 					if (funcRva === 0 || exp.forwardedTo) continue;
 					const memBytes = ReadProcessMemory(hProcess, BigInt(mod.base) + BigInt(funcRva), COMPARE_BYTES);
-					const diskOffset = this._rvaToFileOffset(diskData, funcRva);
+					const diskOffset = this.rvaToFileOffset(diskData, funcRva);
 					if (diskOffset < 0 || diskOffset + COMPARE_BYTES > diskData.length) continue;
 					const diskBytes = diskData.subarray(diskOffset, diskOffset + COMPARE_BYTES);
 					if (!memBytes.equals(diskBytes)) {
-						const hookType = this._classifyHook(memBytes);
-						const jumpTarget = this._decodeJumpTarget(memBytes, BigInt(mod.base) + BigInt(funcRva));
+						const hookType = this.classifyHook(memBytes);
+						const jumpTarget = this.decodeJumpTarget(memBytes, BigInt(mod.base) + BigInt(funcRva));
 						detections.push({
 							address: `0x${(BigInt(mod.base) + BigInt(funcRva)).toString(16)}`,
 							moduleName: mod.name,
@@ -273,7 +273,7 @@ var PEAnalyzer = class {
 		});
 		return anomalies;
 	}
-	async _readCoreHeaders(hProcess, base) {
+	async readCoreHeaders(hProcess, base) {
 		const e_lfanew = ReadProcessMemory(hProcess, base, 64).readUInt32LE(60);
 		const ntData = ReadProcessMemory(hProcess, base + BigInt(e_lfanew), 264);
 		const numSections = ntData.readUInt16LE(6);
@@ -296,7 +296,7 @@ var PEAnalyzer = class {
 			dataDirectories
 		};
 	}
-	_readThunkArray(hProcess, base, thunkRva, isPE32Plus) {
+	readThunkArray(hProcess, base, thunkRva, isPE32Plus) {
 		const thunkSize = isPE32Plus ? 8 : 4;
 		const functions = [];
 		const IMAGE_ORDINAL_FLAG = isPE32Plus ? 9223372036854775808n : 2147483648n;
@@ -326,7 +326,7 @@ var PEAnalyzer = class {
 		}
 		return functions;
 	}
-	_enumerateModulesInternal(hProcess) {
+	enumerateModulesInternal(hProcess) {
 		const modules = [];
 		try {
 			const { modules: modHandles, count } = EnumProcessModules(hProcess);
@@ -347,7 +347,7 @@ var PEAnalyzer = class {
 		}
 		return modules;
 	}
-	_rvaToFileOffset(peData, rva) {
+	rvaToFileOffset(peData, rva) {
 		const e_lfanew = peData.readUInt32LE(60);
 		const numSections = peData.readUInt16LE(e_lfanew + 6);
 		const sizeOfOptionalHeader = peData.readUInt16LE(e_lfanew + 20);
@@ -362,13 +362,13 @@ var PEAnalyzer = class {
 		}
 		return -1;
 	}
-	_classifyHook(memBytes) {
+	classifyHook(memBytes) {
 		if (memBytes[0] === 233) return "jmp_rel32";
 		if (memBytes[0] === 255 && memBytes[1] === 37) return "jmp_abs64";
 		if (memBytes[0] === 104 && memBytes[5] === 195) return "push_ret";
 		return "unknown";
 	}
-	_decodeJumpTarget(memBytes, funcAddr) {
+	decodeJumpTarget(memBytes, funcAddr) {
 		if (memBytes[0] === 233) {
 			const rel32 = memBytes.readInt32LE(1);
 			return `0x${(funcAddr + 5n + BigInt(rel32)).toString(16)}`;

package/dist/{PageController-Bqm2kZ_X.mjs → PageController-BPJNqqBN.mjs}

@@ -1,11 +1,14 @@
 import { t as logger } from "./logger-Dh_xb7_2.mjs";
-import { Kt as PAGE_FRAME_SELECTOR_TIMEOUT_MS, qt as PAGE_NETWORK_IDLE_TIMEOUT_MS } from "./constants-B0OANIBL.mjs";
+import { Jt as PAGE_NETWORK_IDLE_TIMEOUT_MS, qt as PAGE_FRAME_SELECTOR_TIMEOUT_MS } from "./constants-CDZLOoVv.mjs";
 import { setTimeout as setTimeout$1 } from "node:timers/promises";
 //#region src/modules/collector/PageController.ts
 var PageController = class {
 	constructor(collector) {
 		this.collector = collector;
 	}
+	async getBrowser() {
+		return this.collector.getBrowser();
+	}
 	hasAttachedTargetSession() {
 		return this.collector.getAttachedTargetSession() !== null;
 	}
@@ -58,11 +61,22 @@ var PageController = class {
 	}
 	async click(selector, options, frameOptions) {
 		const page = await this.collector.getActivePage();
-		await (await this.resolveFrame(page, frameOptions)).click(selector, {
+		const context = await this.resolveFrame(page, frameOptions);
+		const timeout = options?.timeout;
+		const clickOptions = {
 			button: options?.button || "left",
 			clickCount: options?.clickCount || 1,
 			delay: options?.delay
-		});
+		};
+		if (options?.offset) clickOptions.offset = options.offset;
+		if (typeof timeout === "number" && Number.isFinite(timeout) && timeout > 0) {
+			page.setDefaultTimeout(timeout);
+			try {
+				await context.click(selector, clickOptions);
+			} finally {
+				page.setDefaultTimeout(this.collector["config"]?.timeout ?? 3e4);
+			}
+		} else await context.click(selector, clickOptions);
 		logger.info(`Clicked: ${selector}${frameOptions?.frameUrl || frameOptions?.frameSelector ? " (in frame)" : ""}`);
 	}
 	async type(selector, text, options, frameOptions) {
@@ -168,7 +182,7 @@ var PageController = class {
 		return page.frames().map((frame) => ({
 			url: frame.url(),
 			name: frame.name() || "",
-			id: frame._id || "",
+			id: frame["_id"] || "",
 			isMainFrame: frame === mainFrame
 		}));
 	}

package/dist/{PointerChainEngine-BOhyVsjx.mjs → PointerChainEngine-K7wN8Z-w.mjs}

@@ -1,7 +1,7 @@
-import { Jt as POINTER_CHAIN_MAX_DEPTH, Xt as POINTER_CHAIN_MAX_RESULTS, Yt as POINTER_CHAIN_MAX_OFFSET, Zt as POINTER_CHAIN_SCAN_CHUNK_SIZE } from "./constants-B0OANIBL.mjs";
-import { t as createPlatformProvider } from "./factory-DxlGh9Xf.mjs";
-import { t as nativeMemoryManager } from "./NativeMemoryManager.impl-dZtA1ZGn.mjs";
-import { n as parseAddress, t as formatAddress } from "./formatAddress-DVkj9kpI.mjs";
+import { Qt as POINTER_CHAIN_SCAN_CHUNK_SIZE, Xt as POINTER_CHAIN_MAX_OFFSET, Yt as POINTER_CHAIN_MAX_DEPTH, Zt as POINTER_CHAIN_MAX_RESULTS } from "./constants-CDZLOoVv.mjs";
+import { t as createPlatformProvider } from "./factory-C90tBff6.mjs";
+import { t as nativeMemoryManager } from "./NativeMemoryManager.impl-D9Lkovvn.mjs";
+import { n as parseAddress, t as formatAddress } from "./formatAddress-nnMvEohD.mjs";
 import { randomUUID } from "node:crypto";
 //#region src/native/PointerChainEngine.ts
 /**
@@ -15,10 +15,13 @@ import { randomUUID } from "node:crypto";
 * @module PointerChainEngine
 */
 var PointerChainEngine = class {
-	_provider = null;
+	providerCache = null;
 	get provider() {
-		if (!this._provider) this._provider = createPlatformProvider();
-		return this._provider;
+		if (!this.providerCache) this.providerCache = createPlatformProvider();
+		return this.providerCache;
+	}
+	set provider(value) {
+		this.providerCache = value;
 	}
 	/**
 	* Multi-level BFS pointer scan.

package/dist/ProcessRegistry-zGg12QbE.mjs

@@ -0,0 +1,74 @@
+import { t as logger } from "./logger-Dh_xb7_2.mjs";
+import { G as EXTERNAL_TOOL_FORCE_KILL_GRACE_MS } from "./constants-CDZLOoVv.mjs";
+//#region src/utils/ProcessRegistry.ts
+/**
+* Global singleton registry to track and safely terminate orphaned child
+* processes and worker threads upon server shutdown.
+*/
+var ProcessRegistrySingleton = class {
+	processes = /* @__PURE__ */ new Set();
+	/**
+	* Register a ChildProcess or Worker for automatic cleanup on shutdown.
+	*/
+	register(proc) {
+		if (!proc) return;
+		this.processes.add(proc);
+		if ("kill" in proc) proc.once("close", () => this.unregister(proc));
+		else if ("terminate" in proc) {
+			if (typeof proc.once === "function") proc.once("exit", () => this.unregister(proc));
+			else if (typeof proc.on === "function") proc.on("exit", () => this.unregister(proc));
+		}
+	}
+	/**
+	* Unregister a process/worker.
+	*/
+	unregister(proc) {
+		if (!proc) return;
+		this.processes.delete(proc);
+	}
+	/**
+	* Terminate all tracked processes and workers.
+	* Sends SIGTERM, then after a grace period sends SIGKILL.
+	*/
+	async terminateAll() {
+		if (this.processes.size === 0) return;
+		logger.debug(`[ProcessRegistry] Attempting to terminate ${this.processes.size} active processes/workers...`);
+		const terminationPromises = [];
+		for (const proc of this.processes) if ("terminate" in proc) terminationPromises.push(proc.terminate().then(() => {
+			this.processes.delete(proc);
+		}).catch((err) => {
+			logger.warn(`[ProcessRegistry] Error terminating worker: ${err.message}`);
+		}));
+		else if ("kill" in proc) terminationPromises.push(new Promise((resolve) => {
+			if (proc.killed || proc.exitCode !== null || proc.signalCode !== null) {
+				this.processes.delete(proc);
+				return resolve();
+			}
+			proc.kill("SIGTERM");
+			let settled = false;
+			const handleExit = () => {
+				if (settled) return;
+				settled = true;
+				this.processes.delete(proc);
+				resolve();
+			};
+			proc.once("exit", handleExit);
+			proc.once("close", handleExit);
+			setTimeout(() => {
+				if (!settled && !proc.killed && proc.exitCode === null) {
+					logger.debug(`[ProcessRegistry] Force killing child process PID ${proc.pid}`);
+					try {
+						proc.kill("SIGKILL");
+					} catch {}
+					handleExit();
+				}
+			}, EXTERNAL_TOOL_FORCE_KILL_GRACE_MS).unref();
+		}));
+		await Promise.race([Promise.all(terminationPromises), new Promise((resolve) => setTimeout(resolve, EXTERNAL_TOOL_FORCE_KILL_GRACE_MS + 1e3).unref())]);
+		this.processes.clear();
+		logger.debug(`[ProcessRegistry] Termination sweep complete.`);
+	}
+};
+const ProcessRegistry = new ProcessRegistrySingleton();
+//#endregion
+export { ProcessRegistry as t };