@gba-kit/gba-node 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bruno Macabeus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+# @gba-kit/gba-node
+
+Headless GBA emulator runtime for Node.js. Load a ROM, execute JavaScript scripts against the emulator, and capture screenshots, memory snapshots, and save states to disk.
+
+## Install
+
+```bash
+npm install @gba-kit/gba-node
+```
+
+## Usage
+
+### Headless Runtime
+
+```typescript
+import { HeadlessRuntime } from '@gba-kit/gba-node';
+
+const runtime = await HeadlessRuntime.create({
+  romPath: './game.gba',
+  outputDir: './output',
+  logFn: console.log,
+});
+
+// Execute a script against the emulator
+await runtime.executeScript(`
+  await wait({ frames: 60 });
+  await press('start');
+  await wait({ frames: 30 });
+  await takeScreenshot({ name: 'title' });
+`);
+
+// Write final save state
+await runtime.writeFinalSaveState();
+```
+
+### Script API
+
+Scripts run inside a sandboxed `vm.Context` with these functions available.
+
+See the **[Scripting Guide](https://github.com/macabeus/gba-kit/blob/main/docs/scripting.md)** for the full API reference and examples.
+
+### Snapshot Serialization
+
+Convert `GbaSnapshot` objects (with TypedArrays) to/from JSON using base64 encoding:
+
+```typescript
+import { deserializeSnapshot, serializeSnapshot } from '@gba-kit/gba-node';
+
+// Save to JSON
+const json = JSON.stringify(serializeSnapshot(snapshot));
+
+// Restore from JSON
+const snapshot = deserializeSnapshot(JSON.parse(json));
+```
+
+### Custom Scripting Host
+
+Implement `ScriptingHost` to control where screenshots and snapshots are written:
+
+```typescript
+import { NodeScriptingHost } from '@gba-kit/gba-node';
+
+const host = new NodeScriptingHost('./output', console.log);
+// host.generatedFiles — list of files written during the session
+```
+
+## Exports
+
+| Export                  | Type     | Description                                                               |
+| ----------------------- | -------- | ------------------------------------------------------------------------- |
+| `HeadlessRuntime`       | class    | Main runtime — loads ROM, executes scripts, manages GBA instance          |
+| `NodeScriptingHost`     | class    | File-system scripting host (PNG screenshots via fast-png, JSON snapshots) |
+| `serializeSnapshot()`   | function | Convert `GbaSnapshot` to JSON-safe object (base64 TypedArrays)            |
+| `deserializeSnapshot()` | function | Restore `GbaSnapshot` from serialized JSON                                |
+
+Type: `HeadlessRuntimeOptions`

package/dist/headless-runtime.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Headless GBA Runtime for Node.js
+ *
+ * Creates a Gba instance, loads ROM, and evaluates user scripts
+ * via the ScriptingEngine.
+ */
+import { Gba, ScriptingEngine, type ScriptingHost } from '@gba-kit/gba-emulator';
+export interface HeadlessRuntimeOptions {
+    romPath: string;
+    loadSavePath?: string;
+    outputDir: string;
+    logFn: (message: string) => void;
+}
+export declare class HeadlessRuntime {
+    #private;
+    constructor(gba: Gba, host: ScriptingHost, outputDir: string);
+    get engine(): ScriptingEngine;
+    get gba(): Gba;
+    get host(): ScriptingHost;
+    static create(options: HeadlessRuntimeOptions): Promise<HeadlessRuntime>;
+    /** Execute a script string against the emulator */
+    executeScript(scriptCode: string, scriptPath?: string): Promise<void>;
+    /** Write the final save state */
+    writeFinalSaveState(): Promise<void>;
+}
+//# sourceMappingURL=headless-runtime.d.ts.map

package/dist/headless-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-runtime.d.ts","sourceRoot":"","sources":["../src/headless-runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAOjF,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,qBAAa,eAAe;;gBAMd,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM;IAc5D,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,IAAI,GAAG,IAAI,GAAG,CAEb;IAED,IAAI,IAAI,IAAI,aAAa,CAExB;WAEY,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAkC9E,mDAAmD;IAC7C,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+D3E,iCAAiC;IAC3B,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;CAU3C"}

package/dist/headless-runtime.js

@@ -0,0 +1,121 @@
+/**
+ * Headless GBA Runtime for Node.js
+ *
+ * Creates a Gba instance, loads ROM, and evaluates user scripts
+ * via the ScriptingEngine.
+ */
+import { Gba, ScriptingEngine } from '@gba-kit/gba-emulator';
+import fs from 'fs/promises';
+import vm from 'vm';
+import { NodeScriptingHost } from './node-scripting-host.js';
+import { deserializeSnapshot, serializeSnapshot } from './snapshot-serializer.js';
+export class HeadlessRuntime {
+    #gba;
+    #engine;
+    #host;
+    #outputDir;
+    constructor(gba, host, outputDir) {
+        this.#gba = gba;
+        this.#host = host;
+        this.#outputDir = outputDir;
+        this.#engine = new ScriptingEngine(gba, host);
+        // Wire CPU access for scripting engine
+        const cpu = gba.armCpu;
+        this.#engine.cpuRegisters = cpu.registers;
+        this.#engine.cpuCpsr = () => cpu.cpsr;
+        this.#engine.cpuSerialize = () => cpu.serialize();
+        this.#engine.cpuDeserialize = (snap) => cpu.deserialize(snap);
+    }
+    get engine() {
+        return this.#engine;
+    }
+    get gba() {
+        return this.#gba;
+    }
+    get host() {
+        return this.#host;
+    }
+    static async create(options) {
+        const host = new NodeScriptingHost(options.outputDir, options.logFn);
+        const gba = new Gba();
+        // Load ROM
+        const romData = await fs.readFile(options.romPath);
+        gba.loadRom(new Uint8Array(romData));
+        // Set up initial CPU state (post-BIOS boot)
+        const cpu = gba.armCpu;
+        cpu.switchMode(0x12); // IRQ mode
+        cpu.registers[13] = 0x03007fa0;
+        cpu.switchMode(0x13); // SVC mode
+        cpu.registers[13] = 0x03007fe0;
+        cpu.switchMode(0x1f); // System mode
+        cpu.registers[13] = 0x03007f00;
+        cpu.cpsr = 0x1f; // SYS mode, IRQs enabled, ARM state
+        cpu.registers[15] = 0x08000000; // ROM entry point
+        // Load save state if provided
+        if (options.loadSavePath) {
+            const saveData = await fs.readFile(options.loadSavePath, 'utf-8');
+            const snapshot = deserializeSnapshot(JSON.parse(saveData));
+            gba.deserialize(snapshot);
+        }
+        return new HeadlessRuntime(gba, host, options.outputDir);
+    }
+    /** Execute a script string against the emulator */
+    async executeScript(scriptCode, scriptPath) {
+        const engine = this.#engine;
+        // Build the script context with all API functions bound
+        const context = vm.createContext({
+            // Timing
+            wait: (condition) => engine.wait(condition),
+            // Input
+            press: (buttons, options) => engine.press(buttons, options),
+            release: (button) => engine.release(button),
+            pressSequence: (inputs) => engine.pressSequence(inputs),
+            // Screenshots / memory
+            takeScreenshot: (options) => engine.takeScreenshot(options),
+            takeMemorySnapshot: (options) => engine.takeMemorySnapshot(options),
+            getRegisters: () => engine.getRegisters(),
+            getMemory: (address, length) => engine.getMemory(address, length),
+            read16: (address) => engine.read16(address),
+            read32: (address) => engine.read32(address),
+            disassemble: (address, count, mode) => engine.disassemble(address, count, mode),
+            disassembleFunction: (address, mode) => engine.disassembleFunction(address, mode),
+            readString: (address, maxLen) => engine.readString(address, maxLen),
+            getPixel: (x, y) => engine.getPixel(x, y),
+            getScreenRegion: (x, y, width, height) => engine.getScreenRegion(x, y, width, height),
+            record: (options) => engine.record(options),
+            readOAM: () => engine.readOAM(),
+            readBgScroll: (layer) => engine.readBgScroll(layer),
+            readBgTilemap: (layer) => engine.readBgTilemap(layer),
+            readDisplayControl: () => engine.readDisplayControl(),
+            hashRegion: (x, y, w, h) => engine.hashRegion(x, y, w, h),
+            onFrame: (cb) => engine.onFrame(cb),
+            searchMemory: (options) => engine.searchMemory(options),
+            filterMemory: (addresses, options) => engine.filterMemory(addresses, options),
+            // Save states
+            saveState: (options) => engine.saveState(options),
+            loadState: (path) => engine.loadState(path),
+            // Assertions
+            assert: (condition) => engine.assert(condition),
+            // Console
+            console: {
+                log: (...args) => this.#host.log(args.map(String).join(' ')),
+            },
+        });
+        // Wrap in an async IIFE so top-level await works
+        const wrappedCode = `(async () => {\n${scriptCode}\n})()`;
+        const script = new vm.Script(wrappedCode, {
+            filename: scriptPath ?? '<inline>',
+        });
+        await script.runInContext(context);
+    }
+    /** Write the final save state */
+    async writeFinalSaveState() {
+        const snapshot = this.#gba.serialize();
+        const serialized = serializeSnapshot(snapshot);
+        const { default: fs } = await import('fs/promises');
+        const { default: path } = await import('path');
+        const filePath = path.join(this.#outputDir, 'final_save.json');
+        await fs.writeFile(filePath, JSON.stringify(serialized, null, 2));
+    }
+}
+//# sourceMappingURL=headless-runtime.js.map

package/dist/headless-runtime.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * GBA Node.js Package — Public API
+ *
+ * Headless GBA emulator runtime for Node.js scripting.
+ */
+export { HeadlessRuntime } from './headless-runtime.js';
+export type { HeadlessRuntimeOptions } from './headless-runtime.js';
+export { NodeScriptingHost } from './node-scripting-host.js';
+export { serializeSnapshot, deserializeSnapshot } from './snapshot-serializer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * GBA Node.js Package — Public API
+ *
+ * Headless GBA emulator runtime for Node.js scripting.
+ */
+export { HeadlessRuntime } from './headless-runtime.js';
+export { NodeScriptingHost } from './node-scripting-host.js';
+export { serializeSnapshot, deserializeSnapshot } from './snapshot-serializer.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/node-scripting-host.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Node.js Scripting Host
+ *
+ * Implements ScriptingHost for Node.js: writes PNG screenshots via fast-png,
+ * JSON memory snapshots, and save states to disk.
+ */
+import type { ScriptingHost } from '@gba-kit/gba-emulator';
+import type { GbaSnapshot } from '@gba-kit/gba-emulator/savestate';
+export declare class NodeScriptingHost implements ScriptingHost {
+    #private;
+    constructor(outputDir: string, logFn: (message: string) => void);
+    get generatedFiles(): readonly string[];
+    writeScreenshot(name: string, rgbaData: Uint8Array, width: number, height: number): Promise<void>;
+    writeMemorySnapshot(name: string, data: Record<string, unknown>): Promise<void>;
+    writeSaveState(name: string, snapshot: GbaSnapshot): Promise<void>;
+    readSaveState(filePath: string): Promise<GbaSnapshot>;
+    log(message: string): void;
+}
+//# sourceMappingURL=node-scripting-host.d.ts.map

package/dist/node-scripting-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-scripting-host.d.ts","sourceRoot":"","sources":["../src/node-scripting-host.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAOnE,qBAAa,iBAAkB,YAAW,aAAa;;gBAKzC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;IAK/D,IAAI,cAAc,IAAI,SAAS,MAAM,EAAE,CAEtC;IAEK,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjG,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/E,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlE,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAM3D,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG3B"}

package/dist/node-scripting-host.js

@@ -0,0 +1,47 @@
+import { encode } from 'fast-png';
+import fs from 'fs/promises';
+import path from 'path';
+import { deserializeSnapshot, serializeSnapshot } from './snapshot-serializer.js';
+export class NodeScriptingHost {
+    #outputDir;
+    #logFn;
+    #generatedFiles = [];
+    constructor(outputDir, logFn) {
+        this.#outputDir = outputDir;
+        this.#logFn = logFn;
+    }
+    get generatedFiles() {
+        return this.#generatedFiles;
+    }
+    async writeScreenshot(name, rgbaData, width, height) {
+        const pngBytes = encode({
+            width,
+            height,
+            data: rgbaData,
+            channels: 4,
+        });
+        const filePath = path.join(this.#outputDir, `screenshot-${name}.png`);
+        await fs.writeFile(filePath, pngBytes);
+        this.#generatedFiles.push(`screenshot-${name}.png`);
+    }
+    async writeMemorySnapshot(name, data) {
+        const filePath = path.join(this.#outputDir, `memory-${name}.json`);
+        await fs.writeFile(filePath, JSON.stringify(data, null, 2));
+        this.#generatedFiles.push(`memory-${name}.json`);
+    }
+    async writeSaveState(name, snapshot) {
+        const filePath = path.join(this.#outputDir, `savestate-${name}.json`);
+        const serialized = serializeSnapshot(snapshot);
+        await fs.writeFile(filePath, JSON.stringify(serialized, null, 2));
+        this.#generatedFiles.push(`savestate-${name}.json`);
+    }
+    async readSaveState(filePath) {
+        const data = await fs.readFile(filePath, 'utf-8');
+        const parsed = JSON.parse(data);
+        return deserializeSnapshot(parsed);
+    }
+    log(message) {
+        this.#logFn(message);
+    }
+}
+//# sourceMappingURL=node-scripting-host.js.map

package/dist/node-scripting-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-scripting-host.js","sourceRoot":"","sources":["../src/node-scripting-host.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElF,MAAM,OAAO,iBAAiB;IACnB,UAAU,CAAS;IACnB,MAAM,CAA4B;IAClC,eAAe,GAAa,EAAE,CAAC;IAExC,YAAY,SAAiB,EAAE,KAAgC;QAC7D,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAAY,EAAE,QAAoB,EAAE,KAAa,EAAE,MAAc;QACrF,MAAM,QAAQ,GAAG,MAAM,CAAC;YACtB,KAAK;YACL,MAAM;YACN,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC;SACZ,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,IAAI,MAAM,CAAC,CAAC;QACtE,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,cAAc,IAAI,MAAM,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,IAAY,EAAE,IAA6B;QACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,IAAI,OAAO,CAAC,CAAC;QACnE,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAY,EAAE,QAAqB;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,IAAI,OAAO,CAAC,CAAC;QACtE,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC/C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAgB;QAClC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,OAAe;QACjB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;CACF"}

package/dist/snapshot-serializer.d.ts

@@ -0,0 +1,10 @@
+/**
+ * GbaSnapshot JSON Serializer
+ *
+ * Converts GbaSnapshot (with TypedArrays) to/from plain JSON objects
+ * using base64 encoding for binary data.
+ */
+import type { GbaSnapshot } from '@gba-kit/gba-emulator/savestate';
+export declare function serializeSnapshot(snap: GbaSnapshot): any;
+export declare function deserializeSnapshot(data: any): GbaSnapshot;
+//# sourceMappingURL=snapshot-serializer.d.ts.map

package/dist/snapshot-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-serializer.d.ts","sourceRoot":"","sources":["../src/snapshot-serializer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAuBnE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,GAAG,CA2ExD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,GAAG,WAAW,CAwE1D"}

package/dist/snapshot-serializer.js

@@ -0,0 +1,167 @@
+/** Encode a TypedArray to base64 string */
+function typedArrayToBase64(arr) {
+    const bytes = arr instanceof Uint8Array ? arr : new Uint8Array(arr.buffer, arr.byteOffset, arr.byteLength);
+    return Buffer.from(bytes).toString('base64');
+}
+/** Decode a base64 string to a buffer, then wrap in the target TypedArray constructor */
+function base64ToUint8Array(b64) {
+    return new Uint8Array(Buffer.from(b64, 'base64'));
+}
+function base64ToUint32Array(b64) {
+    const buf = Buffer.from(b64, 'base64');
+    return new Uint32Array(buf.buffer, buf.byteOffset, buf.byteLength / 4);
+}
+function base64ToInt8Array(b64) {
+    const buf = Buffer.from(b64, 'base64');
+    return new Int8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+}
+export function serializeSnapshot(snap) {
+    return {
+        version: snap.version,
+        cpu: {
+            registers: typedArrayToBase64(snap.cpu.registers),
+            cpsr: snap.cpu.cpsr,
+            bankedSP: typedArrayToBase64(snap.cpu.bankedSP),
+            bankedLR: typedArrayToBase64(snap.cpu.bankedLR),
+            fiqBankedR8to12: typedArrayToBase64(snap.cpu.fiqBankedR8to12),
+            usrBankedR8to12: typedArrayToBase64(snap.cpu.usrBankedR8to12),
+            spsr: typedArrayToBase64(snap.cpu.spsr),
+            halted: snap.cpu.halted,
+            haltedBySWI: snap.cpu.haltedBySWI,
+        },
+        currentScanline: snap.currentScanline,
+        inIrqHandler: snap.inIrqHandler,
+        scheduler: {
+            currentCycle: snap.scheduler.currentCycle,
+            events: snap.scheduler.events,
+        },
+        interrupts: snap.interrupts,
+        timers: snap.timers,
+        dma: snap.dma,
+        input: snap.input,
+        bus: {
+            ewram: typedArrayToBase64(snap.bus.ewram),
+            iwram: typedArrayToBase64(snap.bus.iwram),
+            palette: typedArrayToBase64(snap.bus.palette),
+            vram: typedArrayToBase64(snap.bus.vram),
+            oam: typedArrayToBase64(snap.bus.oam),
+            sram: typedArrayToBase64(snap.bus.sram),
+            mmioRegisters: typedArrayToBase64(snap.bus.mmioRegisters),
+            hasSram: snap.bus.hasSram,
+            waitcnt: snap.bus.waitcnt,
+            postflg: snap.bus.postflg,
+            lastBiosRead: snap.bus.lastBiosRead,
+            eeprom: {
+                data: typedArrayToBase64(snap.bus.eeprom.data),
+                addrBits: snap.bus.eeprom.addrBits,
+                state: snap.bus.eeprom.state,
+                command: snap.bus.eeprom.command,
+                address: snap.bus.eeprom.address,
+                bitBuffer: snap.bus.eeprom.bitBuffer,
+                bitsReceived: snap.bus.eeprom.bitsReceived,
+                sendBuffer: snap.bus.eeprom.sendBuffer,
+                sendPos: snap.bus.eeprom.sendPos,
+            },
+        },
+        ppu: {
+            framebuffer: typedArrayToBase64(snap.ppu.framebuffer),
+            bg2RefX: snap.ppu.bg2RefX,
+            bg2RefY: snap.ppu.bg2RefY,
+            bg3RefX: snap.ppu.bg3RefX,
+            bg3RefY: snap.ppu.bg3RefY,
+            bg2RefLatched: snap.ppu.bg2RefLatched,
+            bg3RefLatched: snap.ppu.bg3RefLatched,
+        },
+        apu: snap.apu
+            ? {
+                ...snap.apu,
+                dsA: {
+                    ...snap.apu.dsA,
+                    buffer: typedArrayToBase64(snap.apu.dsA.buffer),
+                },
+                dsB: {
+                    ...snap.apu.dsB,
+                    buffer: typedArrayToBase64(snap.apu.dsB.buffer),
+                },
+                ch3: {
+                    ...snap.apu.ch3,
+                    waveRam: typedArrayToBase64(snap.apu.ch3.waveRam),
+                },
+            }
+            : undefined,
+    };
+}
+export function deserializeSnapshot(data) {
+    return {
+        version: data.version,
+        cpu: {
+            registers: base64ToUint32Array(data.cpu.registers),
+            cpsr: data.cpu.cpsr,
+            bankedSP: base64ToUint32Array(data.cpu.bankedSP),
+            bankedLR: base64ToUint32Array(data.cpu.bankedLR),
+            fiqBankedR8to12: base64ToUint32Array(data.cpu.fiqBankedR8to12),
+            usrBankedR8to12: base64ToUint32Array(data.cpu.usrBankedR8to12),
+            spsr: base64ToUint32Array(data.cpu.spsr),
+            halted: data.cpu.halted,
+            haltedBySWI: data.cpu.haltedBySWI,
+        },
+        currentScanline: data.currentScanline,
+        inIrqHandler: data.inIrqHandler,
+        scheduler: data.scheduler,
+        interrupts: data.interrupts,
+        timers: data.timers,
+        dma: data.dma,
+        input: data.input,
+        bus: {
+            ewram: base64ToUint8Array(data.bus.ewram),
+            iwram: base64ToUint8Array(data.bus.iwram),
+            palette: base64ToUint8Array(data.bus.palette),
+            vram: base64ToUint8Array(data.bus.vram),
+            oam: base64ToUint8Array(data.bus.oam),
+            sram: base64ToUint8Array(data.bus.sram),
+            mmioRegisters: base64ToUint8Array(data.bus.mmioRegisters),
+            hasSram: data.bus.hasSram,
+            waitcnt: data.bus.waitcnt,
+            postflg: data.bus.postflg,
+            lastBiosRead: data.bus.lastBiosRead,
+            eeprom: {
+                data: base64ToUint8Array(data.bus.eeprom.data),
+                addrBits: data.bus.eeprom.addrBits,
+                state: data.bus.eeprom.state,
+                command: data.bus.eeprom.command,
+                address: data.bus.eeprom.address,
+                bitBuffer: data.bus.eeprom.bitBuffer,
+                bitsReceived: data.bus.eeprom.bitsReceived,
+                sendBuffer: data.bus.eeprom.sendBuffer,
+                sendPos: data.bus.eeprom.sendPos,
+            },
+        },
+        ppu: {
+            framebuffer: base64ToUint32Array(data.ppu.framebuffer),
+            bg2RefX: data.ppu.bg2RefX,
+            bg2RefY: data.ppu.bg2RefY,
+            bg3RefX: data.ppu.bg3RefX,
+            bg3RefY: data.ppu.bg3RefY,
+            bg2RefLatched: data.ppu.bg2RefLatched,
+            bg3RefLatched: data.ppu.bg3RefLatched,
+        },
+        apu: data.apu
+            ? {
+                ...data.apu,
+                dsA: {
+                    ...data.apu.dsA,
+                    buffer: base64ToInt8Array(data.apu.dsA.buffer),
+                },
+                dsB: {
+                    ...data.apu.dsB,
+                    buffer: base64ToInt8Array(data.apu.dsB.buffer),
+                },
+                ch3: {
+                    ...data.apu.ch3,
+                    waveRam: base64ToUint8Array(data.apu.ch3.waveRam),
+                },
+            }
+            : undefined,
+    };
+}
+//# sourceMappingURL=snapshot-serializer.js.map

package/dist/snapshot-serializer.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@gba-kit/gba-node",
+  "version": "0.1.0",
+  "description": "Headless Node.js runtime for scripted GBA emulation",
+  "author": "macabeus",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/macabeus/gba-kit",
+    "directory": "packages/gba-node"
+  },
+  "homepage": "https://github.com/macabeus/gba-kit",
+  "bugs": "https://github.com/macabeus/gba-kit/issues",
+  "keywords": [
+    "gba",
+    "gameboy-advance",
+    "emulator",
+    "arm7tdmi",
+    "typescript"
+  ],
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "fast-png": "^8.0.0",
+    "@gba-kit/arm-emulator": "0.1.0",
+    "@gba-kit/gba-emulator": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint src/"
+  }
+}