@aptos-labs/aptos-cli 1.1.1 → 2.0.0

package/README.md

@@ -42,6 +42,28 @@ If you already have the Aptos CLI binary installed on your system, you can speci
 npx aptos --binary-path /path/to/aptos <command>
 ```
 
+### Installing a Specific Version
+
+You can install a specific version of the Aptos CLI by setting the `APTOS_CLI_VERSION` environment variable:
+
+```bash
+# Install version 4.5.0
+APTOS_CLI_VERSION=4.5.0 npx aptos --install
+
+# Or with the v prefix
+APTOS_CLI_VERSION=v4.5.0 npx aptos --install
+```
+
+When `APTOS_CLI_VERSION` is set:
+- The specified version is downloaded directly from GitHub releases (package managers are bypassed)
+- The version is validated to ensure it exists before downloading
+- This works for both `--install` and `--update` commands
+
+This is useful for:
+- Pinning to a known working version
+- Testing against specific CLI versions
+- Reproducible builds in CI/CD pipelines
+
 ## Updating the Aptos CLI
 
 To update the Aptos CLI, you can run the following command within your project environment:
@@ -73,3 +95,90 @@ To build the project:
 ```bash
 npm run build
 ```
+
+## Building Move Artifacts in CI/CD
+
+The Aptos CLI can be used in CI/CD pipelines to build Move packages and generate deployment payloads. This is useful for automated deployments and multi-step workflows.
+
+### Example: Building Publish Payload
+
+```yaml
+# In your GitHub Actions workflow
+
+# Prerequisites: Set up Node.js first
+- name: Setup Node.js
+  uses: actions/setup-node@v4
+  with:
+    node-version: "20"
+
+- name: Install Aptos CLI npm package
+  run: npm install @aptos-labs/aptos-cli
+
+- name: Install Aptos CLI
+  run: npx aptos --install
+
+- name: Build Move package
+  working-directory: your-move-project
+  run: |
+    ~/.local/bin/aptos move compile \
+      --named-addresses your_module=0x1 \
+      --save-metadata
+
+- name: Generate publish payload
+  working-directory: your-move-project
+  run: |
+    ~/.local/bin/aptos move build-publish-payload \
+      --named-addresses your_module=0x1 \
+      --json-output-file publish-payload.json \
+      --assume-yes
+
+- name: Upload artifact for later steps
+  uses: actions/upload-artifact@v4
+  with:
+    name: move-artifacts
+    path: your-move-project/publish-payload.json
+```
+
+### Example: Building Upgrade Payload (Object Code Deployment)
+
+For upgrading existing object-deployed contracts:
+
+```yaml
+- name: Generate upgrade payload
+  working-directory: your-move-project
+  run: |
+    ~/.local/bin/aptos move build-upgrade-payload \
+      --named-addresses your_module=0x1 \
+      --object-address 0xYOUR_OBJECT_ADDRESS \
+      --json-output-file upgrade-payload.json \
+      --assume-yes
+```
+
+### Using Artifacts in Subsequent Jobs
+
+```yaml
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      # ... build steps above ...
+      - uses: actions/upload-artifact@v4
+        with:
+          name: move-artifacts
+          path: your-move-project/publish-payload.json
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: move-artifacts
+
+      - name: Use the payload
+        run: |
+          # The payload JSON can be used for deployment
+          cat publish-payload.json
+```
+
+See the [build-move-artifacts.yaml](.github/workflows/build-move-artifacts.yaml) workflow for a complete working example.

package/dist/aptos.js

@@ -1,20 +1,25 @@
 #!/usr/bin/env node
 import { program } from "commander";
-import { parseCommandOptions } from "./utils/parseCommandOptions.js";
 import { runCLI } from "./tasks/run.js";
+import { parseCommandOptions } from "./utils/parseCommandOptions.js";
 program
     .name("aptos")
     .helpOption(false)
     .option("-i, --install", "install the latest version of the CLI")
     .option("-u, --update", "update the CLI to the latest version")
     .option("-b, --binary-path <path>", "path to an existing Aptos CLI binary")
-    .allowUnknownOption();
+    .option("-d, --direct-download", "skip package managers and download directly from GitHub")
+    .allowUnknownOption()
+    .allowExcessArguments(true);
 program.parse(process.argv);
 const main = async () => {
     const options = {
         install: program.opts().install,
         update: program.opts().update,
         binaryPath: program.opts().binaryPath,
+        directDownload: program.opts().directDownload ||
+            process.env.APTOS_DIRECT_DOWNLOAD === "1" ||
+            process.env.APTOS_DIRECT_DOWNLOAD === "true",
     };
     const unknownOptions = program.args;
     if (process.argv.includes("--help")) {

package/dist/aptos.js.map

@@ -1 +1 @@
-{"version":3,"file":"aptos.js","sourceRoot":"","sources":["../bin/aptos.ts"],"names":[],"mappings":";AAWA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,UAAU,CAAC,KAAK,CAAC;KACjB,MAAM,CAAC,eAAe,EAAE,uCAAuC,CAAC;KAChE,MAAM,CAAC,cAAc,EAAE,sCAAsC,CAAC;KAC9D,MAAM,CAAC,0BAA0B,EAAE,sCAAsC,CAAC;KAC1E,kBAAkB,EAAE,CAAC;AAExB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;IACtB,MAAM,OAAO,GAAG;QACd,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO;QAC/B,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM;QAC7B,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU;KACtC,CAAC;IACF,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAGpC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAEpC,OAAO,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,mBAAmB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"aptos.js","sourceRoot":"","sources":["../bin/aptos.ts"],"names":[],"mappings":";AAkBA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,UAAU,CAAC,KAAK,CAAC;KACjB,MAAM,CAAC,eAAe,EAAE,uCAAuC,CAAC;KAChE,MAAM,CAAC,cAAc,EAAE,sCAAsC,CAAC;KAC9D,MAAM,CAAC,0BAA0B,EAAE,sCAAsC,CAAC;KAC1E,MAAM,CACL,uBAAuB,EACvB,yDAAyD,CAC1D;KACA,kBAAkB,EAAE;KACpB,oBAAoB,CAAC,IAAI,CAAC,CAAC;AAE9B,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;IACtB,MAAM,OAAO,GAAG;QACd,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO;QAC/B,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM;QAC7B,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU;QACrC,cAAc,EACZ,OAAO,CAAC,IAAI,EAAE,CAAC,cAAc;YAC7B,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,GAAG;YACzC,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,MAAM;KAC/C,CAAC;IACF,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAGpC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAEpC,OAAO,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,mBAAmB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\n\n// Installation priorities by platform:\n//\n// macOS:\n//   1. Homebrew (if available) - builds for native CPU architecture\n//   2. Direct download from GitHub releases\n//\n// Windows:\n//   1. winget (if available)\n//   2. Chocolatey (if available)\n//   3. Direct download from GitHub releases\n//\n// Linux:\n//   - Direct download from GitHub releases (with Ubuntu version detection)\n//\n// Use --direct-download or set APTOS_DIRECT_DOWNLOAD=1 to skip package managers.\n\nimport { program } from \"commander\";\nimport { runCLI } from \"./tasks/run.js\";\nimport { parseCommandOptions } from \"./utils/parseCommandOptions.js\";\n\nprogram\n  .name(\"aptos\")\n  .helpOption(false)\n  .option(\"-i, --install\", \"install the latest version of the CLI\")\n  .option(\"-u, --update\", \"update the CLI to the latest version\")\n  .option(\"-b, --binary-path <path>\", \"path to an existing Aptos CLI binary\")\n  .option(\n    \"-d, --direct-download\",\n    \"skip package managers and download directly from GitHub\",\n  )\n  .allowUnknownOption()\n  .allowExcessArguments(true);\n\nprogram.parse(process.argv);\n\nconst main = async () => {\n  const options = {\n    install: program.opts().install,\n    update: program.opts().update,\n    binaryPath: program.opts().binaryPath,\n    directDownload:\n      program.opts().directDownload ||\n      process.env.APTOS_DIRECT_DOWNLOAD === \"1\" ||\n      process.env.APTOS_DIRECT_DOWNLOAD === \"true\",\n  };\n  const unknownOptions = program.args;\n\n  // Manually check for `--help` and handle the CLI `--help`\n  if (process.argv.includes(\"--help\")) {\n    // Forward to the CLI\n    return runCLI(unknownOptions, options.binaryPath);\n  }\n\n  await parseCommandOptions(options, unknownOptions);\n};\n\nmain().catch(console.error);\n"]}

package/dist/examples/examples.test.js

@@ -0,0 +1,69 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { describe, expect, it } from "vitest";
+const WORKSPACE_ROOT = join(__dirname, "../..");
+const EXAMPLES_DIR = join(WORKSPACE_ROOT, "examples");
+const HELLO_BLOCKCHAIN_DIR = join(EXAMPLES_DIR, "hello_blockchain");
+describe("Example Move Projects", () => {
+    describe("hello_blockchain example", () => {
+        it("should have Move.toml configuration file", () => {
+            const moveTomlPath = join(HELLO_BLOCKCHAIN_DIR, "Move.toml");
+            expect(existsSync(moveTomlPath)).toBe(true);
+            const content = readFileSync(moveTomlPath, "utf-8");
+            expect(content).toContain("[package]");
+            expect(content).toContain('name = "HelloBlockchain"');
+            expect(content).toContain("[addresses]");
+            expect(content).toContain("hello_blockchain");
+            expect(content).toContain("[dependencies.AptosFramework]");
+        });
+        it("should have source files", () => {
+            const sourcesDir = join(HELLO_BLOCKCHAIN_DIR, "sources");
+            expect(existsSync(sourcesDir)).toBe(true);
+            const messageMovePath = join(sourcesDir, "message.move");
+            expect(existsSync(messageMovePath)).toBe(true);
+        });
+        it("should have valid Move module structure", () => {
+            const messageMovePath = join(HELLO_BLOCKCHAIN_DIR, "sources/message.move");
+            const content = readFileSync(messageMovePath, "utf-8");
+            expect(content).toContain("module hello_blockchain::message");
+            expect(content).toContain("public entry fun");
+            expect(content).toContain("has key");
+            expect(content).toContain("#[test");
+        });
+    });
+});
+describe("Build Move Artifacts Workflow", () => {
+    const workflowPath = join(WORKSPACE_ROOT, ".github/workflows/build-move-artifacts.yaml");
+    it("should have the workflow file", () => {
+        expect(existsSync(workflowPath)).toBe(true);
+    });
+    it("should contain required workflow configuration", () => {
+        const content = readFileSync(workflowPath, "utf-8");
+        expect(content).toContain("name: Build Move Artifacts");
+        expect(content).toContain("on:");
+        expect(content).toContain("jobs:");
+        expect(content).toContain("Install Aptos CLI");
+        expect(content).toContain("--install");
+        expect(content).toContain("Build Move package");
+        expect(content).toContain("move compile");
+        expect(content).toContain("--named-addresses");
+        expect(content).toContain("--save-metadata");
+        expect(content).toContain("Generate publish payload");
+        expect(content).toContain("build-publish-payload");
+        expect(content).toContain("--json-output-file");
+        expect(content).toContain("Upload build artifacts");
+        expect(content).toContain("actions/upload-artifact");
+    });
+    it("should have artifact download job for downstream usage", () => {
+        const content = readFileSync(workflowPath, "utf-8");
+        expect(content).toContain("use-artifacts");
+        expect(content).toContain("needs: build-artifacts");
+        expect(content).toContain("actions/download-artifact");
+    });
+    it("should demonstrate upgrade payload generation", () => {
+        const content = readFileSync(workflowPath, "utf-8");
+        expect(content).toContain("build-upgrade-payload");
+        expect(content).toContain("--object-address");
+    });
+});
+//# sourceMappingURL=examples.test.js.map

package/dist/examples/examples.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.test.js","sourceRoot":"","sources":["../../bin/examples/examples.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { describe, expect, it } from \"vitest\";\n\nconst WORKSPACE_ROOT = join(__dirname, \"../..\");\nconst EXAMPLES_DIR = join(WORKSPACE_ROOT, \"examples\");\nconst HELLO_BLOCKCHAIN_DIR = join(EXAMPLES_DIR, \"hello_blockchain\");\n\ndescribe(\"Example Move Projects\", () => {\n  describe(\"hello_blockchain example\", () => {\n    it(\"should have Move.toml configuration file\", () => {\n      const moveTomlPath = join(HELLO_BLOCKCHAIN_DIR, \"Move.toml\");\n      expect(existsSync(moveTomlPath)).toBe(true);\n\n      const content = readFileSync(moveTomlPath, \"utf-8\");\n      expect(content).toContain(\"[package]\");\n      expect(content).toContain('name = \"HelloBlockchain\"');\n      expect(content).toContain(\"[addresses]\");\n      expect(content).toContain(\"hello_blockchain\");\n      expect(content).toContain(\"[dependencies.AptosFramework]\");\n    });\n\n    it(\"should have source files\", () => {\n      const sourcesDir = join(HELLO_BLOCKCHAIN_DIR, \"sources\");\n      expect(existsSync(sourcesDir)).toBe(true);\n\n      const messageMovePath = join(sourcesDir, \"message.move\");\n      expect(existsSync(messageMovePath)).toBe(true);\n    });\n\n    it(\"should have valid Move module structure\", () => {\n      const messageMovePath = join(\n        HELLO_BLOCKCHAIN_DIR,\n        \"sources/message.move\",\n      );\n      const content = readFileSync(messageMovePath, \"utf-8\");\n\n      // Verify module declaration\n      expect(content).toContain(\"module hello_blockchain::message\");\n\n      // Verify it has required components for a deployable module\n      expect(content).toContain(\"public entry fun\");\n      expect(content).toContain(\"has key\");\n\n      // Verify it has a test\n      expect(content).toContain(\"#[test\");\n    });\n  });\n});\n\ndescribe(\"Build Move Artifacts Workflow\", () => {\n  const workflowPath = join(\n    WORKSPACE_ROOT,\n    \".github/workflows/build-move-artifacts.yaml\",\n  );\n\n  it(\"should have the workflow file\", () => {\n    expect(existsSync(workflowPath)).toBe(true);\n  });\n\n  it(\"should contain required workflow configuration\", () => {\n    const content = readFileSync(workflowPath, \"utf-8\");\n\n    // Verify workflow structure\n    expect(content).toContain(\"name: Build Move Artifacts\");\n    expect(content).toContain(\"on:\");\n    expect(content).toContain(\"jobs:\");\n\n    // Verify it installs the CLI\n    expect(content).toContain(\"Install Aptos CLI\");\n    expect(content).toContain(\"--install\");\n\n    // Verify it builds Move package\n    expect(content).toContain(\"Build Move package\");\n    expect(content).toContain(\"move compile\");\n    expect(content).toContain(\"--named-addresses\");\n    expect(content).toContain(\"--save-metadata\");\n\n    // Verify it generates publish payload\n    expect(content).toContain(\"Generate publish payload\");\n    expect(content).toContain(\"build-publish-payload\");\n    expect(content).toContain(\"--json-output-file\");\n\n    // Verify artifact upload step\n    expect(content).toContain(\"Upload build artifacts\");\n    expect(content).toContain(\"actions/upload-artifact\");\n  });\n\n  it(\"should have artifact download job for downstream usage\", () => {\n    const content = readFileSync(workflowPath, \"utf-8\");\n\n    // Verify there's a job that uses artifacts\n    expect(content).toContain(\"use-artifacts\");\n    expect(content).toContain(\"needs: build-artifacts\");\n    expect(content).toContain(\"actions/download-artifact\");\n  });\n\n  it(\"should demonstrate upgrade payload generation\", () => {\n    const content = readFileSync(workflowPath, \"utf-8\");\n\n    // Verify upgrade payload example is present\n    expect(content).toContain(\"build-upgrade-payload\");\n    expect(content).toContain(\"--object-address\");\n  });\n});\n"]}

package/dist/tasks/install.js

@@ -1,42 +1,93 @@
-import { execSync } from "child_process";
-import { existsSync } from "fs";
+import { execSync } from "node:child_process";
+import { chmodSync, existsSync, mkdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { installViaBrew, isBrewAvailable, isInstalledViaBrew, } from "../utils/brewOperations.js";
 import { GH_CLI_DOWNLOAD_URL, PNAME } from "../utils/consts.js";
-import { execSyncShell } from "../utils/execSyncShell.js";
-import { getCurrentOpenSSLVersion } from "../utils/versions.js";
-import { getOS } from "../utils/getUserOs.js";
-import { getLocalBinPath } from "../utils/getLocalBinPath.js";
-import { getLatestVersionGh } from "../utils/ghOperations.js";
-export const installCli = async () => {
-    const path = getLocalBinPath();
-    if (existsSync(path)) {
+import { getBinDir, getLocalBinPath, invalidateBinPathCache, } from "../utils/getLocalBinPath.js";
+import { getOS, getTargetPlatform } from "../utils/getUserOs.js";
+import { getCliVersion, hasUserSpecifiedVersion, } from "../utils/ghOperations.js";
+import { installViaChoco, installViaWinget, isChocoAvailable, isInstalledViaChoco, isInstalledViaWinget, isWingetAvailable, } from "../utils/windowsPackageManagers.js";
+export const installCli = async (directDownload = false) => {
+    invalidateBinPathCache();
+    const os = getOS();
+    const useDirectDownload = directDownload || hasUserSpecifiedVersion();
+    if (useDirectDownload && hasUserSpecifiedVersion()) {
+        console.log(`Using specified version from APTOS_CLI_VERSION: ${process.env.APTOS_CLI_VERSION}`);
+    }
+    if (!useDirectDownload) {
+        if (os === "MacOS" && isBrewAvailable()) {
+            if (isInstalledViaBrew()) {
+                console.log("Aptos CLI is already installed via Homebrew");
+                return;
+            }
+            installViaBrew();
+            return;
+        }
+        if (os === "Windows") {
+            if (isWingetAvailable()) {
+                if (isInstalledViaWinget()) {
+                    console.log("Aptos CLI is already installed via winget");
+                    return;
+                }
+                installViaWinget();
+                return;
+            }
+            if (isChocoAvailable()) {
+                if (isInstalledViaChoco()) {
+                    console.log("Aptos CLI is already installed via Chocolatey");
+                    return;
+                }
+                installViaChoco();
+                return;
+            }
+        }
+    }
+    const binaryPath = getLocalBinPath();
+    if (existsSync(binaryPath)) {
         console.log("Aptos CLI is already installed");
         return;
     }
-    const latestCLIVersion = await getLatestVersionGh();
-    console.log(`Downloading aptos CLI version ${latestCLIVersion}`);
-    const os = getOS();
-    if (os === "Windows") {
-        const url = `${GH_CLI_DOWNLOAD_URL}/${PNAME}-v${latestCLIVersion}/${PNAME}-${latestCLIVersion}-${os}-x86_64.zip`;
-        execSync(`powershell -Command "if (!(Test-Path -Path 'C:\\tmp')) { New-Item -ItemType Directory -Path 'C:\\tmp' } ; Invoke-RestMethod -Uri ${url} -OutFile C:\\tmp\\aptos.zip; Expand-Archive -Path C:\\tmp\\aptos.zip -DestinationPath C:\\tmp -Force; Move-Item -Path C:\\tmp\\aptos.exe -Destination \"${path}\""`);
-    }
-    else if (os === "MacOS") {
-        execSyncShell("brew install aptos", { encoding: "utf8" });
+    const binDir = getBinDir();
+    if (!existsSync(binDir)) {
+        mkdirSync(binDir, { recursive: true });
     }
-    else {
-        let osVersion = "x86_64";
-        let opensSslVersion = "1.0.0";
-        try {
-            opensSslVersion = getCurrentOpenSSLVersion();
+    const targetPlatform = getTargetPlatform();
+    const version = await getCliVersion(targetPlatform);
+    console.log(`Downloading Aptos CLI version ${version} for ${targetPlatform}...`);
+    const url = `${GH_CLI_DOWNLOAD_URL}/${PNAME}-v${version}/${PNAME}-${version}-${targetPlatform}.zip`;
+    const tempDir = tmpdir();
+    try {
+        if (os === "Windows") {
+            const zipPath = join(tempDir, "aptos-cli.zip");
+            execSync(`powershell -Command "` +
+                `Invoke-WebRequest -Uri '${url}' -OutFile '${zipPath}'; ` +
+                `Expand-Archive -Path '${zipPath}' -DestinationPath '${binDir}' -Force; ` +
+                `Remove-Item -Path '${zipPath}' -Force"`, { stdio: "inherit" });
         }
