@redocly/openapi-core 1.0.0-beta.102 → 1.0.0-beta.105

package/__tests__/utils.ts

@@ -48,7 +48,7 @@ export const yamlSerializer = {
 export function makeConfigForRuleset(
   rules: Oas3RuleSet,
   plugin?: Partial<Plugin>,
-  version: string = 'oas3',
+  version: string = 'oas3'
 ) {
   const rulesConf: Record<string, RuleConfig> = {};
   const ruleId = 'test';
@@ -72,6 +72,7 @@ export function makeConfigForRuleset(
 export async function makeConfig(
   rules: Record<string, RuleConfig>,
   decorators?: Record<string, DecoratorConfig>,
+  configPath?: string
 ) {
   return new LintConfig(
     await resolveLint({
@@ -82,5 +83,6 @@ export async function makeConfig(
         decorators,
       },
     }),
+    configPath
   );
 }

package/lib/config/config.d.ts

@@ -26,18 +26,19 @@ export declare class LintConfig {
     extendPaths: string[];
     pluginPaths: string[];
     constructor(rawConfig: ResolvedLintConfig, configFile?: string | undefined);
+    resolveIgnore(ignoreFile?: string): void;
     saveIgnore(): void;
     addIgnore(problem: NormalizedProblem): void;
     addProblemToIgnore(problem: NormalizedProblem): NormalizedProblem;
     extendTypes(types: Record<string, NodeType>, version: OasVersion): Record<string, NodeType>;
     getRuleSettings(ruleId: string, oasVersion: OasVersion): {
-        severity: import("../walk").ProblemSeverity | "off";
+        severity: import("./types").RuleSeverity;
     };
     getPreprocessorSettings(ruleId: string, oasVersion: OasVersion): {
-        severity: import("../walk").ProblemSeverity | "off";
+        severity: import("./types").RuleSeverity;
     };
     getDecoratorSettings(ruleId: string, oasVersion: OasVersion): {
-        severity: import("../walk").ProblemSeverity | "off";
+        severity: import("./types").RuleSeverity;
     };
     getUnusedRules(): {
         rules: string[];

package/lib/config/config.js

@@ -28,6 +28,16 @@ function getDomains() {
     }
     return domains;
 }
+function getIgnoreFilePath(configFile) {
+    if (configFile) {
+        return utils_1.doesYamlFileExist(configFile)
+            ? path.join(path.dirname(configFile), exports.IGNORE_FILE)
+            : path.join(configFile, exports.IGNORE_FILE);
+    }
+    else {
+        return typeof process === 'undefined' ? undefined : path.join(process.cwd(), exports.IGNORE_FILE);
+    }
+}
 exports.DOMAINS = getDomains();
 exports.AVAILABLE_REGIONS = Object.keys(exports.DOMAINS);
 class LintConfig {
@@ -57,23 +67,20 @@ class LintConfig {
         };
         this.extendPaths = rawConfig.extendPaths || [];
         this.pluginPaths = rawConfig.pluginPaths || [];
-        const dir = this.configFile
-            ? path.dirname(this.configFile)
-            : (typeof process !== 'undefined' && process.cwd()) || '';
-        const ignoreFile = path.join(dir, exports.IGNORE_FILE);
-        /* no crash when using it on the client */
-        if (fs.hasOwnProperty('existsSync') && fs.existsSync(ignoreFile)) {
-            // TODO: parse errors
-            this.ignore =
-                js_yaml_1.parseYaml(fs.readFileSync(ignoreFile, 'utf-8')) || {};
-            // resolve ignore paths
-            for (const fileName of Object.keys(this.ignore)) {
-                this.ignore[path.resolve(path.dirname(ignoreFile), fileName)] = this.ignore[fileName];
-                for (const ruleId of Object.keys(this.ignore[fileName])) {
-                    this.ignore[fileName][ruleId] = new Set(this.ignore[fileName][ruleId]);
-                }
-                delete this.ignore[fileName];
+        this.resolveIgnore(getIgnoreFilePath(configFile));
+    }
+    resolveIgnore(ignoreFile) {
+        if (!ignoreFile || !utils_1.doesYamlFileExist(ignoreFile))
+            return;
+        this.ignore =
+            js_yaml_1.parseYaml(fs.readFileSync(ignoreFile, 'utf-8')) || {};
+        // resolve ignore paths
+        for (const fileName of Object.keys(this.ignore)) {
+            this.ignore[path.resolve(path.dirname(ignoreFile), fileName)] = this.ignore[fileName];
+            for (const ruleId of Object.keys(this.ignore[fileName])) {
+                this.ignore[fileName][ruleId] = new Set(this.ignore[fileName][ruleId]);
             }
+            delete this.ignore[fileName];
         }
     }
     saveIgnore() {

package/lib/config/load.d.ts

@@ -1,6 +1,6 @@
 import { Config } from './config';
 import type { RawConfig } from './types';
-export declare function loadConfig(configPath?: string | undefined, customExtends?: string[]): Promise<Config>;
+export declare function loadConfig(configPath?: string | undefined, customExtends?: string[], processRawConfig?: (rawConfig: RawConfig) => void | Promise<void>): Promise<Config>;
 export declare const CONFIG_FILE_NAMES: string[];
 export declare function findConfig(dir?: string): string | undefined;
 export declare function getConfig(configPath?: string | undefined): Promise<RawConfig>;

package/lib/config/load.js

@@ -17,10 +17,9 @@ const utils_1 = require("../utils");
 const config_1 = require("./config");
 const utils_2 = require("./utils");
 const config_resolvers_1 = require("./config-resolvers");
-function loadConfig(configPath = findConfig(), customExtends) {
+function addConfigMetadata({ rawConfig, customExtends, configPath, }) {
     var _a;
     return __awaiter(this, void 0, void 0, function* () {
-        const rawConfig = yield getConfig(configPath);
         if (customExtends !== undefined) {
             rawConfig.lint = rawConfig.lint || {};
             rawConfig.lint.extends = customExtends;
@@ -61,6 +60,19 @@ function loadConfig(configPath = findConfig(), customExtends) {
         return config_resolvers_1.resolveConfig(rawConfig, configPath);
     });
 }
+function loadConfig(configPath = findConfig(), customExtends, processRawConfig) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const rawConfig = yield getConfig(configPath);
+        if (typeof processRawConfig === 'function') {
+            yield processRawConfig(rawConfig);
+        }
+        return yield addConfigMetadata({
+            rawConfig,
+            customExtends,
+            configPath,
+        });
+    });
+}
 exports.loadConfig = loadConfig;
 exports.CONFIG_FILE_NAMES = ['redocly.yaml', 'redocly.yml', '.redocly.yaml', '.redocly.yml'];
 function findConfig(dir) {
@@ -79,7 +91,7 @@ function findConfig(dir) {
 exports.findConfig = findConfig;
 function getConfig(configPath = findConfig()) {
     return __awaiter(this, void 0, void 0, function* () {
-        if (!configPath)
+        if (!configPath || !utils_1.doesYamlFileExist(configPath))
             return {};
         try {
             const rawConfig = ((yield utils_1.loadYaml(configPath)) || {});

package/lib/config/rules.d.ts

@@ -1,7 +1,7 @@
 import { RuleSet, OasVersion } from '../oas-types';
 import { LintConfig } from './config';
 export declare function initRules<T extends Function, P extends RuleSet<T>>(rules: P[], config: LintConfig, type: 'rules' | 'preprocessors' | 'decorators', oasVersion: OasVersion): {
-    severity: import("..").ProblemSeverity | "off";
+    severity: import("./types").RuleSeverity;
     ruleId: string;
     visitor: any;
 }[];

package/lib/config/types.d.ts

@@ -1,10 +1,12 @@
 import type { ProblemSeverity } from '../walk';
 import type { Oas3PreprocessorsSet, OasMajorVersion, Oas3DecoratorsSet, Oas2RuleSet, Oas2PreprocessorsSet, Oas2DecoratorsSet, Oas3RuleSet, OasVersion } from '../oas-types';
 import type { NodeType } from '../types';
-export declare type RuleConfig = ProblemSeverity | 'off' | ({
+export declare type RuleSeverity = ProblemSeverity | 'off';
+export declare type PreprocessorSeverity = RuleSeverity | 'on';
+export declare type RuleConfig = RuleSeverity | ({
     severity?: ProblemSeverity;
 } & Record<string, any>);
-export declare type PreprocessorConfig = ProblemSeverity | 'off' | 'on' | ({
+export declare type PreprocessorConfig = PreprocessorSeverity | ({
     severity?: ProblemSeverity;
 } & Record<string, any>);
 export declare type DecoratorConfig = PreprocessorConfig;

package/lib/decorators/common/filters/filter-helper.d.ts

@@ -0,0 +1,3 @@
+import { UserContext } from '../../../walk';
+export declare function filter(node: any, ctx: UserContext, criteria: (item: any) => boolean): void;
+export declare function checkIfMatchByStrategy(nodeValue: any, decoratorValue: any, strategy: 'all' | 'any'): boolean;

package/lib/decorators/common/filters/filter-helper.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkIfMatchByStrategy = exports.filter = void 0;
+const ref_utils_1 = require("../../../ref-utils");
+const utils_1 = require("../../../utils");
+function filter(node, ctx, criteria) {
+    const { parent, key } = ctx;
+    let didDelete = false;
+    if (Array.isArray(node)) {
+        for (let i = 0; i < node.length; i++) {
+            if (ref_utils_1.isRef(node[i])) {
+                const resolved = ctx.resolve(node[i]);
+                if (criteria(resolved.node)) {
+                    node.splice(i, 1);
+                    didDelete = true;
+                    i--;
+                }
+            }
+            if (criteria(node[i])) {
+                node.splice(i, 1);
+                didDelete = true;
+                i--;
+            }
+        }
+    }
+    else if (utils_1.isPlainObject(node)) {
+        for (const key of Object.keys(node)) {
+            node = node;
+            if (ref_utils_1.isRef(node[key])) {
+                const resolved = ctx.resolve(node[key]);
+                if (criteria(resolved.node)) {
+                    delete node[key];
+                    didDelete = true;
+                }
+            }
+            if (criteria(node[key])) {
+                delete node[key];
+                didDelete = true;
+            }
+        }
+    }
+    if (didDelete && (utils_1.isEmptyObject(node) || utils_1.isEmptyArray(node))) {
+        delete parent[key];
+    }
+}
+exports.filter = filter;
+function checkIfMatchByStrategy(nodeValue, decoratorValue, strategy) {
+    if (nodeValue === undefined || decoratorValue === undefined) {
+        return false;
+    }
+    if (!Array.isArray(decoratorValue) && !Array.isArray(nodeValue)) {
+        return nodeValue === decoratorValue;
+    }
+    decoratorValue = toArrayIfNeeded(decoratorValue);
+    nodeValue = toArrayIfNeeded(nodeValue);
+    if (strategy === 'any') {
+        return decoratorValue.some((item) => nodeValue.includes(item));
+    }
+    if (strategy === 'all') {
+        return decoratorValue.every((item) => nodeValue.includes(item));
+    }
+    return false;
+}
+exports.checkIfMatchByStrategy = checkIfMatchByStrategy;
+function toArrayIfNeeded(value) {
+    return Array.isArray(value) ? value : [value];
+}

package/lib/decorators/common/filters/filter-in.d.ts

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

package/lib/decorators/common/filters/filter-in.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilterIn = void 0;
+const filter_helper_1 = require("./filter-helper");
+const DEFAULT_STRATEGY = 'any';
+const FilterIn = ({ property, value, matchStrategy }) => {
+    const strategy = matchStrategy || DEFAULT_STRATEGY;
+    const filterInCriteria = (item) => (item === null || item === void 0 ? void 0 : item[property]) && !filter_helper_1.checkIfMatchByStrategy(item === null || item === void 0 ? void 0 : item[property], value, strategy);
+    return {
+        any: {
+            enter: (node, ctx) => {
+                filter_helper_1.filter(node, ctx, filterInCriteria);
+            },
+        },
+    };
+};
+exports.FilterIn = FilterIn;

package/lib/decorators/common/filters/filter-out.d.ts

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

package/lib/decorators/common/filters/filter-out.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilterOut = void 0;
+const filter_helper_1 = require("./filter-helper");
+const DEFAULT_STRATEGY = 'any';
+const FilterOut = ({ property, value, matchStrategy }) => {
+    const strategy = matchStrategy || DEFAULT_STRATEGY;
+    const filterOutCriteria = (item) => filter_helper_1.checkIfMatchByStrategy(item === null || item === void 0 ? void 0 : item[property], value, strategy);
+    return {
+        any: {
+            enter: (node, ctx) => {
+                filter_helper_1.filter(node, ctx, filterOutCriteria);
+            },
+        },
+    };
+};
+exports.FilterOut = FilterOut;

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

@@ -5,4 +5,6 @@ export declare const decorators: {
     'tag-description-override': Oas2Decorator;
     'info-description-override': Oas2Decorator;
     'remove-x-internal': Oas2Decorator;
+    'filter-in': Oas2Decorator;
+    'filter-out': Oas2Decorator;
 };

package/lib/decorators/oas2/index.js

@@ -6,10 +6,14 @@ const operation_description_override_1 = require("../common/operation-descriptio
 const tag_description_override_1 = require("../common/tag-description-override");
 const info_description_override_1 = require("../common/info-description-override");
 const remove_x_internal_1 = require("../common/remove-x-internal");
+const filter_in_1 = require("../common/filters/filter-in");
+const filter_out_1 = require("../common/filters/filter-out");
 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,
-    'remove-x-internal': remove_x_internal_1.RemoveXInternal
+    'remove-x-internal': remove_x_internal_1.RemoveXInternal,
+    'filter-in': filter_in_1.FilterIn,
+    'filter-out': filter_out_1.FilterOut,
 };

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

@@ -5,4 +5,6 @@ export declare const decorators: {
     'tag-description-override': Oas3Decorator;
     'info-description-override': Oas3Decorator;
     'remove-x-internal': Oas3Decorator;
+    'filter-in': Oas3Decorator;
+    'filter-out': Oas3Decorator;
 };

package/lib/decorators/oas3/index.js

@@ -6,10 +6,14 @@ const operation_description_override_1 = require("../common/operation-descriptio
 const tag_description_override_1 = require("../common/tag-description-override");
 const info_description_override_1 = require("../common/info-description-override");
 const remove_x_internal_1 = require("../common/remove-x-internal");
+const filter_in_1 = require("../common/filters/filter-in");
+const filter_out_1 = require("../common/filters/filter-out");
 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,
-    'remove-x-internal': remove_x_internal_1.RemoveXInternal
+    'remove-x-internal': remove_x_internal_1.RemoveXInternal,
+    'filter-in': filter_in_1.FilterIn,
+    'filter-out': filter_out_1.FilterOut,
 };

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-export { BundleOutputFormat, readFileFromUrl, slash } from './utils';
+export { BundleOutputFormat, readFileFromUrl, slash, doesYamlFileExist } from './utils';
 export { Oas3_1Types } from './types/oas3_1';
 export { Oas3Types } from './types/oas3';
 export { Oas2Types } from './types/oas2';
@@ -8,7 +8,7 @@ export { Oas2Definition } from './typings/swagger';
 export { StatsAccumulator, StatsName } from './typings/common';
 export { normalizeTypes } from './types';
 export { Stats } from './rules/other/stats';
-export { Config, LintConfig, RawConfig, IGNORE_FILE, Region, getMergedConfig, transformConfig, loadConfig, getConfig, findConfig, CONFIG_FILE_NAMES, } from './config';
+export { Config, LintConfig, RawConfig, IGNORE_FILE, Region, getMergedConfig, transformConfig, loadConfig, getConfig, findConfig, CONFIG_FILE_NAMES, RuleSeverity } from './config';
 export { RedoclyClient, isRedoclyRegistryURL } from './redocly';
 export { Source, BaseResolver, Document, resolveDocument, ResolveError, YamlParseError, makeDocumentFromString, } from './resolve';
 export { parseYaml, stringifyYaml } from './js-yaml';

package/lib/index.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapTypeToComponent = 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.isRef = exports.unescapePointer = exports.stringifyYaml = exports.parseYaml = exports.makeDocumentFromString = exports.YamlParseError = exports.ResolveError = exports.resolveDocument = exports.BaseResolver = exports.Source = exports.isRedoclyRegistryURL = exports.RedoclyClient = exports.CONFIG_FILE_NAMES = exports.findConfig = exports.getConfig = exports.loadConfig = exports.transformConfig = exports.getMergedConfig = 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;
+exports.mapTypeToComponent = 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.isRef = exports.unescapePointer = exports.stringifyYaml = exports.parseYaml = exports.makeDocumentFromString = exports.YamlParseError = exports.ResolveError = exports.resolveDocument = exports.BaseResolver = exports.Source = exports.isRedoclyRegistryURL = exports.RedoclyClient = exports.CONFIG_FILE_NAMES = exports.findConfig = exports.getConfig = exports.loadConfig = exports.transformConfig = exports.getMergedConfig = exports.IGNORE_FILE = exports.LintConfig = exports.Config = exports.Stats = exports.normalizeTypes = exports.ConfigTypes = exports.Oas2Types = exports.Oas3Types = exports.Oas3_1Types = exports.doesYamlFileExist = 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; } });
+Object.defineProperty(exports, "doesYamlFileExist", { enumerable: true, get: function () { return utils_1.doesYamlFileExist; } });
 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/lint.d.ts

@@ -1,5 +1,6 @@
 import { BaseResolver, Document } from './resolve';
 import { NodeType } from './types';
+import { ProblemSeverity } from './walk';
 import { LintConfig, Config } from './config';
 export declare function lint(opts: {
     ref: string;
@@ -20,4 +21,5 @@ export declare function lintDocument(opts: {
 }): Promise<import("./walk").NormalizedProblem[]>;
 export declare function lintConfig(opts: {
     document: Document;
+    severity?: ProblemSeverity;
 }): Promise<import("./walk").NormalizedProblem[]>;

package/lib/lint.js

@@ -72,7 +72,7 @@ function lintDocument(opts) {
 exports.lintDocument = lintDocument;
 function lintConfig(opts) {
     return __awaiter(this, void 0, void 0, function* () {
-        const { document } = opts;
+        const { document, severity } = opts;
         const ctx = {
             problems: [],
             oasVersion: oas_types_1.OasVersion.Version3_0,
@@ -84,7 +84,7 @@ function lintConfig(opts) {
             rules: { spec: 'error' },
         });
         const types = types_1.normalizeTypes(redocly_yaml_1.ConfigTypes, config);
-        const rules = [{ severity: 'error', ruleId: 'spec', visitor: spec_1.OasSpec({ severity: 'error' }) }];
+        const rules = [{ severity: severity || 'error', ruleId: 'configuration spec', visitor: spec_1.OasSpec({ severity: 'error' }) }];
         const normalizedVisitors = visitors_1.normalizeVisitors(rules, types);
         walk_1.walkDocument({
             document,

package/lib/redocly/registry-api-types.d.ts

@@ -15,6 +15,8 @@ export declare namespace RegistryApiTypes {
         branch?: string;
         isUpsert?: boolean;
         isPublic?: boolean;
+        batchId?: string;
+        batchSize?: number;
     }
     export interface PrepareFileuploadOKResponse {
         filePath: string;

package/lib/redocly/registry-api.d.ts

@@ -13,5 +13,5 @@ export declare class RegistryApi {
         organizations: string[];
     }>;
     prepareFileUpload({ organizationId, name, version, filesHash, filename, isUpsert, }: RegistryApiTypes.PrepareFileuploadParams): Promise<RegistryApiTypes.PrepareFileuploadOKResponse>;
-    pushApi({ organizationId, name, version, rootFilePath, filePaths, branch, isUpsert, isPublic, }: RegistryApiTypes.PushApiParams): Promise<void>;
+    pushApi({ organizationId, name, version, rootFilePath, filePaths, branch, isUpsert, isPublic, batchId, batchSize }: RegistryApiTypes.PushApiParams): Promise<void>;
 }

package/lib/redocly/registry-api.js

@@ -80,7 +80,7 @@ class RegistryApi {
             throw new Error('Could not prepare file upload');
         });
     }
-    pushApi({ organizationId, name, version, rootFilePath, filePaths, branch, isUpsert, isPublic, }) {
+    pushApi({ organizationId, name, version, rootFilePath, filePaths, branch, isUpsert, isPublic, batchId, batchSize }) {
         return __awaiter(this, void 0, void 0, function* () {
             const response = yield this.request(`/${organizationId}/${name}/${version}`, {
                 method: 'PUT',
@@ -94,6 +94,8 @@ class RegistryApi {
                     branch,
                     isUpsert,
                     isPublic,
+                    batchId,
+                    batchSize
                 }),
             }, this.region);
             if (response.ok) {

package/lib/rules/ajv.d.ts

@@ -2,7 +2,7 @@ import { ErrorObject } from '@redocly/ajv';
 import { Location } from '../ref-utils';
 import { ResolveFn } from '../walk';
 export declare function releaseAjvInstance(): void;
-export declare function validateJsonSchema(data: any, schema: any, schemaLoc: Location, instancePath: string, resolve: ResolveFn<any>, disallowAdditionalProperties: boolean): {
+export declare function validateJsonSchema(data: any, schema: any, schemaLoc: Location, instancePath: string, resolve: ResolveFn, disallowAdditionalProperties: boolean): {
     valid: boolean;
     errors: (ErrorObject & {
         suggest?: string[];

package/lib/rules/ajv.js

@@ -24,7 +24,7 @@ function getAjv(resolve, disallowAdditionalProperties) {
             loadSchemaSync(base, $ref) {
                 const resolvedRef = resolve({ $ref }, base.split('#')[0]);
                 if (!resolvedRef || !resolvedRef.location)
-                    return undefined;
+                    return false;
                 return Object.assign({ $id: resolvedRef.location.absolutePointer }, resolvedRef.node);
             },
             logger: false,

package/lib/rules/common/assertions/asserts.d.ts

@@ -1,4 +1,9 @@
-declare type Asserts = Record<string, (value: any, condition: any) => boolean>;
+import { Location } from '../../../ref-utils';
+declare type AssertResult = {
+    isValid: boolean;
+    location?: Location;
+};
+declare type Asserts = Record<string, (value: any, condition: any, baseLocation: Location, rawValue?: any) => AssertResult>;
 export declare const runOnKeysSet: Set<string>;
 export declare const runOnValuesSet: Set<string>;
 export declare const asserts: Asserts;