@nestia/migrate 12.0.0-dev.20260601.1 → 12.0.0-dev.20260612.2

package/src/NestiaMigrateApplication.ts

@@ -1,167 +1,196 @@
-import {
-  IHttpMigrateApplication,
-  OpenApi,
-  OpenApiV3,
-  OpenApiV3_1,
-  OpenApiV3_2,
-  SwaggerV2,
-} from "@typia/interface";
-import type { IValidation } from "@typia/interface";
-import * as typiaUtils from "@typia/utils";
-
-import { NEST_TEMPLATE } from "./bundles/NEST_TEMPLATE";
-import { SDK_TEMPLATE } from "./bundles/SDK_TEMPLATE";
-import { NestiaMigrateApiProgrammer } from "./programmers/NestiaMigrateApiProgrammer";
-import { NestiaMigrateApiStartProgrammer } from "./programmers/NestiaMigrateApiStartProgrammer";
-import { NestiaMigrateE2eProgrammer } from "./programmers/NestiaMigrateE2eProgrammer";
-import { NestiaMigrateNestProgrammer } from "./programmers/NestiaMigrateNestProgrammer";
-import { INestiaMigrateConfig } from "./structures/INestiaMigrateConfig";
-import { INestiaMigrateContext } from "./structures/INestiaMigrateContext";
-
-const { HttpMigration, OpenApiConverter } =
-  (typiaUtils as { default?: typeof typiaUtils }).default ?? typiaUtils;
-
-export class NestiaMigrateApplication {
-  private readonly data_: IHttpMigrateApplication;
-
-  /* -----------------------------------------------------------
-    CONSTRUCTORS
-  ----------------------------------------------------------- */
-  public constructor(public readonly document: OpenApi.IDocument) {
-    this.data_ = HttpMigration.application(document);
-  }
-
-  public static assert(
-    document:
-      | SwaggerV2.IDocument
-      | OpenApiV3.IDocument
-      | OpenApiV3_1.IDocument
-      | OpenApiV3_2.IDocument
-      | OpenApi.IDocument,
-  ): NestiaMigrateApplication {
-    return new NestiaMigrateApplication(
-      OpenApiConverter.upgradeDocument(document),
-    );
-  }
-
-  public static validate(
-    document:
-      | SwaggerV2.IDocument
-      | OpenApiV3.IDocument
-      | OpenApiV3_1.IDocument
-      | OpenApiV3_2.IDocument
-      | OpenApi.IDocument,
-  ): IValidation<NestiaMigrateApplication> {
-    try {
-      return {
-        success: true,
-        data: new NestiaMigrateApplication(
-          OpenApiConverter.upgradeDocument(document),
-        ),
-      };
-    } catch (exp) {
-      const message: string =
-        exp instanceof Error ? exp.message : String(exp);
-      return {
-        success: false,
-        data: document,
-        errors: [
-          {
-            path: "$input",
-            expected:
-              "SwaggerV2.IDocument | OpenApiV3.IDocument | OpenApiV3_1.IDocument | OpenApiV3_2.IDocument | OpenApi.IDocument",
-            value: message,
-          },
-        ],
-      };
-    }
-  }
-
-  /* -----------------------------------------------------------
-    ACCESSORS
-  ----------------------------------------------------------- */
-  public getData(): IHttpMigrateApplication {
-    return this.data_;
-  }
-
-  public nest(config: INestiaMigrateConfig): Record<string, string> {
-    const context: INestiaMigrateContext = createContext(
-      "nest",
-      this.data_,
-      config,
-    );
-    const files: Record<string, string> = {
-      ...Object.fromEntries(
-        Object.entries(NEST_TEMPLATE).filter(
-          ([key]) =>
-            key.startsWith("src/api/structures") === false &&
-            key.startsWith("src/api/functional") === false &&
-            key.startsWith("src/api/controllers") === false &&
-            key.startsWith("test/features") === false,
-        ),
-      ),
-      ...NestiaMigrateNestProgrammer.write(context),
-      ...NestiaMigrateApiProgrammer.write(context),
-      ...(config.e2e ? NestiaMigrateE2eProgrammer.write(context) : {}),
-      ...(config.keyword === false
-        ? {
-            "nestia.config.ts": NEST_TEMPLATE["nestia.config.ts"]!.replace(
-              "keyword: true",
-              "keyword: false",
-            ),
-          }
-        : {}),
-    };
-    return config.package ? renameSlug(config.package, files) : files;
-  }
-
-  public sdk(config: INestiaMigrateConfig): Record<string, string> {
-    const context: INestiaMigrateContext = createContext(
-      "sdk",
-      this.data_,
-      config,
-    );
-    const files: Record<string, string> = {
-      ...Object.fromEntries(
-        Object.entries(SDK_TEMPLATE).filter(
-          ([key]) =>
-            key.startsWith("src/structures") === false &&
-            key.startsWith("src/functional") === false &&
-            key.startsWith("test/features") === false,
-        ),
-      ),
-      ...NestiaMigrateApiProgrammer.write(context),
-      ...NestiaMigrateApiStartProgrammer.write(context),
-      ...(config.e2e ? NestiaMigrateE2eProgrammer.write(context) : {}),
-      "swagger.json": JSON.stringify(this.document, null, 2),
-    };
-    return config.package ? renameSlug(config.package, files) : files;
-  }
-}
-
-const createContext = (
-  mode: "nest" | "sdk",
-  application: IHttpMigrateApplication,
-  config: INestiaMigrateConfig,
-): INestiaMigrateContext => {
-  return {
-    mode,
-    application: {
-      ...application,
-      routes: application.routes.filter((r) => r.method !== "query"),
-    },
-    config,
-  };
-};
-
-const renameSlug = (
-  slug: string,
-  files: Record<string, string>,
-): Record<string, string> => {
-  return Object.fromEntries(
-    Object.entries(files).map(([key, value]) => [
-      key,
-      value.split(`@ORGANIZATION/PROJECT`).join(slug),
-    ]),
-  );
-};
+import {
+  IHttpMigrateApplication,
+  IHttpMigrateRoute,
+  OpenApi,
+  OpenApiV3,
+  OpenApiV3_1,
+  OpenApiV3_2,
+  SwaggerV2,
+} from "@typia/interface";
+import type { IValidation } from "@typia/interface";
+import * as typiaUtils from "@typia/utils";
+
+import { NEST_TEMPLATE } from "./bundles/NEST_TEMPLATE";
+import { SDK_TEMPLATE } from "./bundles/SDK_TEMPLATE";
+import { NestiaMigrateApiProgrammer } from "./programmers/NestiaMigrateApiProgrammer";
+import { NestiaMigrateApiStartProgrammer } from "./programmers/NestiaMigrateApiStartProgrammer";
+import { NestiaMigrateE2eProgrammer } from "./programmers/NestiaMigrateE2eProgrammer";
+import { NestiaMigrateNestProgrammer } from "./programmers/NestiaMigrateNestProgrammer";
+import { INestiaMigrateConfig } from "./structures/INestiaMigrateConfig";
+import { INestiaMigrateContext } from "./structures/INestiaMigrateContext";
+
+const { HttpMigration, OpenApiConverter } =
+  (typiaUtils as { default?: typeof typiaUtils }).default ?? typiaUtils;
+
+export class NestiaMigrateApplication {
+  private readonly data_: IHttpMigrateApplication;
+
+  /* -----------------------------------------------------------
+    CONSTRUCTORS
+  ----------------------------------------------------------- */
+  public constructor(public readonly document: OpenApi.IDocument) {
+    this.data_ = HttpMigration.application(document);
+  }
+
+  public static assert(
+    document:
+      | SwaggerV2.IDocument
+      | OpenApiV3.IDocument
+      | OpenApiV3_1.IDocument
+      | OpenApiV3_2.IDocument
+      | OpenApi.IDocument,
+  ): NestiaMigrateApplication {
+    return new NestiaMigrateApplication(
+      OpenApiConverter.upgradeDocument(document),
+    );
+  }
+
+  public static validate(
+    document:
+      | SwaggerV2.IDocument
+      | OpenApiV3.IDocument
+      | OpenApiV3_1.IDocument
+      | OpenApiV3_2.IDocument
+      | OpenApi.IDocument,
+  ): IValidation<NestiaMigrateApplication> {
+    try {
+      return {
+        success: true,
+        data: new NestiaMigrateApplication(
+          OpenApiConverter.upgradeDocument(document),
+        ),
+      };
+    } catch (exp) {
+      const message: string = exp instanceof Error ? exp.message : String(exp);
+      return {
+        success: false,
+        data: document,
+        errors: [
+          {
+            path: "$input",
+            expected:
+              "SwaggerV2.IDocument | OpenApiV3.IDocument | OpenApiV3_1.IDocument | OpenApiV3_2.IDocument | OpenApi.IDocument",
+            value: message,
+          },
+        ],
+      };
+    }
+  }
+
+  /* -----------------------------------------------------------
+    ACCESSORS
+  ----------------------------------------------------------- */
+  public getData(): IHttpMigrateApplication {
+    return this.data_;
+  }
+
+  public nest(config: INestiaMigrateConfig): Record<string, string> {
+    const context: INestiaMigrateContext = createContext(
+      "nest",
+      this.data_,
+      config,
+    );
+    const files: Record<string, string> = {
+      ...Object.fromEntries(
+        Object.entries(NEST_TEMPLATE).filter(
+          ([key]) =>
+            key.startsWith("src/api/structures") === false &&
+            key.startsWith("src/api/functional") === false &&
+            key.startsWith("src/api/controllers") === false &&
+            key.startsWith("test/features") === false,
+        ),
+      ),
+      ...NestiaMigrateNestProgrammer.write(context),
+      ...NestiaMigrateApiProgrammer.write(context),
+      ...(config.e2e ? NestiaMigrateE2eProgrammer.write(context) : {}),
+      ...(config.keyword === false
+        ? {
+            "nestia.config.ts": NEST_TEMPLATE["nestia.config.ts"]!.replace(
+              "keyword: true",
+              "keyword: false",
+            ),
+          }
+        : {}),
+    };
+    return config.package ? renameSlug(config.package, files) : files;
+  }
+
+  public sdk(config: INestiaMigrateConfig): Record<string, string> {
+    const context: INestiaMigrateContext = createContext(
+      "sdk",
+      this.data_,
+      config,
+    );
+    const files: Record<string, string> = {
+      ...Object.fromEntries(
+        Object.entries(SDK_TEMPLATE).filter(
+          ([key]) =>
+            key.startsWith("src/structures") === false &&
+            key.startsWith("src/functional") === false &&
+            key.startsWith("test/features") === false,
+        ),
+      ),
+      ...NestiaMigrateApiProgrammer.write(context),
+      ...NestiaMigrateApiStartProgrammer.write(context),
+      ...(config.e2e ? NestiaMigrateE2eProgrammer.write(context) : {}),
+      "swagger.json": JSON.stringify(this.document, null, 2),
+    };
+    return config.package ? renameSlug(config.package, files) : files;
+  }
+}
+
+const createContext = (
+  mode: "nest" | "sdk",
+  application: IHttpMigrateApplication,
+  config: INestiaMigrateConfig,
+): INestiaMigrateContext => {
+  const routes: IHttpMigrateRoute[] = escapeConflictingAccessors(
+    application.routes
+      .filter((r) => r.method !== "query")
+      .map((r) => ({
+        ...r,
+        accessor: [...r.accessor],
+      })),
+  );
+  return {
+    mode,
+    application: {
+      ...application,
+      routes,
+    },
+    config,
+  };
+};
+
+const escapeConflictingAccessors = (
+  routes: IHttpMigrateRoute[],
+): IHttpMigrateRoute[] => {
+  for (const route of routes)
+    while (true) {
+      const neighbor: IHttpMigrateRoute | undefined = routes.find(
+        (candidate) =>
+          candidate !== route &&
+          candidate.accessor.length < route.accessor.length &&
+          route.accessor
+            .slice(0, candidate.accessor.length)
+            .every((value, index) => value === candidate.accessor[index]),
+      );
+      if (neighbor === undefined) break;
+
+      const index: number = neighbor.accessor.length - 1;
+      route.accessor[index] = `_${route.accessor[index]}`;
+    }
+  return routes;
+};
+
+const renameSlug = (
+  slug: string,
+  files: Record<string, string>,
+): Record<string, string> => {
+  return Object.fromEntries(
+    Object.entries(files).map(([key, value]) => [
+      key,
+      value.split(`@ORGANIZATION/PROJECT`).join(slug),
+    ]),
+  );
+};

