@mintlify/cli 4.0.1228 → 4.0.1230

package/bin/welcome.js

@@ -23,10 +23,7 @@ const GROUPS = [
     },
     {
         title: 'Insights',
-        commands: [
-            { name: 'analytics', description: 'View analytics for your site' },
-            { name: 'workflow', description: 'Create and manage workflows' },
-        ],
+        commands: [{ name: 'workflow', description: 'Create and manage workflows' }],
     },
     {
         title: 'Account',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.1228",
+  "version": "4.0.1230",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -45,12 +45,12 @@
   },
   "dependencies": {
     "@inquirer/prompts": "7.9.0",
-    "@mintlify/common": "1.0.948",
-    "@mintlify/link-rot": "3.0.1133",
-    "@mintlify/models": "0.0.323",
-    "@mintlify/prebuild": "1.0.1094",
-    "@mintlify/previewing": "4.0.1158",
-    "@mintlify/validation": "0.1.741",
+    "@mintlify/common": "1.0.949",
+    "@mintlify/link-rot": "3.0.1134",
+    "@mintlify/models": "0.0.324",
+    "@mintlify/prebuild": "1.0.1095",
+    "@mintlify/previewing": "4.0.1159",
+    "@mintlify/validation": "0.1.742",
     "adm-zip": "0.5.16",
     "chalk": "5.2.0",
     "color": "4.2.3",
@@ -95,5 +95,5 @@
     "vitest": "2.1.9",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "dc40bdef59f86aff25d06e92038b053cbef1390e"
+  "gitHead": "17167bf8f0a141fee9164c38384bf1724e31390c"
 }

package/src/cli.tsx

@@ -19,7 +19,6 @@ import yargs, { type Argv } from 'yargs';
 import { hideBin } from 'yargs/helpers';
 
 import { accessibilityCheck } from './accessibilityCheck.js';
-import { analyticsBuilder } from './analytics/index.js';
 import { comingSoon } from './comingSoon.js';
 import { setTelemetryEnabled } from './config.js';
 import { getConfigValue, setConfigValue, clearConfigValue } from './config.js';
@@ -614,7 +613,6 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
           }
         }
       )
