@speclynx/apidom-reference 4.0.1 → 4.0.3

package/src/bundle/index.ts

@@ -0,0 +1,57 @@
+import { isEmpty, propEq } from 'ramda';
+import { ParseResultElement } from '@speclynx/apidom-datamodel';
+
+import File from '../File.ts';
+import * as plugins from '../util/plugins.ts';
+import UnmatchedBundleStrategyError from '../errors/UnmatchedBundleStrategyError.ts';
+import BundleError from '../errors/BundleError.ts';
+import parse from '../parse/index.ts';
+import { merge as mergeOptions } from '../options/util.ts';
+import * as url from '../util/url.ts';
+import type { ReferenceOptions } from '../options/index.ts';
+
+/**
+ * Bundle a file with all its external references to a compound document.
+ */
+const bundle = async (uri: string, options: ReferenceOptions): Promise<ParseResultElement> => {
+  const { refSet } = options.bundle;
+  const sanitizedURI = url.sanitize(uri);
+  const mergedOptions = mergeOptions(options, { resolve: { baseURI: sanitizedURI } });
+  let parseResult;
+
+  // if refSet was provided, use it to avoid unnecessary parsing
+  if (refSet !== null && refSet.has(sanitizedURI)) {
+    // @ts-ignore
+    ({ value: parseResult } = refSet.find(propEq(sanitizedURI, 'uri')));
+  } else {
+    parseResult = await parse(uri, mergedOptions);
+  }
+
+  const file = new File({
+    uri: mergedOptions.resolve.baseURI,
+    parseResult,
+    mediaType: mergedOptions.parse.mediaType,
+  });
+
+  const bundleStrategies = await plugins.filter(
+    'canBundle',
+    [file, mergedOptions],
+    mergedOptions.bundle.strategies,
+  );
+
+  // we couldn't find any bundle strategy for this File
+  if (isEmpty(bundleStrategies)) {
+    throw new UnmatchedBundleStrategyError(
+      `Could not find a bundle strategy that can bundle the file "${file.uri}"`,
+    );
+  }
+
+  try {
+    const { result } = await plugins.run('bundle', [file, mergedOptions], bundleStrategies);
+    return result;
+  } catch (error: any) {
+    throw new BundleError(`Error while bundling file "${file.uri}"`, { cause: error });
+  }
+};
+
+export default bundle;

package/src/bundle/strategies/BundleStrategy.cjs

@@ -0,0 +1,20 @@
+"use strict";
+
+exports.__esModule = true;
+exports.default = void 0;
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class BundleStrategy {
+  name;
+  constructor({
+    name
+  }) {
+    this.name = name;
+  }
+}
+var _default = exports.default = BundleStrategy;

package/src/bundle/strategies/BundleStrategy.mjs

@@ -0,0 +1,16 @@
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class BundleStrategy {
+  name;
+  constructor({
+    name
+  }) {
+    this.name = name;
+  }
+}
+export default BundleStrategy;

package/src/bundle/strategies/BundleStrategy.ts

@@ -0,0 +1,27 @@
+import { ParseResultElement } from '@speclynx/apidom-datamodel';
+
+import File from '../../File.ts';
+import type { ReferenceOptions } from '../../options/index.ts';
+
+/**
+ * @public
+ */
+export interface BundleStrategyOptions {
+  readonly name: string;
+}
+
+/**
+ * @public
+ */
+abstract class BundleStrategy {
+  public readonly name: string;
+
+  constructor({ name }: BundleStrategyOptions) {
+    this.name = name;
+  }
+
+  abstract canBundle(file: File, options: ReferenceOptions): boolean;
+  abstract bundle(file: File, options: ReferenceOptions): Promise<ParseResultElement>;
+}
+
+export default BundleStrategy;

package/src/bundle/strategies/openapi-3-1/index.cjs

@@ -0,0 +1,35 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _apidomNsOpenapi = require("@speclynx/apidom-ns-openapi-3-1");
+var _BundleStrategy = _interopRequireDefault(require("../BundleStrategy.cjs"));
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class OpenAPI3_1BundleStrategy extends _BundleStrategy.default {
+  constructor(options) {
+    super({
+      ...(options ?? {}),
+      name: 'openapi-3-1'
+    });
+  }
+  canBundle(file) {
+    // assert by media type
+    if (file.mediaType !== 'text/plain') {
+      return _apidomNsOpenapi.mediaTypes.includes(file.mediaType);
+    }
+
+    // assert by inspecting ApiDOM
+    return (0, _apidomNsOpenapi.isOpenApi3_1Element)(file.parseResult?.result);
+  }
+  async bundle(file) {
+    return file.parseResult;
+  }
+}
+var _default = exports.default = OpenAPI3_1BundleStrategy;