-        catch (error) {
-            console.log("Could not determine OpenSSL version, assuming older version (1.x.x)");
+        else {
+            const zipPath = join(tempDir, "aptos-cli.zip");
+            execSync(`curl -L -o "${zipPath}" "${url}"`, { stdio: "inherit" });
+            execSync(`unzip -o -q "${zipPath}" -d "${tempDir}"`, {
+                stdio: "inherit",
+            });
+            const extractedBinary = join(tempDir, "aptos");
+            execSync(`mv "${extractedBinary}" "${binaryPath}"`, { stdio: "inherit" });
+            chmodSync(binaryPath, 0o755);
+            try {
+                execSync(`rm -f "${zipPath}"`, { stdio: "ignore" });
+            }
+            catch {
+            }
         }
-        if (opensSslVersion.startsWith("3.")) {
-            osVersion = "22.04-x86_64";
+        console.log(`Aptos CLI installed successfully to ${binaryPath}`);
+        if (os !== "Windows") {
+            console.log(`\nMake sure ${binDir} is in your PATH. You can add it by running:`);
+            console.log(`  export PATH="${binDir}:$PATH"`);
         }
-        console.log(`Downloading CLI binary ${os}-${osVersion}`);
-        const url = `${GH_CLI_DOWNLOAD_URL}/${PNAME}-v${latestCLIVersion}/${PNAME}-${latestCLIVersion}-${os}-${osVersion}.zip`;
-        execSync(`curl -L -o /tmp/aptos.zip ${url}; unzip -o -q /tmp/aptos.zip -d /tmp; mv /tmp/aptos ${path};`);
+    }
+    catch (error) {
+        throw new Error(`Failed to install Aptos CLI: ${error instanceof Error ? error.message : String(error)}`);
     }
 };
 //# sourceMappingURL=install.js.map

