microsandbox 0.1.0 → 0.3.6

package/index.mjs

@@ -0,0 +1,21 @@
+// Auto-generated ESM wrapper for NAPI-RS CJS module.
+import binding from "./index.cjs";
+
+export const {
+  ExecHandle,
+  ExecOutput,
+  ExecSink,
+  Mount,
+  NetworkPolicy,
+  Sandbox,
+  SandboxFs,
+  SandboxHandle,
+  Secret,
+  Volume,
+  VolumeHandle,
+  allSandboxMetrics,
+  install,
+  isInstalled,
+} = binding;
+
+export default binding;

package/package.json

@@ -1,38 +1,39 @@
 {
   "name": "microsandbox",
-  "version": "0.1.0",
-  "description": "Microsandbox JavaScript SDK",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "test": "jest",
-    "lint": "eslint src --ext .ts",
-    "prepare": "npm run build"
+  "version": "0.3.6",
+  "main": "index.cjs",
+  "module": "index.mjs",
+  "types": "index.d.cts",
+  "napi": {
+    "binaryName": "microsandbox",
+    "packageName": "@superradcompany/microsandbox",
+    "targets": [
+      "aarch64-apple-darwin",
+      "x86_64-unknown-linux-gnu",
+      "aarch64-unknown-linux-gnu"
+    ]
   },
-  "keywords": [
-    "microsandbox",
-    "sdk"
-  ],
-  "author": "Microsandbox Team <team@microsandbox.dev>",
   "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/microsandbox/microsandbox.git"
+  "engines": {
+    "node": ">= 18"
   },
-  "bugs": {
-    "url": "https://github.com/microsandbox/microsandbox/issues"
+  "scripts": {
+    "build": "napi build --release --platform --js index.cjs --dts index.d.cts",
+    "build:debug": "napi build --platform --js index.cjs --dts index.d.cts",
+    "postinstall": "node postinstall.js"
   },
-  "homepage": "https://github.com/microsandbox/microsandbox",
   "devDependencies": {
-    "@types/jest": "^29.5.0",
-    "@types/node": "^18.15.0",
-    "eslint": "^8.36.0",
-    "jest": "^29.5.0",
-    "ts-jest": "^29.1.0",
-    "typescript": "^5.0.2"
-  }
+    "@napi-rs/cli": "^3"
+  },
+  "optionalDependencies": {
+    "@superradcompany/microsandbox-darwin-arm64": "0.3.6",
+    "@superradcompany/microsandbox-linux-x64-gnu": "0.3.6",
+    "@superradcompany/microsandbox-linux-arm64-gnu": "0.3.6"
+  },
+  "files": [
+    "index.cjs",
+    "index.mjs",
+    "index.d.cts",
+    "postinstall.js"
+  ]
 }

