@gaiaworks/gaia-cli 0.0.1

package/README.md

@@ -0,0 +1,20 @@
+# @gaiaworks/gaia-cli
+
+这是 `gaia-cli` 的 npm 分发壳包，用于通过 `npx` 下载并运行对应版本的 Go 二进制。
+
+## 使用方式
+
+临时执行：
+
+```bash
+npx @gaiaworks/gaia-cli version
+```
+
+全局安装：
+
+```bash
+npx @gaiaworks/gaia-cli@latest install
+gaia-cli version
+```
+
+安装时会根据 npm 包版本，从 `gaiaworks/gaia-cli-releases` 的同版本 GitHub Release 下载当前平台对应的 `gaia-cli` 二进制。

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@gaiaworks/gaia-cli",
+  "version": "0.0.1",
+  "description": "JavaScript launcher for gaia-cli.",
+  "license": "UNLICENSED",
+  "private": false,
+  "bin": {
+    "gaia-cli": "scripts/run.js"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "files": [
+    "README.md",
+    "package.json",
+    "scripts"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/install.js",
+    "test": "node --test"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/scripts/install-wizard.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
+const packageSpec = `${packageJson.name}@${packageJson.version}`;
+
+const result = spawnSync('npm', ['install', '-g', packageSpec], {
+  stdio: 'inherit',
+});
+
+if (result.error) {
+  console.error(`[gaia-cli] Failed to run npm install: ${result.error.message}`);
+  process.exit(1);
+}
+
+if (result.status !== 0) {
+  process.exit(typeof result.status === 'number' ? result.status : 1);
+}
+
+console.error('[gaia-cli] Global install completed. You can now run: gaia-cli version');

package/scripts/install.js

@@ -0,0 +1,178 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+const PACKAGE_JSON = path.join(PACKAGE_ROOT, 'package.json');
+const BIN_DIR = path.join(PACKAGE_ROOT, 'bin');
+const RELEASE_REPO = process.env.GAIA_CLI_RELEASE_REPO || 'gaiaworks/gaia-cli-releases';
+const DOWNLOAD_BASE = process.env.GAIA_CLI_DOWNLOAD_BASE || `https://github.com/${RELEASE_REPO}/releases/download`;
+const ALLOWED_DOWNLOAD_HOSTS = new Set([
+  'github.com',
+  'objects.githubusercontent.com',
+]);
+
+function readPackageVersion() {
+  const content = fs.readFileSync(PACKAGE_JSON, 'utf8');
+  return JSON.parse(content).version;
+}
+
+function normalizeVersion(version) {
+  return version.startsWith('v') ? version.slice(1) : version;
+}
+
+function platformName(platform = process.platform) {
+  if (platform === 'darwin') return 'darwin';
+  if (platform === 'linux') return 'linux';
+  if (platform === 'win32') return 'windows';
+  throw new Error(`Unsupported platform: ${platform}`);
+}
+
+function archName(arch = process.arch) {
+  if (arch === 'x64') return 'amd64';
+  if (arch === 'arm64') return 'arm64';
+  throw new Error(`Unsupported architecture: ${arch}`);
+}
+
+function binaryName(platform = process.platform) {
+  return platform === 'win32' ? 'gaia-cli.exe' : 'gaia-cli';
+}
+
+function archiveName(version, platform = process.platform, arch = process.arch) {
+  const cleanVersion = normalizeVersion(version);
+  return `gaia-cli-${cleanVersion}-${platformName(platform)}-${archName(arch)}.tar.gz`;
+}
+
+function releaseTag(version) {
+  const cleanVersion = normalizeVersion(version);
+  return `v${cleanVersion}`;
+}
+
+function downloadUrl(version, platform = process.platform, arch = process.arch) {
+  return `${DOWNLOAD_BASE}/${releaseTag(version)}/${archiveName(version, platform, arch)}`;
+}
+
+function assertAllowedUrl(rawUrl) {
+  const parsed = new URL(rawUrl);
+  if (parsed.protocol !== 'https:') {
+    throw new Error(`Refusing non-HTTPS download URL: ${rawUrl}`);
+  }
+  if (!ALLOWED_DOWNLOAD_HOSTS.has(parsed.hostname)) {
+    throw new Error(`Refusing download host: ${parsed.hostname}`);
+  }
+}
+
+function ensureDir(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+function run(command, args, options = {}) {
+  const result = spawnSync(command, args, {
+    stdio: options.stdio || 'inherit',
+    cwd: options.cwd || PACKAGE_ROOT,
+    encoding: 'utf8',
+  });
+  if (result.error) {
+    throw result.error;
+  }
+  if (result.status !== 0) {
+    throw new Error(`${command} ${args.join(' ')} exited with code ${result.status}`);
+  }
+  return result;
+}
+
+function downloadWithRedirects(url, destination) {
+  assertAllowedUrl(url);
+  const tmpPath = `${destination}.tmp`;
+  fs.rmSync(tmpPath, { force: true });
+
+  run('curl', [
+    '--fail',
+    '--location',
+    '--show-error',
+    '--silent',
+    '--output',
+    tmpPath,
+    url,
+  ]);
+
+  fs.renameSync(tmpPath, destination);
+}
+
+function extractArchive(archivePath, targetDir) {
+  fs.rmSync(targetDir, { recursive: true, force: true });
+  ensureDir(targetDir);
+  run('tar', ['-xzf', archivePath, '-C', targetDir]);
+}
+
+function findDownloadedBinary(targetDir, platform = process.platform) {
+  const expectedName = binaryName(platform);
+  const direct = path.join(targetDir, expectedName);
+  if (fs.existsSync(direct)) return direct;
+
+  const pending = [targetDir];
+  while (pending.length > 0) {
+    const currentDir = pending.pop();
+    const entries = fs.readdirSync(currentDir, { withFileTypes: true });
+    for (const entry of entries) {
+      const entryPath = path.join(currentDir, entry.name);
+      if (entry.isDirectory()) {
+        pending.push(entryPath);
+      } else if (entry.isFile() && entry.name === expectedName) {
+        return entryPath;
+      }
+    }
+  }
+  throw new Error(`Downloaded archive does not contain ${expectedName}`);
+}
+
+function install(options = {}) {
+  const version = options.version || readPackageVersion();
+  const url = options.url || downloadUrl(version);
+  const archivePath = path.join(os.tmpdir(), archiveName(version));
+  const unpackDir = path.join(os.tmpdir(), `gaia-cli-${process.pid}-${Date.now()}`);
+  const finalBinary = path.join(BIN_DIR, binaryName());
+
+  console.error(`[gaia-cli] Downloading ${url}`);
+  ensureDir(BIN_DIR);
+  downloadWithRedirects(url, archivePath);
+  extractArchive(archivePath, unpackDir);
+
+  const downloadedBinary = findDownloadedBinary(unpackDir);
+  fs.copyFileSync(downloadedBinary, finalBinary);
+  if (process.platform !== 'win32') {
+    fs.chmodSync(finalBinary, 0o755);
+  }
+
+  fs.rmSync(archivePath, { force: true });
+  fs.rmSync(unpackDir, { recursive: true, force: true });
+  console.error(`[gaia-cli] Installed ${finalBinary}`);
+}
+
+if (require.main === module) {
+  try {
+    install();
+  } catch (error) {
+    console.error(`[gaia-cli] Failed to install binary: ${error.message}`);
+    console.error('[gaia-cli] Please check network access to GitHub Releases or contact the administrator.');
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  ALLOWED_DOWNLOAD_HOSTS,
+  archName,
+  archiveName,
+  assertAllowedUrl,
+  binaryName,
+  downloadUrl,
+  findDownloadedBinary,
+  install,
+  normalizeVersion,
+  platformName,
+  releaseTag,
+};

package/scripts/run.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const { binaryName } = require('./install');
+
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+const BINARY_PATH = path.join(PACKAGE_ROOT, 'bin', binaryName());
+
+function runInstallWizard(args) {
+  const result = spawnSync(process.execPath, [path.join(__dirname, 'install-wizard.js'), ...args], {
+    stdio: 'inherit',
+  });
+  process.exit(typeof result.status === 'number' ? result.status : 1);
+}
+
+function ensureBinary() {
+  if (fs.existsSync(BINARY_PATH)) return;
+  const result = spawnSync(process.execPath, [path.join(__dirname, 'install.js')], {
+    stdio: 'inherit',
+  });
+  if (result.status !== 0) {
+    process.exit(typeof result.status === 'number' ? result.status : 1);
+  }
+}
+
+function runBinary(args) {
+  ensureBinary();
+  const result = spawnSync(BINARY_PATH, args, {
+    stdio: 'inherit',
+  });
+  if (result.error) {
+    console.error(`[gaia-cli] Failed to run ${BINARY_PATH}: ${result.error.message}`);
+    process.exit(1);
+  }
+  process.exit(typeof result.status === 'number' ? result.status : 1);
+}
+
+const args = process.argv.slice(2);
+if (args[0] === 'install') {
+  runInstallWizard(args.slice(1));
+}
+
+runBinary(args);