-      .command('analytics', 'View analytics for your documentation', analyticsBuilder)
       .command('workflow', 'Create and manage workflows', workflowsBuilder)
       .command(
         'score [url]',

package/src/middlewares/telemetryMiddleware.ts

@@ -3,17 +3,13 @@ import { getVersions } from '../helpers.js';
 import { trackCommand } from '../telemetry/track.js';
 
 const SCRAPE_SUBCOMMANDS = new Set(['page', 'site', 'openapi']);
-const ANALYTICS_SUBCOMMANDS = new Set(['stats', 'search', 'feedback', 'conversation']);
 const CONFIG_SUBCOMMANDS = new Set(['set', 'get', 'clear']);
-const CONVERSATION_SUBCOMMANDS = new Set(['list', 'view', 'buckets']);
-const BUCKETS_SUBCOMMANDS = new Set(['list', 'view']);
 
 export function getSanitizedCommandForTelemetry(_: (string | number)[]): string {
   const parts = _.filter((p): p is string => typeof p === 'string');
   if (parts.length === 0) return '';
   const first = parts[0]!;
   const second = parts[1];
-  const third = parts[2];
 
   if (first === 'scrape' && second !== undefined && SCRAPE_SUBCOMMANDS.has(second)) {
     return `scrape ${second}`;
@@ -23,19 +19,6 @@ export function getSanitizedCommandForTelemetry(_: (string | number)[]): string
     return `config ${second}`;
   }
 
-  if (first === 'analytics' && second !== undefined && ANALYTICS_SUBCOMMANDS.has(second)) {
-    if (second === 'conversation' && third !== undefined) {
-      if (CONVERSATION_SUBCOMMANDS.has(third)) {
-        const fourth = parts[3];
-        if (third === 'buckets' && fourth !== undefined && BUCKETS_SUBCOMMANDS.has(fourth)) {
-          return `analytics conversation buckets ${fourth}`;
-        }
-        return `analytics conversation ${third}`;
-      }
-    }
-    return `analytics ${second}`;
-  }
-
   return first;
 }
 

package/src/welcome.ts

@@ -36,10 +36,7 @@ const GROUPS: CommandGroup[] = [
   },
   {
     title: 'Insights',
-    commands: [
-      { name: 'analytics', description: 'View analytics for your site' },
-      { name: 'workflow', description: 'Create and manage workflows' },
-    ],
+    commands: [{ name: 'workflow', description: 'Create and manage workflows' }],
   },
   {
     title: 'Account',

package/__test__/analytics/client.test.ts

@@ -1,166 +0,0 @@
-import {
-  getFeedback,
-  getFeedbackByPage,
-  getBuckets,
-  getBucketThreads,
-  getConversations,
-  getKpi,
-  getSearches,
-  getViews,
-  getVisitors,
-} from '../../src/analytics/client.js';
-
-vi.mock('../../src/keyring.js', () => ({
-  getAccessToken: vi.fn().mockResolvedValue(null),
-  getRefreshToken: vi.fn().mockResolvedValue(null),
-  storeCredentials: vi.fn().mockResolvedValue(undefined),
-}));
-
-const mockFetch = vi.fn();
-global.fetch = mockFetch;
-
-beforeEach(() => {
-  vi.stubEnv('MINTLIFY_SESSION_TOKEN', 'test-token');
-  vi.stubEnv('MINTLIFY_API_URL', 'http://test-server:5000');
-  mockFetch.mockReset();
-});
-
-afterEach(() => {
-  vi.unstubAllEnvs();
-});
-
-function mockOk(data: unknown) {
-  mockFetch.mockResolvedValueOnce({
-    ok: true,
-    status: 200,
-    json: () => Promise.resolve(data),
-  });
-}
-
-function mockError(status: number, body: string) {
-  mockFetch.mockResolvedValueOnce({
-    ok: false,
-    status,
-    statusText: 'Bad Request',
-    text: () => Promise.resolve(body),
-  });
-}
-
-function calledUrl(): string {
-  const arg = mockFetch.mock.calls[0]![0];
-  return typeof arg === 'string' ? arg : String(arg);
-}
-
-function calledUrlObj(): URL {
-  return new URL(calledUrl());
-}
-
-describe('client auth', () => {
-  it('throws when no session token is set', async () => {
-    vi.stubEnv('MINTLIFY_SESSION_TOKEN', '');
-    await expect(getFeedback({ dateFrom: '2024-01-01', dateTo: '2024-01-31' })).rejects.toThrow(
-      'Not authenticated'
-    );
-  });
-
-  it('sends session cookie header', async () => {
-    mockOk({ feedback: [], nextCursor: null, hasMore: false });
-    await getFeedback({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'test');
-    expect(mockFetch).toHaveBeenCalledWith(
-      expect.any(String),
-      expect.objectContaining({
-        headers: expect.objectContaining({
-          Authorization: 'Bearer test-token',
-        }),
-      })
-    );
-  });
-});
-
-describe('client request handling', () => {
-  it('throws on API error', async () => {
-    mockError(400, 'Invalid params');
-    await expect(getFeedback({ dateFrom: '2024-01-01', dateTo: '2024-01-31' })).rejects.toThrow(
-      'API error (400): Invalid params'
-    );
-  });
-
-  it('passes subdomain as query param when provided', async () => {
-    mockOk({ feedback: [], nextCursor: null, hasMore: false });
-    await getFeedback({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'my-docs');
-    expect(calledUrlObj().searchParams.get('subdomain')).toBe('my-docs');
-    expect(calledUrlObj().pathname).toBe('/api/cli/analytics/feedback');
-  });
-
-  it('omits subdomain param when not provided', async () => {
-    mockOk({ feedback: [], nextCursor: null, hasMore: false });
-    await getFeedback({ dateFrom: '2024-01-01', dateTo: '2024-01-31' });
-    expect(calledUrlObj().searchParams.has('subdomain')).toBe(false);
-  });
-
-  it('sets query params and omits undefined values', async () => {
-    mockOk({ feedback: [], nextCursor: null, hasMore: false });
-    await getFeedback({
-      dateFrom: '2024-01-01',
-      dateTo: '2024-01-31',
-      limit: 10,
-      cursor: undefined,
-    });
-    expect(calledUrlObj().searchParams.get('dateFrom')).toBe('2024-01-01');
-    expect(calledUrlObj().searchParams.get('limit')).toBe('10');
-    expect(calledUrlObj().searchParams.has('cursor')).toBe(false);
-  });
-});
-
-describe('endpoint paths', () => {
-  it('getKpi', async () => {
-    mockOk({ humanVisitors: 0 });
-    await getKpi({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'docs');
-    expect(calledUrlObj().pathname).toBe('/api/cli/analytics/kpi');
-    expect(calledUrlObj().searchParams.get('subdomain')).toBe('docs');
-  });
-
-  it('getFeedbackByPage', async () => {
-    mockOk({ feedback: [], hasMore: false });
-    await getFeedbackByPage({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'docs');
-    expect(calledUrlObj().pathname).toBe('/api/cli/analytics/feedback/by-page');
-  });
-
-  it('getConversations', async () => {
-    mockOk({ conversations: [], nextCursor: null, hasMore: false });
-    await getConversations({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'docs');
-    expect(calledUrlObj().pathname).toBe('/api/cli/analytics/assistant');
-  });
-
-  it('getSearches', async () => {
-    mockOk({ searches: [], totalSearches: 0, nextCursor: null });
-    await getSearches({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'docs');
-    expect(calledUrlObj().pathname).toBe('/api/cli/analytics/searches');
-  });
-
-  it('getViews', async () => {
-    mockOk({ totals: {}, views: [], hasMore: false });
-    await getViews({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'docs');
-    expect(calledUrlObj().pathname).toBe('/api/cli/analytics/views');
-  });
-
-  it('getVisitors', async () => {
-    mockOk({ totals: {}, visitors: [], hasMore: false });
-    await getVisitors({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'docs');
-    expect(calledUrlObj().pathname).toBe('/api/cli/analytics/visitors');
-  });
-
-  it('getBuckets', async () => {
-    mockOk({ data: [], pagination: { total: 0 } });
-    await getBuckets({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'docs');
-    expect(calledUrlObj().pathname).toBe('/api/cli/analytics/conversations/buckets');
-    expect(calledUrlObj().searchParams.get('subdomain')).toBe('docs');
-  });
-
-  it('getBucketThreads', async () => {
-    mockOk({ data: [], pagination: { total: 0, hasMore: false, nextCursor: null } });
-    await getBucketThreads('bucket-123', { dateFrom: '2024-01-01' }, 'docs');
-    expect(calledUrlObj().pathname).toBe('/api/cli/analytics/conversations/buckets/bucket-123');
-    expect(calledUrlObj().searchParams.get('subdomain')).toBe('docs');
-  });
-});

package/__test__/analytics/format.test.ts

@@ -1,137 +0,0 @@
-import { num, pct, truncate } from '../../src/analytics/format.js';
-import {
-  formatBarChart,
-  formatPlainTable,
-  formatPrettyTable,
-  resolveFormat,
-} from '../../src/analytics/output.js';
-import * as helpers from '../../src/helpers.js';
-
-afterEach(() => {
-  vi.restoreAllMocks();
-});
-
-describe('num', () => {
-  it('formats numbers with locale separators', () => {
-    expect(num(0)).toBe('0');
-    expect(num(1234)).toBe('1,234');
-    expect(num(1000000)).toBe('1,000,000');
-  });
-});
-
-describe('pct', () => {
-  it('returns percentage string', () => {
-    expect(pct(1, 4)).toBe('25.0%');
-    expect(pct(1, 3)).toBe('33.3%');
-  });
-
-  it('returns dash when total is zero', () => {
-    expect(pct(0, 0)).toBe('\u2014');
-  });
-});
-
-describe('truncate', () => {
-  it('returns short strings unchanged', () => {
-    expect(truncate('hello', 10)).toBe('hello');
-  });
-
-  it('truncates long strings with ellipsis', () => {
-    expect(truncate('hello world', 6)).toBe('hello\u2026');
-  });
-
-  it('returns string unchanged when exactly at max', () => {
-    expect(truncate('hello', 5)).toBe('hello');
-  });
-});
-
-describe('formatPrettyTable', () => {
-  it('returns dim message for empty rows', () => {
-    const result = formatPrettyTable(['A', 'B'], []);
-    expect(result).toContain('No data found');
-  });
-
-  it('formats headers and rows with aligned columns', () => {
-    const result = formatPrettyTable(
-      ['Name', 'Count'],
-      [
-        ['foo', '10'],
-        ['barbaz', '5'],
-      ]
-    );
-    const lines = result.split('\n');
-    expect(lines).toHaveLength(4);
-    expect(lines[2]).toContain('foo');
-    expect(lines[3]).toContain('barbaz');
-  });
-});
-
-describe('formatPlainTable', () => {
-  it('returns empty string for empty rows', () => {
-    expect(formatPlainTable(['A', 'B'], [])).toBe('');
-  });
-
-  it('formats with tab separation and uppercase headers', () => {
-    const result = formatPlainTable(
-      ['Name', 'Count'],
-      [
-        ['foo', '10'],
-        ['bar', '5'],
-      ]
-    );
-    const lines = result.split('\n');
-    expect(lines[0]).toContain('NAME');
-    expect(lines[0]).toContain('\t');
-    expect(lines[1]).toContain('foo');
-  });
-});
-
-describe('resolveFormat', () => {
-  it('returns json when AI mode is active', () => {
-    vi.spyOn(helpers, 'isAI').mockReturnValue(true);
-    expect(resolveFormat({})).toBe('json');
-  });
-
-  it('returns specified format', () => {
-    vi.spyOn(helpers, 'isAI').mockReturnValue(true);
-    expect(resolveFormat({ format: 'plain' })).toBe('plain');
-    expect(resolveFormat({ format: 'json' })).toBe('json');
-    expect(resolveFormat({ format: 'graph' })).toBe('graph');
-  });
-
-  it('defaults to plain', () => {
-    vi.spyOn(helpers, 'isAI').mockReturnValue(false);
-    expect(resolveFormat({})).toBe('plain');
-  });
-});
-
-describe('formatBarChart', () => {
-  it('returns dim message for empty items', () => {
-    expect(formatBarChart([])).toContain('No data found');
-  });
-
-  it('renders bars with labels and values', () => {
-    const result = formatBarChart([
-      { label: 'Foo', value: 10 },
-      { label: 'Bar', value: 5 },
-    ]);
-    const lines = result.split('\n');
-    expect(lines).toHaveLength(2);
-    expect(lines[0]).toContain('Foo');
-    expect(lines[0]).toContain('10');
-    expect(lines[0]).toContain('\u2588');
-    expect(lines[1]).toContain('Bar');
-    expect(lines[1]).toContain('5');
-  });
-
-  it('scales bars relative to max value', () => {
-    const result = formatBarChart([
-      { label: 'Big', value: 100 },
-      { label: 'Small', value: 10 },
-    ]);
-    const bigBar = result.split('\n')[0]!;
-    const smallBar = result.split('\n')[1]!;
-    const bigBlocks = (bigBar.match(/\u2588/g) || []).length;
-    const smallBlocks = (smallBar.match(/\u2588/g) || []).length;
-    expect(bigBlocks).toBeGreaterThan(smallBlocks);
-  });
-});

package/bin/analytics/client.js

@@ -1,55 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { authenticatedFetch } from '../authenticatedFetch.js';
-import { API_URL } from '../constants.js';
-function request(path_1) {
-    return __awaiter(this, arguments, void 0, function* (path, params = {}) {
-        const url = new URL(`${API_URL}/api/cli/analytics${path}`);
-        for (const [key, value] of Object.entries(params)) {
-            if (value !== undefined)
-                url.searchParams.set(key, String(value));
-        }
-        const res = yield authenticatedFetch(url.toString(), {
-            headers: { Accept: 'application/json' },
-        });
-        if (!res.ok) {
-            const body = yield res.text().catch(() => '');
-            throw new Error(`API error (${res.status}): ${body || res.statusText}`);
-        }
-        return res.json();
-    });
-}
-export function getKpi(opts, subdomain) {
-    return request('/kpi', Object.assign(Object.assign({}, opts), { subdomain }));
-}
-export function getFeedback(opts, subdomain) {
-    return request('/feedback', Object.assign(Object.assign({}, opts), { subdomain }));
-}
-export function getFeedbackByPage(opts, subdomain) {
-    return request('/feedback/by-page', Object.assign(Object.assign({}, opts), { subdomain }));
-}
-export function getConversations(opts, subdomain) {
-    return request('/assistant', Object.assign(Object.assign({}, opts), { subdomain }));
-}
-export function getSearches(opts, subdomain) {
-    return request('/searches', Object.assign(Object.assign({}, opts), { subdomain }));
-}
-export function getViews(opts, subdomain) {
-    return request('/views', Object.assign(Object.assign({}, opts), { subdomain }));
-}
-export function getVisitors(opts, subdomain) {
-    return request('/visitors', Object.assign(Object.assign({}, opts), { subdomain }));
-}
-export function getBuckets(opts, subdomain) {
-    return request('/conversations/buckets', Object.assign(Object.assign({}, opts), { subdomain }));
-}
-export function getBucketThreads(bucketId, opts, subdomain) {
-    return request(`/conversations/buckets/${encodeURIComponent(bucketId)}`, Object.assign(Object.assign({}, opts), { subdomain }));
-}

package/bin/analytics/format.js

@@ -1,13 +0,0 @@
-export function num(n) {
-    return n.toLocaleString('en-US');
-}
-export function pct(n, total) {
-    if (total === 0)
-        return '\u2014';
-    return ((n / total) * 100).toFixed(1) + '%';
-}
-export function truncate(s, max) {
-    if (s.length <= max)
-        return s;
-    return s.slice(0, max - 1) + '\u2026';
-}