feat: bin subcommand for binary management

Author: JacobLinCool

src/index.ts

@@ -5,16 +5,47 @@ import { bin, install } from "./lib.js";
 main();
 
 async function main() {
-    if (!fs.existsSync(bin)) {
-        console.log("Installed cloudflared to " + (await install(bin)));
-    }
-
     const args = process.argv.slice(2);
 
-    if (args[0] === "remove-bin") {
-        fs.unlinkSync(bin);
-        console.log("Removed cloudflared");
-        process.exit(0);
+    if (args[0] === "bin") {
+        if (!args[1]) {
+            console.log(bin);
+            return;
+        }
+        if (args[1] === "remove") {
+            fs.unlinkSync(bin);
+            console.log("Removed cloudflared");
+            return;
+        }
+        if (args[1] === "install") {
+            if (args[2]) {
+                console.log(`Installing cloudflared ${args[2]}`);
+                console.log(await install(bin, args[2]));
+            } else {
+                console.log("Installing latest version of cloudflared");
+                await install(bin);
+            }
+            return;
+        }
+        if (args[1] === "help" || args[1] === "--help" || args[1] === "-h") {
+            console.log(`cloudflared bin                    : Prints the path to the binary`);
+            console.log(`cloudflared bin remove             : Removes the binary`);
+            console.log(`cloudflared bin install [version]  : Installs the binary`);
+            console.log(`cloudflared bin help               : Prints this help message`);
+            console.log(`Examples:`);
+            console.log(
+                `cloudflared bin install            : Installs the latest version of cloudflared`,
+            );
+            console.log(`cloudflared bin install 2022.7.1   : Installs cloudflared 2022.7.1`);
+            console.log(
+                `You can find releases at https://github.com/cloudflare/cloudflared/releases`,
+            );
+            return;
+        }
+    }
+
+    if (!fs.existsSync(bin)) {
+        console.log("Installed cloudflared to " + (await install(bin)));
     }
 
     const sub = spawn(bin, args, { shell: true, stdio: "inherit" });

src/install.ts

@@ -3,79 +3,89 @@ import path from "node:path";
 import https from "node:https";
 import { execSync } from "node:child_process";
 
+const RELEASE_BASE = "https://github.com/cloudflare/cloudflared/releases/";
+
 const LINUX_URL: Partial<Record<typeof process.arch, string>> = {
-    arm64: "https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-arm64",
-    arm: "https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-arm",
-    x64: "https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64",
-    ia32: "https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-386",
+    arm64: "cloudflared-linux-arm64",
+    arm: "cloudflared-linux-arm",
+    x64: "cloudflared-linux-amd64",
+    ia32: "cloudflared-linux-386",
 };
 
 const MACOS_URL: Partial<Record<typeof process.arch, string>> = {
-    arm64: "https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-darwin-amd64.tgz",
-    x64: "https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-darwin-amd64.tgz",
+    arm64: "cloudflared-darwin-amd64.tgz",
+    x64: "cloudflared-darwin-amd64.tgz",
 };
 
 const WINDOWS_URL: Partial<Record<typeof process.arch, string>> = {
-    x64: "https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-windows-amd64.exe",
-    ia32: "https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-windows-386.exe",
+    x64: "cloudflared-windows-amd64.exe",
+    ia32: "cloudflared-windows-386.exe",
 };
 
+function resolve_base(version: string): string {
+    if (version === "latest") {
+        return `${RELEASE_BASE}latest/download/`;
+    }
+    return `${RELEASE_BASE}download/${version}/`;
+}
+
 /**
  * Install cloudflared to the given path.
  * @param to The path to the binary to install.
+ * @param version The version of cloudflared to install.
  * @returns The path to the binary that was installed.
  */
-export async function install(to: string): Promise<string> {
+export async function install(to: string, version = "latest"): Promise<string> {
     if (process.platform === "linux") {
-        return install_linux(to);
+        return install_linux(to, version);
     } else if (process.platform === "darwin") {
-        return install_macos(to);
+        return install_macos(to, version);
     } else if (process.platform === "win32") {
-        return install_windows(to);
+        return install_windows(to, version);
     } else {
         console.error("Unsupported platform: " + process.platform);
         process.exit(1);
     }
 }
 
-export async function install_linux(to: string): Promise<string> {
-    const url = LINUX_URL[process.arch];
+export async function install_linux(to: string, version = "latest"): Promise<string> {
+    const file = LINUX_URL[process.arch];
 
-    if (url === undefined) {
+    if (file === undefined) {
         console.error("Unsupported architecture: " + process.arch);
         process.exit(1);
     }
 
-    await download(url, to);
+    await download(resolve_base(version) + file, to);
     await new Promise((r) => setTimeout(r, 100));
     fs.chmodSync(to, "755");
     return to;
 }
 
-export async function install_macos(to: string): Promise<string> {
-    const url = MACOS_URL[process.arch];
+export async function install_macos(to: string, version = "latest"): Promise<string> {
+    const file = MACOS_URL[process.arch];
 
-    if (url === undefined) {
+    if (file === undefined) {
         console.error("Unsupported architecture: " + process.arch);
         process.exit(1);
     }
 
-    await download(url, `${to}.tgz`);
+    await download(resolve_base(version) + file, `${to}.tgz`);
     process.env.VERBOSE && console.log(`Extracting to ${to}`);
     execSync(`tar -xzf ${path.basename(`${to}.tgz`)}`, { cwd: path.dirname(to) });
     fs.unlinkSync(`${to}.tgz`);
     fs.renameSync(`${path.dirname(to)}/cloudflared`, to);
     return to;
 }
-export async function install_windows(to: string): Promise<string> {
-    const url = WINDOWS_URL[process.arch];
+export async function install_windows(to: string, version = "latest"): Promise<string> {
+    const file = WINDOWS_URL[process.arch];
 
-    if (url === undefined) {
+    if (file === undefined) {
         console.error("Unsupported architecture: " + process.arch);
         process.exit(1);
     }
 
-    await download(url, to);
+    await download(resolve_base(version) + file, to);
     return to;
 }