package/src/analyzers/NestiaMigrateControllerAnalyzer.ts

@@ -1,51 +1,51 @@
-import { IHttpMigrateRoute } from "@typia/interface";
-
-import { INestiaMigrateController } from "../structures/INestiaMigrateController";
-import { MapUtil } from "../utils/MapUtil";
-import { StringUtil } from "../utils/StringUtil";
-
-export namespace NestiaMigrateControllerAnalyzer {
-  export const analyze = (
-    routes: IHttpMigrateRoute[],
-  ): INestiaMigrateController[] => {
-    const collection: Map<string, INestiaMigrateController> = new Map();
-    for (const r of routes) {
-      const name: string =
-        r.operation()["x-samchon-controller"] ??
-        (r.accessor.length <= 1
-          ? "__App"
-          : r.accessor.slice(0, -1).map(StringUtil.capitalize).join("")) +
-          "Controller";
-      MapUtil.take(collection)(name)(() => ({
-        name,
-        path: "@lazy",
-        location: "@lazy",
-        routes: [],
-      })).routes.push(r);
-    }
-
-    const controllers: INestiaMigrateController[] = [...collection.values()];
-    for (const col of controllers) {
-      const splitPath = (r: IHttpMigrateRoute): string[] =>
-        r.emendedPath.split("/");
-      const splitLocation = (r: IHttpMigrateRoute): string[] =>
-        splitPath(r).filter((s) => s.length !== 0 && s[0] !== ":");
-
-      const minPath: string[] = splitPath(col.routes[0]!);
-      const minLocation: string[] = splitLocation(col.routes[0]!);
-      for (const r of col.routes.slice(1)) {
-        minPath.splice(getSplitIndex(minPath, splitPath(r)));
-        minLocation.splice(getSplitIndex(minLocation, splitLocation(r)));
-      }
-      col.path = minPath.join("/");
-      col.location = ["src", "controllers", ...minLocation].join("/");
-    }
-    return controllers;
-  };
-}
-
-const getSplitIndex = (x: string[], y: string[]) => {
-  const n: number = Math.min(x.length, y.length);
-  for (let i: number = 0; i < n; ++i) if (x[i] !== y[i]) return i;
-  return n;
-};
+import { IHttpMigrateRoute } from "@typia/interface";
+
+import { INestiaMigrateController } from "../structures/INestiaMigrateController";
+import { MapUtil } from "../utils/MapUtil";
+import { StringUtil } from "../utils/StringUtil";
+
+export namespace NestiaMigrateControllerAnalyzer {
+  export const analyze = (
+    routes: IHttpMigrateRoute[],
+  ): INestiaMigrateController[] => {
+    const collection: Map<string, INestiaMigrateController> = new Map();
+    for (const r of routes) {
+      const name: string =
+        r.operation()["x-samchon-controller"] ??
+        (r.accessor.length <= 1
+          ? "__App"
+          : r.accessor.slice(0, -1).map(StringUtil.capitalize).join("")) +
+          "Controller";
+      MapUtil.take(collection)(name)(() => ({
+        name,
+        path: "@lazy",
+        location: "@lazy",
+        routes: [],
+      })).routes.push(r);
+    }
+
+    const controllers: INestiaMigrateController[] = [...collection.values()];
+    for (const col of controllers) {
+      const splitPath = (r: IHttpMigrateRoute): string[] =>
+        r.emendedPath.split("/");
+      const splitLocation = (r: IHttpMigrateRoute): string[] =>
+        splitPath(r).filter((s) => s.length !== 0 && s[0] !== ":");
+
+      const minPath: string[] = splitPath(col.routes[0]!);
+      const minLocation: string[] = splitLocation(col.routes[0]!);
+      for (const r of col.routes.slice(1)) {
+        minPath.splice(getSplitIndex(minPath, splitPath(r)));
+        minLocation.splice(getSplitIndex(minLocation, splitLocation(r)));
+      }
+      col.path = minPath.join("/");
+      col.location = ["src", "controllers", ...minLocation].join("/");
+    }
+    return controllers;
+  };
+}
+
+const getSplitIndex = (x: string[], y: string[]) => {
+  const n: number = Math.min(x.length, y.length);
+  for (let i: number = 0; i < n; ++i) if (x[i] !== y[i]) return i;
+  return n;
+};

