warpo 2.5.0-alpha-3 → 3.1.0

package/dist/debug_server/nodeDebugger.js

@@ -0,0 +1,240 @@
+// Copyright (C) 2025 wasm-ecosystem
+// SPDX-License-Identifier: Apache-2.0
+import { spawn } from "node:child_process";
+import { appendFileSync, writeFileSync } from "node:fs";
+import * as path from "node:path";
+import * as net from "node:net";
+import { fileURLToPath } from "node:url";
+import { DebuggerWasmModule } from "./debuggerWasmModule.js";
+const DIRNAME = path.dirname(fileURLToPath(import.meta.url));
+const DEBUG_SERVER_TRACE_ENABLED = process.env.WARPO_DEBUG_SERVER_TRACE === "1";
+const DEBUG_SERVER_TRACE_FILE = path.join(process.cwd(), ".warpo-debug-server-trace.log");
+if (DEBUG_SERVER_TRACE_ENABLED) {
+    try {
+        writeFileSync(DEBUG_SERVER_TRACE_FILE, "");
+    }
+    catch {
+        // Tracing should never block launching the runtime.
+    }
+}
+function trace(message) {
+    if (DEBUG_SERVER_TRACE_ENABLED) {
+        try {
+            appendFileSync(DEBUG_SERVER_TRACE_FILE, `[node-debugger] ${message}\n`);
+        }
+        catch {
+            // Tracing should never block launching the runtime.
+        }
+    }
+}
+function findFreePort() {
+    return new Promise((resolve, reject) => {
+        const srv = net.createServer();
+        srv.listen(0, "127.0.0.1", () => {
+            const addr = srv.address();
+            if (addr && typeof addr === "object") {
+                srv.close(() => resolve(addr.port));
+            }
+            else {
+                srv.close(() => reject(new Error("Failed to obtain a free port")));
+            }
+        });
+        srv.on("error", reject);
+    });
+}
+function wait(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+export class NodeDebugger {
+    name = "node";
+    onModuleLoad;
+    onPause;
+    child;
+    ws;
+    cdpId = 0;
+    pendingCommandCallbacks = new Map();
+    paused = false;
+    wasmFilePath;
+    async launch(config) {
+        this.wasmFilePath = config.wasmFilePath;
+        const port = await findFreePort();
+        this.child = spawn(process.execPath, [
+            `--inspect=${port}`,
+            path.join(DIRNAME, "wasmEntry.js"),
+            config.wasmFilePath,
+            config.entryFunctionName,
+            ...config.args.map(String),
+        ], { stdio: ["pipe", "pipe", "pipe"] });
+        const wsUrl = await this.fetchWsUrl(port);
+        await this.connectCDP(wsUrl);
+    }
+    dispose() {
+        this.paused = false;
+        this.wasmFilePath = undefined;
+        this.ws?.close();
+        this.child?.kill();
+    }
+    isPaused() {
+        return this.paused;
+    }
+    pause() {
+        this.sendCommand("Debugger.pause");
+    }
+    async resume() {
+        await this.waitForCommand("Debugger.resume");
+        this.paused = false;
+    }
+    finishModuleLoad() {
+        this.sendCommand("Runtime.runIfWaitingForDebugger");
+    }
+    setWasmBreakpoint(module, bytecodeOffset, callbacks) {
+        this.sendCommand("Debugger.setBreakpointByUrl", {
+            url: module.url,
+            lineNumber: 0,
+            columnNumber: bytecodeOffset,
+        }, {
+            onSuccess: () => {
+                trace(`setWasmBreakpoint success offset=${bytecodeOffset}`);
+                callbacks?.onSuccess?.();
+            },
+            onError: (error) => {
+                trace(`setWasmBreakpoint error offset=${bytecodeOffset} message=${error.message}`);
+                callbacks?.onError?.(error);
+            },
+        });
+    }
+    async fetchWsUrl(port) {
+        const deadline = Date.now() + 5000;
+        while (Date.now() < deadline) {
+            try {
+                const resp = await fetch(`http://127.0.0.1:${port}/json`);
+                if (!resp.ok) {
+                    throw new Error(`inspector endpoint returned ${resp.status}`);
+                }
+                const [info] = (await resp.json());
+                if (info?.webSocketDebuggerUrl) {
+                    return info.webSocketDebuggerUrl;
+                }
+            }
+            catch {
+                // The inspector endpoint is not always ready immediately after spawn.
+            }
+            await wait(50);
+        }
+        throw new Error(`timed out waiting for inspector endpoint on port ${port}`);
+    }
+    sendCommand(method, params, callbacks) {
+        if (!this.ws) {
+            throw new Error("debugger is not connected");
+        }
+        const id = ++this.cdpId;
+        if (callbacks) {
+            this.pendingCommandCallbacks.set(id, callbacks);
+        }
+        this.ws.send(JSON.stringify({ id, method, params }));
+    }
+    waitForCommand(method, params) {
+        return new Promise((resolve, reject) => {
+            this.sendCommand(method, params, {
+                onSuccess: () => {
+                    resolve();
+                },
+                onError: (error) => {
+                    reject(error);
+                },
+            });
+        });
+    }
+    connectCDP(wsUrl) {
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(wsUrl);
+            this.ws = ws;
+            ws.addEventListener("open", () => {
+                void (async () => {
+                    try {
+                        trace("ws open -> Debugger.enable");
+                        await this.waitForCommand("Debugger.enable");
+                        trace("Debugger.enable -> Debugger.setBreakpointsActive");
+                        await this.waitForCommand("Debugger.setBreakpointsActive", { active: true });
+                        trace("Debugger.setBreakpointsActive -> Runtime.runIfWaitingForDebugger");
+                        await this.waitForCommand("Runtime.runIfWaitingForDebugger");
+                        trace("Runtime.runIfWaitingForDebugger -> launch ready");
+                        resolve();
+                    }
+                    catch (error) {
+                        reject(error instanceof Error ? error : new Error(String(error)));
+                    }
+                })();
+            });
+            ws.addEventListener("error", (e) => {
+                const message = e instanceof Error ? e.message : "WebSocket connection failed";
+                reject(new Error(message));
+            });
+            ws.addEventListener("message", (ev) => {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+                const msg = JSON.parse(String(ev.data));
+                if (typeof msg.id === "number") {
+                    this.handleCommandResponse(msg.id, msg);
+                    return;
+                }
+                if (msg.method === "Debugger.paused") {
+                    const reason = this.getPauseReason(msg.params);
+                    this.paused = true;
+                    trace(`Debugger.paused reason=${reason}`);
+                    void Promise.resolve(this.onPause?.({ reason })).catch((error) => {
+                        trace(`pause handler failed: ${error instanceof Error ? error.message : "unknown error"}`);
+                    });
+                    return;
+                }
+                if (msg.method === "Debugger.scriptParsed") {
+                    const params = msg.params;
+                    const lang = typeof params?.scriptLanguage === "string" ? params.scriptLanguage : "unknown";
+                    const url = typeof params?.url === "string" ? params.url : "";
+                    trace(`Debugger.scriptParsed language=${lang} url=${url}`);
+                    if (params && lang === "WebAssembly" && typeof params.scriptId === "string") {
+                        trace(`wasm module detected scriptId=${params.scriptId}`);
+                        void this.handleModuleLoad({
+                            scriptId: params.scriptId,
+                            url,
+                        }).catch((error) => {
+                            const message = error instanceof Error ? error.message : "unknown error";
+                            trace(`module load handler failed: ${message}`);
+                            process.stderr.write(`[node-debugger] module load handler failed: ${message}\n`);
+                        });
+                    }
+                }
+            });
+        });
+    }
+    handleCommandResponse(id, msg) {
+        const callbacks = this.pendingCommandCallbacks.get(id);
+        if (!callbacks) {
+            return;
+        }
+        this.pendingCommandCallbacks.delete(id);
+        if (msg.error) {
+            callbacks.onError?.(new Error(msg.error.message ?? "CDP command failed"));
+            return;
+        }
+        callbacks.onSuccess?.();
+    }
+    getPauseReason(params) {
+        if (Array.isArray(params?.hitBreakpoints) && params.hitBreakpoints.length > 0) {
+            return "breakpoint";
+        }
+        if (typeof params?.reason === "string") {
+            return params.reason;
+        }
+        return "unknown";
+    }
+    async handleModuleLoad(runtimeInfo) {
+        if (!this.wasmFilePath) {
+            throw new Error("wasm file path is not available");
+        }
+        const module = await DebuggerWasmModule.load(this.wasmFilePath, runtimeInfo);
+        void this.onModuleLoad?.(module);
+    }
+}
+//# sourceMappingURL=nodeDebugger.js.map

