@redocly/openapi-core 0.0.0-snapshot.1737554067

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

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoUnresolvedRefs = void 0;
+exports.reportUnresolvedRef = reportUnresolvedRef;
+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) {
+    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 = resolved.error?.message;
+    report({
+        location,
+        message: `Can't resolve $ref${message ? ': ' + message : ''}`,
+    });
+}

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

@@ -0,0 +1,5 @@
+import type { Oas2Rule } from '../../visitors';
+export 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,3 @@
+import type { Oas2RuleSet } from '../../oas-types';
+export declare const rules: Oas2RuleSet<'built-in'>;
+export declare const preprocessors: {};

package/lib/rules/oas2/index.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preprocessors = exports.rules = void 0;
+const struct_1 = require("../common/struct");
+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_contact_1 = require("../common/info-contact");
+const info_license_1 = require("../common/info-license");
+const info_license_url_1 = require("../common/info-license-url");
+const info_license_strict_1 = require("../common/info-license-strict");
+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 security_defined_1 = require("../common/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");
+const required_string_property_missing_min_length_1 = require("../common/required-string-property-missing-min-length");
+const spec_strict_refs_1 = require("../common/spec-strict-refs");
+const no_required_schema_properties_undefined_1 = require("../common/no-required-schema-properties-undefined");
+exports.rules = {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    //@ts-ignore TODO: This is depricated property `spec` and should be removed in the future
+    spec: struct_1.Struct,
+    struct: struct_1.Struct,
+    'no-invalid-schema-examples': no_invalid_schema_examples_1.NoInvalidSchemaExamples,
+    'no-invalid-parameter-examples': no_invalid_parameter_examples_1.NoInvalidParameterExamples,
+    'info-contact': info_contact_1.InfoContact,
+    'info-license': info_license_1.InfoLicense,
+    'info-license-url': info_license_url_1.InfoLicenseUrl,
+    'info-license-strict': info_license_strict_1.InfoLicenseStrict,
+    '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,
+    'security-defined': security_defined_1.SecurityDefined,
+    '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,
+    'required-string-property-missing-min-length': required_string_property_missing_min_length_1.RequiredStringPropertyMissingMinLength,
+    'spec-strict-refs': spec_strict_refs_1.SpecStrictRefs,
+    'no-required-schema-properties-undefined': no_required_schema_properties_undefined_1.NoRequiredSchemaPropertiesUndefined,
+};
+exports.preprocessors = {};

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

