fixed title and desc for arrays (#908)

Author: AyushShri

libV2/schemaUtils.js

@@ -900,6 +900,8 @@ let QUERYPARAM = 'query',
     else if (resolvedSchema.type === 'array' && resolvedSchema.items) {
       const arrayDetails = {
         type: resolvedSchema.type,
+        description: resolvedSchema.description,
+        title: resolvedSchema.title,
         items: processSchema(resolvedSchema.items)
       };
       if (resolvedSchema.minItems !== undefined) { arrayDetails.minItems = resolvedSchema.minItems; }

test/data/valid_openapi/test-title-description.json

@@ -104,6 +104,23 @@
             }
           }
         }
+      },
+      "/inventory": {
+        "get": {
+          "operationId": "listInventory",
+          "responses": {
+            "200": {
+              "description": "200 response",
+              "content": {
+                "application/json": {
+                  "schema": {
+                    "$ref": "#/components/schemas/ArrayOfInventoryItem"
+                  }
+                }
+              }
+            }
+          }
+        }
       }
     },
     "components": {
@@ -229,6 +246,22 @@
             "maxLength": 0
           }
         },
+        "InventoryItem": {
+          "title": "InventoryItem",
+          "description": "An inventory item.",
+          "type": "object",
+          "properties": {
+            "id": { "type": "string" }
+          }
+        },
+        "ArrayOfInventoryItem": {
+          "title": "ArrayOfInventoryItem",
+          "description": "A list of inventory items.",
+          "type": "array",
+          "items": {
+            "$ref": "#/components/schemas/InventoryItem"
+          }
+        },
         "TagList": {
           "title": "TagList",
           "description": "List of widget tags.",

test/unit/convertV2WithTypes.test.js

@@ -1333,6 +1333,15 @@ describe('convertV2WithTypes', function() {
       expect(res500Body.properties.message).to.have.property('description', 'Human-readable error message.');
       expect(res500Body.properties.details).to.have.property('title', 'ErrorDetails');
       expect(res500Body.properties.details).to.have.property('description', 'Optional error details.');
+      // verify arrays preserve title and description
+      const inventoryElement = extractedTypes['get/inventory'];
+      expect(inventoryElement).to.be.an('object').that.includes.keys('response');
+      const inventoryResBody = JSON.parse(inventoryElement.response['200'].body);
+      expect(inventoryResBody).to.have.property('type', 'array');
+      expect(inventoryResBody).to.have.property('title', 'ArrayOfInventoryItem');
+      expect(inventoryResBody).to.have.property('description', 'A list of inventory items.');
+      expect(inventoryResBody.items).to.have.property('title', 'InventoryItem');
+      expect(inventoryResBody.items).to.have.property('description', 'An inventory item.');
       done();
     });
   });