@mintlify/cli 4.0.1094 → 4.0.1096

package/__test__/analytics/format.test.ts

@@ -93,9 +93,12 @@ describe('resolveFormat', () => {
   });
 
   it('returns specified format', () => {
+    const prev = process.env.CLAUDECODE;
+    delete process.env.CLAUDECODE;
     expect(resolveFormat({ format: 'plain' })).toBe('plain');
     expect(resolveFormat({ format: 'json' })).toBe('json');
     expect(resolveFormat({ format: 'graph' })).toBe('graph');
+    process.env.CLAUDECODE = prev;
   });
 
   it('defaults to plain', () => {

package/__test__/workflow.test.ts

@@ -29,6 +29,8 @@ vi.mock('fs-extra', () => ({
 
 vi.mock('../src/helpers.js', () => ({
   CMD_EXEC_PATH: '/fake/project',
+  isAI: () =>
+    !process.stdin.isTTY || process.env.CLAUDECODE === '1' || process.env.TERM_PROGRAM === 'claude',
 }));
 
 const addLogSpy = vi.mocked(previewing.addLog);

package/bin/helpers.js

@@ -174,6 +174,9 @@ export const terminate = (code) => __awaiter(void 0, void 0, void 0, function* (
     process.exit(code);
 });
 export const execAsync = promisify(exec);
+export function isAI() {
+    return (!process.stdin.isTTY || process.env.CLAUDECODE === '1' || process.env.TERM_PROGRAM === 'claude');
+}
 export const detectPackageManager = (_a) => __awaiter(void 0, [_a], void 0, function* ({ packageName }) {
     try {
         const { stdout: packagePath } = yield execAsync(`which ${packageName}`);

package/bin/init.js

@@ -14,6 +14,7 @@ import { docsConfigSchema, validatePathWithinCwd } from '@mintlify/validation';
 import AdmZip from 'adm-zip';
 import fse from 'fs-extra';
 import { Box, Text } from 'ink';
+import { isAI } from './helpers.js';
 const sendOnboardingMessage = (installDir) => {
     addLogs(_jsx(Text, { bold: true, children: "Documentation Setup!" }), _jsx(Text, { children: "To see your docs run" }), _jsxs(Box, { children: [_jsx(Text, { color: "blue", children: "cd" }), _jsxs(Text, { children: [" ", installDir] })] }), _jsx(Text, { color: "blue", children: "mint dev" }));
 };
@@ -24,9 +25,6 @@ export function init(installDir, force, theme, name) {
     return __awaiter(this, void 0, void 0, function* () {
         // Validate path is within current working directory to prevent path traversal
         validatePathWithinCwd(installDir);
-        const isInteractive = process.stdin.isTTY;
-        const isClaudeCode = process.env.CLAUDECODE === '1';
-        const isAI = !isInteractive || isClaudeCode;
         let selectedTheme = theme;
         let projectName = name;
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -35,15 +33,15 @@ export function init(installDir, force, theme, name) {
         });
         const dirContents = yield fse.readdir(installDir).catch(() => []);
         const contentsOccupied = dirContents.length > 0;
-        if ((!theme || !name) && isAI) {
+        if ((!theme || !name) && isAI()) {
             sendUsageMessageForAI(installDir, contentsOccupied, themes);
             return;
         }
-        if (contentsOccupied && isAI && !force) {
+        if (contentsOccupied && isAI() && !force) {
             sendUsageMessageForAI(installDir, contentsOccupied, themes);
             return;
         }
-        if (contentsOccupied && !isAI) {
+        if (contentsOccupied && !isAI()) {
             const choice = yield select({
                 message: `Directory ${installDir} is not empty. What would you like to do?`,
                 choices: [
@@ -68,7 +66,7 @@ export function init(installDir, force, theme, name) {
                 validatePathWithinCwd(installDir, process.cwd());
             }
         }
-        if (!isAI && (!selectedTheme || !projectName)) {
+        if (!isAI() && (!selectedTheme || !projectName)) {
             const defaultProject = projectName !== undefined ? projectName : installDir === '.' ? 'Mintlify' : installDir;
             if (!projectName) {
                 projectName = yield input({

package/bin/login.js

@@ -17,6 +17,7 @@ import { calculatePKCECodeChallenge, randomNonce, randomPKCECodeVerifier, random
 import { startCallbackServer } from './callbackServer.js';
 import { DASHBOARD_URL, STYTCH_CLIENT_ID, TOKEN_ENDPOINT } from './constants.js';
 import { storeCredentials } from './keyring.js';
+import { trackLoginAttempt, trackLoginFailed, trackLoginSuccess } from './telemetry/track.js';
 export function login() {
     return __awaiter(this, void 0, void 0, function* () {
         var _a, _b;
@@ -29,6 +30,7 @@ export function login() {
         authorizeUrl.searchParams.set('state', state);
         authorizeUrl.searchParams.set('code_challenge', codeChallenge);
         const url = authorizeUrl.toString();
+        void trackLoginAttempt();
         const { codePromise, close: closeServer } = yield startCallbackServer();
         addLog(_jsxs(Box, { flexDirection: "column", gap: 1, paddingY: 1, children: [_jsxs(Text, { bold: true, children: [_jsx(Text, { color: "green", children: "\u25C6 " }), "A browser window will open for Mintlify authentication"] }), _jsxs(Box, { flexDirection: "column", paddingLeft: 3, gap: 1, children: [_jsx(Text, { dimColor: true, children: "If your browser doesn't open automatically, copy this URL:" }), _jsx(Text, { color: "cyan", children: url })] })] }));
         open(url).catch(() => { });
@@ -69,11 +71,14 @@ export function login() {
         });
         const body = yield res.json().catch(() => ({}));
         if (!res.ok) {
-            addLog(_jsxs(Text, { color: "red", children: ["\u2716 Login failed: ", (_b = (_a = body.error_message) !== null && _a !== void 0 ? _a : body.error) !== null && _b !== void 0 ? _b : 'unknown error'] }));
+            const reason = (_b = (_a = body.error_message) !== null && _a !== void 0 ? _a : body.error) !== null && _b !== void 0 ? _b : 'unknown error';
+            void trackLoginFailed(reason);
+            addLog(_jsxs(Text, { color: "red", children: ["\u2716 Login failed: ", reason] }));
             return;
         }
         const token = body;
         yield storeCredentials(token.access_token, token.refresh_token);
+        void trackLoginSuccess();
         addLog(_jsx(Text, { color: "green", children: "\u2714 Logged in successfully." }));
     });
 }

package/bin/telemetry/middleware.js

@@ -7,6 +7,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+import { getConfigValue } from '../config.js';
 import { getVersions } from '../helpers.js';
 import { trackCommand } from './track.js';
 const SCRAPE_SUBCOMMANDS = new Set(['page', 'site', 'openapi']);
@@ -32,7 +33,8 @@ export function createTelemetryMiddleware() {
                 tracked = true;
                 const sanitizedCommand = getSanitizedCommandForTelemetry(argv._);
                 const { cli: cliVersion } = getVersions();
-                void trackCommand({ command: sanitizedCommand, cliVersion });
+                const subdomain = getConfigValue('subdomain');
+                void trackCommand({ command: sanitizedCommand, cliVersion, subdomain });
             }
         });
     };

package/bin/telemetry/track.js

@@ -10,7 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import os from 'os';
 import { isTelemetryEnabled } from '../config.js';
 import { TELEMETRY_ASYNC_TIMEOUT_MS } from '../constants.js';
-import { getVersions } from '../helpers.js';
+import { getVersions, isAI } from '../helpers.js';
 import { getPostHogClient } from './client.js';
 import { getDistinctId } from './distinctId.js';
 function captureWithTimeout(event, properties) {
@@ -31,7 +31,7 @@ function captureWithTimeout(event, properties) {
     });
 }
 export function trackCommand(_a) {
-    return __awaiter(this, arguments, void 0, function* ({ command, cliVersion }) {
+    return __awaiter(this, arguments, void 0, function* ({ command, cliVersion, subdomain, }) {
         if (!isTelemetryEnabled())
             return;
         try {
@@ -41,11 +41,39 @@ export function trackCommand(_a) {
                 os: os.platform(),
                 arch: os.arch(),
                 node_version: process.version,
+                is_ai_agent: isAI(),
+                subdomain,
             });
         }
         catch (_b) { }
     });
 }
+function trackLoginEvent(event, extra) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!isTelemetryEnabled())
+            return;
+        try {
+            const { cli: cliVersion } = getVersions();
+            yield captureWithTimeout(event, Object.assign(Object.assign({}, extra), { cli_version: cliVersion, os: os.platform(), arch: os.arch(), node_version: process.version }));
+        }
+        catch (_a) { }
+    });
+}
+export function trackLoginAttempt() {
+    return __awaiter(this, void 0, void 0, function* () {
+        return trackLoginEvent('cli.login.attempted');
+    });
+}
+export function trackLoginSuccess() {
+    return __awaiter(this, void 0, void 0, function* () {
+        return trackLoginEvent('cli.login.succeeded');
+    });
+}
+export function trackLoginFailed(reason) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return trackLoginEvent('cli.login.failed', { reason });
+    });
+}
 export function trackTelemetryPreferenceChange(options) {
     return __awaiter(this, void 0, void 0, function* () {
         if (process.env.CLI_TEST_MODE === 'true')