fix: comment for functional api (#100)

Author: Himenon

src/code-templates/functional-api-client/FunctionalApiClient/Method.ts renamed to src/code-templates/functional-api-client/FunctionalApiClient/ArrowFunction.ts

@@ -117,11 +117,9 @@ const methodTypeParameters = (factory: TsGenerator.Factory.Type, { convertedPara
 };
 
 /**
- * const {functionName} = async (params: {argumentParamsTypeDeclaration}<{RequestContentType}>): Promise<{requestBodyName}[ResponseContentType]> => {
- *
- * }
+ * async (params: {argumentParamsTypeDeclaration}<{RequestContentType}>): Promise<{requestBodyName}[ResponseContentType]> => {}
  */
-export const create = (factory: TsGenerator.Factory.Type, params: CodeGenerator.Params, option: Option): ts.VariableStatement => {
+export const create = (factory: TsGenerator.Factory.Type, params: CodeGenerator.Params, option: Option): ts.ArrowFunction => {
   const { convertedParams } = params;
   const typeParameters: ts.TypeParameterDeclaration[] = methodTypeParameters(factory, params);
   const methodArguments: ts.ParameterDeclaration[] = [];
@@ -153,7 +151,7 @@ export const create = (factory: TsGenerator.Factory.Type, params: CodeGenerator.
     }),
   );
 
-  const arrowFunction = factory.ArrowFunction.create({
+  return factory.ArrowFunction.create({
     typeParameters: typeParameters,
     parameters: methodArguments,
     type: returnType,
@@ -162,18 +160,4 @@ export const create = (factory: TsGenerator.Factory.Type, params: CodeGenerator.
       multiLine: true,
     }),
   });
-
-  const variableDeclarationList = factory.VariableDeclarationList.create({
-    declarations: [
-      factory.VariableDeclaration.create({
-        name: convertedParams.functionName,
-        initializer: arrowFunction,
-      }),
-    ],
-    flag: "const",
-  });
-
-  return factory.VariableStatement.create({
-    declarationList: variableDeclarationList,
-  });
 };

src/code-templates/functional-api-client/FunctionalApiClient/ClientTypeDefinition.ts

@@ -0,0 +1,11 @@
+import type { TsGenerator } from "../../../api";
+
+export const create = (factory: TsGenerator.Factory.Type) => {
+  return factory.TypeAliasDeclaration.create({
+    export: true,
+    name: "Client",
+    type: factory.TypeReferenceNode.create({
+      name: `ReturnType<typeof createClient>`,
+    })
+  })
+};

src/code-templates/functional-api-client/FunctionalApiClient/ReturnStatement.ts

@@ -13,6 +13,7 @@ export const create = (factory: TsGenerator.Factory.Type, list: CodeGenerator.Pa
   return factory.ReturnStatement.create({
     expression: factory.ObjectLiteralExpression.create({
       properties,
+      multiLine: true,
     }),
   });
 };

src/code-templates/functional-api-client/FunctionalApiClient/index.ts

@@ -1,15 +1,29 @@
+import { EOL } from "os";
 import ts from "typescript";
 
 import type { TsGenerator } from "../../../api";
 import type { CodeGenerator } from "../../../types";
 import type { Option } from "../../_shared/types";
-import * as Method from "./Method";
-import * as ReturnStatement from "./ReturnStatement";
-export { Method };
+import * as ArrowFunction from "./ArrowFunction";
 
 export const create = (factory: TsGenerator.Factory.Type, list: CodeGenerator.Params[], option: Option): ts.VariableStatement => {
-  const variableStatements = list.map(params => {
-    return Method.create(factory, params, option);
+  const properties = list.map(params => {
+    return factory.PropertyAssignment.create({
+      name: params.convertedParams.functionName,
+      initializer: ArrowFunction.create(factory, params, option),
+      comment: option.additionalMethodComment
+        ? [params.operationParams.comment, `operationId: ${params.operationId}`, `Request URI: ${params.operationParams.requestUri}`]
+            .filter(t => !!t)
+            .join(EOL)
+        : params.operationParams.comment,
+    });
+  });
+
+  const returnValue = factory.ReturnStatement.create({
+    expression: factory.ObjectLiteralExpression.create({
+      properties,
+      multiLine: true,
+    }),
   });
 
   const arrowFunction = factory.ArrowFunction.create({
@@ -36,7 +50,7 @@ export const create = (factory: TsGenerator.Factory.Type, list: CodeGenerator.Pa
       }),
     ],
     body: factory.Block.create({
-      statements: [...variableStatements, ReturnStatement.create(factory, list)],
+      statements: [returnValue],
       multiLine: true,
     }),
   });

src/code-templates/functional-api-client/index.ts

@@ -5,6 +5,7 @@ import type { CodeGenerator } from "../../types";
 import * as ApiClientArgument from "../_shared/ApiClientArgument";
 import * as FunctionalApiClient from "./FunctionalApiClient";
 import * as ApiClientInterface from "../_shared/ApiClientInterface";
+import * as ClientTypeDefinition from "./FunctionalApiClient/ClientTypeDefinition";
 
 import type { Option } from "../_shared/types";
 
@@ -36,5 +37,6 @@ export const generator: CodeGenerator.GenerateFunction<Option> = (
 
   const apiClientStatement = FunctionalApiClient.create(factory, codeGeneratorParamsList, option || {});
   statements.push(apiClientStatement);
+  statements.push(ClientTypeDefinition.create(factory));
   return statements;
 };

src/internal/TsGenerator/factory/ArrowFunction.ts

@@ -23,6 +23,7 @@ export const create =
       params.equalsGreaterThanToken,
       params.body,
     );
+
     return node;
   };
 

src/internal/TsGenerator/factory/PropertyAssignment.ts

@@ -1,8 +1,11 @@
 import ts from "typescript";
+import { generateComment } from "./utils";
 
 export interface Params {
   name: string;
   initializer: ts.Expression;
+  comment?: string;
+  deprecated?: boolean;
 }
 
 export interface Factory {
@@ -13,6 +16,10 @@ export const create =
   ({ factory }: Pick<ts.TransformationContext, "factory">): Factory["create"] =>
   (params: Params): ts.PropertyAssignment => {
     const node = factory.createPropertyAssignment(params.name, params.initializer);
+    if (params.comment) {
+      const comment = generateComment(params.comment, params.deprecated);
+      return ts.addSyntheticLeadingComment(node, ts.SyntaxKind.MultiLineCommentTrivia, comment.value, comment.hasTrailingNewLine);
+    }
     return node;
   };
 

src/internal/TsGenerator/factory/VariableDeclaration.ts

@@ -1,4 +1,5 @@
 import ts from "typescript";
+import { generateComment } from "./utils";
 
 export interface Params {
   name: string | ts.BindingName;

src/internal/TsGenerator/factory/VariableDeclarationList.ts

@@ -1,4 +1,5 @@
 import ts from "typescript";
+import { generateComment } from "./utils";
 
 const flags = {
   const: ts.NodeFlags.Const,
@@ -7,6 +8,7 @@ const flags = {
 export interface Params {
   declarations: readonly ts.VariableDeclaration[];
   flag: keyof typeof flags;
+
 }
 
 export interface Factory {

src/meta.ts

@@ -1,2 +1,2 @@
 export const Name = "@himenon/openapi-typescript-code-generator";
-export const Version = "0.21.0";
+export const Version = "0.22.0";