@nestia/migrate 6.0.6 → 7.0.0-dev.20250606

package/src/programmers/{MigrateDtoProgrammer.ts → NestiaMigrateDtoProgrammer.ts}

@@ -1,96 +1,101 @@
-import { OpenApi } from "@samchon/openapi";
-import { IPointer } from "tstl";
-import ts from "typescript";
-
-import { MigrateApplication } from "../MigrateApplication";
-import { FilePrinter } from "../utils/FilePrinter";
-import { MapUtil } from "../utils/MapUtil";
-import { StringUtil } from "../utils/StringUtil";
-import { MigrateImportProgrammer } from "./MigrateImportProgrammer";
-import { MigrateSchemaProgrammer } from "./MigrateSchemaProgrammer";
-
-export namespace MigrateDtoProgrammer {
-  export interface IModule {
-    name: string;
-    children: Map<string, IModule>;
-    programmer:
-      | null
-      | ((importer: MigrateImportProgrammer) => ts.TypeAliasDeclaration);
-  }
-
-  export const compose =
-    (config: MigrateApplication.IConfig) =>
-    (components: OpenApi.IComponents): Map<string, IModule> => {
-      const dict: Map<string, IModule> = new Map();
-      for (const [key, value] of Object.entries(components.schemas ?? {})) {
-        const emendedKey: string = key
-          .split("/")
-          .filter((str) => str.length !== 0)
-          .map(StringUtil.escapeNonVariable)
-          .join("");
-        prepare(dict)(emendedKey)((importer) =>
-          writeAlias(config)(components)(importer)(emendedKey, value),
-        );
-      }
-      return dict;
-    };
-
-  const prepare =
-    (dict: Map<string, IModule>) =>
-    (name: string) =>
-    (
-      programmer: (
-        importer: MigrateImportProgrammer,
-      ) => ts.TypeAliasDeclaration,
-    ) => {
-      const accessors: string[] = name.split(".");
-      const modulo: IPointer<IModule> = { value: null! };
-
-      accessors.forEach((acc, i) => {
-        modulo.value = MapUtil.take(dict)(acc)(() => ({
-          name: acc,
-          children: new Map(),
-          programmer: null,
-        }));
-        if (i === accessors.length - 1) modulo.value.programmer = programmer;
-        dict = modulo.value.children;
-      });
-      return modulo!;
-    };
-
-  const writeAlias =
-    (config: MigrateApplication.IConfig) =>
-    (components: OpenApi.IComponents) =>
-    (importer: MigrateImportProgrammer) =>
-    (key: string, value: OpenApi.IJsonSchema) =>
-      FilePrinter.description(
-        ts.factory.createTypeAliasDeclaration(
-          [ts.factory.createToken(ts.SyntaxKind.ExportKeyword)],
-          key.split(".").at(-1)!,
-          [],
-          MigrateSchemaProgrammer.write(components)(importer)(value),
-        ),
-        writeComment(config)(value, key.indexOf(".") === -1),
-      );
-}
-
-const writeComment =
-  (config: MigrateApplication.IConfig) =>
-  (schema: OpenApi.IJsonSchema, top: boolean): string =>
-    [
-      ...(schema.description?.length ? [schema.description] : []),
-      ...(schema.description?.length &&
-      (schema.title !== undefined || schema.deprecated === true)
-        ? [""]
-        : []),
-      ...(schema.title !== undefined ? [`@title ${schema.title}`] : []),
-      ...(schema.deprecated === true ? [`@deprecated`] : []),
-      ...(top
-        ? [
-            `@${config.author?.tag ?? "nestia"} ${config.author?.value ?? "Generated by Nestia - https://github.com/samchon/nestia"}`,
-          ]
-        : []),
-    ]
-      .join("\n")
-      .split("*/")
-      .join("*\\/");
+import { OpenApi } from "@samchon/openapi";
+import { IPointer } from "tstl";
+import ts from "typescript";
+
+import { INestiaMigrateConfig } from "../structures/INestiaMigrateConfig";
+import { FilePrinter } from "../utils/FilePrinter";
+import { MapUtil } from "../utils/MapUtil";
+import { StringUtil } from "../utils/StringUtil";
+import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer";
+import { NestiaMigrateSchemaProgrammer } from "./NestiaMigrateSchemaProgrammer";
+
+export namespace NestiaMigrateDtoProgrammer {
+  export interface IModule {
+    name: string;
+    children: Map<string, IModule>;
+    programmer:
+      | null
+      | ((importer: NestiaMigrateImportProgrammer) => ts.TypeAliasDeclaration);
+  }
+
+  export const compose = (props: {
+    config: INestiaMigrateConfig;
+    components: OpenApi.IComponents;
+  }): Map<string, IModule> => {
+    const dict: Map<string, IModule> = new Map();
+    for (const [key, value] of Object.entries(props.components.schemas ?? {})) {
+      const emendedKey: string = key
+        .split("/")
+        .filter((str) => str.length !== 0)
+        .map(StringUtil.escapeNonVariable)
+        .join("");
+      prepare(dict)(emendedKey)((importer) =>
+        writeAlias(props.config)(props.components)(importer)(emendedKey, value),
+      );
+    }
+    return dict;
+  };
+
+  const prepare =
+    (dict: Map<string, IModule>) =>
+    (name: string) =>
+    (
+      programmer: (
+        importer: NestiaMigrateImportProgrammer,
+      ) => ts.TypeAliasDeclaration,
+    ) => {
+      const accessors: string[] = name.split(".");
+      const modulo: IPointer<IModule> = { value: null! };
+
+      accessors.forEach((acc, i) => {
+        modulo.value = MapUtil.take(dict)(acc)(() => ({
+          name: acc,
+          children: new Map(),
+          programmer: null,
+        }));
+        if (i === accessors.length - 1) modulo.value.programmer = programmer;
+        dict = modulo.value.children;
+      });
+      return modulo!;
+    };
+
+  const writeAlias =
+    (config: INestiaMigrateConfig) =>
+    (components: OpenApi.IComponents) =>
+    (importer: NestiaMigrateImportProgrammer) =>
+    (key: string, value: OpenApi.IJsonSchema) =>
+      FilePrinter.description(
+        ts.factory.createTypeAliasDeclaration(
+          [ts.factory.createToken(ts.SyntaxKind.ExportKeyword)],
+          key.split(".").at(-1)!,
+          [],
+          NestiaMigrateSchemaProgrammer.write({
+            components,
+            importer,
+            schema: value,
+          }),
+        ),
+        writeComment(config)(value, key.indexOf(".") === -1),
+      );
+}
+
+const writeComment =
+  (config: INestiaMigrateConfig) =>
+  (schema: OpenApi.IJsonSchema, top: boolean): string =>
+    [
+      ...(schema.description?.length ? [schema.description] : []),
+      ...(schema.description?.length &&
+      (schema.title !== undefined || schema.deprecated === true)
+        ? [""]
+        : []),
+      ...(schema.title !== undefined ? [`@title ${schema.title}`] : []),
+      ...(schema.deprecated === true ? [`@deprecated`] : []),
+      ...(top
+        ? [
+            `@${config.author?.tag ?? "nestia"} ${config.author?.value ?? "Generated by Nestia - https://github.com/samchon/nestia"}`,
+          ]
+        : []),
+    ]
+      .join("\n")
+      .split("*/")
+      .join("*\\/");

