@nestia/migrate 0.7.4 → 0.7.6

package/package.json

@@ -1,68 +1,68 @@
-{
-  "name": "@nestia/migrate",
-  "version": "0.7.4",
-  "description": "Migration program from swagger to NestJS",
-  "main": "lib/index.js",
-  "typings": "lib/index.d.ts",
-  "bin": {
-    "@nestia/migrate": "lib/executable/migrate.js"
-  },
-  "scripts": {
-    "build": "rimraf lib && tsc",
-    "bundle": "ts-node src/executable/bundle.ts",
-    "dev": "npm run build -- --watch",
-    "prepare": "ts-patch install && typia patch && npm run bundle",
-    "test": "node lib/test"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/samchon/nestia"
-  },
-  "keywords": [
-    "migration",
-    "swagger",
-    "NestJS",
-    "nestia"
-  ],
-  "author": "Jeongho Nam",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/samchon/nestia/issues"
-  },
-  "homepage": "https://github.com/samchon/nestia#readme",
-  "devDependencies": {
-    "@nestia/core": "2.5.3",
-    "@nestia/fetcher": "2.5.3",
-    "@nestjs/common": "^10.3.1",
-    "@nestjs/core": "^10.3.1",
-    "@nestjs/platform-express": "^10.3.1",
-    "@nestjs/platform-fastify": "^10.3.1",
-    "@types/express": "^4.17.21",
-    "@types/inquirer": "^9.0.7",
-    "@types/node": "^20.3.3",
-    "dotenv": "^16.3.1",
-    "dotenv-expand": "^10.0.0",
-    "rimraf": "^5.0.1",
-    "serialize-error": "^4.1.0",
-    "source-map-support": "^0.5.21",
-    "ts-node": "^10.9.1",
-    "ts-patch": "^3.1.0",
-    "tstl": "^2.5.13",
-    "typescript-transform-paths": "^3.4.6"
-  },
-  "dependencies": {
-    "commander": "10.0.0",
-    "inquirer": "8.2.5",
-    "typescript": "^5.3.3",
-    "typia": "^5.4.4"
-  },
-  "files": [
-    "lib",
-    "src",
-    "!lib/test",
-    "!src/test",
-    "package.json",
-    "README.md",
-    "LICENSE"
-  ]
-}
+{
+  "name": "@nestia/migrate",
+  "version": "0.7.6",
+  "description": "Migration program from swagger to NestJS",
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "bin": {
+    "@nestia/migrate": "lib/executable/migrate.js"
+  },
+  "scripts": {
+    "build": "rimraf lib && tsc",
+    "bundle": "ts-node src/executable/bundle.ts",
+    "dev": "npm run build -- --watch",
+    "prepare": "ts-patch install && typia patch && npm run bundle",
+    "test": "node lib/test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/samchon/nestia"
+  },
+  "keywords": [
+    "migration",
+    "swagger",
+    "NestJS",
+    "nestia"
+  ],
+  "author": "Jeongho Nam",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/samchon/nestia/issues"
+  },
+  "homepage": "https://github.com/samchon/nestia#readme",
+  "devDependencies": {
+    "@nestia/core": "2.5.4",
+    "@nestia/fetcher": "2.5.4",
+    "@nestjs/common": "^10.3.1",
+    "@nestjs/core": "^10.3.1",
+    "@nestjs/platform-express": "^10.3.1",
+    "@nestjs/platform-fastify": "^10.3.1",
+    "@types/express": "^4.17.21",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.3.3",
+    "dotenv": "^16.3.1",
+    "dotenv-expand": "^10.0.0",
+    "rimraf": "^5.0.1",
+    "serialize-error": "^4.1.0",
+    "source-map-support": "^0.5.21",
+    "ts-node": "^10.9.1",
+    "ts-patch": "^3.1.0",
+    "tstl": "^2.5.13",
+    "typescript-transform-paths": "^3.4.6"
+  },
+  "dependencies": {
+    "commander": "10.0.0",
+    "inquirer": "8.2.5",
+    "typescript": "^5.3.3",
+    "typia": "^5.4.5"
+  },
+  "files": [
+    "lib",
+    "src",
+    "!lib/test",
+    "!src/test",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/src/IMigrateConfig.ts

@@ -1,4 +1,4 @@
-export interface IMigrateConfig {
-  mode: "nest" | "sdk";
-  simulate: boolean;
-}
+export interface IMigrateConfig {
+  mode: "nest" | "sdk";
+  simulate: boolean;
+}

package/src/MigrateApplication.ts

@@ -1,35 +1,48 @@
-import typia from "typia";
-
-import { MigrateAnalyzer } from "./analyzers/MigrateAnalyzer";
-import { NEST_TEMPLATE } from "./bundles/NEST_TEMPLATE";
-import { SDK_TEMPLATE } from "./bundles/SDK_TEMPLATE";
-import { ApiProgrammer } from "./programmers/ApiProgrammer";
-import { NestProgrammer } from "./programmers/NestProgrammer";
-import { IMigrateFile } from "./structures/IMigrateFile";
-import { ISwagger } from "./structures/ISwagger";
-
-export class MigrateApplication {
-  public constructor(public readonly swagger: ISwagger) {
-    typia.assert(swagger);
-  }
-
-  public nest(simulate: boolean): IMigrateFile[] {
-    const program = MigrateAnalyzer.analyze({
-      mode: "nest",
-      simulate,
-    })(this.swagger);
-    return [
-      ...NEST_TEMPLATE,
-      ...NestProgrammer.write(program),
-      ...ApiProgrammer.write(program),
-    ];
-  }
-
-  public sdk(simulate: boolean): IMigrateFile[] {
-    const program = MigrateAnalyzer.analyze({
-      mode: "sdk",
-      simulate,
-    })(this.swagger);
-    return [...SDK_TEMPLATE, ...ApiProgrammer.write(program)];
-  }
-}
+import typia from "typia";
+
+import { MigrateAnalyzer } from "./analyzers/MigrateAnalyzer";
+import { NEST_TEMPLATE } from "./bundles/NEST_TEMPLATE";
+import { SDK_TEMPLATE } from "./bundles/SDK_TEMPLATE";
+import { IMigrateProgram } from "./module";
+import { MigrateApiProgrammer } from "./programmers/MigrateApiProgrammer";
+import { MigrateNestProgrammer } from "./programmers/MigrateNestProgrammer";
+import { IMigrateFile } from "./structures/IMigrateFile";
+import { ISwagger } from "./structures/ISwagger";
+
+export class MigrateApplication {
+  public constructor(public readonly swagger: ISwagger) {
+    typia.assert(swagger);
+  }
+
+  public nest(simulate: boolean): MigrateApplication.IOutput {
+    const program: IMigrateProgram = MigrateAnalyzer.analyze({
+      mode: "nest",
+      simulate,
+    })(this.swagger);
+    return {
+      program,
+      files: [
+        ...NEST_TEMPLATE,
+        ...MigrateNestProgrammer.write(program),
+        ...MigrateApiProgrammer.write(program),
+      ],
+    };
+  }
+
+  public sdk(simulate: boolean): MigrateApplication.IOutput {
+    const program: IMigrateProgram = MigrateAnalyzer.analyze({
+      mode: "sdk",
+      simulate,
+    })(this.swagger);
+    return {
+      program,
+      files: [...SDK_TEMPLATE, ...MigrateApiProgrammer.write(program)],
+    };
+  }
+}
+export namespace MigrateApplication {
+  export interface IOutput {
+    program: IMigrateProgram;
+    files: IMigrateFile[];
+  }
+}

package/src/analyzers/MigrateAnalyzer.ts

@@ -1,13 +1,13 @@
-import { IMigrateConfig } from "../IMigrateConfig";
-import { IMigrateProgram, ISwagger } from "../module";
-import { ControllerAnalyzer } from "./ControllerAnalyzer";
-
-export namespace MigrateAnalyzer {
-  export const analyze =
-    (config: IMigrateConfig) =>
-    (swagger: ISwagger): IMigrateProgram => ({
-      config,
-      swagger,
-      controllers: ControllerAnalyzer.analyze(swagger),
-    });
-}
+import { IMigrateConfig } from "../IMigrateConfig";
+import { IMigrateProgram, ISwagger } from "../module";
+import { MigrateControllerAnalyzer } from "./MigrateControllerAnalyzer";
+
+export namespace MigrateAnalyzer {
+  export const analyze =
+    (config: IMigrateConfig) =>
+    (swagger: ISwagger): IMigrateProgram => ({
+      config,
+      swagger,
+      controllers: MigrateControllerAnalyzer.analyze(swagger),
+    });
+}

package/src/analyzers/{ControllerAnalyzer.ts → MigrateControllerAnalyzer.ts}

@@ -1,123 +1,122 @@
-import { Escaper } from "typia/lib/utils/Escaper";
-
-import { ISwagger } from "../module";
-import { IMigrateController } from "../structures/IMigrateController";
-import { IMigrateRoute } from "../structures/IMigrateRoute";
-import { MapUtil } from "../utils/MapUtil";
-import { StringUtil } from "../utils/StringUtil";
-import { MethodAnalzyer } from "./MethodAnalyzer";
-
-export namespace ControllerAnalyzer {
-  export const analyze = (swagger: ISwagger): IMigrateController[] => {
-    const dict: Map<string, IMigrateRoute[]> = new Map();
-
-    // GATHER ROUTES
-    for (const [path, collection] of Object.entries(swagger.paths)) {
-      // PREPARE DIRECTORIES
-      const location: string = StringUtil.splitWithNormalization(path)
-        .filter((str) => str[0] !== "{" && str[0] !== ":")
-        .join("/");
-      for (const s of sequence(location)) MapUtil.take(dict)(s)(() => []);
-
-      // INSERT ROUTES TO THE LAST DIRECTORY
-      const routes: IMigrateRoute[] = MapUtil.take(dict)(location)(() => []);
-      for (const [method, value] of Object.entries(collection)) {
-        const r: IMigrateRoute | null = MethodAnalzyer.analyze(swagger)({
-          path,
-          method,
-        })(value);
-        if (r !== null) routes.push(r);
-      }
-    }
-
-    // ABSORB STANDALONE ROUTES
-    const emended: Map<string, IMigrateRoute[]> = new Map(
-      [...dict.entries()].sort((a, b) => a[0].localeCompare(b[0])),
-    );
-    for (const [location, routes] of emended) {
-      if (routes.length !== 1) continue;
-      for (const s of sequence(location).slice(0, 1)) {
-        const parent = emended.get(s);
-        if (parent) {
-          parent.push(...routes);
-          emended.delete(location);
-          break;
-        }
-      }
-    }
-
-    // GENERATE CONTROLLERS
-    return [...emended.entries()]
-      .filter(([_l, routes]) => !!routes.length)
-      .map(([location, routes]) => {
-        const prefix: string = StringUtil.commonPrefix(
-          routes.map((r) => r.path),
-        );
-        for (const r of routes)
-          r.path = StringUtil.reJoinWithDecimalParameters(
-            r.path.replace(prefix, ""),
-          );
-        const controller: IMigrateController = {
-          name: StringUtil.pascal(location) + "Controller",
-          path: StringUtil.reJoinWithDecimalParameters(prefix),
-          location: "src/controllers/" + location,
-          routes,
-        };
-        if (controller.name === "Controller") controller.name = "__Controller";
-        emend(controller);
-        return controller;
-      });
-  };
-
-  const sequence = (location: string): string[] =>
-    StringUtil.splitWithNormalization(location)
-      .map((_str, i, entire) => entire.slice(0, i + 1).join("/"))
-      .slice(0, -1)
-      .reverse();
-
-  const emend = (controller: IMigrateController): void => {
-    interface IRouteCapsule {
-      variables: string[];
-      route: IMigrateRoute;
-    }
-    const dict: Map<string, IRouteCapsule[]> = new Map();
-    for (const route of controller.routes) {
-      const additional: string[] = StringUtil.splitWithNormalization(
-        route.path,
-      );
-      const statics: string[] = additional.filter((str) => str[0] !== ":");
-      if (statics.length) route.name = StringUtil.camel(statics.join("/"));
-      else
-        MapUtil.take(dict)(route.method)(() => []).push({
-          variables: additional
-            .filter((str) => str[0] === ":")
-            .map((str) => str.substring(1)),
-          route,
-        });
-    }
-    for (const [method, capsules] of dict) {
-      const emended: string = method === "delete" ? "erase" : method;
-      for (const c of capsules) {
-        const empty: boolean = c.variables.length === 0;
-        c.route.name = empty
-          ? emended
-          : StringUtil.camel(`${emended}By/${c.variables.join("/and/")}`);
-      }
-    }
-    for (const method of controller.routes) {
-      if (Escaper.variable(method.name) === false)
-        method.name = "_" + method.name;
-      for (const spec of [method.headers, method.query, method.body])
-        if (spec)
-          spec.key = StringUtil.escapeDuplicate(
-            method.parameters.map((p) => p.key),
-          )(spec.key);
-    }
-    controller.routes.forEach(
-      (r, i) =>
-        (r.name = StringUtil.escapeDuplicate(
-          controller.routes.filter((_r, j) => i !== j).map((x) => x.name),
-        )(r.name)),
-    );
-  };
-}
+import { Escaper } from "typia/lib/utils/Escaper";
+
+import { ISwagger } from "../module";
+import { IMigrateController } from "../structures/IMigrateController";
+import { IMigrateRoute } from "../structures/IMigrateRoute";
+import { MapUtil } from "../utils/MapUtil";
+import { StringUtil } from "../utils/StringUtil";
+import { MigrateMethodAnalzyer } from "./MigrateMethodAnalyzer";
+
+export namespace MigrateControllerAnalyzer {
+  export const analyze = (swagger: ISwagger): IMigrateController[] => {
+    const dict: Map<string, IMigrateRoute[]> = new Map();
+
+    // GATHER ROUTES
+    for (const [path, collection] of Object.entries(swagger.paths)) {
+      // PREPARE DIRECTORIES
+      const location: string = StringUtil.splitWithNormalization(path)
+        .filter((str) => str[0] !== "{" && str[0] !== ":")
+        .join("/");
+      for (const s of sequence(location)) MapUtil.take(dict)(s)(() => []);
+
+      // INSERT ROUTES TO THE LAST DIRECTORY
+      const routes: IMigrateRoute[] = MapUtil.take(dict)(location)(() => []);
+      for (const [method, value] of Object.entries(collection)) {
+        const r: IMigrateRoute | null = MigrateMethodAnalzyer.analyze(swagger)({
+          path,
+          method,
+        })(value);
+        if (r !== null) routes.push(r);
+      }
+    }
+
+    // ABSORB STANDALONE ROUTES
+    const emended: Map<string, IMigrateRoute[]> = new Map(
+      [...dict.entries()].sort((a, b) => a[0].localeCompare(b[0])),
+    );
+    for (const [location, routes] of emended) {
+      if (routes.length !== 1) continue;
+      for (const s of sequence(location).slice(0, 1)) {
+        const parent = emended.get(s);
+        if (parent) {
+          parent.push(...routes);
+          emended.delete(location);
+          break;
+        }
+      }
+    }
+
+    // GENERATE CONTROLLERS
+    return [...emended.entries()]
+      .filter(([_l, routes]) => !!routes.length)
+      .map(([location, routes]) => {
+        const prefix: string = StringUtil.commonPrefix(
+          routes.map((r) => r.path),
+        );
+        for (const r of routes)
+          r.path = StringUtil.reJoinWithDecimalParameters(
+            r.path.replace(prefix, ""),
+          );
+        const controller: IMigrateController = {
+          name: StringUtil.pascal(location) + "Controller",
+          path: StringUtil.reJoinWithDecimalParameters(prefix),
+          location: "src/controllers/" + location,
+          routes,
+        };
+        if (controller.name === "Controller") controller.name = "__Controller";
+        emend(controller);
+        return controller;
+      });
+  };
+
+  const sequence = (location: string): string[] =>
+    StringUtil.splitWithNormalization(location)
+      .map((_str, i, entire) => entire.slice(0, i + 1).join("/"))
+      .slice(0, -1)
+      .reverse();
+
+  const emend = (controller: IMigrateController): void => {
+    interface IRouteCapsule {
+      variables: string[];
+      route: IMigrateRoute;
+    }
+    const dict: Map<string, IRouteCapsule[]> = new Map();
+    for (const route of controller.routes) {
+      const additional: string[] = StringUtil.splitWithNormalization(
+        route.path,
+      );
+      const statics: string[] = additional.filter((str) => str[0] !== ":");
+      if (statics.length) route.name = StringUtil.camel(statics.join("/"));
+      else
+        MapUtil.take(dict)(route.method)(() => []).push({
+          variables: additional
+            .filter((str) => str[0] === ":")
+            .map((str) => str.substring(1)),
+          route,
+        });
+    }
+    for (const [method, capsules] of dict) {
+      const emended: string = method === "delete" ? "erase" : method;
+      for (const c of capsules) {
+        const empty: boolean = c.variables.length === 0;
+        c.route.name = empty
+          ? emended
+          : StringUtil.camel(`${emended}By/${c.variables.join("/and/")}`);
+      }
+    }
+    for (const method of controller.routes) {
+      if (Escaper.variable(method.name) === false)
+        method.name = "_" + method.name;
+      for (const spec of [method.headers, method.query, method.body])
+        if (spec)
+          spec.key = StringUtil.escapeDuplicate(
+            method.parameters.map((p) => p.key),
+          )(spec.key);
+    }
+    controller.routes.forEach((r, i) => {
+      r.name = StringUtil.escapeDuplicate(
+        controller.routes.filter((_r, j) => i !== j).map((x) => x.name),
+      )(r.name);
+    });
+  };
+}