@mintlify/common 1.0.803 → 1.0.804

package/dist/openapi/getMatchingOpenApiFile.d.ts

@@ -0,0 +1,21 @@
+import { PageMetaTags } from '@mintlify/models';
+import { RefUuidMap, UUID } from '@mintlify/validation';
+export type FileToUuidMap = {
+    [originalFileLocation: string]: UUID;
+};
+export type UuidToRefsMap = {
+    [localUuid: UUID]: {
+        originalFileLocation: string;
+        filename: string;
+        refs: RefUuidMap;
+    };
+};
+export type ApiReferenceMapping = {
+    files: FileToUuidMap;
+    refs: UuidToRefsMap;
+};
+export declare const getMatchingOpenApiFile: ({ metadata, refs, files, }: {
+    metadata: PageMetaTags;
+    refs: UuidToRefsMap;
+    files: FileToUuidMap;
+}) => UUID | undefined;

package/dist/openapi/getMatchingOpenApiFile.js

@@ -0,0 +1,64 @@
+import { parseApiTargetFromMetadata } from '../api-reference/parseApiTargetFromMetadata.js';
+import { removeLeadingSlash } from '../fs/removeLeadingSlash.js';
+import { isAbsoluteUrl } from '../isAbsoluteUrl.js';
+export const getMatchingOpenApiFile = ({ metadata, refs, files, }) => {
+    const target = parseApiTargetFromMetadata(metadata);
+    if (!target || target.type === 'asyncapi') {
+        return undefined;
+    }
+    let targetPath = '';
+    if (target.type === 'operation') {
+        targetPath = `${target.endpoint}/${target.method}`;
+        // Want to make it explicit when we're doing what here, even
+        // if the conditional check is unnecessary.
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    }
+    else if (target.type === 'schema') {
+        targetPath = `#/components/schemas/${target.name}`;
+    }
+    const matchingUuids = findAllMatchingFileUuids({ refs, targetPath });
+    let filename = undefined;
+    let match = undefined;
+    if (target.filename) {
+        const trimmedFilename = isAbsoluteUrl(target.filename)
+            ? target.filename
+            : removeLeadingSlash(target.filename);
+        filename = trimmedFilename;
+    }
+    // match by original file location > filename > first match
+    if (filename) {
+        // try original file location match
+        if (files[filename]) {
+            const matchingUuid = files[filename];
+            if (matchingUuid && matchingUuids.includes(matchingUuid)) {
+                match = matchingUuid;
+            }
+        }
+        else {
+            // try filename match
+            for (const uuid of matchingUuids) {
+                if (refs[uuid] && refs[uuid].filename === filename) {
+                    match = uuid;
+                    break;
+                }
+            }
+            // filename is just wrong, return first match
+            if (!match) {
+                match = matchingUuids[0];
+            }
+        }
+    }
+    else {
+        match = matchingUuids[0];
+    }
+    return match;
+};
+const findAllMatchingFileUuids = ({ refs, targetPath, }) => {
+    const matchingUuids = [];
+    for (const [uuid, value] of Object.entries(refs)) {
+        if (value.refs[targetPath]) {
+            matchingUuids.push(uuid);
+        }
+    }
+    return matchingUuids;
+};

package/dist/openapi/index.d.ts

@@ -7,3 +7,4 @@ export { getOpenApiDocumentFromUrl } from './getOpenApiDocumentFromUrl.js';
 export { prepOpenApiFrontmatter } from './prepOpenApiFrontmatter.js';
 export { buildOpenApiMetaTag } from './buildOpenApiMetaTag.js';
 export { registerXMintContent, getXMintContent, getAllXMintContent } from './contentRegistry.js';
+export { getMatchingOpenApiFile, type ApiReferenceMapping, type FileToUuidMap, type UuidToRefsMap, } from './getMatchingOpenApiFile.js';

package/dist/openapi/index.js

@@ -7,3 +7,4 @@ export { getOpenApiDocumentFromUrl } from './getOpenApiDocumentFromUrl.js';
 export { prepOpenApiFrontmatter } from './prepOpenApiFrontmatter.js';
 export { buildOpenApiMetaTag } from './buildOpenApiMetaTag.js';
 export { registerXMintContent, getXMintContent, getAllXMintContent } from './contentRegistry.js';
+export { getMatchingOpenApiFile, } from './getMatchingOpenApiFile.js';