package/postinstall.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+
+// Downloads msb + libkrunfw binaries to ~/.microsandbox/{bin,lib}/ during npm install.
+
+const { execSync } = require("child_process");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const https = require("https");
+const http = require("http");
+
+const PREBUILT_VERSION = "0.3.5";
+const LIBKRUNFW_ABI = "5";
+const LIBKRUNFW_VERSION = "5.2.1";
+const GITHUB_ORG = "superradcompany";
+const REPO = "microsandbox";
+const BASE_DIR = path.join(os.homedir(), ".microsandbox");
+const BIN_DIR = path.join(BASE_DIR, "bin");
+const LIB_DIR = path.join(BASE_DIR, "lib");
+
+function getArch() {
+  const arch = process.arch;
+  if (arch === "arm64" || arch === "aarch64") return "aarch64";
+  if (arch === "x64" || arch === "x86_64") return "x86_64";
+  throw new Error(`Unsupported architecture: ${arch}`);
+}
+
+function getOS() {
+  const platform = process.platform;
+  if (platform === "darwin") return "darwin";
+  if (platform === "linux") return "linux";
+  throw new Error(`Unsupported platform: ${platform}`);
+}
+
+function libkrunfwFilename(targetOS) {
+  if (targetOS === "darwin") return `libkrunfw.${LIBKRUNFW_ABI}.dylib`;
+  return `libkrunfw.so.${LIBKRUNFW_VERSION}`;
+}
+
+function libkrunfwSymlinks(filename, targetOS) {
+  if (targetOS === "darwin") {
+    return [["libkrunfw.dylib", filename]];
+  }
+  const soname = `libkrunfw.so.${LIBKRUNFW_ABI}`;
+  return [
+    [soname, filename],
+    ["libkrunfw.so", soname],
+  ];
+}
+
+function bundleUrl(version, arch, targetOS) {
+  return `https://github.com/${GITHUB_ORG}/${REPO}/releases/download/v${version}/${REPO}-${targetOS}-${arch}.tar.gz`;
+}
+
+/** Follow redirects and return the response body as a Buffer. */
+function download(url) {
+  return new Promise((resolve, reject) => {
+    const get = url.startsWith("https:") ? https.get : http.get;
+    get(url, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return download(res.headers.location).then(resolve, reject);
+      }
+      if (res.statusCode !== 200) {
+        return reject(new Error(`HTTP ${res.statusCode} for ${url}`));
+      }
+      const chunks = [];
+      res.on("data", (chunk) => chunks.push(chunk));
+      res.on("end", () => resolve(Buffer.concat(chunks)));
+      res.on("error", reject);
+    }).on("error", reject);
+  });
+}
+
+/** Extract a .tar.gz buffer, routing files to bin/ or lib/. */
+function extractBundle(data) {
+  // Use tar CLI since Node doesn't have built-in tar support without dependencies.
+  const tmpFile = path.join(os.tmpdir(), `microsandbox-bundle-${Date.now()}.tar.gz`);
+  const tmpExtract = path.join(os.tmpdir(), `microsandbox-extract-${Date.now()}`);
+
+  try {
+    fs.writeFileSync(tmpFile, data);
+    fs.mkdirSync(tmpExtract, { recursive: true });
+    execSync(`tar xzf "${tmpFile}" -C "${tmpExtract}"`, { stdio: "pipe" });
+
+    for (const name of fs.readdirSync(tmpExtract)) {
+      const src = path.join(tmpExtract, name);
+      const dest = name.startsWith("libkrunfw")
+        ? path.join(LIB_DIR, name)
+        : path.join(BIN_DIR, name);
+      fs.copyFileSync(src, dest);
+      fs.chmodSync(dest, 0o755);
+    }
+  } finally {
+    try { fs.unlinkSync(tmpFile); } catch {}
+    try { fs.rmSync(tmpExtract, { recursive: true }); } catch {}
+  }
+}
+
+async function main() {
+  const targetOS = getOS();
+  const arch = getArch();
+  const libkrunfw = libkrunfwFilename(targetOS);
+
+  // Skip if already installed.
+  if (
+    fs.existsSync(path.join(BIN_DIR, "msb")) &&
+    fs.existsSync(path.join(LIB_DIR, libkrunfw))
+  ) {
+    return;
+  }
+
+  fs.mkdirSync(BIN_DIR, { recursive: true });
+  fs.mkdirSync(LIB_DIR, { recursive: true });
+
+  const url = bundleUrl(PREBUILT_VERSION, arch, targetOS);
+  console.log(`microsandbox: downloading runtime dependencies (v${PREBUILT_VERSION})...`);
+  const data = await download(url);
+
+  extractBundle(data);
+
+  // Create libkrunfw symlinks.
+  for (const [linkName, target] of libkrunfwSymlinks(libkrunfw, targetOS)) {
+    const linkPath = path.join(LIB_DIR, linkName);
+    try { fs.unlinkSync(linkPath); } catch {}
+    fs.symlinkSync(target, linkPath);
+  }
+
+  // Verify.
+  if (!fs.existsSync(path.join(BIN_DIR, "msb"))) {
+    throw new Error("msb binary not found after extraction");
+  }
+  if (!fs.existsSync(path.join(LIB_DIR, libkrunfw))) {
+    throw new Error(`${libkrunfw} not found after extraction`);
+  }
+
+  console.log("microsandbox: runtime dependencies installed.");
+}
+
+main().catch((err) => {
+  console.error(`microsandbox: failed to install runtime dependencies: ${err.message}`);
+  console.error("You can install them manually: curl -fsSL https://get.microsandbox.dev | sh");
+  // Don't fail the npm install — the user can install manually.
+  process.exit(0);
+});

package/dist/index.d.ts

@@ -1,12 +0,0 @@
-/**
- * Microsandbox JavaScript SDK
- *
- * A minimal SDK for the Microsandbox project.
- */
-/**
- * Returns a greeting message for the given name.
- *
- * @param name - The name to greet
- * @returns A greeting message
- */
-export declare function greet(name: string): string;

package/dist/index.js

@@ -1,19 +0,0 @@
-"use strict";
-/**
- * Microsandbox JavaScript SDK
- *
- * A minimal SDK for the Microsandbox project.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.greet = greet;
-/**
- * Returns a greeting message for the given name.
- *
- * @param name - The name to greet
- * @returns A greeting message
- */
-function greet(name) {
-    const message = `Hello, ${name}! Welcome to Microsandbox!`;
-    console.log(message);
-    return message;
-}