@redocly/openapi-core 1.0.0-beta.94 → 1.0.0-beta.97

package/lib/config/config.d.ts

@@ -1,107 +1,18 @@
-import { OasVersion, Oas3PreprocessorsSet, OasMajorVersion, Oas3DecoratorsSet, Oas2RuleSet, Oas2PreprocessorsSet, Oas2DecoratorsSet, Oas3RuleSet } from '../oas-types';
-import { ProblemSeverity, NormalizedProblem } from '../walk';
-import { NodeType } from '../types';
+/// <reference types="node" />
+import { NormalizedProblem } from '../walk';
+import { OasVersion, OasMajorVersion, Oas2RuleSet, Oas3RuleSet } from '../oas-types';
+import type { NodeType } from '../types';
+import type { DecoratorConfig, Plugin, PreprocessorConfig, Region, ResolveConfig, ResolvedApi, ResolvedConfig, ResolvedLintConfig, RuleConfig } from './types';
+export declare const env: NodeJS.ProcessEnv;
 export declare const IGNORE_FILE = ".redocly.lint-ignore.yaml";
-export declare type RuleConfig = ProblemSeverity | 'off' | ({
-    severity?: ProblemSeverity;
-} & Record<string, any>);
-export declare type PreprocessorConfig = ProblemSeverity | 'off' | 'on' | ({
-    severity?: ProblemSeverity;
-} & Record<string, any>);
-export declare type DecoratorConfig = PreprocessorConfig;
-export declare type LintRawConfig = {
-    plugins?: (string | Plugin)[];
-    extends?: string[];
-    doNotResolveExamples?: boolean;
-    rules?: Record<string, RuleConfig>;
-    oas2Rules?: Record<string, RuleConfig>;
-    oas3_0Rules?: Record<string, RuleConfig>;
-    oas3_1Rules?: Record<string, RuleConfig>;
-    preprocessors?: Record<string, PreprocessorConfig>;
-    oas2Preprocessors?: Record<string, PreprocessorConfig>;
-    oas3_0Preprocessors?: Record<string, PreprocessorConfig>;
-    oas3_1Preprocessors?: Record<string, PreprocessorConfig>;
-    decorators?: Record<string, DecoratorConfig>;
-    oas2Decorators?: Record<string, DecoratorConfig>;
-    oas3_0Decorators?: Record<string, DecoratorConfig>;
-    oas3_1Decorators?: Record<string, DecoratorConfig>;
-};
-export declare type PreprocessorsConfig = {
-    oas3?: Oas3PreprocessorsSet;
-    oas2?: Oas2PreprocessorsSet;
-};
-export declare type DecoratorsConfig = {
-    oas3?: Oas3DecoratorsSet;
-    oas2?: Oas2DecoratorsSet;
-};
-export declare type TypesExtensionFn = (types: Record<string, NodeType>, oasVersion: OasVersion) => Record<string, NodeType>;
-export declare type TypeExtensionsConfig = Partial<Record<OasMajorVersion, TypesExtensionFn>>;
-export declare type CustomRulesConfig = {
-    oas3?: Oas3RuleSet;
-    oas2?: Oas2RuleSet;
-};
-export declare type Plugin = {
-    id: string;
-    configs?: Record<string, LintRawConfig>;
-    rules?: CustomRulesConfig;
-    preprocessors?: PreprocessorsConfig;
-    decorators?: DecoratorsConfig;
-    typeExtension?: TypeExtensionsConfig;
-};
-export declare type ResolveHeader = {
-    name: string;
-    envVariable?: undefined;
-    value: string;
-    matches: string;
-} | {
-    name: string;
-    value?: undefined;
-    envVariable: string;
-    matches: string;
-};
-export declare type RawResolveConfig = {
-    http?: Partial<HttpResolveConfig>;
-};
-export declare type HttpResolveConfig = {
-    headers: ResolveHeader[];
-    customFetch?: Function;
-};
-export declare type ResolveConfig = {
-    http: HttpResolveConfig;
-};
 export declare const DEFAULT_REGION = "us";
