@mintlify/cli 4.0.1791 → 4.0.1792

package/__test__/deploy.test.ts

@@ -66,6 +66,10 @@ describe('mint deploy', () => {
     expect(vi.mocked(trackEvent).mock.calls).toEqual([
       ['agent_signup.discovered', { registration_id: 'reg_1' }],
       ['agent_signup.registered', { registration_id: 'reg_1' }],
+      [
+        'cli.deploy.provisioned',
+        { registration_id: 'reg_1', deployment_id: 'id', subdomain: 'allocated', created: true },
+      ],
     ]);
   });
   it('tracks only discovery for a saved registration', async () => {
@@ -73,8 +77,22 @@ describe('mint deploy', () => {
     await prepareAgentDeployment(options, warn);
     expect(vi.mocked(trackEvent).mock.calls).toEqual([
       ['agent_signup.discovered', { registration_id: 'reg_1' }],
+      [
+        'cli.deploy.provisioned',
+        { registration_id: 'reg_1', deployment_id: 'id', subdomain: 'allocated', created: true },
+      ],
     ]);
   });
+  it('tracks a provisioned site when write access fails', async () => {
+    vi.mocked(deployment.getAgentWriteToken).mockRejectedValue(new Error('timeout'));
+    await expect(prepareAgentDeployment(options, warn)).rejects.toThrow('timeout');
+    expect(vi.mocked(trackEvent)).toHaveBeenCalledWith('cli.deploy.provisioned', {
+      registration_id: 'reg_1',
+      deployment_id: 'id',
+      subdomain: 'allocated',
+      created: true,
+    });
+  });
   it.each([
     ['https://leaves.mintlify.com', 'https://allocated.mintlify.site/'],
     ['https://leaves-dev.mintlify.com', 'https://allocated.mint-dev.mintlify.me/'],

package/__test__/sessionId.test.ts

@@ -0,0 +1,46 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'mint-session-'));
+vi.mock('../src/constants.js', () => ({ CONFIG_DIR: dir }));
+
+const file = path.join(dir, 'telemetry-session.json');
+const now = Date.parse('2026-11-02T12:00:00.000Z');
+const minutes = (n: number) => n * 60 * 1000;
+const load = async () => (await import('../src/telemetry/sessionId.js')).getSessionId;
+const save = (lastSeenAt: number) =>
+  fs.writeFileSync(file, JSON.stringify({ id: 'saved', lastSeenAt }));
+
+beforeEach(() => {
+  vi.resetModules();
+  fs.rmSync(file, { force: true });
+});
+
+describe('getSessionId', () => {
+  it('starts a UUIDv7 session and saves it', async () => {
+    const id = (await load())(now);
+    expect(id).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/);
+    expect(parseInt(id.replace(/-/g, '').slice(0, 12), 16)).toBe(now);
+    expect(JSON.parse(fs.readFileSync(file, 'utf-8'))).toEqual({ id, lastSeenAt: now });
+  });
+
+  it('resumes a session active in the last 30 minutes', async () => {
+    save(now - minutes(29));
+    expect((await load())(now)).toBe('saved');
+    expect(JSON.parse(fs.readFileSync(file, 'utf-8')).lastSeenAt).toBe(now);
+  });
+
+  it('rotates after 30 minutes idle', async () => {
+    save(now - minutes(31));
+    expect((await load())(now)).not.toBe('saved');
+  });
+
+  it('keeps one id per process and refreshes activity', async () => {
+    const getSessionId = await load();
+    const id = getSessionId(now);
+    expect(getSessionId(now + minutes(60))).toBe(id);
+    expect(JSON.parse(fs.readFileSync(file, 'utf-8')).lastSeenAt).toBe(now + minutes(60));
+  });
+});

package/bin/cli.js

@@ -42,7 +42,7 @@ import { buildOverlayRegistryForCheck, checkOpenApiFile } from './openApiCheck.j
 import { scoreHandler } from './score/index.js';
 import { signup } from './signup.js';
 import { status, getCliSubdomains } from './status.js';
-import { trackTelemetryPreferenceChange } from './telemetry/track.js';
+import { trackEvent, trackTelemetryPreferenceChange } from './telemetry/track.js';
 import { update } from './update.js';
 import { splitList, validateHandler } from './validate/command.js';
 import { RULES } from './validate/rules/index.js';
@@ -737,6 +737,11 @@ export const cli = ({ packageName = 'mint' }) => {
     }), (argv) => __awaiter(void 0, void 0, void 0, function* () {
         var _a;
         const agent = (_a = argv.agent) !== null && _a !== void 0 ? _a : (argv.claude ? 'claude' : undefined);
+        void trackEvent('cli.migrate.executed', {
+            from: argv.from,
+            topic: argv.topic,
+            agent,
+        });
         if (agent) {
             try {
                 return yield terminate(yield migrateWithAgent(agent, argv.from));

package/bin/deploy.js

@@ -57,6 +57,12 @@ export function prepareAgentDeployment(options_1, warn_1) {
                 saved = null;
                 continue;
             }
+            void trackEvent('cli.deploy.provisioned', {
+                registration_id: credentials.registrationId,
+                deployment_id: site.deploymentId,
+                subdomain: site.subdomain,
+                created: site.created,
+            });
             yield setAgentSiteMetadata(metadataKey, {
                 registrationId: credentials.registrationId,
                 subdomain: site.subdomain,

package/bin/telemetry/sessionId.js

@@ -0,0 +1,36 @@
+import crypto from 'crypto';
+import fs from 'fs';
+import path from 'path';
+import { CONFIG_DIR } from '../constants.js';
+const SESSION_FILE = path.join(CONFIG_DIR, 'telemetry-session.json');
+const SESSION_IDLE_MS = 30 * 60 * 1000;
+let current;
+function uuidv7(now) {
+    const bytes = crypto.randomBytes(16);
+    bytes.writeUIntBE(now, 0, 6);
+    bytes[6] = (bytes[6] & 0x0f) | 0x70;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = bytes.toString('hex');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+function readSession() {
+    try {
+        const { id, lastSeenAt } = JSON.parse(fs.readFileSync(SESSION_FILE, 'utf-8'));
+        return typeof id === 'string' && typeof lastSeenAt === 'number' ? { id, lastSeenAt } : null;
+    }
+    catch (_a) {
+        return null;
+    }
+}
+export function getSessionId(now = Date.now()) {
+    if (!current) {
+        const saved = readSession();
+        current = saved && now - saved.lastSeenAt < SESSION_IDLE_MS ? saved.id : uuidv7(now);
+    }
+    try {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+        fs.writeFileSync(SESSION_FILE, JSON.stringify({ id: current, lastSeenAt: now }));
+    }
+    catch (_a) { }
+    return current;
+}

package/bin/telemetry/track.js

@@ -16,6 +16,7 @@ import { getAccessToken, getUserEmail, storeUserEmail } from '../keyring.js';
 import { fetchCliStatus } from '../status.js';
 import { deferShutdownUntil, getPostHogClient } from './client.js';
 import { getDistinctId, isFirstRun } from './distinctId.js';
+import { getSessionId } from './sessionId.js';
 function getEnvironmentProperties() {
     const agent = detectAgent();
     return {
@@ -27,6 +28,7 @@ function getEnvironmentProperties() {
         is_ci: isCI(),
         is_tty: Boolean(process.stdin.isTTY),
         is_first_run: isFirstRun(),
+        $session_id: getSessionId(),
     };
 }
 function captureWithTimeout(event, properties) {
@@ -69,14 +71,19 @@ function getIdentity() {
         }
     });
 }
+function getIdentityProperties() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { loggedIn, email } = yield getIdentity();
+        return Object.assign({ is_logged_in: loggedIn }, (email ? { email, $set: { email } } : {}));
+    });
+}
 export function trackCommand(_a) {
     return __awaiter(this, arguments, void 0, function* ({ command, cliVersion, subdomain, }) {
         if (!isTelemetryEnabled())
             return;
         const work = (() => __awaiter(this, void 0, void 0, function* () {
             try {
-                const { loggedIn, email } = yield getIdentity();
-                yield captureWithTimeout('cli.command.executed', Object.assign(Object.assign(Object.assign({ command, cli_version: cliVersion }, getEnvironmentProperties()), { is_logged_in: loggedIn, subdomain }), (email ? { email, $set: { email } } : {})));
+                yield captureWithTimeout('cli.command.executed', Object.assign(Object.assign(Object.assign({ command, cli_version: cliVersion }, getEnvironmentProperties()), (yield getIdentityProperties())), { subdomain }));
             }
             catch (_a) { }
         }))();
@@ -88,11 +95,15 @@ 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(Object.assign({}, extra), { cli_version: cliVersion }), getEnvironmentProperties()));
-        }
-        catch (_a) { }
+        const work = (() => __awaiter(this, void 0, void 0, function* () {
+            try {
+                const { cli: cliVersion } = getVersions();
+                yield captureWithTimeout(event, Object.assign(Object.assign(Object.assign(Object.assign({}, extra), { cli_version: cliVersion }), getEnvironmentProperties()), (yield getIdentityProperties())));
+            }
+            catch (_a) { }
+        }))();
+        deferShutdownUntil(work);
+        yield work;
     });
 }
 export function trackLoginAttempt() {
@@ -117,7 +128,7 @@ export function trackEvent(event, properties) {
         const work = (() => __awaiter(this, void 0, void 0, function* () {
             try {
                 const { cli: cliVersion } = getVersions();
-                yield captureWithTimeout(event, Object.assign(Object.assign(Object.assign({}, properties), { cli_version: cliVersion }), getEnvironmentProperties()));
+                yield captureWithTimeout(event, Object.assign(Object.assign(Object.assign(Object.assign({}, properties), { cli_version: cliVersion }), getEnvironmentProperties()), (yield getIdentityProperties())));
             }
             catch (_a) { }
         }))();