package/src/bundle/strategies/openapi-3-1/index.mjs

@@ -0,0 +1,29 @@
+import { mediaTypes, isOpenApi3_1Element } from '@speclynx/apidom-ns-openapi-3-1';
+import BundleStrategy from "../BundleStrategy.mjs";
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+class OpenAPI3_1BundleStrategy extends BundleStrategy {
+  constructor(options) {
+    super({
+      ...(options ?? {}),
+      name: 'openapi-3-1'
+    });
+  }
+  canBundle(file) {
+    // assert by media type
+    if (file.mediaType !== 'text/plain') {
+      return mediaTypes.includes(file.mediaType);
+    }
+
+    // assert by inspecting ApiDOM
+    return isOpenApi3_1Element(file.parseResult?.result);
+  }
+  async bundle(file) {
+    return file.parseResult;
+  }
+}
+export default OpenAPI3_1BundleStrategy;

package/src/bundle/strategies/openapi-3-1/index.ts

@@ -0,0 +1,57 @@
+import { ParseResultElement } from '@speclynx/apidom-datamodel';
+import { mediaTypes, isOpenApi3_1Element } from '@speclynx/apidom-ns-openapi-3-1';
+
+import File from '../../../File.ts';
+import BundleStrategy, { BundleStrategyOptions } from '../BundleStrategy.ts';
+
+export type {
+  default as DereferenceStrategy,
+  DereferenceStrategyOptions,
+} from '../../../dereference/strategies/DereferenceStrategy.ts';
+export type { default as File, FileOptions } from '../../../File.ts';
+export type { default as Reference, ReferenceOptions } from '../../../Reference.ts';
+export type { default as ReferenceSet, ReferenceSetOptions } from '../../../ReferenceSet.ts';
+export type {
+  ReferenceOptions as ApiDOMReferenceOptions,
+  ReferenceBundleOptions as ApiDOMReferenceBundleOptions,
+  ReferenceDereferenceOptions as ApiDOMReferenceDereferenceOptions,
+  ReferenceParseOptions as ApiDOMReferenceParseOptions,
+  ReferenceResolveOptions as ApiDOMReferenceResolveOptions,
+} from '../../../options/index.ts';
+export type { default as Parser, ParserOptions } from '../../../parse/parsers/Parser.ts';
+export type { default as Resolver, ResolverOptions } from '../../../resolve/resolvers/Resolver.ts';
+export type {
+  default as ResolveStrategy,
+  ResolveStrategyOptions,
+} from '../../../resolve/strategies/ResolveStrategy.ts';
+export type { default as BundleStrategy, BundleStrategyOptions } from '../BundleStrategy.ts';
+
+/**
+ * @public
+ */
+export interface OpenAPI3_1BundleStrategyOptions extends Omit<BundleStrategyOptions, 'name'> {}
+
+/**
+ * @public
+ */
+class OpenAPI3_1BundleStrategy extends BundleStrategy {
+  constructor(options?: OpenAPI3_1BundleStrategyOptions) {
+    super({ ...(options ?? {}), name: 'openapi-3-1' });
+  }
+
+  canBundle(file: File): boolean {
+    // assert by media type
+    if (file.mediaType !== 'text/plain') {
+      return mediaTypes.includes(file.mediaType);
+    }
+
+    // assert by inspecting ApiDOM
+    return isOpenApi3_1Element(file.parseResult?.result);
+  }
+
+  async bundle(file: File): Promise<ParseResultElement> {
+    return file.parseResult!;
+  }
+}
+
+export default OpenAPI3_1BundleStrategy;

package/src/configuration/empty.cjs

@@ -0,0 +1,9 @@
+"use strict";
+
+exports.__esModule = true;
+var _index = require("../index.cjs");
+Object.keys(_index).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _index[key]) return;
+  exports[key] = _index[key];
+});

package/src/configuration/empty.mjs

@@ -0,0 +1 @@
+export * from "../index.mjs";

package/src/configuration/empty.ts

@@ -0,0 +1 @@
+export * from '../index.ts';

