feat: addition of a getRequestBody accessor

__tests__/operation.test.ts

@@ -933,34 +933,83 @@ describe('#hasRequestBody()', () => {
   });
 });
 
+describe('#getRequestBody()', () => {
+  it('should return false on an operation without a requestBody', async () => {
+    const oas = Oas.init(petstore);
+    await oas.dereference();
+
+    const operation = oas.operation('/pet/findByStatus', 'get');
+    expect(operation.getRequestBody('application/json')).toBe(false);
+  });
+
+  it('should return false on an operation without the specified requestBody media type', async () => {
+    const oas = Oas.init(petstore);
+    await oas.dereference();
+
+    const operation = oas.operation('/pet', 'put');
+    expect(operation.getRequestBody('text/xml')).toBe(false);
+  });
+
+  it('should return the specified requestBody media type', async () => {
+    const oas = Oas.init(petstore);
+    await oas.dereference();
+
+    const operation = oas.operation('/pet', 'put');
+    expect(operation.getRequestBody('application/json')).toStrictEqual({
+      schema: {
+        properties: {
+          category: expect.objectContaining({ 'x-readme-ref-name': 'Category' }),
+          id: expect.any(Object),
+          name: expect.any(Object),
+          photoUrls: expect.any(Object),
+          status: expect.any(Object),
+          tags: {
+            items: expect.objectContaining({ 'x-readme-ref-name': 'Tag' }),
+            type: 'array',
+            xml: {
+              name: 'tag',
+              wrapped: true,
+            },
+          },
+        },
+        required: ['name', 'photoUrls'],
+        type: 'object',
+        xml: {
+          name: 'Pet',
+        },
+        'x-readme-ref-name': 'Pet',
+      },
+    });
+  });
+});
+
 describe('#getResponseByStatusCode()', () => {
   it('should return false if the status code doesnt exist', () => {
     const operation = Oas.init(petstore).operation('/pet/findByStatus', 'get');
     expect(operation.getResponseByStatusCode(202)).toBe(false);
   });
 
-  it('should return the response', () => {
-    const operation = Oas.init(petstore).operation('/pet/findByStatus', 'get');
+  it('should return the response', async () => {
+    const oas = Oas.init(petstore);
+    await oas.dereference();
+
+    const operation = oas.operation('/pet/findByStatus', 'get');
     expect(operation.getResponseByStatusCode(200)).toStrictEqual({
+      description: 'successful operation',
       content: {
         'application/json': {
           schema: {
-            items: {
-              $ref: '#/components/schemas/Pet',
-            },
             type: 'array',
+            items: expect.any(Object),
           },
         },
         'application/xml': {
           schema: {
-            items: {
-              $ref: '#/components/schemas/Pet',
-            },
             type: 'array',
+            items: expect.any(Object),
           },
         },
       },
-      description: 'successful operation',
     });
   });
 });

src/operation.ts

@@ -419,13 +419,33 @@ export default class Operation {
   }
 
   /**
-   * Determine if the operation has a request body.
+   * Determine if the operation has any request bodies.
    *
    */
   hasRequestBody(): boolean {
     return !!this.schema.requestBody;
   }
 
+  /**
+   * Retrieve a specific request body content schema off this operation.
+   *
+   * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#mediaTypeObject}
+   * @see {@link https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#mediaTypeObject}
+   * @param mediaType Specific request body media type to retrieve if present.
+   */
+  getRequestBody(mediaType: string) {
+    if (!this.hasRequestBody()) {
+      return false;
+    }
+
+    const requestBody = this.schema.requestBody;
+    if (RMOAS.isRef(requestBody) || !(mediaType in requestBody.content)) {
+      return false;
+    }
+
+    return requestBody.content[mediaType];
+  }
+
   /**
    * Retrieve an array of request body examples that this operation has.
    *