bvisor 0.0.1

package/README.md

@@ -0,0 +1,12 @@
+# bVisor Node SDK
+
+Node.js bindings for bVisor. Linux only.
+
+## Dev
+
+Requires: Zig 0.16+, Docker
+
+```bash
+npm run dev    # builds native binaries (zig build), then runs test.ts in a linux container
+```
+

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { Sandbox } from "./src/sandbox";

package/dist/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Sandbox = void 0;
+var sandbox_1 = require("./src/sandbox");
+Object.defineProperty(exports, "Sandbox", { enumerable: true, get: function () { return sandbox_1.Sandbox; } });

package/dist/src/napi.d.ts

@@ -0,0 +1,5 @@
+declare const __external: unique symbol;
+export type External<T> = unknown & {
+    [__external]: T;
+};
+export {};

package/dist/src/napi.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/native.d.ts

@@ -0,0 +1,11 @@
+import { External } from "./napi";
+/** FFI contract: typed interface for the native Zig module loaded via require(). */
+export interface NativeModule {
+    createSandbox(): External<"Sandbox">;
+    sandboxRunCmd(sandbox: External<"Sandbox">, command: string): {
+        stdout: External<"Stream">;
+        stderr: External<"Stream">;
+    };
+    streamNext(stream: External<"Stream">): Uint8Array | null;
+}
+export declare const native: NativeModule;

package/dist/src/native.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.native = void 0;
+const os_1 = require("os");
+const detect_libc_1 = require("detect-libc");
+if ((0, os_1.platform)() !== "linux") {
+    throw new Error("bVisor only supports Linux");
+}
+const libc = (0, detect_libc_1.familySync)() === detect_libc_1.MUSL ? "musl" : "gnu";
+exports.native = require(`@bvisor/linux-${(0, os_1.arch)()}-${libc}`);

package/dist/src/sandbox.d.ts

@@ -0,0 +1,11 @@
+export declare class Sandbox {
+    private ptr;
+    constructor();
+    runCmd(command: string): Output;
+}
+export interface Output {
+    stdoutStream: ReadableStream<Uint8Array>;
+    stderrStream: ReadableStream<Uint8Array>;
+    stdout: () => Promise<string>;
+    stderr: () => Promise<string>;
+}

package/dist/src/sandbox.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Sandbox = void 0;
+const native_1 = require("./native");
+class Stream {
+    constructor(ptr) {
+        this.ptr = ptr;
+    }
+    toReadableStream() {
+        const self = this;
+        return new ReadableStream({
+            async pull(controller) {
+                // TODO: make streamNext return a promise
+                const chunk = native_1.native.streamNext(self.ptr);
+                if (chunk) {
+                    controller.enqueue(chunk);
+                }
+                else {
+                    controller.close();
+                }
+            },
+        });
+    }
+}
+class Sandbox {
+    constructor() {
+        this.ptr = native_1.native.createSandbox();
+    }
+    runCmd(command) {
+        const result = native_1.native.sandboxRunCmd(this.ptr, command);
+        return createOutput(new Stream(result.stdout).toReadableStream(), new Stream(result.stderr).toReadableStream());
+    }
+}
+exports.Sandbox = Sandbox;
+function createOutput(stdoutStream, stderrStream) {
+    return {
+        stdoutStream,
+        stderrStream,
+        stdout: () => new Response(stdoutStream).text(),
+        stderr: () => new Response(stderrStream).text(),
+    };
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "bvisor",
+  "version": "0.0.1",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "predev": "cd ../../.. && zig build",
+    "dev": "docker run --rm -v .:/app -w /app oven/bun:alpine sh -c 'bun install && bun test.ts'"
+  },
+  "dependencies": {
+    "detect-libc": "^2.0.3"
+  },
+  "optionalDependencies": {
+    "@bvisor/linux-arm64-musl": "0.0.1",
+    "@bvisor/linux-arm64-gnu": "0.0.1",
+    "@bvisor/linux-x64-musl": "0.0.1",
+    "@bvisor/linux-x64-gnu": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.0",
+    "typescript": "^5.0.0"
+  }
+}