@mintlify/cli 4.0.1422 → 4.0.1423

package/src/analytics/types.ts

@@ -0,0 +1,145 @@
+export interface KpiResponse {
+  humanVisitors: number;
+  humanViews: number;
+  humanAssistant: number;
+  humanSearches: number;
+  humanFeedback: number;
+  agentVisitors: number;
+  agentViews: number;
+  agentMcpSearches: number;
+}
+
+export interface BucketSummary {
+  id: string;
+  questionSummary: string;
+  size: number;
+  status: string;
+  lastAsked: string | null;
+  lastOccurredAt: string | null;
+  createdAt: string;
+}
+
+export interface BucketsResponse {
+  data: BucketSummary[];
+  pagination: { total: number };
+}
+
+export interface BucketThread {
+  id: string;
+  firstUserMessage: string | null;
+  feedback: { up: number; down: number };
+  resolutionStatus: string | null;
+  length: number;
+  createdAt: string;
+  lastMessageAt: string | null;
+}
+
+export interface BucketThreadsResponse {
+  data: BucketThread[];
+  pagination: { total: number; hasMore: boolean; nextCursor: string | null };
+}
+
+export interface FeedbackItem {
+  id: string;
+  path: string;
+  comment: string | null;
+  createdAt: string | null;
+  source: string;
+  status: string;
+  helpful?: boolean;
+  contact?: string;
+  code?: string;
+  filename?: string;
+  lang?: string;
+}
+
+export interface FeedbackResponse {
+  feedback: FeedbackItem[];
+  nextCursor: string | null;
+  hasMore: boolean;
+}
+
+export interface FeedbackByPageItem {
+  path: string;
+  thumbsUp: number;
+  thumbsDown: number;
+  code: number;
+  total: number;
+}
+
+export interface FeedbackByPageResponse {
+  feedback: FeedbackByPageItem[];
+  hasMore: boolean;
+}
+
+export interface ConversationSource {
+  title: string;
+  url: string;
+}
+
+export interface Conversation {
+  id: string;
+  timestamp: string;
+  query: string;
+  response: string;
+  sources: ConversationSource[];
+  queryCategory: string | null;
+}
+
+export interface ConversationResponse {
+  conversations: Conversation[];
+  nextCursor: string | null;
+  hasMore: boolean;
+}
+
+export interface AssistantThreadMessage {
+  id: string;
+  role: 'user' | 'assistant';
+  content: string;
+  createdAt: string;
+}
+
+export interface AssistantThreadResponse {
+  threadId: string;
+  createdAt: string;
+  messages: AssistantThreadMessage[];
+}
+
+export interface SearchRow {
+  searchQuery: string;
+  hits: number;
+  ctr: number;
+  topClickedPage: string | null;
+  lastSearchedAt: string;
+}
+
+export interface SearchResponse {
+  searches: SearchRow[];
+  totalSearches: number;
+  nextCursor: string | null;
+}
+
+export interface TrafficTotals {
+  human: number;
+  ai: number;
+  total: number;
+}
+
+export interface TrafficRow {
+  path: string;
+  human: number;
+  ai: number;
+  total: number;
+}
+
+export interface ViewsResponse {
+  totals: TrafficTotals;
+  views: TrafficRow[];
+  hasMore: boolean;
+}
+
+export interface VisitorsResponse {
+  totals: TrafficTotals;
+  visitors: TrafficRow[];
+  hasMore: boolean;
+}

package/src/cli.tsx

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

package/src/middlewares/telemetryMiddleware.ts

@@ -3,13 +3,17 @@ 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}`;
@@ -19,6 +23,19 @@ 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,7 +36,10 @@ const GROUPS: CommandGroup[] = [
   },
   {
     title: 'Insights',
-    commands: [{ name: 'automations', description: 'Create and manage automations' }],
+    commands: [
+      { name: 'analytics', description: 'View analytics for your site' },
+      { name: 'automations', description: 'Create and manage automations' },
+    ],
   },
   {
     title: 'Account',