@mintlify/cli 4.0.1084 → 4.0.1086

package/bin/workflow.js

@@ -13,7 +13,7 @@ import { addLog, addLogs, SuccessLog } from '@mintlify/previewing';
 import fse from 'fs-extra';
 import { Text } from 'ink';
 import path from 'path';
-import { CMD_EXEC_PATH } from './constants.js';
+import { CMD_EXEC_PATH } from './helpers.js';
 export function slugify(name) {
     return name
         .toLowerCase()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.1084",
+  "version": "4.0.1086",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -93,5 +93,5 @@
     "vitest": "2.1.9",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "b98237c830a5b1786611dea52270ae3b8a350fb1"
+  "gitHead": "cda0cfd7e97b5961ec6dd405b5f8dc6d9be2faef"
 }

package/src/accessibilityCheck.tsx

@@ -6,8 +6,7 @@ import { Text } from 'ink';
 
 import { checkDocsColors, type AccessibilityCheckResult } from './accessibility.js';
 import { ContrastResult } from './accessibility.js';
-import { CMD_EXEC_PATH } from './constants.js';
-import { checkForDocsJson } from './helpers.js';
+import { CMD_EXEC_PATH, checkForDocsJson } from './helpers.js';
 
 export type TerminateCode = 0 | 1;
 

package/src/analytics/client.ts

@@ -0,0 +1,164 @@
+import type {
+  BucketThreadsResponse,
+  BucketsResponse,
+  ConversationResponse,
+  FeedbackByPageResponse,
+  FeedbackResponse,
+  KpiResponse,
+  SearchResponse,
+  ViewsResponse,
+  VisitorsResponse,
+} from './types.js';
+
+const API_BASE = process.env.MINTLIFY_API_URL ?? 'http://localhost:5000';
+
+type Params = Record<string, string | number | undefined>;
+
+async function getAuthHeaders(): Promise<Record<string, string>> {
+  try {
+    const { getAccessToken } = await import('../keyring.js');
+    const token = await getAccessToken();
+    if (token) {
+      return { Authorization: `Bearer ${token}` };
+    }
+  } catch {}
+
+  const envToken = process.env.MINTLIFY_SESSION_TOKEN;
+  if (envToken) {
+    return { Authorization: `Bearer ${envToken}` };
+  }
+
+  throw new Error('Not authenticated. Run `mint login` to authenticate.');
+}
+
+async function request<T>(path: string, params: Params = {}): Promise<T> {
+  const url = new URL(`${API_BASE}/api/cli/analytics${path}`);
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== undefined) url.searchParams.set(key, String(value));
+  }
+
+  const authHeaders = await getAuthHeaders();
+  const res = await fetch(url, {
+    headers: { ...authHeaders, Accept: 'application/json' },
+  });
+
+  if (!res.ok) {
+    const body = await res.text().catch(() => '');
+    throw new Error(`API error (${res.status}): ${body || res.statusText}`);
+  }
+
+  return res.json() as Promise<T>;
+}
+
+export function getKpi(
+  opts: {
+    dateFrom: string;
+    dateTo: string;
+    page?: string;
+  },
+  subdomain?: string
+) {
+  return request<KpiResponse>('/kpi', { ...opts, subdomain });
+}
+
+export function getFeedback(
+  opts: {
+    dateFrom: string;
+    dateTo: string;
+    limit?: number;
+    cursor?: string;
+    source?: string;
+    status?: string;
+  },
+  subdomain?: string
+) {
+  return request<FeedbackResponse>('/feedback', { ...opts, subdomain });
+}
+
+export function getFeedbackByPage(
+  opts: {
+    dateFrom: string;
+    dateTo: string;
+    limit?: number;
+    source?: string;
+    status?: string;
+  },
+  subdomain?: string
+) {
+  return request<FeedbackByPageResponse>('/feedback/by-page', { ...opts, subdomain });
+}
+
+export function getConversations(
+  opts: {
+    dateFrom: string;
+    dateTo: string;
+    limit?: number;
+    cursor?: string;
+  },
+  subdomain?: string
+) {
+  return request<ConversationResponse>('/assistant', { ...opts, subdomain });
+}
+
+export function getSearches(
+  opts: {
+    dateFrom: string;
+    dateTo: string;
+    limit?: number;
+    cursor?: string;
+  },
+  subdomain?: string
+) {
+  return request<SearchResponse>('/searches', { ...opts, subdomain });
+}
+
+export function getViews(
+  opts: {
+    dateFrom: string;
+    dateTo: string;
+    limit?: number;
+    offset?: number;
+  },
+  subdomain?: string
+) {
+  return request<ViewsResponse>('/views', { ...opts, subdomain });
+}
+
+export function getVisitors(
+  opts: {
+    dateFrom: string;
+    dateTo: string;
+    limit?: number;
+    offset?: number;
+  },
+  subdomain?: string
+) {
+  return request<VisitorsResponse>('/visitors', { ...opts, subdomain });
+}
+
+export function getBuckets(
+  opts: {
+    dateFrom?: string;
+    dateTo?: string;
+    topK?: number;
+  },
+  subdomain?: string
+) {
+  return request<BucketsResponse>('/conversations/buckets', { ...opts, subdomain });
+}
+
+export function getBucketThreads(
+  bucketId: string,
+  opts: {
+    dateFrom?: string;
+    dateTo?: string;
+    limit?: number;
+    cursor?: string;
+  },
+  subdomain?: string
+) {
+  return request<BucketThreadsResponse>(`/conversations/buckets/${encodeURIComponent(bucketId)}`, {
+    ...opts,
+    subdomain,
+  });
+}

package/src/analytics/format.ts

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