feat: add v2Responses object to v1 EndpointDefinition type (#3275)

Author: sahil485

fern/apis/fdr/definition/api/v1/db/endpoint.yml

@@ -25,6 +25,7 @@ types:
       headers: list<readEndpoint.Header>
       request: optional<DbHttpRequest>
       response: optional<readEndpoint.HttpResponse>
+      responsesV2: optional<readEndpoint.HttpResponsesV2>
       errors: optional<list<readEndpoint.ErrorDeclaration>>
       errorsV2: optional<list<readEndpoint.ErrorDeclarationV2>>
       examples: list<readEndpoint.ExampleEndpointCall>

fern/apis/fdr/definition/api/v1/read/endpoint.yml

@@ -28,6 +28,7 @@ types:
       headers: list<Header>
       request: optional<HttpRequest>
       response: optional<HttpResponse>
+      responsesV2: optional<HttpResponsesV2>
       errors:
         type: list<ErrorDeclaration>
         availability: deprecated
@@ -100,6 +101,10 @@ types:
         type: optional<integer>
         docs: Defaults to 200
 
+  HttpResponsesV2:
+    properties:
+      responses: optional<list<HttpResponse>>
+
   JsonBodyShape:
     union:
       object: type.ObjectType

fern/apis/fdr/definition/api/v1/register/endpoint.yml

@@ -33,6 +33,7 @@ types:
       headers: list<Header>
       request: optional<HttpRequest>
       response: optional<HttpResponse>
+      responsesV2: optional<HttpResponsesV2>
       errors:
         type: optional<list<ErrorDeclaration>>
         availability: deprecated
@@ -113,6 +114,10 @@ types:
       statusCode:
         type: optional<integer>
         docs: Defaults to 200
+  
+  HttpResponsesV2:
+    properties:
+      responses: optional<list<HttpResponse>>
 
   ErrorDeclaration:
     extends:

packages/fdr-sdk/src/api-definition/migrators/v1ToV2.ts

@@ -212,7 +212,17 @@ export class ApiDefinitionV1ToLatest {
       requestHeaders: this.migrateParameters(v1.headers),
       responseHeaders: undefined,
       requests: [this.migrateHttpRequest(v1.request)].filter(isNonNullish),
-      responses: [this.migrateHttpResponse(v1.response)].filter(isNonNullish),
+      responses: (() => {
+        const responses = v1.responsesV2?.responses
+          ?.map((response) => this.migrateHttpResponse(response))
+          ?.filter(isNonNullish);
+
+        if (responses != null && responses.length > 0) {
+          return responses;
+        }
+
+        return [this.migrateHttpResponse(v1.response)].filter(isNonNullish);
+      })(),
       errors: this.migrateHttpErrors(v1.errorsV2),
       examples: undefined,
       snippetTemplates: v1.snippetTemplates,