@@ -0,0 +1,2 @@
+import type { 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 {
+        Root(root, ctx) {
+            (0, utils_1.validateMimeType)({ type: 'consumes', value: root }, ctx, allowedValues);
+        },
+        Operation: {
+            leave(operation, ctx) {
+                (0, 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 type { Oas2Rule } from '../../visitors';
+export declare const ResponseContainsProperty: Oas2Rule;

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

@@ -0,0 +1,37 @@
+"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 }) {
+                    if (schema.type !== 'object')
+                        return;
+                    const expectedProperties = names[key] ||
+                        names[(0, utils_1.getMatchingStatusCodeRange)(key)] ||
+                        names[(0, utils_1.getMatchingStatusCodeRange)(key).toLowerCase()] ||
+                        [];
+                    for (const expectedProperty of expectedProperties) {
+                        if (!schema.properties?.[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 type { 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 {
+        Root(root, ctx) {
+            (0, utils_1.validateMimeType)({ type: 'produces', value: root }, ctx, allowedValues);
+        },
+        Operation: {
+            leave(operation, ctx) {
+                (0, utils_1.validateMimeType)({ type: 'produces', value: operation }, ctx, allowedValues);
+            },
+        },
+    };
+};
+exports.ResponseMimeType = ResponseMimeType;

package/lib/rules/oas3/array-parameter-serialization.d.ts

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

package/lib/rules/oas3/array-parameter-serialization.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArrayParameterSerialization = void 0;
+const ref_utils_1 = require("../../ref-utils");
+const ArrayParameterSerialization = (options) => {
+    return {
+        Parameter: {
+            leave(node, ctx) {
+                if (!node.schema) {
+                    return;
+                }
+                const schema = ((0, ref_utils_1.isRef)(node.schema) ? ctx.resolve(node.schema).node : node.schema);
+                if (schema &&
+                    shouldReportMissingStyleAndExplode(node, schema, options)) {
+                    ctx.report({
+                        message: `Parameter \`${node.name}\` should have \`style\` and \`explode \` fields`,
+                        location: ctx.location,
+                    });
+                }
+            },
+        },
+    };
+};
+exports.ArrayParameterSerialization = ArrayParameterSerialization;
+function shouldReportMissingStyleAndExplode(node, schema, options) {
+    return ((schema.type === 'array' || schema.items || schema.prefixItems) &&
+        (node.style === undefined || node.explode === undefined) &&
+        (!options.in || (node.in && options.in?.includes(node.in))));
+}

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

@@ -0,0 +1,5 @@
+import type { Oas3Rule } from '../../visitors';
+export 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/component-name-unique.d.ts

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

package/lib/rules/oas3/component-name-unique.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComponentNameUnique = void 0;
+const TYPE_NAME_SCHEMA = 'Schema';
+const TYPE_NAME_PARAMETER = 'Parameter';
+const TYPE_NAME_RESPONSE = 'Response';
+const TYPE_NAME_REQUEST_BODY = 'RequestBody';
+const TYPE_NAME_TO_OPTION_COMPONENT_NAME = {
+    [TYPE_NAME_SCHEMA]: 'schemas',
+    [TYPE_NAME_PARAMETER]: 'parameters',
+    [TYPE_NAME_RESPONSE]: 'responses',
+    [TYPE_NAME_REQUEST_BODY]: 'requestBodies',
+};
+const ComponentNameUnique = (options) => {
+    const components = new Map();
+    const typeNames = [];
+    if (options.schemas !== 'off') {
+        typeNames.push(TYPE_NAME_SCHEMA);
+    }
+    if (options.parameters !== 'off') {
+        typeNames.push(TYPE_NAME_PARAMETER);
+    }
+    if (options.responses !== 'off') {
+        typeNames.push(TYPE_NAME_RESPONSE);
+    }
+    if (options.requestBodies !== 'off') {
+        typeNames.push(TYPE_NAME_REQUEST_BODY);
+    }
+    const rule = {
+        ref: {
+            leave(ref, { type, resolve }) {
+                const typeName = type.name;
+                if (typeNames.includes(typeName)) {
+                    const resolvedRef = resolve(ref);
+                    if (!resolvedRef.location)
+                        return;
+                    addComponentFromAbsoluteLocation(typeName, resolvedRef.location);
+                }
+            },
+        },
+        Root: {
+            leave(root, ctx) {
+                components.forEach((value, key, _) => {
+                    if (value.absolutePointers.size > 1) {
+                        const component = getComponentFromKey(key);
+                        const optionComponentName = getOptionComponentNameForTypeName(component.typeName);
+                        const componentSeverity = optionComponentName ? options[optionComponentName] : null;
+                        for (const location of value.locations) {
+                            const definitions = Array.from(value.absolutePointers)
+                                .filter((v) => v !== location.absolutePointer.toString())
+                                .map((v) => `- ${v}`)
+                                .join('\n');
+                            const problem = {
+                                message: `Component '${optionComponentName}/${component.componentName}' is not unique. It is also defined at:\n${definitions}`,
+                                location: location,
+                            };
+                            if (componentSeverity) {
+                                problem.forceSeverity = componentSeverity;
+                            }
+                            ctx.report(problem);
+                        }
+                    }
+                });
+            },
+        },
+    };
+    if (options.schemas != 'off') {
+        rule.NamedSchemas = {
+            Schema(_, { location }) {
+                addComponentFromAbsoluteLocation(TYPE_NAME_SCHEMA, location);
+            },
+        };
+    }
+    if (options.responses != 'off') {
+        rule.NamedResponses = {
+            Response(_, { location }) {
+                addComponentFromAbsoluteLocation(TYPE_NAME_RESPONSE, location);
+            },
+        };
+    }
+    if (options.parameters != 'off') {
+        rule.NamedParameters = {
+            Parameter(_, { location }) {
+                addComponentFromAbsoluteLocation(TYPE_NAME_PARAMETER, location);
+            },
+        };
+    }
+    if (options.requestBodies != 'off') {
+        rule.NamedRequestBodies = {
+            RequestBody(_, { location }) {
+                addComponentFromAbsoluteLocation(TYPE_NAME_REQUEST_BODY, location);
+            },
+        };
+    }
+    return rule;
+    function getComponentNameFromAbsoluteLocation(absoluteLocation) {
+        const componentName = absoluteLocation.split('/').slice(-1)[0];
+        if (componentName.endsWith('.yml') ||
+            componentName.endsWith('.yaml') ||
+            componentName.endsWith('.json')) {
+            return componentName.slice(0, componentName.lastIndexOf('.'));
+        }
+        return componentName;
+    }
+    function addFoundComponent(typeName, componentName, location) {
+        const key = getKeyForComponent(typeName, componentName);
+        const entry = components.get(key) ?? {
+            absolutePointers: new Set(),
+            locations: [],
+        };
+        const absoluteLocation = location.absolutePointer.toString();
+        if (!entry.absolutePointers.has(absoluteLocation)) {
+            entry.absolutePointers.add(absoluteLocation);
+            entry.locations.push(location);
+        }
+        components.set(key, entry);
+    }
+    function addComponentFromAbsoluteLocation(typeName, location) {
+        const componentName = getComponentNameFromAbsoluteLocation(location.absolutePointer.toString());
+        addFoundComponent(typeName, componentName, location);
+    }
+};
+exports.ComponentNameUnique = ComponentNameUnique;
+function getOptionComponentNameForTypeName(typeName) {
+    return TYPE_NAME_TO_OPTION_COMPONENT_NAME[typeName] ?? null;
+}
+function getKeyForComponent(typeName, componentName) {
+    return `${typeName}/${componentName}`;
+}
+function getComponentFromKey(key) {
+    const [typeName, componentName] = key.split('/');
+    return { typeName, componentName };
+}

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

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

package/lib/rules/oas3/index.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preprocessors = exports.rules = void 0;
+const struct_1 = require("../common/struct");
+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 tag_description_1 = require("../common/tag-description");
+const info_contact_1 = require("../common/info-contact");
+const info_license_1 = require("../common/info-license");
+const info_license_url_1 = require("../common/info-license-url");
+const info_license_strict_1 = require("../common/info-license-strict");
+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 security_defined_1 = require("../common/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_server_variables_empty_enum_1 = require("./no-server-variables-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");
+const spec_components_invalid_map_name_1 = require("./spec-components-invalid-map-name");
+const operation_4xx_problem_details_rfc7807_1 = require("./operation-4xx-problem-details-rfc7807");
+const required_string_property_missing_min_length_1 = require("../common/required-string-property-missing-min-length");
+const spec_strict_refs_1 = require("../common/spec-strict-refs");
+const component_name_unique_1 = require("./component-name-unique");
+const array_parameter_serialization_1 = require("./array-parameter-serialization");
+const no_required_schema_properties_undefined_1 = require("../common/no-required-schema-properties-undefined");
+exports.rules = {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    //@ts-ignore TODO: This is depricated property `spec` and should be removed in the future
+    spec: struct_1.Struct,
+    struct: struct_1.Struct,
+    'info-contact': info_contact_1.InfoContact,
+    'info-license': info_license_1.InfoLicense,
+    'info-license-url': info_license_url_1.InfoLicenseUrl,
+    'info-license-strict': info_license_strict_1.InfoLicenseStrict,
+    'operation-2xx-response': operation_2xx_response_1.Operation2xxResponse,
+    'operation-4xx-response': operation_4xx_response_1.Operation4xxResponse,
+    'operation-4xx-problem-details-rfc7807': operation_4xx_problem_details_rfc7807_1.Operation4xxProblemDetailsRfc7807,
+    assertions: assertions_1.Assertions,
+    'operation-operationId-unique': operation_operationId_unique_1.OperationIdUnique,
+    'operation-parameters-unique': operation_parameters_unique_1.OperationParametersUnique,
+    '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-parameters-defined': path_params_defined_1.PathParamsDefined,
+    'path-params-defined': path_params_defined_1.PathParamsDefined,
+    'parameter-description': parameter_description_1.ParameterDescription,
+    'operation-singular-tag': operation_singular_tag_1.OperationSingularTag,
+    'security-defined': security_defined_1.SecurityDefined,
+    '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-server-variables-empty-enum': no_server_variables_empty_enum_1.NoServerVariablesEmptyEnum,
+    '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,
+    'spec-components-invalid-map-name': spec_components_invalid_map_name_1.SpecComponentsInvalidMapName,
+    'required-string-property-missing-min-length': required_string_property_missing_min_length_1.RequiredStringPropertyMissingMinLength,
+    'spec-strict-refs': spec_strict_refs_1.SpecStrictRefs,
+    'component-name-unique': component_name_unique_1.ComponentNameUnique,
+    'array-parameter-serialization': array_parameter_serialization_1.ArrayParameterSerialization,
+    'no-required-schema-properties-undefined': no_required_schema_properties_undefined_1.NoRequiredSchemaPropertiesUndefined,
+};
+exports.preprocessors = {};

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

@@ -0,0 +1,2 @@
+import type { 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 {
+        Root(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 type { Oas3Rule } from '../../visitors';
+export declare const NoExampleValueAndExternalValue: Oas3Rule;