@redocly/openapi-core 1.0.0-beta.100

package/lib/rules/no-unresolved-refs.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportUnresolvedRef = exports.NoUnresolvedRefs = void 0;
+const resolve_1 = require("../resolve");
+const NoUnresolvedRefs = () => {
+    return {
+        ref: {
+            leave(_, { report, location }, resolved) {
+                if (resolved.node !== undefined)
+                    return;
+                reportUnresolvedRef(resolved, report, location);
+            },
+        },
+        DiscriminatorMapping(mapping, { report, resolve, location }) {
+            for (const mappingName of Object.keys(mapping)) {
+                const resolved = resolve({ $ref: mapping[mappingName] });
+                if (resolved.node !== undefined)
+                    return;
+                reportUnresolvedRef(resolved, report, location.child(mappingName));
+            }
+        },
+    };
+};
+exports.NoUnresolvedRefs = NoUnresolvedRefs;
+function reportUnresolvedRef(resolved, report, location) {
+    var _a;
+    const error = resolved.error;
+    if (error instanceof resolve_1.YamlParseError) {
+        report({
+            message: 'Failed to parse: ' + error.message,
+            location: {
+                source: error.source,
+                pointer: undefined,
+                start: {
+                    col: error.col,
+                    line: error.line,
+                },
+            },
+        });
+    }
+    const message = (_a = resolved.error) === null || _a === void 0 ? void 0 : _a.message;
+    report({
+        location,
+        message: `Can't resolve $ref${message ? ': ' + message : ''}`,
+    });
+}
+exports.reportUnresolvedRef = reportUnresolvedRef;

package/lib/rules/oas2/boolean-parameter-prefixes.d.ts

@@ -0,0 +1,5 @@
+import { Oas2Rule } from '../../visitors';
+export declare type BooleanParameterPrefixesOptions = {
+    prefixes?: string[];
+};
+export declare const BooleanParameterPrefixes: Oas2Rule;

package/lib/rules/oas2/boolean-parameter-prefixes.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BooleanParameterPrefixes = void 0;
+const BooleanParameterPrefixes = (options) => {
+    const prefixes = options.prefixes || ['is', 'has'];
+    const regexp = new RegExp(`^(${prefixes.join('|')})[A-Z-_]`);
+    const wrappedPrefixes = prefixes.map((p) => `\`${p}\``);
+    const prefixesString = wrappedPrefixes.length === 1
+        ? wrappedPrefixes[0]
+        : wrappedPrefixes.slice(0, -1).join(', ') + ' or ' + wrappedPrefixes[prefixes.length - 1];
+    return {
+        Parameter(param, { report, location }) {
+            if (param.type === 'boolean' && !regexp.test(param.name)) {
+                report({
+                    message: `Boolean parameter \`${param.name}\` should have ${prefixesString} prefix.`,
+                    location: location.child('name'),
+                });
+            }
+        },
+    };
+};
+exports.BooleanParameterPrefixes = BooleanParameterPrefixes;

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

