@mintlify/cli 4.0.1812 → 4.1.1

package/src/analytics/types.ts

@@ -1,145 +0,0 @@
-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/authenticatedFetch.ts

@@ -1,42 +0,0 @@
-import { getAccessToken } from './keyring.js';
-import { refreshAccessToken } from './tokenRefresh.js';
-
-async function getKeyringToken(): Promise<string | null> {
-  try {
-    return await getAccessToken();
-  } catch {
-    return null;
-  }
-}
-
-export async function authenticatedFetch(url: string | URL, init?: RequestInit): Promise<Response> {
-  const keyringToken = await getKeyringToken();
-  const envToken = process.env.MINTLIFY_SESSION_TOKEN;
-  const token = keyringToken ?? envToken;
-
-  if (!token) {
-    throw new Error('Not authenticated. Run `mint login` to authenticate.');
-  }
-
-  const makeRequest = (t: string) =>
-    fetch(url, {
-      ...init,
-      headers: { ...init?.headers, Authorization: `Bearer ${t}` },
-    });
-
-  const res = await makeRequest(token);
-  if (res.status !== 401) return res;
-
-  // If the keyring token expired, try refreshing it
-  if (keyringToken) {
-    const refreshed = await refreshAccessToken();
-    if (refreshed) return makeRequest(refreshed);
-  }
-
-  // Fall back to the env session token if it wasn't already used
-  if (envToken && token !== envToken) {
-    return makeRequest(envToken);
-  }
-
-  return res;
-}

package/src/brokenLinks.tsx

@@ -1,152 +0,0 @@
-import { buildGraph, getBrokenExternalLinks, getFilesLinksDependOn } from '@mintlify/link-rot';
-import {
-  addLog,
-  clearLogs,
-  BrokenLinksLog,
-  ErrorLog,
-  SpinnerLog,
-  SuccessLog,
-  WarningLog,
-} from '@mintlify/previewing';
-import fs from 'node:fs/promises';
-import path from 'path';
-
-import { autoUpgradeIfNeeded, CMD_EXEC_PATH, findDocsRoot, terminate } from './helpers.js';
-import { resolveExplicitFiles } from './resolveFiles.js';
-
-type BrokenLinksArgs = {
-  files?: (string | number)[];
-  'check-anchors': boolean;
-  'check-external': boolean;
-  'check-snippets': boolean;
-  'check-redirects': boolean;
-};
-
-export const brokenLinksHandler = async (argv: BrokenLinksArgs): Promise<void> => {
-  await autoUpgradeIfNeeded();
-  addLog(<SpinnerLog message="checking for broken links..." />);
-  try {
-    const docsRoot = await findDocsRoot(CMD_EXEC_PATH);
-    const fileArgs = (argv.files ?? []).map(String).filter(Boolean);
-    const sourceFiles =
-      fileArgs.length > 0
-        ? new Set(
-            (await resolveExplicitFiles(CMD_EXEC_PATH, fileArgs)).map((file) =>
-              path.relative(docsRoot, path.resolve(CMD_EXEC_PATH, file))
-            )
-          )
-        : undefined;
-    // One unparseable page shouldn't hide every other result: report it and keep going
-    const parseErrorsByFile = new Map<string, string>();
-    const graph = await buildGraph(docsRoot, {
-      checkSnippets: argv['check-snippets'],
-      onParseError: (filePath, error) => parseErrorsByFile.set(filePath, error.message),
-    });
-    graph.precomputeFileResolutions();
-    // With --files, a failure elsewhere only matters when a selected link needs that
-    // file: an anchor pointing at it, or a snippet the selected page renders
-    const dependencies = sourceFiles
-      ? getFilesLinksDependOn(graph, sourceFiles, {
-          checkAnchors: argv['check-anchors'],
-          checkSnippets: argv['check-snippets'],
-        })
-      : undefined;
-    const parseErrors = [...parseErrorsByFile]
-      .filter(
-        ([filePath]) =>
-          !sourceFiles ||
-          sourceFiles.has(filePath) ||
-          dependencies?.has(filePath.split(path.sep).join('/'))
-      )
-      .map(([, message]) => message);
-
-    const brokenInternalLinks = graph
-      .getBrokenInternalLinks({
-        checkAnchors: argv['check-anchors'],
-      })
-      .filter(
-        ({ relativeDir, filename }) =>
-          !sourceFiles || sourceFiles.has(path.join(relativeDir, filename))
-      );
-
-    const brokenLinksByFile: Record<string, string[]> = {};
-
-    brokenInternalLinks.forEach((mdxPath) => {
-      const filename = path.join(mdxPath.relativeDir, mdxPath.filename);
-      const existing = brokenLinksByFile[filename];
-      if (existing) {
-        existing.push(mdxPath.originalPath);
-      } else {
-        brokenLinksByFile[filename] = [mdxPath.originalPath];
-      }
-    });
-
-    if (argv['check-external']) {
-      const brokenExternalLinks = await getBrokenExternalLinks(
-        graph,
-        sourceFiles ? { sourceFiles } : undefined
-      );
-      for (const result of brokenExternalLinks) {
-        for (const source of result.sources) {
-          const label = result.status
-            ? `${result.url} (${result.status})`
-            : `${result.url} (${result.error})`;
-          const existing = brokenLinksByFile[source.file];
-          if (existing) {
-            existing.push(label);
-          } else {
-            brokenLinksByFile[source.file] = [label];
-          }
-        }
-      }
-    }
-
-    if (argv['check-redirects']) {
-      const brokenRedirects = graph.getBrokenRedirects();
-      if (brokenRedirects.length > 0) {
-        const configFilename = await fs
-          .access(path.join(docsRoot, 'docs.json'))
-          .then(() => 'docs.json')
-          .catch(() => 'mint.json');
-        const labels = brokenRedirects.map(
-          ({ source, destination }) => `${source} → ${destination}`
-        );
-        const existing = brokenLinksByFile[configFilename];
-        if (existing) {
-          existing.push(...labels);
-        } else {
-          brokenLinksByFile[configFilename] = labels;
-        }
-      }
-    }
-
-    const hasBrokenLinks = Object.keys(brokenLinksByFile).length > 0;
-    if (!hasBrokenLinks && parseErrors.length === 0) {
-      clearLogs();
-      addLog(<SuccessLog message="no broken links found" />);
-      await terminate(0);
-    }
-
-    clearLogs();
-    if (hasBrokenLinks) {
-      addLog(<BrokenLinksLog brokenLinksByFile={brokenLinksByFile} />);
-    } else {
-      addLog(<SuccessLog message="no broken links found in the files that parsed" />);
-    }
-    for (const message of parseErrors) {
-      addLog(<ErrorLog message={message} />);
-    }
-    if (parseErrors.length > 0) {
-      addLog(
-        <WarningLog
-          message={`skipped ${parseErrors.length} file(s) that could not be parsed; links in them were not checked`}
-        />
-      );
-    }
-  } catch (err) {
-    addLog(<ErrorLog message={err instanceof Error ? err.message : 'unknown error'} />);
-    await terminate(1);
-  }
-
-  await terminate(1);
-};

