@mintlify/prebuild 1.0.1208 → 1.0.1210

package/dist/prebuild/update/docsConfig/generateOpenApiFromDocsConfig.d.ts

@@ -7,6 +7,7 @@ export declare const generateOpenApiFromDocsConfig: (navigation: NavigationConfi
     targetDir?: string;
     localSchema?: boolean;
     invalidSpecFiles?: InvalidSpecFile[];
+    mountPaths?: string[];
     writeFile?: (filename: string, content: string) => void | Promise<void>;
 }) => Promise<{
     newNav: NavigationConfig;

package/dist/prebuild/update/docsConfig/generateOpenApiFromDocsConfig.js

@@ -5,8 +5,20 @@ import { divisions, } from '@mintlify/validation';
 import * as path from 'path';
 import { findInvalidSpecFile } from '../../invalidSpecFiles.js';
 const DEFAULT_OUTPUT_DIR = 'api-reference';
+const normalizeMountPath = (mountPath) => mountPath.replace(/^\/+|\/+$/g, '');
+const getMountPathForPath = (candidatePath, mountPaths) => {
+    if (!candidatePath)
+        return '';
+    const normalizedPath = candidatePath.replace(/^\/+/, '');
+    const candidates = mountPaths
+        .map(normalizeMountPath)
+        .filter(Boolean)
+        .sort((a, b) => b.length - a.length);
+    return (candidates.find((mountPath) => normalizedPath === mountPath || normalizedPath.startsWith(`${mountPath}/`)) ?? '');
+};
+const resolveMountPath = (specPath, outputDir, mountPaths) => getMountPathForPath(specPath, mountPaths) || getMountPathForPath(outputDir, mountPaths);
 export const generateOpenApiFromDocsConfig = async (navigation, openApiFiles, pagesAcc, opts) => {
-    const { overwrite, writeFiles, targetDir, localSchema, invalidSpecFiles, writeFile } = opts;
+    const { overwrite, writeFiles, targetDir, localSchema, invalidSpecFiles, mountPaths = [], writeFile, } = opts;
     const newOpenApiFiles = [];
     const openApiFilePromises = new Map();
     async function processOpenApiInNav(nav) {
@@ -53,6 +65,7 @@ export const generateOpenApiFromDocsConfig = async (navigation, openApiFiles, pa
                 writeFiles,
                 outDir: outputDir,
                 outDirBasePath: path.join(targetDir ?? '', 'src', '_props'),
+                mountPath: resolveMountPath(openApiFile.originalFileLocation, outputDir, mountPaths),
                 overwrite,
                 localSchema,
                 writeFile,
@@ -161,17 +174,19 @@ export const generateOpenApiFromDocsConfig = async (navigation, openApiFiles, pa
                         const tempNav = [];
                         const tempDecoratedNav = [];
                         const writePromises = [];
+                        let generatedSlugs = [];
                         if (isWebhook) {
                             const webhooks = schema.webhooks;
                             const webhookMatch = findOpenApiPath(webhooks, endpoint);
                             if (!webhookMatch) {
                                 throw new Error(`Webhook ${endpoint} not found in ${openapiPath}. ${webhooks ? `Available webhooks: ${Object.keys(webhooks).join(', ')}` : ''}`.trim());
                             }
-                            processOpenApiWebhook(webhookMatch.pathKey, webhookMatch.pathItem, schema, tempNav, tempDecoratedNav, writePromises, pagesAcc, {
+                            generatedSlugs = processOpenApiWebhook(webhookMatch.pathKey, webhookMatch.pathItem, schema, tempNav, tempDecoratedNav, writePromises, pagesAcc, {
                                 openApiFilePath: openApiFile.originalFileLocation,
                                 writeFiles,
                                 outDir: currentDirectory ?? DEFAULT_OUTPUT_DIR,
                                 outDirBasePath: path.join(targetDir ?? '', 'src', '_props'),
+                                mountPath: resolveMountPath(openApiFile.originalFileLocation, currentDirectory, mountPaths),
                                 overwrite,
                                 localSchema,
                                 writeFile,
@@ -187,34 +202,21 @@ export const generateOpenApiFromDocsConfig = async (navigation, openApiFiles, pa
                             if (!opObject) {
                                 throw new Error(`Method ${method.toUpperCase()} for endpoint ${match.pathKey} not found in ${openapiPath}`);
                             }
-                            processOpenApiPath(match.pathKey, { [method.toLowerCase()]: opObject }, schema, tempNav, tempDecoratedNav, writePromises, pagesAcc, {
+                            generatedSlugs = processOpenApiPath(match.pathKey, { [method.toLowerCase()]: opObject }, schema, tempNav, tempDecoratedNav, writePromises, pagesAcc, {
                                 openApiFilePath: openApiFile.originalFileLocation,
                                 writeFiles,
                                 outDir: currentDirectory ?? DEFAULT_OUTPUT_DIR,
                                 outDirBasePath: path.join(targetDir ?? '', 'src', '_props'),
+                                mountPath: resolveMountPath(openApiFile.originalFileLocation, currentDirectory, mountPaths),
                                 overwrite,
                                 localSchema,
                                 writeFile,
                             }, findNavGroup);
                         }
                         await Promise.all(writePromises);
-                        let slug;
-                        const firstEntry = tempNav[0];
-                        if (firstEntry &&
-                            typeof firstEntry === 'object' &&
-                            'pages' in firstEntry &&
-                            Array.isArray(firstEntry.pages) &&
-                            firstEntry.pages.length > 0) {
-                            slug = firstEntry.pages[0];
-                        }
-                        else if (typeof firstEntry === 'string') {
-                            slug = firstEntry;
-                        }
-                        else {
-                            slug = Object.keys(pagesAcc).pop();
-                        }
+                        const slug = generatedSlugs[0];
                         if (!slug) {
-                            throw new Error('Failed to generate OpenAPI endpoint page');
+                            throw new Error(`Failed to generate OpenAPI endpoint page for ${method.toUpperCase()} ${endpoint} in ${openapiPath}`);
                         }
                         if (currentOpenApiOwner && !explicitOpenapiPath) {
                             skipBulkForNodeId.add(currentOpenApiOwner);