@@ -0,0 +1,46 @@
+import { Oas2Rule } from '../../visitors';
+export declare const rules: {
+    spec: Oas2Rule;
+    'no-invalid-schema-examples': any;
+    'no-invalid-parameter-examples': any;
+    'info-description': Oas2Rule;
+    'info-contact': Oas2Rule;
+    'info-license': Oas2Rule;
+    'info-license-url': Oas2Rule;
+    'tag-description': Oas2Rule;
+    'tags-alphabetical': Oas2Rule;
+    'paths-kebab-case': Oas2Rule;
+    'no-enum-type-mismatch': Oas2Rule;
+    'boolean-parameter-prefixes': Oas2Rule;
+    'no-path-trailing-slash': Oas2Rule;
+    'operation-2xx-response': Oas2Rule;
+    'operation-4xx-response': Oas2Rule;
+    assertions: Oas2Rule;
+    'operation-operationId-unique': Oas2Rule;
+    'operation-parameters-unique': Oas2Rule;
+    'path-parameters-defined': Oas2Rule;
+    'operation-tag-defined': Oas2Rule;
+    'path-declaration-must-exist': Oas2Rule;
+    'operation-operationId-url-safe': Oas2Rule;
+    'operation-operationId': Oas2Rule;
+    'operation-summary': Oas2Rule;
+    'operation-description': Oas2Rule;
+    'path-not-include-query': Oas2Rule;
+    'path-params-defined': Oas2Rule;
+    'parameter-description': Oas2Rule;
+    'operation-singular-tag': Oas2Rule;
+    'operation-security-defined': Oas2Rule;
+    'no-unresolved-refs': Oas2Rule;
+    '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;
+    'response-contains-header': Oas2Rule;
+    'response-contains-property': Oas2Rule;
+    'scalar-property-missing-example': import("../../visitors").Oas3Rule | Oas2Rule;
+};
+export declare const preprocessors: {};

package/lib/rules/oas2/index.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preprocessors = exports.rules = void 0;
+const spec_1 = require("../common/spec");
+const no_invalid_schema_examples_1 = require("../common/no-invalid-schema-examples");
+const no_invalid_parameter_examples_1 = require("../common/no-invalid-parameter-examples");
+const info_description_1 = require("../common/info-description");
+const info_contact_1 = require("../common/info-contact");
+const info_license_url_1 = require("../common/info-license-url");
+const license_url_1 = require("../common/license-url");
+const boolean_parameter_prefixes_1 = require("./boolean-parameter-prefixes");
+const tag_description_1 = require("../common/tag-description");
+const tags_alphabetical_1 = require("../common/tags-alphabetical");
+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 assertions_1 = require("../common/assertions");
+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");
+const operation_tag_defined_1 = require("../common/operation-tag-defined");
+const path_declaration_must_exist_1 = require("../common/path-declaration-must-exist");
+const operation_operationId_url_safe_1 = require("../common/operation-operationId-url-safe");
+const operation_description_1 = require("../common/operation-description");
+const path_not_include_query_1 = require("../common/path-not-include-query");
+const parameter_description_1 = require("../common/parameter-description");
+const operation_singular_tag_1 = require("../common/operation-singular-tag");
+const operation_security_defined_1 = require("../common/operation-security-defined");
+const no_unresolved_refs_1 = require("../no-unresolved-refs");
+const path_http_verbs_order_1 = require("../common/path-http-verbs-order");
+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 response_contains_header_1 = require("../common/response-contains-header");
+const response_contains_property_1 = require("./response-contains-property");
+const scalar_property_missing_example_1 = require("../common/scalar-property-missing-example");
+exports.rules = {
+    spec: spec_1.OasSpec,
+    'no-invalid-schema-examples': no_invalid_schema_examples_1.NoInvalidSchemaExamples,
+    'no-invalid-parameter-examples': no_invalid_parameter_examples_1.NoInvalidParameterExamples,
+    'info-description': info_description_1.InfoDescription,
+    'info-contact': info_contact_1.InfoContact,
+    'info-license': info_license_url_1.InfoLicense,
+    'info-license-url': license_url_1.InfoLicenseUrl,
+    'tag-description': tag_description_1.TagDescription,
+    'tags-alphabetical': tags_alphabetical_1.TagsAlphabetical,
+    'paths-kebab-case': paths_kebab_case_1.PathsKebabCase,
+    'no-enum-type-mismatch': no_enum_type_mismatch_1.NoEnumTypeMismatch,
+    '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,
+    'assertions': assertions_1.Assertions,
+    'operation-operationId-unique': operation_operationId_unique_1.OperationIdUnique,
+    'operation-parameters-unique': operation_parameters_unique_1.OperationParametersUnique,
+    'path-parameters-defined': path_params_defined_1.PathParamsDefined,
+    'operation-tag-defined': operation_tag_defined_1.OperationTagDefined,
+    'path-declaration-must-exist': path_declaration_must_exist_1.PathDeclarationMustExist,
+    'operation-operationId-url-safe': operation_operationId_url_safe_1.OperationIdUrlSafe,
+    'operation-operationId': operation_operationId_1.OperationOperationId,
+    'operation-summary': operation_summary_1.OperationSummary,
+    'operation-description': operation_description_1.OperationDescription,
+    'path-not-include-query': path_not_include_query_1.PathNotIncludeQuery,
+    'path-params-defined': path_params_defined_1.PathParamsDefined,
+    'parameter-description': parameter_description_1.ParameterDescription,
+    'operation-singular-tag': operation_singular_tag_1.OperationSingularTag,
+    'operation-security-defined': operation_security_defined_1.OperationSecurityDefined,
+    'no-unresolved-refs': no_unresolved_refs_1.NoUnresolvedRefs,
+    '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,
+    'response-contains-header': response_contains_header_1.ResponseContainsHeader,
+    'response-contains-property': response_contains_property_1.ResponseContainsProperty,
+    'scalar-property-missing-example': scalar_property_missing_example_1.ScalarPropertyMissingExample,
+};
+exports.preprocessors = {};

