@mintlify/cli 4.0.571 → 4.0.572

package/bin/update.js

@@ -0,0 +1,53 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { getTargetMintVersion, downloadTargetMint } from '@mintlify/previewing';
+import { execSync } from 'node:child_process';
+import { buildLogger, getLatestCliVersion, getVersions } from './helpers.js';
+export const update = (_a) => __awaiter(void 0, [_a], void 0, function* ({ packageName }) {
+    const logger = buildLogger(`Updating ${packageName} to the latest version...`);
+    const { cli: existingCliVersion, client: existingClientVersion } = getVersions();
+    const latestCliVersion = getLatestCliVersion(packageName);
+    const latestClientVersion = yield getTargetMintVersion(logger);
+    const isUpToDate = existingCliVersion &&
+        existingClientVersion &&
+        latestClientVersion &&
+        latestCliVersion &&
+        latestCliVersion.trim() === existingCliVersion.trim() &&
+        latestClientVersion.trim() === existingClientVersion.trim();
+    if (isUpToDate) {
+        logger.succeed('Already up to date.');
+        return;
+    }
+    if (existingCliVersion && latestCliVersion.trim() !== existingCliVersion.trim()) {
+        try {
+            logger.text = `Updating ${packageName} package...`;
+            execSync(`npm install -g ${packageName}@latest --silent`);
+        }
+        catch (err) {
+            logger.fail(`Failed to update ${packageName}@latest`);
+            process.exit(1);
+        }
+    }
+    if (latestClientVersion && latestClientVersion !== existingClientVersion) {
+        try {
+            logger.text = `Updating Mintlify client to ${latestClientVersion}...`;
+            yield downloadTargetMint({
+                logger,
+                targetVersion: latestClientVersion,
+                existingVersion: existingClientVersion !== null && existingClientVersion !== void 0 ? existingClientVersion : null,
+            });
+        }
+        catch (err) {
+            logger.fail(`Failed to update Mintlify client to ${latestClientVersion}`);
+            process.exit(1);
+        }
+    }
+    logger.succeed(`Updated ${packageName} to the latest version: ${latestCliVersion}`);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.571",
+  "version": "4.0.572",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -43,7 +43,7 @@
     "@mintlify/link-rot": "3.0.525",
     "@mintlify/models": "0.0.195",
     "@mintlify/prebuild": "1.0.522",
-    "@mintlify/previewing": "4.0.562",
+    "@mintlify/previewing": "4.0.563",
     "@mintlify/validation": "0.1.390",
     "chalk": "^5.2.0",
     "detect-port": "^1.5.1",
@@ -68,7 +68,8 @@
     "prettier": "^3.1.1",
     "rimraf": "^5.0.1",
     "typescript": "^5.5.3",
-    "vitest": "^2.0.4"
+    "vitest": "^2.0.4",
+    "vitest-mock-process": "^1.0.4"
   },
-  "gitHead": "5bd94415bf9977160b000aa2776dd65161b03ed6"
+  "gitHead": "5ca64a06ad9b1c7d52f0a98eb00cd4bdc4a48c7e"
 }

package/src/cli.ts

@@ -16,6 +16,7 @@ import {
   checkForDocsJson,
   getVersions,
 } from './helpers.js';
+import { update } from './update.js';
 
 export const cli = () =>
   yargs(hideBin(process.argv))
@@ -47,10 +48,12 @@ export const cli = () =>
           .example('mintlify dev --no-open', 'Run without opening in browser'),
       async (argv) => {
         const port = await checkPort(argv);
+        const packageName = process.argv[1]?.split('/').pop() ?? 'mintlify';
         if (port != undefined) {
           await dev({
             ...argv,
             port,
+            packageName,
           });
         } else {
           console.error(`No available port found.`);
@@ -163,6 +166,15 @@ export const cli = () =>
         await renameFilesAndUpdateLinksInContent(from, to);
       }
     )
+    .command(
+      'update',
+      'Update the Mintlify client and cli to the latest version',
+      () => undefined,
+      async () => {
+        const packageName = process.argv[1]?.split('/').pop() ?? 'mintlify';
+        await update({ packageName });
+      }
+    )
     .command(
       'upgrade',
       'Upgrade the mint.json file to v2 (docs.json)',

package/src/helpers.ts

@@ -7,6 +7,7 @@ import detect from 'detect-port';
 import fse from 'fs-extra';
 import fs from 'fs/promises';
 import inquirer from 'inquirer';
+import { execSync } from 'node:child_process';
 import Ora, { Ora as OraType } from 'ora';
 import path from 'path';
 import type { ArgumentsCamelCase } from 'yargs';
@@ -118,3 +119,10 @@ export const getVersions = (): {
   const client = getClientVersion().trim();
   return { cli, client };
 };
+
+export const getLatestCliVersion = (packageName: string) => {
+  return execSync(`npm view ${packageName} version --silent`, {
+    encoding: 'utf-8',
+    stdio: ['pipe', 'pipe', 'pipe'],
+  }).trim();
+};

package/src/update.ts

@@ -0,0 +1,49 @@
+import { getTargetMintVersion, downloadTargetMint } from '@mintlify/previewing';
+import { execSync } from 'node:child_process';
+
+import { buildLogger, getLatestCliVersion, getVersions } from './helpers.js';
+
+export const update = async ({ packageName }: { packageName: string }) => {
+  const logger = buildLogger(`Updating ${packageName} to the latest version...`);
+  const { cli: existingCliVersion, client: existingClientVersion } = getVersions();
+  const latestCliVersion = getLatestCliVersion(packageName);
+  const latestClientVersion = await getTargetMintVersion(logger);
+  const isUpToDate =
+    existingCliVersion &&
+    existingClientVersion &&
+    latestClientVersion &&
+    latestCliVersion &&
+    latestCliVersion.trim() === existingCliVersion.trim() &&
+    latestClientVersion.trim() === existingClientVersion.trim();
+
+  if (isUpToDate) {
+    logger.succeed('Already up to date.');
+    return;
+  }
+
+  if (existingCliVersion && latestCliVersion.trim() !== existingCliVersion.trim()) {
+    try {
+      logger.text = `Updating ${packageName} package...`;
+      execSync(`npm install -g ${packageName}@latest --silent`);
+    } catch (err) {
+      logger.fail(`Failed to update ${packageName}@latest`);
+      process.exit(1);
+    }
+  }
+
+  if (latestClientVersion && latestClientVersion !== existingClientVersion) {
+    try {
+      logger.text = `Updating Mintlify client to ${latestClientVersion}...`;
+      await downloadTargetMint({
+        logger,
+        targetVersion: latestClientVersion,
+        existingVersion: existingClientVersion ?? null,
+      });
+    } catch (err) {
+      logger.fail(`Failed to update Mintlify client to ${latestClientVersion}`);
+      process.exit(1);
+    }
+  }
+
+  logger.succeed(`Updated ${packageName} to the latest version: ${latestCliVersion}`);
+};