@nestia/migrate 0.5.1 → 0.6.1

package/src/programmers/NestControllerProgrammer.ts

@@ -0,0 +1,47 @@
+import ts from "typescript";
+
+import { IMigrateController } from "../structures/IMigrateController";
+import { ISwaggerComponents } from "../structures/ISwaggerComponents";
+import { FilePrinter } from "../utils/FilePrinter";
+import { StringUtil } from "../utils/StringUtil";
+import { ImportProgrammer } from "./ImportProgrammer";
+import { NestMethodProgrammer } from "./NestMethodProgrammer";
+
+export namespace NestControllerProgrammer {
+  export const write =
+    (components: ISwaggerComponents) =>
+    (controller: IMigrateController): ts.Statement[] => {
+      const importer: ImportProgrammer = new ImportProgrammer();
+      const $class = ts.factory.createClassDeclaration(
+        [
+          ts.factory.createDecorator(
+            ts.factory.createCallExpression(
+              ts.factory.createIdentifier(
+                importer.external({
+                  library: "@nestjs/common",
+                  instance: "Controller",
+                }),
+              ),
+              [],
+              [ts.factory.createStringLiteral(controller.path)],
+            ),
+          ),
+          ts.factory.createToken(ts.SyntaxKind.ExportKeyword),
+        ],
+        controller.name,
+        [],
+        [],
+        controller.routes.map(NestMethodProgrammer.write(components)(importer)),
+      );
+      return [
+        ...importer.toStatements(
+          (ref) =>
+            `${"../".repeat(
+              StringUtil.splitWithNormalization(controller.location).length - 1,
+            )}api/structures/${ref}`,
+        ),
+        ...(importer.empty() ? [] : [FilePrinter.enter()]),
+        $class,
+      ];
+    };
+}

package/src/programmers/NestMethodProgrammer.ts

