@tomasko/mb 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,53 @@
-# Temporary Holding Version
+# mb (npm)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+npm wrapper for [`mb`](../../README.md) — a MoonBit-native, uv-style toolchain
+and package manager.
+
+```bash
+pnpm install -g @tomasko/mb
+mb --help
+mb moon install 0.10.14
+mb tool install bobzhang/zip
+```
+
+## How it works
+
+The package itself contains only a small launcher. On install,
+`install.js` downloads the prebuilt `mb` binary for the current platform from
+GitHub Releases and writes it to `bin/mb`. The published `bin` entry
+(`bin/mb.js`) then spawns it, forwarding arguments and standard IO.
+
+Supported targets:
+
+| Node `platform-arch` | Release asset       |
+| -------------------- | ------------------- |
+| `linux-x64`          | `mb-linux-x86_64`   |
+| `linux-arm64`        | `mb-linux-aarch64`  |
+| `darwin-arm64`       | `mb-darwin-aarch64` |
+
+Intel macOS (`darwin-x64`) is not supported: the MoonBit toolchain no longer
+ships a `darwin-x86_64` target, so no such build can be produced.
+
+Assets are produced by `.github/workflows/release.yml` when a `v*` tag is
+pushed.
+
+## Overrides
+
+| Variable             | Purpose                                          |
+| -------------------- | ------------------------------------------------ |
+| `MB_REPO`            | `owner/repo` to download from                    |
+| `MB_VERSION`         | release version to download                      |
+| `MB_DOWNLOAD_BASE`   | full base URL (mirror), e.g. `https://host/assets` |
+| `MB_FORCE_DOWNLOAD`  | re-download even if the binary is present        |
+| `MB_SKIP_DOWNLOAD`   | skip the download entirely                       |
+
+## Publishing
+
+From this directory:
+
+```bash
+npm publish --access public
+```
+
+Change `name`, `repository` and `homepage` in `package.json` first if you
+publish under a different scope or repository.

package/bin/mb.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+// Thin launcher for the downloaded native `mb` binary.
+"use strict";
+
+const { spawnSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+
+const ext = process.platform === "win32" ? ".exe" : "";
+const binary = path.join(__dirname, "mb" + ext);
+
+if (!fs.existsSync(binary)) {
+  console.error(
+    `mb: native binary not found at ${binary}\n` +
+      "mb: reinstall it with `npm rebuild mb` (or `npm install -g mb --force`)."
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+
+if (result.error) {
+  console.error(`mb: failed to launch ${binary}: ${result.error.message}`);
+  process.exit(1);
+}
+
+process.exit(typeof result.status === "number" ? result.status : 1);

package/install.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+// Downloads the prebuilt `mb` binary for the current platform from GitHub
+// Releases and drops it next to this package's launcher (`bin/mb.js`).
+//
+// Overridable for forks / private mirrors:
+//   MB_REPO            owner/repo            (default: parsed from package.json)
+//   MB_VERSION         release version       (default: package.json version)
+//   MB_DOWNLOAD_BASE   full base URL         (overrides MB_REPO/MB_VERSION)
+//   MB_SKIP_DOWNLOAD   set to skip fetching
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const https = require("https");
+const http = require("http");
+
+const pkg = require("./package.json");
+
+const TARGETS = {
+  "linux-x64": "linux-x86_64",
+  "linux-arm64": "linux-aarch64",
+  "darwin-arm64": "darwin-aarch64",
+};
+
+function repoSlug(repo) {
+  if (!repo) return null;
+  const url = typeof repo === "string" ? repo : repo.url || "";
+  const m = url.match(/github\.com[/:]([^/]+)\/([^/.]+)/);
+  return m ? `${m[1]}/${m[2]}` : null;
+}
+
+function target() {
+  return TARGETS[`${process.platform}-${process.arch}`];
+}
+
+function downloadUrl(targetName) {
+  if (process.env.MB_DOWNLOAD_BASE) {
+    return `${process.env.MB_DOWNLOAD_BASE.replace(/\/$/, "")}/mb-${targetName}`;
+  }
+  const repo = process.env.MB_REPO || repoSlug(pkg.repository) || "tomasky/mb";
+  const version = process.env.MB_VERSION || pkg.version;
+  return `https://github.com/${repo}/releases/download/v${version}/mb-${targetName}`;
+}
+
+function fetch(url, redirects) {
+  return new Promise((resolve, reject) => {
+    if (redirects > 10) return reject(new Error("too many redirects"));
+    const client = url.startsWith("http:") ? http : https;
+    const req = client.get(
+      url,
+      { headers: { "user-agent": `mb-npm/${pkg.version}` } },
+      (res) => {
+        const { statusCode, headers } = res;
+        if (statusCode >= 300 && statusCode < 400 && headers.location) {
+          res.resume();
+          const next = new URL(headers.location, url).toString();
+          resolve(fetch(next, (redirects || 0) + 1));
+          return;
+        }
+        if (statusCode !== 200) {
+          res.resume();
+          reject(new Error(`GET ${url} -> HTTP ${statusCode}`));
+          return;
+        }
+        resolve(res);
+      }
+    );
+    req.on("error", reject);
+  });
+}
+
+async function main() {
+  if (process.env.MB_SKIP_DOWNLOAD) {
+    console.log("mb: MB_SKIP_DOWNLOAD set, skipping binary download");
+    return;
+  }
+
+  const targetName = target();
+  if (!targetName) {
+    throw new Error(
+      `unsupported platform ${process.platform}-${process.arch}; mb ` +
+        `supports linux-x64, linux-arm64 and darwin-arm64 (the MoonBit ` +
+        `toolchain no longer ships a darwin-x64 target)`
+    );
+  }
+
+  const ext = process.platform === "win32" ? ".exe" : "";
+  const dest = path.join(__dirname, "bin", "mb" + ext);
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+
+  if (fs.existsSync(dest) && !process.env.MB_FORCE_DOWNLOAD) {
+    console.log(`mb: ${dest} already present, skipping download`);
+    return;
+  }
+
+  const url = downloadUrl(targetName);
+  console.log(`mb: downloading ${url}`);
+  const res = await fetch(url, 0);
+  await new Promise((resolve, reject) => {
+    const out = fs.createWriteStream(dest);
+    res.pipe(out);
+    out.on("finish", () => out.close(resolve));
+    out.on("error", reject);
+    res.on("error", reject);
+  });
+  fs.chmodSync(dest, 0o755);
+  console.log(`mb: installed ${dest}`);
+}
+
+main().catch((err) => {
+  console.error(`mb: failed to install the native binary: ${err.message}`);
+  console.error(
+    "mb: set MB_DOWNLOAD_BASE (or MB_REPO/MB_VERSION) to point at a mirror, " +
+      "or set MB_SKIP_DOWNLOAD=1 to skip."
+  );
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@tomasko/mb",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "A MoonBit-native, uv-style toolchain and package manager: manage MoonBit toolchains and install tools from mooncakes.io.",
+  "license": "Apache-2.0",
+  "bin": {
+    "mb": "bin/mb.js"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "files": [
+    "bin/mb.js",
+    "install.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tomasky/mb.git"
+  },
+  "homepage": "https://github.com/tomasky/mb",
+  "bugs": "https://github.com/tomasky/mb/issues",
+  "keywords": [
+    "moonbit",
+    "mooncakes",
+    "toolchain",
+    "package-manager",
+    "uv"
+  ],
+  "preferGlobal": true
+}