@redocly/openapi-core 1.0.0-beta.65 → 1.0.0-beta.69

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,9 +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,
@@ -49,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,
@@ -81,6 +88,11 @@ exports.rules = {
     '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,
 };
 exports.preprocessors = {};
 exports.decorators = {

package/lib/rules/oas3/no-server-trailing-slash.js

@@ -6,7 +6,7 @@ const NoServerTrailingSlash = () => {
         Server(server, { report, location }) {
             if (!server.url)
                 return;
-            if (server.url.endsWith('/')) {
+            if (server.url.endsWith('/') && server.url !== '/') {
                 report({
                     message: 'Server `url` should not have a trailing slash.',
                     location: location.child(['url']),

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' },

package/lib/utils.d.ts

@@ -1,4 +1,5 @@
 import { HttpResolveConfig } from './config/config';
+import { UserContext } from './walk';
 export { parseYaml, stringifyYaml } from './js-yaml';
 export declare type StackFrame<T> = {
     prev: StackFrame<T> | null;
@@ -22,4 +23,13 @@ export declare function readFileFromUrl(url: string, config: HttpResolveConfig):
 export declare function match(url: string, pattern: string): boolean;
 export declare function pickObjectProps<T extends Record<string, unknown>>(object: T, keys: Array<string>): T;
 export declare function omitObjectProps<T extends Record<string, unknown>>(object: T, keys: Array<string>): T;
+export declare function splitCamelCaseIntoWords(str: string): Set<string>;
+export declare function validateMimeType({ type, value }: any, { report, location }: UserContext, allowedValues: string[]): void;
+export declare function validateMimeTypeOAS3({ type, value }: any, { report, location }: UserContext, allowedValues: string[]): void;
+export declare function isSingular(path: string): boolean;
 export declare function readFileAsStringSync(filePath: string): string;
+export declare function isPathParameter(pathSegment: string): boolean;
+/**
+ * Convert Windows backslash paths to slash paths: foo\\bar ➔ foo/bar
+ */
+export declare function slash(path: string): string;

package/lib/utils.js

@@ -9,10 +9,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readFileAsStringSync = exports.omitObjectProps = exports.pickObjectProps = exports.match = exports.readFileFromUrl = exports.isPlainObject = exports.notUndefined = exports.loadYaml = exports.popStack = exports.pushStack = exports.stringifyYaml = exports.parseYaml = void 0;
+exports.slash = exports.isPathParameter = exports.readFileAsStringSync = exports.isSingular = exports.validateMimeTypeOAS3 = exports.validateMimeType = exports.splitCamelCaseIntoWords = exports.omitObjectProps = exports.pickObjectProps = exports.match = exports.readFileFromUrl = exports.isPlainObject = exports.notUndefined = exports.loadYaml = exports.popStack = exports.pushStack = exports.stringifyYaml = exports.parseYaml = void 0;
 const fs = require("fs");
 const minimatch = require("minimatch");
 const node_fetch_1 = require("node-fetch");
+const pluralize = require("pluralize");
 const js_yaml_1 = require("./js-yaml");
 var js_yaml_2 = require("./js-yaml");
 Object.defineProperty(exports, "parseYaml", { enumerable: true, get: function () { return js_yaml_2.parseYaml; } });
@@ -76,7 +77,70 @@ function omitObjectProps(object, keys) {
     return Object.fromEntries(Object.entries(object).filter(([key]) => !keys.includes(key)));
 }
 exports.omitObjectProps = omitObjectProps;
+function splitCamelCaseIntoWords(str) {
+    const camel = str
+        .split(/(?:[-._])|([A-Z][a-z]+)/)
+        .filter(Boolean)
+        .map((item) => item.toLocaleLowerCase());
+    const caps = str
+        .split(/([A-Z]{2,})/)
+        .filter((e) => e && e === e.toUpperCase())
+        .map((item) => item.toLocaleLowerCase());
+    return new Set([...camel, ...caps]);
+}
+exports.splitCamelCaseIntoWords = splitCamelCaseIntoWords;
+function validateMimeType({ type, value }, { report, location }, allowedValues) {
+    const ruleType = type === 'consumes' ? 'request' : 'response';
+    if (!allowedValues)
+        throw new Error(`Parameter "allowedValues" is not provided for "${ruleType}-mime-type" rule`);
+    if (!value[type])
+        return;
+    for (const mime of value[type]) {
+        if (!allowedValues.includes(mime)) {
+            report({
+                message: `Mime type "${mime}" is not allowed`,
+                location: location.child(value[type].indexOf(mime)).key(),
+            });
+        }
+    }
+}
+exports.validateMimeType = validateMimeType;
+function validateMimeTypeOAS3({ type, value }, { report, location }, allowedValues) {
+    const ruleType = type === 'consumes' ? 'request' : 'response';
+    if (!allowedValues)
+        throw new Error(`Parameter "allowedValues" is not provided for "${ruleType}-mime-type" rule`);
+    if (!value.content)
+        return;
+    for (const mime of Object.keys(value.content)) {
+        if (!allowedValues.includes(mime)) {
+            report({
+                message: `Mime type "${mime}" is not allowed`,
+                location: location.child('content').child(mime).key(),
+            });
+        }
+    }
+}
+exports.validateMimeTypeOAS3 = validateMimeTypeOAS3;
+function isSingular(path) {
+    return pluralize.isSingular(path);
+}
+exports.isSingular = isSingular;
 function readFileAsStringSync(filePath) {
     return fs.readFileSync(filePath, 'utf-8');
 }
 exports.readFileAsStringSync = readFileAsStringSync;
+function isPathParameter(pathSegment) {
+    return pathSegment.startsWith('{') && pathSegment.endsWith('{');
+}
+exports.isPathParameter = isPathParameter;
+/**
+ * Convert Windows backslash paths to slash paths: foo\\bar ➔ foo/bar
+ */
+function slash(path) {
+    const isExtendedLengthPath = /^\\\\\?\\/.test(path);
+    if (isExtendedLengthPath) {
+        return path;
+    }
+    return path.replace(/\\/g, '/');
+}
+exports.slash = slash;

package/lib/walk.d.ts

@@ -36,6 +36,7 @@ export declare type UserContext = {
     key: string | number;
     parent: any;
     oasVersion: OasVersion;
+    getVisitorData: () => Record<string, unknown>;
 };
 export declare type Loc = {
     line: number;
@@ -72,6 +73,7 @@ export declare type NormalizedProblem = {
 export declare type WalkContext = {
     problems: NormalizedProblem[];
     oasVersion: OasVersion;
+    visitorsData: Record<string, Record<string, unknown>>;
     refTypes?: Map<string, NormalizedNodeType>;
 };
 export declare function walkDocument<T>(opts: {

package/lib/walk.js

@@ -50,6 +50,7 @@ function walkDocument(opts) {
                         key,
                         parentLocations: {},
                         oasVersion: ctx.oasVersion,
+                        getVisitorData: getVisitorDataFn.bind(undefined, ruleId)
                     }, { node: resolvedNode, location: resolvedLocation, error });
                     if ((resolvedLocation === null || resolvedLocation === void 0 ? void 0 : resolvedLocation.source.absoluteRef) && ctx.refTypes) {
                         ctx.refTypes.set(resolvedLocation === null || resolvedLocation === void 0 ? void 0 : resolvedLocation.source.absoluteRef, type);
@@ -192,6 +193,7 @@ function walkDocument(opts) {
                         key,
                         parentLocations: {},
                         oasVersion: ctx.oasVersion,
+                        getVisitorData: getVisitorDataFn.bind(undefined, ruleId)
                     }, { node: resolvedNode, location: resolvedLocation, error });
                 }
             }
@@ -212,6 +214,7 @@ function walkDocument(opts) {
                 ignoreNextVisitorsOnNode: () => {
                     ignoreNextVisitorsOnNode = true;
                 },
+                getVisitorData: getVisitorDataFn.bind(undefined, ruleId),
             }, collectParents(context), context);
             return ignoreNextVisitorsOnNode;
         }
@@ -244,6 +247,10 @@ function walkDocument(opts) {
                     return Object.assign(Object.assign(Object.assign({}, currentLocation), { reportOnKey: false }), loc);
                 }) }));
         }
+        function getVisitorDataFn(ruleId) {
+            ctx.visitorsData[ruleId] = ctx.visitorsData[ruleId] || {};
+            return ctx.visitorsData[ruleId];
+        }
     }
 }
 exports.walkDocument = walkDocument;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redocly/openapi-core",