package/dist/tasks/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../bin/tasks/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE;IACnC,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAC9C,OAAO;IACT,CAAC;IAED,MAAM,gBAAgB,GAAG,MAAM,kBAAkB,EAAE,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,iCAAiC,gBAAgB,EAAE,CAAC,CAAC;IACjE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IAEnB,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,GAAG,mBAAmB,IAAI,KAAK,KAAK,gBAAgB,IAAI,KAAK,IAAI,gBAAgB,IAAI,EAAE,aAAa,CAAC;QAEjH,QAAQ,CACN,oIAAoI,GAAG,4JAA4J,IAAI,KAAK,CAC7S,CAAC;IACJ,CAAC;SAAM,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;QAE1B,aAAa,CAAC,oBAAoB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC;SAAM,CAAC;QAGN,IAAI,SAAS,GAAG,QAAQ,CAAC;QACzB,IAAI,eAAe,GAAG,OAAO,CAAC;QAC9B,IAAI,CAAC;YACH,eAAe,GAAG,wBAAwB,EAAE,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CACT,qEAAqE,CACtE,CAAC;QACJ,CAAC;QAED,IAAI,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,SAAS,GAAG,cAAc,CAAC;QAC7B,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,IAAI,SAAS,EAAE,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,GAAG,mBAAmB,IAAI,KAAK,KAAK,gBAAgB,IAAI,KAAK,IAAI,gBAAgB,IAAI,EAAE,IAAI,SAAS,MAAM,CAAC;QAEvH,QAAQ,CACN,6BAA6B,GAAG,uDAAuD,IAAI,GAAG,CAC/F,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../bin/tasks/install.ts"],"names":[],"mappings":"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","sourcesContent":["import { execSync } from \"node:child_process\";\nimport { chmodSync, existsSync, mkdirSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport {\n  installViaBrew,\n  isBrewAvailable,\n  isInstalledViaBrew,\n} from \"../utils/brewOperations.js\";\nimport { GH_CLI_DOWNLOAD_URL, PNAME } from \"../utils/consts.js\";\nimport {\n  getBinDir,\n  getLocalBinPath,\n  invalidateBinPathCache,\n} from \"../utils/getLocalBinPath.js\";\nimport { getOS, getTargetPlatform } from \"../utils/getUserOs.js\";\nimport {\n  getCliVersion,\n  hasUserSpecifiedVersion,\n} from \"../utils/ghOperations.js\";\nimport {\n  installViaChoco,\n  installViaWinget,\n  isChocoAvailable,\n  isInstalledViaChoco,\n  isInstalledViaWinget,\n  isWingetAvailable,\n} from \"../utils/windowsPackageManagers.js\";\n\n/**\n * Install the Aptos CLI.\n *\n * Installation priority:\n *\n * macOS:\n *   1. Homebrew (if available)\n *   2. Direct download from GitHub releases\n *\n * Windows:\n *   1. winget (if available)\n *   2. Chocolatey (if available)\n *   3. Direct download from GitHub releases\n *\n * Linux:\n *   - Direct download from GitHub releases\n *\n * Note: When APTOS_CLI_VERSION is set, package managers are skipped and the\n * specified version is downloaded directly from GitHub releases.\n *\n * @param directDownload - If true, skip package managers and download directly\n */\nexport const installCli = async (\n  directDownload: boolean = false,\n): Promise<void> => {\n  invalidateBinPathCache();\n  const os = getOS();\n\n  // If a specific version is requested, force direct download\n  // Package managers don't support installing specific versions\n  const useDirectDownload = directDownload || hasUserSpecifiedVersion();\n\n  if (useDirectDownload && hasUserSpecifiedVersion()) {\n    console.log(\n      `Using specified version from APTOS_CLI_VERSION: ${process.env.APTOS_CLI_VERSION}`,\n    );\n  }\n\n  // Skip package managers if directDownload is set or specific version requested\n  if (!useDirectDownload) {\n    // On macOS, prefer Homebrew if available\n    if (os === \"MacOS\" && isBrewAvailable()) {\n      if (isInstalledViaBrew()) {\n        console.log(\"Aptos CLI is already installed via Homebrew\");\n        return;\n      }\n      installViaBrew();\n      return;\n    }\n\n    // On Windows, prefer winget, then Chocolatey\n    if (os === \"Windows\") {\n      if (isWingetAvailable()) {\n        if (isInstalledViaWinget()) {\n          console.log(\"Aptos CLI is already installed via winget\");\n          return;\n        }\n        installViaWinget();\n        return;\n      }\n\n      if (isChocoAvailable()) {\n        if (isInstalledViaChoco()) {\n          console.log(\"Aptos CLI is already installed via Chocolatey\");\n          return;\n        }\n        installViaChoco();\n        return;\n      }\n    }\n  }\n\n  // Direct download installation\n  const binaryPath = getLocalBinPath();\n  if (existsSync(binaryPath)) {\n    console.log(\"Aptos CLI is already installed\");\n    return;\n  }\n\n  // Ensure the bin directory exists\n  const binDir = getBinDir();\n  if (!existsSync(binDir)) {\n    mkdirSync(binDir, { recursive: true });\n  }\n\n  // Get target platform first for version validation\n  const targetPlatform = getTargetPlatform();\n\n  // Get the version to install (user-specified or latest)\n  const version = await getCliVersion(targetPlatform);\n\n  console.log(\n    `Downloading Aptos CLI version ${version} for ${targetPlatform}...`,\n  );\n\n  // Build download URL matching official release artifact naming\n  const url = `${GH_CLI_DOWNLOAD_URL}/${PNAME}-v${version}/${PNAME}-${version}-${targetPlatform}.zip`;\n\n  const tempDir = tmpdir();\n\n  try {\n    if (os === \"Windows\") {\n      // Windows installation using PowerShell\n      const zipPath = join(tempDir, \"aptos-cli.zip\");\n      execSync(\n        `powershell -Command \"` +\n          `Invoke-WebRequest -Uri '${url}' -OutFile '${zipPath}'; ` +\n          `Expand-Archive -Path '${zipPath}' -DestinationPath '${binDir}' -Force; ` +\n          `Remove-Item -Path '${zipPath}' -Force\"`,\n        { stdio: \"inherit\" },\n      );\n    } else {\n      // macOS (without Homebrew) and Linux installation using curl/unzip\n      const zipPath = join(tempDir, \"aptos-cli.zip\");\n\n      // Download\n      execSync(`curl -L -o \"${zipPath}\" \"${url}\"`, { stdio: \"inherit\" });\n\n      // Extract\n      execSync(`unzip -o -q \"${zipPath}\" -d \"${tempDir}\"`, {\n        stdio: \"inherit\",\n      });\n\n      // Move binary to bin directory\n      const extractedBinary = join(tempDir, \"aptos\");\n      execSync(`mv \"${extractedBinary}\" \"${binaryPath}\"`, { stdio: \"inherit\" });\n\n      // Set executable permissions\n      chmodSync(binaryPath, 0o755);\n\n      // Clean up\n      try {\n        execSync(`rm -f \"${zipPath}\"`, { stdio: \"ignore\" });\n      } catch {\n        // Ignore cleanup errors\n      }\n    }\n\n    console.log(`Aptos CLI installed successfully to ${binaryPath}`);\n\n    // Remind user about PATH if needed\n    if (os !== \"Windows\") {\n      console.log(\n        `\\nMake sure ${binDir} is in your PATH. You can add it by running:`,\n      );\n      console.log(`  export PATH=\"${binDir}:$PATH\"`);\n    }\n  } catch (error) {\n    throw new Error(\n      `Failed to install Aptos CLI: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n};\n"]}

