@cheatron/native 1.1.0 → 1.2.0

package/dist/native-fn.js

@@ -0,0 +1,212 @@
+import { ffi, MsvcrtImpl as msvcrt, MemoryProtection, MemoryState, MemoryFreeType, } from '@cheatron/native-bindings';
+import { KeystoneX86 } from '@cheatron/keystone';
+import { log } from './logger';
+const nfLog = log.child('NativeFn');
+/** Registry for automatic cleanup of memory pages */
+const registry = new FinalizationRegistry((page) => {
+    if (page) {
+        // Lazy require to avoid circular dependencies
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { currentProcess } = require('./process');
+        // Free the allocated memory using currentProcess.free
+        try {
+            const success = currentProcess.free(page, 0, MemoryFreeType.RELEASE);
+            if (success) {
+                nfLog.info('Garbage collection: cleaned up executable memory page');
+            }
+            else {
+                nfLog.error('Garbage collection: currentProcess.free returned false during cleanup');
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            nfLog.error(`Garbage collection: cleanup failed: ${message}`);
+        }
+    }
+});
+export const ALIGN = 16;
+/**
+ * Rounds a number up to the nearest multiple of 16.
+ */
+export function align16(n) {
+    return (n + ALIGN - 1) & ~(ALIGN - 1);
+}
+/**
+ * Dynamically creates callable native functions from assembly or bytecode.
+ *
+ * Functions are written into a single VirtualAlloc'd executable page and
+ * exposed as callable methods on the instance via koffi.
+ */
+export class NativeFunctionCreator {
+    page;
+    pageAddr;
+    offset = 0;
+    capacity;
+    ks;
+    functions = new Map();
+    constructor(capacity = 8192) {
+        this.capacity = capacity;
+        this.ks = new KeystoneX86();
+        // Lazy require to avoid circular dependencies
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { currentProcess } = require('./process');
+        // Allocate executable memory using currentProcess.alloc
+        this.page = currentProcess.alloc(BigInt(capacity), null, MemoryState.COMMIT | MemoryState.RESERVE, MemoryProtection.EXECUTE_READWRITE);
+        if (!this.page) {
+            throw new Error('VirtualAlloc failed: could not allocate executable memory');
+        }
+        // Register for automatic cleanup. Use 'this' as the unregister token.
+        registry.register(this, this.page, this);
+        this.pageAddr = ffi.address(this.page);
+        nfLog.info(`Allocated ${capacity} bytes of executable memory at 0x${this.pageAddr.toString(16).toUpperCase()}`);
+    }
+    /**
+     * Add a native function from assembly source code.
+     * @param def Function definition { name: [returnType, [paramTypes...]] }
+     * @param asmSource x86-64 assembly instructions
+     * @returns Address of the function
+     */
+    add(def, asmSource) {
+        const name = Object.keys(def)[0];
+        if (!name) {
+            throw new Error('Invalid function definition: name is missing');
+        }
+        const sig = def[name];
+        if (!sig) {
+            throw new Error(`Invalid function definition: signature is missing for '${name}'`);
+        }
+        const funcAddr = this.pageAddr + BigInt(this.offset);
+        const bytes = this.ks.asm(asmSource, funcAddr);
+        return this._writeAndBind(name, sig, bytes);
+    }
+    /**
+     * Add a native function from raw bytecode.
+     * @param def Function definition { name: [returnType, [paramTypes...]] }
+     * @param bytes Raw machine code bytes
+     * @returns Address of the function
+     */
+    addBytes(def, bytes) {
+        const name = Object.keys(def)[0];
+        if (!name) {
+            throw new Error('Invalid function definition: name is missing');
+        }
+        const sig = def[name];
+        if (!sig) {
+            throw new Error(`Invalid function definition: signature is missing for '${name}'`);
+        }
+        return this._writeAndBind(name, sig, bytes);
+    }
+    /**
+     * Get the address of a registered function by name.
+     */
+    getAddress(name) {
+        return this.functions.get(name)?.address;
+    }
+    /**
+     * Get the callable function by name.
+     */
+    // eslint-disable-next-line no-unused-vars
+    getFunction(name) {
+        return this.functions.get(name)?.callable;
+    }
+    /**
+     * Get info about all registered functions.
+     */
+    list() {
+        return [...this.functions.values()];
+    }
+    /**
+     * Get remaining capacity in bytes.
+     */
+    get remaining() {
+        return this.capacity - this.offset;
+    }
+    /**
+     * Free the executable memory page.
+     */
+    destroy() {
+        if (this.page) {
+            // Unregister from finalizer as we are doing manual cleanup
+            registry.unregister(this);
+            // Lazy require to avoid circular dependencies
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { currentProcess } = require('./process');
+            // Perform the actual free using currentProcess.free
+            const success = currentProcess.free(this.page, 0, MemoryFreeType.RELEASE);
+            if (success) {
+                nfLog.info('NativeFunctionCreator destroyed');
+            }
+            else {
+                nfLog.warn('currentProcess.free failed during NativeFunctionCreator destruction');
+            }
+            this.page = null;
+            this.functions.clear();
+        }
+    }
+    // ── Internal ──────────────────────────────────────────────
+    _writeAndBind(name, sig, bytes) {
+        if (this.functions.has(name)) {
+            throw new Error(`Function '${name}' already registered`);
+        }
+        const alignedSize = align16(bytes.length);
+        if (this.offset + alignedSize > this.capacity) {
+            throw new Error(`Not enough space: need ${alignedSize} bytes, ${this.remaining} remaining`);
+        }
+        const funcOffset = this.offset;
+        const funcAddr = this.pageAddr + BigInt(funcOffset);
+        // Write bytecode into executable page
+        const buf = Buffer.from(bytes);
+        msvcrt.memcpy(funcAddr, buf, BigInt(bytes.length));
+        nfLog.debug(`Written '${name}' (${bytes.length} bytes) at 0x${funcAddr.toString(16).toUpperCase()} [offset: ${funcOffset}]`);
+        // Advance offset (aligned)
+        this.offset += alignedSize;
+        // Create koffi prototype
+        const [retType, paramTypes] = sig;
+        const protoName = `__nf_${name}_${Date.now()}`;
+        const paramStr = paramTypes.map((t, i) => `${t} p${i}`).join(', ');
+        const protoStr = `${retType} ${protoName}(${paramStr})`;
+        const proto = ffi.proto(protoStr);
+        // Decode function pointer from base page + offset
+        // koffi.decode(ptr, type, offset) offsets from the base external pointer
+        const callable = ffi.decode(this.page, proto, funcOffset);
+        // Bind as method on this instance
+        Object.defineProperty(this, name, {
+            enumerable: true,
+            configurable: true,
+            value: callable,
+        });
+        // Track
+        const entry = {
+            name,
+            address: funcAddr,
+            size: bytes.length,
+            sig,
+            callable,
+        };
+        this.functions.set(name, entry);
+        return funcAddr;
+    }
+}
+/**
+ * Global shared NativeFunctionCreator instance.
+ * Lazy initialized to prevent circular dependency issues during module load.
+ */
+let _nativeFn;
+export const nativeFn = new Proxy({}, {
+    get(_target, prop) {
+        if (!_nativeFn) {
+            _nativeFn = new NativeFunctionCreator();
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const val = _nativeFn[prop];
+        // Don't bind non-functions or constructor
+        if (typeof val === 'function' && prop !== 'constructor') {
+            return val.bind(_nativeFn);
+        }
+        return val;
+    },
+    getPrototypeOf() {
+        return NativeFunctionCreator.prototype;
+    },
+});
+//# sourceMappingURL=native-fn.js.map

package/dist/native-fn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-fn.js","sourceRoot":"","sources":["../src/native-fn.ts"],"names":[],"mappings":"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"}

package/dist/pattern.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Represents a parsed memory signature/pattern
+ */
+export declare class Pattern {
+    bytes: Buffer;
+    mask: string;
+    limit: number;
+    /**
+     * @param signature Pattern string (e.g. "55 8B EC ?? 56")
+     * @param limit Maximum number of results to find (0 = no limit)
+     */
+    constructor(signature: string, limit?: number);
+    get length(): number;
+}
+//# sourceMappingURL=pattern.d.ts.map

package/dist/pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern.d.ts","sourceRoot":"","sources":["../src/pattern.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,qBAAa,OAAO;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IAErB;;;OAGG;gBACS,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU;IAyBhD,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/dist/pattern.js

@@ -0,0 +1,41 @@
+import { log } from './logger';
+const scanLog = log.child('Scanner');
+/**
+ * Represents a parsed memory signature/pattern
+ */
+export class Pattern {
+    bytes;
+    mask;
+    limit;
+    /**
+     * @param signature Pattern string (e.g. "55 8B EC ?? 56")
+     * @param limit Maximum number of results to find (0 = no limit)
+     */
+    constructor(signature, limit = 0) {
+        this.limit = limit;
+        const parts = signature.split(/\s+/).filter(Boolean);
+        const bytes = [];
+        let mask = '';
+        for (const part of parts) {
+            if (part === '??' || part === '?') {
+                bytes.push(0);
+                mask += '?';
+            }
+            else {
+                const byte = parseInt(part, 16);
+                if (isNaN(byte)) {
+                    throw new Error(`Invalid byte in signature: ${part}`);
+                }
+                bytes.push(byte);
+                mask += 'x';
+            }
+        }
+        this.bytes = Buffer.from(bytes);
+        this.mask = mask;
+        scanLog.debug(`Parsed pattern: ${signature} -> ${mask}`);
+    }
+    get length() {
+        return this.bytes.length;
+    }
+}
+//# sourceMappingURL=pattern.js.map

package/dist/pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern.js","sourceRoot":"","sources":["../src/pattern.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAErC;;GAEG;AACH,MAAM,OAAO,OAAO;IACX,KAAK,CAAS;IACd,IAAI,CAAS;IACb,KAAK,CAAS;IAErB;;;OAGG;IACH,YAAY,SAAiB,EAAE,QAAgB,CAAC;QAC9C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,IAAI,GAAG,EAAE,CAAC;QAEd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBAClC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACd,IAAI,IAAI,GAAG,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAChC,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBAChB,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;gBACxD,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,IAAI,IAAI,GAAG,CAAC;YACd,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,mBAAmB,SAAS,OAAO,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;CACF"}

package/dist/process.d.ts

@@ -0,0 +1,72 @@
+import { Thread } from './thread';
+import { ThreadCreationFlags, MemoryFreeType, type SecurityAttributes, type MemoryBasicInformation, type HANDLE, type LPVOID, type SIZE_T } from '@cheatron/native-bindings';
+import { Handle } from './handle';
+import { Pattern } from './pattern';
+/**
+ * Represents a process handle
+ */
+export declare class Process extends Handle {
+    protected _pid: number;
+    constructor(handle: HANDLE, pid?: number, autoClose?: boolean);
+    static open(pid: number, access?: number): Process;
+    readMemory(address: LPVOID, size: number): Buffer;
+    read: (address: LPVOID, size: number) => Buffer;
+    writeMemory(address: LPVOID, buffer: Buffer): void;
+    write: (address: LPVOID, buffer: Buffer) => void;
+    createThread(startAddress: LPVOID, parameter?: LPVOID | null, stackSize?: SIZE_T, flags?: ThreadCreationFlags | number, attributes?: SecurityAttributes | LPVOID | null): Thread;
+    virtualQuery(address: LPVOID): MemoryBasicInformation;
+    query: (address: LPVOID) => MemoryBasicInformation;
+    /**
+     * Allocates memory in the process.
+     */
+    alloc(size: SIZE_T, address?: LPVOID | null, allocationType?: number, protection?: number): LPVOID;
+    /**
+     * Frees memory in the process.
+     */
+    free(address: LPVOID, size?: SIZE_T, freeType?: MemoryFreeType | number): boolean;
+    /**
+     * Finds a pattern in a specific memory range
+     * @param signature Pattern string (e.g. "55 8B EC ?? 56")
+     * @param start Start address
+     * @param size Scan size
+     */
+    findPatternInRange(signature: string | Pattern, start: bigint, size: number): bigint | null;
+    /**
+     * Finds all matches of a pattern in a specific memory range
+     */
+    findAllPatternsInRange(signature: string | Pattern, start: bigint, size: number, limit?: number): bigint[];
+    /**
+     * Finds a pattern in all committed and readable memory of the process
+     */
+    findPattern(signature: string | Pattern): bigint | null;
+    /**
+     * Finds all matches of a pattern in all committed and readable memory
+     */
+    findAllPatterns(signature: string | Pattern, limit?: number): bigint[];
+    /**
+     * Scans specific loaded modules for a given pattern.
+     * Finds the first pattern match across the specified (or default) modules.
+     * @param signature Pattern string (e.g. "55 8B EC ?? 56") or Pattern object
+     * @param moduleNames Array of module names (e.g. ['kernel32.dll', 'msvcrt.dll'])
+     * @returns The first matched address, or null if not found
+     */
+    findPatternFromModules(signature: string | Pattern, moduleNames?: string[]): bigint | null;
+    /**
+     * Finds all matches of a pattern across specified modules
+     */
+    findAllPatternsFromModules(signature: string | Pattern, moduleNames?: string[], limit?: number): bigint[];
+    static current(): CurrentProcess;
+    get pid(): number;
+}
+/**
+ * Represents the current process (singleton)
+ */
+export declare class CurrentProcess extends Process {
+    constructor();
+    createThread(startAddress: LPVOID, parameter?: LPVOID | null, stackSize?: SIZE_T, flags?: ThreadCreationFlags | number, attributes?: SecurityAttributes | LPVOID | null): Thread;
+    alloc(size: SIZE_T, address?: LPVOID | null, allocationType?: number, protection?: number): LPVOID;
+    free(address: LPVOID, size?: SIZE_T, freeType?: MemoryFreeType | number): boolean;
+    close(): void;
+}
+export declare const currentProcess: CurrentProcess;
+//# sourceMappingURL=process.d.ts.map

package/dist/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAIL,mBAAmB,EAKnB,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,MAAM,EACX,KAAK,MAAM,EACX,KAAK,MAAM,EACZ,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;GAEG;AACH,qBAAa,OAAQ,SAAQ,MAAM;IACjC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEX,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,OAAc;IAKnE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAiC,GAAG,OAAO;IAU5E,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAmBjD,IAAI,YAnBgB,MAAM,QAAQ,MAAM,KAAG,MAAM,CAmB1B;IAEvB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAiBlD,KAAK,YAjBgB,MAAM,UAAU,MAAM,KAAG,IAAI,CAiBzB;IAEzB,YAAY,CACV,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,SAAS,GAAE,MAAoB,EAC/B,KAAK,GAAE,mBAAmB,GAAG,MAAsC,EACnE,UAAU,GAAE,kBAAkB,GAAG,MAAM,GAAG,IAAW,GACpD,MAAM;IAsBT,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB;IAmBrD,KAAK,YAnBiB,MAAM,KAAG,sBAAsB,CAmB3B;IAE1B;;OAEG;IACH,KAAK,CACH,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAM,GAAG,IAAW,EAC7B,cAAc,GAAE,MAAiD,EACjE,UAAU,GAAE,MAAmC,GAC9C,MAAM;IAoBT;;OAEG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAoB,EAC1B,QAAQ,GAAE,cAAc,GAAG,MAA+B,GACzD,OAAO;IAkBV;;;;;OAKG;IACH,kBAAkB,CAChB,SAAS,EAAE,MAAM,GAAG,OAAO,EAC3B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,IAAI;IAKhB;;OAEG;IACH,sBAAsB,CACpB,SAAS,EAAE,MAAM,GAAG,OAAO,EAC3B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAU,GAChB,MAAM,EAAE;IAsBX;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI;IAKvD;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,EAAE;IAiDzE;;;;;;OAMG;IACH,sBAAsB,CACpB,SAAS,EAAE,MAAM,GAAG,OAAO,EAC3B,WAAW,GAAE,MAAM,EAAO,GACzB,MAAM,GAAG,IAAI;IAKhB;;OAEG;IACH,0BAA0B,CACxB,SAAS,EAAE,MAAM,GAAG,OAAO,EAC3B,WAAW,GAAE,MAAM,EAAO,EAC1B,KAAK,GAAE,MAAU,GAChB,MAAM,EAAE;IA0CX,MAAM,CAAC,OAAO,IAAI,cAAc;IAIhC,IAAI,GAAG,IAAI,MAAM,CAEhB;CACF;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,OAAO;;IAMhC,YAAY,CACnB,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,SAAS,GAAE,MAAoB,EAC/B,KAAK,CAAC,EAAE,mBAAmB,GAAG,MAAM,EACpC,UAAU,CAAC,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,GAC9C,MAAM;IAIA,KAAK,CACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAM,GAAG,IAAW,EAC7B,cAAc,GAAE,MAAiD,EACjE,UAAU,GAAE,MAAmC,GAC9C,MAAM;IAeA,IAAI,CACX,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAoB,EAC1B,QAAQ,GAAE,cAAc,GAAG,MAA+B,GACzD,OAAO;IAWD,KAAK;CAGf;AAID,eAAO,MAAM,cAAc,EAAE,cAU3B,CAAC"}

package/dist/process.js

@@ -0,0 +1,269 @@
+import { Thread } from './thread';
+import { Kernel32Impl, ffi, ProcessAccess, ThreadCreationFlags, MEMORY_BASIC_INFORMATION, MBI_SIZE, MemoryProtection, MemoryState, MemoryFreeType, } from '@cheatron/native-bindings';
+import { Handle } from './handle';
+import { log } from './logger';
+import { Scanner } from './scanner';
+import { Pattern } from './pattern';
+const processLog = log.child('Process');
+/**
+ * Represents a process handle
+ */
+export class Process extends Handle {
+    _pid;
+    constructor(handle, pid, autoClose = true) {
+        super(handle, autoClose);
+        this._pid = pid ?? Kernel32Impl.GetProcessId(handle);
+    }
+    static open(pid, access = ProcessAccess.ALL_ACCESS) {
+        processLog.debug(`Opening process ${pid} with access ${access}`);
+        const handle = Kernel32Impl.OpenProcess(access, 0, pid);
+        if (!handle) {
+            processLog.warn(`Failed to open process ${pid}`);
+            throw new Error(`Failed to open process ${pid}`);
+        }
+        return new Process(handle, pid);
+    }
+    readMemory(address, size) {
+        if (!this.isValid())
+            throw new Error('Process handle is closed');
+        const buf = Buffer.alloc(size);
+        const success = Kernel32Impl.ReadProcessMemory(this._handle, address, buf, size, null);
+        if (!success) {
+            const addrHex = ffi.address(address).toString(16).toUpperCase();
+            processLog.error(`ReadProcessMemory failed at 0x${addrHex}`);
+            throw new Error(`ReadProcessMemory failed at 0x${addrHex}`);
+        }
+        return buf;
+    }
+    read = this.readMemory;
+    writeMemory(address, buffer) {
+        if (!this.isValid())
+            throw new Error('Process handle is closed');
+        const success = Kernel32Impl.WriteProcessMemory(this._handle, address, buffer, buffer.length, null);
+        if (!success) {
+            const addrHex = ffi.address(address).toString(16).toUpperCase();
+            processLog.error(`WriteProcessMemory failed at 0x${addrHex}`);
+            throw new Error(`WriteProcessMemory failed at 0x${addrHex}`);
+        }
+    }
+    write = this.writeMemory;
+    createThread(startAddress, parameter = null, stackSize = 0, flags = ThreadCreationFlags.IMMEDIATE, attributes = null) {
+        if (!this.isValid())
+            throw new Error('Process handle is closed');
+        processLog.debug(`Creating remote thread at 0x${ffi.address(startAddress).toString(16)} (PID: ${this._pid})`);
+        const handle = Kernel32Impl.CreateRemoteThread(this._handle, attributes, stackSize, startAddress, parameter, flags, null);
+        if (!handle) {
+            processLog.error('CreateRemoteThread failed');
+            throw new Error('CreateRemoteThread failed');
+        }
+        return new Thread(handle);
+    }
+    virtualQuery(address) {
+        if (!this.isValid())
+            throw new Error('Process handle is closed');
+        const buf = Buffer.alloc(MBI_SIZE);
+        const result = Kernel32Impl.VirtualQueryEx(this._handle, address, buf, MBI_SIZE);
+        if (result === 0) {
+            const addrHex = ffi.address(address).toString(16).toUpperCase();
+            processLog.error(`VirtualQueryEx failed at 0x${addrHex}`);
+            throw new Error(`VirtualQueryEx failed at 0x${addrHex}`);
+        }
+        return ffi.decode(buf, MEMORY_BASIC_INFORMATION);
+    }
+    query = this.virtualQuery;
+    /**
+     * Allocates memory in the process.
+     */
+    alloc(size, address = null, allocationType = MemoryState.COMMIT | MemoryState.RESERVE, protection = MemoryProtection.READWRITE) {
+        if (!this.isValid())
+            throw new Error('Process handle is closed');
+        const result = Kernel32Impl.VirtualAllocEx(this._handle, address, size, allocationType, protection);
+        if (!result) {
+            processLog.error(`VirtualAllocEx failed (PID: ${this._pid}, size: ${size})`);
+        }
+        return result;
+    }
+    /**
+     * Frees memory in the process.
+     */
+    free(address, size = 0, freeType = MemoryFreeType.RELEASE) {
+        if (!this.isValid())
+            throw new Error('Process handle is closed');
+        const result = Kernel32Impl.VirtualFreeEx(this._handle, address, size, freeType);
+        if (!result) {
+            const addrHex = ffi.address(address).toString(16).toUpperCase();
+            processLog.error(`VirtualFreeEx failed at 0x${addrHex}`);
+        }
+        return !!result;
+    }
+    /**
+     * Finds a pattern in a specific memory range
+     * @param signature Pattern string (e.g. "55 8B EC ?? 56")
+     * @param start Start address
+     * @param size Scan size
+     */
+    findPatternInRange(signature, start, size) {
+        const results = this.findAllPatternsInRange(signature, start, size, 1);
+        return results[0] ?? null;
+    }
+    /**
+     * Finds all matches of a pattern in a specific memory range
+     */
+    findAllPatternsInRange(signature, start, size, limit = 0) {
+        if (this._pid !== Kernel32Impl.GetCurrentProcessId()) {
+            throw new Error('Memory scanning is only supported for the current process');
+        }
+        const pattern = signature instanceof Pattern ? signature : new Pattern(signature, limit);
+        const results = [];
+        const searchLimit = limit > 0 ? limit : pattern.limit > 0 ? pattern.limit : -1;
+        const hasLimit = searchLimit !== -1;
+        for (const addr of Scanner.scan(start, size, pattern)) {
+            results.push(addr);
+            if (hasLimit && results.length >= searchLimit)
+                break;
+        }
+        return results;
+    }
+    /**
+     * Finds a pattern in all committed and readable memory of the process
+     */
+    findPattern(signature) {
+        const results = this.findAllPatterns(signature, 1);
+        return results[0] ?? null;
+    }
+    /**
+     * Finds all matches of a pattern in all committed and readable memory
+     */
+    findAllPatterns(signature, limit = 0) {
+        const results = [];
+        let address = 0n;
+        const pattern = signature instanceof Pattern ? signature : new Pattern(signature, limit);
+        const searchLimit = limit > 0 ? limit : pattern.limit > 0 ? pattern.limit : -1;
+        const hasLimit = searchLimit !== -1;
+        // Max address for x64 user-space: 0x7FFFFFFFFFFF
+        const maxAddress = 0x7fffffffffffn;
+        try {
+            while (address < maxAddress) {
+                const mbi = this.virtualQuery(address);
+                // Region is committed, not guarded, and has some form of read access
+                const isReadable = mbi.State === MemoryState.COMMIT &&
+                    !(mbi.Protect & MemoryProtection.GUARD) &&
+                    (mbi.Protect & MemoryProtection.READONLY ||
+                        mbi.Protect & MemoryProtection.READWRITE ||
+                        mbi.Protect & MemoryProtection.EXECUTE_READ ||
+                        mbi.Protect & MemoryProtection.EXECUTE_READWRITE);
+                if (isReadable) {
+                    const regionLimit = hasLimit ? searchLimit - results.length : 0;
+                    const regionResults = this.findAllPatternsInRange(pattern, BigInt(mbi.BaseAddress), Number(mbi.RegionSize), regionLimit);
+                    results.push(...regionResults);
+                    if (hasLimit && results.length >= searchLimit)
+                        break;
+                }
+                const nextAddress = BigInt(mbi.BaseAddress) + BigInt(mbi.RegionSize);
+                if (nextAddress <= address)
+                    break;
+                address = nextAddress;
+            }
+        }
+        catch {
+            // Loop finished
+        }
+        return results;
+    }
+    /**
+     * Scans specific loaded modules for a given pattern.
+     * Finds the first pattern match across the specified (or default) modules.
+     * @param signature Pattern string (e.g. "55 8B EC ?? 56") or Pattern object
+     * @param moduleNames Array of module names (e.g. ['kernel32.dll', 'msvcrt.dll'])
+     * @returns The first matched address, or null if not found
+     */
+    findPatternFromModules(signature, moduleNames = []) {
+        const results = this.findAllPatternsFromModules(signature, moduleNames, 1);
+        return results[0] ?? null;
+    }
+    /**
+     * Finds all matches of a pattern across specified modules
+     */
+    findAllPatternsFromModules(signature, moduleNames = [], limit = 0) {
+        // Lazy load Module to prevent circular dependencies at the top level
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { Module, STATIC_MODULES } = require('./module');
+        if (this._pid !== Kernel32Impl.GetCurrentProcessId()) {
+            throw new Error('Module scanning is only supported for the current process');
+        }
+        if (moduleNames.length === 0) {
+            moduleNames = Object.values(STATIC_MODULES);
+        }
+        const pattern = signature instanceof Pattern ? signature : new Pattern(signature, limit);
+        const results = [];
+        const searchLimit = limit > 0 ? limit : pattern.limit > 0 ? pattern.limit : -1;
+        const hasLimit = searchLimit !== -1;
+        for (const name of moduleNames) {
+            try {
+                const mod = Module.get(name);
+                const modResults = mod.findAllPatterns(pattern);
+                for (const addr of modResults) {
+                    results.push(addr);
+                    if (hasLimit && results.length >= searchLimit)
+                        break;
+                }
+                if (hasLimit && results.length >= searchLimit)
+                    break;
+            }
+            catch (err) {
+                processLog.warn(`findAllPatternsFromModules: Failed to process module ${name}: ${err}`);
+            }
+        }
+        return results;
+    }
+    static current() {
+        return currentProcess;
+    }
+    get pid() {
+        return this._pid;
+    }
+}
+/**
+ * Represents the current process (singleton)
+ */
+export class CurrentProcess extends Process {
+    constructor() {
+        // Current process uses a pseudo-handle that doesn't need closing
+        super(Kernel32Impl.GetCurrentProcess(), Kernel32Impl.GetCurrentProcessId());
+    }
+    createThread(startAddress, parameter, stackSize = 0, flags, attributes) {
+        return Thread.create(startAddress, parameter, stackSize, flags, attributes);
+    }
+    alloc(size, address = null, allocationType = MemoryState.COMMIT | MemoryState.RESERVE, protection = MemoryProtection.READWRITE) {
+        const result = Kernel32Impl.VirtualAlloc(address, size, allocationType, protection);
+        if (!result) {
+            processLog.error(`VirtualAlloc failed (size: ${size})`);
+        }
+        return result;
+    }
+    free(address, size = 0, freeType = MemoryFreeType.RELEASE) {
+        const result = Kernel32Impl.VirtualFree(address, size, freeType);
+        if (!result) {
+            const addrHex = ffi.address(address).toString(16).toUpperCase();
+            processLog.error(`VirtualFree failed at 0x${addrHex}`);
+        }
+        return !!result;
+    }
+    close() {
+        this._handle = null;
+    }
+}
+// Export a pre-initialized instance of the current process (lazy via Proxy)
+let _currentProcess;
+export const currentProcess = new Proxy({}, {
+    get(_target, prop, receiver) {
+        if (!_currentProcess) {
+            _currentProcess = new CurrentProcess();
+        }
+        return Reflect.get(_currentProcess, prop, receiver);
+    },
+    getPrototypeOf() {
+        return CurrentProcess.prototype;
+    },
+});
+//# sourceMappingURL=process.js.map

package/dist/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"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"}