swagger-client 3.19.4 → 3.19.6

package/es/resolver/apidom/reference/dereference/strategies/openapi-3-1-swagger-client/visitors/dereference.js

@@ -33,7 +33,7 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = OpenApi3_1DereferenceVisitor.c
   methods: {
     async ReferenceElement(referenceElement, key, parent, path, ancestors) {
       try {
-        const [ancestorsLineage, directAncestors] = this.toAncestorLineage(ancestors);
+        const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
 
         // skip already identified cycled Path Item Objects
         if (includesClasses(['cycle'], referenceElement.$ref)) {
@@ -82,6 +82,21 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = OpenApi3_1DereferenceVisitor.c
         if (this.indirections.length > this.options.dereference.maxDepth) {
           throw new MaximumDereferenceDepthError(`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
         }
+        if (!this.useCircularStructures) {
+          const hasCycles = ancestorsLineage.some(ancs => ancs.has(fragment));
+          if (hasCycles) {
+            if (url.isHttpUrl(retrievalURI) || url.isFileSystemPath(retrievalURI)) {
+              // make the referencing URL or file system path absolute
+              const cycledReferenceElement = new ReferenceElement({
+                $ref: $refBaseURI
+              }, referenceElement.meta.clone(), referenceElement.attributes.clone());
+              cycledReferenceElement.get('$ref').classes.push('cycle');
+              return cycledReferenceElement;
+            }
+            // skip processing this schema and all it's child schemas
+            return false;
+          }
+        }
 
         // append referencing schema to ancestors lineage
         directAncestors.add(referenceElement);
@@ -105,21 +120,6 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = OpenApi3_1DereferenceVisitor.c
         // remove referencing schema from ancestors lineage
         directAncestors.delete(referenceElement);
         this.indirections.pop();
-        if (!this.useCircularStructures) {
-          const hasCycles = ancestorsLineage.some(ancs => ancs.has(fragment));
-          if (hasCycles) {
-            if (url.isHttpUrl(retrievalURI) || url.isFileSystemPath(retrievalURI)) {
-              // make the referencing URL or file system path absolute
-              const cycledReferenceElement = new ReferenceElement({
-                $ref: $refBaseURI
-              }, referenceElement.meta.clone(), referenceElement.attributes.clone());
-              cycledReferenceElement.get('$ref').classes.push('cycle');
-              return cycledReferenceElement;
-            }
-            // skip processing this schema but traverse all it's child schemas
-            return false;
-          }
-        }
         fragment = fragment.clone();
         fragment.setMetaProperty('ref-fields', {
           $ref: referenceElement.$ref?.toValue(),
@@ -165,7 +165,7 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = OpenApi3_1DereferenceVisitor.c
     },
     async PathItemElement(pathItemElement, key, parent, path, ancestors) {
       try {
-        const [ancestorsLineage, directAncestors] = this.toAncestorLineage(ancestors);
+        const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
 
         // ignore PathItemElement without $ref field
         if (!isStringElement(pathItemElement.$ref)) {
@@ -210,6 +210,21 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = OpenApi3_1DereferenceVisitor.c
         if (this.indirections.length > this.options.dereference.maxDepth) {
           throw new MaximumDereferenceDepthError(`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
         }
+        if (!this.useCircularStructures) {
+          const hasCycles = ancestorsLineage.some(ancs => ancs.has(referencedElement));
+          if (hasCycles) {
+            if (url.isHttpUrl(retrievalURI) || url.isFileSystemPath(retrievalURI)) {
+              // make the referencing URL or file system path absolute
+              const cycledPathItemElement = new PathItemElement({
+                $ref: $refBaseURI
+              }, pathItemElement.meta.clone(), pathItemElement.attributes.clone());
+              cycledPathItemElement.get('$ref').classes.push('cycle');
+              return cycledPathItemElement;
+            }
+            // skip processing this schema and all it's child schemas
+            return false;
+          }
+        }
 
         // append referencing schema to ancestors lineage
         directAncestors.add(pathItemElement);
@@ -233,21 +248,6 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = OpenApi3_1DereferenceVisitor.c
         // remove referencing schema from ancestors lineage
         directAncestors.delete(pathItemElement);
         this.indirections.pop();
-        if (!this.useCircularStructures) {
-          const hasCycles = ancestorsLineage.some(ancs => ancs.has(referencedElement));
-          if (hasCycles) {
-            if (url.isHttpUrl(retrievalURI) || url.isFileSystemPath(retrievalURI)) {
-              // make the referencing URL or file system path absolute
-              const cycledPathItemElement = new PathItemElement({
-                $ref: $refBaseURI
-              }, pathItemElement.meta.clone(), pathItemElement.attributes.clone());
-              cycledPathItemElement.get('$ref').classes.push('cycle');
-              return cycledPathItemElement;
-            }
-            // skip processing this schema but traverse all it's child schemas
-            return false;
-          }
-        }
 
         // merge fields from referenced Path Item with referencing one
         const mergedPathItemElement = new PathItemElement([...referencedElement.content], referencedElement.meta.clone(), referencedElement.attributes.clone());
@@ -290,7 +290,7 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = OpenApi3_1DereferenceVisitor.c
     },
     async SchemaElement(referencingElement, key, parent, path, ancestors) {
       try {
-        const [ancestorsLineage, directAncestors] = this.toAncestorLineage(ancestors);
+        const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
 
         // skip current referencing schema as $ref keyword was not defined
         if (!isStringElement(referencingElement.$ref)) {
@@ -380,6 +380,24 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = OpenApi3_1DereferenceVisitor.c
           throw new MaximumDereferenceDepthError(`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
         }
 
+        // useCircularStructures option processing
+        if (!this.useCircularStructures) {
+          const hasCycles = ancestorsLineage.some(ancs => ancs.has(referencedElement));
+          if (hasCycles) {
+            if (url.isHttpUrl(retrievalURI) || url.isFileSystemPath(retrievalURI)) {
+              // make the referencing URL or file system path absolute
+              const baseURI = url.resolve(retrievalURI, $refBaseURI);
+              const cycledSchemaElement = new SchemaElement({
+                $ref: baseURI
+              }, referencingElement.meta.clone(), referencingElement.attributes.clone());
+              cycledSchemaElement.get('$ref').classes.push('cycle');
+              return cycledSchemaElement;
+            }
+            // skip processing this schema and all it's child schemas
+            return false;
+          }
+        }
+
         // append referencing schema to ancestors lineage
         directAncestors.add(referencingElement);
 
@@ -414,24 +432,6 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = OpenApi3_1DereferenceVisitor.c
           return jsonSchemaBooleanElement;
         }
 
-        // useCircularStructures option processing
-        if (!this.useCircularStructures) {
-          const hasCycles = ancestorsLineage.some(ancs => ancs.has(referencedElement));
-          if (hasCycles) {
-            if (url.isHttpUrl(retrievalURI) || url.isFileSystemPath(retrievalURI)) {
-              // make the referencing URL or file system path absolute
-              const baseURI = url.resolve(retrievalURI, $refBaseURI);
-              const cycledSchemaElement = new SchemaElement({
-                $ref: baseURI
-              }, referencingElement.meta.clone(), referencingElement.attributes.clone());
-              cycledSchemaElement.get('$ref').classes.push('cycle');
-              return cycledSchemaElement;
-            }
-            // skip processing this schema but traverse all it's child schemas
-            return false;
-          }
-        }
-
         // Schema Object - merge keywords from referenced schema with referencing schema
         const mergedSchemaElement = new SchemaElement([...referencedElement.content], referencedElement.meta.clone(), referencedElement.attributes.clone());
         // existing keywords from referencing schema overrides ones from referenced schema

package/es/resolver/apidom/reference/resolve/resolvers/http-swagger-client/index.js

@@ -35,8 +35,17 @@ const HttpResolverSwaggerClient = HttpResolver.compose({
           url: file.uri,
           signal,
           userFetch: async (resource, options) => {
-            const res = await fetch(resource, options);
-            res.headers.delete('Content-Type');
+            let res = await fetch(resource, options);
+            try {
+              // node-fetch supports mutations
+              res.headers.delete('Content-Type');
+            } catch {
+              // Fetch API has guards which prevent mutations
+              res = new Response(res.body, _objectSpread(_objectSpread({}, res), {}, {
+                headers: new Headers(res.headers)
+              }));
+              res.headers.delete('Content-Type');
+            }
             return res;
           },
           credentials,

package/lib/execute/oas3/build-request.js

@@ -11,7 +11,8 @@ function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (O
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
-function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); } // This function runs after the common function,
+// `src/execute/index.js#buildRequest`
 function buildRequest(options, req) {
   const {
     operation,

package/lib/index.js

@@ -26,7 +26,7 @@ function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (O
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
-function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); } /* eslint-disable camelcase */
 Swagger.http = _index.default;
 Swagger.makeHttp = _index.makeHttp.bind(null, Swagger.http);
 Swagger.resolveStrategies = {

package/lib/resolver/apidom/reference/dereference/strategies/openapi-3-1-swagger-client/visitors/dereference.js

@@ -39,7 +39,7 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _openapi.OpenApi3_1Dereference
     async ReferenceElement(referenceElement, key, parent, path, ancestors) {
       try {
         var _this$basePath, _referenceElement$$re, _referenceElement$des, _referenceElement$sum;
-        const [ancestorsLineage, directAncestors] = this.toAncestorLineage(ancestors);
+        const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
 
         // skip already identified cycled Path Item Objects
         if ((0, _apidomCore.includesClasses)(['cycle'], referenceElement.$ref)) {
@@ -88,6 +88,21 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _openapi.OpenApi3_1Dereference
         if (this.indirections.length > this.options.dereference.maxDepth) {
           throw new _empty.MaximumDereferenceDepthError(`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
         }
+        if (!this.useCircularStructures) {
+          const hasCycles = ancestorsLineage.some(ancs => ancs.has(fragment));
+          if (hasCycles) {
+            if (_empty.url.isHttpUrl(retrievalURI) || _empty.url.isFileSystemPath(retrievalURI)) {
+              // make the referencing URL or file system path absolute
+              const cycledReferenceElement = new _apidomNsOpenapi.ReferenceElement({
+                $ref: $refBaseURI
+              }, referenceElement.meta.clone(), referenceElement.attributes.clone());
+              cycledReferenceElement.get('$ref').classes.push('cycle');
+              return cycledReferenceElement;
+            }
+            // skip processing this schema and all it's child schemas
+            return false;
+          }
+        }
 
         // append referencing schema to ancestors lineage
         directAncestors.add(referenceElement);
@@ -111,21 +126,6 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _openapi.OpenApi3_1Dereference
         // remove referencing schema from ancestors lineage
         directAncestors.delete(referenceElement);
         this.indirections.pop();
-        if (!this.useCircularStructures) {
-          const hasCycles = ancestorsLineage.some(ancs => ancs.has(fragment));
-          if (hasCycles) {
-            if (_empty.url.isHttpUrl(retrievalURI) || _empty.url.isFileSystemPath(retrievalURI)) {
-              // make the referencing URL or file system path absolute
-              const cycledReferenceElement = new _apidomNsOpenapi.ReferenceElement({
-                $ref: $refBaseURI
-              }, referenceElement.meta.clone(), referenceElement.attributes.clone());
-              cycledReferenceElement.get('$ref').classes.push('cycle');
-              return cycledReferenceElement;
-            }
-            // skip processing this schema but traverse all it's child schemas
-            return false;
-          }
-        }
         fragment = fragment.clone();
         fragment.setMetaProperty('ref-fields', {
           $ref: (_referenceElement$$re = referenceElement.$ref) === null || _referenceElement$$re === void 0 ? void 0 : _referenceElement$$re.toValue(),
@@ -173,7 +173,7 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _openapi.OpenApi3_1Dereference
     async PathItemElement(pathItemElement, key, parent, path, ancestors) {
       try {
         var _this$basePath3, _pathItemElement$$ref;
-        const [ancestorsLineage, directAncestors] = this.toAncestorLineage(ancestors);
+        const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
 
         // ignore PathItemElement without $ref field
         if (!(0, _apidomCore.isStringElement)(pathItemElement.$ref)) {
@@ -218,6 +218,21 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _openapi.OpenApi3_1Dereference
         if (this.indirections.length > this.options.dereference.maxDepth) {
           throw new _empty.MaximumDereferenceDepthError(`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
         }
+        if (!this.useCircularStructures) {
+          const hasCycles = ancestorsLineage.some(ancs => ancs.has(referencedElement));
+          if (hasCycles) {
+            if (_empty.url.isHttpUrl(retrievalURI) || _empty.url.isFileSystemPath(retrievalURI)) {
+              // make the referencing URL or file system path absolute
+              const cycledPathItemElement = new _apidomNsOpenapi.PathItemElement({
+                $ref: $refBaseURI
+              }, pathItemElement.meta.clone(), pathItemElement.attributes.clone());
+              cycledPathItemElement.get('$ref').classes.push('cycle');
+              return cycledPathItemElement;
+            }
+            // skip processing this schema and all it's child schemas
+            return false;
+          }
+        }
 
         // append referencing schema to ancestors lineage
         directAncestors.add(pathItemElement);
@@ -241,21 +256,6 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _openapi.OpenApi3_1Dereference
         // remove referencing schema from ancestors lineage
         directAncestors.delete(pathItemElement);
         this.indirections.pop();
-        if (!this.useCircularStructures) {
-          const hasCycles = ancestorsLineage.some(ancs => ancs.has(referencedElement));
-          if (hasCycles) {
-            if (_empty.url.isHttpUrl(retrievalURI) || _empty.url.isFileSystemPath(retrievalURI)) {
-              // make the referencing URL or file system path absolute
-              const cycledPathItemElement = new _apidomNsOpenapi.PathItemElement({
-                $ref: $refBaseURI
-              }, pathItemElement.meta.clone(), pathItemElement.attributes.clone());
-              cycledPathItemElement.get('$ref').classes.push('cycle');
-              return cycledPathItemElement;
-            }
-            // skip processing this schema but traverse all it's child schemas
-            return false;
-          }
-        }
 
         // merge fields from referenced Path Item with referencing one
         const mergedPathItemElement = new _apidomNsOpenapi.PathItemElement([...referencedElement.content], referencedElement.meta.clone(), referencedElement.attributes.clone());
@@ -300,7 +300,7 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _openapi.OpenApi3_1Dereference
     async SchemaElement(referencingElement, key, parent, path, ancestors) {
       try {
         var _this$basePath5, _referencingElement$$2;
-        const [ancestorsLineage, directAncestors] = this.toAncestorLineage(ancestors);
+        const [ancestorsLineage, directAncestors] = this.toAncestorLineage([...ancestors, parent]);
 
         // skip current referencing schema as $ref keyword was not defined
         if (!(0, _apidomCore.isStringElement)(referencingElement.$ref)) {
@@ -390,6 +390,24 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _openapi.OpenApi3_1Dereference
           throw new _empty.MaximumDereferenceDepthError(`Maximum dereference depth of "${this.options.dereference.maxDepth}" has been exceeded in file "${this.reference.uri}"`);
         }
 
+        // useCircularStructures option processing
+        if (!this.useCircularStructures) {
+          const hasCycles = ancestorsLineage.some(ancs => ancs.has(referencedElement));
+          if (hasCycles) {
+            if (_empty.url.isHttpUrl(retrievalURI) || _empty.url.isFileSystemPath(retrievalURI)) {
+              // make the referencing URL or file system path absolute
+              const baseURI = _empty.url.resolve(retrievalURI, $refBaseURI);
+              const cycledSchemaElement = new _apidomNsOpenapi.SchemaElement({
+                $ref: baseURI
+              }, referencingElement.meta.clone(), referencingElement.attributes.clone());
+              cycledSchemaElement.get('$ref').classes.push('cycle');
+              return cycledSchemaElement;
+            }
+            // skip processing this schema and all it's child schemas
+            return false;
+          }
+        }
+
         // append referencing schema to ancestors lineage
         directAncestors.add(referencingElement);
 
@@ -425,24 +443,6 @@ const OpenApi3_1SwaggerClientDereferenceVisitor = _openapi.OpenApi3_1Dereference
           return jsonSchemaBooleanElement;
         }
 
-        // useCircularStructures option processing
-        if (!this.useCircularStructures) {
-          const hasCycles = ancestorsLineage.some(ancs => ancs.has(referencedElement));
-          if (hasCycles) {
-            if (_empty.url.isHttpUrl(retrievalURI) || _empty.url.isFileSystemPath(retrievalURI)) {
-              // make the referencing URL or file system path absolute
-              const baseURI = _empty.url.resolve(retrievalURI, $refBaseURI);
-              const cycledSchemaElement = new _apidomNsOpenapi.SchemaElement({
-                $ref: baseURI
-              }, referencingElement.meta.clone(), referencingElement.attributes.clone());
-              cycledSchemaElement.get('$ref').classes.push('cycle');
-              return cycledSchemaElement;
-            }
-            // skip processing this schema but traverse all it's child schemas
-            return false;
-          }
-        }
-
         // Schema Object - merge keywords from referenced schema with referencing schema
         const mergedSchemaElement = new _apidomNsOpenapi.SchemaElement([...referencedElement.content], referencedElement.meta.clone(), referencedElement.attributes.clone());
         // existing keywords from referencing schema overrides ones from referenced schema

package/lib/resolver/apidom/reference/resolve/resolvers/http-swagger-client/index.js

@@ -43,8 +43,17 @@ const HttpResolverSwaggerClient = _empty.HttpResolver.compose({
           url: file.uri,
           signal,
           userFetch: async (resource, options) => {
-            const res = await fetch(resource, options);
-            res.headers.delete('Content-Type');
+            let res = await fetch(resource, options);
+            try {
+              // node-fetch supports mutations
+              res.headers.delete('Content-Type');
+            } catch {
+              // Fetch API has guards which prevent mutations
+              res = new Response(res.body, _objectSpread(_objectSpread({}, res), {}, {
+                headers: new Headers(res.headers)
+              }));
+              res.headers.delete('Content-Type');
+            }
             return res;
           },
           credentials,

package/lib/subtree-resolver/index.js

@@ -12,7 +12,28 @@ function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (O
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
-function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); } // The subtree resolver is a higher-level interface that allows you to
+// get the same result that you would from `Swagger.resolve`, but focuses on
+// a subtree of your object.
+//
+// It makes several assumptions that allow you to think less about what resolve,
+// specmap, and normalizeSwagger are doing: if this is not suitable for you,
+// you can emulate `resolveSubtree`'s behavior by talking to the traditional
+// resolver directly.
+//
+// By providing a top-level `obj` and a `path` to resolve within, the subtree
+// at `path` will be resolved and normalized in the context of your top-level
+// `obj`. You'll get the resolved subtree you're interest in as a return value
+// (or, you can use `returnEntireTree` to get everything back).
+//
+// This is useful for cases where resolving your entire object is unnecessary
+// and/or non-performant; we use this interface for lazily resolving operations
+// and models in Swagger-UI, which allows us to handle larger definitions.
+//
+// It's likely that Swagger-Client will rely entirely on lazy resolving in
+// future versions.
+//
+// TODO: move the remarks above into project documentation
 const resolveSubtree = async (obj, path, options = {}) => {
   const {
     returnEntireTree,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swagger-client",
-  "version": "3.19.4",
+  "version": "3.19.6",
   "description": "SwaggerJS - a collection of interfaces for OAI specs",
   "browser": {
     "./src/http/fold-formdata-to-request.node.js": "./src/http/fold-formdata-to-request.browser.js",
@@ -114,10 +114,10 @@
   },
   "dependencies": {
     "@babel/runtime-corejs3": "^7.20.13",
-    "@swagger-api/apidom-core": ">=0.69.1 <1.0.0",
-    "@swagger-api/apidom-json-pointer": ">=0.69.1 <1.0.0",
-    "@swagger-api/apidom-ns-openapi-3-1": ">=0.69.1 <1.0.0",
-    "@swagger-api/apidom-reference": ">=0.69.1 <1.0.0",
+    "@swagger-api/apidom-core": ">=0.69.2 <1.0.0",
+    "@swagger-api/apidom-json-pointer": ">=0.69.2 <1.0.0",
+    "@swagger-api/apidom-ns-openapi-3-1": ">=0.69.2 <1.0.0",
+    "@swagger-api/apidom-reference": ">=0.69.2 <1.0.0",
     "cookie": "~0.5.0",
     "cross-fetch": "^3.1.5",
     "deepmerge": "~4.3.0",