@redocly/cli 1.18.1 → 1.20.0

package/lib/commands/join.js

@@ -1,15 +1,6 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleJoin = void 0;
+exports.handleJoin = handleJoin;
 const path = require("path");
 const colorette_1 = require("colorette");
 const perf_hooks_1 = require("perf_hooks");
@@ -22,437 +13,433 @@ const split_1 = require("./split");
 const Tags = 'tags';
 const xTagGroups = 'x-tagGroups';
 let potentialConflictsTotal = 0;
-function handleJoin(argv, config, packageVersion) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const startedAt = perf_hooks_1.performance.now();
-        if (argv.apis.length < 2) {
-            return (0, miscellaneous_1.exitWithError)(`At least 2 apis should be provided.`);
-        }
-        const fileExtension = (0, miscellaneous_1.getAndValidateFileExtension)(argv.output || argv.apis[0]);
-        const { 'prefix-components-with-info-prop': prefixComponentsWithInfoProp, 'prefix-tags-with-filename': prefixTagsWithFilename, 'prefix-tags-with-info-prop': prefixTagsWithInfoProp, 'without-x-tag-groups': withoutXTagGroups, output: specFilename = `openapi.${fileExtension}`, } = argv;
-        const usedTagsOptions = [
-            prefixTagsWithFilename && 'prefix-tags-with-filename',
-            prefixTagsWithInfoProp && 'prefix-tags-with-info-prop',
-            withoutXTagGroups && 'without-x-tag-groups',
-        ].filter(Boolean);
-        if (usedTagsOptions.length > 1) {
-            return (0, miscellaneous_1.exitWithError)(`You use ${(0, colorette_1.yellow)(usedTagsOptions.join(', '))} together.\nPlease choose only one!`);
-        }
-        const apis = yield (0, miscellaneous_1.getFallbackApisOrExit)(argv.apis, config);
-        const externalRefResolver = new openapi_core_1.BaseResolver(config.resolve);
-        const documents = yield Promise.all(apis.map(({ path }) => externalRefResolver.resolveDocument(null, path, true)));
-        const decorators = new Set([
-            ...Object.keys(config.styleguide.decorators.oas3_0),
-            ...Object.keys(config.styleguide.decorators.oas3_1),
-            ...Object.keys(config.styleguide.decorators.oas2),
-        ]);
-        config.styleguide.skipDecorators(Array.from(decorators));
-        const preprocessors = new Set([
-            ...Object.keys(config.styleguide.preprocessors.oas3_0),
-            ...Object.keys(config.styleguide.preprocessors.oas3_1),
-            ...Object.keys(config.styleguide.preprocessors.oas2),
-        ]);
-        config.styleguide.skipPreprocessors(Array.from(preprocessors));
-        const bundleResults = yield Promise.all(documents.map((document) => (0, openapi_core_1.bundleDocument)({
-            document,
-            config: config.styleguide,
-            externalRefResolver: new openapi_core_1.BaseResolver(config.resolve),
-        }).catch((e) => {
-            (0, miscellaneous_1.exitWithError)(`${e.message}: ${(0, colorette_1.blue)(document.source.absoluteRef)}`);
-        })));
-        for (const { problems, bundle: document } of bundleResults) {
-            const fileTotals = (0, openapi_core_1.getTotals)(problems);
-            if (fileTotals.errors) {
-                (0, openapi_core_1.formatProblems)(problems, {
-                    totals: fileTotals,
-                    version: packageVersion,
-                });
-                (0, miscellaneous_1.exitWithError)(`❌ Errors encountered while bundling ${(0, colorette_1.blue)(document.source.absoluteRef)}: join will not proceed.`);
-            }
+async function handleJoin({ argv, config, version: packageVersion, }) {
+    const startedAt = perf_hooks_1.performance.now();
+    if (argv.apis.length < 2) {
+        return (0, miscellaneous_1.exitWithError)(`At least 2 apis should be provided.`);
+    }
+    const fileExtension = (0, miscellaneous_1.getAndValidateFileExtension)(argv.output || argv.apis[0]);
+    const { 'prefix-components-with-info-prop': prefixComponentsWithInfoProp, 'prefix-tags-with-filename': prefixTagsWithFilename, 'prefix-tags-with-info-prop': prefixTagsWithInfoProp, 'without-x-tag-groups': withoutXTagGroups, output: specFilename = `openapi.${fileExtension}`, } = argv;
+    const usedTagsOptions = [
+        prefixTagsWithFilename && 'prefix-tags-with-filename',
+        prefixTagsWithInfoProp && 'prefix-tags-with-info-prop',
+        withoutXTagGroups && 'without-x-tag-groups',
+    ].filter(Boolean);
+    if (usedTagsOptions.length > 1) {
+        return (0, miscellaneous_1.exitWithError)(`You use ${(0, colorette_1.yellow)(usedTagsOptions.join(', '))} together.\nPlease choose only one!`);
+    }
+    const apis = await (0, miscellaneous_1.getFallbackApisOrExit)(argv.apis, config);
+    const externalRefResolver = new openapi_core_1.BaseResolver(config.resolve);
+    const documents = await Promise.all(apis.map(({ path }) => externalRefResolver.resolveDocument(null, path, true)));
+    const decorators = new Set([
+        ...Object.keys(config.styleguide.decorators.oas3_0),
+        ...Object.keys(config.styleguide.decorators.oas3_1),
+        ...Object.keys(config.styleguide.decorators.oas2),
+    ]);
+    config.styleguide.skipDecorators(Array.from(decorators));
+    const preprocessors = new Set([
+        ...Object.keys(config.styleguide.preprocessors.oas3_0),
+        ...Object.keys(config.styleguide.preprocessors.oas3_1),
+        ...Object.keys(config.styleguide.preprocessors.oas2),
+    ]);
+    config.styleguide.skipPreprocessors(Array.from(preprocessors));
+    const bundleResults = await Promise.all(documents.map((document) => (0, openapi_core_1.bundleDocument)({
+        document,
+        config: config.styleguide,
+        externalRefResolver: new openapi_core_1.BaseResolver(config.resolve),
+    }).catch((e) => {
+        (0, miscellaneous_1.exitWithError)(`${e.message}: ${(0, colorette_1.blue)(document.source.absoluteRef)}`);
+    })));
+    for (const { problems, bundle: document } of bundleResults) {
+        const fileTotals = (0, openapi_core_1.getTotals)(problems);
+        if (fileTotals.errors) {
+            (0, openapi_core_1.formatProblems)(problems, {
+                totals: fileTotals,
+                version: packageVersion,
+            });
+            (0, miscellaneous_1.exitWithError)(`❌ Errors encountered while bundling ${(0, colorette_1.blue)(document.source.absoluteRef)}: join will not proceed.`);
         }
-        let oasVersion = null;
-        for (const document of documents) {
-            try {
-                const version = (0, openapi_core_1.detectSpec)(document.parsed);
-                if (version !== openapi_core_1.SpecVersion.OAS3_0 && version !== openapi_core_1.SpecVersion.OAS3_1) {
-                    return (0, miscellaneous_1.exitWithError)(`Only OpenAPI 3.0 and OpenAPI 3.1 are supported: ${(0, colorette_1.blue)(document.source.absoluteRef)}.`);
-                }
-                oasVersion = oasVersion !== null && oasVersion !== void 0 ? oasVersion : version;
-                if (oasVersion !== version) {
-                    return (0, miscellaneous_1.exitWithError)(`All APIs must use the same OpenAPI version: ${(0, colorette_1.blue)(document.source.absoluteRef)}.`);
-                }
+    }
+    let oasVersion = null;
+    for (const document of documents) {
+        try {
+            const version = (0, openapi_core_1.detectSpec)(document.parsed);
+            if (version !== openapi_core_1.SpecVersion.OAS3_0 && version !== openapi_core_1.SpecVersion.OAS3_1) {
+                return (0, miscellaneous_1.exitWithError)(`Only OpenAPI 3.0 and OpenAPI 3.1 are supported: ${(0, colorette_1.blue)(document.source.absoluteRef)}.`);
             }
-            catch (e) {
-                return (0, miscellaneous_1.exitWithError)(`${e.message}: ${(0, colorette_1.blue)(document.source.absoluteRef)}.`);
+            oasVersion = oasVersion ?? version;
+            if (oasVersion !== version) {
+                return (0, miscellaneous_1.exitWithError)(`All APIs must use the same OpenAPI version: ${(0, colorette_1.blue)(document.source.absoluteRef)}.`);
             }
         }
-        const joinedDef = {};
-        const potentialConflicts = {
-            tags: {},
-            paths: {},
-            components: {},
-            webhooks: {},
+        catch (e) {
+            return (0, miscellaneous_1.exitWithError)(`${e.message}: ${(0, colorette_1.blue)(document.source.absoluteRef)}.`);
+        }
+    }
+    const joinedDef = {};
+    const potentialConflicts = {
+        tags: {},
+        paths: {},
+        components: {},
+        webhooks: {},
+    };
+    addInfoSectionAndSpecVersion(documents, prefixComponentsWithInfoProp);
+    for (const document of documents) {
+        const openapi = document.parsed;
+        const { tags, info } = openapi;
+        const api = path.relative(process.cwd(), document.source.absoluteRef);
+        const apiFilename = getApiFilename(api);
+        const tagsPrefix = prefixTagsWithFilename
+            ? apiFilename
+            : getInfoPrefix(info, prefixTagsWithInfoProp, 'tags');
+        const componentsPrefix = getInfoPrefix(info, prefixComponentsWithInfoProp, types_1.COMPONENTS);
+        if (openapi.hasOwnProperty('x-tagGroups')) {
+            process.stderr.write((0, colorette_1.yellow)(`warning: x-tagGroups at ${(0, colorette_1.blue)(api)} will be skipped \n`));
+        }
+        const context = {
+            api,
+            apiFilename,
+            apiTitle: info?.title,
+            tags,
+            potentialConflicts,
+            tagsPrefix,
+            componentsPrefix,
         };
-        addInfoSectionAndSpecVersion(documents, prefixComponentsWithInfoProp);
-        for (const document of documents) {
-            const openapi = document.parsed;
-            const { tags, info } = openapi;
-            const api = path.relative(process.cwd(), document.source.absoluteRef);
-            const apiFilename = getApiFilename(api);
-            const tagsPrefix = prefixTagsWithFilename
-                ? apiFilename
-                : getInfoPrefix(info, prefixTagsWithInfoProp, 'tags');
-            const componentsPrefix = getInfoPrefix(info, prefixComponentsWithInfoProp, types_1.COMPONENTS);
-            if (openapi.hasOwnProperty('x-tagGroups')) {
-                process.stderr.write((0, colorette_1.yellow)(`warning: x-tagGroups at ${(0, colorette_1.blue)(api)} will be skipped \n`));
-            }
-            const context = {
-                api,
-                apiFilename,
-                apiTitle: info === null || info === void 0 ? void 0 : info.title,
-                tags,
-                potentialConflicts,
-                tagsPrefix,
-                componentsPrefix,
-            };
-            if (tags) {
-                populateTags(context);
-            }
-            collectServers(openapi);
-            collectExternalDocs(openapi, context);
-            collectPaths(openapi, context);
-            collectComponents(openapi, context);
-            collectWebhooks(oasVersion, openapi, context);
-            if (componentsPrefix) {
-                replace$Refs(openapi, componentsPrefix);
-            }
+        if (tags) {
+            populateTags(context);
         }
-        iteratePotentialConflicts(potentialConflicts, withoutXTagGroups);
-        const noRefs = true;
-        if (potentialConflictsTotal) {
-            return (0, miscellaneous_1.exitWithError)(`Please fix conflicts before running ${(0, colorette_1.yellow)('join')}.`);
+        collectServers(openapi);
+        collectExternalDocs(openapi, context);
+        collectPaths(openapi, context);
+        collectComponents(openapi, context);
+        collectWebhooks(oasVersion, openapi, context);
+        if (componentsPrefix) {
+            replace$Refs(openapi, componentsPrefix);
         }
-        (0, miscellaneous_1.writeToFileByExtension)((0, miscellaneous_1.sortTopLevelKeysForOas)(joinedDef), specFilename, noRefs);
-        (0, miscellaneous_1.printExecutionTime)('join', startedAt, specFilename);
-        function populateTags({ api, apiFilename, apiTitle, tags, potentialConflicts, tagsPrefix, componentsPrefix, }) {
-            if (!joinedDef.hasOwnProperty(Tags)) {
-                joinedDef[Tags] = [];
-            }
-            if (!potentialConflicts.tags.hasOwnProperty('all')) {
-                potentialConflicts.tags['all'] = {};
+    }
+    iteratePotentialConflicts(potentialConflicts, withoutXTagGroups);
+    const noRefs = true;
+    if (potentialConflictsTotal) {
+        return (0, miscellaneous_1.exitWithError)(`Please fix conflicts before running ${(0, colorette_1.yellow)('join')}.`);
+    }
+    (0, miscellaneous_1.writeToFileByExtension)((0, miscellaneous_1.sortTopLevelKeysForOas)(joinedDef), specFilename, noRefs);
+    (0, miscellaneous_1.printExecutionTime)('join', startedAt, specFilename);
+    function populateTags({ api, apiFilename, apiTitle, tags, potentialConflicts, tagsPrefix, componentsPrefix, }) {
+        if (!joinedDef.hasOwnProperty(Tags)) {
+            joinedDef[Tags] = [];
+        }
+        if (!potentialConflicts.tags.hasOwnProperty('all')) {
+            potentialConflicts.tags['all'] = {};
+        }
+        if (withoutXTagGroups && !potentialConflicts.tags.hasOwnProperty('description')) {
+            potentialConflicts.tags['description'] = {};
+        }
+        for (const tag of tags) {
+            const entrypointTagName = addPrefix(tag.name, tagsPrefix);
+            if (tag.description) {
+                tag.description = addComponentsPrefix(tag.description, componentsPrefix);
             }
-            if (withoutXTagGroups && !potentialConflicts.tags.hasOwnProperty('description')) {
-                potentialConflicts.tags['description'] = {};
+            const tagDuplicate = joinedDef.tags.find((t) => t.name === entrypointTagName);
+            if (tagDuplicate && withoutXTagGroups) {
+                // If tag already exist and `without-x-tag-groups` option,
+                // check if description are different for potential conflicts warning.
+                const isTagDescriptionNotEqual = tag.hasOwnProperty('description') && tagDuplicate.description !== tag.description;
+                potentialConflicts.tags.description[entrypointTagName].push(...(isTagDescriptionNotEqual ? [api] : []));
             }
-            for (const tag of tags) {
-                const entrypointTagName = addPrefix(tag.name, tagsPrefix);
-                if (tag.description) {
-                    tag.description = addComponentsPrefix(tag.description, componentsPrefix);
-                }
-                const tagDuplicate = joinedDef.tags.find((t) => t.name === entrypointTagName);
-                if (tagDuplicate && withoutXTagGroups) {
-                    // If tag already exist and `without-x-tag-groups` option,
-                    // check if description are different for potential conflicts warning.
-                    const isTagDescriptionNotEqual = tag.hasOwnProperty('description') && tagDuplicate.description !== tag.description;
-                    potentialConflicts.tags.description[entrypointTagName].push(...(isTagDescriptionNotEqual ? [api] : []));
+            else if (!tagDuplicate) {
+                // Instead add tag to joinedDef if there no duplicate;
+                tag['x-displayName'] = tag['x-displayName'] || tag.name;
+                tag.name = entrypointTagName;
+                joinedDef.tags.push(tag);
+                if (withoutXTagGroups) {
+                    potentialConflicts.tags.description[entrypointTagName] = [api];
                 }
-                else if (!tagDuplicate) {
-                    // Instead add tag to joinedDef if there no duplicate;
-                    tag['x-displayName'] = tag['x-displayName'] || tag.name;
-                    tag.name = entrypointTagName;
-                    joinedDef.tags.push(tag);
-                    if (withoutXTagGroups) {
-                        potentialConflicts.tags.description[entrypointTagName] = [api];
-                    }
-                }
-                if (!withoutXTagGroups) {
-                    const groupName = apiTitle || apiFilename;
-                    createXTagGroups(groupName);
-                    if (!tagDuplicate) {
-                        populateXTagGroups(entrypointTagName, getIndexGroup(groupName));
-                    }
+            }
+            if (!withoutXTagGroups) {
+                const groupName = apiTitle || apiFilename;
+                createXTagGroups(groupName);
+                if (!tagDuplicate) {
+                    populateXTagGroups(entrypointTagName, getIndexGroup(groupName));
                 }
-                const doesEntrypointExist = !potentialConflicts.tags.all[entrypointTagName] ||
-                    (potentialConflicts.tags.all[entrypointTagName] &&
-                        !potentialConflicts.tags.all[entrypointTagName].includes(api));
-                potentialConflicts.tags.all[entrypointTagName] = [
-                    ...(potentialConflicts.tags.all[entrypointTagName] || []),
-                    ...(!withoutXTagGroups && doesEntrypointExist ? [api] : []),
-                ];
             }
+            const doesEntrypointExist = !potentialConflicts.tags.all[entrypointTagName] ||
+                (potentialConflicts.tags.all[entrypointTagName] &&
+                    !potentialConflicts.tags.all[entrypointTagName].includes(api));
+            potentialConflicts.tags.all[entrypointTagName] = [
+                ...(potentialConflicts.tags.all[entrypointTagName] || []),
+                ...(!withoutXTagGroups && doesEntrypointExist ? [api] : []),
+            ];
         }
-        function getIndexGroup(name) {
-            return joinedDef[xTagGroups].findIndex((item) => item.name === name);
+    }
+    function getIndexGroup(name) {
+        return joinedDef[xTagGroups].findIndex((item) => item.name === name);
+    }
+    function createXTagGroups(name) {
+        if (!joinedDef.hasOwnProperty(xTagGroups)) {
+            joinedDef[xTagGroups] = [];
         }
-        function createXTagGroups(name) {
-            if (!joinedDef.hasOwnProperty(xTagGroups)) {
-                joinedDef[xTagGroups] = [];
-            }
-            if (!joinedDef[xTagGroups].some((g) => g.name === name)) {
-                joinedDef[xTagGroups].push({ name, tags: [] });
-            }
-            const indexGroup = getIndexGroup(name);
-            if (!joinedDef[xTagGroups][indexGroup].hasOwnProperty(Tags)) {
-                joinedDef[xTagGroups][indexGroup][Tags] = [];
-            }
+        if (!joinedDef[xTagGroups].some((g) => g.name === name)) {
+            joinedDef[xTagGroups].push({ name, tags: [] });
         }
-        function populateXTagGroups(entrypointTagName, indexGroup) {
-            if (!joinedDef[xTagGroups][indexGroup][Tags].find((t) => t.name === entrypointTagName)) {
-                joinedDef[xTagGroups][indexGroup][Tags].push(entrypointTagName);
-            }
+        const indexGroup = getIndexGroup(name);
+        if (!joinedDef[xTagGroups][indexGroup].hasOwnProperty(Tags)) {
+            joinedDef[xTagGroups][indexGroup][Tags] = [];
         }
-        function collectServers(openapi) {
-            const { servers } = openapi;
-            if (servers) {
-                if (!joinedDef.hasOwnProperty('servers')) {
-                    joinedDef['servers'] = [];
-                }
-                for (const server of servers) {
-                    if (!joinedDef.servers.some((s) => s.url === server.url)) {
-                        joinedDef.servers.push(server);
-                    }
+    }
+    function populateXTagGroups(entrypointTagName, indexGroup) {
+        if (!joinedDef[xTagGroups][indexGroup][Tags].find((t) => t.name === entrypointTagName)) {
+            joinedDef[xTagGroups][indexGroup][Tags].push(entrypointTagName);
+        }
+    }
+    function collectServers(openapi) {
+        const { servers } = openapi;
+        if (servers) {
+            if (!joinedDef.hasOwnProperty('servers')) {
+                joinedDef['servers'] = [];
+            }
+            for (const server of servers) {
+                if (!joinedDef.servers.some((s) => s.url === server.url)) {
+                    joinedDef.servers.push(server);
                 }
             }
         }
-        function collectExternalDocs(openapi, { api }) {
-            const { externalDocs } = openapi;
-            if (externalDocs) {
-                if (joinedDef.hasOwnProperty('externalDocs')) {
-                    process.stderr.write((0, colorette_1.yellow)(`warning: skip externalDocs from ${(0, colorette_1.blue)(path.basename(api))} \n`));
-                    return;
-                }
-                joinedDef['externalDocs'] = externalDocs;
+    }
+    function collectExternalDocs(openapi, { api }) {
+        const { externalDocs } = openapi;
+        if (externalDocs) {
+            if (joinedDef.hasOwnProperty('externalDocs')) {
+                process.stderr.write((0, colorette_1.yellow)(`warning: skip externalDocs from ${(0, colorette_1.blue)(path.basename(api))} \n`));
+                return;
             }
+            joinedDef['externalDocs'] = externalDocs;
         }
-        function collectPaths(openapi, { apiFilename, apiTitle, api, potentialConflicts, tagsPrefix, componentsPrefix, }) {
-            const { paths } = openapi;
-            const operationsSet = new Set((0, js_utils_1.keysOf)(types_1.OPENAPI3_METHOD));
-            if (paths) {
-                if (!joinedDef.hasOwnProperty('paths')) {
-                    joinedDef['paths'] = {};
+    }
+    function collectPaths(openapi, { apiFilename, apiTitle, api, potentialConflicts, tagsPrefix, componentsPrefix, }) {
+        const { paths } = openapi;
+        const operationsSet = new Set((0, js_utils_1.keysOf)(types_1.OPENAPI3_METHOD));
+        if (paths) {
+            if (!joinedDef.hasOwnProperty('paths')) {
+                joinedDef['paths'] = {};
+            }
+            for (const path of (0, js_utils_1.keysOf)(paths)) {
+                if (!joinedDef.paths.hasOwnProperty(path)) {
+                    joinedDef.paths[path] = {};
+                }
+                if (!potentialConflicts.paths.hasOwnProperty(path)) {
+                    potentialConflicts.paths[path] = {};
                 }
-                for (const path of (0, js_utils_1.keysOf)(paths)) {
-                    if (!joinedDef.paths.hasOwnProperty(path)) {
-                        joinedDef.paths[path] = {};
+                const pathItem = paths[path];
+                for (const field of (0, js_utils_1.keysOf)(pathItem)) {
+                    if (operationsSet.has(field)) {
+                        collectPathOperation(pathItem, path, field);
                     }
-                    if (!potentialConflicts.paths.hasOwnProperty(path)) {
-                        potentialConflicts.paths[path] = {};
+                    if (field === 'servers') {
+                        collectPathServers(pathItem, path);
                     }
-                    const pathItem = paths[path];
-                    for (const field of (0, js_utils_1.keysOf)(pathItem)) {
-                        if (operationsSet.has(field)) {
-                            collectPathOperation(pathItem, path, field);
-                        }
-                        if (field === 'servers') {
-                            collectPathServers(pathItem, path);
-                        }
-                        if (field === 'parameters') {
-                            collectPathParameters(pathItem, path);
-                        }
-                        if (typeof pathItem[field] === 'string') {
-                            collectPathStringFields(pathItem, path, field);
-                        }
+                    if (field === 'parameters') {
+                        collectPathParameters(pathItem, path);
+                    }
+                    if (typeof pathItem[field] === 'string') {
+                        collectPathStringFields(pathItem, path, field);
                     }
                 }
             }
-            function collectPathStringFields(pathItem, path, field) {
-                const fieldValue = pathItem[field];
-                if (joinedDef.paths[path].hasOwnProperty(field) &&
-                    joinedDef.paths[path][field] !== fieldValue) {
-                    process.stderr.write((0, colorette_1.yellow)(`warning: different ${field} values in ${path}\n`));
-                    return;
-                }
-                joinedDef.paths[path][field] = fieldValue;
+        }
+        function collectPathStringFields(pathItem, path, field) {
+            const fieldValue = pathItem[field];
+            if (joinedDef.paths[path].hasOwnProperty(field) &&
+                joinedDef.paths[path][field] !== fieldValue) {
+                process.stderr.write((0, colorette_1.yellow)(`warning: different ${field} values in ${path}\n`));
+                return;
             }
-            function collectPathServers(pathItem, path) {
-                if (!pathItem.servers) {
-                    return;
-                }
-                if (!joinedDef.paths[path].hasOwnProperty('servers')) {
-                    joinedDef.paths[path].servers = [];
-                }
-                for (const server of pathItem.servers) {
-                    let isFoundServer = false;
-                    for (const pathServer of joinedDef.paths[path].servers) {
-                        if (pathServer.url === server.url) {
-                            if (!isServersEqual(pathServer, server)) {
-                                (0, miscellaneous_1.exitWithError)(`Different server values for (${server.url}) in ${path}.`);
-                            }
-                            isFoundServer = true;
+            joinedDef.paths[path][field] = fieldValue;
+        }
+        function collectPathServers(pathItem, path) {
+            if (!pathItem.servers) {
+                return;
+            }
+            if (!joinedDef.paths[path].hasOwnProperty('servers')) {
+                joinedDef.paths[path].servers = [];
+            }
+            for (const server of pathItem.servers) {
+                let isFoundServer = false;
+                for (const pathServer of joinedDef.paths[path].servers) {
+                    if (pathServer.url === server.url) {
+                        if (!isServersEqual(pathServer, server)) {
+                            (0, miscellaneous_1.exitWithError)(`Different server values for (${server.url}) in ${path}.`);
                         }
-                    }
-                    if (!isFoundServer) {
-                        joinedDef.paths[path].servers.push(server);
+                        isFoundServer = true;
                     }
                 }
-            }
-            function collectPathParameters(pathItem, path) {
-                if (!pathItem.parameters) {
-                    return;
-                }
-                if (!joinedDef.paths[path].hasOwnProperty('parameters')) {
-                    joinedDef.paths[path].parameters = [];
+                if (!isFoundServer) {
+                    joinedDef.paths[path].servers.push(server);
                 }
-                for (const parameter of pathItem.parameters) {
-                    let isFoundParameter = false;
-                    for (const pathParameter of joinedDef.paths[path]
-                        .parameters) {
-                        // Compare $ref only if both are reference objects
-                        if ((0, openapi_core_1.isRef)(pathParameter) && (0, openapi_core_1.isRef)(parameter)) {
-                            if (pathParameter['$ref'] === parameter['$ref']) {
-                                isFoundParameter = true;
-                            }
+            }
+        }
+        function collectPathParameters(pathItem, path) {
+            if (!pathItem.parameters) {
+                return;
+            }
+            if (!joinedDef.paths[path].hasOwnProperty('parameters')) {
+                joinedDef.paths[path].parameters = [];
+            }
+            for (const parameter of pathItem.parameters) {
+                let isFoundParameter = false;
+                for (const pathParameter of joinedDef.paths[path]
+                    .parameters) {
+                    // Compare $ref only if both are reference objects
+                    if ((0, openapi_core_1.isRef)(pathParameter) && (0, openapi_core_1.isRef)(parameter)) {
+                        if (pathParameter['$ref'] === parameter['$ref']) {
+                            isFoundParameter = true;
                         }
-                        // Compare properties only if both are reference objects
-                        if (!(0, openapi_core_1.isRef)(pathParameter) && !(0, openapi_core_1.isRef)(parameter)) {
-                            if (pathParameter.name === parameter.name && pathParameter.in === parameter.in) {
-                                if (!(0, utils_1.dequal)(pathParameter.schema, parameter.schema)) {
-                                    (0, miscellaneous_1.exitWithError)(`Different parameter schemas for (${parameter.name}) in ${path}.`);
-                                }
-                                isFoundParameter = true;
+                    }
+                    // Compare properties only if both are reference objects
+                    if (!(0, openapi_core_1.isRef)(pathParameter) && !(0, openapi_core_1.isRef)(parameter)) {
+                        if (pathParameter.name === parameter.name && pathParameter.in === parameter.in) {
+                            if (!(0, utils_1.dequal)(pathParameter.schema, parameter.schema)) {
+                                (0, miscellaneous_1.exitWithError)(`Different parameter schemas for (${parameter.name}) in ${path}.`);
                             }
+                            isFoundParameter = true;
                         }
                     }
-                    if (!isFoundParameter) {
-                        joinedDef.paths[path].parameters.push(parameter);
-                    }
                 }
-            }
-            function collectPathOperation(pathItem, path, operation) {
-                const pathOperation = pathItem[operation];
-                if (!pathOperation) {
-                    return;
+                if (!isFoundParameter) {
+                    joinedDef.paths[path].parameters.push(parameter);
                 }
-                joinedDef.paths[path][operation] = pathOperation;
-                potentialConflicts.paths[path][operation] = [
-                    ...(potentialConflicts.paths[path][operation] || []),
+            }
+        }
+        function collectPathOperation(pathItem, path, operation) {
+            const pathOperation = pathItem[operation];
+            if (!pathOperation) {
+                return;
+            }
+            joinedDef.paths[path][operation] = pathOperation;
+            potentialConflicts.paths[path][operation] = [
+                ...(potentialConflicts.paths[path][operation] || []),
+                api,
+            ];
+            const { operationId } = pathOperation;
+            if (operationId) {
+                if (!potentialConflicts.paths.hasOwnProperty('operationIds')) {
+                    potentialConflicts.paths['operationIds'] = {};
+                }
+                potentialConflicts.paths.operationIds[operationId] = [
+                    ...(potentialConflicts.paths.operationIds[operationId] || []),
                     api,
                 ];
-                const { operationId } = pathOperation;
-                if (operationId) {
-                    if (!potentialConflicts.paths.hasOwnProperty('operationIds')) {
-                        potentialConflicts.paths['operationIds'] = {};
-                    }
-                    potentialConflicts.paths.operationIds[operationId] = [
-                        ...(potentialConflicts.paths.operationIds[operationId] || []),
-                        api,
-                    ];
-                }
-                const { tags, security } = joinedDef.paths[path][operation];
-                if (tags) {
-                    joinedDef.paths[path][operation].tags = tags.map((tag) => addPrefix(tag, tagsPrefix));
-                    populateTags({
-                        api,
-                        apiFilename,
-                        apiTitle,
-                        tags: formatTags(tags),
-                        potentialConflicts,
-                        tagsPrefix,
-                        componentsPrefix,
-                    });
-                }
-                else {
-                    joinedDef.paths[path][operation]['tags'] = [addPrefix('other', tagsPrefix || apiFilename)];
-                    populateTags({
-                        api,
-                        apiFilename,
-                        apiTitle,
-                        tags: formatTags(['other']),
-                        potentialConflicts,
-                        tagsPrefix: tagsPrefix || apiFilename,
-                        componentsPrefix,
-                    });
-                }
-                if (!security && openapi.hasOwnProperty('security')) {
-                    joinedDef.paths[path][operation]['security'] = addSecurityPrefix(openapi.security, componentsPrefix);
-                }
-                else if (pathOperation.security) {
-                    joinedDef.paths[path][operation].security = addSecurityPrefix(pathOperation.security, componentsPrefix);
-                }
             }
-        }
-        function isServersEqual(serverOne, serverTwo) {
-            if (serverOne.description === serverTwo.description) {
-                return (0, utils_1.dequal)(serverOne.variables, serverTwo.variables);
+            const { tags, security } = joinedDef.paths[path][operation];
+            if (tags) {
+                joinedDef.paths[path][operation].tags = tags.map((tag) => addPrefix(tag, tagsPrefix));
+                populateTags({
+                    api,
+                    apiFilename,
+                    apiTitle,
+                    tags: formatTags(tags),
+                    potentialConflicts,
+                    tagsPrefix,
+                    componentsPrefix,
+                });
+            }
+            else {
+                joinedDef.paths[path][operation]['tags'] = [addPrefix('other', tagsPrefix || apiFilename)];
+                populateTags({
+                    api,
+                    apiFilename,
+                    apiTitle,
+                    tags: formatTags(['other']),
+                    potentialConflicts,
+                    tagsPrefix: tagsPrefix || apiFilename,
+                    componentsPrefix,
+                });
+            }
+            if (!security && openapi.hasOwnProperty('security')) {
+                joinedDef.paths[path][operation]['security'] = addSecurityPrefix(openapi.security, componentsPrefix);
+            }
+            else if (pathOperation.security) {
+                joinedDef.paths[path][operation].security = addSecurityPrefix(pathOperation.security, componentsPrefix);
             }
-            return false;
         }
-        function collectComponents(openapi, { api, potentialConflicts, componentsPrefix }) {
-            const { components } = openapi;
-            if (components) {
-                if (!joinedDef.hasOwnProperty(types_1.COMPONENTS)) {
-                    joinedDef[types_1.COMPONENTS] = {};
-                }
-                for (const [component, componentObj] of Object.entries(components)) {
-                    if (!potentialConflicts[types_1.COMPONENTS].hasOwnProperty(component)) {
-                        potentialConflicts[types_1.COMPONENTS][component] = {};
-                        joinedDef[types_1.COMPONENTS][component] = {};
-                    }
-                    for (const item of Object.keys(componentObj)) {
-                        const componentPrefix = addPrefix(item, componentsPrefix);
-                        potentialConflicts.components[component][componentPrefix] = [
-                            ...(potentialConflicts.components[component][item] || []),
-                            { [api]: componentObj[item] },
-                        ];
-                        joinedDef.components[component][componentPrefix] = componentObj[item];
-                    }
+    }
+    function isServersEqual(serverOne, serverTwo) {
+        if (serverOne.description === serverTwo.description) {
+            return (0, utils_1.dequal)(serverOne.variables, serverTwo.variables);
+        }
+        return false;
+    }
+    function collectComponents(openapi, { api, potentialConflicts, componentsPrefix }) {
+        const { components } = openapi;
+        if (components) {
+            if (!joinedDef.hasOwnProperty(types_1.COMPONENTS)) {
+                joinedDef[types_1.COMPONENTS] = {};
+            }
+            for (const [component, componentObj] of Object.entries(components)) {
+                if (!potentialConflicts[types_1.COMPONENTS].hasOwnProperty(component)) {
+                    potentialConflicts[types_1.COMPONENTS][component] = {};
+                    joinedDef[types_1.COMPONENTS][component] = {};
+                }
+                for (const item of Object.keys(componentObj)) {
+                    const componentPrefix = addPrefix(item, componentsPrefix);
+                    potentialConflicts.components[component][componentPrefix] = [
+                        ...(potentialConflicts.components[component][item] || []),
+                        { [api]: componentObj[item] },
+                    ];
+                    joinedDef.components[component][componentPrefix] = componentObj[item];
                 }
             }
         }
-        function collectWebhooks(oasVersion, openapi, { apiFilename, apiTitle, api, potentialConflicts, tagsPrefix, componentsPrefix, }) {
-            const webhooks = oasVersion === openapi_core_1.SpecVersion.OAS3_1 ? 'webhooks' : 'x-webhooks';
-            const openapiWebhooks = openapi[webhooks];
-            if (openapiWebhooks) {
-                if (!joinedDef.hasOwnProperty(webhooks)) {
-                    joinedDef[webhooks] = {};
+    }
+    function collectWebhooks(oasVersion, openapi, { apiFilename, apiTitle, api, potentialConflicts, tagsPrefix, componentsPrefix, }) {
+        const webhooks = oasVersion === openapi_core_1.SpecVersion.OAS3_1 ? 'webhooks' : 'x-webhooks';
+        const openapiWebhooks = openapi[webhooks];
+        if (openapiWebhooks) {
+            if (!joinedDef.hasOwnProperty(webhooks)) {
+                joinedDef[webhooks] = {};
+            }
+            for (const webhook of Object.keys(openapiWebhooks)) {
+                joinedDef[webhooks][webhook] = openapiWebhooks[webhook];
+                if (!potentialConflicts.webhooks.hasOwnProperty(webhook)) {
+                    potentialConflicts.webhooks[webhook] = {};
+                }
+                for (const operation of Object.keys(openapiWebhooks[webhook])) {
+                    potentialConflicts.webhooks[webhook][operation] = [
+                        ...(potentialConflicts.webhooks[webhook][operation] || []),
+                        api,
+                    ];
                 }
-                for (const webhook of Object.keys(openapiWebhooks)) {
-                    joinedDef[webhooks][webhook] = openapiWebhooks[webhook];
-                    if (!potentialConflicts.webhooks.hasOwnProperty(webhook)) {
-                        potentialConflicts.webhooks[webhook] = {};
-                    }
-                    for (const operation of Object.keys(openapiWebhooks[webhook])) {
-                        potentialConflicts.webhooks[webhook][operation] = [
-                            ...(potentialConflicts.webhooks[webhook][operation] || []),
+                for (const operationKey of Object.keys(joinedDef[webhooks][webhook])) {
+                    const { tags } = joinedDef[webhooks][webhook][operationKey];
+                    if (tags) {
+                        joinedDef[webhooks][webhook][operationKey].tags = tags.map((tag) => addPrefix(tag, tagsPrefix));
+                        populateTags({
                             api,
-                        ];
-                    }
-                    for (const operationKey of Object.keys(joinedDef[webhooks][webhook])) {
-                        const { tags } = joinedDef[webhooks][webhook][operationKey];
-                        if (tags) {
-                            joinedDef[webhooks][webhook][operationKey].tags = tags.map((tag) => addPrefix(tag, tagsPrefix));
-                            populateTags({
-                                api,
-                                apiFilename,
-                                apiTitle,
-                                tags: formatTags(tags),
-                                potentialConflicts,
-                                tagsPrefix,
-                                componentsPrefix,
-                            });
-                        }
+                            apiFilename,
+                            apiTitle,
+                            tags: formatTags(tags),
+                            potentialConflicts,
+                            tagsPrefix,
+                            componentsPrefix,
+                        });
                     }
                 }
             }
         }
-        function addInfoSectionAndSpecVersion(documents, prefixComponentsWithInfoProp) {
-            var _a;
-            const firstApi = documents[0];
-            const openapi = firstApi.parsed;
-            const componentsPrefix = getInfoPrefix(openapi.info, prefixComponentsWithInfoProp, types_1.COMPONENTS);
-            if (!openapi.openapi)
-                (0, miscellaneous_1.exitWithError)('Version of specification is not found.');
-            if (!openapi.info)
-                (0, miscellaneous_1.exitWithError)('Info section is not found in specification.');
-            if ((_a = openapi.info) === null || _a === void 0 ? void 0 : _a.description) {
-                openapi.info.description = addComponentsPrefix(openapi.info.description, componentsPrefix);
-            }
-            joinedDef.openapi = openapi.openapi;
-            joinedDef.info = openapi.info;
+    }
+    function addInfoSectionAndSpecVersion(documents, prefixComponentsWithInfoProp) {
+        const firstApi = documents[0];
+        const openapi = firstApi.parsed;
+        const componentsPrefix = getInfoPrefix(openapi.info, prefixComponentsWithInfoProp, types_1.COMPONENTS);
+        if (!openapi.openapi)
+            (0, miscellaneous_1.exitWithError)('Version of specification is not found.');
+        if (!openapi.info)
+            (0, miscellaneous_1.exitWithError)('Info section is not found in specification.');
+        if (openapi.info?.description) {
+            openapi.info.description = addComponentsPrefix(openapi.info.description, componentsPrefix);
         }
-    });
+        joinedDef.openapi = openapi.openapi;
+        joinedDef.info = openapi.info;
+    }
 }
-exports.handleJoin = handleJoin;
 function doesComponentsDiffer(curr, next) {
     return !(0, utils_1.dequal)(Object.values(curr)[0], Object.values(next)[0]);
 }
@@ -529,7 +516,7 @@ function addComponentsPrefix(description, componentsPrefix) {
 }
 function addSecurityPrefix(security, componentsPrefix) {
     return componentsPrefix
-        ? security === null || security === void 0 ? void 0 : security.map((s) => {
+        ? security?.map((s) => {
             const joinedSecuritySchema = {};
             for (const [key, value] of Object.entries(s)) {
                 Object.assign(joinedSecuritySchema, { [componentsPrefix + '_' + key]: value });