package/src/archivers/NestiaMigrateFileArchiver.ts

@@ -1,28 +1,28 @@
-import { VariadicSingleton } from "tstl";
-
-export namespace NestiaMigrateFileArchiver {
-  export const archive = async (props: {
-    mkdir: (path: string) => Promise<void>;
-    writeFile: (path: string, content: string) => Promise<void>;
-    root: string;
-    files: Record<string, string>;
-  }): Promise<void> => {
-    const mkdir = new VariadicSingleton(
-      async (location: string): Promise<void> => {
-        try {
-          await props.mkdir(`${props.root}/${location}`);
-        } catch {}
-      },
-    );
-    const iterate = async (location: string): Promise<void> => {
-      const sequence: string[] = location
-        .split("/")
-        .map((_str, i, entire) => entire.slice(0, i + 1).join("/"));
-      for (const s of sequence) await mkdir.get(s);
-    };
-    for (const [key, value] of Object.entries(props.files)) {
-      await iterate(key.split("/").slice(0, -1).join("/"));
-      await props.writeFile(`${props.root}/${key}`, value);
-    }
-  };
-}
+import { VariadicSingleton } from "tstl";
+
+export namespace NestiaMigrateFileArchiver {
+  export const archive = async (props: {
+    mkdir: (path: string) => Promise<void>;
+    writeFile: (path: string, content: string) => Promise<void>;
+    root: string;
+    files: Record<string, string>;
+  }): Promise<void> => {
+    const mkdir = new VariadicSingleton(
+      async (location: string): Promise<void> => {
+        try {
+          await props.mkdir(`${props.root}/${location}`);
+        } catch {}
+      },
+    );
+    const iterate = async (location: string): Promise<void> => {
+      const sequence: string[] = location
+        .split("/")
+        .map((_str, i, entire) => entire.slice(0, i + 1).join("/"));
+      for (const s of sequence) await mkdir.get(s);
+    };
+    for (const [key, value] of Object.entries(props.files)) {
+      await iterate(key.split("/").slice(0, -1).join("/"));
+      await props.writeFile(`${props.root}/${key}`, value);
+    }
+  };
+}