@cheatron/native 1.2.0 → 1.2.2

package/dist/process.d.ts

@@ -2,59 +2,35 @@ 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';
+import { ScanResult } from './scan-result';
 /**
  * Represents a process handle
  */
 export declare class Process extends Handle {
     protected _pid: number;
+    readonly memory: ProcessMemory;
     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.
+     * Finds pattern matches in a specific memory range.
+     * Configure limit on the Pattern: `.limit(1)` for first match only.
      */
-    alloc(size: SIZE_T, address?: LPVOID | null, allocationType?: number, protection?: number): LPVOID;
+    private findPatternInRangeGenerator;
+    findPatternInRange(signature: string | Pattern, start: bigint, size: number, module?: import('./module').Module): ScanResult;
     /**
-     * Frees memory in the process.
+     * Finds pattern matches in all committed readable memory of the process.
+     * Configure limit and protect filter on the Pattern object.
      */
-    free(address: LPVOID, size?: SIZE_T, freeType?: MemoryFreeType | number): boolean;
+    private findPatternGenerator;
+    findPattern(signature: string | Pattern): ScanResult;
     /**
-     * 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
+     * Finds pattern matches across specified modules (default: all static modules).
+     * Each entry in the result is tagged with its source module.
+     * Configure limit and protect filter on the Pattern object.
      */
-    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[];
+    private findPatternFromModulesGenerator;
+    findPatternFromModules(signature: string | Pattern, moduleNames?: string[]): ScanResult;
     static current(): CurrentProcess;
     get pid(): number;
 }
@@ -62,11 +38,67 @@ export declare class Process extends Handle {
  * Represents the current process (singleton)
  */
 export declare class CurrentProcess extends Process {
+    readonly memory: CurrentProcessMemory;
     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;
+/**
+ * Manages memory operations for a given process handle.
+ */
+export declare class ProcessMemory {
+    readonly process: Process;
+    constructor(process: Process);
+    read(address: LPVOID, size: number): Buffer;
+    readMemory: (address: LPVOID, size: number) => Buffer;
+    write(address: LPVOID, buffer: Buffer): void;
+    writeMemory: (address: LPVOID, buffer: Buffer) => void;
+    readInt8(address: LPVOID): number;
+    writeInt8(address: LPVOID, value: number): void;
+    readUInt8(address: LPVOID): number;
+    writeUInt8(address: LPVOID, value: number): void;
+    readInt16(address: LPVOID): number;
+    writeInt16(address: LPVOID, value: number): void;
+    readUInt16(address: LPVOID): number;
+    writeUInt16(address: LPVOID, value: number): void;
+    readInt32(address: LPVOID): number;
+    writeInt32(address: LPVOID, value: number): void;
+    readUInt32(address: LPVOID): number;
+    writeUInt32(address: LPVOID, value: number): void;
+    readInt64(address: LPVOID): bigint;
+    writeInt64(address: LPVOID, value: bigint): void;
+    readUInt64(address: LPVOID): bigint;
+    writeUInt64(address: LPVOID, value: bigint): void;
+    readFloat(address: LPVOID): number;
+    writeFloat(address: LPVOID, value: number): void;
+    readDouble(address: LPVOID): number;
+    writeDouble(address: LPVOID, value: number): void;
+    readString(address: LPVOID, length: number, encoding?: BufferEncoding): string;
+    writeString(address: LPVOID, value: string, encoding?: BufferEncoding): void;
+    query(address: LPVOID): MemoryBasicInformation;
+    virtualQuery: (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;
+    /**
+     * Changes the memory protection of a region of memory.
+     */
+    protect(address: LPVOID, size: SIZE_T, newProtect: number): number | null;
+}
+/**
+ * Optimizes memory operations natively for the current running process.
+ */
+export declare class CurrentProcessMemory extends ProcessMemory {
+    alloc(size: SIZE_T, address?: LPVOID | null, allocationType?: number, protection?: number): LPVOID;
+    free(address: LPVOID, size?: SIZE_T, freeType?: MemoryFreeType | number): boolean;
+    protect(address: LPVOID, size: SIZE_T | number, newProtect: number): number | null;
+    query(address: LPVOID): MemoryBasicInformation;
+    virtualQuery: (address: LPVOID) => MemoryBasicInformation;
+}
 //# sourceMappingURL=process.d.ts.map

package/dist/process.d.ts.map

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