@nestia/migrate 0.12.1 → 0.13.0-dev.20240411

package/src/programmers/MigrateApiSimulatationProgrammer.ts

@@ -1,3 +1,4 @@
+import { OpenApi } from "@samchon/openapi";
 import ts from "typescript";
 import { IdentifierFactory } from "typia/lib/factories/IdentifierFactory";
 import { StatementFactory } from "typia/lib/factories/StatementFactory";
@@ -5,7 +6,6 @@ import { TypeFactory } from "typia/lib/factories/TypeFactory";
 
 import { IMigrateController } from "../structures/IMigrateController";
 import { IMigrateRoute } from "../structures/IMigrateRoute";
-import { ISwaggerComponents } from "../structures/ISwaggerComponents";
 import { MigrateApiFunctionProgrammer } from "./MigrateApiFunctionProgrammer";
 import { MigrateApiNamespaceProgrammer } from "./MigrateApiNamespaceProgrammer";
 import { MigrateImportProgrammer } from "./MigrateImportProgrammer";
@@ -18,7 +18,7 @@ export namespace MigrateApiSimulatationProgrammer {
     alias: string;
   }
   export const random =
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
     (props: IProps) => {
       const output = props.route.success
@@ -70,7 +70,7 @@ export namespace MigrateApiSimulatationProgrammer {
     };
 
   export const simulate =
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
     (props: IProps): ts.VariableStatement => {
       const caller = () =>
@@ -121,7 +121,7 @@ export namespace MigrateApiSimulatationProgrammer {
     };
 
   const assert =
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
     (props: IProps): ts.Statement[] => {
       const parameters = [

package/src/programmers/MigrateApiStartProgrammer.ts

@@ -1,3 +1,4 @@
+import { OpenApi } from "@samchon/openapi";
 import ts from "typescript";
 import { IdentifierFactory } from "typia/lib/factories/IdentifierFactory";
 import { StatementFactory } from "typia/lib/factories/StatementFactory";
@@ -5,7 +6,6 @@ import { StatementFactory } from "typia/lib/factories/StatementFactory";
 import { IMigrateFile } from "../structures/IMigrateFile";
 import { IMigrateProgram } from "../structures/IMigrateProgram";
 import { IMigrateRoute } from "../structures/IMigrateRoute";
-import { ISwagger } from "../structures/ISwagger";
 import { FilePrinter } from "../utils/FilePrinter";
 import { MigrateE2eFunctionProgrammer } from "./MigrateE2eFileProgrammer";
 import { MigrateImportProgrammer } from "./MigrateImportProgrammer";
@@ -13,7 +13,7 @@ import { MigrateImportProgrammer } from "./MigrateImportProgrammer";
 export namespace MigrateApiStartProgrammer {
   export const write = (program: IMigrateProgram): IMigrateFile => {
     const importer: MigrateImportProgrammer = new MigrateImportProgrammer();
-    const main: ts.VariableStatement = writeMain(program)(program.swagger)(
+    const main: ts.VariableStatement = writeMain(program)(program.document)(
       importer,
     )(pick(program.controllers.map((c) => c.routes).flat()));
     const statements: ts.Statement[] = [
@@ -50,7 +50,7 @@ export namespace MigrateApiStartProgrammer {
 
   const writeMain =
     (config: IMigrateProgram.IConfig) =>
-    (swagger: ISwagger) =>
+    (document: OpenApi.IDocument) =>
     (importer: MigrateImportProgrammer) =>
     (route: IMigrateRoute): ts.VariableStatement =>
       StatementFactory.constant(
@@ -63,8 +63,8 @@ export namespace MigrateApiStartProgrammer {
           undefined,
           ts.factory.createBlock(
             [
-              writeConnection(config)(swagger)(importer),
-              ...MigrateE2eFunctionProgrammer.writeBody(swagger.components)(
+              writeConnection(config)(document)(importer),
+              ...MigrateE2eFunctionProgrammer.writeBody(document.components)(
                 importer,
               )(route),
             ],
@@ -75,7 +75,7 @@ export namespace MigrateApiStartProgrammer {
 
   const writeConnection =
     (config: IMigrateProgram.IConfig) =>
-    (swagger: ISwagger) =>
+    (document: OpenApi.IDocument) =>
     (importer: MigrateImportProgrammer): ts.VariableStatement =>
       ts.factory.createVariableStatement(
         undefined,
@@ -108,12 +108,12 @@ export namespace MigrateApiStartProgrammer {
                       undefined,
                     ),
                   ),
-                  ...(swagger.servers[0]?.url?.length
+                  ...(document.servers?.[0]?.url?.length
                     ? [
                         ts.factory.createPropertyAssignment(
                           "host",
                           ts.factory.createStringLiteral(
-                            swagger.servers[0].url,
+                            document.servers[0].url,
                           ),
                         ),
                       ]

package/src/programmers/MigrateDtoProgrammer.ts

@@ -1,8 +1,7 @@
+import { OpenApi } from "@samchon/openapi";
 import { IPointer } from "tstl";
 import ts from "typescript";
 
-import { ISwaggerComponents } from "../structures/ISwaggerComponents";
-import { ISwaggerSchema } from "../structures/ISwaggerSchema";
 import { FilePrinter } from "../utils/FilePrinter";
 import { MapUtil } from "../utils/MapUtil";
 import { MigrateImportProgrammer } from "./MigrateImportProgrammer";
@@ -18,7 +17,7 @@ export namespace MigrateDtoProgrammer {
   }
 
   export const compose = (
-    components: ISwaggerComponents,
+    components: OpenApi.IComponents,
   ): Map<string, IModule> => {
     const dict: Map<string, IModule> = new Map();
     for (const [key, value] of Object.entries(components.schemas ?? {}))
@@ -52,9 +51,9 @@ export namespace MigrateDtoProgrammer {
     };
 
   const writeAlias =
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
-    (key: string, value: ISwaggerSchema) =>
+    (key: string, value: OpenApi.IJsonSchema) =>
       FilePrinter.description(
         ts.factory.createTypeAliasDeclaration(
           [ts.factory.createToken(ts.SyntaxKind.ExportKeyword)],
@@ -66,7 +65,7 @@ export namespace MigrateDtoProgrammer {
       );
 }
 
-const writeComment = (schema: ISwaggerSchema): string =>
+const writeComment = (schema: OpenApi.IJsonSchema): string =>
   [
     ...(schema.description?.length ? [schema.description] : []),
     ...(schema.description?.length &&

package/src/programmers/MigrateE2eFileProgrammer.ts

@@ -1,14 +1,14 @@
+import { OpenApi } from "@samchon/openapi";
 import ts from "typescript";
 import { IdentifierFactory } from "typia/lib/factories/IdentifierFactory";
 
 import { IMigrateRoute } from "../structures/IMigrateRoute";
-import { ISwaggerComponents } from "../structures/ISwaggerComponents";
 import { MigrateImportProgrammer } from "./MigrateImportProgrammer";
 import { MigrateSchemaProgrammer } from "./MigrateSchemaProgrammer";
 
 export namespace MigrateE2eFunctionProgrammer {
   export const write =
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
     (route: IMigrateRoute): ts.FunctionDeclaration =>
       ts.factory.createFunctionDeclaration(
@@ -41,7 +41,7 @@ export namespace MigrateE2eFunctionProgrammer {
       );
 
   export const writeBody =
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
     (route: IMigrateRoute): ts.Statement[] => [
       ts.factory.createVariableStatement(
@@ -83,7 +83,7 @@ export namespace MigrateE2eFunctionProgrammer {
     ];
 
   const writeCallExpressionn =
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
     (route: IMigrateRoute): ts.CallExpression =>
       ts.factory.createCallExpression(

package/src/programmers/MigrateE2eProgrammer.ts

@@ -1,9 +1,9 @@
+import { OpenApi } from "@samchon/openapi";
 import ts from "typescript";
 
 import { IMigrateFile } from "../structures/IMigrateFile";
 import { IMigrateProgram } from "../structures/IMigrateProgram";
 import { IMigrateRoute } from "../structures/IMigrateRoute";
-import { ISwaggerComponents } from "../structures/ISwaggerComponents";
 import { FilePrinter } from "../utils/FilePrinter";
 import { MigrateE2eFunctionProgrammer } from "./MigrateE2eFileProgrammer";
 import { MigrateImportProgrammer } from "./MigrateImportProgrammer";
@@ -11,11 +11,11 @@ import { MigrateImportProgrammer } from "./MigrateImportProgrammer";
 export namespace MigrateE2eProgrammer {
   export const write = (program: IMigrateProgram): IMigrateFile[] =>
     program.controllers
-      .map((c) => c.routes.map(writeFile(program.swagger.components)))
+      .map((c) => c.routes.map(writeFile(program.document.components)))
       .flat();
 
   const writeFile =
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (route: IMigrateRoute): IMigrateFile => {
       const importer: MigrateImportProgrammer = new MigrateImportProgrammer();
       const func: ts.FunctionDeclaration =

package/src/programmers/MigrateImportProgrammer.ts

@@ -1,117 +1,117 @@
-import ts from "typescript";
-
-import { TypeLiteralFactory } from "../factories/TypeLiteralFactory";
-import { FilePrinter } from "../utils/FilePrinter";
-import { MapUtil } from "../utils/MapUtil";
-
-export class MigrateImportProgrammer {
-  private external_: Map<string, IClause> = new Map();
-  private dtos_: Set<string> = new Set();
-
-  public constructor() {}
-
-  public empty(): boolean {
-    return this.external_.size === 0 && this.dtos_.size === 0;
-  }
-
-  public external(props: MigrateImportProgrammer.IProps): string {
-    const clause: IClause = MapUtil.take(this.external_)(props.library)(() => ({
-      default: null,
-      instances: new Set(),
-    }));
-    const name: string = props.name.split(".")[0];
-    if (props.type === "default") clause.default = props.name;
-    else clause.instances.add(name);
-    return name;
-  }
-
-  public dto(name: string, namespace?: string): ts.TypeReferenceNode {
-    const file: string = name.split(".")[0];
-    this.dtos_.add(file);
-    return ts.factory.createTypeReferenceNode(
-      namespace?.length
-        ? ts.factory.createQualifiedName(
-            ts.factory.createIdentifier(namespace),
-            ts.factory.createIdentifier(file),
-          )
-        : name,
-    );
-  }
-
-  public tag(type: string, arg: any): ts.TypeReferenceNode {
-    const instance: string = this.external({
-      type: "instance",
-      library: "typia",
-      name: "tags",
-    });
-    return ts.factory.createTypeReferenceNode(`${instance}.${type}`, [
-      TypeLiteralFactory.generate(arg),
-    ]);
-  }
-
-  public toStatements(
-    dtoPath: (name: string) => string,
-    current?: string,
-  ): ts.Statement[] {
-    return [
-      ...[...this.external_.entries()].map(([library, props]) =>
-        ts.factory.createImportDeclaration(
-          undefined,
-          ts.factory.createImportClause(
-            false,
-            props.default !== null
-              ? ts.factory.createIdentifier(props.default)
-              : undefined,
-            props.instances.size
-              ? ts.factory.createNamedImports(
-                  [...props.instances].map((i) =>
-                    ts.factory.createImportSpecifier(
-                      false,
-                      undefined,
-                      ts.factory.createIdentifier(i),
-                    ),
-                  ),
-                )
-              : undefined,
-          ),
-          ts.factory.createStringLiteral(library),
-        ),
-      ),
-      ...(this.external_.size && this.dtos_.size
-        ? [FilePrinter.newLine()]
-        : []),
-      ...[...this.dtos_]
-        .filter(
-          current ? (name) => name !== current!.split(".")[0] : () => true,
-        )
-        .map((i) =>
-          ts.factory.createImportDeclaration(
-            undefined,
-            ts.factory.createImportClause(
-              false,
-              undefined,
-              ts.factory.createNamedImports([
-                ts.factory.createImportSpecifier(
-                  false,
-                  undefined,
-                  ts.factory.createIdentifier(i),
-                ),
-              ]),
-            ),
-            ts.factory.createStringLiteral(dtoPath(i)),
-          ),
-        ),
-    ];
-  }
-}
-export namespace MigrateImportProgrammer {
-  export interface IProps {
-    type: "default" | "instance";
-    library: string;
-    name: string;
-  }
-}
-interface IClause {
-  default: string | null;
-  instances: Set<string>;
-}
+import ts from "typescript";
+
+import { TypeLiteralFactory } from "../factories/TypeLiteralFactory";
+import { FilePrinter } from "../utils/FilePrinter";
+import { MapUtil } from "../utils/MapUtil";
+
+export class MigrateImportProgrammer {
+  private external_: Map<string, IClause> = new Map();
+  private dtos_: Set<string> = new Set();
+
+  public constructor() {}
+
+  public empty(): boolean {
+    return this.external_.size === 0 && this.dtos_.size === 0;
+  }
+
+  public external(props: MigrateImportProgrammer.IProps): string {
+    const clause: IClause = MapUtil.take(this.external_)(props.library)(() => ({
+      default: null,
+      instances: new Set(),
+    }));
+    const name: string = props.name.split(".")[0];
+    if (props.type === "default") clause.default = props.name;
+    else clause.instances.add(name);
+    return name;
+  }
+
+  public dto(name: string, namespace?: string): ts.TypeReferenceNode {
+    const file: string = name.split(".")[0];
+    this.dtos_.add(file);
+    return ts.factory.createTypeReferenceNode(
+      namespace?.length
+        ? ts.factory.createQualifiedName(
+            ts.factory.createIdentifier(namespace),
+            ts.factory.createIdentifier(file),
+          )
+        : name,
+    );
+  }
+
+  public tag(type: string, arg: any): ts.TypeReferenceNode {
+    const instance: string = this.external({
+      type: "instance",
+      library: "typia",
+      name: "tags",
+    });
+    return ts.factory.createTypeReferenceNode(`${instance}.${type}`, [
+      TypeLiteralFactory.generate(arg),
+    ]);
+  }
+
+  public toStatements(
+    dtoPath: (name: string) => string,
+    current?: string,
+  ): ts.Statement[] {
+    return [
+      ...[...this.external_.entries()].map(([library, props]) =>
+        ts.factory.createImportDeclaration(
+          undefined,
+          ts.factory.createImportClause(
+            false,
+            props.default !== null
+              ? ts.factory.createIdentifier(props.default)
+              : undefined,
+            props.instances.size
+              ? ts.factory.createNamedImports(
+                  [...props.instances].map((i) =>
+                    ts.factory.createImportSpecifier(
+                      false,
+                      undefined,
+                      ts.factory.createIdentifier(i),
+                    ),
+                  ),
+                )
+              : undefined,
+          ),
+          ts.factory.createStringLiteral(library),
+        ),
+      ),
+      ...(this.external_.size && this.dtos_.size
+        ? [FilePrinter.newLine()]
+        : []),
+      ...[...this.dtos_]
+        .filter(
+          current ? (name) => name !== current!.split(".")[0] : () => true,
+        )
+        .map((i) =>
+          ts.factory.createImportDeclaration(
+            undefined,
+            ts.factory.createImportClause(
+              false,
+              undefined,
+              ts.factory.createNamedImports([
+                ts.factory.createImportSpecifier(
+                  false,
+                  undefined,
+                  ts.factory.createIdentifier(i),
+                ),
+              ]),
+            ),
+            ts.factory.createStringLiteral(dtoPath(i)),
+          ),
+        ),
+    ];
+  }
+}
+export namespace MigrateImportProgrammer {
+  export interface IProps {
+    type: "default" | "instance";
+    library: string;
+    name: string;
+  }
+}
+interface IClause {
+  default: string | null;
+  instances: Set<string>;
+}

package/src/programmers/MigrateNestControllerProgrammer.ts

@@ -1,7 +1,7 @@
+import { OpenApi } from "@samchon/openapi";
 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 { MigrateImportProgrammer } from "./MigrateImportProgrammer";
@@ -9,7 +9,7 @@ import { MigrateNestMethodProgrammer } from "./MigrateNestMethodProgrammer";
 
 export namespace MigrateNestControllerProgrammer {
   export const write =
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (controller: IMigrateController): ts.Statement[] => {
       const importer: MigrateImportProgrammer = new MigrateImportProgrammer();
       const $class = ts.factory.createClassDeclaration(

package/src/programmers/MigrateNestMethodProgrammer.ts

@@ -1,11 +1,10 @@
+import { OpenApi } from "@samchon/openapi";
 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 { ISwaggerComponents } from "../structures/ISwaggerComponents";
-import { ISwaggerSchema } from "../structures/ISwaggerSchema";
 import { FilePrinter } from "../utils/FilePrinter";
 import { StringUtil } from "../utils/StringUtil";
 import { MigrateImportProgrammer } from "./MigrateImportProgrammer";
@@ -13,7 +12,7 @@ import { MigrateSchemaProgrammer } from "./MigrateSchemaProgrammer";
 
 export namespace MigrateNestMethodProgrammer {
   export const write =
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
     (route: IMigrateRoute): ts.MethodDeclaration => {
       const output: ts.TypeNode = route.success
@@ -75,7 +74,7 @@ export namespace MigrateNestMethodProgrammer {
     ].join("\n");
 
   const writeMethodDecorators =
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
     (route: IMigrateRoute): ts.Decorator[] => {
       const external =
@@ -154,7 +153,7 @@ export namespace MigrateNestMethodProgrammer {
     };
 
   const writeParameters =
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
     (route: IMigrateRoute): ts.ParameterDeclaration[] => [
       ...route.parameters.map(({ key, schema: value }) =>
@@ -216,9 +215,9 @@ export namespace MigrateNestMethodProgrammer {
 
   const writeDtoParameter =
     (accessor: { method: string | [string, string]; variable: string }) =>
-    (components: ISwaggerComponents) =>
+    (components: OpenApi.IComponents) =>
     (importer: MigrateImportProgrammer) =>
-    (schema: ISwaggerSchema): ts.ParameterDeclaration => {
+    (schema: OpenApi.IJsonSchema): ts.ParameterDeclaration => {
       const instance = ts.factory.createIdentifier(
         importer.external({
           type: "instance",

package/src/programmers/MigrateNestProgrammer.ts

@@ -20,11 +20,11 @@ export namespace MigrateNestProgrammer {
         location: c.location,
         file: `${c.name}.ts`,
         statements: MigrateNestControllerProgrammer.write(
-          program.swagger.components,
+          program.document.components,
         )(c),
       })),
       ...[
-        ...MigrateDtoProgrammer.compose(program.swagger.components).entries(),
+        ...MigrateDtoProgrammer.compose(program.document.components).entries(),
       ].map(([key, value]) => ({
         location: "src/api/structures",
         file: `${key}.ts`,