@mintlify/link-rot 3.0.1036 → 3.0.1038

package/dist/static-checking/getNavigationHrefs.js

@@ -7,8 +7,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import fs from 'fs-extra';
-import path from 'path';
+import { readResolvedConfigJson } from './readConfig.js';
 const collectHrefs = (obj) => {
     if (typeof obj !== 'object' || obj === null)
         return [];
@@ -25,17 +24,13 @@ const collectHrefs = (obj) => {
     return hrefs;
 };
 export const getNavigationHrefs = (baseDir) => __awaiter(void 0, void 0, void 0, function* () {
-    let configJson;
-    let configFile;
-    if (fs.existsSync(path.join(baseDir, 'docs.json'))) {
-        configJson = yield fs.readJSON(path.join(baseDir, 'docs.json'));
-        configFile = 'docs.json';
-    }
-    else if (fs.existsSync(path.join(baseDir, 'mint.json'))) {
-        configJson = yield fs.readJSON(path.join(baseDir, 'mint.json'));
-        configFile = 'mint.json';
-    }
-    if (!(configJson === null || configJson === void 0 ? void 0 : configJson.navigation) || !configFile)
+    const resolved = yield readResolvedConfigJson(baseDir);
+    if (!resolved)
+        return undefined;
+    if (!resolved.json.navigation)
         return undefined;
-    return { hrefs: collectHrefs(configJson.navigation), configFile };
+    return {
+        hrefs: collectHrefs(resolved.json.navigation),
+        configFile: resolved.configFile,
+    };
 });

package/dist/static-checking/getOpenApiPagePaths.d.ts

@@ -2,7 +2,12 @@
  * Extract virtual page paths that would be generated from OpenAPI specs.
  * These pages don't exist as files but are valid link targets.
  *
- * Note: Uses api.openapi.directory from docs.json, or falls back to 'api-reference'.
- * Per-navigation directory configs are not currently supported.
+ * For docs.json (v2) configs, this walks the navigation tree so that per-spec
+ * `directory` overrides and inherited directories are honored — matching the
+ * slugs production generates. For mint.json (v1) or missing configs, it falls
+ * back to generating page paths under the default `api-reference` directory.
+ *
+ * `$ref` pointers inside the config are resolved first, so navigation split
+ * across multiple JSON files is walked end-to-end.
  */
 export declare const getOpenApiPagePaths: (baseDir: string) => Promise<string[]>;

package/dist/static-checking/getOpenApiPagePaths.js

@@ -7,52 +7,52 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { categorizeFilePaths } from '@mintlify/prebuild';
+import { categorizeFilePaths, generateOpenApiFromDocsConfig, getOpenApiFilesFromConfig, } from '@mintlify/prebuild';
 import { generateOpenApiPagesForDocsConfig } from '@mintlify/scraping';
 import { validateDocsConfig } from '@mintlify/validation';
-import fs from 'fs-extra';
-import path from 'path';
+import { readResolvedConfigJson } from './readConfig.js';
 const DEFAULT_OUTPUT_DIR = 'api-reference';
-const getOpenApiDirectory = (baseDir) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a;
-    const docsJsonPath = path.join(baseDir, 'docs.json');
-    if (!fs.existsSync(docsJsonPath))
-        return DEFAULT_OUTPUT_DIR;
-    try {
-        const docsJson = yield fs.readJSON(docsJsonPath);
-        const result = validateDocsConfig(docsJson);
-        if (!result.success)
-            return DEFAULT_OUTPUT_DIR;
-        const openapi = (_a = result.data.api) === null || _a === void 0 ? void 0 : _a.openapi;
-        if (typeof openapi === 'object' && 'directory' in openapi && openapi.directory) {
-            return openapi.directory;
-        }
-    }
-    catch (_b) {
-        throw new Error('Unable to parse OpenAPI directory from docs.json');
-    }
-    return DEFAULT_OUTPUT_DIR;
-});
 /**
  * Extract virtual page paths that would be generated from OpenAPI specs.
  * These pages don't exist as files but are valid link targets.
  *
- * Note: Uses api.openapi.directory from docs.json, or falls back to 'api-reference'.
- * Per-navigation directory configs are not currently supported.
+ * For docs.json (v2) configs, this walks the navigation tree so that per-spec
+ * `directory` overrides and inherited directories are honored — matching the
+ * slugs production generates. For mint.json (v1) or missing configs, it falls
+ * back to generating page paths under the default `api-reference` directory.
+ *
+ * `$ref` pointers inside the config are resolved first, so navigation split
+ * across multiple JSON files is walked end-to-end.
  */
 export const getOpenApiPagePaths = (baseDir) => __awaiter(void 0, void 0, void 0, function* () {
     const pagePaths = [];
     try {
-        const [{ openApiFiles }, outDir] = yield Promise.all([
-            categorizeFilePaths(baseDir),
-            getOpenApiDirectory(baseDir),
-        ]);
+        const { openApiFiles } = yield categorizeFilePaths(baseDir);
+        const docsConfig = yield readDocsConfig(baseDir);
+        if (docsConfig) {
+            const urlOpenApiFiles = yield safeGetOpenApiFilesFromConfig(docsConfig);
+            const allOpenApiFiles = [...openApiFiles, ...urlOpenApiFiles];
+            const pagesAcc = {};
+            try {
+                yield generateOpenApiFromDocsConfig(docsConfig.navigation, allOpenApiFiles, pagesAcc, {
+                    writeFiles: false,
+                });
+            }
+            catch (err) {
+                console.warn(`Warning: Failed to extract OpenAPI pages from navigation: ${err}`);
+            }
+            pagePaths.push(...Object.keys(pagesAcc));
+        }
+        // Also enumerate default-directory pages per local spec. This preserves
+        // the previous behavior for configs that don't wire every OpenAPI file
+        // into `navigation`, and keeps us permissive (extra virtual nodes can
+        // only hide broken-link reports, never add false positives).
         for (const openApiFile of openApiFiles) {
             try {
                 const { pagesAcc } = yield generateOpenApiPagesForDocsConfig(openApiFile.spec, {
                     openApiFilePath: openApiFile.originalFileLocation,
                     writeFiles: false,
-                    outDir,
+                    outDir: DEFAULT_OUTPUT_DIR,
                 });
                 pagePaths.push(...Object.keys(pagesAcc));
             }
@@ -66,3 +66,19 @@ export const getOpenApiPagePaths = (baseDir) => __awaiter(void 0, void 0, void 0
     }
     return [...new Set(pagePaths)];
 });
+const readDocsConfig = (baseDir) => __awaiter(void 0, void 0, void 0, function* () {
+    const resolved = yield readResolvedConfigJson(baseDir);
+    if (!resolved || resolved.configFile !== 'docs.json')
+        return null;
+    const result = validateDocsConfig(resolved.json);
+    return result.success ? result.data : null;
+});
+const safeGetOpenApiFilesFromConfig = (docsConfig) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        return yield getOpenApiFilesFromConfig('docs', docsConfig);
+    }
+    catch (err) {
+        console.warn(`Warning: Failed to fetch URL-based OpenAPI specs: ${err}`);
+        return [];
+    }
+});