-  "version": "1.0.0-beta.65",
+  "version": "1.0.0-beta.69",
   "description": "",
   "main": "lib/index.js",
   "engines": {
@@ -30,7 +30,7 @@
     "Andriy Leliv <andriy@redoc.ly> (https://redoc.ly/)"
   ],
   "dependencies": {
-    "@redocly/ajv": "^8.6.2",
+    "@redocly/ajv": "^8.6.4",
     "@types/node": "^14.11.8",
     "colorette": "^1.2.0",
     "js-levenshtein": "^1.1.6",
@@ -38,6 +38,7 @@
     "lodash.isequal": "^4.5.0",
     "minimatch": "^3.0.4",
     "node-fetch": "^2.6.1",
+    "pluralize": "^8.0.0",
     "yaml-ast-parser": "0.0.43"
   },
   "devDependencies": {
@@ -46,6 +47,7 @@
     "@types/lodash.isequal": "^4.5.5",
     "@types/minimatch": "^3.0.3",
     "@types/node-fetch": "^2.5.7",
+    "@types/pluralize": "^0.0.29",
     "typescript": "^4.0.5"
   }
-}
+}

package/src/__tests__/utils.test.ts

@@ -1,4 +1,4 @@
-import { pickObjectProps, omitObjectProps } from '../utils';
+import { pickObjectProps, omitObjectProps, slash } from '../utils';
 
 describe('utils', () => {
   const testObject = {
@@ -53,4 +53,22 @@ describe('utils', () => {
       expect(omitObjectProps({}, ['d', 'e'])).toStrictEqual({});
     });
   });
+
+  describe('slash path', () => {
+    it('can correctly slash path', () => {
+      [
+        ['foo\\bar', 'foo/bar'],
+        ['foo/bar', 'foo/bar'],
+        ['foo\\中文', 'foo/中文'],
+        ['foo/中文', 'foo/中文'],
+      ].forEach(([path, expectRes]) => {
+        expect(slash(path)).toBe(expectRes);
+      });
+    });
+
+    it('does not modify extended length paths', () => {
+      const extended = '\\\\?\\some\\path';
+      expect(slash(extended)).toBe(extended);
+    });
+  });
 });

