@ricsam/r5d-macos-vm 0.0.0 → 0.0.55

package/dist/cjs/cli.cjs

@@ -0,0 +1,179 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var cli_exports = {};
+__export(cli_exports, {
+  getHelpText: () => getHelpText,
+  invokeNativeProcess: () => invokeNativeProcess,
+  normalizeNativeArguments: () => normalizeNativeArguments,
+  runCli: () => runCli,
+  validateVmName: () => validateVmName
+});
+module.exports = __toCommonJS(cli_exports);
+var import_node_fs = __toESM(require("node:fs"), 1);
+var import_node_path = __toESM(require("node:path"), 1);
+var import_node_url = require("node:url");
+var import_node_child_process = require("node:child_process");
+var import_artifact_manifest = require("./artifact-manifest.cjs");
+var import_host = require("./host.cjs");
+var import_native_runtime = require("./native-runtime.cjs");
+const import_meta = {};
+function defaultModulePath() {
+  if (typeof __filename === "string") return __filename;
+  return (0, import_node_url.fileURLToPath)(import_meta.url);
+}
+const HELP = `Usage: r5d-macos-vm <command> [options]
+
+Commands:
+  doctor [--json]                 Check host and native virtualization support
+  create [name] [...]             Download macOS from Apple and create a VM
+  list [--json]                   List locally managed VMs
+  status [name] [--json]          Show VM state
+  start [name] [--json]           Start a VM in its window
+  run [name] [--json]             Alias for start
+  stop [name] [--force]           Stop a VM
+  delete <name> --yes [--purge]   Move a VM to Trash, or permanently purge it
+  cache prune                     Remove restore images and old native runners
+  --version                       Show the package version
+
+`;
+function findBootstrapDirectory(modulePath) {
+  const packageRoot = (0, import_artifact_manifest.findPackageRoot)(modulePath);
+  const candidate = packageRoot ? import_node_path.default.join(packageRoot, "bootstrap") : null;
+  if (candidate && import_node_fs.default.existsSync(candidate) && import_node_fs.default.statSync(candidate).isDirectory()) return candidate;
+  throw new Error("The guest bootstrap assets are missing. Reinstall @ricsam/r5d-macos-vm.");
+}
+const NAMED_COMMANDS = /* @__PURE__ */ new Set(["create", "run", "start", "status", "stop", "delete", "delete-check"]);
+function validateVmName(name) {
+  if (!/^[A-Za-z0-9][A-Za-z0-9_.-]{0,62}$/.test(name)) {
+    throw new Error("VM names must start with a letter or number and contain at most 63 letters, numbers, dots, underscores, or hyphens.");
+  }
+}
+function findCommandIndex(args) {
+  for (let index = 0; index < args.length; index += 1) {
+    if (args[index] === "--json") continue;
+    if (args[index] === "--state-root") {
+      index += 1;
+      continue;
+    }
+    return index;
+  }
+  return -1;
+}
+function normalizeNativeArguments(args, bootstrapDir) {
+  const normalized = [...args];
+  const commandIndex = findCommandIndex(normalized);
+  if (commandIndex < 0) return normalized;
+  const command = normalized[commandIndex];
+  if (NAMED_COMMANDS.has(command)) {
+    const nameOptionIndex = normalized.indexOf("--name");
+    if (nameOptionIndex >= 0) {
+      const name = normalized[nameOptionIndex + 1];
+      if (!name || name.startsWith("-")) throw new Error("Missing value for --name.");
+      validateVmName(name);
+    } else {
+      let positionalIndex = commandIndex + 1;
+      while (normalized[positionalIndex] === "--json" || normalized[positionalIndex] === "--state-root") {
+        if (normalized[positionalIndex] === "--state-root") positionalIndex += 2;
+        else positionalIndex += 1;
+      }
+      const positionalName = normalized[positionalIndex];
+      if (positionalName && !positionalName.startsWith("-")) {
+        validateVmName(positionalName);
+        normalized.splice(positionalIndex, 1, "--name", positionalName);
+      }
+    }
+  }
+  if (command === "create" && !normalized.includes("--bootstrap-dir")) {
+    normalized.push("--bootstrap-dir", bootstrapDir);
+  }
+  return normalized;
+}
+const invokeNativeProcess = (executable, args) => new Promise((resolve, reject) => {
+  const child = (0, import_node_child_process.spawn)(executable, [...args], { stdio: "inherit", shell: false });
+  const forwardSignal = (signal) => child.kill(signal);
+  const onSigint = () => forwardSignal("SIGINT");
+  const onSigterm = () => forwardSignal("SIGTERM");
+  process.once("SIGINT", onSigint);
+  process.once("SIGTERM", onSigterm);
+  child.once("error", reject);
+  child.once("close", (code, signal) => {
+    process.off("SIGINT", onSigint);
+    process.off("SIGTERM", onSigterm);
+    if (signal) resolve(128 + (signal === "SIGINT" ? 2 : 15));
+    else resolve(code ?? 1);
+  });
+});
+function resolveManifestPath(modulePath, explicitPath) {
+  if (explicitPath) return import_node_path.default.resolve(explicitPath);
+  const packageRoot = (0, import_artifact_manifest.findPackageRoot)(modulePath);
+  const candidate = packageRoot ? import_node_path.default.join(packageRoot, "native-artifact.json") : null;
+  if (!candidate || !import_node_fs.default.existsSync(candidate)) {
+    throw new Error("The native artifact manifest is missing. Reinstall @ricsam/r5d-macos-vm.");
+  }
+  return candidate;
+}
+async function runCli(args, dependencies = {}) {
+  const modulePath = dependencies.modulePath ?? defaultModulePath();
+  const stdout = dependencies.stdout ?? process.stdout;
+  const packageVersion = dependencies.packageVersion ?? (0, import_artifact_manifest.findPackageVersion)(modulePath);
+  if (args.length === 0 || args[0] === "--help" || args[0] === "-h" || args[0] === "help") {
+    stdout.write(HELP);
+    return 0;
+  }
+  if (args[0] === "--version" || args[0] === "-v" || args[0] === "version") {
+    stdout.write(`r5d-macos-vm ${packageVersion}
+`);
+    return 0;
+  }
+  (0, import_host.validateHostInformation)(dependencies.hostInformation ?? await (0, import_host.readHostInformation)());
+  const manifest = (0, import_artifact_manifest.readNativeArtifactManifest)(resolveManifestPath(modulePath, dependencies.manifestPath), packageVersion);
+  const executable = await (dependencies.ensureRuntime ?? import_native_runtime.ensureNativeRuntime)(manifest, dependencies.runtime);
+  const bootstrapDir = dependencies.bootstrapDir ?? findBootstrapDirectory(modulePath);
+  const nativeArgs = normalizeNativeArguments(args, bootstrapDir);
+  const exitCode = await (dependencies.invokeNative ?? invokeNativeProcess)(executable, nativeArgs);
+  const commandIndex = findCommandIndex(nativeArgs);
+  if (exitCode === 0 && commandIndex >= 0 && nativeArgs[commandIndex] === "cache" && nativeArgs[commandIndex + 1] === "prune") {
+    await (dependencies.pruneRuntimes ?? import_native_runtime.pruneObsoleteNativeRuntimes)(
+      executable,
+      dependencies.runtime?.cacheRoot ?? (0, import_native_runtime.defaultCacheRoot)()
+    );
+  }
+  return exitCode;
+}
+function getHelpText() {
+  return HELP;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getHelpText,
+  invokeNativeProcess,
+  normalizeNativeArguments,
+  runCli,
+  validateVmName
+});

