@redocly/openapi-core 1.0.0-beta.110 → 1.0.0-beta.111

package/lib/config/config-resolvers.js

@@ -23,21 +23,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolvePreset = exports.resolveStyleguideConfig = exports.resolveApis = exports.resolvePlugins = exports.resolveConfig = void 0;
 const path = require("path");
 const ref_utils_1 = require("../ref-utils");
+const utils_1 = require("../utils");
 const resolve_1 = require("../resolve");
 const builtIn_1 = require("./builtIn");
-const utils_1 = require("./utils");
+const utils_2 = require("./utils");
 const env_1 = require("../env");
-const utils_2 = require("../utils");
+const utils_3 = require("../utils");
 const config_1 = require("./config");
 const logger_1 = require("../logger");
 const asserts_1 = require("../rules/common/assertions/asserts");
 function resolveConfig(rawConfig, configPath) {
     var _a, _b, _c, _d, _e;
     return __awaiter(this, void 0, void 0, function* () {
-        if ((_b = (_a = rawConfig.styleguide) === null || _a === void 0 ? void 0 : _a.extends) === null || _b === void 0 ? void 0 : _b.some(utils_2.isNotString)) {
+        if ((_b = (_a = rawConfig.styleguide) === null || _a === void 0 ? void 0 : _a.extends) === null || _b === void 0 ? void 0 : _b.some(utils_3.isNotString)) {
             throw new Error(`Error configuration format not detected in extends value must contain strings`);
         }
-        const resolver = new resolve_1.BaseResolver(utils_1.getResolveConfig(rawConfig.resolve));
+        const resolver = new resolve_1.BaseResolver(utils_2.getResolveConfig(rawConfig.resolve));
         const configExtends = (_d = (_c = rawConfig === null || rawConfig === void 0 ? void 0 : rawConfig.styleguide) === null || _c === void 0 ? void 0 : _c.extends) !== null && _d !== void 0 ? _d : ['recommended'];
         const recommendedFallback = !((_e = rawConfig === null || rawConfig === void 0 ? void 0 : rawConfig.styleguide) === null || _e === void 0 ? void 0 : _e.extends);
         const styleguideConfig = Object.assign(Object.assign({}, rawConfig === null || rawConfig === void 0 ? void 0 : rawConfig.styleguide), { extends: configExtends, recommendedFallback });
@@ -61,11 +62,11 @@ function resolvePlugins(plugins, configPath = '') {
         return [];
     // TODO: implement or reuse Resolver approach so it will work in node and browser envs
     const requireFunc = (plugin) => {
-        if (env_1.isBrowser && utils_2.isString(plugin)) {
+        if (env_1.isBrowser && utils_3.isString(plugin)) {
             logger_1.logger.error(`Cannot load ${plugin}. Plugins aren't supported in browser yet.`);
             return undefined;
         }
-        if (utils_2.isString(plugin)) {
+        if (utils_3.isString(plugin)) {
             const absoltePluginPath = path.resolve(path.dirname(configPath), plugin);
             // eslint-disable-next-line @typescript-eslint/ban-ts-comment
             // @ts-ignore
@@ -80,7 +81,7 @@ function resolvePlugins(plugins, configPath = '') {
     const seenPluginIds = new Map();
     return plugins
         .map((p) => {
-        if (utils_2.isString(p) && ref_utils_1.isAbsoluteUrl(p)) {
+        if (utils_3.isString(p) && ref_utils_1.isAbsoluteUrl(p)) {
             throw new Error(logger_1.colorize.red(`We don't support remote plugins yet.`));
         }
         // TODO: resolve npm packages similar to eslint
@@ -104,10 +105,10 @@ function resolvePlugins(plugins, configPath = '') {
             }
             plugin.rules = {};
             if (pluginModule.rules.oas3) {
-                plugin.rules.oas3 = utils_1.prefixRules(pluginModule.rules.oas3, id);
+                plugin.rules.oas3 = utils_2.prefixRules(pluginModule.rules.oas3, id);
             }
             if (pluginModule.rules.oas2) {
-                plugin.rules.oas2 = utils_1.prefixRules(pluginModule.rules.oas2, id);
+                plugin.rules.oas2 = utils_2.prefixRules(pluginModule.rules.oas2, id);
             }
         }
         if (pluginModule.preprocessors) {
@@ -116,10 +117,10 @@ function resolvePlugins(plugins, configPath = '') {
             }
             plugin.preprocessors = {};
             if (pluginModule.preprocessors.oas3) {
-                plugin.preprocessors.oas3 = utils_1.prefixRules(pluginModule.preprocessors.oas3, id);
+                plugin.preprocessors.oas3 = utils_2.prefixRules(pluginModule.preprocessors.oas3, id);
             }
             if (pluginModule.preprocessors.oas2) {
-                plugin.preprocessors.oas2 = utils_1.prefixRules(pluginModule.preprocessors.oas2, id);
+                plugin.preprocessors.oas2 = utils_2.prefixRules(pluginModule.preprocessors.oas2, id);
             }
         }
         if (pluginModule.decorators) {
@@ -128,10 +129,10 @@ function resolvePlugins(plugins, configPath = '') {
             }
             plugin.decorators = {};
             if (pluginModule.decorators.oas3) {
-                plugin.decorators.oas3 = utils_1.prefixRules(pluginModule.decorators.oas3, id);
+                plugin.decorators.oas3 = utils_2.prefixRules(pluginModule.decorators.oas3, id);
             }
             if (pluginModule.decorators.oas2) {
-                plugin.decorators.oas2 = utils_1.prefixRules(pluginModule.decorators.oas2, id);
+                plugin.decorators.oas2 = utils_2.prefixRules(pluginModule.decorators.oas2, id);
             }
         }
         if (pluginModule.assertions) {
@@ -139,7 +140,7 @@ function resolvePlugins(plugins, configPath = '') {
         }
         return plugin;
     })
-        .filter(utils_2.isDefined);
+        .filter(utils_3.isDefined);
 }
 exports.resolvePlugins = resolvePlugins;
 function resolveApis({ rawConfig, configPath = '', resolver, }) {
@@ -148,7 +149,7 @@ function resolveApis({ rawConfig, configPath = '', resolver, }) {
         const { apis = {}, styleguide: styleguideConfig = {} } = rawConfig;
         const resolvedApis = {};
         for (const [apiName, apiContent] of Object.entries(apis || {})) {
-            if ((_b = (_a = apiContent.styleguide) === null || _a === void 0 ? void 0 : _a.extends) === null || _b === void 0 ? void 0 : _b.some(utils_2.isNotString)) {
+            if ((_b = (_a = apiContent.styleguide) === null || _a === void 0 ? void 0 : _a.extends) === null || _b === void 0 ? void 0 : _b.some(utils_3.isNotString)) {
                 throw new Error(`Error configuration format not detected in extends value must contain strings`);
             }
             const rawStyleguideConfig = getMergedRawStyleguideConfig(styleguideConfig, apiContent.styleguide);
@@ -169,8 +170,8 @@ function resolveAndMergeNestedStyleguideConfig({ styleguideConfig, configPath =
         if (parentConfigPaths.includes(configPath)) {
             throw new Error(`Circular dependency in config file: "${configPath}"`);
         }
-        const plugins = utils_1.getUniquePlugins(resolvePlugins([...((styleguideConfig === null || styleguideConfig === void 0 ? void 0 : styleguideConfig.plugins) || []), builtIn_1.defaultPlugin], configPath));
-        const pluginPaths = (_a = styleguideConfig === null || styleguideConfig === void 0 ? void 0 : styleguideConfig.plugins) === null || _a === void 0 ? void 0 : _a.filter(utils_2.isString).map((p) => path.resolve(path.dirname(configPath), p));
+        const plugins = utils_2.getUniquePlugins(resolvePlugins([...((styleguideConfig === null || styleguideConfig === void 0 ? void 0 : styleguideConfig.plugins) || []), builtIn_1.defaultPlugin], configPath));
+        const pluginPaths = (_a = styleguideConfig === null || styleguideConfig === void 0 ? void 0 : styleguideConfig.plugins) === null || _a === void 0 ? void 0 : _a.filter(utils_3.isString).map((p) => path.resolve(path.dirname(configPath), p));
         const resolvedConfigPath = ref_utils_1.isAbsoluteUrl(configPath)
             ? configPath
             : configPath && path.resolve(configPath);
@@ -190,11 +191,11 @@ function resolveAndMergeNestedStyleguideConfig({ styleguideConfig, configPath =
                 resolver: resolver,
             }, [...parentConfigPaths, resolvedConfigPath], extendPaths);
         }))) || []);
-        const _d = utils_1.mergeExtends([
+        const _d = utils_2.mergeExtends([
             ...extendConfigs,
             Object.assign(Object.assign({}, styleguideConfig), { plugins, extends: undefined, extendPaths: [...parentConfigPaths, resolvedConfigPath], pluginPaths }),
         ]), { plugins: mergedPlugins = [] } = _d, styleguide = __rest(_d, ["plugins"]);
-        return Object.assign(Object.assign({}, styleguide), { extendPaths: (_c = styleguide.extendPaths) === null || _c === void 0 ? void 0 : _c.filter((path) => path && !ref_utils_1.isAbsoluteUrl(path)), plugins: utils_1.getUniquePlugins(mergedPlugins), recommendedFallback: styleguideConfig === null || styleguideConfig === void 0 ? void 0 : styleguideConfig.recommendedFallback, doNotResolveExamples: styleguideConfig === null || styleguideConfig === void 0 ? void 0 : styleguideConfig.doNotResolveExamples });
+        return Object.assign(Object.assign({}, styleguide), { extendPaths: (_c = styleguide.extendPaths) === null || _c === void 0 ? void 0 : _c.filter((path) => path && !ref_utils_1.isAbsoluteUrl(path)), plugins: utils_2.getUniquePlugins(mergedPlugins), recommendedFallback: styleguideConfig === null || styleguideConfig === void 0 ? void 0 : styleguideConfig.recommendedFallback, doNotResolveExamples: styleguideConfig === null || styleguideConfig === void 0 ? void 0 : styleguideConfig.doNotResolveExamples });
     });
 }
 function resolveStyleguideConfig(opts, parentConfigPaths = [], extendPaths = []) {
@@ -206,7 +207,7 @@ function resolveStyleguideConfig(opts, parentConfigPaths = [], extendPaths = [])
 exports.resolveStyleguideConfig = resolveStyleguideConfig;
 function resolvePreset(presetName, plugins) {
     var _a;
-    const { pluginId, configName } = utils_1.parsePresetName(presetName);
+    const { pluginId, configName } = utils_2.parsePresetName(presetName);
     const plugin = plugins.find((p) => p.id === pluginId);
     if (!plugin) {
         throw new Error(`Invalid config ${logger_1.colorize.red(presetName)}: plugin ${pluginId} is not included.`);
@@ -224,7 +225,7 @@ function loadExtendStyleguideConfig(filePath, resolver) {
     return __awaiter(this, void 0, void 0, function* () {
         try {
             const fileSource = yield resolver.loadExternalRef(filePath);
-            const rawConfig = utils_1.transformConfig(utils_2.parseYaml(fileSource.body));
+            const rawConfig = utils_2.transformConfig(utils_3.parseYaml(fileSource.body));
             if (!rawConfig.styleguide) {
                 throw new Error(`Styleguide configuration format not detected: "${filePath}"`);
             }
@@ -236,7 +237,7 @@ function loadExtendStyleguideConfig(filePath, resolver) {
     });
 }
 function getMergedRawStyleguideConfig(rootStyleguideConfig, apiStyleguideConfig) {
-    const resultLint = Object.assign(Object.assign(Object.assign({}, rootStyleguideConfig), apiStyleguideConfig), { rules: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.rules), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.rules), oas2Rules: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas2Rules), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas2Rules), oas3_0Rules: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_0Rules), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_0Rules), oas3_1Rules: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_1Rules), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_1Rules), preprocessors: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.preprocessors), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.preprocessors), oas2Preprocessors: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas2Preprocessors), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas2Preprocessors), oas3_0Preprocessors: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_0Preprocessors), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_0Preprocessors), oas3_1Preprocessors: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_1Preprocessors), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_1Preprocessors), decorators: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.decorators), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.decorators), oas2Decorators: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas2Decorators), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas2Decorators), oas3_0Decorators: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_0Decorators), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_0Decorators), oas3_1Decorators: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_1Decorators), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_1Decorators), recommendedFallback: (apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.extends)
+    const resultLint = Object.assign(Object.assign(Object.assign({}, rootStyleguideConfig), utils_1.pickDefined(apiStyleguideConfig)), { rules: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.rules), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.rules), oas2Rules: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas2Rules), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas2Rules), oas3_0Rules: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_0Rules), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_0Rules), oas3_1Rules: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_1Rules), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_1Rules), preprocessors: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.preprocessors), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.preprocessors), oas2Preprocessors: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas2Preprocessors), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas2Preprocessors), oas3_0Preprocessors: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_0Preprocessors), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_0Preprocessors), oas3_1Preprocessors: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_1Preprocessors), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_1Preprocessors), decorators: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.decorators), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.decorators), oas2Decorators: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas2Decorators), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas2Decorators), oas3_0Decorators: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_0Decorators), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_0Decorators), oas3_1Decorators: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_1Decorators), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_1Decorators), recommendedFallback: (apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.extends)
             ? false
             : rootStyleguideConfig.recommendedFallback });
     return resultLint;

