@agscale/agscale 0.1.2

package/README.md

@@ -0,0 +1,17 @@
+# @agscale/agscale
+
+NPM wrapper for AGScale CLI.
+
+It downloads the matching native binary from GitHub Releases on first run and executes it.
+
+## Usage
+
+```bash
+npx @agscale/agscale version
+```
+
+Override release source if needed:
+
+```bash
+AGSCALE_REPO=yangpuyu/agscale AGSCALE_RELEASE_TAG=v0.3.1 npx @agscale/agscale version
+```

package/bin/agscale.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+const crypto = require("node:crypto");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const https = require("node:https");
+const { spawnSync } = require("node:child_process");
+
+const PKG = require("../package.json");
+
+function mapPlatform() {
+  const p = process.platform;
+  if (p === "linux") return "linux";
+  if (p === "darwin") return "darwin";
+  if (p === "win32") return "windows";
+  throw new Error(`unsupported platform: ${p}`);
+}
+
+function mapArch() {
+  const a = process.arch;
+  if (a === "x64") return "amd64";
+  if (a === "arm64") return "arm64";
+  throw new Error(`unsupported architecture: ${a}`);
+}
+
+function getTag() {
+  const envTag = process.env.AGSCALE_RELEASE_TAG;
+  if (envTag && envTag.trim()) return envTag.trim();
+  if (PKG.version === "0.0.0-dev") {
+    throw new Error("package version is 0.0.0-dev; set AGSCALE_RELEASE_TAG=vX.Y.Z");
+  }
+  return `v${PKG.version}`;
+}
+
+function getRepo() {
+  const envRepo = process.env.AGSCALE_REPO;
+  if (envRepo && envRepo.trim()) return envRepo.trim();
+  return "yangpuyu/agscale";
+}
+
+function request(url) {
+  return new Promise((resolve, reject) => {
+    const req = https.request(
+      url,
+      {
+        method: "GET",
+        headers: process.env.GITHUB_TOKEN
+          ? { Authorization: `Bearer ${process.env.GITHUB_TOKEN}` }
+          : {}
+      },
+      (res) => {
+        if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          resolve(request(res.headers.location));
+          return;
+        }
+        if (!res.statusCode || res.statusCode < 200 || res.statusCode >= 300) {
+          reject(new Error(`request failed ${res.statusCode || 0}: ${url}`));
+          return;
+        }
+        const chunks = [];
+        res.on("data", (c) => chunks.push(c));
+        res.on("end", () => resolve(Buffer.concat(chunks)));
+      }
+    );
+    req.on("error", reject);
+    req.end();
+  });
+}
+
+function sha256(buf) {
+  return crypto.createHash("sha256").update(buf).digest("hex");
+}
+
+function binaryFilename(tag, osName, arch) {
+  const base = `agscale_${tag}_${osName}_${arch}`;
+  if (osName === "windows") return `${base}.exe`;
+  return base;
+}
+
+async function ensureBinary() {
+  const repo = getRepo();
+  const tag = getTag();
+  const osName = mapPlatform();
+  const arch = mapArch();
+  const assetName = binaryFilename(tag, osName, arch);
+  const checksumsName = "checksums.txt";
+
+  const cacheRoot = process.env.AGSCALE_CACHE_DIR
+    ? process.env.AGSCALE_CACHE_DIR
+    : path.join(os.homedir(), ".cache", "agscale-npm");
+  const cacheDir = path.join(cacheRoot, tag, `${osName}-${arch}`);
+  const binPath = path.join(cacheDir, osName === "windows" ? "agscale.exe" : "agscale");
+  if (fs.existsSync(binPath)) return binPath;
+
+  fs.mkdirSync(cacheDir, { recursive: true });
+
+  const base = `https://github.com/${repo}/releases/download/${tag}`;
+  const binURL = `${base}/${assetName}`;
+  const checksumsURL = `${base}/${checksumsName}`;
+
+  const [binBuf, checksumsBuf] = await Promise.all([request(binURL), request(checksumsURL)]);
+  const checksumsText = checksumsBuf.toString("utf8");
+  const expected = checksumsText
+    .split("\n")
+    .map((l) => l.trim())
+    .filter(Boolean)
+    .map((l) => l.split(/\s+/))
+    .find((parts) => parts.length >= 2 && parts[1] === assetName);
+  if (!expected) {
+    throw new Error(`checksum entry missing for asset ${assetName}`);
+  }
+  const actual = sha256(binBuf);
+  if (actual !== expected[0]) {
+    throw new Error(`checksum mismatch for ${assetName}`);
+  }
+
+  fs.writeFileSync(binPath, binBuf, { mode: 0o755 });
+  fs.chmodSync(binPath, 0o755);
+  return binPath;
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  try {
+    const bin = await ensureBinary();
+    const child = spawnSync(bin, args, { stdio: "inherit" });
+    if (child.error) throw child.error;
+    process.exit(child.status || 0);
+  } catch (err) {
+    console.error(`[agscale npm wrapper] ${err.message}`);
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@agscale/agscale",
+  "version": "0.1.2",
+  "description": "AGScale CLI npm wrapper (downloads native binary from GitHub Releases)",
+  "license": "MIT",
+  "private": false,
+  "type": "commonjs",
+  "bin": {
+    "agscale": "bin/agscale.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yangpuyu/agscale.git"
+  },
+  "keywords": [
+    "agscale",
+    "agent",
+    "kubernetes",
+    "cli"
+  ]
+}