Fix Issue#627: Add defined example parameter when schema is resolved

Author: aman-v-singh

lib/deref.js

@@ -295,6 +295,9 @@ module.exports = {
         resolvedSchema = concreteUtils.addOuterPropsToRefSchemaIfIsSupported(resolvedSchema, outerProperties);
       }
       if (resolvedSchema) {
+        if (schema.example) {
+          resolvedSchema.example = schema.example;
+        }
         let refResolvedSchema = this.resolveRefs(resolvedSchema, parameterSourceOption,
           components, {
             resolveFor,

test/unit/deref.test.js

@@ -313,6 +313,32 @@ describe('DEREF FUNCTION TESTS ', function() {
       expect(output.required).to.not.include('tag');
       done();
     });
+
+    it('should return schema with example parameter(if given) for $ref just like inline schema', function(done) {
+      var schema = {
+          $ref: '#/components/schemas/schema1'
+        },
+        componentsAndPaths = {
+          components: {
+            schemas: {
+              schema1: {
+                description: 'The unique identifier of a spacecraft',
+                enum: [
+                  'asc',
+                  'desc'
+                ],
+                type: 'string'
+              }
+            }
+          }
+        },
+        parameterSource = 'REQUEST',
+        // deref.resolveRefs modifies the input schema and components so cloning to keep tests independent of each other
+        output = deref.resolveRefs(schema, parameterSource, _.cloneDeep(componentsAndPaths), {});
+
+      expect(output.example).to.equal(schema.example);
+      done();
+    });
   });
 
   describe('resolveAllOf Function', function () {