@mintlify/cli 4.0.1617 → 4.0.1618

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.1617",
+  "version": "4.0.1618",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -105,5 +105,5 @@
     "vitest": "2.1.9",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "688752e942ccb49213dddf7fa163b025016a48eb"
+  "gitHead": "4beaa4d9a8f9f1841a3990ea46bd28961a1e5597"
 }

package/src/telemetry/distinctId.ts

@@ -32,6 +32,13 @@ function tryPersistId(id: string): void {
   fs.writeFileSync(ID_FILE, id, { flag: 'wx' });
 }
 
+let createdThisRun = false;
+
+export function isFirstRun(): boolean {
+  getDistinctId();
+  return createdThisRun;
+}
+
 export function getDistinctId(): string {
   const existing = readValidIdFromFile();
   if (existing) return existing;
@@ -40,6 +47,7 @@ export function getDistinctId(): string {
 
   try {
     tryPersistId(randomId);
+    createdThisRun = true;
     return readValidIdFromFile() ?? randomId;
   } catch (err) {
     const code = (err as NodeJS.ErrnoException).code;

package/src/telemetry/track.ts

@@ -7,7 +7,7 @@ import { getVersions } from '../helpers.js';
 import { getAccessToken, getUserEmail, storeUserEmail } from '../keyring.js';
 import { fetchCliStatus } from '../status.js';
 import { deferShutdownUntil, getPostHogClient } from './client.js';
-import { getDistinctId } from './distinctId.js';
+import { getDistinctId, isFirstRun } from './distinctId.js';
 
 export interface TrackCommandOptions {
   command: string;
@@ -25,6 +25,7 @@ function getEnvironmentProperties(): Record<string, unknown> {
     ai_agent: agent,
     is_ci: isCI(),
     is_tty: Boolean(process.stdin.isTTY),
+    is_first_run: isFirstRun(),
   };
 }
 
@@ -47,20 +48,23 @@ async function captureWithTimeout(
   ]);
 }
 
-async function getAuthenticatedUserEmail(): Promise<string | null> {
+async function getIdentity(): Promise<{ loggedIn: boolean; email: string | null }> {
   try {
-    const [accessToken, storedEmail] = await Promise.all([getAccessToken(), getUserEmail()]);
-    if (!accessToken) return null;
-    if (storedEmail) return storedEmail;
+    const [accessToken, storedEmail] = await Promise.all([
+      getAccessToken(),
+      getUserEmail().catch(() => null),
+    ]);
+    if (!accessToken) return { loggedIn: false, email: null };
+    if (storedEmail) return { loggedIn: true, email: storedEmail };
 
     const status = await fetchCliStatus(AbortSignal.timeout(TELEMETRY_IDENTITY_TIMEOUT_MS));
-    if (!status.ok) return null;
+    if (!status.ok) return { loggedIn: true, email: null };
 
     const email = status.status.user.email;
     await storeUserEmail(email).catch(() => {});
-    return email;
+    return { loggedIn: true, email };
   } catch {
-    return null;
+    return { loggedIn: false, email: null };
   }
 }
 
@@ -73,11 +77,12 @@ export async function trackCommand({
 
   const work = (async () => {
     try {
-      const email = await getAuthenticatedUserEmail();
+      const { loggedIn, email } = await getIdentity();
       await captureWithTimeout('cli.command.executed', {
         command,
         cli_version: cliVersion,
         ...getEnvironmentProperties(),
+        is_logged_in: loggedIn,
         subdomain,
         ...(email ? { email, $set: { email } } : {}),
       });