@tachyon-sdk/cli 0.6.53

package/README.md

@@ -0,0 +1,62 @@
+# @tachyon-sdk/cli
+
+Global npm installer for the Tachyon CLI.
+
+## Install
+
+```sh
+npm install -g @tachyon-sdk/cli
+```
+
+This installs the `tachyon` command, plus the short alias `tc`.
+
+```sh
+tachyon --version
+tc --version
+```
+
+During `postinstall`, the package downloads the matching native binary from
+the `quantum-box/tachyon-sdk` GitHub Release. The npm package version matches
+the CLI release version, so `@tachyon-sdk/cli@0.6.25` downloads
+`tachyon-cli-v0.6.25`.
+
+Supported platforms:
+
+| OS | Architecture | Release asset |
+| --- | --- | --- |
+| Linux | x64 | `tachyon-linux-x86_64.tar.gz` |
+| Linux | arm64 | `tachyon-linux-arm64.tar.gz` |
+| macOS | arm64 | `tachyon-darwin-arm64.tar.gz` |
+| macOS | x64 | `tachyon-darwin-x86_64.tar.gz` |
+
+## Configuration
+
+The npm installer uses these optional environment variables:
+
+| Variable | Purpose |
+| --- | --- |
+| `TACHYON_CLI_SKIP_DOWNLOAD=1` | Skip binary download during install. The wrapper will try again on first run. |
+| `TACHYON_CLI_VERSION` | Override the version used to build the default release tag. |
+| `TACHYON_CLI_TAG` | Override the release tag, for example `tachyon-cli-v0.6.25`. |
+| `TACHYON_CLI_REPOSITORY` | Override the GitHub repository, default `quantum-box/tachyon-sdk`. |
+| `TACHYON_CLI_DOWNLOAD_URL` | Override the full `.tar.gz` download URL. |
+
+## Cloud App internalService Support
+
+`@tachyon-sdk/cli@0.6.13` is the first release line that can apply Cloud App
+manifests with `envVars[].valueFrom.internalService`. The CLI collects those
+references, calls the control-plane preflight endpoint before app mutations,
+and then lets the server-side manifest apply path persist the unresolved
+reference for deploy-time resolution.
+
+CLI `0.6.12` does not support this field. Run `tachyon self-update` or install
+`@tachyon-sdk/cli@0.6.13` before applying manifests that depend on internal
+Cloud App service URLs.
+
+## Alternative Install
+
+The standalone installer remains available:
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/quantum-box/tachyon-sdk/main/scripts/install.sh | sh
+```

package/bin/tachyon.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const packageRoot = path.resolve(__dirname, "..");
+const binaryPath = path.join(packageRoot, "vendor", "tachyon");
+
+function ensureBinary() {
+  if (fs.existsSync(binaryPath)) {
+    return;
+  }
+
+  const installScript = path.join(packageRoot, "scripts", "install.js");
+  const result = spawnSync(process.execPath, [installScript], {
+    stdio: "inherit",
+    env: process.env,
+  });
+
+  if (result.error) {
+    console.error(`tachyon: failed to install the native binary: ${result.error.message}`);
+    process.exit(1);
+  }
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
+  }
+}
+
+function exitFrom(result) {
+  if (result.error) {
+    console.error(`tachyon: failed to execute ${binaryPath}: ${result.error.message}`);
+    process.exit(1);
+  }
+
+  if (result.signal) {
+    const signalExitCodes = {
+      SIGINT: 130,
+      SIGTERM: 143,
+    };
+    process.exit(signalExitCodes[result.signal] ?? 1);
+  }
+
+  process.exit(result.status ?? 0);
+}
+
+ensureBinary();
+
+const result = spawnSync(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  env: process.env,
+});
+exitFrom(result);

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@tachyon-sdk/cli",
+  "version": "0.6.53",
+  "description": "Command-line interface for the Tachyon Platform",
+  "license": "MIT",
+  "bin": {
+    "tachyon": "bin/tachyon.js",
+    "tc": "bin/tachyon.js"
+  },
+  "files": [
+    "bin",
+    "scripts/install.js",
+    "scripts/platform.js",
+    "README.md"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/install.js",
+    "check": "node --check bin/tachyon.js && node --check scripts/install.js && node --check scripts/platform.js && node --check scripts/check-version.js && node scripts/check-version.js",
+    "prepublishOnly": "npm run check"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/quantum-box/tachyon-sdk.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/quantum-box/tachyon-sdk/issues"
+  },
+  "homepage": "https://github.com/quantum-box/tachyon-sdk#readme",
+  "keywords": [
+    "tachyon",
+    "cli",
+    "cloud",
+    "compute"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/install.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+"use strict";
+
+const { execFileSync } = require("node:child_process");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const { Readable } = require("node:stream");
+const { pipeline } = require("node:stream/promises");
+const { resolvePlatformTarget } = require("./platform");
+
+const packageRoot = path.resolve(__dirname, "..");
+const packageJson = require(path.join(packageRoot, "package.json"));
+const vendorDir = path.join(packageRoot, "vendor");
+const binaryPath = path.join(vendorDir, "tachyon");
+
+async function main() {
+  if (process.env.TACHYON_CLI_SKIP_DOWNLOAD === "1") {
+    console.log("Skipping Tachyon CLI binary download because TACHYON_CLI_SKIP_DOWNLOAD=1");
+    return;
+  }
+
+  const target = resolvePlatformTarget();
+  const version = normalizeVersion(process.env.TACHYON_CLI_VERSION ?? packageJson.version);
+  const tag = process.env.TACHYON_CLI_TAG ?? `tachyon-cli-v${version}`;
+  const repo = process.env.TACHYON_CLI_REPOSITORY ?? "quantum-box/tachyon-sdk";
+  const assetName = `${target.artifactName}.tar.gz`;
+  const downloadUrl =
+    process.env.TACHYON_CLI_DOWNLOAD_URL ??
+    `https://github.com/${repo}/releases/download/${tag}/${assetName}`;
+
+  fs.mkdirSync(vendorDir, { recursive: true });
+
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "tachyon-cli-"));
+  const archivePath = path.join(tmpDir, assetName);
+
+  try {
+    console.log(`Downloading Tachyon CLI ${version} for ${target.os}/${target.arch}...`);
+    await download(downloadUrl, archivePath);
+    execFileSync("tar", ["-xzf", archivePath, "-C", tmpDir], {
+      stdio: "inherit",
+    });
+
+    const extractedBinary = path.join(tmpDir, "tachyon");
+    if (!fs.existsSync(extractedBinary)) {
+      throw new Error(`Downloaded archive did not contain the tachyon binary: ${downloadUrl}`);
+    }
+
+    fs.copyFileSync(extractedBinary, binaryPath);
+    fs.chmodSync(binaryPath, 0o755);
+    console.log(`Installed Tachyon CLI to ${binaryPath}`);
+  } finally {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  }
+}
+
+function normalizeVersion(version) {
+  return version.replace(/^v/, "").trim();
+}
+
+async function download(url, destinationPath) {
+  const response = await fetch(url, {
+    headers: {
+      "User-Agent": `@tachyon-sdk/cli/${packageJson.version}`,
+    },
+    redirect: "follow",
+  });
+
+  if (!response.ok) {
+    throw new Error(`Failed to download ${url}: ${response.status} ${response.statusText}`);
+  }
+  if (!response.body) {
+    throw new Error(`Failed to download ${url}: response body is empty`);
+  }
+
+  await pipeline(Readable.fromWeb(response.body), fs.createWriteStream(destinationPath));
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+});

package/scripts/platform.js

@@ -0,0 +1,31 @@
+"use strict";
+
+function resolvePlatformTarget(platform = process.platform, arch = process.arch) {
+  const osByPlatform = {
+    darwin: "darwin",
+    linux: "linux",
+  };
+  const archByNodeArch = {
+    arm64: "arm64",
+    x64: "x86_64",
+  };
+
+  const os = osByPlatform[platform];
+  const artifactArch = archByNodeArch[arch];
+
+  if (!os || !artifactArch) {
+    throw new Error(
+      `Unsupported platform: ${platform}/${arch}. Tachyon CLI npm installs currently support macOS and Linux on arm64 or x64.`,
+    );
+  }
+
+  return {
+    os,
+    arch: artifactArch,
+    artifactName: `tachyon-${os}-${artifactArch}`,
+  };
+}
+
+module.exports = {
+  resolvePlatformTarget,
+};