package/lib/rules/common/no-ambiguous-paths.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NoAmbiguousPaths = void 0;
 const NoAmbiguousPaths = () => {
     return {
-        PathsMap(pathMap, { report, location }) {
+        Paths(pathMap, { report, location }) {
             const seenPaths = [];
             for (const currentPath of Object.keys(pathMap)) {
                 const ambiguousPath = seenPaths.find((seenPath) => arePathsAmbiguous(seenPath, currentPath));

package/lib/rules/common/no-identical-paths.js

@@ -3,11 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NoIdenticalPaths = void 0;
 const NoIdenticalPaths = () => {
     return {
-        PathsMap(pathMap, { report, location }) {
-            const pathsMap = new Map();
+        Paths(pathMap, { report, location }) {
+            const Paths = new Map();
             for (const pathName of Object.keys(pathMap)) {
                 const id = pathName.replace(/{.+?}/g, '{VARIABLE}');
-                const existingSamePath = pathsMap.get(id);
+                const existingSamePath = Paths.get(id);
                 if (existingSamePath) {
                     report({
                         message: `The path already exists which differs only by path parameter name(s): \`${existingSamePath}\` and \`${pathName}\`.`,
@@ -15,7 +15,7 @@ const NoIdenticalPaths = () => {
                     });
                 }
                 else {
-                    pathsMap.set(id, pathName);
+                    Paths.set(id, pathName);
                 }
             }
         },

package/lib/rules/common/operation-2xx-response.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Operation2xxResponse = void 0;
 const Operation2xxResponse = () => {
     return {
-        ResponsesMap(responses, { report }) {
-            const codes = Object.keys(responses);
+        Responses(responses, { report }) {
+            const codes = Object.keys(responses || {});
             if (!codes.some((code) => code === 'default' || /2[Xx0-9]{2}/.test(code))) {
                 report({
                     message: 'Operation must have at least one `2XX` response.',

package/lib/rules/common/operation-4xx-response.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Operation4xxResponse = void 0;
 const Operation4xxResponse = () => {
     return {
-        ResponsesMap(responses, { report }) {
-            const codes = Object.keys(responses);
+        Responses(responses, { report }) {
+            const codes = Object.keys(responses || {});
             if (!codes.some((code) => /4[Xx0-9]{2}/.test(code))) {
                 report({
                     message: 'Operation must have at least one `4XX` response.',

package/lib/rules/common/path-not-include-query.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PathNotIncludeQuery = void 0;
 const PathNotIncludeQuery = () => {
     return {
-        PathsMap: {
+        Paths: {
             PathItem(_operation, { report, key }) {
                 if (key.toString().includes('?')) {
                     report({

package/lib/rules/common/path-params-defined.js

@@ -6,6 +6,7 @@ const PathParamsDefined = () => {
     let pathTemplateParams;
     let definedPathParams;
     let currentPath;
+    let definedOperationParams;
     return {
         PathItem: {
             enter(_, { key }) {
@@ -25,9 +26,13 @@ const PathParamsDefined = () => {
                 }
             },
             Operation: {
+                enter() {
+                    definedOperationParams = new Set();
+                },
                 leave(_op, { report, location }) {
                     for (const templateParam of Array.from(pathTemplateParams.keys())) {
-                        if (!definedPathParams.has(templateParam)) {
+                        if (!definedOperationParams.has(templateParam) &&
+                            !definedPathParams.has(templateParam)) {
                             report({
                                 message: `The operation does not define the path parameter \`{${templateParam}}\` expected by path \`${currentPath}\`.`,
                                 location: location.child(['parameters']).key(), // report on operation
@@ -37,7 +42,7 @@ const PathParamsDefined = () => {
                 },
                 Parameter(parameter, { report, location }) {
                     if (parameter.in === 'path' && parameter.name) {
-                        definedPathParams.add(parameter.name);
+                        definedOperationParams.add(parameter.name);
                         if (!pathTemplateParams.has(parameter.name)) {
                             report({
                                 message: `Path parameter \`${parameter.name}\` is not used in the path \`${currentPath}\`.`,

package/lib/rules/common/response-contains-header.js

@@ -8,13 +8,13 @@ const ResponseContainsHeader = (options) => {
         Operation: {
             Response: {
                 enter: (response, { report, location, key }) => {
-                    var _a;
                     const expectedHeaders = names[key] ||
                         names[utils_1.getMatchingStatusCodeRange(key)] ||
                         names[utils_1.getMatchingStatusCodeRange(key).toLowerCase()] ||
                         [];
                     for (const expectedHeader of expectedHeaders) {
-                        if (!((_a = response.headers) === null || _a === void 0 ? void 0 : _a[expectedHeader])) {
+                        if (!(response === null || response === void 0 ? void 0 : response.headers) ||
+                            !Object.keys(response === null || response === void 0 ? void 0 : response.headers).some((header) => header.toLowerCase() === expectedHeader.toLowerCase())) {
                             report({
                                 message: `Response object must contain a "${expectedHeader}" header.`,
                                 location: location.child('headers').key(),

package/lib/rules/common/security-defined.js

@@ -3,9 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SecurityDefined = void 0;
 const SecurityDefined = () => {
     const referencedSchemes = new Map();
+    const operationsWithoutSecurity = [];
     let eachOperationHasSecurity = true;
     return {
-        DefinitionRoot: {
+        Root: {
             leave(root, { report }) {
                 for (const [name, scheme] of referencedSchemes.entries()) {
                     if (scheme.defined)
@@ -21,9 +22,12 @@ const SecurityDefined = () => {
                     return;
                 }
                 else {
-                    report({
-                        message: `Every API should have security defined on the root level or for each operation.`,
-                    });
+                    for (const operationLocation of operationsWithoutSecurity) {
+                        report({
+                            message: `Every operation should have security defined on it or on the root level.`,
+                            location: operationLocation.key(),
+                        });
+                    }
                 }
             },
         },
@@ -42,9 +46,10 @@ const SecurityDefined = () => {
                 }
             }
         },
-        Operation(operation) {
+        Operation(operation, { location }) {
             if (!(operation === null || operation === void 0 ? void 0 : operation.security)) {
                 eachOperationHasSecurity = false;
+                operationsWithoutSecurity.push(location);
             }
         },
     };

package/lib/rules/common/spec.js

@@ -8,7 +8,7 @@ const utils_2 = require("../../utils");
 const OasSpec = () => {
     return {
         any(node, { report, type, location, rawLocation, key, resolve, ignoreNextVisitorsOnNode }) {
-            var _a, _b, _c, _d;
+            var _a, _b, _c, _d, _e, _f;
             const nodeType = utils_1.oasTypeOf(node);
             const refLocation = rawLocation !== location ? rawLocation : undefined;
             if (type.items) {
@@ -99,18 +99,20 @@ const OasSpec = () => {
                 if (propSchema.resolvable !== false && ref_utils_1.isRef(propValue)) {
                     propValue = resolve(propValue).node;
                 }
-                if (propSchema.enum) {
-                    if (!propSchema.enum.includes(propValue)) {
-                        report({
-                            location: propLocation,
-                            message: `\`${propName}\` can be one of the following only: ${propSchema.enum
-                                .map((i) => `"${i}"`)
-                                .join(', ')}.`,
-                            from: refLocation,
-                            suggest: utils_1.getSuggest(propValue, propSchema.enum),
+                if (propSchema.items && ((_c = propSchema.items) === null || _c === void 0 ? void 0 : _c.enum) && Array.isArray(propValue)) {
+                    for (let i = 0; i < propValue.length; i++) {
+                        utils_1.validateSchemaEnumType((_d = propSchema.items) === null || _d === void 0 ? void 0 : _d.enum, propValue[i], propName, refLocation, {
+                            report,
+                            location: location.child([propName, i]),
                         });
                     }
                 }
+                if (propSchema.enum) {
+                    utils_1.validateSchemaEnumType(propSchema.enum, propValue, propName, refLocation, {
+                        report,
+                        location: location.child([propName]),
+                    });
+                }
                 else if (propSchema.type && !utils_1.matchesJsonSchemaType(propValue, propSchema.type, false)) {
                     report({
                         message: `Expected type \`${propSchema.type}\` but got \`${propValueType}\`.`,
@@ -118,8 +120,8 @@ const OasSpec = () => {
                         location: propLocation,
                     });
                 }
-                else if (propValueType === 'array' && ((_c = propSchema.items) === null || _c === void 0 ? void 0 : _c.type)) {
-                    const itemsType = (_d = propSchema.items) === null || _d === void 0 ? void 0 : _d.type;
+                else if (propValueType === 'array' && ((_e = propSchema.items) === null || _e === void 0 ? void 0 : _e.type)) {
+                    const itemsType = (_f = propSchema.items) === null || _f === void 0 ? void 0 : _f.type;
                     for (let i = 0; i < propValue.length; i++) {
                         const item = propValue[i];
                         if (!utils_1.matchesJsonSchemaType(item, itemsType, false)) {

package/lib/rules/oas3/request-mime-type.js

@@ -4,7 +4,7 @@ exports.RequestMimeType = void 0;
 const utils_1 = require("../../utils");
 const RequestMimeType = ({ allowedValues }) => {
     return {
-        PathsMap: {
+        Paths: {
             RequestBody: {
                 leave(requestBody, ctx) {
                     utils_1.validateMimeTypeOAS3({ type: 'consumes', value: requestBody }, ctx, allowedValues);

package/lib/rules/oas3/response-mime-type.js

@@ -4,7 +4,7 @@ exports.ResponseMimeType = void 0;
 const utils_1 = require("../../utils");
 const ResponseMimeType = ({ allowedValues }) => {
     return {
-        PathsMap: {
+        Paths: {
             Response: {
                 leave(response, ctx) {
                     utils_1.validateMimeTypeOAS3({ type: 'produces', value: response }, ctx, allowedValues);

package/lib/rules/other/stats.d.ts

@@ -22,7 +22,7 @@ export declare const Stats: (statsAccumulator: StatsAccumulator) => {
             leave(operation: any): void;
         };
     };
-    PathsMap: {
+    Paths: {
         PathItem: {
             leave(): void;
             Operation: {

package/lib/rules/other/stats.js

@@ -40,7 +40,7 @@ const Stats = (statsAccumulator) => {
                 },
             },
         },
-        PathsMap: {
+        Paths: {
             PathItem: {
                 leave() {
                     statsAccumulator.pathItems.total++;

package/lib/rules/utils.d.ts

@@ -16,3 +16,4 @@ export declare function validateDefinedAndNonEmpty(fieldName: string, value: any
 export declare function getSuggest(given: string, variants: string[]): string[];
 export declare function validateExample(example: any, schema: Referenced<Oas3Schema>, dataLoc: Location, { resolve, location, report }: UserContext, allowAdditionalProperties: boolean): void;
 export declare function getAdditionalPropertiesOption(opts: Record<string, any>): boolean;
+export declare function validateSchemaEnumType(schemaEnum: string[], propertyValue: string, propName: string, refLocation: Location | undefined, { report, location }: UserContext): void;

package/lib/rules/utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAdditionalPropertiesOption = exports.validateExample = exports.getSuggest = exports.validateDefinedAndNonEmpty = exports.fieldNonEmpty = exports.missingRequiredField = exports.matchesJsonSchemaType = exports.oasTypeOf = void 0;
+exports.validateSchemaEnumType = exports.getAdditionalPropertiesOption = exports.validateExample = exports.getSuggest = exports.validateDefinedAndNonEmpty = exports.fieldNonEmpty = exports.missingRequiredField = exports.matchesJsonSchemaType = exports.oasTypeOf = void 0;
 const levenshtein = require("js-levenshtein");
 const ref_utils_1 = require("../ref-utils");
 const ajv_1 = require("./ajv");
@@ -120,3 +120,19 @@ function getAdditionalPropertiesOption(opts) {
     return !opts.disallowAdditionalProperties;
 }
 exports.getAdditionalPropertiesOption = getAdditionalPropertiesOption;
+function validateSchemaEnumType(schemaEnum, propertyValue, propName, refLocation, { report, location }) {
+    if (!schemaEnum) {
+        return;
+    }
+    if (!schemaEnum.includes(propertyValue === null ? 'null' : propertyValue)) {
+        report({
+            location,
+            message: `\`${propName}\` can be one of the following only: ${schemaEnum
+                .map((type) => `"${type}"`)
+                .join(', ')}.`,
+            from: refLocation,
+            suggest: getSuggest(propertyValue, schemaEnum),
+        });
+    }
+}
+exports.validateSchemaEnumType = validateSchemaEnumType;

package/lib/types/oas2.js

@@ -12,7 +12,7 @@ const Root = {
         schemes: { type: 'array', items: { type: 'string' } },
         consumes: { type: 'array', items: { type: 'string' } },
         produces: { type: 'array', items: { type: 'string' } },
-        paths: 'PathsMap',
+        paths: 'Paths',
         definitions: 'NamedSchemas',
         parameters: 'NamedParameters',
         responses: 'NamedResponses',
@@ -48,7 +48,7 @@ const License = {
     },
     required: ['name'],
 };
-const PathsMap = {
+const Paths = {
     properties: {},
     additionalProperties: (_value, key) => key.startsWith('/') ? 'PathItem' : undefined,
 };
@@ -75,7 +75,7 @@ const Operation = {
         consumes: { type: 'array', items: { type: 'string' } },
         produces: { type: 'array', items: { type: 'string' } },
         parameters: _1.listOf('Parameter'),
-        responses: 'ResponsesMap',
+        responses: 'Responses',
         schemes: { type: 'array', items: { type: 'string' } },
         deprecated: { type: 'boolean' },
         security: _1.listOf('SecurityRequirement'),
@@ -171,7 +171,7 @@ const ParameterItems = {
         }
     },
 };
-const ResponsesMap = {
+const Responses = {
     properties: {
         default: 'Response',
     },
@@ -359,14 +359,14 @@ exports.Oas2Types = {
     Info,
     Contact,
     License,
-    PathsMap,
+    Paths,
     PathItem,
     Parameter,
     ParameterItems,
     Operation,
     Examples,
     Header,
-    ResponsesMap,
+    Responses,
     Response,
     Schema,
     Xml,

package/lib/types/oas3.js

@@ -12,7 +12,7 @@ const Root = {
         security: _1.listOf('SecurityRequirement'),
         tags: _1.listOf('Tag'),
         externalDocs: 'ExternalDocs',
-        paths: 'PathsMap',
+        paths: 'Paths',
         components: 'Components',
         'x-webhooks': 'WebhooksMap',
     },
@@ -81,7 +81,7 @@ const License = {
     },
     required: ['name'],
 };
-const PathsMap = {
+const Paths = {
     properties: {},
     additionalProperties: (_value, key) => key.startsWith('/') ? 'PathItem' : undefined,
 };
@@ -141,7 +141,7 @@ const Operation = {
         security: _1.listOf('SecurityRequirement'),
         servers: _1.listOf('Server'),
         requestBody: 'RequestBody',
-        responses: 'ResponsesMap',
+        responses: 'Responses',
         deprecated: { type: 'boolean' },
         callbacks: 'CallbacksMap',
         'x-codeSamples': _1.listOf('XCodeSample'),
@@ -174,7 +174,7 @@ const MediaType = {
         schema: 'Schema',
         example: { isExample: true },
         examples: 'ExamplesMap',
-        encoding: 'EncodingsMap',
+        encoding: 'EncodingMap',
     },
 };
 const Example = {
@@ -214,7 +214,7 @@ const Header = {
     },
     requiredOneOf: ['schema', 'content'],
 };
-const ResponsesMap = {
+const Responses = {
     properties: { default: 'Response' },
     additionalProperties: (_v, key) => responseCodeRegexp.test(key) ? 'Response' : undefined,
 };
@@ -378,7 +378,7 @@ const AuthorizationCode = {
     },
     required: ['authorizationUrl', 'tokenUrl', 'scopes'],
 };
-const SecuritySchemeFlows = {
+const OAuth2Flows = {
     properties: {
         implicit: 'ImplicitFlow',
         password: 'PasswordFlow',
@@ -394,7 +394,7 @@ const SecurityScheme = {
         in: { type: 'string', enum: ['query', 'header', 'cookie'] },
         scheme: { type: 'string' },
         bearerFormat: { type: 'string' },
-        flows: 'SecuritySchemeFlows',
+        flows: 'OAuth2Flows',
         openIdConnectUrl: { type: 'string' },
     },
     required(value) {
@@ -438,7 +438,7 @@ exports.Oas3Types = {
     Info,
     Contact,
     License,
-    PathsMap,
+    Paths,
     PathItem,
     Parameter,
     Operation,
@@ -450,10 +450,10 @@ exports.Oas3Types = {
     Example,
     ExamplesMap: _1.mapOf('Example'),
     Encoding,
-    EncodingsMap: _1.mapOf('Encoding'),
+    EncodingMap: _1.mapOf('Encoding'),
     Header,
     HeadersMap: _1.mapOf('Header'),
-    ResponsesMap,
+    Responses,
     Response,
     Link,
     Schema,
@@ -476,7 +476,7 @@ exports.Oas3Types = {
     PasswordFlow,
     ClientCredentials,
     AuthorizationCode,
-    SecuritySchemeFlows,
+    OAuth2Flows,
     SecurityScheme,
     XCodeSample,
     WebhooksMap,

package/lib/types/oas3_1.js

@@ -11,7 +11,7 @@ const Root = {
         security: _1.listOf('SecurityRequirement'),
         tags: _1.listOf('Tag'),
         externalDocs: 'ExternalDocs',
-        paths: 'PathsMap',
+        paths: 'Paths',
         webhooks: 'WebhooksMap',
         components: 'Components',
         jsonSchemaDialect: { type: 'string' },
@@ -67,7 +67,7 @@ const Operation = {
         security: _1.listOf('SecurityRequirement'),
         servers: _1.listOf('Server'),
         requestBody: 'RequestBody',
-        responses: 'ResponsesMap',
+        responses: 'Responses',
         deprecated: { type: 'boolean' },
         callbacks: _1.mapOf('Callback'),
         'x-codeSamples': _1.listOf('XCodeSample'),
@@ -175,7 +175,7 @@ const SecurityScheme = {
         in: { type: 'string', enum: ['query', 'header', 'cookie'] },
         scheme: { type: 'string' },
         bearerFormat: { type: 'string' },
-        flows: 'SecuritySchemeFlows',
+        flows: 'OAuth2Flows',
         openIdConnectUrl: { type: 'string' },
     },
     required(value) {