Fixing issue #309

lib/schemaUtils.js

@@ -512,6 +512,24 @@ module.exports = {
     return reqParam;
   },
 
+  dereferenceFromOutOfComponents: function (spec, reference) {
+    let splitRef = reference.split('/'),
+      resolvedContent;
+
+    splitRef = splitRef.slice(1).map((elem) => {
+      // https://swagger.io/docs/specification/using-ref#escape
+      // since / is the default delimiter, slashes are escaped with ~1
+      return decodeURIComponent(
+        elem
+          .replace(/~1/g, '/')
+          .replace(/~0/g, '~')
+      );
+    });
+
+    resolvedContent = deref._getEscaped(spec, splitRef);
+    return resolvedContent;
+  },
+
   /**
    * Generates a Trie-like folder structure from the root path object of the OpenAPI specification.
    * @param {Object} spec - specification in json format
@@ -585,6 +603,10 @@ module.exports = {
 
         pathLength = currentPath.length;
 
+        if (currentPathObject.hasOwnProperty('$ref')) {
+          currentPathObject = this.dereferenceFromOutOfComponents(spec, currentPathObject.$ref);
+        }
+
         // get method names available for this path
         pathMethods = getPathMethods(Object.keys(currentPathObject));
 
@@ -799,6 +821,10 @@ module.exports = {
         collectionVariables,
         pathLevelServers = '';
 
+      if (currentPathObject.hasOwnProperty('$ref')) {
+        currentPathObject = this.dereferenceFromOutOfComponents(spec, currentPathObject.$ref);
+      }
+
       // discard the leading slash, if it exists
       if (path[0] === '/') {
         path = path.substring(1);