@@ -0,0 +1,211 @@
+import ts from "typescript";
+import { ExpressionFactory } from "typia/lib/factories/ExpressionFactory";
+import { IdentifierFactory } from "typia/lib/factories/IdentifierFactory";
+import { TypeFactory } from "typia/lib/factories/TypeFactory";
+
+import { IMigrateRoute } from "../structures/IMigrateRoute";
+import { ISwaggerSchema } from "../structures/ISwaggeSchema";
+import { ISwaggerComponents } from "../structures/ISwaggerComponents";
+import { FilePrinter } from "../utils/FilePrinter";
+import { StringUtil } from "../utils/StringUtil";
+import { ImportProgrammer } from "./ImportProgrammer";
+import { SchemaProgrammer } from "./SchemaProgrammer";
+
+export namespace NestMethodProgrammer {
+  export const write =
+    (components: ISwaggerComponents) =>
+    (importer: ImportProgrammer) =>
+    (route: IMigrateRoute): ts.MethodDeclaration => {
+      const output: ts.TypeNode = route.success
+        ? SchemaProgrammer.write(importer)(components)(route.success.schema)
+        : TypeFactory.keyword("void");
+
+      const method: ts.MethodDeclaration = ts.factory.createMethodDeclaration(
+        [
+          ...writeMethodDecorators(components)(importer)(route),
+          ts.factory.createToken(ts.SyntaxKind.PublicKeyword),
+          ts.factory.createToken(ts.SyntaxKind.AsyncKeyword),
+        ],
+        undefined,
+        route.name,
+        undefined,
+        undefined,
+        writeParameters(importer)(components)(route),
+        ts.factory.createTypeReferenceNode("Promise", [output]),
+        ts.factory.createBlock(
+          [
+            ...[
+              ...route.parameters.map((p) => StringUtil.normalize(p.key)),
+              ...(route.headers ? ["headers"] : []),
+              ...(route.query ? ["query"] : []),
+              ...(route.body ? ["body"] : []),
+            ].map((str) =>
+              ts.factory.createExpressionStatement(
+                ts.factory.createIdentifier(str),
+              ),
+            ),
+            ts.factory.createReturnStatement(
+              ts.factory.createCallExpression(
+                ts.factory.createIdentifier(
+                  importer.external({
+                    library: "typia",
+                    instance: "random",
+                  }),
+                ),
+                [output],
+                undefined,
+              ),
+            ),
+          ],
+          true,
+        ),
+      );
+      return FilePrinter.description(method, route.description ?? "");
+    };
+
+  const writeMethodDecorators =
+    (components: ISwaggerComponents) =>
+    (importer: ImportProgrammer) =>
+    (route: IMigrateRoute): ts.Decorator[] => {
+      const external =
+        (lib: string) =>
+        (instance: string): ts.Identifier =>
+          ts.factory.createIdentifier(
+            importer.external({ library: lib, instance }),
+          );
+      const router = (instance: string) =>
+        ts.factory.createDecorator(
+          ts.factory.createCallExpression(
+            IdentifierFactory.access(external("@nestia/core")(instance))(
+              StringUtil.capitalize(route.method),
+            ),
+            [],
+            [ts.factory.createStringLiteral(route.path)],
+          ),
+        );
+
+      const decorators: ts.Decorator[] = [];
+      if (route.success?.["x-nestia-encrypted"])
+        decorators.push(router("EncryptedRoute"));
+      else if (route.success?.type === "text/plain")
+        decorators.push(
+          ts.factory.createDecorator(
+            ts.factory.createCallExpression(
+              external("@nestjs/common")(StringUtil.capitalize(route.method)),
+              [],
+              [ts.factory.createStringLiteral(route.path)],
+            ),
+          ),
+        );
+      else if (route.success?.type === "application/x-www-form-urlencoded")
+        decorators.push(router("TypedQuery"));
+      else if (route.success?.type === "application/json")
+        decorators.push(router("TypedRoute"));
+      else if (route.method === "head")
+        decorators.push(
+          ts.factory.createDecorator(
+            ts.factory.createCallExpression(
+              external("@nestjs/common")("Head"),
+              [],
+              [ts.factory.createStringLiteral(route.path)],
+            ),
+          ),
+        );
+      for (const [key, value] of Object.entries(route.exceptions ?? {}))
+        decorators.push(
+          ts.factory.createDecorator(
+            ts.factory.createCallExpression(
+              external("@nestia/core")("TypedException"),
+              [SchemaProgrammer.write(importer)(components)(value.schema)],
+              [
+                isNaN(Number(key))
+                  ? ts.factory.createStringLiteral(key)
+                  : ExpressionFactory.number(Number(key)),
+                ...(value.description?.length
+                  ? [ts.factory.createStringLiteral(value.description)]
+                  : []),
+              ],
+            ),
+          ),
+        );
+      return decorators;
+    };
+
+  const writeParameters =
+    (importer: ImportProgrammer) =>
+    (components: ISwaggerComponents) =>
+    (route: IMigrateRoute): ts.ParameterDeclaration[] => [
+      ...route.parameters.map(({ key, schema: value }) =>
+        ts.factory.createParameterDeclaration(
+          [
+            ts.factory.createDecorator(
+              ts.factory.createCallExpression(
+                ts.factory.createIdentifier(
+                  importer.external({
+                    library: "@nestia/core",
+                    instance: "TypedParam",
+                  }),
+                ),
+                undefined,
+                [ts.factory.createStringLiteral(key)],
+              ),
+            ),
+          ],
+          undefined,
+          StringUtil.normalize(key),
+          undefined,
+          SchemaProgrammer.write(importer)(components)(value),
+        ),
+      ),
+      ...(route.headers
+        ? [
+            writeDtoParameter({ method: "TypedHeaders", variable: "headers" })(
+              importer,
+            )(components)(route.headers),
+          ]
+        : []),
+      ...(route.query
+        ? [
+            writeDtoParameter({ method: "TypedQuery", variable: "query" })(
+              importer,
+            )(components)(route.query),
+          ]
+        : []),
+      ...(route.body
+        ? [
+            writeDtoParameter({
+              method: route.body?.["x-nestia-encrypted"]
+                ? "EncryptedBody"
+                : "TypedBody",
+              variable: "body",
+            })(importer)(components)(route.body.schema),
+          ]
+        : []),
+    ];
+
+  const writeDtoParameter =
+    (accessor: { method: string; variable: string }) =>
+    (importer: ImportProgrammer) =>
+    (components: ISwaggerComponents) =>
+    (schema: ISwaggerSchema): ts.ParameterDeclaration =>
+      ts.factory.createParameterDeclaration(
+        [
+          ts.factory.createDecorator(
+            ts.factory.createCallExpression(
+              ts.factory.createIdentifier(
+                importer.external({
+                  library: "@nestia/core",
+                  instance: accessor.method,
+                }),
+              ),
+              undefined,
+              undefined,
+            ),
+          ),
+        ],
+        undefined,
+        StringUtil.normalize(accessor.variable),
+        undefined,
+        SchemaProgrammer.write(importer)(components)(schema),
+      );
+}

package/src/programmers/NestModuleProgrammer.ts