package/src/configuration/saturated.cjs

@@ -0,0 +1,88 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+var _indexNode = _interopRequireDefault(require("../resolve/resolvers/file/index-node.cjs"));
+var _index = _interopRequireDefault(require("../resolve/resolvers/http-axios/index.cjs"));
+var _index2 = _interopRequireDefault(require("../resolve/strategies/openapi-2/index.cjs"));
+var _index3 = _interopRequireDefault(require("../resolve/strategies/openapi-3-0/index.cjs"));
+var _index4 = _interopRequireDefault(require("../resolve/strategies/openapi-3-1/index.cjs"));
+var _index5 = _interopRequireDefault(require("../resolve/strategies/asyncapi-2/index.cjs"));
+var _index6 = _interopRequireDefault(require("../resolve/strategies/apidom/index.cjs"));
+var _index7 = _interopRequireDefault(require("../parse/parsers/openapi-json-2/index.cjs"));
+var _index8 = _interopRequireDefault(require("../parse/parsers/openapi-yaml-2/index.cjs"));
+var _index9 = _interopRequireDefault(require("../parse/parsers/openapi-json-3-0/index.cjs"));
+var _index0 = _interopRequireDefault(require("../parse/parsers/openapi-yaml-3-0/index.cjs"));
+var _index1 = _interopRequireDefault(require("../parse/parsers/openapi-json-3-1/index.cjs"));
+var _index10 = _interopRequireDefault(require("../parse/parsers/openapi-yaml-3-1/index.cjs"));
+var _index11 = _interopRequireDefault(require("../parse/parsers/asyncapi-json-2/index.cjs"));
+var _index12 = _interopRequireDefault(require("../parse/parsers/asyncapi-yaml-2/index.cjs"));
+var _index13 = _interopRequireDefault(require("../parse/parsers/arazzo-json-1/index.cjs"));
+var _index14 = _interopRequireDefault(require("../parse/parsers/arazzo-yaml-1/index.cjs"));
+var _index15 = _interopRequireDefault(require("../parse/parsers/apidom-json/index.cjs"));
+var _index16 = _interopRequireDefault(require("../parse/parsers/json/index.cjs"));
+var _index17 = _interopRequireDefault(require("../parse/parsers/yaml-1-2/index.cjs"));
+var _indexNode2 = _interopRequireDefault(require("../parse/parsers/binary/index-node.cjs"));
+var _index18 = _interopRequireDefault(require("../dereference/strategies/apidom/index.cjs"));
+var _index19 = _interopRequireDefault(require("../dereference/strategies/openapi-2/index.cjs"));
+var _index20 = _interopRequireDefault(require("../dereference/strategies/openapi-3-0/index.cjs"));
+var _index21 = _interopRequireDefault(require("../dereference/strategies/openapi-3-1/index.cjs"));
+var _index22 = _interopRequireDefault(require("../dereference/strategies/asyncapi-2/index.cjs"));
+var _index23 = _interopRequireDefault(require("../dereference/strategies/arazzo-1/index.cjs"));
+var _index24 = _interopRequireDefault(require("../bundle/strategies/openapi-3-1/index.cjs"));
+var _index25 = require("../index.cjs");
+Object.keys(_index25).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _index25[key]) return;
+  exports[key] = _index25[key];
+});
+_index25.options.parse.parsers = [new _index7.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index8.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index9.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index0.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index1.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index10.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index11.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index12.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index13.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index14.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index15.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index16.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _index17.default({
+  allowEmpty: true,
+  sourceMap: false
+}), new _indexNode2.default({
+  allowEmpty: true
+})];
+_index25.options.resolve.resolvers = [new _indexNode.default(), new _index.default({
+  timeout: 5000,
+  redirects: 5,
+  withCredentials: false
+})];
+_index25.options.resolve.strategies = [new _index2.default(), new _index3.default(), new _index4.default(), new _index5.default(), new _index6.default()];
+_index25.options.dereference.strategies = [new _index19.default(), new _index20.default(), new _index21.default(), new _index22.default(), new _index23.default(), new _index18.default()];
+_index25.options.bundle.strategies = [new _index24.default()];

package/src/configuration/saturated.mjs

