bin-home 0.1.0 → 0.1.1

package/README.md

@@ -16,6 +16,41 @@ npm install -g bin-home
 bin-home <command> [--open]
 ```
 
+### Version & Update
+
+```bash
+# 显示自身版本与线上版本
+bin-home --version
+
+# 显示指定命令对应包的版本信息
+bin-home codex --version
+
+# 进入更新流程（默认 latest）
+bin-home --update
+```
+
+示例输出：
+
+```
+当前版本: 0.1.0
+线上版本: 0.1.0
+请输入要更新的版本 (默认 latest):
+```
+
+指定命令的更新示例：
+
+```bash
+bin-home codex --update
+```
+
+示例输出：
+
+```
+当前版本: 0.72.0
+线上版本: 0.92.0-alpha.9,0.92.0-alpha.8,0.92.0-alpha.7,0.92.0-alpha.5,0.92.0-alpha.4,0.92.0-alpha.3
+请输入要更新的版本 (默认 latest):
+```
+
 ### Examples
 
 ```bash

package/bin/cli.js

@@ -3,6 +3,12 @@ const path = require("path");
 const validateCommand = require("../lib/commandValidator");
 const findPackageForCommand = require("../lib/packageFinder");
 const displayPackageInfo = require("../lib/packageInfoFormatter");
+const {
+  fetchOnlineVersions,
+  formatVersionOutput,
+  promptForVersion,
+  runGlobalUpdate
+} = require("../lib/versionUpdate");
 
 const COMMAND_NOT_FOUND_EXIT_CODE = 1;
 const PACKAGE_NOT_FOUND_EXIT_CODE = 2;
@@ -13,14 +19,10 @@ function printHelp() {
   console.log("Options:");
   console.log("  --help, -h     Show help");
   console.log("  --version, -v  Show version");
+  console.log("  --update, -u   Update to specified version");
   console.log("  --open, -o     Open npm package page in browser");
 }
 
-function printVersion() {
-  const packageJson = require(path.join(__dirname, "..", "package.json"));
-  console.log(packageJson.version);
-}
-
 function parseArgs(argv) {
   const flags = new Set();
   let commandName = null;
@@ -37,15 +39,58 @@ function parseArgs(argv) {
     commandName,
     help: flags.has("--help") || flags.has("-h"),
     version: flags.has("--version") || flags.has("-v"),
+    update: flags.has("--update") || flags.has("-u"),
     open: flags.has("--open") || flags.has("-o")
   };
 }
 
