@nestia/migrate 12.0.0-rc.2 → 12.0.0-rc.3

package/src/programmers/NestiaMigrateApiStartProgrammer.ts

@@ -1,198 +1,198 @@
-import { NodeFlags, SyntaxKind, factory } from "@ttsc/factory";
-import { IHttpMigrateRoute } from "@typia/interface";
-
-import { IdentifierFactory } from "../factories/IdentifierFactory";
-import { StatementFactory } from "../factories/StatementFactory";
-import ts from "../internal/ts";
-import { INestiaMigrateContext } from "../structures/INestiaMigrateContext";
-import { FilePrinter } from "../utils/FilePrinter";
-import { NestiaMigrateE2eFunctionProgrammer } from "./NestiaMigrateE2eFileProgrammer";
-import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer";
-
-export namespace NestiaMigrateApiStartProgrammer {
-  export const write = (
-    context: INestiaMigrateContext,
-  ): Record<string, string> => {
-    const importer: NestiaMigrateImportProgrammer =
-      new NestiaMigrateImportProgrammer();
-    const main: ts.VariableStatement = writeMain(
-      context,
-      importer,
-      pick(context.application.routes),
-    );
-    const statements: ts.Statement[] = [
-      ...importer.toStatements(
-        (name) => `@ORGANIZATION/PROJECT-api/lib/structures/${name}`,
-      ),
-      FilePrinter.newLine(),
-      factory.createImportDeclaration(
-        undefined,
-        factory.createImportClause(
-          false,
-          undefined,
-          factory.createNamedImports([
-            factory.createImportSpecifier(
-              false,
-              undefined,
-              factory.createIdentifier("TestGlobal"),
-            ),
-          ]),
-        ),
-        factory.createStringLiteral("./TestGlobal"),
-      ),
-      FilePrinter.newLine(),
-      main,
-      factory.createExpressionStatement(writeStarter()),
-    ];
-    return {
-      "test/start.ts": FilePrinter.write({ statements }),
-    };
-  };
-
-  const writeMain = (
-    ctx: INestiaMigrateContext,
-    importer: NestiaMigrateImportProgrammer,
-    route: IHttpMigrateRoute,
-  ): ts.VariableStatement =>
-    StatementFactory.constant({
-      name: "main",
-      value: factory.createArrowFunction(
-        [factory.createToken(SyntaxKind.AsyncKeyword)],
-        undefined,
-        [],
-        undefined,
-        undefined,
-        factory.createBlock(
-          [
-            writeConnection(ctx, importer),
-            ...NestiaMigrateE2eFunctionProgrammer.writeBody({
-              config: ctx.config,
-              components: ctx.application.document().components,
-              importer,
-              route,
-            }),
-          ],
-          true,
-        ),
-      ),
-    });
-
-  const writeConnection = (
-    ctx: INestiaMigrateContext,
-    importer: NestiaMigrateImportProgrammer,
-  ): ts.VariableStatement =>
-    factory.createVariableStatement(
-      undefined,
-      factory.createVariableDeclarationList(
-        [
-          factory.createVariableDeclaration(
-            "connection",
-            undefined,
-            factory.createTypeReferenceNode(
-              factory.createQualifiedName(
-                factory.createIdentifier(
-                  importer.external({
-                    type: "default",
-                    library: "@ORGANIZATION/PROJECT-api",
-                    name: "api",
-                  }),
-                ),
-                factory.createIdentifier("IConnection"),
-              ),
-            ),
-            factory.createObjectLiteralExpression(
-              [
-                factory.createSpreadAssignment(
-                  factory.createCallExpression(
-                    factory.createPropertyAccessExpression(
-                      factory.createIdentifier("TestGlobal"),
-                      "connection",
-                    ),
-                    undefined,
-                    undefined,
-                  ),
-                ),
-                ...(ctx.application.document().servers?.[0]?.url?.length
-                  ? [
-                      factory.createPropertyAssignment(
-                        "host",
-                        factory.createStringLiteral(
-                          ctx.application.document().servers![0]!.url,
-                        ),
-                      ),
-                    ]
-                  : []),
-                ...(ctx.config.simulate === true
-                  ? [
-                      factory.createPropertyAssignment(
-                        "simulate",
-                        factory.createTrue(),
-                      ),
-                    ]
-                  : []),
-              ],
-              true,
-            ),
-          ),
-        ],
-        NodeFlags.Const,
-      ),
-    );
-
-  const writeStarter = (): ts.CallExpression =>
-    factory.createCallExpression(
-      factory.createPropertyAccessExpression(
-        factory.createCallExpression(
-          factory.createIdentifier("main"),
-          undefined,
-          undefined,
-        ),
-        "catch",
-      ),
-      undefined,
-      [
-        factory.createArrowFunction(
-          undefined,
-          undefined,
-          [IdentifierFactory.parameter("exp")],
-          undefined,
-          undefined,
-          factory.createBlock(
-            [
-              factory.createExpressionStatement(
-                factory.createCallExpression(
-                  factory.createPropertyAccessExpression(
-                    factory.createIdentifier("console"),
-                    "log",
-                  ),
-                  undefined,
-                  [factory.createIdentifier("exp")],
-                ),
-              ),
-              factory.createExpressionStatement(
-                factory.createCallExpression(
-                  factory.createPropertyAccessExpression(
-                    factory.createIdentifier("process"),
-                    "exit",
-                  ),
-                  undefined,
-                  [
-                    factory.createPrefixMinus(
-                      factory.createNumericLiteral("1"),
-                    ),
-                  ],
-                ),
-              ),
-            ],
-            true,
-          ),
-        ),
-      ],
-    );
-}
-
-const pick = <T>(array: T[]): T => {
-  const rand: number = Math.random() * array.length;
-  const index: number = Math.min(array.length - 1, Math.floor(rand));
-  return array[index]!;
-};
+import { NodeFlags, SyntaxKind, factory } from "@ttsc/factory";
+import { IHttpMigrateRoute } from "@typia/interface";
+
+import { IdentifierFactory } from "../factories/IdentifierFactory";
+import { StatementFactory } from "../factories/StatementFactory";
+import ts from "../internal/ts";
+import { INestiaMigrateContext } from "../structures/INestiaMigrateContext";
+import { FilePrinter } from "../utils/FilePrinter";
+import { NestiaMigrateE2eFunctionProgrammer } from "./NestiaMigrateE2eFileProgrammer";
+import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer";
+
+export namespace NestiaMigrateApiStartProgrammer {
+  export const write = (
+    context: INestiaMigrateContext,
+  ): Record<string, string> => {
+    const importer: NestiaMigrateImportProgrammer =
+      new NestiaMigrateImportProgrammer();
+    const main: ts.VariableStatement = writeMain(
+      context,
+      importer,
+      pick(context.application.routes),
+    );
+    const statements: ts.Statement[] = [
+      ...importer.toStatements(
+        (name) => `@ORGANIZATION/PROJECT-api/lib/structures/${name}`,
+      ),
+      FilePrinter.newLine(),
+      factory.createImportDeclaration(
+        undefined,
+        factory.createImportClause(
+          false,
+          undefined,
+          factory.createNamedImports([
+            factory.createImportSpecifier(
+              false,
+              undefined,
+              factory.createIdentifier("TestGlobal"),
+            ),
+          ]),
+        ),
+        factory.createStringLiteral("./TestGlobal"),
+      ),
+      FilePrinter.newLine(),
+      main,
+      factory.createExpressionStatement(writeStarter()),
+    ];
+    return {
+      "test/start.ts": FilePrinter.write({ statements }),
+    };
+  };
+
+  const writeMain = (
+    ctx: INestiaMigrateContext,
+    importer: NestiaMigrateImportProgrammer,
+    route: IHttpMigrateRoute,
+  ): ts.VariableStatement =>
+    StatementFactory.constant({
+      name: "main",
+      value: factory.createArrowFunction(
+        [factory.createToken(SyntaxKind.AsyncKeyword)],
+        undefined,
+        [],
+        undefined,
+        undefined,
+        factory.createBlock(
+          [
+            writeConnection(ctx, importer),
+            ...NestiaMigrateE2eFunctionProgrammer.writeBody({
+              config: ctx.config,
+              components: ctx.application.document().components,
+              importer,
+              route,
+            }),
+          ],
+          true,
+        ),
+      ),
+    });
+
+  const writeConnection = (
+    ctx: INestiaMigrateContext,
+    importer: NestiaMigrateImportProgrammer,
+  ): ts.VariableStatement =>
+    factory.createVariableStatement(
+      undefined,
+      factory.createVariableDeclarationList(
+        [
+          factory.createVariableDeclaration(
+            "connection",
+            undefined,
+            factory.createTypeReferenceNode(
+              factory.createQualifiedName(
+                factory.createIdentifier(
+                  importer.external({
+                    type: "default",
+                    library: "@ORGANIZATION/PROJECT-api",
+                    name: "api",
+                  }),
+                ),
+                factory.createIdentifier("IConnection"),
+              ),
+            ),
+            factory.createObjectLiteralExpression(
+              [
+                factory.createSpreadAssignment(
+                  factory.createCallExpression(
+                    factory.createPropertyAccessExpression(
+                      factory.createIdentifier("TestGlobal"),
+                      "connection",
+                    ),
+                    undefined,
+                    undefined,
+                  ),
+                ),
+                ...(ctx.application.document().servers?.[0]?.url?.length
+                  ? [
+                      factory.createPropertyAssignment(
+                        "host",
+                        factory.createStringLiteral(
+                          ctx.application.document().servers![0]!.url,
+                        ),
+                      ),
+                    ]
+                  : []),
+                ...(ctx.config.simulate === true
+                  ? [
+                      factory.createPropertyAssignment(
+                        "simulate",
+                        factory.createTrue(),
+                      ),
+                    ]
+                  : []),
+              ],
+              true,
+            ),
+          ),
+        ],
+        NodeFlags.Const,
+      ),
+    );
+
+  const writeStarter = (): ts.CallExpression =>
+    factory.createCallExpression(
+      factory.createPropertyAccessExpression(
+        factory.createCallExpression(
+          factory.createIdentifier("main"),
+          undefined,
+          undefined,
+        ),
+        "catch",
+      ),
+      undefined,
+      [
+        factory.createArrowFunction(
+          undefined,
+          undefined,
+          [IdentifierFactory.parameter("exp")],
+          undefined,
+          undefined,
+          factory.createBlock(
+            [
+              factory.createExpressionStatement(
+                factory.createCallExpression(
+                  factory.createPropertyAccessExpression(
+                    factory.createIdentifier("console"),
+                    "log",
+                  ),
+                  undefined,
+                  [factory.createIdentifier("exp")],
+                ),
+              ),
+              factory.createExpressionStatement(
+                factory.createCallExpression(
+                  factory.createPropertyAccessExpression(
+                    factory.createIdentifier("process"),
+                    "exit",
+                  ),
+                  undefined,
+                  [
+                    factory.createPrefixMinus(
+                      factory.createNumericLiteral("1"),
+                    ),
+                  ],
+                ),
+              ),
+            ],
+            true,
+          ),
+        ),
+      ],
+    );
+}
+
+const pick = <T>(array: T[]): T => {
+  const rand: number = Math.random() * array.length;
+  const index: number = Math.min(array.length - 1, Math.floor(rand));
+  return array[index]!;
+};

