fix(APIC-758): request body description missing

Author: carowright

demo/APIC-758/APIC-758.yaml

@@ -0,0 +1,53 @@
+openapi: "3.0.0"
+externalDocs:
+  url: petstore.com
+  description: Pet Store website
+info:
+  version: 1.0.0
+  title: OpenAPI Spec 3.0  Petstore
+
+components:
+  schemas:
+    Pet:
+      type: object
+      required:
+        - id
+        - name
+      properties:
+        id:
+          type: integer
+          format: int64
+        name:
+          type: string
+        tag:
+          type: string
+    Error:
+      type: object
+      required:
+        - code
+        - message
+      properties:
+        code:
+          type: integer
+          format: int32
+        message:
+          type: string
+paths:
+  /pets:
+    post:
+      summary: Create a pet
+      requestBody:
+        description: Pet to add
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/Pet"
+      responses:
+        "201":
+          description: Null response
+        default:
+          description: unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"

demo/apis.json

@@ -9,5 +9,6 @@
   "APIC-463/APIC-463.raml": "RAML 1.0",
   "SE-12291/SE-12291.json": "OAS 2.0",
   "anyOf/anyOf.yaml": "ASYNC 2.0",
-  "steveTest-1/stevetest.json": "OAS 2.0"
+  "steveTest-1/stevetest.json": "OAS 2.0",
+  "APIC-758/APIC-758.yaml": "OAS 3.0"
 }

src/ApiBodyDocumentElement.d.ts

@@ -29,6 +29,14 @@ export declare class ApiBodyDocumentElement extends AmfHelperMixin(LitElement) {
    * type.
    */
   body: any[];
+  /**
+   * requestBody description for OAS 3.0 specs
+   */
+  bodyDescription: string;
+  /**
+   * requestBody description for OAS 3.0 specs
+   */
+  _bodyDescription: string;
   /**
    * List of discovered media types in the `body`.
    */

src/ApiBodyDocumentElement.js

@@ -41,6 +41,10 @@ export class ApiBodyDocumentElement extends AmfHelperMixin(LitElement) {
        * type.
        */
       body: { type: Array },
+      /**
+       * requestBody description for OAS 3.0 specs
+       */
+      bodyDescription: { type: String },
       /**
        * List of discovered media types in the `body`.
        */
@@ -203,6 +207,19 @@ export class ApiBodyDocumentElement extends AmfHelperMixin(LitElement) {
     this._bodyChanged();
   }
 
+  get bodyDescription() {
+    return this._bodyDescription;
+  }
+
+  set bodyDescription(value) {
+    const old = this._bodyDescription;
+    if (old === value) {
+      return;
+    }
+    this._bodyDescription = value;
+    this.requestUpdate('bodyDescription', old);
+  }
+
   get toggleActionLabel() {
     const { opened } = this;
     return opened ? 'Hide' : 'Show';
@@ -478,10 +495,12 @@ export class ApiBodyDocumentElement extends AmfHelperMixin(LitElement) {
       amf,
       narrow,
       renderReadOnly,
+      bodyDescription
     } = this;
     const hasBodyName = !!_bodyName;
     const hasDescription = !!_description;
     const hasTypeName = _typeName && _typeName !== 'default';
+    const hasBodyDescription = !!bodyDescription
 
     return html`
     <div class="media-type-selector">
@@ -490,6 +509,10 @@ export class ApiBodyDocumentElement extends AmfHelperMixin(LitElement) {
         this._mediaTypesTemplate() :
         html`<span class="media-type-label">${_selectedMediaType}</span>`}
     </div>
+    ${hasBodyDescription ? html`
+        <arc-marked .markdown="${bodyDescription}" sanitize>
+            <div slot="markdown-html" class="markdown-html" part="markdown-html"></div>
+        </arc-marked>` : ''}
     ${hasBodyName ? html`<div class="body-name type-title">${_bodyName}</div>` : ''}
     ${hasTypeName ? html`<div class="type-title">${_typeName}</div>` : ''}
     ${hasDescription ? html`

test/api-body-document.test.js

@@ -560,4 +560,35 @@ describe('ApiBodyDocumentElement', () => {
       });
     });
   });
+
+  describe('OAS 3.0', () => {
+    [
+      ['Full AMF model', false],
+      ['Compact AMF model', true]
+    ].forEach(([label, compact]) => {
+      describe(String(label), () => {
+        let element = /** @type ApiBodyDocumentElement */ (null);
+        let amf;
+        let payload;
+
+        before(async () => {
+          amf = await AmfLoader.load(compact, 'APIC-758');
+          payload = AmfLoader.lookupReturnsPayload(amf, '/pets', 'post', 201);
+        });
+
+        beforeEach(async () => {
+          element = await openedFixture();
+          element.amf = amf;
+          element.body = payload;
+          element.bodyDescription = 'Pet to add';
+          await nextFrame();
+          await aTimeout(0);
+        });
+
+        it('Sets body description value', async () => {
+          assert.equal(element._bodyDescription, 'Pet to add');
+        });
+      });
+    });
+  });
 });