144 lines
5.9 KiB
JavaScript
144 lines
5.9 KiB
JavaScript
"use strict";
|
|
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
if (k2 === undefined) k2 = k;
|
|
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
}
|
|
Object.defineProperty(o, k2, desc);
|
|
}) : (function(o, m, k, k2) {
|
|
if (k2 === undefined) k2 = k;
|
|
o[k2] = m[k];
|
|
}));
|
|
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
}) : function(o, v) {
|
|
o["default"] = v;
|
|
});
|
|
var __importStar = (this && this.__importStar) || (function () {
|
|
var ownKeys = function(o) {
|
|
ownKeys = Object.getOwnPropertyNames || function (o) {
|
|
var ar = [];
|
|
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
|
|
return ar;
|
|
};
|
|
return ownKeys(o);
|
|
};
|
|
return function (mod) {
|
|
if (mod && mod.__esModule) return mod;
|
|
var result = {};
|
|
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
|
|
__setModuleDefault(result, mod);
|
|
return result;
|
|
};
|
|
})();
|
|
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
};
|
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
const ref_js_1 = __importDefault(require("./ref.js"));
|
|
const pointer_js_1 = __importDefault(require("./pointer.js"));
|
|
const parse_js_1 = __importDefault(require("./parse.js"));
|
|
const url = __importStar(require("./util/url.js"));
|
|
const errors_js_1 = require("./util/errors.js");
|
|
/**
|
|
* Crawls the JSON schema, finds all external JSON references, and resolves their values.
|
|
* This method does not mutate the JSON schema. The resolved values are added to {@link $RefParser#$refs}.
|
|
*
|
|
* NOTE: We only care about EXTERNAL references here. INTERNAL references are only relevant when dereferencing.
|
|
*
|
|
* @returns
|
|
* The promise resolves once all JSON references in the schema have been resolved,
|
|
* including nested references that are contained in externally-referenced files.
|
|
*/
|
|
function resolveExternal(parser, options) {
|
|
if (!options.resolve?.external) {
|
|
// Nothing to resolve, so exit early
|
|
return Promise.resolve();
|
|
}
|
|
try {
|
|
// console.log('Resolving $ref pointers in %s', parser.$refs._root$Ref.path);
|
|
const promises = crawl(parser.schema, parser.$refs._root$Ref.path + "#", parser.$refs, options);
|
|
return Promise.all(promises);
|
|
}
|
|
catch (e) {
|
|
return Promise.reject(e);
|
|
}
|
|
}
|
|
/**
|
|
* Recursively crawls the given value, and resolves any external JSON references.
|
|
*
|
|
* @param obj - The value to crawl. If it's not an object or array, it will be ignored.
|
|
* @param path - The full path of `obj`, possibly with a JSON Pointer in the hash
|
|
* @param {boolean} external - Whether `obj` was found in an external document.
|
|
* @param $refs
|
|
* @param options
|
|
* @param seen - Internal.
|
|
*
|
|
* @returns
|
|
* Returns an array of promises. There will be one promise for each JSON reference in `obj`.
|
|
* If `obj` does not contain any JSON references, then the array will be empty.
|
|
* If any of the JSON references point to files that contain additional JSON references,
|
|
* then the corresponding promise will internally reference an array of promises.
|
|
*/
|
|
function crawl(obj, path, $refs, options, seen, external) {
|
|
seen ||= new Set();
|
|
let promises = [];
|
|
if (obj && typeof obj === "object" && !ArrayBuffer.isView(obj) && !seen.has(obj)) {
|
|
seen.add(obj); // Track previously seen objects to avoid infinite recursion
|
|
if (ref_js_1.default.isExternal$Ref(obj)) {
|
|
promises.push(resolve$Ref(obj, path, $refs, options));
|
|
}
|
|
const keys = Object.keys(obj);
|
|
for (const key of keys) {
|
|
const keyPath = pointer_js_1.default.join(path, key);
|
|
const value = obj[key];
|
|
promises = promises.concat(crawl(value, keyPath, $refs, options, seen, external));
|
|
}
|
|
}
|
|
return promises;
|
|
}
|
|
/**
|
|
* Resolves the given JSON Reference, and then crawls the resulting value.
|
|
*
|
|
* @param $ref - The JSON Reference to resolve
|
|
* @param path - The full path of `$ref`, possibly with a JSON Pointer in the hash
|
|
* @param $refs
|
|
* @param options
|
|
*
|
|
* @returns
|
|
* The promise resolves once all JSON references in the object have been resolved,
|
|
* including nested references that are contained in externally-referenced files.
|
|
*/
|
|
async function resolve$Ref($ref, path, $refs, options) {
|
|
const shouldResolveOnCwd = options.dereference?.externalReferenceResolution === "root";
|
|
const resolvedPath = url.resolve(shouldResolveOnCwd ? url.cwd() : path, $ref.$ref);
|
|
const withoutHash = url.stripHash(resolvedPath);
|
|
// $ref.$ref = url.relative($refs._root$Ref.path, resolvedPath);
|
|
// Do we already have this $ref?
|
|
const ref = $refs._$refs[withoutHash];
|
|
if (ref) {
|
|
// We've already parsed this $ref, so use the existing value
|
|
return Promise.resolve(ref.value);
|
|
}
|
|
// Parse the $referenced file/url
|
|
try {
|
|
const result = await (0, parse_js_1.default)(resolvedPath, $refs, options);
|
|
// Crawl the parsed value
|
|
// console.log('Resolving $ref pointers in %s', withoutHash);
|
|
const promises = crawl(result, withoutHash + "#", $refs, options, new Set(), true);
|
|
return Promise.all(promises);
|
|
}
|
|
catch (err) {
|
|
if (!options?.continueOnError || !(0, errors_js_1.isHandledError)(err)) {
|
|
throw err;
|
|
}
|
|
if ($refs._$refs[withoutHash]) {
|
|
err.source = decodeURI(url.stripHash(path));
|
|
err.path = url.safePointerToPath(url.getHash(path));
|
|
}
|
|
return [];
|
|
}
|
|
}
|
|
exports.default = resolveExternal;
|