virtual-machine 0.0.31 → 0.0.35

package/native/index.d.ts

@@ -0,0 +1,61 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+/** Connection status for JavaScript */
+export const enum ConnectionStatus {
+  Disconnected = 0,
+  Connecting = 1,
+  Connected = 2,
+  Error = 3
+}
+/**
+ * WebTransport client for Node.js.
+ *
+ * This class provides WebTransport connectivity using the same implementation
+ * as the native Rust VM. It maintains a persistent connection with automatic
+ * reconnection and heartbeat handling.
+ */
+export declare class WebTransportClient {
+  /**
+   * Create a new WebTransport client and start connecting.
+   *
+   * @param url - WebTransport server URL (e.g., "https://localhost:4433")
+   * @param certHash - Optional certificate hash for self-signed certs (hex string)
+   */
+  constructor(url: string, certHash?: string | undefined | null)
+  /** Check if connected to the relay server. */
+  isConnected(): boolean
+  /** Check if registered with the relay (IP assigned). */
+  isRegistered(): boolean
+  /** Get current connection status. */
+  status(): ConnectionStatus
+  /** Get the MAC address as a hex string. */
+  macAddress(): string
+  /** Get the MAC address as a byte array. */
+  macBytes(): Array<number>
+  /** Get the assigned IP address (if any) as a string. */
+  assignedIp(): string | null
+  /** Get the assigned IP address as bytes (if any). */
+  assignedIpBytes(): Array<number> | null
+  /** Get the number of connection attempts. */
+  connectionAttempts(): number
+  /**
+   * Send an Ethernet frame to the relay.
+   * Returns true if sent successfully, false if not connected.
+   */
+  send(data: Buffer): boolean
+  /**
+   * Receive an Ethernet frame from the relay (non-blocking).
+   * Returns the frame data or undefined if no frame available.
+   */
+  recv(): Buffer | null
+  /**
+   * Receive all pending Ethernet frames (non-blocking).
+   * Returns an array of frame buffers.
+   */
+  recvAll(): Array<Buffer>
+  /** Shut down the connection and cleanup. */
+  shutdown(): void
+}

package/native/index.js

