import { validate, DEFAULT_API_GROUP_NAME } from '@mintlify/common'; import type { DecoratedNavigation, DecoratedNavigationGroup, Navigation, NavigationGroup, DecoratedNavigationPage, } from '@mintlify/models'; import { OpenAPI } from 'openapi-types'; import { getOpenApiDefinition, GenerateOpenApiPagesOptions, OpenApiPageGenerationResult, processOpenApiPath, processOpenApiWebhook, } from './common.js'; export async function generateOpenApiPages( pathOrDocumentOrUrl: string | OpenAPI.Document | URL, opts?: GenerateOpenApiPagesOptions ): Promise> { const { document, isUrl } = await getOpenApiDefinition(pathOrDocumentOrUrl, opts?.localSchema); const { schema } = await validate(document); if ( schema?.openapi === '3.0.0' && (schema.paths === undefined || Object.keys(schema.paths).length === 0) ) { throw new Error('No paths defined.'); } else if ( schema?.openapi === '3.1.0' && (schema.paths === undefined || Object.keys(schema.paths).length === 0) && (schema.webhooks === undefined || Object.keys(schema.webhooks).length === 0) ) { throw new Error('No paths or webhooks defined.'); } const nav: Navigation = []; const decoratedNav: DecoratedNavigation = []; const writePromises: Promise[] = []; const pagesAcc: Record = {}; if (schema?.paths) { Object.entries(schema.paths).forEach(([path, pathItemObject]) => { if (!pathItemObject || typeof pathItemObject !== 'object') { return; } processOpenApiPath( path, pathItemObject, schema as OpenAPI.Document, nav, decoratedNav, writePromises, pagesAcc, opts ?? {}, findNavGroup ); }); } if (schema?.webhooks) { Object.entries(schema.webhooks).forEach(([webhook, webhookObject]) => { if (!webhookObject || typeof webhookObject !== 'object') { return; } processOpenApiWebhook( webhook, webhookObject, schema as OpenAPI.Document, nav, decoratedNav, writePromises, pagesAcc, opts ?? {}, findNavGroup ); }); } await Promise.all(writePromises); return { nav, decoratedNav, spec: schema as OpenAPI.Document, pagesAcc, isUrl, }; } const findNavGroup = ( nav: T['pages'][number][], groupName: string = DEFAULT_API_GROUP_NAME ): T['pages'][number][] => { const group = nav.find( (fileOrGroup) => typeof fileOrGroup === 'object' && 'group' in fileOrGroup && fileOrGroup.group === groupName ) as T | undefined; if (group === undefined) { const newGroup = { group: groupName, pages: [], }; nav.push(newGroup); return newGroup.pages; } else { return group.pages; } };