@redocly/cli 1.2.1 → 1.4.0

package/lib/commands/split/index.js

@@ -24,24 +24,25 @@ function handleSplit(argv) {
         const startedAt = perf_hooks_1.performance.now();
         const { api, outDir, separator } = argv;
         validateDefinitionFileName(api);
-        const openapi = utils_1.readYaml(api);
-        splitDefinition(openapi, outDir, separator);
-        process.stderr.write(`🪓 Document: ${colorette_1.blue(api)} ${colorette_1.green('is successfully split')}
-    and all related files are saved to the directory: ${colorette_1.blue(outDir)} \n`);
-        utils_1.printExecutionTime('split', startedAt, api);
+        const ext = (0, utils_1.getAndValidateFileExtension)(api);
+        const openapi = (0, utils_1.readYaml)(api);
+        splitDefinition(openapi, outDir, separator, ext);
+        process.stderr.write(`🪓 Document: ${(0, colorette_1.blue)(api)} ${(0, colorette_1.green)('is successfully split')}
+    and all related files are saved to the directory: ${(0, colorette_1.blue)(outDir)} \n`);
+        (0, utils_1.printExecutionTime)('split', startedAt, api);
     });
 }
 exports.handleSplit = handleSplit;
-function splitDefinition(openapi, openapiDir, pathSeparator) {
+function splitDefinition(openapi, openapiDir, pathSeparator, ext) {
     fs.mkdirSync(openapiDir, { recursive: true });
     const componentsFiles = {};
-    iterateComponents(openapi, openapiDir, componentsFiles);
-    iteratePathItems(openapi.paths, openapiDir, path.join(openapiDir, 'paths'), componentsFiles, pathSeparator);
+    iterateComponents(openapi, openapiDir, componentsFiles, ext);
+    iteratePathItems(openapi.paths, openapiDir, path.join(openapiDir, 'paths'), componentsFiles, pathSeparator, undefined, ext);
     const webhooks = openapi.webhooks || openapi['x-webhooks'];
     // use webhook_ prefix for code samples to prevent potential name-clashes with paths samples
-    iteratePathItems(webhooks, openapiDir, path.join(openapiDir, 'webhooks'), componentsFiles, pathSeparator, 'webhook_');
+    iteratePathItems(webhooks, openapiDir, path.join(openapiDir, 'webhooks'), componentsFiles, pathSeparator, 'webhook_', ext);
     replace$Refs(openapi, openapiDir, componentsFiles);
-    utils_1.writeYaml(openapi, path.join(openapiDir, 'openapi.yaml'));
+    (0, utils_1.writeToFileByExtension)(openapi, path.join(openapiDir, `openapi.${ext}`));
 }
 function isStartsWithComponents(node) {
     return node.startsWith(types_1.componentsPath);
@@ -51,20 +52,20 @@ function isNotYaml(filename) {
 }
 function loadFile(fileName) {
     try {
-        return openapi_core_1.parseYaml(fs.readFileSync(fileName, 'utf8'));
+        return (0, openapi_core_1.parseYaml)(fs.readFileSync(fileName, 'utf8'));
     }
     catch (e) {
-        return utils_1.exitWithError(e.message);
+        return (0, utils_1.exitWithError)(e.message);
     }
 }
 function validateDefinitionFileName(fileName) {
     if (!fs.existsSync(fileName))
-        utils_1.exitWithError(`File ${colorette_1.blue(fileName)} does not exist \n`);
+        (0, utils_1.exitWithError)(`File ${(0, colorette_1.blue)(fileName)} does not exist \n`);
     const file = loadFile(fileName);
     if (file.swagger)
-        utils_1.exitWithError('OpenAPI 2 is not supported by this command');
+        (0, utils_1.exitWithError)('OpenAPI 2 is not supported by this command');
     if (!file.openapi)
-        utils_1.exitWithError('File does not conform to the OpenAPI Specification. OpenAPI version is not specified');
+        (0, utils_1.exitWithError)('File does not conform to the OpenAPI Specification. OpenAPI version is not specified');
     return true;
 }
 function traverseDirectoryDeep(directory, callback, componentsFiles) {
@@ -84,12 +85,12 @@ function traverseDirectoryDeep(directory, callback, componentsFiles) {
 function traverseDirectoryDeepCallback(filename, directory, componentsFiles) {
     if (isNotYaml(filename))
         return;
-    const pathData = utils_1.readYaml(filename);
+    const pathData = (0, utils_1.readYaml)(filename);
     replace$Refs(pathData, directory, componentsFiles);
-    utils_1.writeYaml(pathData, filename);
+    (0, utils_1.writeToFileByExtension)(pathData, filename);
 }
 function crawl(object, visitor) {
-    if (!js_utils_1.isObject(object))
+    if (!(0, js_utils_1.isObject)(object))
         return;
     for (const key of Object.keys(object)) {
         visitor(object, key);
@@ -98,15 +99,15 @@ function crawl(object, visitor) {
 }
 function replace$Refs(obj, relativeFrom, componentFiles = {}) {
     crawl(obj, (node) => {
-        if (node.$ref && js_utils_1.isString(node.$ref) && isStartsWithComponents(node.$ref)) {
+        if (node.$ref && (0, js_utils_1.isString)(node.$ref) && isStartsWithComponents(node.$ref)) {
             replace(node, '$ref');
         }
         else if (node.discriminator &&
             node.discriminator.mapping &&
-            js_utils_1.isObject(node.discriminator.mapping)) {
+            (0, js_utils_1.isObject)(node.discriminator.mapping)) {
             const { mapping } = node.discriminator;
             for (const name of Object.keys(mapping)) {
-                if (js_utils_1.isString(mapping[name]) && isStartsWithComponents(mapping[name])) {
+                if ((0, js_utils_1.isString)(mapping[name]) && isStartsWithComponents(mapping[name])) {
                     replace(node.discriminator.mapping, name);
                 }
             }
@@ -137,7 +138,7 @@ function implicitlyReferenceDiscriminator(obj, defName, filename, schemaFiles) {
             implicitMapping[name] = res.startsWith('.') ? res : '.' + path.sep + res;
         }
     }
-    if (js_utils_1.isEmptyObject(implicitMapping))
+    if ((0, js_utils_1.isEmptyObject)(implicitMapping))
         return;
     const discriminatorPropSchema = obj.properties[obj.discriminator.propertyName];
     const discriminatorEnum = discriminatorPropSchema && discriminatorPropSchema.enum;
@@ -147,7 +148,7 @@ function implicitlyReferenceDiscriminator(obj, defName, filename, schemaFiles) {
             continue;
         }
         if (mapping[name] && mapping[name] !== implicitMapping[name]) {
-            process.stderr.write(colorette_1.yellow(`warning: explicit mapping overlaps with local mapping entry ${colorette_1.red(name)} at ${colorette_1.blue(filename)}. Please check it.`));
+            process.stderr.write((0, colorette_1.yellow)(`warning: explicit mapping overlaps with local mapping entry ${(0, colorette_1.red)(name)} at ${(0, colorette_1.blue)(filename)}. Please check it.`));
         }
         mapping[name] = implicitMapping[name];
     }
@@ -159,13 +160,13 @@ function findComponentTypes(components) {
     return types_1.OPENAPI3_COMPONENT_NAMES.filter((item) => isNotSecurityComponentType(item) && Object.keys(components).includes(item));
 }
 function doesFileDiffer(filename, componentData) {
-    return fs.existsSync(filename) && !isEqual(utils_1.readYaml(filename), componentData);
+    return fs.existsSync(filename) && !isEqual((0, utils_1.readYaml)(filename), componentData);
 }
 function removeEmptyComponents(openapi, componentType) {
-    if (openapi.components && js_utils_1.isEmptyObject(openapi.components[componentType])) {
+    if (openapi.components && (0, js_utils_1.isEmptyObject)(openapi.components[componentType])) {
         delete openapi.components[componentType];
     }
-    if (js_utils_1.isEmptyObject(openapi.components)) {
+    if ((0, js_utils_1.isEmptyObject)(openapi.components)) {
         delete openapi.components;
     }
 }
@@ -177,8 +178,8 @@ function createComponentDir(componentDirPath, componentType) {
 function extractFileNameFromPath(filename) {
     return path.basename(filename, path.extname(filename));
 }
-function getFileNamePath(componentDirPath, componentName) {
-    return path.join(componentDirPath, componentName) + '.yaml';
+function getFileNamePath(componentDirPath, componentName, ext) {
+    return path.join(componentDirPath, componentName) + `.${ext}`;
 }
 function gatherComponentsFiles(components, componentsFiles, componentType, componentName, filename) {
     var _a, _b;
@@ -191,14 +192,14 @@ function gatherComponentsFiles(components, componentsFiles, componentType, compo
     componentsFiles[componentType] = componentsFiles[componentType] || {};
     componentsFiles[componentType][componentName] = { inherits, filename };
 }
-function iteratePathItems(pathItems, openapiDir, outDir, componentsFiles, pathSeparator, codeSamplesPathPrefix = '') {
+function iteratePathItems(pathItems, openapiDir, outDir, componentsFiles, pathSeparator, codeSamplesPathPrefix = '', ext) {
     if (!pathItems)
         return;
     fs.mkdirSync(outDir, { recursive: true });
     for (const pathName of Object.keys(pathItems)) {
-        const pathFile = `${path.join(outDir, utils_1.pathToFilename(pathName, pathSeparator))}.yaml`;
+        const pathFile = `${path.join(outDir, (0, utils_1.pathToFilename)(pathName, pathSeparator))}.${ext}`;
         const pathData = pathItems[pathName];
-        if (openapi_core_1.isRef(pathData))
+        if ((0, openapi_core_1.isRef)(pathData))
             continue;
         for (const method of types_1.OPENAPI3_METHOD_NAMES) {
             const methodData = pathData[method];
@@ -209,25 +210,25 @@ function iteratePathItems(pathItems, openapiDir, outDir, componentsFiles, pathSe
             for (const sample of methodDataXCode) {
                 if (sample.source && sample.source.$ref)
                     continue;
-                const sampleFileName = path.join(openapiDir, 'code_samples', utils_1.escapeLanguageName(sample.lang), codeSamplesPathPrefix + utils_1.pathToFilename(pathName, pathSeparator), method + utils_1.langToExt(sample.lang));
+                const sampleFileName = path.join(openapiDir, 'code_samples', (0, utils_1.escapeLanguageName)(sample.lang), codeSamplesPathPrefix + (0, utils_1.pathToFilename)(pathName, pathSeparator), method + (0, utils_1.langToExt)(sample.lang));
                 fs.mkdirSync(path.dirname(sampleFileName), { recursive: true });
                 fs.writeFileSync(sampleFileName, sample.source);
                 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
                 // @ts-ignore
                 sample.source = {
-                    $ref: openapi_core_1.slash(path.relative(outDir, sampleFileName)),
+                    $ref: (0, openapi_core_1.slash)(path.relative(outDir, sampleFileName)),
                 };
             }
         }
-        utils_1.writeYaml(pathData, pathFile);
+        (0, utils_1.writeToFileByExtension)(pathData, pathFile);
         pathItems[pathName] = {
-            $ref: openapi_core_1.slash(path.relative(openapiDir, pathFile)),
+            $ref: (0, openapi_core_1.slash)(path.relative(openapiDir, pathFile)),
         };
         traverseDirectoryDeep(outDir, traverseDirectoryDeepCallback, componentsFiles);
     }
 }
 exports.iteratePathItems = iteratePathItems;
-function iterateComponents(openapi, openapiDir, componentsFiles) {
+function iterateComponents(openapi, openapiDir, componentsFiles, ext) {
     const { components } = openapi;
     if (components) {
         const componentsDir = path.join(openapiDir, types_1.COMPONENTS);
@@ -239,7 +240,7 @@ function iterateComponents(openapi, openapiDir, componentsFiles) {
         function iterateAndGatherComponentsFiles(componentType) {
             const componentDirPath = path.join(componentsDir, componentType);
             for (const componentName of Object.keys((components === null || components === void 0 ? void 0 : components[componentType]) || {})) {
-                const filename = getFileNamePath(componentDirPath, componentName);
+                const filename = getFileNamePath(componentDirPath, componentName, ext);
                 gatherComponentsFiles(components, componentsFiles, componentType, componentName, filename);
             }
         }
@@ -249,15 +250,15 @@ function iterateComponents(openapi, openapiDir, componentsFiles) {
             const componentDirPath = path.join(componentsDir, componentType);
             createComponentDir(componentDirPath, componentType);
             for (const componentName of Object.keys((components === null || components === void 0 ? void 0 : components[componentType]) || {})) {
-                const filename = getFileNamePath(componentDirPath, componentName);
+                const filename = getFileNamePath(componentDirPath, componentName, ext);
                 const componentData = (_a = components === null || components === void 0 ? void 0 : components[componentType]) === null || _a === void 0 ? void 0 : _a[componentName];
                 replace$Refs(componentData, path.dirname(filename), componentsFiles);
                 implicitlyReferenceDiscriminator(componentData, extractFileNameFromPath(filename), filename, componentsFiles.schemas || {});
                 if (doesFileDiffer(filename, componentData)) {
-                    process.stderr.write(colorette_1.yellow(`warning: conflict for ${componentName} - file already exists with different content: ${colorette_1.blue(filename)} ... Skip.\n`));
+                    process.stderr.write((0, colorette_1.yellow)(`warning: conflict for ${componentName} - file already exists with different content: ${(0, colorette_1.blue)(filename)} ... Skip.\n`));
                 }
                 else {
-                    utils_1.writeYaml(componentData, filename);
+                    (0, utils_1.writeToFileByExtension)(componentData, filename);
                 }
                 if (isNotSecurityComponentType(componentType)) {
                     // security schemas must referenced from components

package/lib/commands/split/types.d.ts

@@ -1,6 +1,6 @@
 import { Oas3Schema, Oas3_1Schema, Oas3Definition, Oas3_1Definition, Oas3Components, Oas3PathItem, Oas3Paths, Oas3ComponentName, Oas3_1Webhooks, Oas2Definition, Referenced } from '@redocly/openapi-core';
 export { Oas3_1Definition, Oas3Definition, Oas2Definition, Oas3Components, Oas3Paths, Oas3PathItem, Oas3ComponentName, Oas3_1Schema, Oas3Schema, Oas3_1Webhooks, Referenced, };
-export declare type Definition = Oas3_1Definition | Oas3Definition | Oas2Definition;
+export type Definition = Oas3_1Definition | Oas3Definition | Oas2Definition;
 export interface ComponentsFiles {
     [schemas: string]: any;
 }
@@ -11,7 +11,7 @@ export declare const COMPONENTS = "components";
 export declare const PATHS = "paths";
 export declare const WEBHOOKS = "webhooks";
 export declare const xWEBHOOKS = "x-webhooks";
-export declare const componentsPath: string;
+export declare const componentsPath = "#/components/";
 export declare enum OPENAPI3_METHOD {
     get = "get",
     put = "put",

package/lib/commands/split/types.js

@@ -16,7 +16,7 @@ var OPENAPI3_METHOD;
     OPENAPI3_METHOD["head"] = "head";
     OPENAPI3_METHOD["patch"] = "patch";
     OPENAPI3_METHOD["trace"] = "trace";
-})(OPENAPI3_METHOD = exports.OPENAPI3_METHOD || (exports.OPENAPI3_METHOD = {}));
+})(OPENAPI3_METHOD || (exports.OPENAPI3_METHOD = OPENAPI3_METHOD = {}));
 exports.OPENAPI3_METHOD_NAMES = [
     OPENAPI3_METHOD.get,
     OPENAPI3_METHOD.put,
@@ -38,7 +38,7 @@ var OPENAPI3_COMPONENT;
     OPENAPI3_COMPONENT["Links"] = "links";
     OPENAPI3_COMPONENT["Callbacks"] = "callbacks";
     OPENAPI3_COMPONENT["SecuritySchemes"] = "securitySchemes";
-})(OPENAPI3_COMPONENT = exports.OPENAPI3_COMPONENT || (exports.OPENAPI3_COMPONENT = {}));
+})(OPENAPI3_COMPONENT || (exports.OPENAPI3_COMPONENT = OPENAPI3_COMPONENT = {}));
 exports.OPENAPI3_COMPONENT_NAMES = [
     OPENAPI3_COMPONENT.RequestBodies,
     OPENAPI3_COMPONENT.Schemas,

package/lib/commands/stats.d.ts

@@ -1,6 +1,6 @@
 import { Config } from '@redocly/openapi-core';
 import type { OutputFormat } from '@redocly/openapi-core';
-export declare type StatsOptions = {
+export type StatsOptions = {
     api?: string;
     format: OutputFormat;
     config?: string;

package/lib/commands/stats.js

@@ -54,31 +54,31 @@ function printStats(statsAccumulator, api, format) {
 }
 function handleStats(argv, config) {
     return __awaiter(this, void 0, void 0, function* () {
-        const [{ path }] = yield utils_1.getFallbackApisOrExit(argv.api ? [argv.api] : [], config);
+        const [{ path }] = yield (0, utils_1.getFallbackApisOrExit)(argv.api ? [argv.api] : [], config);
         const externalRefResolver = new openapi_core_1.BaseResolver(config.resolve);
-        const { bundle: document } = yield openapi_core_1.bundle({ config, ref: path });
+        const { bundle: document } = yield (0, openapi_core_1.bundle)({ config, ref: path });
         const lintConfig = config.styleguide;
-        const specVersion = openapi_core_1.detectSpec(document.parsed);
-        const types = openapi_core_1.normalizeTypes(lintConfig.extendTypes(openapi_core_1.getTypes(specVersion), specVersion), lintConfig);
+        const specVersion = (0, openapi_core_1.detectSpec)(document.parsed);
+        const types = (0, openapi_core_1.normalizeTypes)(lintConfig.extendTypes((0, openapi_core_1.getTypes)(specVersion), specVersion), lintConfig);
         const startedAt = perf_hooks_1.performance.now();
         const ctx = {
             problems: [],
             oasVersion: specVersion,
             visitorsData: {},
         };
-        const resolvedRefMap = yield openapi_core_1.resolveDocument({
+        const resolvedRefMap = yield (0, openapi_core_1.resolveDocument)({
             rootDocument: document,
             rootType: types.Root,
             externalRefResolver,
         });
-        const statsVisitor = openapi_core_1.normalizeVisitors([
+        const statsVisitor = (0, openapi_core_1.normalizeVisitors)([
             {
                 severity: 'warn',
                 ruleId: 'stats',
-                visitor: openapi_core_1.Stats(statsAccumulator),
+                visitor: (0, openapi_core_1.Stats)(statsAccumulator),
             },
         ], types);
-        openapi_core_1.walkDocument({
+        (0, openapi_core_1.walkDocument)({
             document,
             rootType: types.Root,
             normalizedVisitors: statsVisitor,
@@ -86,7 +86,7 @@ function handleStats(argv, config) {
             ctx,
         });
         printStats(statsAccumulator, path, argv.format);
-        utils_2.printExecutionTime('stats', startedAt, path);
+        (0, utils_2.printExecutionTime)('stats', startedAt, path);
     });
 }
 exports.handleStats = handleStats;

package/lib/fetch-with-timeout.js

@@ -14,13 +14,16 @@ const TIMEOUT = 3000;
 exports.default = (url, options = {}) => __awaiter(void 0, void 0, void 0, function* () {
     try {
         if (!global.AbortController) {
-            return node_fetch_1.default(url, options);
+            return (0, node_fetch_1.default)(url, options);
         }
         const controller = new AbortController();
         const timeout = setTimeout(() => {
             controller.abort();
         }, TIMEOUT);
-        const res = yield node_fetch_1.default(url, Object.assign({ signal: controller.signal }, options));
+        // FIXME: fix this (possibly along with this issue: https://github.com/Redocly/redocly-cli/issues/1260)
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        const res = yield (0, node_fetch_1.default)(url, Object.assign({ signal: controller.signal }, options));
         clearTimeout(timeout);
         return res;
     }

package/lib/index.js

@@ -29,13 +29,18 @@ const update_version_notifier_2 = require("./update-version-notifier");
 if (!('replaceAll' in String.prototype)) {
     require('core-js/actual/string/replace-all');
 }
-update_version_notifier_1.cacheLatestVersion();
+(0, update_version_notifier_1.cacheLatestVersion)();
 yargs
     .version('version', 'Show version number.', update_version_notifier_2.version)
     .help('help', 'Show help.')
     .parserConfiguration({ 'greedy-arrays': false, 'camel-case-expansion': false })
     .command('stats [api]', 'Show statistics for an API description.', (yargs) => yargs.positional('api', { type: 'string' }).option({
     config: { description: 'Path to the config file.', type: 'string' },
+    'lint-config': {
+        description: 'Severity level for config file linting.',
+        choices: ['warn', 'error', 'off'],
+        default: 'warn',
+    },
     format: {
         description: 'Use a specific output format.',
         choices: ['stylish', 'json'],
@@ -43,7 +48,7 @@ yargs
     },
 }), (argv) => {
     process.env.REDOCLY_CLI_COMMAND = 'stats';
-    wrapper_1.commandWrapper(stats_1.handleStats)(argv);
+    (0, wrapper_1.commandWrapper)(stats_1.handleStats)(argv);
 })
     .command('split [api]', 'Split an API description into a multi-file structure.', (yargs) => yargs
     .positional('api', {
@@ -67,10 +72,15 @@ yargs
         requiresArg: true,
         type: 'string',
     },
+    'lint-config': {
+        description: 'Severity level for config file linting.',
+        choices: ['warn', 'error', 'off'],
+        default: 'warn',
+    },
 })
     .demandOption('api'), (argv) => {
     process.env.REDOCLY_CLI_COMMAND = 'split';
-    wrapper_1.commandWrapper(split_1.handleSplit)(argv);
+    (0, wrapper_1.commandWrapper)(split_1.handleSplit)(argv);
 })
     .command('join [apis...]', 'Join definitions [experimental].', (yargs) => yargs
     .positional('apis', {
@@ -105,16 +115,20 @@ yargs
         describe: 'Output file',
         alias: 'o',
         type: 'string',
-        default: 'openapi.yaml',
     },
     config: {
         description: 'Path to the config file.',
         requiresArg: true,
         type: 'string',
     },
+    'lint-config': {
+        description: 'Severity level for config file linting.',
+        choices: ['warn', 'error', 'off'],
+        default: 'warn',
+    },
 }), (argv) => {
     process.env.REDOCLY_CLI_COMMAND = 'join';
-    wrapper_1.commandWrapper(join_1.handleJoin)(argv);
+    (0, wrapper_1.commandWrapper)(join_1.handleJoin)(argv);
 })
     .command('push [api] [maybeDestination] [maybeBranchName]', 'Push an API description to the Redocly API registry.', (yargs) => yargs
     .usage('push [api]')
@@ -175,6 +189,11 @@ yargs
         array: true,
         type: 'string',
     },
+    'lint-config': {
+        description: 'Severity level for config file linting.',
+        choices: ['warn', 'error', 'off'],
+        default: 'warn',
+    },
 })
     .deprecateOption('batch-id', 'use --job-id')
     .deprecateOption('maybeDestination')
@@ -182,7 +201,7 @@ yargs
     .implies('batch-id', 'batch-size')
     .implies('batch-size', 'job-id'), (argv) => {
     process.env.REDOCLY_CLI_COMMAND = 'push';
-    wrapper_1.commandWrapper(push_1.transformPush(push_1.handlePush))(argv);
+    (0, wrapper_1.commandWrapper)((0, push_1.transformPush)(push_1.handlePush))(argv);
 })
     .command('lint [apis...]', 'Lint definition.', (yargs) => yargs.positional('apis', { array: true, type: 'string', demandOption: true }).option({
     format: {
@@ -235,7 +254,7 @@ yargs
     },
 }), (argv) => {
     process.env.REDOCLY_CLI_COMMAND = 'lint';
-    wrapper_1.commandWrapper(lint_1.handleLint)(argv);
+    (0, wrapper_1.commandWrapper)(lint_1.handleLint)(argv);
 })
     .command('bundle [apis...]', 'Bundle definition.', (yargs) => yargs.positional('apis', { array: true, type: 'string', demandOption: true }).options({
     output: { type: 'string', alias: 'o' },
@@ -309,9 +328,14 @@ yargs
         type: 'boolean',
         alias: 'k',
     },
+    'lint-config': {
+        description: 'Severity level for config file linting.',
+        choices: ['warn', 'error', 'off'],
+        default: 'warn',
+    },
 }), (argv) => {
     process.env.REDOCLY_CLI_COMMAND = 'bundle';
-    wrapper_1.commandWrapper(bundle_1.handleBundle)(argv);
+    (0, wrapper_1.commandWrapper)(bundle_1.handleBundle)(argv);
 })
     .command('login', 'Login to the Redocly API registry with an access token.', (yargs) => __awaiter(void 0, void 0, void 0, function* () {
     return yargs.options({
@@ -332,11 +356,11 @@ yargs
     });
 }), (argv) => {
     process.env.REDOCLY_CLI_COMMAND = 'login';
-    wrapper_1.commandWrapper(login_1.handleLogin)(argv);
+    (0, wrapper_1.commandWrapper)(login_1.handleLogin)(argv);
 })
     .command('logout', 'Clear your stored credentials for the Redocly API registry.', (yargs) => yargs, (argv) => __awaiter(void 0, void 0, void 0, function* () {
     process.env.REDOCLY_CLI_COMMAND = 'logout';
-    yield wrapper_1.commandWrapper(() => __awaiter(void 0, void 0, void 0, function* () {
+    yield (0, wrapper_1.commandWrapper)(() => __awaiter(void 0, void 0, void 0, function* () {
         const client = new openapi_core_1.RedoclyClient();
         client.logout();
         process.stdout.write('Logged out from the Redocly account. ✋\n');
@@ -378,9 +402,14 @@ yargs
         description: 'Path to the config file.',
         type: 'string',
     },
+    'lint-config': {
+        description: 'Severity level for config file linting.',
+        choices: ['warn', 'error', 'off'],
+        default: 'warn',
+    },
 }), (argv) => {
     process.env.REDOCLY_CLI_COMMAND = 'preview-docs';
-    wrapper_1.commandWrapper(preview_docs_1.previewDocs)(argv);
+    (0, wrapper_1.commandWrapper)(preview_docs_1.previewDocs)(argv);
 })
     .command('build-docs [api]', 'Produce API documentation as an HTML file', (yargs) => yargs
     .positional('api', { type: 'string' })
@@ -415,6 +444,11 @@ yargs
         describe: 'Path to the config file.',
         type: 'string',
     },
+    'lint-config': {
+        description: 'Severity level for config file linting.',
+        choices: ['warn', 'error', 'off'],
+        default: 'warn',
+    },
 })
     .check((argv) => {
     var _a;
@@ -423,7 +457,7 @@ yargs
     return true;
 }), (argv) => __awaiter(void 0, void 0, void 0, function* () {
     process.env.REDOCLY_CLI_COMMAND = 'build-docs';
-    wrapper_1.commandWrapper(build_docs_1.handlerBuildCommand)(argv);
+    (0, wrapper_1.commandWrapper)(build_docs_1.handlerBuildCommand)(argv);
 }))
     .completion('completion', 'Generate completion script.')
     .demandCommand(1)

package/lib/types.d.ts

@@ -8,22 +8,22 @@ import type { StatsOptions } from './commands/stats';
 import type { SplitOptions } from './commands/split';
 import type { PreviewDocsOptions } from './commands/preview-docs';
 import type { BuildDocsArgv } from './commands/build-docs/types';
-export declare type Totals = {
+export type Totals = {
     errors: number;
     warnings: number;
     ignored: number;
 };
-export declare type Entrypoint = {
+export type Entrypoint = {
     path: string;
     alias?: string;
 };
 export declare const outputExtensions: readonly BundleOutputFormat[];
-export declare type OutputExtensions = 'json' | 'yaml' | 'yml' | undefined;
+export type OutputExtensions = 'json' | 'yaml' | 'yml' | undefined;
 export declare const regionChoices: readonly Region[];
-export declare type CommandOptions = StatsOptions | SplitOptions | JoinOptions | PushOptions | LintOptions | BundleOptions | LoginOptions | PreviewDocsOptions | BuildDocsArgv;
-export declare type Skips = {
+export type CommandOptions = StatsOptions | SplitOptions | JoinOptions | PushOptions | LintOptions | BundleOptions | LoginOptions | PreviewDocsOptions | BuildDocsArgv;
+export type Skips = {
     'skip-rule'?: string[];
     'skip-decorator'?: string[];
     'skip-preprocessor'?: string[];
 };
-export declare type ConfigApis = Pick<Config, 'apis' | 'configFile'>;
+export type ConfigApis = Pick<Config, 'apis' | 'configFile'>;

package/lib/update-version-notifier.js

@@ -28,7 +28,7 @@ const notifyUpdateCliVersion = () => {
         return;
     }
     try {
-        const latestVersion = fs_1.readFileSync(path_1.join(os_1.tmpdir(), VERSION_CACHE_FILE)).toString();
+        const latestVersion = (0, fs_1.readFileSync)((0, path_1.join)((0, os_1.tmpdir)(), VERSION_CACHE_FILE)).toString();
         if (isNewVersionAvailable(exports.version, latestVersion)) {
             renderUpdateBanner(exports.version, latestVersion);
         }
@@ -38,10 +38,10 @@ const notifyUpdateCliVersion = () => {
     }
 };
 exports.notifyUpdateCliVersion = notifyUpdateCliVersion;
-const isNewVersionAvailable = (current, latest) => semver_1.compare(current, latest) < 0;
+const isNewVersionAvailable = (current, latest) => (0, semver_1.compare)(current, latest) < 0;
 const getLatestVersion = (packageName) => __awaiter(void 0, void 0, void 0, function* () {
     const latestUrl = `http://registry.npmjs.org/${packageName}/latest`;
-    const response = yield fetch_with_timeout_1.default(latestUrl);
+    const response = yield (0, fetch_with_timeout_1.default)(latestUrl);
     if (!response)
         return;
     const info = yield response.json();
@@ -54,8 +54,8 @@ const cacheLatestVersion = () => {
     getLatestVersion(exports.name)
         .then((version) => {
         if (version) {
-            const lastCheckFile = path_1.join(os_1.tmpdir(), VERSION_CACHE_FILE);
-            fs_1.writeFileSync(lastCheckFile, version);
+            const lastCheckFile = (0, path_1.join)((0, os_1.tmpdir)(), VERSION_CACHE_FILE);
+            (0, fs_1.writeFileSync)(lastCheckFile, version);
         }
     })
         .catch(() => { });
@@ -63,39 +63,39 @@ const cacheLatestVersion = () => {
 exports.cacheLatestVersion = cacheLatestVersion;
 const renderUpdateBanner = (current, latest) => {
     const messageLines = [
-        `A new version of ${colorette_1.cyan('Redocly CLI')} (${colorette_1.green(latest)}) is available.`,
-        `Update now: \`${colorette_1.cyan('npm i -g @redocly/cli@latest')}\`.`,
+        `A new version of ${(0, colorette_1.cyan)('Redocly CLI')} (${(0, colorette_1.green)(latest)}) is available.`,
+        `Update now: \`${(0, colorette_1.cyan)('npm i -g @redocly/cli@latest')}\`.`,
         `Changelog: https://redocly.com/docs/cli/changelog/`,
     ];
-    const maxLength = Math.max(...messageLines.map((line) => utils_1.cleanColors(line).length));
-    const border = colorette_1.yellow('═'.repeat(maxLength + SPACE_TO_BORDER));
+    const maxLength = Math.max(...messageLines.map((line) => (0, utils_1.cleanColors)(line).length));
+    const border = (0, colorette_1.yellow)('═'.repeat(maxLength + SPACE_TO_BORDER));
     const banner = `
-    ${colorette_1.yellow('╔' + border + '╗')}
-    ${colorette_1.yellow('║' + ' '.repeat(maxLength + SPACE_TO_BORDER) + '║')}
+    ${(0, colorette_1.yellow)('╔' + border + '╗')}
+    ${(0, colorette_1.yellow)('║' + ' '.repeat(maxLength + SPACE_TO_BORDER) + '║')}
     ${messageLines
         .map((line, index) => {
         return getLineWithPadding(maxLength, line, index);
     })
         .join('\n')}
-    ${colorette_1.yellow('║' + ' '.repeat(maxLength + SPACE_TO_BORDER) + '║')}
-    ${colorette_1.yellow('╚' + border + '╝')}
+    ${(0, colorette_1.yellow)('║' + ' '.repeat(maxLength + SPACE_TO_BORDER) + '║')}
+    ${(0, colorette_1.yellow)('╚' + border + '╝')}
   `;
     process.stderr.write(banner);
 };
 const getLineWithPadding = (maxLength, line, index) => {
-    const padding = ' '.repeat(maxLength - utils_1.cleanColors(line).length);
+    const padding = ' '.repeat(maxLength - (0, utils_1.cleanColors)(line).length);
     const extraSpaces = index !== 0 ? ' '.repeat(SPACE_TO_BORDER) : '';
-    return `${extraSpaces}${colorette_1.yellow('║')}  ${line}${padding}  ${colorette_1.yellow('║')}`;
+    return `${extraSpaces}${(0, colorette_1.yellow)('║')}  ${line}${padding}  ${(0, colorette_1.yellow)('║')}`;
 };
 const isNeedToBeCached = () => {
     try {
         // Last version from npm is stored in a file in the OS temp folder
-        const versionFile = path_1.join(os_1.tmpdir(), VERSION_CACHE_FILE);
-        if (!fs_1.existsSync(versionFile)) {
+        const versionFile = (0, path_1.join)((0, os_1.tmpdir)(), VERSION_CACHE_FILE);
+        if (!(0, fs_1.existsSync)(versionFile)) {
             return true;
         }
         const now = new Date().getTime();
-        const stats = fs_1.statSync(versionFile);
+        const stats = (0, fs_1.statSync)(versionFile);
         const lastCheck = stats.mtime.getTime();
         return now - lastCheck >= INTERVAL_TO_CHECK;
     }

package/lib/utils.d.ts

@@ -1,5 +1,5 @@
 import { BundleOutputFormat, StyleguideConfig, RawConfig, Region, Config, Oas3Definition, Oas2Definition } from '@redocly/openapi-core';
-import { Totals, Entrypoint, ConfigApis, CommandOptions } from './types';
+import { Totals, Entrypoint, ConfigApis, CommandOptions, OutputExtensions } from './types';
 import { Arguments } from 'yargs';
 export declare function getFallbackApisOrExit(argsApis: string[] | undefined, config: ConfigApis): Promise<Entrypoint[]>;
 export declare function getExecutionTime(startedAt: number): string;
@@ -15,7 +15,10 @@ export declare function dumpBundle(obj: any, format: BundleOutputFormat, derefer
 export declare function saveBundle(filename: string, output: string): void;
 export declare function promptUser(query: string, hideUserInput?: boolean): Promise<string>;
 export declare function readYaml(filename: string): unknown;
+export declare function writeToFileByExtension(data: unknown, filePath: string, noRefs?: boolean): void;
 export declare function writeYaml(data: any, filename: string, noRefs?: boolean): void;
+export declare function writeJson(data: unknown, filename: string): void;
+export declare function getAndValidateFileExtension(fileName: string): NonNullable<OutputExtensions>;
 export declare function pluralize(label: string, num: number): string;
 export declare function handleError(e: Error, ref: string): void;
 export declare class HandledError extends Error {
@@ -43,8 +46,8 @@ export declare function sortTopLevelKeysForOas(document: Oas3Definition | Oas2De
 export declare function checkIfRulesetExist(rules: typeof StyleguideConfig.prototype.rules): void;
 export declare function cleanColors(input: string): string;
 export declare function sendTelemetry(argv: Arguments | undefined, exit_code: ExitCode, has_config: boolean | undefined): Promise<void>;
-export declare type ExitCode = 0 | 1 | 2;
-export declare type Analytics = {
+export type ExitCode = 0 | 1 | 2;
+export type Analytics = {
     event: string;
     event_time: string;
     logged_in: boolean;