chore(codegen): add error response names

Author: Himenon

src/Converter/v3/Generator.ts

@@ -14,7 +14,7 @@ const extractPickedParameter = (parameter: OpenApi.Parameter): PickedParameter =
   };
 };
 
-const extractSuccessStatusCode = (responses: { [statusCode: string]: OpenApi.Response }): string[] => {
+const extractResponseNamesByStatusCode = (type: "success" | "error", responses: { [statusCode: string]: OpenApi.Response }): string[] => {
   const statusCodeList: string[] = [];
   Object.entries(responses || {}).forEach(([statusCodeLike, response]) => {
     // ContentTypeの定義が存在しない場合はstatusCodeを読み取らない
@@ -23,8 +23,14 @@ const extractSuccessStatusCode = (responses: { [statusCode: string]: OpenApi.Res
     }
     if (typeof statusCodeLike === "string") {
       const statusCodeNumberValue = parseInt(statusCodeLike, 10);
-      if (200 <= statusCodeNumberValue && statusCodeNumberValue < 300) {
-        statusCodeList.push(statusCodeNumberValue.toString());
+      if (type === "success") {
+        if (200 <= statusCodeNumberValue && statusCodeNumberValue < 300) {
+          statusCodeList.push(statusCodeNumberValue.toString());
+        }
+      } else if (type === "error") {
+        if (400 <= statusCodeNumberValue && statusCodeNumberValue < 600) {
+          statusCodeList.push(statusCodeNumberValue.toString());
+        }
       }
     }
   });
@@ -37,7 +43,7 @@ const getRequestContentTypeList = (requestBody: OpenApi.RequestBody): string[] =
 
 const getSuccessResponseContentTypeList = (responses: { [statusCode: string]: OpenApi.Response }): string[] => {
   let contentTypeList: string[] = [];
-  extractSuccessStatusCode(responses).forEach(statusCode => {
+  extractResponseNamesByStatusCode("success", responses).forEach(statusCode => {
     const response = responses[statusCode];
     contentTypeList = contentTypeList.concat(Object.keys(response.content || {}));
   });
@@ -55,7 +61,10 @@ const generateCodeGeneratorParamsList = (store: Store.Type, converterContext: Co
   const operationState = store.getNoReferenceOperationState();
   const params: CodeGeneratorParams[] = [];
   Object.entries(operationState).forEach(([operationId, item]) => {
-    const responseSuccessNames = extractSuccessStatusCode(item.responses).map(statusCode =>
+    const responseSuccessNames = extractResponseNamesByStatusCode("success", item.responses).map(statusCode =>
+      converterContext.generateResponseName(operationId, statusCode),
+    );
+    const responseErrorNames = extractResponseNamesByStatusCode("error", item.responses).map(statusCode =>
       converterContext.generateResponseName(operationId, statusCode),
     );
     const requestContentTypeList = item.requestBody ? getRequestContentTypeList(item.requestBody) : [];
@@ -65,6 +74,7 @@ const generateCodeGeneratorParamsList = (store: Store.Type, converterContext: Co
 
     const formatParams: CodeGeneratorParams = {
       operationId: operationId,
+      escapedOperationId: converterContext.escapeOperationIdText(operationId),
       rawRequestUri: item.requestUri,
       httpMethod: item.httpMethod,
       argumentParamsTypeDeclaration: converterContext.generateArgumentParamsTypeDeclaration(operationId),
@@ -88,6 +98,7 @@ const generateCodeGeneratorParamsList = (store: Store.Type, converterContext: Co
       responseSuccessNames: responseSuccessNames,
       responseFirstSuccessName: responseSuccessNames.length === 1 ? responseSuccessNames[0] : undefined,
       has2OrMoreSuccessNames: hasOver2SuccessNames,
+      responseErrorNames: responseErrorNames,
       // Response Success Content Type
       successResponseContentTypes: responseSuccessContentTypes,
       successResponseFirstContentType: responseSuccessContentTypes.length === 1 ? responseSuccessContentTypes[0] : undefined,

src/Converter/v3/types/CodeGeneratorParams.ts

@@ -4,6 +4,7 @@ export type PickedParameter = Pick<OpenApi.Parameter, "name" | "in" | "required"
 
 export interface CodeGeneratorParams {
   operationId: string;
+  escapedOperationId: string;
   httpMethod: string; // get, post, put, delete ...etc
   rawRequestUri: string;
   functionName: string;
@@ -19,6 +20,8 @@ export interface CodeGeneratorParams {
   requestContentTypes: string[];
   requestFirstContentType: string | undefined; // requestContentTypes.length === 1 only
   has2OrMoreRequestContentTypes: boolean; // requestContentTypes.length > 1
+  // Response Error Response Name
+  responseErrorNames: string[];
   // Response Success Name
   responseSuccessNames: string[]; // `Response$${operationId}$Status$${statusCode}`[]
   responseFirstSuccessName: string | undefined; // responseSuccessNames.length === 1 only

src/DefaultCodeTemplate/ApiClientClass/ApiClientInterface.ts

@@ -5,6 +5,27 @@ import { CodeGeneratorParams } from "../../Converter/v3";
 
 const httpMethodList: string[] = ["GET", "PUT", "POST", "DELETE", "OPTIONS", "HEAD", "PATCH", "TRACE"];
 
+const createErrorResponsesTypeAlias = (typeName: string, factory: Factory.Type, errorResponseNames: string[]) => {
+  if (errorResponseNames.length === 0) {
+    return factory.TypeAliasDeclaration.create({
+      export: true,
+      name: typeName,
+      type: ts.factory.createToken(ts.SyntaxKind.VoidKeyword),
+    });
+  }
+  return factory.TypeAliasDeclaration.create({
+    export: true,
+    name: typeName,
+    type: factory.UnionTypeNode.create({
+      typeNodes: errorResponseNames.map(name => {
+        return factory.TypeReferenceNode.create({
+          name,
+        });
+      }),
+    }),
+  });
+};
+
 const createSuccessResponseTypeAlias = (typeName: string, factory: Factory.Type, successResponseNames: string[]) => {
   if (successResponseNames.length === 0) {
     return factory.TypeAliasDeclaration.create({
@@ -134,6 +155,10 @@ export const create = (factory: Factory.Type, list: CodeGeneratorParams[]): ts.S
 
   const successResponseNames = list.map(item => item.responseSuccessNames).flat();
 
+  const errorResponseTypes = list.map(item => {
+    return createErrorResponsesTypeAlias(`ErrorResponses$${item.escapedOperationId}`, factory, item.responseErrorNames);
+  });
+
   const functionType = factory.FunctionTypeNode.create({
     typeParameters: [
       factory.TypeParameterDeclaration.create({
@@ -165,6 +190,7 @@ export const create = (factory: Factory.Type, list: CodeGeneratorParams[]): ts.S
     createObjectLikeInterface(factory),
     ...createQueryParamsDeclarations(factory),
     createSuccessResponseTypeAlias("SuccessResponses", factory, successResponseNames),
+    ...errorResponseTypes,
     factory.InterfaceDeclaration.create({
       export: true,
       name: "ApiClient",