@redocly/openapi-core 1.0.0-beta.63 → 1.0.0-beta.67

package/__tests__/lint.test.ts

@@ -0,0 +1,17 @@
+import outdent from 'outdent';
+import { detectOpenAPI } from '../src/oas-types';
+import { parseYamlToDocument } from './utils';
+
+describe.only('lint', () => {
+	it('detect OpenAPI should throw an error when version is not string', () => {
+
+	const testDocument = parseYamlToDocument(
+      outdent`
+        openapi: 3.0
+      `,
+      '',
+    );
+		expect(() => detectOpenAPI(testDocument.parsed))
+			.toThrow(`Invalid OpenAPI version: should be a string but got "number"`)
+	});
+});

package/lib/config/all.js

@@ -12,11 +12,13 @@ exports.default = {
         'no-identical-paths': 'error',
         'no-ambiguous-paths': 'error',
         'no-path-trailing-slash': 'error',
+        'path-segment-plural': 'error',
         'path-declaration-must-exist': 'error',
         'path-not-include-query': 'error',
         'path-parameters-defined': 'error',
         'operation-description': 'error',
         'operation-2xx-response': 'error',
+        'operation-4xx-response': 'error',
         'operation-operationId': 'error',
         'operation-summary': 'error',
         'operation-operationId-unique': 'error',
@@ -29,6 +31,12 @@ exports.default = {
         'no-enum-type-mismatch': 'error',
         'boolean-parameter-prefixes': 'error',
         'paths-kebab-case': 'error',
+        'no-http-verbs-in-paths': 'error',
+        'path-excludes-patterns': {
+            severity: 'error',
+            patterns: [],
+        },
+        'request-mime-type': 'error',
         spec: 'error',
     },
     oas3_0Rules: {
@@ -49,5 +57,5 @@ exports.default = {
         'no-unused-components': 'error',
         'no-undefined-server-variable': 'error',
         'no-servers-empty-enum': 'error',
-    }
+    },
 };

package/lib/config/config.js

