@mintlify/cli 4.0.1307 → 4.0.1309

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.1307",
+  "version": "4.0.1309",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -45,11 +45,11 @@
   },
   "dependencies": {
     "@inquirer/prompts": "7.9.0",
-    "@mintlify/common": "1.0.1018",
-    "@mintlify/link-rot": "3.0.1210",
+    "@mintlify/common": "1.0.1019",
+    "@mintlify/link-rot": "3.0.1211",
     "@mintlify/models": "0.0.339",
-    "@mintlify/prebuild": "1.0.1166",
-    "@mintlify/previewing": "4.0.1235",
+    "@mintlify/prebuild": "1.0.1167",
+    "@mintlify/previewing": "4.0.1236",
     "@mintlify/validation": "0.1.788",
     "adm-zip": "0.5.16",
     "chalk": "5.2.0",
@@ -92,5 +92,5 @@
     "vitest": "2.1.9",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "35bad1c04f17f7bc1fe6e5a722aa9b98ca51b0bf"
+  "gitHead": "534ee2066c98331ba570f3e7829764af3f58c0ec"
 }

package/src/cli.tsx

@@ -41,6 +41,7 @@ import { mdxLinter } from './mdxLinter.js';
 import { createTelemetryMiddleware } from './middlewares/telemetryMiddleware.js';
 import { checkOpenApiFile, getOpenApiFilenamesFromDocsConfig } from './openApiCheck.js';
 import { scoreHandler } from './score/index.js';
+import { signup } from './signup.js';
 import { status, getCliSubdomains } from './status.js';
 import { trackTelemetryPreferenceChange } from './telemetry/track.js';
 import { update } from './update.js';
@@ -417,6 +418,15 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
           await terminate(0);
         }
       )
+      .command(
+        'signup',
+        'Create a new Mintlify account',
+        () => undefined,
+        async () => {
+          await signup();
+          await terminate(0);
+        }
+      )
       .command('config', 'Manage CLI configuration', (yargs) =>
         yargs
           .command(
@@ -649,12 +659,6 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
         () => undefined,
         comingSoon('test', packageName)
       )
-      .command(
-        'signup',
-        '[Coming soon] Sign up for a Mintlify account (run mint signup to vote)',
-        () => undefined,
-        comingSoon('signup', packageName)
-      )
       .command(
         'mcp',
         '[Coming soon] MCP server for documentation (run mint mcp to vote)',

package/src/login.tsx

@@ -17,7 +17,7 @@ import { storeCredentials } from './keyring.js';
 import { getCliSubdomains } from './status.js';
 import { trackLoginAttempt, trackLoginFailed, trackLoginSuccess } from './telemetry/track.js';
 
-interface TokenResponse {
+export interface TokenResponse {
   access_token: string;
   id_token: string;
   refresh_token: string;

package/src/signup.tsx

@@ -0,0 +1,92 @@
+import { input } from '@inquirer/prompts';
+import { addLog, ErrorLog, SuccessLog } from '@mintlify/previewing';
+import { Box, Text } from 'ink';
+import {
+  calculatePKCECodeChallenge,
+  randomNonce,
+  randomPKCECodeVerifier,
+  randomState,
+} from 'openid-client';
+
+import { startCallbackServer } from './callbackServer.js';
+import { API_URL, DASHBOARD_URL, STYTCH_CLIENT_ID, TOKEN_ENDPOINT } from './constants.js';
+import { storeCredentials } from './keyring.js';
+import type { TokenResponse } from './login.js';
+
+export async function signup(): Promise<void> {
+  const firstName = await input({ message: 'First name' });
+  const lastName = await input({ message: 'Last name' });
+  const company = await input({ message: 'Company name' });
+  const email = await input({ message: 'Email' });
+
+  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 { codePromise, close: closeServer } = await startCallbackServer();
+  codePromise.catch(() => {});
+
+  try {
+    const res = await fetch(`${API_URL}/api/cli-onboarding/signup`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ firstName, lastName, company, email, state, codeChallenge }),
+    });
+
+    if (!res.ok) {
+      const body = await res.json().catch(() => ({}));
+      closeServer();
+      addLog(<ErrorLog message={`signup failed: ${body.error ?? 'unknown error'}`} />);
+      return;
+    }
+  } catch {
+    closeServer();
+    addLog(<ErrorLog message="signup failed: could not reach the server" />);
+    return;
+  }
+
+  addLog(
+    <Box flexDirection="column" gap={1} paddingY={1}>
+      <Text bold>
+        <Text color="green">◆ </Text>Check your email to verify your account
+      </Text>
+      <Box flexDirection="column" paddingLeft={3} gap={1}>
+        <Text dimColor>We sent a verification link to {email}. Click it to continue.</Text>
+      </Box>
+    </Box>
+  );
+
+  let code: string;
+  try {
+    code = await codePromise;
+  } catch {
+    addLog(<ErrorLog message="signup cancelled" />);
+    return;
+  }
+
+  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) {
+    const reason = body.error_message ?? body.error ?? 'unknown error';
+    addLog(<ErrorLog message={`signup failed: ${reason}`} />);
+    return;
+  }
+
+  const token = body as TokenResponse;
+  await storeCredentials(token.access_token, token.refresh_token);
+  addLog(<SuccessLog message="account created and logged in successfully" />);
+}