mpx-api 1.2.0 → 1.2.1

package/bin/mpx-api.js

@@ -63,6 +63,79 @@ registerHistoryCommand(program);
 registerLoadCommand(program);
 registerDocsCommand(program);
 
+// Update subcommand
+program
+  .command('update')
+  .description('Check for updates and optionally install the latest version')
+  .option('--check', 'Only check for updates (do not install)')
+  .action(async (options, cmd) => {
+    const { checkForUpdate, performUpdate } = await import('../src/update.js');
+    const chalk = (await import('chalk')).default;
+    const jsonMode = cmd.parent?.opts()?.output === 'json';
+
+    try {
+      const info = checkForUpdate();
+
+      if (jsonMode) {
+        const output = {
+          current: info.current,
+          latest: info.latest,
+          updateAvailable: info.updateAvailable,
+          isGlobal: info.isGlobal
+        };
+
+        if (!options.check && info.updateAvailable) {
+          try {
+            const result = performUpdate(info.isGlobal);
+            output.updated = true;
+            output.newVersion = result.version;
+          } catch (err) {
+            output.updated = false;
+            output.error = err.message;
+          }
+        }
+
+        console.log(JSON.stringify(output, null, 2));
+        process.exit(0);
+        return;
+      }
+
+      // Human-readable output
+      if (!info.updateAvailable) {
+        console.log('');
+        console.log(chalk.green.bold(`✓ mpx-api v${info.current} is up to date`));
+        console.log('');
+        process.exit(0);
+        return;
+      }
+
+      console.log('');
+      console.log(chalk.yellow.bold(`⬆ Update available: v${info.current} → v${info.latest}`));
+
+      if (options.check) {
+        console.log(chalk.gray(`Run ${chalk.cyan('mpx-api update')} to install`));
+        console.log('');
+        process.exit(0);
+        return;
+      }
+
+      console.log(chalk.gray(`Installing v${info.latest}${info.isGlobal ? ' (global)' : ''}...`));
+
+      const result = performUpdate(info.isGlobal);
+      console.log(chalk.green.bold(`✓ Updated to v${result.version}`));
+      console.log('');
+      process.exit(0);
+    } catch (err) {
+      if (jsonMode) {
+        console.log(JSON.stringify({ error: err.message, code: 'ERR_UPDATE' }, null, 2));
+      } else {
+        console.error(chalk.red.bold('\n❌ Update check failed:'), err.message);
+        console.error('');
+      }
+      process.exit(1);
+    }
+  });
+
 // MCP subcommand
 program
   .command('mcp')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mpx-api",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Developer-first API testing, mocking, and documentation CLI with AI-native features (JSON output, MCP server)",
   "main": "src/index.js",
   "bin": {

package/src/schema.js

@@ -253,6 +253,18 @@ export function getSchema() {
         examples: [
           { command: 'mpx-api mcp', description: 'Start MCP stdio server' }
         ]
+      },
+      update: {
+        description: 'Check for updates and optionally install the latest version',
+        usage: 'mpx-api update [--check] [-o json]',
+        flags: {
+          '--check': { description: 'Only check for updates (do not install)', default: false }
+        },
+        examples: [
+          { command: 'mpx-api update', description: 'Check and install updates' },
+          { command: 'mpx-api update --check', description: 'Just check for updates' },
+          { command: 'mpx-api update --check -o json', description: 'Check for updates (JSON output)' }
+        ]
       }
     },
     globalFlags: {

package/src/update.js

@@ -0,0 +1,72 @@
+/**
+ * Update Command
+ * 
+ * Checks npm for the latest version of mpx-api and offers to update.
+ */
+
+import { execSync } from 'child_process';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf8'));
+
+/**
+ * Check npm registry for latest version
+ * @returns {object} { current, latest, updateAvailable, isGlobal }
+ */
+export function checkForUpdate() {
+  const current = pkg.version;
+  
+  let latest;
+  try {
+    latest = execSync('npm view mpx-api version', { encoding: 'utf8', timeout: 10000 }).trim();
+  } catch (err) {
+    throw new Error('Failed to check npm registry: ' + (err.message || 'unknown error'));
+  }
+  
+  const updateAvailable = latest !== current && compareVersions(latest, current) > 0;
+  
+  // Detect if installed globally
+  let isGlobal = false;
+  try {
+    const globalDir = execSync('npm root -g', { encoding: 'utf8', timeout: 5000 }).trim();
+    isGlobal = __dirname.startsWith(globalDir) || process.argv[1]?.includes('node_modules/.bin');
+  } catch {
+    // Can't determine, assume local
+  }
+  
+  return { current, latest, updateAvailable, isGlobal };
+}
+
+/**
+ * Perform the update
+ * @param {boolean} isGlobal - Install globally
+ * @returns {object} { success, version }
+ */
+export function performUpdate(isGlobal) {
+  const cmd = isGlobal ? 'npm install -g mpx-api@latest' : 'npm install mpx-api@latest';
+  try {
+    execSync(cmd, { encoding: 'utf8', timeout: 60000, stdio: 'pipe' });
+    // Verify
+    const newVersion = execSync('npm view mpx-api version', { encoding: 'utf8', timeout: 10000 }).trim();
+    return { success: true, version: newVersion };
+  } catch (err) {
+    throw new Error('Update failed: ' + (err.message || 'unknown error'));
+  }
+}
+
+/**
+ * Compare semver strings. Returns >0 if a > b, <0 if a < b, 0 if equal.
+ */
+export function compareVersions(a, b) {
+  const pa = a.split('.').map(Number);
+  const pb = b.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] || 0) > (pb[i] || 0)) return 1;
+    if ((pa[i] || 0) < (pb[i] || 0)) return -1;
+  }
+  return 0;
+}