package/dist/debug_server/nodeDebugger.js.map

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

package/dist/debug_server/tests/debugSession.test.js

@@ -3,11 +3,15 @@
 import { DebugClient } from "@vscode/debugadapter-testsupport";
 import * as assert from "node:assert/strict";
 import * as path from "node:path";
-import { describe, it, beforeEach, afterEach } from "node:test";
+import { describe, it, before, beforeEach, afterEach } from "node:test";
 import { fileURLToPath } from "node:url";
 import { launchDapServer } from "./launcher.js";
+import { build } from "../../scripts/lib.js";
 const DIRNAME = path.dirname(fileURLToPath(import.meta.url));
 const DAP_SERVER = path.resolve(DIRNAME, "..", "..", "..", "dist", "debug_server", "dapServer.js");
+const TEST_MODULE_DIR = path.resolve(DIRNAME, "testModule");
+const TEST_MODULE_SOURCE = path.join(TEST_MODULE_DIR, "debugger_basic.ts");
+const TEST_MODULE_OUTPUT = path.join(TEST_MODULE_DIR, "build/debugger_basic.wasm");
 const waitForExit = (child, timeoutMs) => new Promise((resolve) => {
     if (child.exitCode !== null) {
         resolve(true);
@@ -23,6 +27,19 @@ const waitForExit = (child, timeoutMs) => new Promise((resolve) => {
     };
     child.once("exit", onExit);
 });
+before(async () => {
+    let buildOutput = "";
+    const exitCode = await build({
+        argv: [TEST_MODULE_SOURCE, "-o", TEST_MODULE_OUTPUT, "--debug"],
+        cwd: TEST_MODULE_DIR,
+        onStdout: (chunk) => {
+            buildOutput += chunk;
+        },
+    });
+    if (exitCode !== 0) {
+        throw new Error(`failed to build debugger test module: ${buildOutput}`);
+    }
+});
 void describe("WarpoDebugSession", () => {
     let dc;
     let serverChild;
@@ -57,5 +74,32 @@ void describe("WarpoDebugSession", () => {
         assert.equal(response.body.breakpoints[1].verified, true);
         assert.equal(response.body.breakpoints[1].line, 10);
     });
+    void it("should report the built wasm as a loaded source on launch", { timeout: 5000 }, async () => {
+        await dc.initializeRequest();
+        const breakpointResponse = await dc.setBreakpointsRequest({
+            source: { path: TEST_MODULE_SOURCE },
+            breakpoints: [{ line: 3 }],
+        });
+        assert.equal(breakpointResponse.body.breakpoints.length, 1);
+        assert.equal(breakpointResponse.body.breakpoints[0].verified, true);
+        assert.equal(breakpointResponse.body.breakpoints[0].line, 3);
+        const launchArgs = {
+            program: TEST_MODULE_OUTPUT,
+            launchType: "wasm file",
+            runtime: "node",
+            entryFunctionName: "_start",
+        };
+        const loadedSourcePromise = dc.waitForEvent("loadedSource");
+        const stoppedPromise = dc.waitForEvent("stopped");
+        await dc.launchRequest(launchArgs);
+        const loadedSourceEvent = await loadedSourcePromise;
+        const loadedSourceBody = loadedSourceEvent.body;
+        const stoppedEvent = await stoppedPromise;
+        const stoppedBody = stoppedEvent.body;
+        assert.equal(loadedSourceBody?.reason, "new");
+        assert.equal(loadedSourceBody?.source?.path, path.resolve(TEST_MODULE_OUTPUT));
+        assert.equal(loadedSourceBody?.source?.name, path.basename(TEST_MODULE_OUTPUT));
+        assert.equal(stoppedBody?.reason, "breakpoint");
+    });
 });
 //# sourceMappingURL=debugSession.test.js.map

package/dist/debug_server/tests/debugSession.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"debugSession.test.js","sourceRoot":"","sources":["../../../tools/debug_server/tests/debugSession.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"debugSession.test.js","sourceRoot":"","sources":["../../../tools/debug_server/tests/debugSession.test.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sCAAsC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAE/D,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAwB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;AACnG,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAC5D,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC;AAC3E,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,2BAA2B,CAAC,CAAC;AAEnF,MAAM,WAAW,GAAG,CAAC,KAA+B,EAAE,SAAiB,EAAoB,EAAE,CAC3F,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,CAAC;QACd,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC,EAAE,SAAS,CAAC,CAAC;IAEd,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC7B,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,KAAK,IAAI,EAAE;IAChB,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC;QAC3B,IAAI,EAAE,CAAC,kBAAkB,EAAE,IAAI,EAAE,kBAAkB,EAAE,SAAS,CAAC;QAC/D,GAAG,EAAE,eAAe;QACpB,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;YAC1B,WAAW,IAAI,KAAK,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;IACH,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,yCAAyC,WAAW,EAAE,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,KAAK,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACtC,IAAI,EAAe,CAAC;IACpB,IAAI,WAAqC,CAAC;IAE1C,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;QAC1D,WAAW,GAAG,KAAK,CAAC;QACpB,EAAE,GAAG,IAAI,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;QAC5C,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,WAAW,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,KAAK,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,EAAE,CAAC,iBAAiB,EAAE,CAAC;QAE7B,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,qBAAqB,CAAC;YAC9C,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC3B,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;SACzC,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC1D,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC1D,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,KAAK,EAAE,CAAC,2DAA2D,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,IAAI,EAAE;QACjG,MAAM,EAAE,CAAC,iBAAiB,EAAE,CAAC;QAE7B,MAAM,kBAAkB,GAAG,MAAM,EAAE,CAAC,qBAAqB,CAAC;YACxD,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE;YACpC,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;SAC3B,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACpE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAE7D,MAAM,UAAU,GAKZ;YACF,OAAO,EAAE,kBAAkB;YAC3B,UAAU,EAAE,WAAW;YACvB,OAAO,EAAE,MAAM;YACf,iBAAiB,EAAE,QAAQ;SAC5B,CAAC;QAEF,MAAM,mBAAmB,GAAG,EAAE,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;QAC5D,MAAM,cAAc,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAElD,MAAM,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAEnC,MAAM,iBAAiB,GAAG,MAAM,mBAAmB,CAAC;QACpD,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,IAAsE,CAAC;QAClH,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC;QAC1C,MAAM,WAAW,GAAG,YAAY,CAAC,IAAuC,CAAC;QAEzE,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAC/E,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAChF,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/debug_server/tests/testModule/debugger_basic.d.ts

@@ -0,0 +1 @@
+export declare function _start(): i32;

package/dist/debug_server/tests/testModule/debugger_basic.js

@@ -0,0 +1,6 @@
+// @ts-nocheck
+export function _start() {
+    let a = 1;
+    return a;
+}
+//# sourceMappingURL=debugger_basic.js.map

package/dist/debug_server/tests/testModule/debugger_basic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugger_basic.js","sourceRoot":"","sources":["../../../../tools/debug_server/tests/testModule/debugger_basic.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,MAAM,UAAU,MAAM;IACpB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/debug_server/wasmEntry.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/debug_server/wasmEntry.js

@@ -0,0 +1,36 @@
+// Copyright (C) 2025 wasm-ecosystem
+// SPDX-License-Identifier: Apache-2.0
+/* eslint-disable n/no-process-exit, unicorn/no-process-exit */
+import * as fs from "node:fs";
+import * as inspector from "node:inspector";
+import * as path from "node:path";
+const [wasmFilePath, entryFunctionName, ...rawArgs] = process.argv.slice(2);
+if (!wasmFilePath || !entryFunctionName) {
+    console.error("Usage: wasmEntry.js <wasmFilePath> <entryFunctionName> [args...]");
+    process.exit(1);
+}
+const resolvedPath = path.resolve(wasmFilePath);
+if (!fs.existsSync(resolvedPath)) {
+    console.error(`Wasm file not found: ${resolvedPath}`);
+    process.exit(1);
+}
+const args = rawArgs.map(Number);
+async function main() {
+    inspector.waitForDebugger();
+    const buffer = fs.readFileSync(resolvedPath);
+    const module = await WebAssembly.compile(buffer);
+    const instance = await WebAssembly.instantiate(module, {});
+    inspector.waitForDebugger();
+    const fn = instance.exports[entryFunctionName];
+    if (typeof fn !== "function") {
+        const keys = Object.keys(instance.exports).join(", ");
+        console.error(`Export "${entryFunctionName}" is not a function. Available exports: ${keys}`);
+        process.exit(1);
+    }
+    console.log(`Calling ${entryFunctionName}(${args.join(", ")})...`);
+    const result = fn(...args);
+    // eslint-disable-next-line @typescript-eslint/no-base-to-string, @typescript-eslint/restrict-template-expressions
+    console.log(`Result: ${result}`);
+}
+await main();
+//# sourceMappingURL=wasmEntry.js.map

package/dist/debug_server/wasmEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasmEntry.js","sourceRoot":"","sources":["../../tools/debug_server/wasmEntry.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sCAAsC;AACtC,+DAA+D;AAE/D,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,CAAC,YAAY,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE5E,IAAI,CAAC,YAAY,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACxC,OAAO,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;IAClF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AAChD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;IACjC,OAAO,CAAC,KAAK,CAAC,wBAAwB,YAAY,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAEjC,KAAK,UAAU,IAAI;IACjB,SAAS,CAAC,eAAe,EAAE,CAAC;IAE5B,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAE3D,SAAS,CAAC,eAAe,EAAE,CAAC;IAE5B,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC/C,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,OAAO,CAAC,KAAK,CAAC,WAAW,iBAAiB,2CAA2C,IAAI,EAAE,CAAC,CAAC;QAC7F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,WAAW,iBAAiB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnE,MAAM,MAAM,GAAI,EAAkC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5D,kHAAkH;IAClH,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,IAAI,EAAE,CAAC"}

package/dist/heap_analyzer/src/comparison.d.ts

@@ -0,0 +1,2 @@
+import type { HeapComparison, HeapSnapshot } from "./types.js";
+export declare function compareSnapshots(before: HeapSnapshot, after: HeapSnapshot): HeapComparison;

package/dist/heap_analyzer/src/comparison.js

@@ -0,0 +1,77 @@
+// Copyright (C) 2026 wasm-ecosystem
+// SPDX-License-Identifier: Apache-2.0
+export function compareSnapshots(before, after) {
+    const beforeConstructors = new Map(before.constructors.map((entry) => [entry.className, entry]));
+    const afterConstructors = new Map(after.constructors.map((entry) => [entry.className, entry]));
+    const classNames = new Set([...beforeConstructors.keys(), ...afterConstructors.keys()]);
+    return {
+        beforeTotalHeapSize: before.totalHeapSize,
+        afterTotalHeapSize: after.totalHeapSize,
+        totalHeapSizeDelta: after.totalHeapSize - before.totalHeapSize,
+        beforeTotalLiveSize: before.totalLiveSize,
+        afterTotalLiveSize: after.totalLiveSize,
+        totalLiveSizeDelta: after.totalLiveSize - before.totalLiveSize,
+        constructors: [...classNames]
+            .map((className) => compareConstructorEntries(className, beforeConstructors.get(className), afterConstructors.get(className)))
+            .filter((entry) => entry.instances.length > 0)
+            .toSorted(sortConstructorComparisons),
+    };
+}
+function compareConstructorEntries(className, beforeEntry, afterEntry) {
+    const beforeInstancesByAddress = indexInstancesByAddress(beforeEntry?.instances ?? []);
+    const afterInstancesByAddress = indexInstancesByAddress(afterEntry?.instances ?? []);
+    const newInstances = [...afterInstancesByAddress.entries()]
+        .filter(([address]) => !beforeInstancesByAddress.has(address))
+        .map(([, instance]) => ({
+        address: instance.address,
+        shallowSize: instance.shallowSize,
+        retainedSize: instance.retainedSize,
+        changeKind: "new",
+    }));
+    const deletedInstances = [...beforeInstancesByAddress.entries()]
+        .filter(([address]) => !afterInstancesByAddress.has(address))
+        .map(([, instance]) => ({
+        address: instance.address,
+        shallowSize: instance.shallowSize,
+        retainedSize: instance.retainedSize,
+        changeKind: "delete",
+    }));
+    const instances = [...newInstances, ...deletedInstances].toSorted(sortComparisonInstances);
+    const allocatedSize = sumShallowSize(newInstances);
+    const freedSize = sumShallowSize(deletedInstances);
+    return {
+        className,
+        newCount: newInstances.length,
+        deletedCount: deletedInstances.length,
+        countDelta: newInstances.length - deletedInstances.length,
+        allocatedSize,
+        freedSize,
+        sizeDelta: allocatedSize - freedSize,
+        instances,
+    };
+}
+function indexInstancesByAddress(instances) {
+    return new Map(instances.map((instance) => [instance.address, instance]));
+}
+function sortConstructorComparisons(lhs, rhs) {
+    return (rhs.sizeDelta - lhs.sizeDelta ||
+        rhs.allocatedSize - lhs.allocatedSize ||
+        rhs.countDelta - lhs.countDelta ||
+        lhs.className.localeCompare(rhs.className));
+}
+function sortComparisonInstances(lhs, rhs) {
+    return (compareChangeKind(lhs.changeKind, rhs.changeKind) ||
+        rhs.shallowSize - lhs.shallowSize ||
+        rhs.retainedSize - lhs.retainedSize ||
+        lhs.address - rhs.address);
+}
+function compareChangeKind(lhs, rhs) {
+    if (lhs === rhs) {
+        return 0;
+    }
+    return lhs === "new" ? -1 : 1;
+}
+function sumShallowSize(instances) {
+    return instances.reduce((sum, instance) => sum + instance.shallowSize, 0);
+}
+//# sourceMappingURL=comparison.js.map

package/dist/heap_analyzer/src/comparison.js.map

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

package/dist/heap_analyzer/src/constants.d.ts

@@ -0,0 +1,21 @@
+export declare const AL_BITS = 4;
+export declare const AL_SIZE: number;
+export declare const AL_MASK: number;
+export declare const BLOCK_OVERHEAD = 4;
+export declare const OBJECT_OVERHEAD = 16;
+export declare const TOTAL_OVERHEAD: number;
+export declare const SL_BITS = 4;
+export declare const SB_BITS = 8;
+export declare const FL_BITS = 23;
+export declare const SL_SIZE: number;
+export declare const ROOT_SIZE = 1572;
+export declare const FREE = 1;
+export declare const LEFT_FREE = 2;
+export declare const TAGS_MASK = 3;
+export declare const COLOR_MASK = 3;
+export declare const GC_COLOR_GRAY = 2;
+export declare const GC_COLOR_TRANSPARENT = 3;
+export declare const DUMP_MAGIC = 1145590593;
+export declare const DUMP_MAGIC_BYTES: Uint8Array<ArrayBuffer>;
+export declare const DUMP_VERSION = 2;
+export declare const DUMP_HEADER_SIZE = 24;

package/dist/heap_analyzer/src/constants.js

@@ -0,0 +1,30 @@
+// Copyright (C) 2026 wasm-ecosystem
+// SPDX-License-Identifier: Apache-2.0
+// TLSF Allocator Constants (32-bit)
+export const AL_BITS = 4;
+export const AL_SIZE = 1 << AL_BITS; // 16
+export const AL_MASK = AL_SIZE - 1; // 15
+export const BLOCK_OVERHEAD = 4; // mmInfo only
+export const OBJECT_OVERHEAD = 16; // nextWithColor + prev + rtId + rtSize
+export const TOTAL_OVERHEAD = BLOCK_OVERHEAD + OBJECT_OVERHEAD; // 20
+export const SL_BITS = 4;
+export const SB_BITS = 8;
+export const FL_BITS = 23;
+export const SL_SIZE = 1 << SL_BITS; // 16
+export const ROOT_SIZE = 1572; // TLSF root structure size
+// Block flags (in mmInfo)
+export const FREE = 1;
+export const LEFT_FREE = 2;
+export const TAGS_MASK = 3;
+// GC Color (in nextWithColor & 3)
+export const COLOR_MASK = 3;
+// 0 and 1 are white/black but swap each GC cycle (white ^= 1 in rt/itcms.ts)
+// Only gray (2) and transparent (3) have fixed meaning
+export const GC_COLOR_GRAY = 2;
+export const GC_COLOR_TRANSPARENT = 3; // pinned, always reachable
+// Dump file
+export const DUMP_MAGIC = 0x44485341; // "A S H D" in LE
+export const DUMP_MAGIC_BYTES = new Uint8Array([0x41, 0x53, 0x48, 0x44]); // A, S, H, D
+export const DUMP_VERSION = 2;
+export const DUMP_HEADER_SIZE = 24;
+//# sourceMappingURL=constants.js.map

package/dist/heap_analyzer/src/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../tools/heap_analyzer/src/constants.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sCAAsC;AAEtC,oCAAoC;AACpC,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC;AACzB,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,KAAK;AAC1C,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK;AAEzC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,CAAC,cAAc;AAC/C,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC,CAAC,uCAAuC;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,GAAG,eAAe,CAAC,CAAC,KAAK;AAErE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC;AACzB,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC;AACzB,MAAM,CAAC,MAAM,OAAO,GAAG,EAAE,CAAC;AAC1B,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,KAAK;AAC1C,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,2BAA2B;AAE1D,0BAA0B;AAC1B,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC;AACtB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAC3B,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAE3B,kCAAkC;AAClC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAC5B,6EAA6E;AAC7E,uDAAuD;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,CAAC,2BAA2B;AAElE,YAAY;AACZ,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,kBAAkB;AACxD,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa;AACvF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAC9B,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC"}

package/dist/heap_analyzer/src/debugInfoResolver.d.ts

@@ -0,0 +1,30 @@
+import { type ClassLayout, type GlobalRoot } from "./types.js";
+export declare function attachBuiltinKind(classLayout: Pick<ClassLayout, "name" | "builtinKind">): void;
+/**
+ * Resolves class layouts and global-root metadata from WebAssembly debug
+ * information and provides helper queries for reference scanning.
+ *
+ * Only classes with a runtime ID (`DW_AT_signature`) are included.
+ */
+export declare class DebugInfoResolver {
+    private readonly layoutMap;
+    private readonly globalVariableDebugInfos;
+    private readonly wasmGlobalEntries;
+    private constructor();
+    static fromWasm(wasmBinary: Uint8Array | ArrayBuffer): DebugInfoResolver;
+    getLayouts(): ClassLayout[];
+    /** Returns class name, or "Class#<id>" if not found in debug info */
+    getClassName(classId: number): string;
+    /** Returns ClassDef or undefined */
+    getClassDef(classId: number): ClassLayout | undefined;
+    getGlobalRoots(mutableI32GlobalValues: number[]): GlobalRoot[];
+    /** Maps i32 wasm global indices to runtime mutable values or immutable initial values. */
+    private buildI32GlobalValueMap;
+}
+/**
+ * Resolve all class layouts from DWARF debug information embedded in a
+ * WebAssembly binary.
+ *
+ * Only classes with a runtime ID (`DW_AT_signature`) are included.
+ */
+export declare function resolveClassLayouts(wasmBinary: Uint8Array | ArrayBuffer): ClassLayout[];