@@ -0,0 +1,80 @@
+import FileResolver from "../resolve/resolvers/file/index-node.mjs";
+import HTTPResolverAxios from "../resolve/resolvers/http-axios/index.mjs";
+import OpenAPI2ResolveStrategy from "../resolve/strategies/openapi-2/index.mjs";
+import OpenAPI3_0ResolveStrategy from "../resolve/strategies/openapi-3-0/index.mjs";
+import OpenAPI3_1ResolveStrategy from "../resolve/strategies/openapi-3-1/index.mjs";
+import AsyncAPI2ResolveStrategy from "../resolve/strategies/asyncapi-2/index.mjs";
+import ApiDOMResolveStrategy from "../resolve/strategies/apidom/index.mjs";
+import OpenAPIJSON2Parser from "../parse/parsers/openapi-json-2/index.mjs";
+import OpenAPIYAML2Parser from "../parse/parsers/openapi-yaml-2/index.mjs";
+import OpenAPIJSON3_0Parser from "../parse/parsers/openapi-json-3-0/index.mjs";
+import OpenAPIYAML3_0Parser from "../parse/parsers/openapi-yaml-3-0/index.mjs";
+import OpenAPIJSON3_1Parser from "../parse/parsers/openapi-json-3-1/index.mjs";
+import OpenAPIYAML3_1Parser from "../parse/parsers/openapi-yaml-3-1/index.mjs";
+import AsyncAPIJSON2Parser from "../parse/parsers/asyncapi-json-2/index.mjs";
+import AsyncAPIYAML2Parser from "../parse/parsers/asyncapi-yaml-2/index.mjs";
+import ArazzoJSON1Parser from "../parse/parsers/arazzo-json-1/index.mjs";
+import ArazzoYAML1Parser from "../parse/parsers/arazzo-yaml-1/index.mjs";
+import APIDOMJSONParser from "../parse/parsers/apidom-json/index.mjs";
+import JSONParser from "../parse/parsers/json/index.mjs";
+import YAMLParser from "../parse/parsers/yaml-1-2/index.mjs";
+import BinaryParser from "../parse/parsers/binary/index-node.mjs";
+import ApiDOMDereferenceStrategy from "../dereference/strategies/apidom/index.mjs";
+import OpenAPI2DereferenceStrategy from "../dereference/strategies/openapi-2/index.mjs";
+import OpenAPI3_0DereferenceStrategy from "../dereference/strategies/openapi-3-0/index.mjs";
+import OpenAPI3_1DereferenceStrategy from "../dereference/strategies/openapi-3-1/index.mjs";
+import AsyncAPI2DereferenceStrategy from "../dereference/strategies/asyncapi-2/index.mjs";
+import Arazzo1DereferenceStrategy from "../dereference/strategies/arazzo-1/index.mjs";
+import OpenAPI3_1BundleStrategy from "../bundle/strategies/openapi-3-1/index.mjs";
+import { options } from "../index.mjs";
+options.parse.parsers = [new OpenAPIJSON2Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new OpenAPIYAML2Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new OpenAPIJSON3_0Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new OpenAPIYAML3_0Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new OpenAPIJSON3_1Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new OpenAPIYAML3_1Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new AsyncAPIJSON2Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new AsyncAPIYAML2Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new ArazzoJSON1Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new ArazzoYAML1Parser({
+  allowEmpty: true,
+  sourceMap: false
+}), new APIDOMJSONParser({
+  allowEmpty: true,
+  sourceMap: false
+}), new JSONParser({
+  allowEmpty: true,
+  sourceMap: false
+}), new YAMLParser({
+  allowEmpty: true,
+  sourceMap: false
+}), new BinaryParser({
+  allowEmpty: true
+})];
+options.resolve.resolvers = [new FileResolver(), new HTTPResolverAxios({
+  timeout: 5000,
+  redirects: 5,
+  withCredentials: false
+})];
+options.resolve.strategies = [new OpenAPI2ResolveStrategy(), new OpenAPI3_0ResolveStrategy(), new OpenAPI3_1ResolveStrategy(), new AsyncAPI2ResolveStrategy(), new ApiDOMResolveStrategy()];
+options.dereference.strategies = [new OpenAPI2DereferenceStrategy(), new OpenAPI3_0DereferenceStrategy(), new OpenAPI3_1DereferenceStrategy(), new AsyncAPI2DereferenceStrategy(), new Arazzo1DereferenceStrategy(), new ApiDOMDereferenceStrategy()];
+options.bundle.strategies = [new OpenAPI3_1BundleStrategy()];
+export * from "../index.mjs";

package/src/configuration/saturated.ts

