Request body refs (#454)

* Updated request body to support ref structure

* Added support for ref requestBody

Author: tshelburne

src/transform/operation.ts

@@ -1,5 +1,5 @@
-import { OperationObject, ParameterObject } from "../types";
-import { comment } from "../utils";
+import { OperationObject, ParameterObject, ReferenceObject } from "../types";
+import { comment, transformRef } from "../utils";
 import { transformParametersArray } from "./parameters";
 import { transformResponsesObj } from "./responses";
 import { transformSchemaObj } from "./schema";
@@ -18,20 +18,31 @@ export function transformOperationObj(
     output += `  responses: {\n  ${transformResponsesObj(operation.responses)}\n  }\n`;
   }
 
-  if (operation.requestBody && operation.requestBody.content) {
-    if (operation.requestBody.description) output += comment(operation.requestBody.description);
+  if (operation.requestBody) {
+    if (isRef(operation.requestBody)) {
+      output += `  requestBody: ${transformRef(operation.requestBody.$ref)};\n`;
+    } else {
+      const {description, content} = operation.requestBody
 
-    if (Object.keys(operation.requestBody.content).length) {
-      output += `  requestBody: {\n    content: {\n`; // open requestBody
+      if (description) output += comment(description);
+
+      if (content && Object.keys(content).length) {
+        output += `  requestBody: {\n    content: {\n`; // open requestBody
+
+        Object.entries(content).forEach(([k, v]) => {
+          output += `      "${k}": ${transformSchemaObj(v.schema)};\n`;
+        });
+        output += `    }\n  }\n`; // close requestBody
+      } else {
+        output += `  requestBody: unknown;\n`;
+      }
 
-      Object.entries(operation.requestBody.content).forEach(([k, v]) => {
-        output += `      "${k}": ${transformSchemaObj(v.schema)};\n`;
-      });
-      output += `    }\n  }\n`; // close requestBody
-    } else {
-      output += `  requestBody: unknown;\n`;
     }
   }
 
   return output;
 }
+
+export function isRef(obj: any): obj is ReferenceObject {
+  return !!obj.$ref
+}

src/types/index.ts

@@ -11,6 +11,7 @@ export interface OpenAPI3 {
   paths?: Record<string, PathItemObject>; // required
   components?: {
     schemas?: Record<string, ReferenceObject | SchemaObject>;
+    requestBodies?: Record<string, ReferenceObject | RequestBody>;
     responses?: Record<string, ReferenceObject | ResponseObject>;
     parameters?: Record<string, ReferenceObject | ParameterObject>;
     headers?: Record<string, ReferenceObject | HeaderObject>;
@@ -56,7 +57,7 @@ export interface OperationObject {
   operationId?: string;
   parameters?: (ReferenceObject | ParameterObject)[];
   responses?: Record<string, ReferenceObject | ResponseObject>; // required
-  requestBody?: RequestBody;
+  requestBody?: ReferenceObject | RequestBody;
 }
 
 export interface ParameterObject {