package/lib/rules/oas2/remove-unused-components.d.ts

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

package/lib/rules/oas2/remove-unused-components.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemoveUnusedComponents = void 0;
+const utils_1 = require("../../utils");
+const RemoveUnusedComponents = () => {
+    let components = new Map();
+    function registerComponent(location, componentType, name) {
+        var _a;
+        components.set(location.absolutePointer, {
+            used: ((_a = components.get(location.absolutePointer)) === null || _a === void 0 ? void 0 : _a.used) || false,
+            componentType,
+            name,
+        });
+    }
+    return {
+        ref: {
+            leave(ref, { type, resolve, key }) {
+                if (['Schema', 'Parameter', 'Response', 'SecurityScheme'].includes(type.name)) {
+                    const resolvedRef = resolve(ref);
+                    if (!resolvedRef.location)
+                        return;
+                    components.set(resolvedRef.location.absolutePointer, {
+                        used: true,
+                        name: key.toString(),
+                    });
+                }
+            }
+        },
+        DefinitionRoot: {
+            leave(root, ctx) {
+                const data = ctx.getVisitorData();
+                data.removedCount = 0;
+                let rootComponents = new Set();
+                components.forEach(usageInfo => {
+                    const { used, name, componentType } = usageInfo;
+                    if (!used && componentType) {
+                        rootComponents.add(componentType);
+                        delete root[componentType][name];
+                        data.removedCount++;
+                    }
+                });
+                for (const component of rootComponents) {
+                    if (utils_1.isEmptyObject(root[component])) {
+                        delete root[component];
+                    }
+                }
+            },
+        },
+        NamedSchemas: {
+            Schema(schema, { location, key }) {
+                if (!schema.allOf) {
+                    registerComponent(location, 'definitions', key.toString());
+                }
+            },
+        },
+        NamedParameters: {
+            Parameter(_parameter, { location, key }) {
+                registerComponent(location, 'parameters', key.toString());
+            },
+        },
+        NamedResponses: {
+            Response(_response, { location, key }) {
+                registerComponent(location, 'responses', key.toString());
+            },
+        },
+        NamedSecuritySchemes: {
+            SecurityScheme(_securityScheme, { location, key }) {
+                registerComponent(location, 'securityDefinitions', key.toString());
+            },
+        }
+    };
+};
+exports.RemoveUnusedComponents = RemoveUnusedComponents;

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-contains-property.d.ts

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