@@ -0,0 +1,125 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/**
+ * Native bindings loader for riscv-vm
+ * 
+ * This module detects the current platform and loads the appropriate
+ * pre-built native binary. All binaries are bundled in this package.
+ * 
+ * Supported platforms:
+ * - darwin-x64 (macOS Intel)
+ * - darwin-arm64 (macOS Apple Silicon)
+ * - linux-x64-gnu (Linux x64 glibc)
+ * - linux-x64-musl (Linux x64 musl/Alpine)
+ * - linux-arm64-gnu (Linux ARM64 glibc)
+ * - linux-arm64-musl (Linux ARM64 musl/Alpine)
+ * - win32-x64-msvc (Windows x64)
+ */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let loadError = null
+
+/**
+ * Detect if running on musl libc (Alpine Linux, etc.)
+ */
+function isMusl() {
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+/**
+ * Load a native binding from the native directory
+ */
+function loadNativeBinding(filename) {
+  const filepath = join(__dirname, filename)
+  if (!existsSync(filepath)) {
+    throw new Error(
+      `Native binding not found: ${filename}\n` +
+      `Expected at: ${filepath}\n` +
+      `Platform: ${platform}, Architecture: ${arch}\n\n` +
+      `This platform may not be supported, or the package was not installed correctly.\n` +
+      `Try reinstalling the package: npm install virtual-machine`
+    )
+  }
+  return require(filepath)
+}
+
+/**
+ * Determine the correct native binding filename for the current platform
+ */
+function getNativeBindingFilename() {
+  switch (platform) {
+    case 'darwin':
+      switch (arch) {
+        case 'x64':
+          return 'riscv-vm-native.darwin-x64.node'
+        case 'arm64':
+          return 'riscv-vm-native.darwin-arm64.node'
+        default:
+          throw new Error(`Unsupported architecture on macOS: ${arch}`)
+      }
+
+    case 'linux':
+      const musl = isMusl()
+      switch (arch) {
+        case 'x64':
+          return musl 
+            ? 'riscv-vm-native.linux-x64-musl.node'
+            : 'riscv-vm-native.linux-x64-gnu.node'
+        case 'arm64':
+          return musl
+            ? 'riscv-vm-native.linux-arm64-musl.node'
+            : 'riscv-vm-native.linux-arm64-gnu.node'
+        default:
+          throw new Error(`Unsupported architecture on Linux: ${arch}`)
+      }
+
+    case 'win32':
+      switch (arch) {
+        case 'x64':
+          return 'riscv-vm-native.win32-x64-msvc.node'
+        default:
+          throw new Error(`Unsupported architecture on Windows: ${arch}`)
+      }
+
+    default:
+      throw new Error(`Unsupported platform: ${platform}`)
+  }
+}
+
+// Load the native binding
+try {
+  const filename = getNativeBindingFilename()
+  nativeBinding = loadNativeBinding(filename)
+} catch (e) {
+  loadError = e
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error('Failed to load native binding')
+}
+
+// Export the native binding APIs
+const { ConnectionStatus, WebTransportClient } = nativeBinding
+
+module.exports.ConnectionStatus = ConnectionStatus
+module.exports.WebTransportClient = WebTransportClient

package/native/index.mjs

@@ -0,0 +1,9 @@
+/**
+ * ESM wrapper for native addon.
+ */
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const native = require('./index.js');
+
+export const { ConnectionStatus, WebTransportClient } = native;
+

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "virtual-machine",
-  "version": "0.0.31",
-  "description": "",
+  "version": "0.0.35",
+  "description": "RISC-V Virtual Machine with WASM and Node.js native support",
   "bin": "build/cli.js",
   "publishConfig": {
     "access": "public"
@@ -19,13 +19,36 @@
       "types": "./build/worker.d.ts",
       "import": "./build/worker.mjs",
       "require": "./build/worker.js"
+    },
+    "./native": {
+      "import": "./native/index.mjs",
+      "require": "./native/index.js"
+    }
+  },
+  "napi": {
+    "name": "riscv-vm-native",
+    "triples": {
+      "defaults": false,
+      "additional": [
+        "x86_64-apple-darwin",
+        "aarch64-apple-darwin",
+        "x86_64-unknown-linux-gnu",
+        "aarch64-unknown-linux-gnu",
+        "x86_64-unknown-linux-musl",
+        "aarch64-unknown-linux-musl",
+        "x86_64-pc-windows-msvc"
+      ]
     }
   },
   "files": [
-    "build"
+    "build",
+    "native"
   ],
   "scripts": {
-    "build": "rm -rf build && sh build.sh"
+    "build": "rm -rf build && sh build.sh",
+    "build:native": "napi build --platform --release --features napi --cargo-cwd . --cargo-flags=\"--lib\" native",
+    "build:native:debug": "napi build --platform --features napi --cargo-cwd . --cargo-flags=\"--lib\" native",
+    "build:all": "npm run build && npm run build:native"
   },
   "repository": {
     "type": "git",
@@ -39,6 +62,7 @@
   "packageManager": "yarn@4.11.0+sha512.4e54aeace9141df2f0177c266b05ec50dc044638157dae128c471ba65994ac802122d7ab35bcd9e81641228b7dcf24867d28e750e0bcae8a05277d600008ad54",
   "devDependencies": {
     "@esbuild-plugins/node-resolve": "^0.2.2",
+    "@napi-rs/cli": "^2.18.0",
     "@trust0/ridb-build": "^0.0.21",
     "@types/node": "^24.10.1",
     "tsup": "^8.4.0",

package/build/worker.d.ts

@@ -1,35 +0,0 @@
-/**
- * Web Worker entry point for RISC-V hart.
- *
- * This worker runs a secondary RISC-V hart sharing memory with the main thread
- * via SharedArrayBuffer.
- *
- * Communication protocol:
- *   Main → Worker: WorkerInitMessage
- *   Worker → Main: WorkerReadyMessage | WorkerHaltedMessage | WorkerErrorMessage
- */
-/** Message sent from main thread to initialize the worker */
-interface WorkerInitMessage {
-    hartId: number;
-    sharedMem: SharedArrayBuffer;
-    entryPc: number;
-}
-/** Message sent when worker is ready to execute */
-interface WorkerReadyMessage {
-    type: "ready";
-    hartId: number;
-}
-/** Message sent when worker has halted */
-interface WorkerHaltedMessage {
-    type: "halted";
-    hartId: number;
-}
-/** Message sent when an error occurs */
-interface WorkerErrorMessage {
-    type: "error";
-    hartId?: number;
-    error: string;
-}
-type WorkerOutboundMessage = WorkerReadyMessage | WorkerHaltedMessage | WorkerErrorMessage;
-
-export type { WorkerErrorMessage, WorkerHaltedMessage, WorkerInitMessage, WorkerOutboundMessage, WorkerReadyMessage };

package/build/worker.mjs

@@ -1,54 +0,0 @@
-import {
-  riscv_vm_default,
-  worker_entry
-} from "./chunk-CP2XF74Q.mjs";
-
-// worker.ts
-var initialized = false;
-self.onmessage = async (event) => {
-  const { hartId, sharedMem, entryPc } = event.data;
-  console.log(`[Worker ${hartId}] Received init message`);
-  if (!initialized) {
-    try {
-      await riscv_vm_default();
-      initialized = true;
-      console.log(`[Worker ${hartId}] WASM initialized`);
-    } catch (e) {
-      console.error(`[Worker ${hartId}] WASM init failed:`, e);
-      const msg = {
-        type: "error",
-        hartId,
-        error: String(e)
-      };
-      self.postMessage(msg);
-      return;
-    }
-  }
-  const readyMsg = { type: "ready", hartId };
-  self.postMessage(readyMsg);
-  try {
-    const pc = BigInt(Math.floor(entryPc));
-    console.log(`[Worker ${hartId}] Starting execution at PC=0x${pc.toString(16)}`);
-    worker_entry(hartId, sharedMem, pc);
-  } catch (e) {
-    console.error(`[Worker ${hartId}] Execution error:`, e);
-    const msg = {
-      type: "error",
-      hartId,
-      error: String(e)
-    };
-    self.postMessage(msg);
-    return;
-  }
-  console.log(`[Worker ${hartId}] Halted`);
-  const haltedMsg = { type: "halted", hartId };
-  self.postMessage(haltedMsg);
-};
-self.onerror = (e) => {
-  console.error("[Worker] Uncaught error:", e);
-  const msg = {
-    type: "error",
-    error: e.message || String(e)
-  };
-  self.postMessage(msg);
-};