package/src/programmers/NestiaMigrateDtoProgrammer.ts

@@ -1,117 +1,117 @@
-import { SyntaxKind, factory } from "@ttsc/factory";
-import { OpenApi } from "@typia/interface";
-import { IPointer } from "tstl";
-
-import ts from "../internal/ts";
-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(
-        factory.createTypeAliasDeclaration(
-          [factory.createToken(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 => {
-    // PLUGIN PROPERTIES (x-) AS JSDOC TAGS
-    //
-    // Mirror NestiaMigrateSchemaProgrammer: emit every `x-` extension property
-    // whose value is a primitive as an `@x-key value` JSDoc tag, so the plugin
-    // metadata survives the swagger -> DTO round trip.
-    const plugins: string[] = [];
-    for (const [key, value] of Object.entries(schema))
-      if (key.startsWith("x-") && isExtensionValue(value))
-        plugins.push(`@${key} ${String(value)}`);
-    return [
-      ...(schema.description?.length ? [schema.description] : []),
-      ...(schema.description?.length &&
-      (schema.title !== undefined ||
-        schema.deprecated === true ||
-        plugins.length !== 0)
-        ? [""]
-        : []),
-      ...(schema.title !== undefined ? [`@title ${schema.title}`] : []),
-      ...(schema.deprecated === true ? [`@deprecated`] : []),
-      ...plugins,
-      ...(top
-        ? [
-            `@${config.author?.tag ?? "nestia"} ${config.author?.value ?? "Generated by Nestia - https://github.com/samchon/nestia"}`,
-          ]
-        : []),
-    ].join("\n");
-  };
-
-const isExtensionValue = (value: unknown): value is boolean | number | string =>
-  typeof value === "boolean" ||
-  typeof value === "number" ||
-  typeof value === "string";
+import { SyntaxKind, factory } from "@ttsc/factory";
+import { OpenApi } from "@typia/interface";
+import { IPointer } from "tstl";
+
+import ts from "../internal/ts";
+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(
+        factory.createTypeAliasDeclaration(
+          [factory.createToken(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 => {
+    // PLUGIN PROPERTIES (x-) AS JSDOC TAGS
+    //
+    // Mirror NestiaMigrateSchemaProgrammer: emit every `x-` extension property
+    // whose value is a primitive as an `@x-key value` JSDoc tag, so the plugin
+    // metadata survives the swagger -> DTO round trip.
+    const plugins: string[] = [];
+    for (const [key, value] of Object.entries(schema))
+      if (key.startsWith("x-") && isExtensionValue(value))
+        plugins.push(`@${key} ${String(value)}`);
+    return [
+      ...(schema.description?.length ? [schema.description] : []),
+      ...(schema.description?.length &&
+      (schema.title !== undefined ||
+        schema.deprecated === true ||
+        plugins.length !== 0)
+        ? [""]
+        : []),
+      ...(schema.title !== undefined ? [`@title ${schema.title}`] : []),
+      ...(schema.deprecated === true ? [`@deprecated`] : []),
+      ...plugins,
+      ...(top
+        ? [
+            `@${config.author?.tag ?? "nestia"} ${config.author?.value ?? "Generated by Nestia - https://github.com/samchon/nestia"}`,
+          ]
+        : []),
+    ].join("\n");
+  };
+
+const isExtensionValue = (value: unknown): value is boolean | number | string =>
+  typeof value === "boolean" ||
+  typeof value === "number" ||
+  typeof value === "string";