@speclynx/apidom-reference 6.1.2 → 7.0.0

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

@@ -30,9 +30,8 @@ Object.defineProperty(exports, "resolveSchema$refField", {
   }
 });
 var _ramda = require("ramda");
-var _apidomDatamodel = require("@speclynx/apidom-datamodel");
-var _apidomTraverse = require("@speclynx/apidom-traverse");
 var _apidomNsOpenapi = require("@speclynx/apidom-ns-openapi-3-1");
+var _mediaTypes = require("@swaggerexpert/media-types");
 var _DereferenceStrategy = _interopRequireDefault(require("../DereferenceStrategy.cjs"));
 var _Reference = _interopRequireDefault(require("../../../Reference.cjs"));
 var _ReferenceSet = _interopRequireDefault(require("../../../ReferenceSet.cjs"));
@@ -54,72 +53,47 @@ class OpenAPI3_1DereferenceStrategy extends _DereferenceStrategy.default {
   }
   canDereference(file) {
     // assert by media type
-    if (file.mediaType !== 'text/plain') {
-      return _apidomNsOpenapi.mediaTypes.includes(file.mediaType);
+    if (!(0, _mediaTypes.matches)('text/plain', file.mediaType)) {
+      return (0, _mediaTypes.selectBestMatch)(_apidomNsOpenapi.mediaTypes, file.mediaType) !== null;
     }
 
     // assert by inspecting ApiDOM
     return (0, _apidomNsOpenapi.isOpenApi3_1Element)(file.parseResult?.result);
   }
   async dereference(file, options) {
-    const immutableRefSet = options.dereference.refSet ?? new _ReferenceSet.default();
-    const mutableRefSet = new _ReferenceSet.default();
-    let refSet = immutableRefSet;
+    const refSet = options.dereference.refSet ?? new _ReferenceSet.default();
     let reference;
-    if (!immutableRefSet.has(file.uri)) {
+    if (!refSet.has(file.uri)) {
       reference = new _Reference.default({
         uri: file.uri,
         value: file.parseResult
       });
-      immutableRefSet.add(reference);
+      refSet.add(reference);
     } else {
       // pre-computed refSet was provided as configuration option
-      reference = immutableRefSet.find((0, _ramda.propEq)(file.uri, 'uri'));
+      reference = refSet.find((0, _ramda.propEq)(file.uri, 'uri'));
     }
 
     /**
-     * Clone refSet due the dereferencing process being mutable.
-     * We don't want to mutate the original refSet and the references.
+     * With the immutable option the dereferenced element is a new tree,
+     * otherwise the dereferenced root is dereferenced in place.
      */
-    if (options.dereference.immutable) {
-      immutableRefSet.refs.map(ref => new _Reference.default({
-        ...ref,
-        value: (0, _apidomDatamodel.cloneDeep)(ref.value)
-      })).forEach(ref => mutableRefSet.add(ref));
-      reference = mutableRefSet.find(ref => ref.uri === file.uri);
-      refSet = mutableRefSet;
-    }
-    const shouldDetectCircular = ['error', 'replace'].includes(options.dereference.circular);
+    const root = refSet.rootRef.value;
     const visitor = new _visitor.default({
-      reference: reference,
-      options,
-      ancestorSchema$ids: (0, _util.detachedRootSchema$ids)(refSet.rootRef.value.result)
+      reference,
+      options
     });
-    const dereferencedElement = await (0, _apidomTraverse.traverseAsync)(refSet.rootRef.value, visitor, {
-      mutable: true,
-      ...(shouldDetectCircular && {
-        skipVisited: 'skip'
-      })
+    const dereferencedElement = await visitor.dereference(root, {
+      ancestorSchema$ids: (0, _util.detachedRootSchema$ids)(root.result)
     });
 
     /**
-     * If immutable option is set, replay refs from the refSet.
-     */
-    if (options.dereference.immutable) {
-      mutableRefSet.refs.filter(ref => ref.uri.startsWith('immutable://')).map(ref => new _Reference.default({
-        ...ref,
-        uri: ref.uri.replace(/^immutable:\/\//, '')
-      })).forEach(ref => immutableRefSet.add(ref));
-    }
-
-    /**
-     * Release all memory if this refSet was not provided as an configuration option.
+     * Release all memory if this refSet was not provided as a configuration option.
      * If provided as configuration option, then provider is responsible for cleanup.
      */
     if (options.dereference.refSet === null) {
-      immutableRefSet.clean();
+      refSet.clean();
     }
-    mutableRefSet.clean();
     return dereferencedElement;
   }
 }

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

@@ -1,7 +1,6 @@
 import { propEq } from 'ramda';
-import { cloneDeep } from '@speclynx/apidom-datamodel';
-import { traverseAsync } from '@speclynx/apidom-traverse';
 import { isOpenApi3_1Element, mediaTypes } from '@speclynx/apidom-ns-openapi-3-1';
+import { matches, selectBestMatch } from '@swaggerexpert/media-types';
 import DereferenceStrategy from "../DereferenceStrategy.mjs";
 import Reference from "../../../Reference.mjs";
 import ReferenceSet from "../../../ReferenceSet.mjs";
@@ -22,72 +21,47 @@ class OpenAPI3_1DereferenceStrategy extends DereferenceStrategy {
   }
   canDereference(file) {
     // assert by media type
-    if (file.mediaType !== 'text/plain') {
-      return mediaTypes.includes(file.mediaType);
+    if (!matches('text/plain', file.mediaType)) {
+      return selectBestMatch(mediaTypes, file.mediaType) !== null;
     }
 
     // assert by inspecting ApiDOM
     return isOpenApi3_1Element(file.parseResult?.result);
   }
   async dereference(file, options) {
-    const immutableRefSet = options.dereference.refSet ?? new ReferenceSet();
-    const mutableRefSet = new ReferenceSet();
-    let refSet = immutableRefSet;
+    const refSet = options.dereference.refSet ?? new ReferenceSet();
     let reference;
-    if (!immutableRefSet.has(file.uri)) {
+    if (!refSet.has(file.uri)) {
       reference = new Reference({
         uri: file.uri,
         value: file.parseResult
       });
-      immutableRefSet.add(reference);
+      refSet.add(reference);
     } else {
       // pre-computed refSet was provided as configuration option
-      reference = immutableRefSet.find(propEq(file.uri, 'uri'));
+      reference = refSet.find(propEq(file.uri, 'uri'));
     }
 
     /**
-     * Clone refSet due the dereferencing process being mutable.
-     * We don't want to mutate the original refSet and the references.
+     * With the immutable option the dereferenced element is a new tree,
+     * otherwise the dereferenced root is dereferenced in place.
      */
-    if (options.dereference.immutable) {
-      immutableRefSet.refs.map(ref => new Reference({
-        ...ref,
-        value: cloneDeep(ref.value)
-      })).forEach(ref => mutableRefSet.add(ref));
-      reference = mutableRefSet.find(ref => ref.uri === file.uri);
-      refSet = mutableRefSet;
-    }
-    const shouldDetectCircular = ['error', 'replace'].includes(options.dereference.circular);
+    const root = refSet.rootRef.value;
     const visitor = new OpenAPI3_1DereferenceVisitor({
-      reference: reference,
-      options,
-      ancestorSchema$ids: detachedRootSchema$ids(refSet.rootRef.value.result)
+      reference,
+      options
     });
-    const dereferencedElement = await traverseAsync(refSet.rootRef.value, visitor, {
-      mutable: true,
-      ...(shouldDetectCircular && {
-        skipVisited: 'skip'
-      })
+    const dereferencedElement = await visitor.dereference(root, {
+      ancestorSchema$ids: detachedRootSchema$ids(root.result)
     });
 
     /**
-     * If immutable option is set, replay refs from the refSet.
-     */
-    if (options.dereference.immutable) {
-      mutableRefSet.refs.filter(ref => ref.uri.startsWith('immutable://')).map(ref => new Reference({
-        ...ref,
-        uri: ref.uri.replace(/^immutable:\/\//, '')
-      })).forEach(ref => immutableRefSet.add(ref));
-    }
-
-    /**
-     * Release all memory if this refSet was not provided as an configuration option.
+     * Release all memory if this refSet was not provided as a configuration option.
      * If provided as configuration option, then provider is responsible for cleanup.
      */
     if (options.dereference.refSet === null) {
-      immutableRefSet.clean();
+      refSet.clean();
     }
-    mutableRefSet.clean();
     return dereferencedElement;
   }
 }