package/lib/rules/oas2/response-contains-property.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseContainsProperty = void 0;
+const utils_1 = require("../../utils");
+const ResponseContainsProperty = (options) => {
+    const names = options.names || {};
+    let key;
+    return {
+        Operation: {
+            Response: {
+                skip: (_response, key) => {
+                    return `${key}` === '204';
+                },
+                enter: (_response, ctx) => {
+                    key = ctx.key;
+                },
+                Schema(schema, { report, location }) {
+                    var _a;
+                    if (schema.type !== 'object')
+                        return;
+                    const expectedProperties = names[key] ||
+                        names[utils_1.getMatchingStatusCodeRange(key)] ||
+                        names[utils_1.getMatchingStatusCodeRange(key).toLowerCase()] ||
+                        [];
+                    for (const expectedProperty of expectedProperties) {
+                        if (!((_a = schema.properties) === null || _a === void 0 ? void 0 : _a[expectedProperty])) {
+                            report({
+                                message: `Response object must contain a top-level "${expectedProperty}" property.`,
+                                location: location.child('properties').key(),
+                            });
+                        }
+                    }
+                },
+            },
+        },
+    };
+};
+exports.ResponseContainsProperty = ResponseContainsProperty;

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/boolean-parameter-prefixes.d.ts

@@ -0,0 +1,5 @@
+import { Oas3Rule } from '../../visitors';
+export declare type BooleanParameterPrefixesOptions = {
+    prefixes?: string[];
+};
+export declare const BooleanParameterPrefixes: Oas3Rule;

package/lib/rules/oas3/boolean-parameter-prefixes.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BooleanParameterPrefixes = void 0;
+const BooleanParameterPrefixes = (options) => {
+    const prefixes = options.prefixes || ['is', 'has'];
+    const regexp = new RegExp(`^(${prefixes.join('|')})[A-Z-_]`);
+    const wrappedPrefixes = prefixes.map((p) => `\`${p}\``);
+    const prefixesString = wrappedPrefixes.length === 1
+        ? wrappedPrefixes[0]
+        : wrappedPrefixes.slice(0, -1).join(', ') + ' or ' + wrappedPrefixes[prefixes.length - 1];
+    return {
+        Parameter: {
+            Schema(schema, { report, parentLocations }, parents) {
+                if (schema.type === 'boolean' && !regexp.test(parents.Parameter.name)) {
+                    report({
+                        message: `Boolean parameter \`${parents.Parameter.name}\` should have ${prefixesString} prefix.`,
+                        location: parentLocations.Parameter.child(['name']),
+                    });
+                }
+            },
+        },
+    };
+};
+exports.BooleanParameterPrefixes = BooleanParameterPrefixes;

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

@@ -0,0 +1,3 @@
+import { Oas3RuleSet } from '../../oas-types';
+export declare const rules: Oas3RuleSet;
+export declare const preprocessors: {};

