@mintlify/cli 4.0.976 → 4.0.977

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.976",
+  "version": "4.0.977",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -46,7 +46,7 @@
   "dependencies": {
     "@inquirer/prompts": "7.9.0",
     "@mintlify/common": "1.0.748",
-    "@mintlify/link-rot": "3.0.911",
+    "@mintlify/link-rot": "3.0.912",
     "@mintlify/models": "0.0.274",
     "@mintlify/prebuild": "1.0.885",
     "@mintlify/previewing": "4.0.942",
@@ -87,5 +87,5 @@
     "vitest": "2.0.4",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "92cd443cb6af79021bfaa814b3e5e96c10846baa"
+  "gitHead": "8f066a43dd9d3552038aa9b421a4e83142206abb"
 }

package/src/cli.tsx

@@ -1,5 +1,9 @@
 import { validate, getOpenApiDocumentFromUrl, isAllowedLocalSchemaUrl } from '@mintlify/common';
-import { getBrokenInternalLinks, renameFilesAndUpdateLinksInContent } from '@mintlify/link-rot';
+import {
+  buildGraph,
+  getBrokenExternalLinks,
+  renameFilesAndUpdateLinksInContent,
+} from '@mintlify/link-rot';
 import {
   addLog,
   dev,
@@ -216,13 +220,24 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
       )
       .command(
         'broken-links',
-        'check for invalid internal links',
+        'check for broken links',
         (yargs) =>
-          yargs.option('check-anchors', {
-            type: 'boolean',
-            default: false,
-            description: 'also validate anchor links (e.g. #section) against heading slugs',
-          }),
+          yargs
+            .option('check-anchors', {
+              type: 'boolean',
+              default: false,
+              description: 'also validate anchor links (e.g. #section) against heading slugs',
+            })
+            .option('check-external', {
+              type: 'boolean',
+              default: false,
+              description: 'also check external links for broken URLs',
+            })
+            .option('check-snippets', {
+              type: 'boolean',
+              default: false,
+              description: 'also check links inside <Snippet> components',
+            }),
         async (argv) => {
           const hasMintJson = await checkForMintJson();
           if (!hasMintJson) {
@@ -231,25 +246,50 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
 
           addLog(<SpinnerLog message="checking for broken links..." />);
           try {
-            const brokenLinks = await getBrokenInternalLinks(undefined, {
+            const graph = await buildGraph(undefined, {
+              checkSnippets: argv['check-snippets'],
+            });
+            graph.precomputeFileResolutions();
+
+            const brokenInternalLinks = graph.getBrokenInternalLinks({
               checkAnchors: argv['check-anchors'],
             });
-            if (brokenLinks.length === 0) {
-              clearLogs();
-              addLog(<SuccessLog message="no broken links found" />);
-              await terminate(0);
-            }
 
             const brokenLinksByFile: Record<string, string[]> = {};
-            brokenLinks.forEach((mdxPath) => {
+
+            brokenInternalLinks.forEach((mdxPath) => {
               const filename = path.join(mdxPath.relativeDir, mdxPath.filename);
-              const brokenLinksForFile = brokenLinksByFile[filename];
-              if (brokenLinksForFile) {
-                brokenLinksForFile.push(mdxPath.originalPath);
+              const existing = brokenLinksByFile[filename];
+              if (existing) {
+                existing.push(mdxPath.originalPath);
               } else {
                 brokenLinksByFile[filename] = [mdxPath.originalPath];
               }
             });
+
+            if (argv['check-external']) {
+              const brokenExternalLinks = await getBrokenExternalLinks(graph);
+              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 (Object.keys(brokenLinksByFile).length === 0) {
+              clearLogs();
+              addLog(<SuccessLog message="no broken links found" />);
+              await terminate(0);
+            }
+
             clearLogs();
             addLog(<BrokenLinksLog brokenLinksByFile={brokenLinksByFile} />);
           } catch (err) {