@mintlify/prebuild 1.0.1401 → 1.0.1403

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

@@ -18,9 +18,12 @@ export type GenerateGraphqlDivisionsResult = {
     parsedReferences: Record<string, GraphqlReference>;
 };
 export type GraphqlSourceLoader = (source: string) => Promise<string>;
+export type GenerateGraphqlDivisionsOptions = {
+    onSourceError?: (source: string, error: unknown) => void;
+};
 export declare const getGraphqlRouteKey: (route: string) => string;
 /** Transform GraphQL navigation without reading or writing the filesystem. */
-export declare function generateGraphqlDivisionsFromDocsConfig(docsConfig: DocsConfig, loadSource: GraphqlSourceLoader): Promise<GenerateGraphqlDivisionsResult>;
+export declare function generateGraphqlDivisionsFromDocsConfig(docsConfig: DocsConfig, loadSource: GraphqlSourceLoader, { onSourceError }?: GenerateGraphqlDivisionsOptions): Promise<GenerateGraphqlDivisionsResult>;
 export declare function generateGraphqlDivisions(docsConfig: DocsConfig, contentDirectoryPath: string, targetDir?: string): Promise<GenerateGraphqlDivisionsResult>;
 export declare function loadGraphqlSdlSource(source: string, contentDirectoryPath: string): Promise<string>;
 export declare const isRemoteGraphqlSource: (source: string) => boolean;

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

@@ -94,7 +94,7 @@ function mdxStub(page) {
     return `---\n${fields.join('\n')}\n---\n`;
 }
 /** Transform GraphQL navigation without reading or writing the filesystem. */
-export async function generateGraphqlDivisionsFromDocsConfig(docsConfig, loadSource) {
+export async function generateGraphqlDivisionsFromDocsConfig(docsConfig, loadSource, { onSourceError } = {}) {
     const references = new Map();
     const parsedReferences = new Map();
     const pagesByRouteKey = new Map();
@@ -102,11 +102,17 @@ export async function generateGraphqlDivisionsFromDocsConfig(docsConfig, loadSou
     async function load(source) {
         let pending = references.get(source);
         if (!pending) {
-            pending = loadSource(source).then((sdl) => {
+            const loaded = loadSource(source).then((sdl) => {
                 const reference = parseGraphqlSdl(sdl);
                 parsedReferences.set(source, reference);
                 return reference;
             });
+            pending = onSourceError
+                ? loaded.catch((error) => {
+                    onSourceError(source, error);
+                    return undefined;
+                })
+                : loaded;
             references.set(source, pending);
         }
         return pending;
@@ -129,7 +135,10 @@ export async function generateGraphqlDivisionsFromDocsConfig(docsConfig, loadSou
         const selector = parseGraphqlSelector(page);
         if (!selector)
             return page;
-        const generated = makeSelectedPage(await load(scope.source), scope.source, scope.directory, selector);
+        const reference = await load(scope.source);
+        if (!reference)
+            return page;
+        const generated = makeSelectedPage(reference, scope.source, scope.directory, selector);
         register(generated);
         bulkSuppressed.add(scope.owner);
         return generated.slug;
@@ -155,7 +164,10 @@ export async function generateGraphqlDivisionsFromDocsConfig(docsConfig, loadSou
         const processed = await processChildren(node, { source, directory, owner: value });
         if (bulkSuppressed.has(value))
             return processed;
-        const generated = generatePages(await load(source), source, directory);
+        const reference = await load(source);
+        if (!reference)
+            return processed;
+        const generated = generatePages(reference, source, directory);
         const groups = [
             { group: 'Queries', pages: generated.queries.map(({ slug }) => slug) },
             { group: 'Mutations', pages: generated.mutations.map(({ slug }) => slug) },

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

@@ -91,16 +91,33 @@ function toGeneratedPage(page, config, directory, referenceSlugs, autogeneratedB
         ...(autogeneratedBySdk ? { autogeneratedBySdk: true } : {}),
     };
 }
+function prefixSdkGroup(group, directory) {
+    return {
+        group: group.group,
+        pages: group.pages.map((entry) => typeof entry === 'string'
+            ? path.posix.join(directory, entry)
+            : prefixSdkGroup(entry, directory)),
+    };
+}
+function collectSdkGroupSlugs(groups, slugs = new Set()) {
+    for (const group of groups) {
+        for (const entry of group.pages) {
+            if (typeof entry === 'string')
+                slugs.add(entry);
+            else
+                collectSdkGroupSlugs([entry], slugs);
+        }
+    }
+    return slugs;
+}
 function expandSdkGroups(reference, directory) {
     const pageBySlug = new Map(reference.pages.map((page) => [page.slug, page]));
-    const groups = reference.groups.map((group) => ({
-        group: group.group,
-        pages: group.pages.map((slug) => path.posix.join(directory, slug)),
-    }));
+    const groups = reference.groups.map((group) => prefixSdkGroup(group, directory));
+    const groupedSlugs = collectSdkGroupSlugs(reference.groups);
     const orphanedSlugs = reference.pages
         .filter((page) => !page.target?.parent)
         .map((page) => page.slug)
-        .filter((slug) => !reference.groups.some((group) => group.pages.includes(slug)));
+        .filter((slug) => !groupedSlugs.has(slug));
     if (orphanedSlugs.length > 0 && pageBySlug.size > 0) {
         groups.push({
             group: 'Reference',

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

@@ -44,4 +44,4 @@ export { generateAsyncApiFromDocsConfig } from './generateAsyncApiFromDocsConfig
 export { getCustomLanguages } from './getCustomLanguages.js';
 export { generateGraphqlDivisions, generateGraphqlDivisionsFromDocsConfig, getGraphqlRouteKey, isRemoteGraphqlSource, loadGraphqlSdlSource, loadRemoteGraphqlSdl, writeGraphqlArtifacts, } from './generateGraphqlDivisions.js';
 export { assertNoGeneratedRouteCollisions, getGeneratedRouteKey, } from './generatedRouteCollisions.js';
-export type { GeneratedGraphqlPage, GenerateGraphqlDivisionsResult, GraphqlSourceLoader, } from './generateGraphqlDivisions.js';
+export type { GeneratedGraphqlPage, GenerateGraphqlDivisionsOptions, GenerateGraphqlDivisionsResult, GraphqlSourceLoader, } from './generateGraphqlDivisions.js';