@cheatron/native 1.1.0 → 1.2.1

package/dist/process.js

@@ -0,0 +1,402 @@
+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';
+import { ScanResult, ScanEntry } from './scan-result';
+const processLog = log.child('Process');
+/**
+ * Represents a process handle
+ */
+export class Process extends Handle {
+    _pid;
+    memory;
+    constructor(handle, pid, autoClose = true) {
+        super(handle, autoClose);
+        this._pid = pid ?? Kernel32Impl.GetProcessId(handle);
+        this.memory = new ProcessMemory(this);
+    }
+    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);
+    }
+    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);
+    }
+    /**
+     * Finds pattern matches in a specific memory range.
+     * Configure limit on the Pattern: `.limit(1)` for first match only.
+     */
+    *findPatternInRangeGenerator(pattern, start, size, module) {
+        const end = start + BigInt(size);
+        let current = start;
+        try {
+            while (current < end) {
+                const mbi = this.memory.query(current);
+                const regionBase = BigInt(mbi.BaseAddress);
+                const regionSize = BigInt(mbi.RegionSize);
+                const regionEnd = regionBase + regionSize;
+                const isReadable = mbi.State === MemoryState.COMMIT &&
+                    !(mbi.Protect & MemoryProtection.GUARD) &&
+                    !!(mbi.Protect & pattern.protect);
+                if (isReadable) {
+                    const scanStart = current > regionBase ? current : regionBase;
+                    const scanEnd = end < regionEnd ? end : regionEnd;
+                    const scanSize = Number(scanEnd - scanStart);
+                    if (scanSize >= pattern.length) {
+                        for (const ptr of Scanner.scan(scanStart, scanSize, pattern)) {
+                            yield new ScanEntry(ptr, module);
+                        }
+                    }
+                }
+                if (regionEnd <= current)
+                    break;
+                current = regionEnd;
+            }
+        }
+        catch {
+            // Range partially unmapped or error
+        }
+    }
+    findPatternInRange(signature, start, size, module) {
+        const pattern = signature instanceof Pattern ? signature : new Pattern(signature);
+        if (pattern.protect === 0)
+            pattern.defaultProtect();
+        return new ScanResult(this.findPatternInRangeGenerator(pattern, start, size, module), pattern);
+    }
+    /**
+     * Finds pattern matches in all committed readable memory of the process.
+     * Configure limit and protect filter on the Pattern object.
+     */
+    *findPatternGenerator(pattern) {
+        let address = 0n;
+        const maxAddress = 0x7fffffffffffn;
+        try {
+            while (address < maxAddress) {
+                const mbi = this.memory.query(address);
+                const isReadable = mbi.State === MemoryState.COMMIT &&
+                    !(mbi.Protect & MemoryProtection.GUARD) &&
+                    !!(mbi.Protect & pattern.protect);
+                if (isReadable) {
+                    const regionResult = this.findPatternInRange(pattern, BigInt(mbi.BaseAddress), Number(mbi.RegionSize));
+                    yield* regionResult;
+                }
+                const nextAddress = BigInt(mbi.BaseAddress) + BigInt(mbi.RegionSize);
+                if (nextAddress <= address)
+                    break;
+                address = nextAddress;
+            }
+        }
+        catch {
+            // Loop finished
+        }
+    }
+    findPattern(signature) {
+        const pattern = signature instanceof Pattern ? signature : new Pattern(signature);
+        // Ensure protect mask is set before filtering regions
+        if (pattern.protect === 0)
+            pattern.defaultProtect();
+        return new ScanResult(this.findPatternGenerator(pattern), pattern);
+    }
+    /**
+     * 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.
+     */
+    *findPatternFromModulesGenerator(pattern, moduleNames) {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { Module } = require('./module');
+        for (const name of moduleNames) {
+            try {
+                const mod = Module.get(name);
+                yield* mod.findPattern(pattern);
+            }
+            catch (err) {
+                processLog.warn(`findPatternFromModules: Failed to process module ${name}: ${err}`);
+            }
+        }
+    }
+    findPatternFromModules(signature, moduleNames = []) {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { 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);
+        return new ScanResult(this.findPatternFromModulesGenerator(pattern, moduleNames), pattern);
+    }
+    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());
+        this.memory = new CurrentProcessMemory(this);
+    }
+    createThread(startAddress, parameter, stackSize = 0, flags, attributes) {
+        return Thread.create(startAddress, parameter, stackSize, flags, attributes);
+    }
+    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;
+    },
+});
+/**
+ * Manages memory operations for a given process handle.
+ */
+export class ProcessMemory {
+    process;
+    // eslint-disable-next-line no-unused-vars
+    constructor(process) {
+        this.process = process;
+    }
+    read(address, size) {
+        if (!this.process.isValid())
+            throw new Error('Process handle is closed');
+        const buf = Buffer.alloc(size);
+        const success = Kernel32Impl.ReadProcessMemory(this.process.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;
+    }
+    readMemory = this.read;
+    write(address, buffer) {
+        if (!this.process.isValid())
+            throw new Error('Process handle is closed');
+        const success = Kernel32Impl.WriteProcessMemory(this.process.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}`);
+        }
+    }
+    writeMemory = this.write;
+    readInt8(address) {
+        return this.read(address, 1).readInt8(0);
+    }
+    writeInt8(address, value) {
+        const buf = Buffer.alloc(1);
+        buf.writeInt8(value, 0);
+        this.write(address, buf);
+    }
+    readUInt8(address) {
+        return this.read(address, 1).readUInt8(0);
+    }
+    writeUInt8(address, value) {
+        const buf = Buffer.alloc(1);
+        buf.writeUInt8(value, 0);
+        this.write(address, buf);
+    }
+    readInt16(address) {
+        return this.read(address, 2).readInt16LE(0);
+    }
+    writeInt16(address, value) {
+        const buf = Buffer.alloc(2);
+        buf.writeInt16LE(value, 0);
+        this.write(address, buf);
+    }
+    readUInt16(address) {
+        return this.read(address, 2).readUInt16LE(0);
+    }
+    writeUInt16(address, value) {
+        const buf = Buffer.alloc(2);
+        buf.writeUInt16LE(value, 0);
+        this.write(address, buf);
+    }
+    readInt32(address) {
+        return this.read(address, 4).readInt32LE(0);
+    }
+    writeInt32(address, value) {
+        const buf = Buffer.alloc(4);
+        buf.writeInt32LE(value, 0);
+        this.write(address, buf);
+    }
+    readUInt32(address) {
+        return this.read(address, 4).readUInt32LE(0);
+    }
+    writeUInt32(address, value) {
+        const buf = Buffer.alloc(4);
+        buf.writeUInt32LE(value, 0);
+        this.write(address, buf);
+    }
+    readInt64(address) {
+        return this.read(address, 8).readBigInt64LE(0);
+    }
+    writeInt64(address, value) {
+        const buf = Buffer.alloc(8);
+        buf.writeBigInt64LE(value, 0);
+        this.write(address, buf);
+    }
+    readUInt64(address) {
+        return this.read(address, 8).readBigUInt64LE(0);
+    }
+    writeUInt64(address, value) {
+        const buf = Buffer.alloc(8);
+        buf.writeBigUInt64LE(value, 0);
+        this.write(address, buf);
+    }
+    readFloat(address) {
+        return this.read(address, 4).readFloatLE(0);
+    }
+    writeFloat(address, value) {
+        const buf = Buffer.alloc(4);
+        buf.writeFloatLE(value, 0);
+        this.write(address, buf);
+    }
+    readDouble(address) {
+        return this.read(address, 8).readDoubleLE(0);
+    }
+    writeDouble(address, value) {
+        const buf = Buffer.alloc(8);
+        buf.writeDoubleLE(value, 0);
+        this.write(address, buf);
+    }
+    readString(address, length, encoding = 'utf8') {
+        const buf = this.read(address, length);
+        // Trim null byte if exists at the end
+        const nullIdx = buf.indexOf(0);
+        if (nullIdx !== -1) {
+            return buf.toString(encoding, 0, nullIdx);
+        }
+        return buf.toString(encoding);
+    }
+    writeString(address, value, encoding = 'utf8') {
+        const buf = Buffer.from(value + '\0', encoding);
+        this.write(address, buf);
+    }
+    query(address) {
+        if (!this.process.isValid())
+            throw new Error('Process handle is closed');
+        const buf = Buffer.alloc(MBI_SIZE);
+        const result = Kernel32Impl.VirtualQueryEx(this.process.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);
+    }
+    virtualQuery = this.query;
+    /**
+     * Allocates memory in the process.
+     */
+    alloc(size, address = null, allocationType = MemoryState.COMMIT | MemoryState.RESERVE, protection = MemoryProtection.READWRITE) {
+        if (!this.process.isValid())
+            throw new Error('Process handle is closed');
+        const result = Kernel32Impl.VirtualAllocEx(this.process.handle, address, size, allocationType, protection);
+        if (!result) {
+            processLog.error(`VirtualAllocEx failed (PID: ${this.process.pid}, size: ${size})`);
+        }
+        return result;
+    }
+    /**
+     * Frees memory in the process.
+     */
+    free(address, size = 0, freeType = MemoryFreeType.RELEASE) {
+        if (!this.process.isValid())
+            throw new Error('Process handle is closed');
+        const result = Kernel32Impl.VirtualFreeEx(this.process.handle, address, size, freeType);
+        if (!result) {
+            const addrHex = ffi.address(address).toString(16).toUpperCase();
+            processLog.error(`VirtualFreeEx failed at 0x${addrHex}`);
+        }
+        return !!result;
+    }
+    /**
+     * Changes the memory protection of a region of memory.
+     */
+    protect(address, size, newProtect) {
+        if (!this.process.isValid())
+            throw new Error('Process handle is closed');
+        const oldProtectBuf = Buffer.alloc(4);
+        const result = Kernel32Impl.VirtualProtectEx(this.process.handle, address, size, newProtect, oldProtectBuf);
+        if (!result) {
+            const addrHex = ffi.address(address).toString(16).toUpperCase();
+            processLog.error(`VirtualProtectEx failed at 0x${addrHex}`);
+            return null;
+        }
+        return oldProtectBuf.readUInt32LE(0);
+    }
+}
+/**
+ * Optimizes memory operations natively for the current running process.
+ */
+export class CurrentProcessMemory extends ProcessMemory {
+    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;
+    }
+    protect(address, size, newProtect) {
+        const oldProtectBuf = Buffer.alloc(4);
+        const result = Kernel32Impl.VirtualProtect(address, BigInt(size), newProtect, oldProtectBuf);
+        if (!result) {
+            const addrHex = ffi.address(address).toString(16).toUpperCase();
+            processLog.error(`VirtualProtect failed at 0x${addrHex}`);
+            return null;
+        }
+        return oldProtectBuf.readUInt32LE(0);
+    }
+    query(address) {
+        const buf = Buffer.alloc(MBI_SIZE);
+        const result = Kernel32Impl.VirtualQuery(address, buf, MBI_SIZE);
+        if (result === 0) {
+            const addrHex = ffi.address(address).toString(16).toUpperCase();
+            processLog.error(`VirtualQuery failed at 0x${addrHex}`);
+            throw new Error(`VirtualQuery failed at 0x${addrHex}`);
+        }
+        return ffi.decode(buf, MEMORY_BASIC_INFORMATION);
+    }
+    virtualQuery = this.query;
+}
+//# 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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"}

package/dist/scan-result.d.ts

@@ -0,0 +1,54 @@
+import type { Pattern } from './pattern';
+/**
+ * A single pattern match entry.
+ * Stores the decoded numeric address (bigint) of the match.
+ * Call `toAddress()` to retrieve it — consistent with how ffi.address() works.
+ */
+export declare class ScanEntry {
+    readonly address: bigint;
+    readonly module?: import('./module').Module;
+    constructor(address: bigint, module?: import('./module').Module);
+    toAddress(): bigint;
+    toString(): string;
+}
+/**
+ * Result of a pattern scan operation.
+ * Lazily evaluates the underlying generator and caches findings.
+ * Supports taking matches one-by-one or materializing the full result.
+ *
+ * @example
+ * const result = currentProcess.findPattern('55 8B EC');
+ * const firstMatch = result.first(); // Scans until 1 match is found
+ * const allMatches = result.all(); // Fully exhausts the generator up to pattern config limit
+ */
+export declare class ScanResult implements Iterable<ScanEntry> {
+    readonly pattern: Pattern;
+    private generator;
+    private _cached;
+    private _isExhausted;
+    constructor(iterable: Iterable<ScanEntry>, pattern: Pattern);
+    /**
+     * Evaluates the generator up to 'n' elements and caches them internally.
+     */
+    private pump;
+    /** Gets the first match and stops scanning further unless requested again. */
+    first(): ScanEntry | undefined;
+    /** Gets up to N matches. Scans only as much memory as needed. */
+    take(n: number): ScanEntry[];
+    /** Evaluates the scan fully, up to the pattern's configured limit. */
+    all(): ScanEntry[];
+    /** Shortcut to strictly evaluate the scan based on the limit and return the array. */
+    get entries(): ScanEntry[];
+    /** Number of matched entries (fully evaluates scan). */
+    get length(): number;
+    /** All matched addresses directly derived from entries. */
+    get addresses(): bigint[];
+    /** Combines another ScanResult efficiently. */
+    merge(other: ScanResult): ScanResult;
+    /**
+     * Lazily iterates over available entries, fetching from the scan engine only when needed.
+     * Bound efficiently by the limit configured on the `Pattern`.
+     */
+    [Symbol.iterator](): Iterator<ScanEntry>;
+}
+//# sourceMappingURL=scan-result.d.ts.map

package/dist/scan-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-result.d.ts","sourceRoot":"","sources":["../src/scan-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;GAIG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,UAAU,EAAE,MAAM,CAAC;gBAEhC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,UAAU,EAAE,MAAM;IAK/D,SAAS,IAAI,MAAM;IAInB,QAAQ,IAAI,MAAM;CAMnB;AAED;;;;;;;;;GASG;AACH,qBAAa,UAAW,YAAW,QAAQ,CAAC,SAAS,CAAC;IACpD,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,YAAY,CAAS;gBAEjB,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO;IAK3D;;OAEG;IACH,OAAO,CAAC,IAAI;IAWZ,8EAA8E;IAC9E,KAAK,IAAI,SAAS,GAAG,SAAS;IAK9B,iEAAiE;IACjE,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE;IAK5B,sEAAsE;IACtE,GAAG,IAAI,SAAS,EAAE;IAWlB,sFAAsF;IACtF,IAAI,OAAO,IAAI,SAAS,EAAE,CAEzB;IAED,wDAAwD;IACxD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,2DAA2D;IAC3D,IAAI,SAAS,IAAI,MAAM,EAAE,CAExB;IAED,+CAA+C;IAC/C,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU;IAUpC;;;OAGG;IACF,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC;CAuB1C"}

package/dist/scan-result.js

@@ -0,0 +1,128 @@
+/**
+ * A single pattern match entry.
+ * Stores the decoded numeric address (bigint) of the match.
+ * Call `toAddress()` to retrieve it — consistent with how ffi.address() works.
+ */
+export class ScanEntry {
+    address;
+    module;
+    constructor(address, module) {
+        this.address = address;
+        this.module = module;
+    }
+    toAddress() {
+        return this.address;
+    }
+    toString() {
+        const addressString = '0x' + this.address.toString(16).toUpperCase();
+        return this.module
+            ? `${this.module.toString()}+${addressString}`
+            : addressString;
+    }
+}
+/**
+ * Result of a pattern scan operation.
+ * Lazily evaluates the underlying generator and caches findings.
+ * Supports taking matches one-by-one or materializing the full result.
+ *
+ * @example
+ * const result = currentProcess.findPattern('55 8B EC');
+ * const firstMatch = result.first(); // Scans until 1 match is found
+ * const allMatches = result.all(); // Fully exhausts the generator up to pattern config limit
+ */
+export class ScanResult {
+    pattern;
+    generator;
+    _cached = [];
+    _isExhausted = false;
+    constructor(iterable, pattern) {
+        this.pattern = pattern;
+        this.generator = iterable[Symbol.iterator]();
+    }
+    /**
+     * Evaluates the generator up to 'n' elements and caches them internally.
+     */
+    pump(n) {
+        while (!this._isExhausted && (n === undefined || this._cached.length < n)) {
+            const res = this.generator.next();
+            if (res.done) {
+                this._isExhausted = true;
+            }
+            else {
+                this._cached.push(res.value);
+            }
+        }
+    }
+    /** Gets the first match and stops scanning further unless requested again. */
+    first() {
+        this.pump(1);
+        return this._cached[0];
+    }
+    /** Gets up to N matches. Scans only as much memory as needed. */
+    take(n) {
+        this.pump(n);
+        return this._cached.slice(0, n);
+    }
+    /** Evaluates the scan fully, up to the pattern's configured limit. */
+    all() {
+        const limit = this.pattern.maxResults;
+        if (limit > 0) {
+            this.pump(limit);
+            return this._cached.slice(0, limit);
+        }
+        else {
+            this.pump();
+            return [...this._cached];
+        }
+    }
+    /** Shortcut to strictly evaluate the scan based on the limit and return the array. */
+    get entries() {
+        return this.all();
+    }
+    /** Number of matched entries (fully evaluates scan). */
+    get length() {
+        return this.all().length;
+    }
+    /** All matched addresses directly derived from entries. */
+    get addresses() {
+        return this.all().map((e) => e.address);
+    }
+    /** Combines another ScanResult efficiently. */
+    merge(other) {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const me = this;
+        const combined = function* () {
+            yield* me.all(); // Yields cached/evaluated from this
+            yield* other.all(); // Yields cached/evaluated from other
+        };
+        return new ScanResult(combined(), this.pattern);
+    }
+    /**
+     * Lazily iterates over available entries, fetching from the scan engine only when needed.
+     * Bound efficiently by the limit configured on the `Pattern`.
+     */
+    *[Symbol.iterator]() {
+        const limit = this.pattern.maxResults;
+        let yielded = 0;
+        // First yield already evaluated results
+        for (const cachedEntry of this._cached) {
+            if (limit > 0 && yielded >= limit)
+                return;
+            yield cachedEntry;
+            yielded++;
+        }
+        // Now evaluate fresh parts if needed
+        while (!this._isExhausted && (limit === 0 || yielded < limit)) {
+            const res = this.generator.next();
+            if (res.done) {
+                this._isExhausted = true;
+            }
+            else {
+                this._cached.push(res.value);
+                yield res.value;
+                yielded++;
+            }
+        }
+    }
+}
+//# sourceMappingURL=scan-result.js.map

package/dist/scan-result.js.map

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

package/dist/scanner.d.ts

@@ -0,0 +1,22 @@
+import { Pattern } from './pattern';
+/**
+ * Memory scanning utility
+ */
+export declare class Scanner {
+    /**
+     * Scans local memory for a pattern using a generator.
+     * Yields each matched address as a decoded bigint.
+     *
+     * @param base Memory address to start from
+     * @param size Total size of the memory region to scan
+     * @param pattern Pattern to search for
+     * @param chunkSize Size of each scan chunk (default: 1MB)
+     */
+    static scan(base: bigint, size: number, pattern: Pattern, chunkSize?: number): Generator<bigint>;
+    /**
+     * Helper method to scan a specific memory chunk with wildcards.
+     * Yields decoded bigint addresses.
+     */
+    private static scanChunkWildcard;
+}
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;GAEG;AACH,qBAAa,OAAO;IAClB;;;;;;;;OAQG;IACH,MAAM,CAAE,IAAI,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,SAAS,GAAE,MAAoB,GAC9B,SAAS,CAAC,MAAM,CAAC;IAuFpB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAE,iBAAiB;CA2BlC"}