package/src/callbackServer.ts

@@ -1,64 +0,0 @@
-import { CALLBACK_PORT, DASHBOARD_URL } from './constants.js';
-
-export async function startCallbackServer(): Promise<{
-  codePromise: Promise<string>;
-  close: () => void;
-}> {
-  const { default: http } = await import('http');
-
-  let resolveCode: (code: string) => void;
-  let rejectCode: (err: Error) => void;
-  let closed = false;
-
-  const codePromise = new Promise<string>((res, rej) => {
-    resolveCode = res;
-    rejectCode = rej;
-  });
-
-  const server = http.createServer((req, res) => {
-    res.setHeader('Access-Control-Allow-Origin', DASHBOARD_URL);
-    res.setHeader('Access-Control-Allow-Methods', 'POST, OPTIONS');
-    res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
-
-    if (req.method === 'OPTIONS') {
-      res.writeHead(204);
-      res.end();
-      return;
-    }
-
-    if (req.method === 'POST') {
-      let body = '';
-      req.on('data', (chunk) => {
-        body += chunk;
-      });
-      req.on('end', () => {
-        try {
-          const { code } = JSON.parse(body) as { code: string };
-          res.writeHead(200, { 'Content-Type': 'application/json' });
-          res.end(JSON.stringify({ ok: true }));
-          closed = true;
-          server.close();
-          resolveCode(code);
-        } catch {
-          res.writeHead(400);
-          res.end(JSON.stringify({ error: 'invalid body' }));
-        }
-      });
-    } else {
-      res.writeHead(405);
-      res.end();
-    }
-  });
-
-  server.listen(CALLBACK_PORT, 'localhost');
-
-  const close = () => {
-    if (!closed) {
-      closed = true;
-      server.close();
-      rejectCode(new Error('Login cancelled'));
-    }
-  };
-
-  return { codePromise, close };
-}