@@ -73,7 +73,7 @@ class LintConfig {
         const ignoreFile = path.join(dir, exports.IGNORE_FILE);
         const mapped = {};
         for (const absFileName of Object.keys(this.ignore)) {
-            const ignoredRules = (mapped[path.relative(dir, absFileName)] = this.ignore[absFileName]);
+            const ignoredRules = (mapped[utils_1.slash(path.relative(dir, absFileName))] = this.ignore[absFileName]);
             for (const ruleId of Object.keys(ignoredRules)) {
                 ignoredRules[ruleId] = Array.from(ignoredRules[ruleId]);
             }

package/lib/config/minimal.js

@@ -17,6 +17,7 @@ exports.default = {
         'path-parameters-defined': 'warn',
         'operation-description': 'off',
         'operation-2xx-response': 'warn',
+        'operation-4xx-response': 'off',
         'operation-operationId': 'warn',
         'operation-summary': 'warn',
         'operation-operationId-unique': 'warn',

package/lib/config/recommended.js

@@ -17,6 +17,7 @@ exports.default = {
         'path-parameters-defined': 'error',
         'operation-description': 'off',
         'operation-2xx-response': 'warn',
+        'operation-4xx-response': 'warn',
         'operation-operationId': 'warn',
         'operation-summary': 'error',
         'operation-operationId-unique': 'error',

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-export { BundleOutputFormat, readFileFromUrl } from './utils';
+export { BundleOutputFormat, readFileFromUrl, slash } from './utils';
 export { Oas3_1Types } from './types/oas3_1';
 export { Oas3Types } from './types/oas3';
 export { Oas2Types } from './types/oas2';

package/lib/index.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.bundleDocument = exports.bundle = exports.lintConfig = exports.lintFromString = exports.lintDocument = exports.validate = exports.lint = exports.getTotals = exports.formatProblems = exports.getLineColLocation = exports.getAstNodeByPointer = exports.walkDocument = exports.normalizeVisitors = exports.OasVersion = exports.openAPIMajor = exports.OasMajorVersion = exports.detectOpenAPI = exports.unescapePointer = exports.stringifyYaml = exports.parseYaml = exports.makeDocumentFromString = exports.YamlParseError = exports.ResolveError = exports.resolveDocument = exports.BaseResolver = exports.Source = exports.RedoclyClient = exports.loadConfig = exports.IGNORE_FILE = exports.LintConfig = exports.Config = exports.Stats = exports.normalizeTypes = exports.ConfigTypes = exports.Oas2Types = exports.Oas3Types = exports.Oas3_1Types = exports.readFileFromUrl = void 0;
+exports.bundleDocument = exports.bundle = exports.lintConfig = exports.lintFromString = exports.lintDocument = exports.validate = exports.lint = exports.getTotals = exports.formatProblems = exports.getLineColLocation = exports.getAstNodeByPointer = exports.walkDocument = exports.normalizeVisitors = exports.OasVersion = exports.openAPIMajor = exports.OasMajorVersion = exports.detectOpenAPI = exports.unescapePointer = exports.stringifyYaml = exports.parseYaml = exports.makeDocumentFromString = exports.YamlParseError = exports.ResolveError = exports.resolveDocument = exports.BaseResolver = exports.Source = exports.RedoclyClient = exports.loadConfig = exports.IGNORE_FILE = exports.LintConfig = exports.Config = exports.Stats = exports.normalizeTypes = exports.ConfigTypes = exports.Oas2Types = exports.Oas3Types = exports.Oas3_1Types = exports.slash = exports.readFileFromUrl = void 0;
 var utils_1 = require("./utils");
 Object.defineProperty(exports, "readFileFromUrl", { enumerable: true, get: function () { return utils_1.readFileFromUrl; } });
+Object.defineProperty(exports, "slash", { enumerable: true, get: function () { return utils_1.slash; } });
 var oas3_1_1 = require("./types/oas3_1");
 Object.defineProperty(exports, "Oas3_1Types", { enumerable: true, get: function () { return oas3_1_1.Oas3_1Types; } });
 var oas3_1 = require("./types/oas3");

package/lib/oas-types.js

@@ -19,6 +19,9 @@ function detectOpenAPI(root) {
     if (!(root.openapi || root.swagger)) {
         throw new Error('This doesn’t look like an OpenAPI document.\n');
     }
+    if (root.openapi && typeof root.openapi !== 'string') {
+        throw new Error(`Invalid OpenAPI version: should be a string but got "${typeof root.openapi}"`);
+    }
     if (root.openapi && root.openapi.startsWith('3.0')) {
         return OasVersion.Version3_0;
     }

package/lib/rules/builtin.d.ts

@@ -7,8 +7,14 @@ export declare const preprocessors: {
 export declare const decorators: {
     oas3: {
         'registry-dependencies': import("../visitors").Oas3Decorator;
+        'operation-description-override': import("../visitors").Oas3Decorator;
+        'tag-description-override': import("../visitors").Oas3Decorator;
+        'info-description-override': import("../visitors").Oas3Decorator;
     };
     oas2: {
         'registry-dependencies': import("../visitors").Oas2Decorator;
+        'operation-description-override': import("../visitors").Oas2Decorator;
+        'tag-description-override': import("../visitors").Oas2Decorator;
+        'info-description-override': import("../visitors").Oas2Decorator;
     };
 };

package/lib/rules/common/info-description-override.d.ts

@@ -0,0 +1,2 @@
+import { Oas3Decorator, Oas2Decorator } from '../../visitors';
+export declare const InfoDescriptionOverride: Oas3Decorator | Oas2Decorator;

package/lib/rules/common/info-description-override.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InfoDescriptionOverride = void 0;
+const utils_1 = require("../../utils");
+const InfoDescriptionOverride = ({ filePath }) => {
+    return {
+        Info: {
+            leave(info, { report, location }) {
+                if (!filePath)
+                    throw new Error(`Parameter "filePath" is not provided for "info-description-override" rule`);
+                try {
+                    info.description = utils_1.readFileAsStringSync(filePath);
+                }
+                catch (e) {
+                    report({
+                        message: `Failed to read markdown override file for "info.description".\n${e.message}`,
+                        location: location.child('description'),
+                    });
+                }
+            },
+        },
+    };
+};
+exports.InfoDescriptionOverride = InfoDescriptionOverride;

package/lib/rules/common/info-license-url.js

@@ -8,6 +8,7 @@ const InfoLicense = () => {
             if (!info.license) {
                 report({
                     message: utils_1.missingRequiredField('Info', 'license'),
+                    location: { reportOnKey: true }
                 });
             }
         },

package/lib/rules/common/no-http-verbs-in-paths.d.ts

@@ -0,0 +1,2 @@
+import { Oas3Rule, Oas2Rule } from '../../visitors';
+export declare const NoHttpVerbsInPaths: Oas3Rule | Oas2Rule;

package/lib/rules/common/no-http-verbs-in-paths.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoHttpVerbsInPaths = void 0;
+const utils_1 = require("../../utils");
+const httpMethods = ['get', 'head', 'post', 'put', 'patch', 'delete', 'options', 'trace'];
+const NoHttpVerbsInPaths = ({ splitIntoWords }) => {
+    return {
+        PathItem(_path, { key, report, location }) {
+            const pathKey = key.toString();
+            if (!pathKey.startsWith('/'))
+                return;
+            const pathSegments = pathKey.split('/');
+            for (const pathSegment of pathSegments) {
+                if (!pathSegment || utils_1.isPathParameter(pathSegment))
+                    continue;
+                const isHttpMethodIncluded = (method) => {
+                    return splitIntoWords
+                        ? utils_1.splitCamelCaseIntoWords(pathSegment).has(method)
+                        : pathSegment.toLocaleLowerCase().includes(method);
+                };
+                for (const method of httpMethods) {
+                    if (isHttpMethodIncluded(method)) {
+                        report({
+                            message: `path \`${pathKey}\` should not contain http verb ${method}`,
+                            location: location.key(),
+                        });
+                    }
+                }
+            }
+        },
+    };
+};
+exports.NoHttpVerbsInPaths = NoHttpVerbsInPaths;

package/lib/rules/common/operation-4xx-response.d.ts

@@ -0,0 +1,2 @@
+import { Oas3Rule, Oas2Rule } from '../../visitors';
+export declare const Operation4xxResponse: Oas3Rule | Oas2Rule;

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Operation4xxResponse = void 0;
+const Operation4xxResponse = () => {
+    return {
+        ResponsesMap(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.',
+                    location: { reportOnKey: true },
+                });
+            }
+        },
+    };
+};
+exports.Operation4xxResponse = Operation4xxResponse;

package/lib/rules/common/operation-description-override.d.ts

@@ -0,0 +1,2 @@
+import { Oas3Decorator, Oas2Decorator } from '../../visitors';
+export declare const OperationDescriptionOverride: Oas3Decorator | Oas2Decorator;

package/lib/rules/common/operation-description-override.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationDescriptionOverride = void 0;
+const utils_1 = require("../../utils");
+const OperationDescriptionOverride = ({ operationIds }) => {
+    return {
+        Operation: {
+            leave(operation, { report, location }) {
+                if (!operation.operationId)
+                    return;
+                if (!operationIds)
+                    throw new Error(`Parameter "operationIds" is not provided for "operation-description-override" rule`);
+                const operationId = operation.operationId;
+                if (operationIds[operationId]) {
+                    try {
+                        operation.description = utils_1.readFileAsStringSync(operationIds[operationId]);
+                    }
+                    catch (e) {
+                        report({
+                            message: `Failed to read markdown override file for operation "${operationId}".\n${e.message}`,
+                            location: location.child('operationId').key(),
+                        });
+                    }
+                }
+            },
+        },
+    };
+};
+exports.OperationDescriptionOverride = OperationDescriptionOverride;

package/lib/rules/common/path-excludes-patterns.d.ts

@@ -0,0 +1,2 @@
+import { Oas2Rule, Oas3Rule } from '../../visitors';
+export declare const PathExcludesPatterns: Oas3Rule | Oas2Rule;

package/lib/rules/common/path-excludes-patterns.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PathExcludesPatterns = void 0;
+const PathExcludesPatterns = ({ patterns }) => {
+    return {
+        PathItem(_path, { report, key, location }) {
+            if (!patterns)
+                throw new Error(`Parameter "patterns" is not provided for "path-excludes-patterns" rule`);
+            const pathKey = key.toString();
+            if (pathKey.startsWith('/')) {
+                const matches = patterns.filter((pattern) => pathKey.match(pattern));
+                for (const match of matches) {
+                    report({
+                        message: `path \`${pathKey}\` should not match regex pattern: \`${match}\``,
+                        location: location.key(),
+                    });
+                }
+            }
+        },
+    };
+};
+exports.PathExcludesPatterns = PathExcludesPatterns;

package/lib/rules/common/path-segment-plural.d.ts

@@ -0,0 +1,2 @@
+import { Oas3Rule, Oas2Rule } from '../../visitors';
+export declare const PathSegmentPlural: Oas3Rule | Oas2Rule;

package/lib/rules/common/path-segment-plural.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PathSegmentPlural = void 0;
+const utils_1 = require("../../utils");
+const PathSegmentPlural = (opts) => {
+    const { ignoreLastPathSegment, exceptions } = opts;
+    return {
+        PathItem: {
+            leave(_path, { report, key, location }) {
+                const pathKey = key.toString();
+                if (pathKey.startsWith('/')) {
+                    const pathSegments = pathKey.split('/');
+                    pathSegments.shift();
+                    if (ignoreLastPathSegment && pathSegments.length > 1) {
+                        pathSegments.pop();
+                    }
+                    for (const pathSegment of pathSegments) {
+                        if (exceptions && exceptions.includes(pathSegment))
+                            continue;
+                        if (!utils_1.isPathParameter(pathSegment) && utils_1.isSingular(pathSegment)) {
+                            report({
+                                message: `path segment \`${pathSegment}\` should be plural.`,
+                                location: location.key(),
+                            });
+                        }
+                    }
+                }
+            },
+        },
+    };
+};
+exports.PathSegmentPlural = PathSegmentPlural;

package/lib/rules/common/tag-description-override.d.ts

@@ -0,0 +1,2 @@
+import { Oas3Decorator, Oas2Decorator } from '../../visitors';
+export declare const TagDescriptionOverride: Oas3Decorator | Oas2Decorator;

package/lib/rules/common/tag-description-override.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TagDescriptionOverride = void 0;
+const utils_1 = require("../../utils");
+const TagDescriptionOverride = ({ tagNames }) => {
+    return {
+        Tag: {
+            leave(tag, { report }) {
+                if (!tagNames)
+                    throw new Error(`Parameter "tagNames" is not provided for "tag-description-override" rule`);
+                if (tagNames[tag.name]) {
+                    try {
+                        tag.description = utils_1.readFileAsStringSync(tagNames[tag.name]);
+                    }
+                    catch (e) {
+                        report({
+                            message: `Failed to read markdown override file for tag "${tag.name}".\n${e.message}`,
+                        });
+                    }
+                }
+            },
+        },
+    };
+};
+exports.TagDescriptionOverride = TagDescriptionOverride;

package/lib/rules/oas2/index.d.ts

@@ -12,6 +12,7 @@ export declare const rules: {
     'boolean-parameter-prefixes': Oas2Rule;
     'no-path-trailing-slash': Oas2Rule;
     'operation-2xx-response': Oas2Rule;
+    'operation-4xx-response': Oas2Rule;
     'operation-operationId-unique': Oas2Rule;
     'operation-parameters-unique': Oas2Rule;
     'path-parameters-defined': Oas2Rule;
@@ -30,8 +31,16 @@ export declare const rules: {
     'no-identical-paths': Oas2Rule;
     'no-ambiguous-paths': Oas2Rule;
     'path-http-verbs-order': Oas2Rule;
+    'no-http-verbs-in-paths': Oas2Rule;
+    'path-excludes-patterns': Oas2Rule;
+    'request-mime-type': Oas2Rule;
+    'response-mime-type': Oas2Rule;
+    'path-segment-plural': Oas2Rule;
 };
 export declare const preprocessors: {};
 export declare const decorators: {
     'registry-dependencies': Oas2Decorator;
+    'operation-description-override': Oas2Decorator;
+    'tag-description-override': Oas2Decorator;
+    'info-description-override': Oas2Decorator;
 };

package/lib/rules/oas2/index.js

@@ -13,6 +13,7 @@ const paths_kebab_case_1 = require("../common/paths-kebab-case");
 const no_enum_type_mismatch_1 = require("../common/no-enum-type-mismatch");
 const no_path_trailing_slash_1 = require("../common/no-path-trailing-slash");
 const operation_2xx_response_1 = require("../common/operation-2xx-response");
+const operation_4xx_response_1 = require("../common/operation-4xx-response");
 const operation_operationId_unique_1 = require("../common/operation-operationId-unique");
 const operation_parameters_unique_1 = require("../common/operation-parameters-unique");
 const path_params_defined_1 = require("../common/path-params-defined");
@@ -31,6 +32,14 @@ const no_identical_paths_1 = require("../common/no-identical-paths");
 const operation_operationId_1 = require("../common/operation-operationId");
 const operation_summary_1 = require("../common/operation-summary");
 const no_ambiguous_paths_1 = require("../common/no-ambiguous-paths");
+const no_http_verbs_in_paths_1 = require("../common/no-http-verbs-in-paths");
+const path_excludes_patterns_1 = require("../common/path-excludes-patterns");
+const request_mime_type_1 = require("./request-mime-type");
+const response_mime_type_1 = require("./response-mime-type");
+const path_segment_plural_1 = require("../common/path-segment-plural");
+const operation_description_override_1 = require("../common/operation-description-override");
+const tag_description_override_1 = require("../common/tag-description-override");
+const info_description_override_1 = require("../common/info-description-override");
 exports.rules = {
     spec: spec_1.OasSpec,
     'info-description': info_description_1.InfoDescription,
@@ -44,6 +53,7 @@ exports.rules = {
     'boolean-parameter-prefixes': boolean_parameter_prefixes_1.BooleanParameterPrefixes,
     'no-path-trailing-slash': no_path_trailing_slash_1.NoPathTrailingSlash,
     'operation-2xx-response': operation_2xx_response_1.Operation2xxResponse,
+    'operation-4xx-response': operation_4xx_response_1.Operation4xxResponse,
     'operation-operationId-unique': operation_operationId_unique_1.OperationIdUnique,
     'operation-parameters-unique': operation_parameters_unique_1.OperationParametersUnique,
     'path-parameters-defined': path_params_defined_1.PathParamsDefined,
@@ -62,8 +72,16 @@ exports.rules = {
     'no-identical-paths': no_identical_paths_1.NoIdenticalPaths,
     'no-ambiguous-paths': no_ambiguous_paths_1.NoAmbiguousPaths,
     'path-http-verbs-order': path_http_verbs_order_1.PathHttpVerbsOrder,
+    'no-http-verbs-in-paths': no_http_verbs_in_paths_1.NoHttpVerbsInPaths,
+    'path-excludes-patterns': path_excludes_patterns_1.PathExcludesPatterns,
+    'request-mime-type': request_mime_type_1.RequestMimeType,
+    'response-mime-type': response_mime_type_1.ResponseMimeType,
+    'path-segment-plural': path_segment_plural_1.PathSegmentPlural,
 };
 exports.preprocessors = {};
 exports.decorators = {
     'registry-dependencies': registry_dependencies_1.RegistryDependencies,
+    'operation-description-override': operation_description_override_1.OperationDescriptionOverride,
+    'tag-description-override': tag_description_override_1.TagDescriptionOverride,
+    'info-description-override': info_description_override_1.InfoDescriptionOverride,
 };

package/lib/rules/oas2/request-mime-type.d.ts

@@ -0,0 +1,2 @@
+import { Oas2Rule } from '../../visitors';
+export declare const RequestMimeType: Oas2Rule;

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestMimeType = void 0;
+const utils_1 = require("../../utils");
+const RequestMimeType = ({ allowedValues }) => {
+    return {
+        DefinitionRoot(root, ctx) {
+            utils_1.validateMimeType({ type: 'consumes', value: root }, ctx, allowedValues);
+        },
+        Operation: {
+            leave(operation, ctx) {
+                utils_1.validateMimeType({ type: 'consumes', value: operation }, ctx, allowedValues);
+            },
+        },
+    };
+};
+exports.RequestMimeType = RequestMimeType;

package/lib/rules/oas2/response-mime-type.d.ts

@@ -0,0 +1,2 @@
+import { Oas2Rule } from '../../visitors';
+export declare const ResponseMimeType: Oas2Rule;

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseMimeType = void 0;
+const utils_1 = require("../../utils");
+const ResponseMimeType = ({ allowedValues }) => {
+    return {
+        DefinitionRoot(root, ctx) {
+            utils_1.validateMimeType({ type: 'produces', value: root }, ctx, allowedValues);
+        },
+        Operation: {
+            leave(operation, ctx) {
+                utils_1.validateMimeType({ type: 'produces', value: operation }, ctx, allowedValues);
+            },
+        },
+    };
+};
+exports.ResponseMimeType = ResponseMimeType;

package/lib/rules/oas3/index.d.ts

@@ -4,4 +4,7 @@ export declare const rules: Oas3RuleSet;
 export declare const preprocessors: {};
 export declare const decorators: {
     'registry-dependencies': Oas3Decorator;
+    'operation-description-override': Oas3Decorator;
+    'tag-description-override': Oas3Decorator;
+    'info-description-override': Oas3Decorator;
 };

package/lib/rules/oas3/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.decorators = exports.preprocessors = exports.rules = void 0;
 const spec_1 = require("../common/spec");
 const operation_2xx_response_1 = require("../common/operation-2xx-response");
+const operation_4xx_response_1 = require("../common/operation-4xx-response");
 const operation_operationId_unique_1 = require("../common/operation-operationId-unique");
 const operation_parameters_unique_1 = require("../common/operation-parameters-unique");
 const path_params_defined_1 = require("../common/path-params-defined");
@@ -39,6 +40,14 @@ const operation_operationId_1 = require("../common/operation-operationId");
 const operation_summary_1 = require("../common/operation-summary");
 const no_ambiguous_paths_1 = require("../common/no-ambiguous-paths");
 const no_servers_empty_enum_1 = require("./no-servers-empty-enum");
+const no_http_verbs_in_paths_1 = require("../common/no-http-verbs-in-paths");
+const request_mime_type_1 = require("./request-mime-type");
+const response_mime_type_1 = require("./response-mime-type");
+const path_segment_plural_1 = require("../common/path-segment-plural");
+const operation_description_override_1 = require("../common/operation-description-override");
+const tag_description_override_1 = require("../common/tag-description-override");
+const info_description_override_1 = require("../common/info-description-override");
+const path_excludes_patterns_1 = require("../common/path-excludes-patterns");
 exports.rules = {
     spec: spec_1.OasSpec,
     'info-description': info_description_1.InfoDescription,
@@ -46,6 +55,7 @@ exports.rules = {
     'info-license': info_license_url_1.InfoLicense,
     'info-license-url': license_url_1.InfoLicenseUrl,
     'operation-2xx-response': operation_2xx_response_1.Operation2xxResponse,
+    'operation-4xx-response': operation_4xx_response_1.Operation4xxResponse,
     'operation-operationId-unique': operation_operationId_unique_1.OperationIdUnique,
     'operation-parameters-unique': operation_parameters_unique_1.OperationParametersUnique,
     'path-parameters-defined': path_params_defined_1.PathParamsDefined,
@@ -77,9 +87,17 @@ exports.rules = {
     'no-identical-paths': no_identical_paths_1.NoIdenticalPaths,
     'no-ambiguous-paths': no_ambiguous_paths_1.NoAmbiguousPaths,
     'no-undefined-server-variable': no_undefined_server_variable_1.NoUndefinedServerVariable,
-    'no-servers-empty-enum': no_servers_empty_enum_1.NoEmptyEnumServers
+    'no-servers-empty-enum': no_servers_empty_enum_1.NoEmptyEnumServers,
+    'no-http-verbs-in-paths': no_http_verbs_in_paths_1.NoHttpVerbsInPaths,
+    'path-excludes-patterns': path_excludes_patterns_1.PathExcludesPatterns,
+    'request-mime-type': request_mime_type_1.RequestMimeType,
+    'response-mime-type': response_mime_type_1.ResponseMimeType,
+    'path-segment-plural': path_segment_plural_1.PathSegmentPlural,
 };
 exports.preprocessors = {};
 exports.decorators = {
     'registry-dependencies': registry_dependencies_1.RegistryDependencies,
+    'operation-description-override': operation_description_override_1.OperationDescriptionOverride,
+    'tag-description-override': tag_description_override_1.TagDescriptionOverride,
+    'info-description-override': info_description_override_1.InfoDescriptionOverride,
 };

package/lib/rules/oas3/request-mime-type.d.ts

@@ -0,0 +1,2 @@
+import { Oas3Rule } from '../../visitors';
+export declare const RequestMimeType: Oas3Rule;

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

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestMimeType = void 0;
+const utils_1 = require("../../utils");
+const RequestMimeType = ({ allowedValues }) => {
+    return {
+        PathMap: {
+            RequestBody: {
+                leave(requestBody, ctx) {
+                    utils_1.validateMimeTypeOAS3({ type: 'consumes', value: requestBody }, ctx, allowedValues);
+                },
+            },
+            Callback: {
+                RequestBody() { },
+                Response: {
+                    leave(response, ctx) {
+                        utils_1.validateMimeTypeOAS3({ type: 'consumes', value: response }, ctx, allowedValues);
+                    },
+                },
+            },
+        },
+        WebhooksMap: {
+            Response: {
+                leave(response, ctx) {
+                    utils_1.validateMimeTypeOAS3({ type: 'consumes', value: response }, ctx, allowedValues);
+                },
+            },
+        },
+    };
+};
+exports.RequestMimeType = RequestMimeType;

package/lib/rules/oas3/response-mime-type.d.ts

@@ -0,0 +1,2 @@
+import { Oas3Rule } from '../../visitors';
+export declare const ResponseMimeType: Oas3Rule;

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

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseMimeType = void 0;
+const utils_1 = require("../../utils");
+const ResponseMimeType = ({ allowedValues }) => {
+    return {
+        PathMap: {
+            Response: {
+                leave(response, ctx) {
+                    utils_1.validateMimeTypeOAS3({ type: 'produces', value: response }, ctx, allowedValues);
+                },
+            },
+            Callback: {
+                Response() { },
+                RequestBody: {
+                    leave(requestBody, ctx) {
+                        utils_1.validateMimeTypeOAS3({ type: 'produces', value: requestBody }, ctx, allowedValues);
+                    },
+                },
+            },
+        },
+        WebhooksMap: {
+            RequestBody: {
+                leave(requestBody, ctx) {
+                    utils_1.validateMimeTypeOAS3({ type: 'produces', value: requestBody }, ctx, allowedValues);
+                },
+            },
+        },
+    };
+};
+exports.ResponseMimeType = ResponseMimeType;

package/lib/types/oas3_1.js

@@ -94,6 +94,12 @@ const Operation = {
 };
 const Schema = {
     properties: {
+        $id: { type: 'string' },
+        id: { type: 'string' },
+        $schema: { type: 'string' },
+        definitions: 'NamedSchemas',
+        $defs: 'NamedSchemas',
+        $vocabulary: { type: 'string' },
         externalDocs: 'ExternalDocs',
         discriminator: 'Discriminator',
         myArbitraryKeyword: { type: 'boolean' },