@mintlify/cli 4.0.1068 → 4.0.1070

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.1068",
+  "version": "4.0.1070",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -62,6 +62,7 @@
     "inquirer": "12.3.0",
     "js-yaml": "4.1.0",
     "mdast-util-mdx-jsx": "3.2.0",
+    "openid-client": "^6.8.2",
     "posthog-node": "5.17.2",
     "react": "19.2.3",
     "semver": "7.7.2",
@@ -88,5 +89,5 @@
     "vitest": "2.1.9",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "3401569a70e020cc6f08559f5f6feed9715c8324"
+  "gitHead": "f7c3aa2f0d1ea8c6368ac8467fc07dbccdf6bd51"
 }

package/src/cli.tsx

@@ -27,16 +27,15 @@ import { accessibilityCheck } from './accessibilityCheck.js';
 import { setTelemetryEnabled } from './config.js';
 import {
   checkPort,
-  checkForMintJson,
   checkNodeVersion,
-  upgradeConfig,
-  checkForDocsJson,
+  autoUpgradeIfNeeded,
   getVersions,
   suppressConsoleWarnings,
   terminate,
   readLocalOpenApiFile,
 } from './helpers.js';
 import { init } from './init.js';
+import { login } from './login.js';
 import { mdxLinter } from './mdxLinter.js';
 import { migrateMdx } from './migrateMdx.js';
 import { scrapeSite, scrapePage, scrapeOpenApi } from './scrape.js';
@@ -109,6 +108,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
             .example('mintlify dev', 'run with default settings (opens in browser)')
             .example('mintlify dev --no-open', 'run without opening in browser'),
         async (argv) => {
+          await autoUpgradeIfNeeded();
           const port = await checkPort(argv);
           const { cli: cliVersion } = getVersions();
           if (port != undefined) {
@@ -273,11 +273,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
               description: 'also check links inside <Snippet> components',
             }),
         async (argv) => {
-          const hasMintJson = await checkForMintJson();
-          if (!hasMintJson) {
-            await checkForDocsJson();
-          }
-
+          await autoUpgradeIfNeeded();
           addLog(<SpinnerLog message="checking for broken links..." />);
           try {
             const graph = await buildGraph(undefined, {
@@ -355,33 +351,27 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
             })
             .epilog('example: `mintlify rename introduction.mdx overview.mdx`'),
         async ({ from, to, force }) => {
-          const hasMintJson = await checkForMintJson();
-          if (!hasMintJson) {
-            await checkForDocsJson();
-          }
+          await autoUpgradeIfNeeded();
           await renameFilesAndUpdateLinksInContent(from, to, force);
           await terminate(0);
         }
       )
       .command(
-        'update',
-        'update the CLI to the latest version',
+        'login',
+        false,
         () => undefined,
         async () => {
-          await update({ packageName });
+          await login();
           await terminate(0);
         }
       )
       .command(
-        'upgrade',
-        'upgrade mint.json file to docs.json (current format)',
+        'update',
+        'update the CLI to the latest version',
         () => undefined,
         async () => {
-          const hasMintJson = await checkForMintJson();
-          if (!hasMintJson) {
-            await checkForDocsJson();
-          }
-          await upgradeConfig();
+          await update({ packageName });
+          await terminate(0);
         }
       )
       .command(

package/src/constants.ts

@@ -7,3 +7,8 @@ export const CMD_EXEC_PATH = process.cwd();
 export const CONFIG_DIR = path.join(HOME_DIR, '.config', 'mintlify');
 export const CLI_CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
 export const TELEMETRY_ASYNC_TIMEOUT_MS = 10_000;
+
+export const DASHBOARD_URL = process.env.MINTLIFY_DASHBOARD_URL ?? 'http://localhost:3000';
+export const TOKEN_ENDPOINT =
+  'https://test.stytch.com/v1/public/project-test-2d86347b-dfdb-4609-be69-12d8146220bd/oauth2/token';
+export const STYTCH_CLIENT_ID = 'connected-app-test-b597afb3-304a-420f-bc13-dacca566c59f';

package/src/helpers.tsx

@@ -9,6 +9,7 @@ import {
   SpinnerLog,
   removeLastLog,
   LOCAL_LINKED_CLI_VERSION,
+  WarningLog,
 } from '@mintlify/previewing';
 import { upgradeToDocsConfig, validatePathWithinCwd } from '@mintlify/validation';
 import detect from 'detect-port';
@@ -94,6 +95,19 @@ export const checkForDocsJson = async () => {
   }
 };
 
+export const autoUpgradeIfNeeded = async () => {
+  const hasMintJson = await checkForMintJson();
+  if (!hasMintJson) return;
+
+  const docsJsonPath = path.join(CMD_EXEC_PATH, 'docs.json');
+  const hasDocsJson = await fse.pathExists(docsJsonPath);
+  if (!hasDocsJson) {
+    addLog(<WarningLog message="Legacy mint.json detected, auto-upgrading to docs.json" />);
+    addLog(<SpinnerLog message="upgrading mint.json to docs.json..." />);
+    await upgradeConfig();
+  }
+};
+
 export const upgradeConfig = async () => {
   try {
     const mintJsonPath = path.join(CMD_EXEC_PATH, 'mint.json');

package/src/login.tsx

@@ -0,0 +1,62 @@
+import { input } from '@inquirer/prompts';
+import { addLog } from '@mintlify/previewing';
+import { Text } from 'ink';
+import {
+  calculatePKCECodeChallenge,
+  randomNonce,
+  randomPKCECodeVerifier,
+  randomState,
+} from 'openid-client';
+
+import { DASHBOARD_URL, STYTCH_CLIENT_ID, TOKEN_ENDPOINT } from './constants.js';
+
+interface TokenResponse {
+  access_token: string;
+  id_token: string;
+  refresh_token: string;
+  token_type: 'bearer';
+  expires_in: number;
+  request_id: string;
+  status_code: number;
+}
+
+export async function login(): Promise<void> {
+  const codeVerifier = randomPKCECodeVerifier();
+  const codeChallenge = await calculatePKCECodeChallenge(codeVerifier);
+  const nonce = randomNonce();
+  const clientState = randomState();
+
+  const state = Buffer.from(JSON.stringify({ nonce, clientState })).toString('base64url');
+
+  const authorizeUrl = new URL('/api/cli/oauth/authorize', DASHBOARD_URL);
+  authorizeUrl.searchParams.set('state', state);
+  authorizeUrl.searchParams.set('code_challenge', codeChallenge);
+
+  addLog(<Text>Opening browser to log in to Mintlify... {authorizeUrl.toString()}</Text>);
+
+  const code = await input({ message: 'Paste the code from your browser:' });
+
+  const res = await fetch(TOKEN_ENDPOINT, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      client_id: STYTCH_CLIENT_ID,
+      grant_type: 'authorization_code',
+      code,
+      code_verifier: codeVerifier,
+      redirect_uri: `${DASHBOARD_URL}/api/cli/oauth/callback`,
+    }),
+  });
+
+  const body = await res.json().catch(() => ({}));
+
+  if (!res.ok) {
+    addLog(
+      <Text color="red">Login failed: {body.error_message ?? body.error ?? 'unknown error'}</Text>
+    );
+    return;
+  }
+
+  const token = body as TokenResponse;
+  addLog(<Text color="green">Logged in successfully.</Text>);
+}