package/dist/cjs/host.cjs

@@ -0,0 +1,62 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var host_exports = {};
+__export(host_exports, {
+  readHostInformation: () => readHostInformation,
+  validateHostInformation: () => validateHostInformation
+});
+module.exports = __toCommonJS(host_exports);
+var import_node_child_process = require("node:child_process");
+function runSwVers() {
+  return new Promise((resolve, reject) => {
+    const child = (0, import_node_child_process.spawn)("/usr/bin/sw_vers", ["-productVersion"], {
+      stdio: ["ignore", "pipe", "pipe"],
+      env: { ...process.env, LANG: "C", LC_ALL: "C" }
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.setEncoding("utf8").on("data", (chunk) => stdout += chunk);
+    child.stderr.setEncoding("utf8").on("data", (chunk) => stderr += chunk);
+    child.once("error", reject);
+    child.once("close", (code) => {
+      if (code === 0) resolve(stdout.trim());
+      else reject(new Error(`sw_vers failed (${code ?? "signal"}): ${stderr.trim()}`));
+    });
+  });
+}
+async function readHostInformation() {
+  return {
+    platform: process.platform,
+    architecture: process.arch,
+    macOSVersion: process.platform === "darwin" ? await runSwVers() : "unknown"
+  };
+}
+function validateHostInformation(host) {
+  if (host.platform !== "darwin") throw new Error("r5d-macos-vm requires macOS.");
+  if (host.architecture !== "arm64") throw new Error("r5d-macos-vm requires an Apple silicon Mac (arm64).");
+  const match = /^(\d+)(?:\.(\d+))?/.exec(host.macOSVersion);
+  if (!match || Number(match[1]) < 14) {
+    throw new Error(`r5d-macos-vm requires macOS 14 or newer (found ${host.macOSVersion}).`);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  readHostInformation,
+  validateHostInformation
+});

package/dist/cjs/main.cjs

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+"use strict";
+var import_cli = require("./cli.cjs");
+(0, import_cli.runCli)(process.argv.slice(2)).then((exitCode) => {
+  process.exitCode = exitCode;
+}).catch((error) => {
+  process.stderr.write(`r5d-macos-vm: ${error instanceof Error ? error.message : String(error)}
+`);
+  process.exitCode = 1;
+});