@@ -0,0 +1,62 @@
+import ts from "typescript";
+
+import { IMigrateController } from "../structures/IMigrateController";
+import { FilePrinter } from "../utils/FilePrinter";
+
+export namespace NestModuleProgrammer {
+  export const write = (controllers: IMigrateController[]): ts.Statement[] => [
+    $import("@nestjs/common")("Module"),
+    ...(controllers.length ? [FilePrinter.enter()] : []),
+    ...controllers.map((c) =>
+      $import(`${c.location.replace("src/", "./")}/${c.name}`)(c.name),
+    ),
+    ...(controllers.length ? [FilePrinter.enter()] : []),
+    ts.factory.createClassDeclaration(
+      [
+        ts.factory.createDecorator(
+          ts.factory.createCallExpression(
+            ts.factory.createIdentifier("Module"),
+            undefined,
+            [
+              ts.factory.createObjectLiteralExpression(
+                [
+                  ts.factory.createPropertyAssignment(
+                    ts.factory.createIdentifier("controllers"),
+                    ts.factory.createArrayLiteralExpression(
+                      controllers.map((c) =>
+                        ts.factory.createIdentifier(c.name),
+                      ),
+                    ),
+                  ),
+                ],
+                true,
+              ),
+            ],
+          ),
+        ),
+        ts.factory.createToken(ts.SyntaxKind.ExportKeyword),
+      ],
+      "MyModule",
+      undefined,
+      undefined,
+      [],
+    ),
+  ];
+}
+
+const $import = (file: string) => (instance: string) =>
+  ts.factory.createImportDeclaration(
+    undefined,
+    ts.factory.createImportClause(
+      false,
+      undefined,
+      ts.factory.createNamedImports([
+        ts.factory.createImportSpecifier(
+          false,
+          undefined,
+          ts.factory.createIdentifier(instance),
+        ),
+      ]),
+    ),
+    ts.factory.createStringLiteral(file),
+  );

package/src/programmers/NestProgrammer.ts

@@ -0,0 +1,74 @@
+import ts from "typescript";
+
+import { IMigrateFile } from "../structures/IMigrateFile";
+import { IMigrateProgram } from "../structures/IMigrateProgram";
+import { FilePrinter } from "../utils/FilePrinter";
+import { DtoProgrammer } from "./DtoProgrammer";
+import { ImportProgrammer } from "./ImportProgrammer";
+import { NestControllerProgrammer } from "./NestControllerProgrammer";
+import { NestModuleProgrammer } from "./NestModuleProgrammer";
+
+export namespace MigrateProgrammer {
+  export const write = (program: IMigrateProgram): IMigrateFile[] =>
+    [
+      {
+        location: "src",
+        file: "MyModule.ts",
+        statements: NestModuleProgrammer.write(program.controllers),
+      },
+      ...program.controllers.map((c) => ({
+        location: c.location,
+        file: `${c.name}.ts`,
+        statements: NestControllerProgrammer.write(program.swagger.components)(
+          c,
+        ),
+      })),
+      ...[...DtoProgrammer.write(program.swagger.components).entries()].map(
+        ([key, value]) => ({
+          location: "src/api/structures",
+          file: `${key}.ts`,
+          statements: writeDtoFile(key, value),
+        }),
+      ),
+    ].map((o) => ({
+      location: o.location,
+      file: o.file,
+      content: FilePrinter.write({ statements: o.statements }),
+    }));
+
+  const writeDtoFile = (
+    key: string,
+    modulo: DtoProgrammer.IModule,
+  ): ts.Statement[] => {
+    const importer = new ImportProgrammer();
+    const statements: ts.Statement[] = iterate(importer)(modulo);
+    if (statements.length === 0) return [];
+
+    return [
+      ...importer.toStatements((name) => `./${name}`, key),
+      ...(importer.empty() ? [] : [FilePrinter.enter()]),
+      ...statements,
+    ];
+  };
+
+  const iterate =
+    (importer: ImportProgrammer) =>
+    (modulo: DtoProgrammer.IModule): ts.Statement[] => {
+      const output: ts.Statement[] = [];
+      if (modulo.programmer !== null) output.push(modulo.programmer(importer));
+      if (modulo.children.size) {
+        const internal: ts.Statement[] = [];
+        for (const child of modulo.children.values())
+          internal.push(...iterate(importer)(child));
+        output.push(
+          ts.factory.createModuleDeclaration(
+            [ts.factory.createModifier(ts.SyntaxKind.ExportKeyword)],
+            ts.factory.createIdentifier(modulo.name),
+            ts.factory.createModuleBlock(internal),
+            ts.NodeFlags.Namespace,
+          ),
+        );
+      }
+      return output;
+    };
+}