@humanmd/cli 0.1.0-alpha.5

package/README.md

@@ -0,0 +1,13 @@
+# @humanmd/cli
+
+Native npm wrapper for the HMD command-line tool.
+
+The package installs the platform-specific `hmd` binary from GitHub release artifacts generated by `cargo-dist`. JavaScript is only used as distribution glue; it does not parse or render HMD documents.
+
+```bash
+npm install -g @humanmd/cli
+hmd --help
+npx @humanmd/cli validate examples/todo.hmd
+```
+
+For local development, set `HMD_CLI_BINARY=/path/to/hmd` or run `npm test` from this package.

package/bin/hmd.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+const binaryName = process.platform === "win32" ? "hmd.exe" : "hmd";
+const candidates = [
+  process.env.HMD_CLI_BINARY,
+  join(packageRoot, "vendor", binaryName),
+  join(packageRoot, "vendor", "hmd"),
+].filter(Boolean);
+
+const binary = candidates.find((candidate) => existsSync(candidate));
+
+if (!binary) {
+  console.error(
+    "error: hmd native binary not found. Reinstall @humanmd/cli or set HMD_CLI_BINARY."
+  );
+  process.exit(1);
+}
+
+const child = spawnSync(binary, process.argv.slice(2), {
+  stdio: "inherit",
+  windowsHide: false,
+});
+
+if (child.error) {
+  console.error(`error: failed to run ${binary}: ${child.error.message}`);
+  process.exit(1);
+}
+
+if (child.signal) {
+  process.kill(process.pid, child.signal);
+}
+
+process.exit(child.status ?? 1);

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@humanmd/cli",
+  "version": "0.1.0-alpha.5",
+  "description": "Native HMD CLI wrapper for npm.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VrianCao/hmd.git",
+    "directory": "packages/npm-cli"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "hmd": "bin/hmd.js"
+  },
+  "files": [
+    "bin",
+    "scripts",
+    "README.md"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "test": "node test/smoke.mjs",
+    "pack:check": "npm pack --dry-run"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,206 @@
+import { execFileSync } from "node:child_process";
+import {
+  chmodSync,
+  copyFileSync,
+  existsSync,
+  mkdirSync,
+  mkdtempSync,
+  readFileSync,
+  readdirSync,
+  rmSync,
+  statSync,
+  writeFileSync,
+} from "node:fs";
+import { get } from "node:https";
+import { tmpdir } from "node:os";
+import { basename, dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+const vendorDir = join(packageRoot, "vendor");
+const binaryName = process.platform === "win32" ? "hmd.exe" : "hmd";
+const destination = join(vendorDir, binaryName);
+
+if (process.env.HMD_SKIP_DOWNLOAD === "1") {
+  console.log("Skipping hmd binary download because HMD_SKIP_DOWNLOAD=1.");
+  process.exit(0);
+}
+
+mkdirSync(vendorDir, { recursive: true });
+
+if (process.env.HMD_CLI_BINARY) {
+  copyNativeBinary(process.env.HMD_CLI_BINARY, destination);
+  process.exit(0);
+}
+
+if (existsSync(destination)) {
+  process.exit(0);
+}
+
+const packageJson = JSON.parse(readFileSync(join(packageRoot, "package.json"), "utf8"));
+const repo = process.env.HMD_CLI_REPOSITORY || "VrianCao/hmd";
+const version = process.env.HMD_CLI_VERSION || packageJson.version;
+const tag =
+  process.env.HMD_CLI_RELEASE_TAG || (version.startsWith("v") ? version : `v${version}`);
+const target = targetTriple();
+const assetUrl = process.env.HMD_CLI_ASSET_URL || (await findReleaseAsset(repo, tag, target));
+const workDir = mkdtempSync(join(tmpdir(), "hmd-cli-"));
+
+try {
+  const archivePath = join(workDir, basename(new URL(assetUrl).pathname));
+  await download(assetUrl, archivePath);
+  const extractDir = join(workDir, "extract");
+  mkdirSync(extractDir, { recursive: true });
+  extractArchive(archivePath, extractDir);
+  const extractedBinary = findBinary(extractDir);
+
+  if (!extractedBinary) {
+    throw new Error(`downloaded artifact does not contain ${binaryName}`);
+  }
+
+  copyNativeBinary(extractedBinary, destination);
+} finally {
+  rmSync(workDir, { recursive: true, force: true });
+}
+
+function targetTriple() {
+  const key = `${process.platform}-${process.arch}`;
+  const targets = {
+    "darwin-x64": "x86_64-apple-darwin",
+    "darwin-arm64": "aarch64-apple-darwin",
+    "linux-x64": "x86_64-unknown-linux-gnu",
+    "linux-arm64": "aarch64-unknown-linux-gnu",
+    "win32-x64": "x86_64-pc-windows-msvc",
+  };
+  const target = targets[key];
+
+  if (!target) {
+    throw new Error(`unsupported platform for @humanmd/cli: ${key}`);
+  }
+
+  return target;
+}
+
+async function findReleaseAsset(repo, tag, target) {
+  const releaseUrl = `https://api.github.com/repos/${repo}/releases/tags/${tag}`;
+  const release = JSON.parse(await fetchText(releaseUrl));
+  const asset = release.assets
+    ?.filter((candidate) => candidate.name.includes(target))
+    .filter((candidate) => /\.(tar\.xz|tar\.gz|tgz|zip)$/.test(candidate.name))
+    .find((candidate) => /(^|[-_])hmd([-_]|$)|hmd-cli/.test(candidate.name));
+
+  if (!asset) {
+    throw new Error(`no @humanmd/cli release artifact for ${target} in ${repo}@${tag}`);
+  }
+
+  return asset.browser_download_url;
+}
+
+function fetchText(url) {
+  return new Promise((resolve, reject) => {
+    get(
+      url,
+      {
+        headers: {
+          Accept: "application/vnd.github+json",
+          "User-Agent": "@humanmd/cli postinstall",
+        },
+      },
+      (response) => {
+        if (isRedirect(response.statusCode)) {
+          fetchText(response.headers.location).then(resolve, reject);
+          return;
+        }
+
+        if (response.statusCode < 200 || response.statusCode >= 300) {
+          reject(new Error(`GET ${url} failed with HTTP ${response.statusCode}`));
+          response.resume();
+          return;
+        }
+
+        const chunks = [];
+        response.setEncoding("utf8");
+        response.on("data", (chunk) => chunks.push(chunk));
+        response.on("end", () => resolve(chunks.join("")));
+      }
+    ).on("error", reject);
+  });
+}
+
+function download(url, path) {
+  return new Promise((resolve, reject) => {
+    get(
+      url,
+      {
+        headers: {
+          "User-Agent": "@humanmd/cli postinstall",
+        },
+      },
+      (response) => {
+        if (isRedirect(response.statusCode)) {
+          download(response.headers.location, path).then(resolve, reject);
+          return;
+        }
+
+        if (response.statusCode < 200 || response.statusCode >= 300) {
+          reject(new Error(`GET ${url} failed with HTTP ${response.statusCode}`));
+          response.resume();
+          return;
+        }
+
+        const chunks = [];
+        response.on("data", (chunk) => chunks.push(chunk));
+        response.on("end", () => {
+          writeFileSync(path, Buffer.concat(chunks));
+          resolve();
+        });
+      }
+    ).on("error", reject);
+  });
+}
+
+function isRedirect(statusCode) {
+  return [301, 302, 303, 307, 308].includes(statusCode);
+}
+
+function extractArchive(archivePath, extractDir) {
+  if (archivePath.endsWith(".zip")) {
+    if (process.platform === "win32") {
+      execFileSync("powershell", [
+        "-NoProfile",
+        "-Command",
+        `Expand-Archive -LiteralPath '${archivePath}' -DestinationPath '${extractDir}' -Force`,
+      ]);
+      return;
+    }
+
+    execFileSync("unzip", ["-q", archivePath, "-d", extractDir]);
+    return;
+  }
+
+  execFileSync("tar", ["-xf", archivePath, "-C", extractDir]);
+}
+
+function findBinary(dir) {
+  for (const entry of readdirSync(dir)) {
+    const path = join(dir, entry);
+    const stat = statSync(path);
+
+    if (stat.isDirectory()) {
+      const nested = findBinary(path);
+      if (nested) {
+        return nested;
+      }
+    } else if (entry === binaryName || (process.platform !== "win32" && entry === "hmd")) {
+      return path;
+    }
+  }
+
+  return null;
+}
+
+function copyNativeBinary(source, dest) {
+  copyFileSync(source, dest);
+  chmodSync(dest, 0o755);
+  console.log(`Installed hmd binary to ${dest}.`);
+}