@mintlify/prebuild 1.0.834 → 1.0.840

package/dist/generate.js

@@ -1,8 +1,11 @@
 import { slugToTitle, optionallyAddLeadingSlash, removeLeadingSlash, optionallyRemoveTrailingSlash, } from '@mintlify/common';
 import { divisions, } from '@mintlify/validation';
-import chalk from 'chalk';
+import { addWarning } from './prebuild/warnings.js';
 const handleUnknownPage = (page, type) => {
-    console.log(`${chalk.yellow.bold('warning')} - "${page}" is referenced in the ${type}.json navigation but the file does not exist.`);
+    addWarning({
+        type: 'missing-nav-page',
+        message: `"${page}" is referenced in the ${type}.json navigation but the file does not exist.`,
+    });
     return {
         title: slugToTitle(page),
         href: optionallyAddLeadingSlash(page),

package/dist/prebuild/categorizeFilePaths.js

@@ -5,6 +5,7 @@ import * as path from 'path';
 import { formatError } from '../errorMessages/formatError.js';
 import { getFileList } from '../fs/index.js';
 import { getFileExtension } from '../utils.js';
+import { addWarning } from './warnings.js';
 export const categorizeFilePaths = async (contentDirectoryPath, mintIgnore = [], disableOpenApi) => {
     const allFiles = getFileList(contentDirectoryPath, contentDirectoryPath, mintIgnore);
     const mdxFiles = [];
@@ -72,7 +73,10 @@ export const categorizeFilePaths = async (contentDirectoryPath, mintIgnore = [],
                         }
                     }
                     catch (error) {
-                        console.error(`Error validating OpenAPI file ${filename}: ${error}`);
+                        addWarning({
+                            type: 'openapi',
+                            message: `Error validating OpenAPI file ${filename}: ${error}`,
+                        });
                     }
                 }
                 if (isAsyncApi) {

package/dist/prebuild/index.js

@@ -1,11 +1,14 @@
 import { getConfigPath, getMintIgnore } from '../utils.js';
 import { categorizeFilePaths } from './categorizeFilePaths.js';
 import { update } from './update/index.js';
+import { clearWarnings, checkStrictMode } from './warnings.js';
 export const prebuild = async (contentDirectoryPath, { localSchema, groups, disableOpenApi, strict, } = {}) => {
     if (process.env.IS_MULTI_TENANT === 'true') {
         console.log('Skipping prebuild in multi-tenant mode.');
         return;
     }
+    // Clear any warnings from previous runs
+    clearWarnings();
     const docsConfigPath = await getConfigPath(contentDirectoryPath, 'docs');
     const mintConfigPath = await getConfigPath(contentDirectoryPath, 'mint');
     if (mintConfigPath == null && docsConfigPath == null) {
@@ -28,6 +31,8 @@ export const prebuild = async (contentDirectoryPath, { localSchema, groups, disa
         disableOpenApi,
         strict,
     });
+    // In strict mode, fail if there were any warnings
+    checkStrictMode(strict);
     return { fileImportsMap };
 };
 export * from './categorizeFilePaths.js';

package/dist/prebuild/update/resolveImportsAndWriteFiles.js

@@ -1,6 +1,7 @@
 import { resolveAllImports, hasImports, findAndRemoveImports, getDecoratedNavPageAndSlug, topologicalSort, stringifyTree, } from '@mintlify/common';
 import { outputFile } from 'fs-extra';
 import { join } from 'path';
+import { addWarning } from '../warnings.js';
 export const resolveImportsAndWriteFiles = async ({ openApiFiles, asyncApiFiles, pagesAcc, snippetsV2, filesWithImports, }) => {
     const snippetsWithResolvedImports = await resolveImportsInSnippets(snippetsV2);
     const writeSnippetsWithImportsPromises = await writeSnippets(snippetsWithResolvedImports);
@@ -35,6 +36,7 @@ const resolveImportsInSnippets = async (snippetsV2) => {
             snippetWithImports.tree = await resolveAllImports({
                 snippets: orderedSnippetsWithImports,
                 fileWithImports: snippetWithImports,
+                onWarning: addWarning,
             });
         }
     }
@@ -51,6 +53,7 @@ const resolveImportsInPages = async ({ openApiFiles, asyncApiFiles, snippetsWith
         const tree = await resolveAllImports({
             snippets: snippetsWithResolvedImports,
             fileWithImports,
+            onWarning: addWarning,
         });
         const contentStr = stringifyTree(tree);
         const { slug, pageMetadata } = getDecoratedNavPageAndSlug(fileWithImports.filename, contentStr, openApiFiles, asyncApiFiles);

package/dist/prebuild/warnings.d.ts

@@ -0,0 +1,7 @@
+export type Warning = {
+    type: 'missing-file' | 'missing-nav-page' | 'openapi' | 'invalid-import-path' | 'import-resolution-error';
+    message: string;
+};
+export declare const clearWarnings: () => void;
+export declare const addWarning: (warning: Warning) => void;
+export declare const checkStrictMode: (strict?: boolean) => void;

package/dist/prebuild/warnings.js

@@ -0,0 +1,14 @@
+import chalk from 'chalk';
+let warnings = [];
+export const clearWarnings = () => {
+    warnings = [];
+};
+export const addWarning = (warning) => {
+    warnings.push(warning);
+    console.log(chalk.yellow.bold('warning') + ' - ' + warning.message);
+};
+export const checkStrictMode = (strict) => {
+    if (strict && warnings.length > 0) {
+        throw new Error(`Build validation failed with ${warnings.length} warning(s). See above for details.`);
+    }
+};