package/src/bundle.ts

@@ -7,12 +7,13 @@ import { Oas3_1Types } from './types/oas3_1';
 import { NormalizedNodeType, normalizeTypes, NodeType } from './types';
 import { WalkContext, walkDocument, UserContext, ResolveResult } from './walk';
 import { detectOpenAPI, openAPIMajor, OasMajorVersion } from './oas-types';
-import { Location, refBaseName } from './ref-utils';
+import { isRef, Location, refBaseName } from './ref-utils';
 import type { Config, LintConfig } from './config/config';
 import { initRules } from './config/rules';
 import { reportUnresolvedRef } from './rules/no-unresolved-refs';
 import { isPlainObject } from './utils';
 import { OasRef } from './typings/openapi';
+import { isRedoclyRegistryURL } from './redocly';
 
 export type Oas3RuleSet = Record<string, Oas3Rule>;
 
@@ -29,6 +30,7 @@ export async function bundle(opts: {
   config: Config;
   dereference?: boolean;
   base?: string;
+  skipRedoclyRegistryRefs?: boolean;
 }) {
   const {
     ref,
@@ -40,7 +42,8 @@ export async function bundle(opts: {
     throw new Error('Document or reference is required.\n');
   }
 
-  const document = doc !== undefined ? doc : await externalRefResolver.resolveDocument(base, ref!, true);
+  const document =
+    doc !== undefined ? doc : await externalRefResolver.resolveDocument(base, ref!, true);
 
   if (document instanceof Error) {
     throw document;
@@ -62,14 +65,26 @@ export async function bundleDocument(opts: {
   customTypes?: Record<string, NodeType>;
   externalRefResolver: BaseResolver;
   dereference?: boolean;
+  skipRedoclyRegistryRefs?: boolean;
 }) {
-  const { document, config, customTypes, externalRefResolver, dereference = false } = opts;
+  const {
+    document,
+    config,
+    customTypes,
+    externalRefResolver,
+    dereference = false,
+    skipRedoclyRegistryRefs = false,
+  } = opts;
   const oasVersion = detectOpenAPI(document.parsed);
   const oasMajorVersion = openAPIMajor(oasVersion);
   const rules = config.getRulesForOasVersion(oasMajorVersion);
   const types = normalizeTypes(
     config.extendTypes(
-      customTypes ?? oasMajorVersion === OasMajorVersion.Version3 ? (oasVersion === OasVersion.Version3_1 ? Oas3_1Types : Oas3Types) : Oas2Types,
+      customTypes ?? oasMajorVersion === OasMajorVersion.Version3
+        ? oasVersion === OasVersion.Version3_1
+          ? Oas3_1Types
+          : Oas3Types
+        : Oas2Types,
       oasVersion,
     ),
     config,
@@ -81,6 +96,7 @@ export async function bundleDocument(opts: {
     problems: [],
     oasVersion: oasVersion,
     refTypes: new Map<string, NormalizedNodeType>(),
+    visitorsData: {},
   };
 
   const bundleVisitor = normalizeVisitors(
@@ -89,7 +105,7 @@ export async function bundleDocument(opts: {
       {
         severity: 'error',
         ruleId: 'bundler',
-        visitor: makeBundleVisitor(oasMajorVersion, dereference, document),
+        visitor: makeBundleVisitor(oasMajorVersion, dereference, skipRedoclyRegistryRefs, document),
       },
       ...decorators,
     ],
@@ -116,6 +132,7 @@ export async function bundleDocument(opts: {
     fileDependencies: externalRefResolver.getFiles(),
     rootType: types.DefinitionRoot,
     refTypes: ctx.refTypes,
+    visitorsData: ctx.visitorsData,
   };
 }
 
@@ -160,7 +177,12 @@ function mapTypeToComponent(typeName: string, version: OasMajorVersion) {
 
 // function oas3Move
 
-function makeBundleVisitor(version: OasMajorVersion, dereference: boolean, rootDocument: Document) {
+function makeBundleVisitor(
+  version: OasMajorVersion,
+  dereference: boolean,
+  skipRedoclyRegistryRefs: boolean,
+  rootDocument: Document,
+) {
   let components: Record<string, Record<string, any>>;
 
   const visitor: Oas3Visitor | Oas2Visitor = {
@@ -178,6 +200,11 @@ function makeBundleVisitor(version: OasMajorVersion, dereference: boolean, rootD
         ) {
           return;
         }
+
+        if (skipRedoclyRegistryRefs && isRedoclyRegistryURL(node.$ref)) {
+          return;
+        }
+
         const componentType = mapTypeToComponent(ctx.type.name, version);
         if (!componentType) {
           replaceRef(node, resolved, ctx);
@@ -249,6 +276,21 @@ function makeBundleVisitor(version: OasMajorVersion, dereference: boolean, rootD
     }
   }
 
+  function isEqualOrEqualRef(
+    node: any,
+    target: { node: any; location: Location },
+    ctx: UserContext,
+  ) {
+    if (
+      isRef(node) &&
+      ctx.resolve(node).location?.absolutePointer === target.location.absolutePointer
+    ) {
+      return true;
+    }
+
+    return isEqual(node, target.node);
+  }
+
   function getComponentName(
     target: { node: any; location: Location },
     componentType: string,
@@ -265,20 +307,20 @@ function makeBundleVisitor(version: OasMajorVersion, dereference: boolean, rootD
       if (
         !componentsGroup ||
         !componentsGroup[name] ||
-        isEqual(componentsGroup[name], target.node)
+        isEqualOrEqualRef(componentsGroup[name], target, ctx)
       ) {
         return name;
       }
     }
 
     name = refBaseName(fileRef) + (name ? `_${name}` : '');
-    if (!componentsGroup[name] || isEqual(componentsGroup[name], target.node)) {
+    if (!componentsGroup[name] || isEqualOrEqualRef(componentsGroup[name], target, ctx)) {
       return name;
     }
 
     const prevName = name;
     let serialId = 2;
-    while (componentsGroup[name] && !isEqual(componentsGroup[name], target.node)) {
+    while (componentsGroup[name] && !isEqualOrEqualRef(componentsGroup[name], target, ctx)) {
       name = `${prevName}-${serialId}`;
       serialId++;
     }

package/src/config/all.ts

@@ -12,11 +12,13 @@ export 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 @@ export 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 @@ export default {
     'no-unused-components': 'error',
     'no-undefined-server-variable': 'error',
     'no-servers-empty-enum': 'error',
-  }
+  },
 } as LintRawConfig;

package/src/config/config.ts

@@ -4,7 +4,7 @@ import { dirname } from 'path';
 import { red, blue } from 'colorette';
 
 import { parseYaml, stringifyYaml } from '../js-yaml';
-import { notUndefined } from '../utils';
+import { notUndefined, slash } from '../utils';
 
 import {
   OasVersion,
@@ -211,7 +211,7 @@ export class LintConfig {
     const ignoreFile = path.join(dir, IGNORE_FILE);
     const mapped: Record<string, any> = {};
     for (const absFileName of Object.keys(this.ignore)) {
-      const ignoredRules = (mapped[path.relative(dir, absFileName)] = this.ignore[absFileName]);
+      const ignoredRules = (mapped[slash(path.relative(dir, absFileName))] = this.ignore[absFileName]);
       for (const ruleId of Object.keys(ignoredRules)) {
         ignoredRules[ruleId] = Array.from(ignoredRules[ruleId]) as any;
       }

package/src/config/minimal.ts

@@ -17,6 +17,7 @@ export 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/src/config/recommended.ts

@@ -17,6 +17,7 @@ export 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/src/index.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/src/lint.ts

@@ -72,6 +72,7 @@ export async function lintDocument(opts: {
   const ctx: WalkContext = {
     problems: [],
     oasVersion: oasVersion,
+    visitorsData: {},
   };
 
   const preprocessors = initRules(rules as any, config, 'preprocessors', oasVersion);
@@ -101,6 +102,7 @@ export async function lintConfig(opts: {
   const ctx: WalkContext = {
     problems: [],
     oasVersion: OasVersion.Version3_0,
+    visitorsData: {},
   };
   const config = new LintConfig({
     plugins: [defaultPlugin],