+async function resolvePackageInfo(commandName) {
+  if (!commandName) {
+    const packageJson = require(path.join(__dirname, "..", "package.json"));
+    return { packageName: packageJson.name, localVersion: packageJson.version };
+  }
+
+  const commandExists = await validateCommand(commandName);
+  if (!commandExists) {
+    const error = new Error(`Command '${commandName}' not found in system PATH`);
+    error.exitCode = COMMAND_NOT_FOUND_EXIT_CODE;
+    throw error;
+  }
+
+  const packageInfo = await findPackageForCommand(commandName);
+  if (!packageInfo) {
+    const error = new Error(
+      `No npm package found for command '${commandName}'. It may not be installed via npm.`
+    );
+    error.exitCode = PACKAGE_NOT_FOUND_EXIT_CODE;
+    throw error;
+  }
+
+  const packageName = packageInfo.packageJson.name || packageInfo.packageName;
+  return {
+    packageName,
+    localVersion: packageInfo.packageJson.version
+  };
+}
+
+async function showVersionInfo(commandName) {
+  const { packageName, localVersion } = await resolvePackageInfo(commandName);
+  const onlineVersions = await fetchOnlineVersions(packageName, { limit: 6 });
+  console.log(formatVersionOutput(localVersion, onlineVersions));
+  return packageName;
+}
+
 async function run() {
-  const { commandName, help, version, open } = parseArgs(process.argv.slice(2));
+  const { commandName, help, version, update, open } = parseArgs(
+    process.argv.slice(2)
+  );
 
-  if (version) {
-    printVersion();
+  if (version || update) {
+    const packageName = await showVersionInfo(commandName);
+    if (update) {
+      const targetVersion = await promptForVersion();
+      await runGlobalUpdate(packageName, targetVersion);
+    }
     return;
   }
 

package/lib/versionUpdate.js

@@ -0,0 +1,126 @@
+const { exec } = require("child_process");
+const readline = require("readline");
+
+const NPM_VIEW_EXIT_CODE = 5;
+const NPM_UPDATE_EXIT_CODE = 6;
+
+function getNpmCommand() {
+  return process.platform === "win32" ? "npm.cmd" : "npm";
+}
+
+function normalizeVersions(raw) {
+  if (!raw) {
+    return [];
+  }
+
+  if (Array.isArray(raw)) {
+    return raw.filter(Boolean);
+  }
+
+  const text = String(raw).trim();
+  if (!text) {
+    return [];
+  }
+
+  try {
+    const parsed = JSON.parse(text);
+    if (Array.isArray(parsed)) {
+      return parsed.filter(Boolean);
+    }
+  } catch (error) {
+    // Fall through for non-JSON outputs.
+  }
+
+  return text
+    .replace(/[\[\]]/g, "")
+    .split(/[\s,]+/)
+    .filter(Boolean);
+}
+
+function sortNewestFirst(versions) {
+  if (!versions.length) {
+    return [];
+  }
+
+  const sorted = versions.slice();
+  sorted.reverse();
+  return sorted;
+}
+
+function execCommand(command, execFn, exitCode, errorMessage) {
+  return new Promise((resolve, reject) => {
+    execFn(
+      command,
+      { maxBuffer: 10 * 1024 * 1024, windowsHide: true },
+      (error, stdout) => {
+        if (error) {
+          const err = new Error(`${errorMessage}: ${error.message}`);
+          err.exitCode = exitCode;
+          return reject(err);
+        }
+        resolve(stdout);
+      }
+    );
+  });
+}
+
+async function fetchOnlineVersions(packageName, options = {}) {
+  if (options.versionsOverride) {
+    const versions = normalizeVersions(options.versionsOverride);
+    return sortNewestFirst(versions).slice(0, options.limit || 6);
+  }
+
+  if (process.env.BIN_HOME_TEST_VERSIONS) {
+    const versions = normalizeVersions(process.env.BIN_HOME_TEST_VERSIONS);
+    return sortNewestFirst(versions).slice(0, options.limit || 6);
+  }
+
+  const npmCommand = getNpmCommand();
+  const command = `${npmCommand} view ${packageName} versions --json`;
+  const stdout = await execCommand(
+    command,
+    options.execFn || exec,
+    NPM_VIEW_EXIT_CODE,
+    `Failed to fetch npm versions for ${packageName}`
+  );
+  const versions = normalizeVersions(stdout);
+  return sortNewestFirst(versions).slice(0, options.limit || 6);
+}
+
+function formatVersionOutput(localVersion, versions) {
+  const list = Array.isArray(versions) ? versions : [];
+  return `当前版本: ${localVersion}\n线上版本: ${list.join(",")}`;
+}
+
+function promptForVersion(options = {}) {
+  const input = options.input || process.stdin;
+  const output = options.output || process.stdout;
+  const defaultVersion = options.defaultVersion || "latest";
+
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input, output });
+    rl.question(`请输入要更新的版本 (默认 ${defaultVersion}): `, (answer) => {
+      rl.close();
+      const trimmed = answer.trim();
+      resolve(trimmed || defaultVersion);
+    });
+  });
+}
+
+async function runGlobalUpdate(packageName, version, options = {}) {
+  const npmCommand = getNpmCommand();
+  const command = `${npmCommand} i -g ${packageName}@${version}`;
+  return execCommand(
+    command,
+    options.execFn || exec,
+    NPM_UPDATE_EXIT_CODE,
+    `Failed to update ${packageName}`
+  );
+}
+
+module.exports = {
+  fetchOnlineVersions,
+  formatVersionOutput,
+  promptForVersion,
+  runGlobalUpdate
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bin-home",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Find which global npm package provides a CLI command",
   "author": "bin-home",
   "license": "MIT",