package/dist/tasks/install.test.js

@@ -0,0 +1,227 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("child_process", () => ({
+    execSync: vi.fn(),
+}));
+vi.mock("fs", () => ({
+    existsSync: vi.fn(),
+    chmodSync: vi.fn(),
+    mkdirSync: vi.fn(),
+}));
+vi.mock("os", () => ({
+    tmpdir: () => "/tmp",
+    homedir: () => "/home/user",
+    platform: vi.fn(() => "linux"),
+    arch: vi.fn(() => "x64"),
+}));
+vi.mock("../utils/getUserOs.js", () => ({
+    getOS: vi.fn(),
+    getTargetPlatform: vi.fn(),
+}));
+vi.mock("../utils/getLocalBinPath.js", () => ({
+    getLocalBinPath: vi.fn(),
+    getBinDir: vi.fn(),
+    invalidateBinPathCache: vi.fn(),
+}));
+vi.mock("../utils/ghOperations.js", () => ({
+    getCliVersion: vi.fn(),
+    hasUserSpecifiedVersion: vi.fn(),
+}));
+vi.mock("../utils/brewOperations.js", () => ({
+    isBrewAvailable: vi.fn(),
+    isInstalledViaBrew: vi.fn(),
+    installViaBrew: vi.fn(),
+}));
+vi.mock("../utils/windowsPackageManagers.js", () => ({
+    isWingetAvailable: vi.fn(),
+    isChocoAvailable: vi.fn(),
+    isInstalledViaWinget: vi.fn(),
+    isInstalledViaChoco: vi.fn(),
+    installViaWinget: vi.fn(),
+    installViaChoco: vi.fn(),
+}));
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync } from "node:fs";
+import { installViaBrew, isBrewAvailable, isInstalledViaBrew, } from "../utils/brewOperations.js";
+import { getBinDir, getLocalBinPath } from "../utils/getLocalBinPath.js";
+import { getOS, getTargetPlatform } from "../utils/getUserOs.js";
+import { getCliVersion, hasUserSpecifiedVersion, } from "../utils/ghOperations.js";
+import { installViaChoco, installViaWinget, isChocoAvailable, isInstalledViaChoco, isInstalledViaWinget, isWingetAvailable, } from "../utils/windowsPackageManagers.js";
+import { installCli } from "./install.js";
+describe("install", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.mocked(getLocalBinPath).mockReturnValue("/home/user/.local/bin/aptos");
+        vi.mocked(getBinDir).mockReturnValue("/home/user/.local/bin");
+        vi.mocked(getCliVersion).mockResolvedValue("1.0.0");
+        vi.mocked(hasUserSpecifiedVersion).mockReturnValue(false);
+        vi.mocked(getTargetPlatform).mockReturnValue("Linux-x86_64");
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe("macOS with Homebrew", () => {
+        beforeEach(() => {
+            vi.mocked(getOS).mockReturnValue("MacOS");
+            vi.mocked(isBrewAvailable).mockReturnValue(true);
+        });
+        it("should use Homebrew when available", async () => {
+            vi.mocked(isInstalledViaBrew).mockReturnValue(false);
+            await installCli();
+            expect(installViaBrew).toHaveBeenCalled();
+            expect(execSync).not.toHaveBeenCalled();
+        });
+        it("should skip if already installed via Homebrew", async () => {
+            vi.mocked(isInstalledViaBrew).mockReturnValue(true);
+            await installCli();
+            expect(installViaBrew).not.toHaveBeenCalled();
+        });
+        it("should skip Homebrew when directDownload is true", async () => {
+            vi.mocked(isInstalledViaBrew).mockReturnValue(false);
+            vi.mocked(existsSync).mockReturnValue(false);
+            vi.mocked(execSync).mockReturnValue(Buffer.from(""));
+            vi.mocked(getTargetPlatform).mockReturnValue("macos-x86_64");
+            await installCli(true);
+            expect(installViaBrew).not.toHaveBeenCalled();
+            expect(execSync).toHaveBeenCalled();
+        });
+    });
+    describe("Windows with winget", () => {
+        beforeEach(() => {
+            vi.mocked(getOS).mockReturnValue("Windows");
+            vi.mocked(isBrewAvailable).mockReturnValue(false);
+            vi.mocked(isWingetAvailable).mockReturnValue(true);
+            vi.mocked(isChocoAvailable).mockReturnValue(false);
+        });
+        it("should use winget when available", async () => {
+            vi.mocked(isInstalledViaWinget).mockReturnValue(false);
+            await installCli();
+            expect(installViaWinget).toHaveBeenCalled();
+            expect(installViaChoco).not.toHaveBeenCalled();
+        });
+        it("should skip if already installed via winget", async () => {
+            vi.mocked(isInstalledViaWinget).mockReturnValue(true);
+            await installCli();
+            expect(installViaWinget).not.toHaveBeenCalled();
+        });
+    });
+    describe("Windows with Chocolatey", () => {
+        beforeEach(() => {
+            vi.mocked(getOS).mockReturnValue("Windows");
+            vi.mocked(isBrewAvailable).mockReturnValue(false);
+            vi.mocked(isWingetAvailable).mockReturnValue(false);
+            vi.mocked(isChocoAvailable).mockReturnValue(true);
+        });
+        it("should use Chocolatey when winget is not available", async () => {
+            vi.mocked(isInstalledViaChoco).mockReturnValue(false);
+            await installCli();
+            expect(installViaChoco).toHaveBeenCalled();
+            expect(installViaWinget).not.toHaveBeenCalled();
+        });
+        it("should skip if already installed via Chocolatey", async () => {
+            vi.mocked(isInstalledViaChoco).mockReturnValue(true);
+            await installCli();
+            expect(installViaChoco).not.toHaveBeenCalled();
+        });
+    });
+    describe("Windows direct download", () => {
+        beforeEach(() => {
+            vi.mocked(getOS).mockReturnValue("Windows");
+            vi.mocked(isBrewAvailable).mockReturnValue(false);
+            vi.mocked(isWingetAvailable).mockReturnValue(false);
+            vi.mocked(isChocoAvailable).mockReturnValue(false);
+            vi.mocked(existsSync).mockReturnValue(false);
+            vi.mocked(getTargetPlatform).mockReturnValue("Windows-x86_64");
+        });
+        it("should download directly when no package manager available", async () => {
+            vi.mocked(execSync).mockReturnValue(Buffer.from(""));
+            await installCli();
+            expect(installViaWinget).not.toHaveBeenCalled();
+            expect(installViaChoco).not.toHaveBeenCalled();
+            expect(execSync).toHaveBeenCalledWith(expect.stringContaining("powershell"), expect.any(Object));
+        });
+        it("should skip package managers when directDownload is true", async () => {
+            vi.mocked(isWingetAvailable).mockReturnValue(true);
+            vi.mocked(isChocoAvailable).mockReturnValue(true);
+            vi.mocked(execSync).mockReturnValue(Buffer.from(""));
+            await installCli(true);
+            expect(installViaWinget).not.toHaveBeenCalled();
+            expect(installViaChoco).not.toHaveBeenCalled();
+            expect(execSync).toHaveBeenCalled();
+        });
+    });
+    describe("Linux direct download", () => {
+        beforeEach(() => {
+            vi.mocked(getOS).mockReturnValue("Linux");
+            vi.mocked(isBrewAvailable).mockReturnValue(false);
+            vi.mocked(existsSync).mockReturnValue(false);
+            vi.mocked(getTargetPlatform).mockReturnValue("Ubuntu-22.04-x86_64");
+        });
+        it("should download directly on Linux", async () => {
+            vi.mocked(execSync).mockReturnValue(Buffer.from(""));
+            await installCli();
+            expect(execSync).toHaveBeenCalledWith(expect.stringContaining("curl"), expect.any(Object));
+        });
+        it("should create bin directory if it doesn't exist", async () => {
+            vi.mocked(existsSync).mockImplementation((path) => {
+                if (path === "/home/user/.local/bin")
+                    return false;
+                return false;
+            });
+            vi.mocked(execSync).mockReturnValue(Buffer.from(""));
+            await installCli();
+            expect(mkdirSync).toHaveBeenCalledWith("/home/user/.local/bin", {
+                recursive: true,
+            });
+        });
+    });
+    describe("already installed", () => {
+        it("should skip if binary already exists", async () => {
+            vi.mocked(getOS).mockReturnValue("Linux");
+            vi.mocked(isBrewAvailable).mockReturnValue(false);
+            vi.mocked(existsSync).mockReturnValue(true);
+            await installCli();
+            expect(execSync).not.toHaveBeenCalled();
+            expect(getCliVersion).not.toHaveBeenCalled();
+        });
+    });
+    describe("specific version via APTOS_CLI_VERSION", () => {
+        beforeEach(() => {
+            vi.mocked(hasUserSpecifiedVersion).mockReturnValue(true);
+            vi.mocked(getCliVersion).mockResolvedValue("4.5.0");
+        });
+        it("should skip package managers when specific version is set", async () => {
+            vi.mocked(getOS).mockReturnValue("MacOS");
+            vi.mocked(isBrewAvailable).mockReturnValue(true);
+            vi.mocked(isInstalledViaBrew).mockReturnValue(false);
+            vi.mocked(existsSync).mockReturnValue(false);
+            vi.mocked(execSync).mockReturnValue(Buffer.from(""));
+            vi.mocked(getTargetPlatform).mockReturnValue("macos-x86_64");
+            await installCli();
+            expect(installViaBrew).not.toHaveBeenCalled();
+            expect(execSync).toHaveBeenCalled();
+        });
+        it("should skip winget when specific version is set on Windows", async () => {
+            vi.mocked(getOS).mockReturnValue("Windows");
+            vi.mocked(isBrewAvailable).mockReturnValue(false);
+            vi.mocked(isWingetAvailable).mockReturnValue(true);
+            vi.mocked(isChocoAvailable).mockReturnValue(true);
+            vi.mocked(existsSync).mockReturnValue(false);
+            vi.mocked(execSync).mockReturnValue(Buffer.from(""));
+            vi.mocked(getTargetPlatform).mockReturnValue("Windows-x86_64");
+            await installCli();
+            expect(installViaWinget).not.toHaveBeenCalled();
+            expect(installViaChoco).not.toHaveBeenCalled();
+            expect(execSync).toHaveBeenCalled();
+        });
+        it("should use specific version in download URL", async () => {
+            vi.mocked(getOS).mockReturnValue("Linux");
+            vi.mocked(isBrewAvailable).mockReturnValue(false);
+            vi.mocked(existsSync).mockReturnValue(false);
+            vi.mocked(execSync).mockReturnValue(Buffer.from(""));
+            vi.mocked(getTargetPlatform).mockReturnValue("Ubuntu-22.04-x86_64");
+            await installCli();
+            expect(execSync).toHaveBeenCalledWith(expect.stringContaining("4.5.0"), expect.any(Object));
+        });
+    });
+});
+//# sourceMappingURL=install.test.js.map