package/src/programmers/NestiaMigrateE2eFileProgrammer.ts

@@ -0,0 +1,153 @@
+import { IHttpMigrateRoute, OpenApi } from "@samchon/openapi";
+import ts from "typescript";
+import { IdentifierFactory } from "typia/lib/factories/IdentifierFactory";
+import { LiteralFactory } from "typia/lib/factories/LiteralFactory";
+
+import { INestiaMigrateConfig } from "../structures/INestiaMigrateConfig";
+import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer";
+import { NestiaMigrateSchemaProgrammer } from "./NestiaMigrateSchemaProgrammer";
+
+export namespace NestiaMigrateE2eFunctionProgrammer {
+  export interface IContext {
+    config: INestiaMigrateConfig;
+    components: OpenApi.IComponents;
+    importer: NestiaMigrateImportProgrammer;
+    route: IHttpMigrateRoute;
+  }
+
+  export const write = (ctx: IContext): ts.FunctionDeclaration =>
+    ts.factory.createFunctionDeclaration(
+      [
+        ts.factory.createModifier(ts.SyntaxKind.ExportKeyword),
+        ts.factory.createModifier(ts.SyntaxKind.AsyncKeyword),
+      ],
+      undefined,
+      ["test", "api", ...ctx.route.accessor].join("_"),
+      undefined,
+      [
+        IdentifierFactory.parameter(
+          "connection",
+          ts.factory.createTypeReferenceNode(
+            ts.factory.createQualifiedName(
+              ts.factory.createIdentifier(
+                ctx.importer.external({
+                  type: "default",
+                  library: "@ORGANIZATION/PROJECT-api",
+                  name: "api",
+                }),
+              ),
+              ts.factory.createIdentifier("IConnection"),
+            ),
+          ),
+        ),
+      ],
+      undefined,
+      ts.factory.createBlock(writeBody(ctx), true),
+    );
+
+  export const writeBody = (ctx: IContext): ts.Statement[] => [
+    ts.factory.createVariableStatement(
+      [],
+      ts.factory.createVariableDeclarationList(
+        [
+          ts.factory.createVariableDeclaration(
+            "output",
+            undefined,
+            ctx.route.success
+              ? NestiaMigrateSchemaProgrammer.write({
+                  components: ctx.components,
+                  importer: ctx.importer,
+                  schema: ctx.route.success.schema,
+                })
+              : undefined,
+            ts.factory.createAwaitExpression(writeCallExpressionn(ctx)),
+          ),
+        ],
+        ts.NodeFlags.Const,
+      ),
+    ),
+    ts.factory.createExpressionStatement(
+      ts.factory.createCallExpression(
+        ts.factory.createPropertyAccessExpression(
+          ts.factory.createIdentifier(
+            ctx.importer.external({
+              type: "default",
+              library: "typia",
+              name: "typia",
+            }),
+          ),
+          "assert",
+        ),
+        undefined,
+        [ts.factory.createIdentifier("output")],
+      ),
+    ),
+  ];
+
+  const writeCallExpressionn = (ctx: IContext): ts.CallExpression => {
+    const fetch = ts.factory.createPropertyAccessExpression(
+      ts.factory.createIdentifier("api.functional"),
+      ts.factory.createIdentifier(ctx.route.accessor.join(".")),
+    );
+    const connection = ts.factory.createIdentifier("connection");
+    if (
+      ctx.route.parameters.length === 0 &&
+      ctx.route.query === null &&
+      ctx.route.body === null
+    )
+      return ts.factory.createCallExpression(fetch, undefined, [connection]);
+
+    const random = ts.factory.createPropertyAccessExpression(
+      ts.factory.createIdentifier(
+        ctx.importer.external({
+          type: "default",
+          library: "typia",
+          name: "typia",
+        }),
+      ),
+      "random",
+    );
+    if (ctx.config.keyword === true)
+      return ts.factory.createCallExpression(fetch, undefined, [
+        connection,
+        LiteralFactory.write(
+          Object.fromEntries(
+            [...ctx.route.parameters, ctx.route.query, ctx.route.body]
+              .filter((x) => x !== null)
+              .map(({ key, schema: value }) => [
+                key,
+                ts.factory.createCallExpression(
+                  random,
+                  [
+                    NestiaMigrateSchemaProgrammer.write({
+                      components: ctx.components,
+                      importer: ctx.importer,
+                      schema: value,
+                    }),
+                  ],
+                  undefined,
+                ),
+              ]),
+          ),
+        ),
+      ]);
+    return ts.factory.createCallExpression(fetch, undefined, [
+      connection,
+      ...[...ctx.route.parameters, ctx.route.query, ctx.route.body]
+        .filter((p) => !!p)
+        .map((p) =>
+          ts.factory.createCallExpression(
+            random,
+            [
+              NestiaMigrateSchemaProgrammer.write({
+                components: ctx.components,
+                importer: ctx.importer,
+                schema: p.schema,
+              }),
+            ],
+            undefined,
+          ),
+        ),
+    ]);
+  };
+}

