@docubook/cli 0.2.3 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docubook/cli",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "DocuBook CLI tool that helps you initialize, update, and deploy documentation directly from your terminal.",
   "type": "module",
   "files": [
@@ -12,11 +12,6 @@
     "docubook": "src/index.js"
   },
   "main": "./src/index.js",
-  "scripts": {
-    "dev": "node src/index.js",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix"
-  },
   "keywords": [
     "docubook",
     "documentation",
@@ -47,5 +42,10 @@
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "scripts": {
+    "dev": "node src/index.js",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix"
   }
-}
+}

package/src/cli/program.js

@@ -1,3 +1,4 @@
+/* global fetch */
 import { program } from "commander";
 import { collectUserInput } from "./promptHandler.js";
 import { createProject } from "../installer/projectInstaller.js";
@@ -6,6 +7,8 @@ import { renderWelcome, renderDone, renderError } from "../tui/renderer.js";
 import { CLIState } from "../tui/state.js";
 import { detectPackageManager, getPackageManagerInfo, getPackageManagerVersion } from "../utils/packageManagerDetect.js";
 import { getAvailableTemplates, getTemplate, getDefaultTemplate } from "../utils/templateDetect.js";
+import { execSync } from "child_process";
+import ora from "ora";
 
 /**
  * Initializes the CLI program
@@ -14,7 +17,64 @@ import { getAvailableTemplates, getTemplate, getDefaultTemplate } from "../utils
 export function initializeProgram(version) {
   program
     .version(version)
-    .description("CLI to create a new DocuBook project")
+    .description("CLI to create a new DocuBook project");
+
+  // Add `update` command: check npm registry and install latest globally if needed
+  program
+    .command("update")
+    .description("Check for updates and install the latest DocuBook CLI globally")
+    .action(async () => {
+      const pkgName = "@docubook/cli";
+      // declare spinner in outer scope so catch block can safely reference it
+      let spinner;
+      try {
+        // Fetch package metadata from npm registry
+        const encoded = encodeURIComponent(pkgName);
+        spinner = ora('Checking for updates...').start();
+        const res = await fetch(`https://registry.npmjs.org/${encoded}`);
+        if (!res.ok) {
+          spinner.fail(`Failed to fetch registry metadata (status ${res.status})`);
+          throw new Error(`Failed to fetch registry metadata (status ${res.status})`);
+        }
+        const data = await res.json();
+        const latest = data && data["dist-tags"] && data["dist-tags"].latest;
+        if (!latest) {
+          spinner.fail("Could not determine latest version from npm registry");
+          throw new Error("Could not determine latest version from npm registry");
+        }
+
+        // Stop spinner and print a plain "Checking for updates..." line (no check mark)
+        if (spinner && typeof spinner.stop === 'function') spinner.stop();
+        console.log('Checking for updates...');
+
+        if (latest === version) {
+          console.log(`No update needed, current version is ${version}, fetched latest release is ${latest}`);
+          return;
+        }
+
+        console.log(`Updating ${pkgName} from ${version} to ${latest}...`);
+
+        // Use npm to install globally. This will stream stdout/stderr to the user.
+        const cmd = `npm install -g ${pkgName}@${latest}`;
+        try {
+          execSync(cmd, { stdio: "inherit" });
+          console.log(`Successfully updated to ${latest}`);
+        } catch (installErr) {
+          // If install fails, provide a helpful message
+          console.error(`Update failed: ${installErr.message || installErr}`);
+          console.error(`Try running the following command manually:\n  ${cmd}\nIf you see permissions errors, consider running with elevated privileges or using a Node version manager.`);
+          process.exitCode = 1;
+        }
+      } catch (err) {
+        // ensure spinner is stopped on error
+        if (spinner && typeof spinner.stop === 'function') spinner.stop();
+        console.error(err.message || err);
+        process.exitCode = 1;
+      }
+    });
+
+  // Default behavior (create project)
+  program
     .argument("[directory]", "The name of the project directory")
     .action(async (directory) => {
       const state = new CLIState();

package/src/index.js

@@ -14,6 +14,14 @@ const packageJsonPath = path.join(__dirname, '..', 'package.json');
 const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
 const VERSION = packageJson.version;
 
+// Handle --version / -V early to print custom output
+const args = process.argv.slice(2);
+if (args.includes('--version') || args.includes('-V')) {
+  console.log(`DocuBook CLI ${VERSION}`);
+  console.log("Run 'docubook update' to check for updates.");
+  process.exit(0);
+}
+
 // Initialize and parse CLI arguments
 const program = initializeProgram(VERSION);
 program.parse(process.argv);