@@ -0,0 +1,72 @@
+import FileResolver from '../resolve/resolvers/file/index-node.ts';
+import HTTPResolverAxios from '../resolve/resolvers/http-axios/index.ts';
+import OpenAPI2ResolveStrategy from '../resolve/strategies/openapi-2/index.ts';
+import OpenAPI3_0ResolveStrategy from '../resolve/strategies/openapi-3-0/index.ts';
+import OpenAPI3_1ResolveStrategy from '../resolve/strategies/openapi-3-1/index.ts';
+import AsyncAPI2ResolveStrategy from '../resolve/strategies/asyncapi-2/index.ts';
+import ApiDOMResolveStrategy from '../resolve/strategies/apidom/index.ts';
+import OpenAPIJSON2Parser from '../parse/parsers/openapi-json-2/index.ts';
+import OpenAPIYAML2Parser from '../parse/parsers/openapi-yaml-2/index.ts';
+import OpenAPIJSON3_0Parser from '../parse/parsers/openapi-json-3-0/index.ts';
+import OpenAPIYAML3_0Parser from '../parse/parsers/openapi-yaml-3-0/index.ts';
+import OpenAPIJSON3_1Parser from '../parse/parsers/openapi-json-3-1/index.ts';
+import OpenAPIYAML3_1Parser from '../parse/parsers/openapi-yaml-3-1/index.ts';
+import AsyncAPIJSON2Parser from '../parse/parsers/asyncapi-json-2/index.ts';
+import AsyncAPIYAML2Parser from '../parse/parsers/asyncapi-yaml-2/index.ts';
+import ArazzoJSON1Parser from '../parse/parsers/arazzo-json-1/index.ts';
+import ArazzoYAML1Parser from '../parse/parsers/arazzo-yaml-1/index.ts';
+import APIDOMJSONParser from '../parse/parsers/apidom-json/index.ts';
+import JSONParser from '../parse/parsers/json/index.ts';
+import YAMLParser from '../parse/parsers/yaml-1-2/index.ts';
+import BinaryParser from '../parse/parsers/binary/index-node.ts';
+import ApiDOMDereferenceStrategy from '../dereference/strategies/apidom/index.ts';
+import OpenAPI2DereferenceStrategy from '../dereference/strategies/openapi-2/index.ts';
+import OpenAPI3_0DereferenceStrategy from '../dereference/strategies/openapi-3-0/index.ts';
+import OpenAPI3_1DereferenceStrategy from '../dereference/strategies/openapi-3-1/index.ts';
+import AsyncAPI2DereferenceStrategy from '../dereference/strategies/asyncapi-2/index.ts';
+import Arazzo1DereferenceStrategy from '../dereference/strategies/arazzo-1/index.ts';
+import OpenAPI3_1BundleStrategy from '../bundle/strategies/openapi-3-1/index.ts';
+import { options } from '../index.ts';
+
+options.parse.parsers = [
+  new OpenAPIJSON2Parser({ allowEmpty: true, sourceMap: false }),
+  new OpenAPIYAML2Parser({ allowEmpty: true, sourceMap: false }),
+  new OpenAPIJSON3_0Parser({ allowEmpty: true, sourceMap: false }),
+  new OpenAPIYAML3_0Parser({ allowEmpty: true, sourceMap: false }),
+  new OpenAPIJSON3_1Parser({ allowEmpty: true, sourceMap: false }),
+  new OpenAPIYAML3_1Parser({ allowEmpty: true, sourceMap: false }),
+  new AsyncAPIJSON2Parser({ allowEmpty: true, sourceMap: false }),
+  new AsyncAPIYAML2Parser({ allowEmpty: true, sourceMap: false }),
+  new ArazzoJSON1Parser({ allowEmpty: true, sourceMap: false }),
+  new ArazzoYAML1Parser({ allowEmpty: true, sourceMap: false }),
+  new APIDOMJSONParser({ allowEmpty: true, sourceMap: false }),
+  new JSONParser({ allowEmpty: true, sourceMap: false }),
+  new YAMLParser({ allowEmpty: true, sourceMap: false }),
+  new BinaryParser({ allowEmpty: true }),
+];
+
+options.resolve.resolvers = [
+  new FileResolver(),
+  new HTTPResolverAxios({ timeout: 5000, redirects: 5, withCredentials: false }),
+];
+
+options.resolve.strategies = [
+  new OpenAPI2ResolveStrategy(),
+  new OpenAPI3_0ResolveStrategy(),
+  new OpenAPI3_1ResolveStrategy(),
+  new AsyncAPI2ResolveStrategy(),
+  new ApiDOMResolveStrategy(),
+];
+
+options.dereference.strategies = [
+  new OpenAPI2DereferenceStrategy(),
+  new OpenAPI3_0DereferenceStrategy(),
+  new OpenAPI3_1DereferenceStrategy(),
+  new AsyncAPI2DereferenceStrategy(),
+  new Arazzo1DereferenceStrategy(),
+  new ApiDOMDereferenceStrategy(),
+];
+
+options.bundle.strategies = [new OpenAPI3_1BundleStrategy()];
+
+export * from '../index.ts';

