1 | import { isEmpty } from 'ramda';
|
---|
2 | import { isParseResultElement, ParseResultElement, cloneShallow } from '@swagger-api/apidom-core';
|
---|
3 | import { merge as mergeOptions } from "../options/util.mjs";
|
---|
4 | import parse from "../parse/index.mjs";
|
---|
5 | import * as plugins from "../util/plugins.mjs";
|
---|
6 | import File from "../util/File.mjs";
|
---|
7 | import ResolveError from "../errors/ResolverError.mjs";
|
---|
8 | import UnmatchedResolveStrategyError from "../errors/UnmatchedResolveStrategyError.mjs";
|
---|
9 | import * as url from "../util/url.mjs";
|
---|
10 | /**
|
---|
11 | * Resolves ApiDOM with all its external references.
|
---|
12 | */
|
---|
13 | export const resolveApiDOM = async (element, options) => {
|
---|
14 | // @ts-ignore
|
---|
15 | let parseResult = element;
|
---|
16 |
|
---|
17 | // wrap element into parse result
|
---|
18 | if (!isParseResultElement(element)) {
|
---|
19 | // shallow clone of the element
|
---|
20 | const elementClone = cloneShallow(element);
|
---|
21 | elementClone.classes.push('result');
|
---|
22 | parseResult = new ParseResultElement([elementClone]);
|
---|
23 | }
|
---|
24 | const sanitizedURI = url.sanitize(url.stripHash(options.resolve.baseURI));
|
---|
25 | const file = File({
|
---|
26 | uri: sanitizedURI,
|
---|
27 | parseResult,
|
---|
28 | mediaType: options.parse.mediaType
|
---|
29 | });
|
---|
30 | const resolveStrategies = await plugins.filter('canResolve', file, options.resolve.strategies);
|
---|
31 |
|
---|
32 | // we couldn't find any resolver for this File
|
---|
33 | if (isEmpty(resolveStrategies)) {
|
---|
34 | throw new UnmatchedResolveStrategyError(file.uri);
|
---|
35 | }
|
---|
36 | try {
|
---|
37 | const {
|
---|
38 | result
|
---|
39 | } = await plugins.run('resolve', [file, options], resolveStrategies);
|
---|
40 | return result;
|
---|
41 | } catch (error) {
|
---|
42 | throw new ResolveError(`Error while resolving file "${file.uri}"`, {
|
---|
43 | cause: error
|
---|
44 | });
|
---|
45 | }
|
---|
46 | };
|
---|
47 |
|
---|
48 | /**
|
---|
49 | * Resolves a file with all its external references.
|
---|
50 | */
|
---|
51 | const resolve = async (uri, options) => {
|
---|
52 | const parseResult = await parse(uri, options);
|
---|
53 | const mergedOptions = mergeOptions(options, {
|
---|
54 | resolve: {
|
---|
55 | baseURI: url.sanitize(uri)
|
---|
56 | }
|
---|
57 | });
|
---|
58 | return resolveApiDOM(parseResult, mergedOptions);
|
---|
59 | };
|
---|
60 | export default resolve; |
---|