package/src/programmers/NestiaMigrateE2eProgrammer.ts

@@ -0,0 +1,46 @@
+import { IHttpMigrateRoute, OpenApi } from "@samchon/openapi";
+import ts from "typescript";
+
+import { INestiaMigrateConfig } from "../structures/INestiaMigrateConfig";
+import { INestiaMigrateContext } from "../structures/INestiaMigrateContext";
+import { INestiaMigrateFile } from "../structures/INestiaMigrateFile";
+import { FilePrinter } from "../utils/FilePrinter";
+import { NestiaMigrateE2eFunctionProgrammer } from "./NestiaMigrateE2eFileProgrammer";
+import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer";
+
+export namespace NestiaMigrateE2eProgrammer {
+  export const write = (ctx: INestiaMigrateContext): Record<string, string> =>
+    Object.fromEntries(
+      ctx.routes
+        .map((r) => writeFile(ctx.config, ctx.document.components, r))
+        .map((r) => [`${r.location}/${r.file}`, r.content]),
+    );
+
+  const writeFile = (
+    config: INestiaMigrateConfig,
+    components: OpenApi.IComponents,
+    route: IHttpMigrateRoute,
+  ): INestiaMigrateFile => {
+    const importer: NestiaMigrateImportProgrammer =
+      new NestiaMigrateImportProgrammer();
+    const func: ts.FunctionDeclaration =
+      NestiaMigrateE2eFunctionProgrammer.write({
+        config,
+        components,
+        importer,
+        route,
+      });
+    const statements: ts.Statement[] = [
+      ...importer.toStatements(
+        (name) => `@ORGANIZATION/PROJECT-api/lib/structures/${name}`,
+      ),
+      FilePrinter.newLine(),
+      func,
+    ];
+    return {
+      location: `test/features/api`,
+      file: `${["test", "api", ...route.accessor].join("_")}.ts`,
+      content: FilePrinter.write({ statements }),
+    };
+  };
+}

package/src/programmers/{MigrateImportProgrammer.ts → NestiaMigrateImportProgrammer.ts}

@@ -1,118 +1,118 @@
-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}`,
-      arg === undefined ? [] : [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 NestiaMigrateImportProgrammer {
+  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}`,
+      arg === undefined ? [] : [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>;
+}