-export declare type Region = 'us' | 'eu';
-export declare type AccessTokens = {
-    [region in Region]?: string;
-};
 export declare const DOMAINS: {
-    [region in Region]: string;
+    us: string;
+    eu: string;
 };
 export declare const AVAILABLE_REGIONS: Region[];
-export declare type DeprecatedRawConfig = {
-    apiDefinitions?: Record<string, string>;
-    lint?: LintRawConfig;
-    resolve?: RawResolveConfig;
-    region?: Region;
-    referenceDocs?: Record<string, any>;
-};
-export declare type Api = {
-    root: string;
-    lint?: Omit<LintRawConfig, 'plugins'>;
-    'features.openapi'?: Record<string, any>;
-    'features.mockServer'?: Record<string, any>;
-};
-export declare type RawConfig = {
-    apis?: Record<string, Api>;
-    lint?: LintRawConfig;
-    resolve?: RawResolveConfig;
-    region?: Region;
-    'features.openapi'?: Record<string, any>;
-    'features.mockServer'?: Record<string, any>;
-    organization?: string;
-};
 export declare class LintConfig {
-    rawConfig: LintRawConfig;
+    rawConfig: ResolvedLintConfig;
     configFile?: string | undefined;
     plugins: Plugin[];
     ignore: Record<string, Record<string, Set<string>>>;
@@ -112,19 +23,21 @@ export declare class LintConfig {
     private _usedRules;
     private _usedVersions;
     recommendedFallback: boolean;
-    constructor(rawConfig: LintRawConfig, configFile?: string | undefined);
+    extendPaths: string[];
+    pluginPaths: string[];
+    constructor(rawConfig: ResolvedLintConfig, configFile?: string | undefined);
     saveIgnore(): void;
     addIgnore(problem: NormalizedProblem): void;
     addProblemToIgnore(problem: NormalizedProblem): NormalizedProblem;
     extendTypes(types: Record<string, NodeType>, version: OasVersion): Record<string, NodeType>;
     getRuleSettings(ruleId: string, oasVersion: OasVersion): {
-        severity: ProblemSeverity | "off";
+        severity: import("../walk").ProblemSeverity | "off";
     };
     getPreprocessorSettings(ruleId: string, oasVersion: OasVersion): {
-        severity: ProblemSeverity | "off";
+        severity: import("../walk").ProblemSeverity | "off";
     };
     getDecoratorSettings(ruleId: string, oasVersion: OasVersion): {
-        severity: ProblemSeverity | "off";
+        severity: import("../walk").ProblemSeverity | "off";
     };
     getUnusedRules(): {
         rules: string[];
@@ -137,9 +50,9 @@ export declare class LintConfig {
     skipDecorators(decorators?: string[]): void;
 }
 export declare class Config {
-    rawConfig: RawConfig;
+    rawConfig: ResolvedConfig;
     configFile?: string | undefined;
-    apis: Record<string, Api>;
+    apis: Record<string, ResolvedApi>;
     lint: LintConfig;
     resolve: ResolveConfig;
     licenseKey?: string;
@@ -147,30 +60,5 @@ export declare class Config {
     'features.openapi': Record<string, any>;
     'features.mockServer'?: Record<string, any>;
     organization?: string;
-    constructor(rawConfig: RawConfig, configFile?: string | undefined);
+    constructor(rawConfig: ResolvedConfig, configFile?: string | undefined);
 }
-export declare function getMergedConfig(config: Config, entrypointAlias?: string): Config;
-export declare function getMergedLintConfig(config: Config, entrypointAlias?: string): {
-    rules: {
-        [x: string]: RuleConfig;
-    };
-    preprocessors: {
-        [x: string]: PreprocessorConfig;
-    };
-    decorators: {
-        [x: string]: PreprocessorConfig;
-    };
-    extends?: string[] | undefined;
-    doNotResolveExamples?: boolean | undefined;
-    oas2Rules?: Record<string, RuleConfig> | undefined;
-    oas3_0Rules?: Record<string, RuleConfig> | undefined;
-    oas3_1Rules?: Record<string, RuleConfig> | undefined;
-    oas2Preprocessors?: Record<string, PreprocessorConfig> | undefined;
-    oas3_0Preprocessors?: Record<string, PreprocessorConfig> | undefined;
-    oas3_1Preprocessors?: Record<string, PreprocessorConfig> | undefined;
-    oas2Decorators?: Record<string, PreprocessorConfig> | undefined;
-    oas3_0Decorators?: Record<string, PreprocessorConfig> | undefined;
-    oas3_1Decorators?: Record<string, PreprocessorConfig> | undefined;
-    plugins?: (string | Plugin)[] | undefined;
-};
-export declare function transformConfig(rawConfig: DeprecatedRawConfig | RawConfig): RawConfig;

package/lib/config/config.js

@@ -1,41 +1,34 @@
 "use strict";
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.transformConfig = exports.getMergedLintConfig = exports.getMergedConfig = exports.Config = exports.LintConfig = exports.AVAILABLE_REGIONS = exports.DOMAINS = exports.DEFAULT_REGION = exports.IGNORE_FILE = void 0;
+exports.Config = exports.LintConfig = exports.AVAILABLE_REGIONS = exports.DOMAINS = exports.DEFAULT_REGION = exports.IGNORE_FILE = exports.env = void 0;
 const fs = require("fs");
 const path = require("path");
-const path_1 = require("path");
-const colorette_1 = require("colorette");
 const js_yaml_1 = require("../js-yaml");
 const utils_1 = require("../utils");
 const oas_types_1 = require("../oas-types");
-const recommended_1 = require("./recommended");
+const utils_2 = require("./utils");
+// Alias environment here so this file can work in browser environments too.
+exports.env = typeof process !== 'undefined' ? process.env || {} : {};
 exports.IGNORE_FILE = '.redocly.lint-ignore.yaml';
 const IGNORE_BANNER = `# This file instructs Redocly's linter to ignore the rules contained for specific parts of your API.\n` +
     `# See https://redoc.ly/docs/cli/ for more information.\n`;
 exports.DEFAULT_REGION = 'us';
-const REDOCLY_DOMAIN = process.env.REDOCLY_DOMAIN;
-exports.DOMAINS = {
-    us: 'redocly.com',
-    eu: 'eu.redocly.com',
-};
-// FIXME: temporary fix for our lab environments
-if (REDOCLY_DOMAIN === null || REDOCLY_DOMAIN === void 0 ? void 0 : REDOCLY_DOMAIN.endsWith('.redocly.host')) {
-    exports.DOMAINS[REDOCLY_DOMAIN.split('.')[0]] = REDOCLY_DOMAIN;
-}
-if (REDOCLY_DOMAIN === 'redoc.online') {
-    exports.DOMAINS[REDOCLY_DOMAIN] = REDOCLY_DOMAIN;
+function getDomains() {
+    const domains = {
+        us: 'redocly.com',
+        eu: 'eu.redocly.com',
+    };
+    // FIXME: temporary fix for our lab environments
+    const domain = exports.env.REDOCLY_DOMAIN;
+    if (domain === null || domain === void 0 ? void 0 : domain.endsWith('.redocly.host')) {
+        domains[domain.split('.')[0]] = domain;
+    }
+    if (domain === 'redoc.online') {
+        domains[domain] = domain;
+    }
+    return domains;
 }
+exports.DOMAINS = getDomains();
 exports.AVAILABLE_REGIONS = Object.keys(exports.DOMAINS);
 class LintConfig {
     constructor(rawConfig, configFile) {
@@ -44,38 +37,26 @@ class LintConfig {
         this.ignore = {};
         this._usedRules = new Set();
         this._usedVersions = new Set();
-        this.recommendedFallback = false;
-        this.plugins = rawConfig.plugins ? resolvePlugins(rawConfig.plugins, configFile) : [];
+        this.plugins = rawConfig.plugins || [];
         this.doNotResolveExamples = !!rawConfig.doNotResolveExamples;
-        if (!rawConfig.extends) {
-            this.recommendedFallback = true;
-        }
-        const extendConfigs = rawConfig.extends
-            ? resolvePresets(rawConfig.extends, this.plugins)
-            : [recommended_1.default];
-        if (rawConfig.rules || rawConfig.preprocessors || rawConfig.decorators) {
-            extendConfigs.push({
-                rules: rawConfig.rules,
-                preprocessors: rawConfig.preprocessors,
-                decorators: rawConfig.decorators,
-            });
-        }
-        const merged = mergeExtends(extendConfigs);
+        this.recommendedFallback = rawConfig.recommendedFallback || false;
         this.rules = {
-            [oas_types_1.OasVersion.Version2]: Object.assign(Object.assign({}, merged.rules), merged.oas2Rules),
-            [oas_types_1.OasVersion.Version3_0]: Object.assign(Object.assign({}, merged.rules), merged.oas3_0Rules),
-            [oas_types_1.OasVersion.Version3_1]: Object.assign(Object.assign({}, merged.rules), merged.oas3_1Rules),
+            [oas_types_1.OasVersion.Version2]: Object.assign(Object.assign({}, rawConfig.rules), rawConfig.oas2Rules),
+            [oas_types_1.OasVersion.Version3_0]: Object.assign(Object.assign({}, rawConfig.rules), rawConfig.oas3_0Rules),
+            [oas_types_1.OasVersion.Version3_1]: Object.assign(Object.assign({}, rawConfig.rules), rawConfig.oas3_1Rules),
         };
         this.preprocessors = {
-            [oas_types_1.OasVersion.Version2]: Object.assign(Object.assign({}, merged.preprocessors), merged.oas2Preprocessors),
-            [oas_types_1.OasVersion.Version3_0]: Object.assign(Object.assign({}, merged.preprocessors), merged.oas3_0Preprocessors),
-            [oas_types_1.OasVersion.Version3_1]: Object.assign(Object.assign({}, merged.preprocessors), merged.oas3_1Preprocessors),
+            [oas_types_1.OasVersion.Version2]: Object.assign(Object.assign({}, rawConfig.preprocessors), rawConfig.oas2Preprocessors),
+            [oas_types_1.OasVersion.Version3_0]: Object.assign(Object.assign({}, rawConfig.preprocessors), rawConfig.oas3_0Preprocessors),
+            [oas_types_1.OasVersion.Version3_1]: Object.assign(Object.assign({}, rawConfig.preprocessors), rawConfig.oas3_1Preprocessors),
         };
         this.decorators = {
-            [oas_types_1.OasVersion.Version2]: Object.assign(Object.assign({}, merged.decorators), merged.oas2Decorators),
-            [oas_types_1.OasVersion.Version3_0]: Object.assign(Object.assign({}, merged.decorators), merged.oas3_0Decorators),
-            [oas_types_1.OasVersion.Version3_1]: Object.assign(Object.assign({}, merged.decorators), merged.oas3_1Decorators),
+            [oas_types_1.OasVersion.Version2]: Object.assign(Object.assign({}, rawConfig.decorators), rawConfig.oas2Decorators),
+            [oas_types_1.OasVersion.Version3_0]: Object.assign(Object.assign({}, rawConfig.decorators), rawConfig.oas3_0Decorators),
+            [oas_types_1.OasVersion.Version3_1]: Object.assign(Object.assign({}, rawConfig.decorators), rawConfig.oas3_1Decorators),
         };
+        this.extendPaths = rawConfig.extendPaths || [];
+        this.pluginPaths = rawConfig.pluginPaths || [];
         const dir = this.configFile
             ? path.dirname(this.configFile)
             : (typeof process !== 'undefined' && process.cwd()) || '';
@@ -87,7 +68,7 @@ class LintConfig {
                 js_yaml_1.parseYaml(fs.readFileSync(ignoreFile, 'utf-8')) || {};
             // resolve ignore paths
             for (const fileName of Object.keys(this.ignore)) {
-                this.ignore[path.resolve(path_1.dirname(ignoreFile), fileName)] = this.ignore[fileName];
+                this.ignore[path.resolve(path.dirname(ignoreFile), fileName)] = this.ignore[fileName];
                 for (const ruleId of Object.keys(this.ignore[fileName])) {
                     this.ignore[fileName][ruleId] = new Set(this.ignore[fileName][ruleId]);
                 }
@@ -249,207 +230,15 @@ class LintConfig {
 exports.LintConfig = LintConfig;
 class Config {
     constructor(rawConfig, configFile) {
-        var _a, _b, _c;
         this.rawConfig = rawConfig;
         this.configFile = configFile;
         this.apis = rawConfig.apis || {};
         this.lint = new LintConfig(rawConfig.lint || {}, configFile);
         this['features.openapi'] = rawConfig['features.openapi'] || {};
         this['features.mockServer'] = rawConfig['features.mockServer'] || {};
-        this.resolve = {
-            http: {
-                headers: (_c = (_b = (_a = rawConfig === null || rawConfig === void 0 ? void 0 : rawConfig.resolve) === null || _a === void 0 ? void 0 : _a.http) === null || _b === void 0 ? void 0 : _b.headers) !== null && _c !== void 0 ? _c : [],
-                customFetch: undefined,
-            },
-        };
+        this.resolve = utils_2.getResolveConfig(rawConfig === null || rawConfig === void 0 ? void 0 : rawConfig.resolve);
         this.region = rawConfig.region;
         this.organization = rawConfig.organization;
     }
 }
 exports.Config = Config;
-function resolvePresets(presets, plugins) {
-    return presets.map((presetName) => {
-        var _a;
-        const { pluginId, configName } = parsePresetName(presetName);
-        const plugin = plugins.find((p) => p.id === pluginId);
-        if (!plugin) {
-            throw new Error(`Invalid config ${colorette_1.red(presetName)}: plugin ${pluginId} is not included.`);
-        }
-        const preset = (_a = plugin.configs) === null || _a === void 0 ? void 0 : _a[configName];
-        if (!preset) {
-            throw new Error(pluginId
-                ? `Invalid config ${colorette_1.red(presetName)}: plugin ${pluginId} doesn't export config with name ${configName}.`
-                : `Invalid config ${colorette_1.red(presetName)}: there is no such built-in config.`);
-        }
-        return preset;
-    });
-}
-function parsePresetName(presetName) {
-    if (presetName.indexOf('/') > -1) {
-        const [pluginId, configName] = presetName.split('/');
-        return { pluginId, configName };
-    }
-    else {
-        return { pluginId: '', configName: presetName };
-    }
-}
-function resolvePlugins(plugins, configPath = '') {
-    if (!plugins)
-        return [];
-    // @ts-ignore
-    const requireFunc = typeof __webpack_require__ === 'function' ? __non_webpack_require__ : require;
-    const seenPluginIds = new Map();
-    return plugins
-        .map((p) => {
-        // TODO: resolve npm packages similar to eslint
-        const pluginModule = typeof p === 'string'
-            ? requireFunc(path.resolve(path.dirname(configPath), p))
-            : p;
-        const id = pluginModule.id;
-        if (typeof id !== 'string') {
-            throw new Error(colorette_1.red(`Plugin must define \`id\` property in ${colorette_1.blue(p.toString())}.`));
-        }
-        if (seenPluginIds.has(id)) {
-            const pluginPath = seenPluginIds.get(id);
-            throw new Error(colorette_1.red(`Plugin "id" must be unique. Plugin ${colorette_1.blue(p.toString())} uses id "${colorette_1.blue(id)}" already seen in ${colorette_1.blue(pluginPath)}`));
-        }
-        seenPluginIds.set(id, p.toString());
-        const plugin = Object.assign(Object.assign({ id }, (pluginModule.configs ? { configs: pluginModule.configs } : {})), (pluginModule.typeExtension ? { typeExtension: pluginModule.typeExtension } : {}));
-        if (pluginModule.rules) {
-            if (!pluginModule.rules.oas3 && !pluginModule.rules.oas2) {
-                throw new Error(`Plugin rules must have \`oas3\` or \`oas2\` rules "${p}.`);
-            }
-            plugin.rules = {};
-            if (pluginModule.rules.oas3) {
-                plugin.rules.oas3 = prefixRules(pluginModule.rules.oas3, id);
-            }
-            if (pluginModule.rules.oas2) {
-                plugin.rules.oas2 = prefixRules(pluginModule.rules.oas2, id);
-            }
-        }
-        if (pluginModule.preprocessors) {
-            if (!pluginModule.preprocessors.oas3 && !pluginModule.preprocessors.oas2) {
-                throw new Error(`Plugin \`preprocessors\` must have \`oas3\` or \`oas2\` preprocessors "${p}.`);
-            }
-            plugin.preprocessors = {};
-            if (pluginModule.preprocessors.oas3) {
-                plugin.preprocessors.oas3 = prefixRules(pluginModule.preprocessors.oas3, id);
-            }
-            if (pluginModule.preprocessors.oas2) {
-                plugin.preprocessors.oas2 = prefixRules(pluginModule.preprocessors.oas2, id);
-            }
-        }
-        if (pluginModule.decorators) {
-            if (!pluginModule.decorators.oas3 && !pluginModule.decorators.oas2) {
-                throw new Error(`Plugin \`decorators\` must have \`oas3\` or \`oas2\` decorators "${p}.`);
-            }
-            plugin.decorators = {};
-            if (pluginModule.decorators.oas3) {
-                plugin.decorators.oas3 = prefixRules(pluginModule.decorators.oas3, id);
-            }
-            if (pluginModule.decorators.oas2) {
-                plugin.decorators.oas2 = prefixRules(pluginModule.decorators.oas2, id);
-            }
-        }
-        return plugin;
-    })
-        .filter(utils_1.notUndefined);
-}
-function prefixRules(rules, prefix) {
-    if (!prefix)
-        return rules;
-    const res = {};
-    for (const name of Object.keys(rules)) {
-        res[`${prefix}/${name}`] = rules[name];
-    }
-    return res;
-}
-function mergeExtends(rulesConfList) {
-    const result = {
-        rules: {},
-        oas2Rules: {},
-        oas3_0Rules: {},
-        oas3_1Rules: {},
-        preprocessors: {},
-        oas2Preprocessors: {},
-        oas3_0Preprocessors: {},
-        oas3_1Preprocessors: {},
-        decorators: {},
-        oas2Decorators: {},
-        oas3_0Decorators: {},
-        oas3_1Decorators: {},
-    };
-    for (let rulesConf of rulesConfList) {
-        if (rulesConf.extends) {
-            throw new Error(`\`extends\` is not supported in shared configs yet: ${JSON.stringify(rulesConf, null, 2)}.`);
-        }
-        Object.assign(result.rules, rulesConf.rules);
-        Object.assign(result.oas2Rules, rulesConf.oas2Rules);
-        assignExisting(result.oas2Rules, rulesConf.rules || {});
-        Object.assign(result.oas3_0Rules, rulesConf.oas3_0Rules);
-        assignExisting(result.oas3_0Rules, rulesConf.rules || {});
-        Object.assign(result.oas3_1Rules, rulesConf.oas3_1Rules);
-        assignExisting(result.oas3_1Rules, rulesConf.rules || {});
-        Object.assign(result.preprocessors, rulesConf.preprocessors);
-        Object.assign(result.oas2Preprocessors, rulesConf.oas2Preprocessors);
-        assignExisting(result.oas2Preprocessors, rulesConf.preprocessors || {});
-        Object.assign(result.oas3_0Preprocessors, rulesConf.oas3_0Preprocessors);
-        assignExisting(result.oas3_0Preprocessors, rulesConf.preprocessors || {});
-        Object.assign(result.oas3_1Preprocessors, rulesConf.oas3_1Preprocessors);
-        assignExisting(result.oas3_1Preprocessors, rulesConf.preprocessors || {});
-        Object.assign(result.decorators, rulesConf.decorators);
-        Object.assign(result.oas2Decorators, rulesConf.oas2Decorators);
-        assignExisting(result.oas2Decorators, rulesConf.decorators || {});
-        Object.assign(result.oas3_0Decorators, rulesConf.oas3_0Decorators);
-        assignExisting(result.oas3_0Decorators, rulesConf.decorators || {});
-        Object.assign(result.oas3_1Decorators, rulesConf.oas3_1Decorators);
-        assignExisting(result.oas3_1Decorators, rulesConf.decorators || {});
-    }
-    return result;
-}
-function assignExisting(target, obj) {
-    for (let k of Object.keys(obj)) {
-        if (target.hasOwnProperty(k)) {
-            target[k] = obj[k];
-        }
-    }
-}
-function getMergedConfig(config, entrypointAlias) {
-    var _a, _b;
-    return entrypointAlias
-        ? new Config(Object.assign(Object.assign({}, config.rawConfig), { lint: getMergedLintConfig(config, entrypointAlias), 'features.openapi': Object.assign(Object.assign({}, config['features.openapi']), (_a = config.apis[entrypointAlias]) === null || _a === void 0 ? void 0 : _a['features.openapi']), 'features.mockServer': Object.assign(Object.assign({}, config['features.mockServer']), (_b = config.apis[entrypointAlias]) === null || _b === void 0 ? void 0 : _b['features.mockServer']) }), config.configFile)
-        : config;
-}
-exports.getMergedConfig = getMergedConfig;
-function getMergedLintConfig(config, entrypointAlias) {
-    var _a, _b, _c, _d;
-    const apiLint = entrypointAlias ? (_a = config.apis[entrypointAlias]) === null || _a === void 0 ? void 0 : _a.lint : {};
-    const mergedLint = Object.assign(Object.assign(Object.assign({}, config.rawConfig.lint), apiLint), { rules: Object.assign(Object.assign({}, (_b = config.rawConfig.lint) === null || _b === void 0 ? void 0 : _b.rules), apiLint === null || apiLint === void 0 ? void 0 : apiLint.rules), preprocessors: Object.assign(Object.assign({}, (_c = config.rawConfig.lint) === null || _c === void 0 ? void 0 : _c.preprocessors), apiLint === null || apiLint === void 0 ? void 0 : apiLint.preprocessors), decorators: Object.assign(Object.assign({}, (_d = config.rawConfig.lint) === null || _d === void 0 ? void 0 : _d.decorators), apiLint === null || apiLint === void 0 ? void 0 : apiLint.decorators) });
-    return mergedLint;
-}
-exports.getMergedLintConfig = getMergedLintConfig;
-function transformApiDefinitionsToApis(apiDefinitions = {}) {
-    let apis = {};
-    for (const [apiName, apiPath] of Object.entries(apiDefinitions)) {
-        apis[apiName] = { root: apiPath };
-    }
-    return apis;
-}
-function transformConfig(rawConfig) {
-    if (rawConfig.apis && rawConfig.apiDefinitions) {
-        throw new Error("Do not use 'apiDefinitions' field. Use 'apis' instead.\n");
-    }
-    if (rawConfig['features.openapi'] &&
-        rawConfig.referenceDocs) {
-        throw new Error("Do not use 'referenceDocs' field. Use 'features.openapi' instead.\n");
-    }
-    const _a = rawConfig, { apiDefinitions, referenceDocs } = _a, rest = __rest(_a, ["apiDefinitions", "referenceDocs"]);
-    if (apiDefinitions) {
-        process.stderr.write(`The ${colorette_1.yellow('apiDefinitions')} field is deprecated. Use ${colorette_1.green('apis')} instead. Read more about this change: https://redocly.com/docs/api-registry/guides/migration-guide-config-file/#changed-properties\n`);
-    }
-    if (referenceDocs) {
-        process.stderr.write(`The ${colorette_1.yellow('referenceDocs')} field is deprecated. Use ${colorette_1.green('features.openapi')} instead. Read more about this change: https://redocly.com/docs/api-registry/guides/migration-guide-config-file/#changed-properties\n`);
-    }
-    return Object.assign({ 'features.openapi': referenceDocs, apis: transformApiDefinitionsToApis(apiDefinitions) }, rest);
-}
-exports.transformConfig = transformConfig;

package/lib/config/index.d.ts

@@ -0,0 +1,7 @@
+export * from './config';
+export * from './types';
+export * from './rules';
+export * from './builtIn';
+export * from './load';
+export * from './utils';
+export * from './config-resolvers';

package/lib/config/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./config"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./rules"), exports);
+__exportStar(require("./builtIn"), exports);
+__exportStar(require("./load"), exports);
+__exportStar(require("./utils"), exports);
+__exportStar(require("./config-resolvers"), exports);

package/lib/config/load.d.ts

@@ -1,4 +1,5 @@
-import { Config, RawConfig } from './config';
+import { Config } from './config';
+import type { RawConfig } from './types';
 export declare function loadConfig(configPath?: string | undefined, customExtends?: string[]): Promise<Config>;
 export declare const CONFIG_FILE_NAMES: string[];
 export declare function findConfig(dir?: string): string | undefined;

package/lib/config/load.js

@@ -15,15 +15,20 @@ const path = require("path");
 const redocly_1 = require("../redocly");
 const utils_1 = require("../utils");
 const config_1 = require("./config");
-const builtIn_1 = require("./builtIn");
+const utils_2 = require("./utils");
+const config_resolvers_1 = require("./config-resolvers");
 function loadConfig(configPath = findConfig(), customExtends) {
-    var _a, _b;
+    var _a;
     return __awaiter(this, void 0, void 0, function* () {
         const rawConfig = yield getConfig(configPath);
         if (customExtends !== undefined) {
             rawConfig.lint = rawConfig.lint || {};
             rawConfig.lint.extends = customExtends;
         }
+        else if (utils_1.isEmptyObject(rawConfig)) {
+            // TODO: check if we can add recommended here. add message here?
+            // rawConfig.lint = { extends: ['recommended'], recommendedFallback: true };
+        }
         const redoclyClient = new redocly_1.RedoclyClient();
         const tokens = yield redoclyClient.getTokens();
         if (tokens.length) {
@@ -41,15 +46,19 @@ function loadConfig(configPath = findConfig(), customExtends) {
                     value: item.token,
                 }, 
                 //support redocly.com domain for future compatibility
-                ...(item.region === 'us' ? [{
-                        matches: `https://api.redoc.ly/registry/**`,
-                        name: 'Authorization',
-                        envVariable: undefined,
-                        value: item.token,
-                    }] : []));
+                ...(item.region === 'us'
+                    ? [
+                        {
+                            matches: `https://api.redoc.ly/registry/**`,
+                            name: 'Authorization',
+                            envVariable: undefined,
+                            value: item.token,
+                        },
+                    ]
+                    : []));
             }
         }
-        return new config_1.Config(Object.assign(Object.assign({}, rawConfig), { lint: Object.assign(Object.assign({}, rawConfig === null || rawConfig === void 0 ? void 0 : rawConfig.lint), { plugins: [...(((_b = rawConfig === null || rawConfig === void 0 ? void 0 : rawConfig.lint) === null || _b === void 0 ? void 0 : _b.plugins) || []), builtIn_1.defaultPlugin] }) }), configPath);
+        return config_resolvers_1.resolveConfig(rawConfig, configPath);
     });
 }
 exports.loadConfig = loadConfig;
@@ -57,9 +66,7 @@ exports.CONFIG_FILE_NAMES = ['redocly.yaml', 'redocly.yml', '.redocly.yaml', '.r
 function findConfig(dir) {
     if (!fs.hasOwnProperty('existsSync'))
         return;
-    const existingConfigFiles = exports.CONFIG_FILE_NAMES
-        .map(name => dir ? path.resolve(dir, name) : name)
-        .filter(fs.existsSync);
+    const existingConfigFiles = exports.CONFIG_FILE_NAMES.map((name) => dir ? path.resolve(dir, name) : name).filter(fs.existsSync);
     if (existingConfigFiles.length > 1) {
         throw new Error(`
       Multiple configuration files are not allowed. 
@@ -76,7 +83,7 @@ function getConfig(configPath = findConfig()) {
             return {};
         try {
             const rawConfig = ((yield utils_1.loadYaml(configPath)) || {});
-            return config_1.transformConfig(rawConfig);
+            return utils_2.transformConfig(rawConfig);
         }
         catch (e) {
             throw new Error(`Error parsing config file at '${configPath}': ${e.message}`);

package/lib/config/minimal.d.ts

@@ -1,3 +1,3 @@
-import { LintRawConfig } from './config';
-declare const _default: LintRawConfig;
+import type { PluginLintConfig } from './types';
+declare const _default: PluginLintConfig;
 export default _default;

package/lib/config/recommended.d.ts

@@ -1,3 +1,3 @@
-import { LintRawConfig } from './config';
-declare const _default: LintRawConfig;
+import type { PluginLintConfig } from './types';
+declare const _default: PluginLintConfig;
 export default _default;