package/dist/static-checking/getRedirects.js

@@ -7,25 +7,14 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { validateDocsConfig, validateMintConfig } from '@mintlify/validation';
-import fs from 'fs-extra';
-import path from 'path';
+import { readResolvedConfigJsonAndValidate } from './readConfig.js';
 export const getRedirects = (baseDir) => __awaiter(void 0, void 0, void 0, function* () {
     const configRedirects = [];
-    // read docs.json or mint.json to get redirects
-    if (fs.existsSync(path.join(baseDir, 'docs.json'))) {
-        const docsJson = yield fs.readJSON(path.join(baseDir, 'docs.json'));
-        const result = validateDocsConfig(docsJson);
-        if (result.success && 'redirects' in result.data && result.data.redirects) {
-            configRedirects.push(...result.data.redirects);
-        }
-    }
-    else if (fs.existsSync(path.join(baseDir, 'mint.json'))) {
-        const mintJson = yield fs.readJSON(path.join(baseDir, 'mint.json'));
-        const result = validateMintConfig(mintJson);
-        if (result.success && 'redirects' in result.data && result.data.redirects) {
-            configRedirects.push(...result.data.redirects);
-        }
+    const result = yield readResolvedConfigJsonAndValidate(baseDir);
+    if (!result)
+        return configRedirects;
+    if (result.success && 'redirects' in result.data && result.data.redirects) {
+        configRedirects.push(...result.data.redirects);
     }
     return configRedirects;
 });