package/lib/rules/oas3/index.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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 assertions_1 = require("../common/assertions");
+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");
+const operation_tag_defined_1 = require("../common/operation-tag-defined");
+const no_example_value_and_externalValue_1 = require("./no-example-value-and-externalValue");
+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 path_declaration_must_exist_1 = require("../common/path-declaration-must-exist");
+const operation_operationId_url_safe_1 = require("../common/operation-operationId-url-safe");
+const tags_alphabetical_1 = require("../common/tags-alphabetical");
+const no_server_example_com_1 = require("./no-server-example.com");
+const no_server_trailing_slash_1 = require("./no-server-trailing-slash");
+const info_description_1 = require("../common/info-description");
+const tag_description_1 = require("../common/tag-description");
+const info_contact_1 = require("../common/info-contact");
+const info_license_url_1 = require("../common/info-license-url");
+const operation_description_1 = require("../common/operation-description");
+const no_unused_components_1 = require("./no-unused-components");
+const path_not_include_query_1 = require("../common/path-not-include-query");
+const parameter_description_1 = require("../common/parameter-description");
+const operation_singular_tag_1 = require("../common/operation-singular-tag");
+const license_url_1 = require("../common/license-url");
+const operation_security_defined_1 = require("../common/operation-security-defined");
+const no_unresolved_refs_1 = require("../no-unresolved-refs");
+const boolean_parameter_prefixes_1 = require("./boolean-parameter-prefixes");
+const paths_kebab_case_1 = require("../common/paths-kebab-case");
+const path_http_verbs_order_1 = require("../common/path-http-verbs-order");
+const no_empty_servers_1 = require("./no-empty-servers");
+const no_invalid_media_type_examples_1 = require("./no-invalid-media-type-examples");
+const no_identical_paths_1 = require("../common/no-identical-paths");
+const no_undefined_server_variable_1 = require("./no-undefined-server-variable");
+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 path_excludes_patterns_1 = require("../common/path-excludes-patterns");
+const no_invalid_schema_examples_1 = require("../common/no-invalid-schema-examples");
+const no_invalid_parameter_examples_1 = require("../common/no-invalid-parameter-examples");
+const response_contains_header_1 = require("../common/response-contains-header");
+const response_contains_property_1 = require("./response-contains-property");
+const scalar_property_missing_example_1 = require("../common/scalar-property-missing-example");
+exports.rules = {
+    spec: spec_1.OasSpec,
+    'info-description': info_description_1.InfoDescription,
+    'info-contact': info_contact_1.InfoContact,
+    '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,
+    'assertions': assertions_1.Assertions,
+    'operation-operationId-unique': operation_operationId_unique_1.OperationIdUnique,
+    'operation-parameters-unique': operation_parameters_unique_1.OperationParametersUnique,
+    'path-parameters-defined': path_params_defined_1.PathParamsDefined,
+    'operation-tag-defined': operation_tag_defined_1.OperationTagDefined,
+    'no-example-value-and-externalValue': no_example_value_and_externalValue_1.NoExampleValueAndExternalValue,
+    'no-enum-type-mismatch': no_enum_type_mismatch_1.NoEnumTypeMismatch,
+    'no-path-trailing-slash': no_path_trailing_slash_1.NoPathTrailingSlash,
+    'no-empty-servers': no_empty_servers_1.NoEmptyServers,
+    'path-declaration-must-exist': path_declaration_must_exist_1.PathDeclarationMustExist,
+    'operation-operationId-url-safe': operation_operationId_url_safe_1.OperationIdUrlSafe,
+    'operation-operationId': operation_operationId_1.OperationOperationId,
+    'operation-summary': operation_summary_1.OperationSummary,
+    'tags-alphabetical': tags_alphabetical_1.TagsAlphabetical,
+    'no-server-example.com': no_server_example_com_1.NoServerExample,
+    'no-server-trailing-slash': no_server_trailing_slash_1.NoServerTrailingSlash,
+    'tag-description': tag_description_1.TagDescription,
+    'operation-description': operation_description_1.OperationDescription,
+    'no-unused-components': no_unused_components_1.NoUnusedComponents,
+    'path-not-include-query': path_not_include_query_1.PathNotIncludeQuery,
+    'path-params-defined': path_params_defined_1.PathParamsDefined,
+    'parameter-description': parameter_description_1.ParameterDescription,
+    'operation-singular-tag': operation_singular_tag_1.OperationSingularTag,
+    'operation-security-defined': operation_security_defined_1.OperationSecurityDefined,
+    'no-unresolved-refs': no_unresolved_refs_1.NoUnresolvedRefs,
+    'paths-kebab-case': paths_kebab_case_1.PathsKebabCase,
+    'boolean-parameter-prefixes': boolean_parameter_prefixes_1.BooleanParameterPrefixes,
+    'path-http-verbs-order': path_http_verbs_order_1.PathHttpVerbsOrder,
+    'no-invalid-media-type-examples': no_invalid_media_type_examples_1.ValidContentExamples,
+    '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-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,
+    'no-invalid-schema-examples': no_invalid_schema_examples_1.NoInvalidSchemaExamples,
+    'no-invalid-parameter-examples': no_invalid_parameter_examples_1.NoInvalidParameterExamples,
+    'response-contains-header': response_contains_header_1.ResponseContainsHeader,
+    'response-contains-property': response_contains_property_1.ResponseContainsProperty,
+    'scalar-property-missing-example': scalar_property_missing_example_1.ScalarPropertyMissingExample,
+};
+exports.preprocessors = {};