package/src/dereference/index.cjs

@@ -0,0 +1,90 @@
+"use strict";
+
+var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.dereferenceApiDOM = exports.default = void 0;
+var _ramda = require("ramda");
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
+var _File = _interopRequireDefault(require("../File.cjs"));
+var plugins = _interopRequireWildcard(require("../util/plugins.cjs"));
+var _UnmatchedDereferenceStrategyError = _interopRequireDefault(require("../errors/UnmatchedDereferenceStrategyError.cjs"));
+var _DereferenceError = _interopRequireDefault(require("../errors/DereferenceError.cjs"));
+var _UnresolvableReferenceError = _interopRequireDefault(require("../errors/UnresolvableReferenceError.cjs"));
+var _index = _interopRequireDefault(require("../parse/index.cjs"));
+var _util = require("../options/util.cjs");
+var url = _interopRequireWildcard(require("../util/url.cjs"));
+/**
+ * Dereferences ApiDOM with all its external references.
+ */
+const dereferenceApiDOM = async (element, options) => {
+  // @ts-ignore
+  let parseResult = element;
+  let surrogateWrapping = false;
+
+  // wrap element into parse result
+  if (!(0, _apidomDatamodel.isParseResultElement)(element)) {
+    const elementClone = (0, _apidomDatamodel.cloneShallow)(element);
+    elementClone.classes.push('result');
+    parseResult = new _apidomDatamodel.ParseResultElement([elementClone]);
+    surrogateWrapping = true;
+  }
+  const file = new _File.default({
+    uri: options.resolve.baseURI,
+    parseResult,
+    mediaType: options.parse.mediaType
+  });
+  const dereferenceStrategies = await plugins.filter('canDereference', [file, options], options.dereference.strategies);
+
+  // we couldn't find any dereference strategy for this File
+  if ((0, _ramda.isEmpty)(dereferenceStrategies)) {
+    throw new _UnmatchedDereferenceStrategyError.default(`Could not find a dereference strategy that can dereference the file "${file.uri}"`);
+  }
+  try {
+    const {
+      result
+    } = await plugins.run('dereference', [file, options], dereferenceStrategies);
+    // unwrap the element from ParseResult assuming first element is the actual result
+    return surrogateWrapping ? result.get(0) : result;
+  } catch (error) {
+    if (error instanceof _UnresolvableReferenceError.default) {
+      throw error;
+    }
+    throw new _DereferenceError.default(`Error while dereferencing file "${file.uri}"`, {
+      cause: error
+    });
+  }
+};
+
+/**
+ * Dereferences a file with all its external references.
+ */
+exports.dereferenceApiDOM = dereferenceApiDOM;
+const dereference = async (uri, options) => {
+  const {
+    refSet
+  } = options.dereference;
+  const sanitizedURI = url.sanitize(uri);
+  let parseResult;
+
+  // if refSet was provided, use it to avoid unnecessary parsing
+  if (refSet !== null && refSet.has(sanitizedURI)) {
+    // @ts-ignore
+    ({
+      value: parseResult
+    } = refSet.find((0, _ramda.propEq)(sanitizedURI, 'uri')));
+  } else {
+    parseResult = await (0, _index.default)(uri, options);
+  }
+  const mergedOptions = (0, _util.merge)(options, {
+    resolve: {
+      baseURI: sanitizedURI
+    },
+    dereference: {
+      // if refSet was not provided, then we can work in mutable mode
+      immutable: options.dereference.immutable && refSet !== null
+    }
+  });
+  return dereferenceApiDOM(parseResult, mergedOptions);
+};
+var _default = exports.default = dereference;