package/lib/rules/oas3/no-empty-servers.d.ts

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

package/lib/rules/oas3/no-empty-servers.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoEmptyServers = void 0;
+const NoEmptyServers = () => {
+    return {
+        DefinitionRoot(root, { report, location }) {
+            if (!root.hasOwnProperty('servers')) {
+                report({
+                    message: 'Servers must be present.',
+                    location: location.child(['openapi']).key()
+                });
+                return;
+            }
+            if (!Array.isArray(root.servers) || root.servers.length === 0) {
+                report({
+                    message: 'Servers must be a non-empty array.',
+                    location: location.child(['servers']).key(),
+                });
+            }
+        },
+    };
+};
+exports.NoEmptyServers = NoEmptyServers;

package/lib/rules/oas3/no-example-value-and-externalValue.d.ts

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

package/lib/rules/oas3/no-example-value-and-externalValue.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoExampleValueAndExternalValue = void 0;
+const NoExampleValueAndExternalValue = () => {
+    return {
+        Example(example, { report, location }) {
+            if (example.value && example.externalValue) {
+                report({
+                    message: 'Example object can have either `value` or `externalValue` fields.',
+                    location: location.child(['value']).key(),
+                });
+            }
+        },
+    };
+};
+exports.NoExampleValueAndExternalValue = NoExampleValueAndExternalValue;

package/lib/rules/oas3/no-invalid-media-type-examples.d.ts

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

package/lib/rules/oas3/no-invalid-media-type-examples.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidContentExamples = void 0;
+const ref_utils_1 = require("../../ref-utils");
+const utils_1 = require("../utils");
+const ValidContentExamples = (opts) => {
+    var _a;
+    const disallowAdditionalProperties = (_a = opts.disallowAdditionalProperties) !== null && _a !== void 0 ? _a : true;
+    return {
+        MediaType: {
+            leave(mediaType, ctx) {
+                const { location, resolve } = ctx;
+                if (!mediaType.schema)
+                    return;
+                if (mediaType.example) {
+                    resolveAndValidateExample(mediaType.example, location.child('example'));
+                }
+                else if (mediaType.examples) {
+                    for (const exampleName of Object.keys(mediaType.examples)) {
+                        resolveAndValidateExample(mediaType.examples[exampleName], location.child(['examples', exampleName, 'value']), true);
+                    }
+                }
+                function resolveAndValidateExample(example, location, isMultiple) {
+                    if (ref_utils_1.isRef(example)) {
+                        const resolved = resolve(example);
+                        if (!resolved.location)
+                            return;
+                        location = isMultiple ? resolved.location.child('value') : resolved.location;
+                        example = resolved.node;
+                    }
+                    utils_1.validateExample(isMultiple ? example.value : example, mediaType.schema, location, ctx, disallowAdditionalProperties);
+                }
+            },
+        },
+    };
+};
+exports.ValidContentExamples = ValidContentExamples;

package/lib/rules/oas3/no-server-example.com.d.ts

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

package/lib/rules/oas3/no-server-example.com.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoServerExample = void 0;
+const NoServerExample = () => {
+    return {
+        Server(server, { report, location }) {
+            if (['example.com', 'localhost'].indexOf(server.url) !== -1) {
+                report({
+                    message: 'Server `url` should not point at example.com.',
+                    location: location.child(['url']),
+                });
+            }
+        },
+    };
+};
+exports.NoServerExample = NoServerExample;

package/lib/rules/oas3/no-server-trailing-slash.d.ts

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