@nestia/migrate 6.0.6 → 7.0.0-dev.20250605

package/src/NestiaMigrateApplication.ts

@@ -0,0 +1,144 @@
+import {
+  HttpMigration,
+  IHttpMigrateApplication,
+  OpenApi,
+  OpenApiV3,
+  OpenApiV3_1,
+  SwaggerV2,
+} from "@samchon/openapi";
+import typia, { IValidation } from "typia";
+
+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";
+import { INestiaMigrateFile } from "./structures/INestiaMigrateFile";
+
+export class NestiaMigrateApplication {
+  private readonly application_: IHttpMigrateApplication;
+
+  public constructor(public readonly document: OpenApi.IDocument) {
+    this.application_ = HttpMigration.application(document);
+  }
+
+  public static assert(
+    document:
+      | SwaggerV2.IDocument
+      | OpenApiV3.IDocument
+      | OpenApiV3_1.IDocument
+      | OpenApi.IDocument,
+  ): NestiaMigrateApplication {
+    return new NestiaMigrateApplication(
+      OpenApi.convert(typia.assert(document)),
+    );
+  }
+
+  public static validate(
+    document:
+      | SwaggerV2.IDocument
+      | OpenApiV3.IDocument
+      | OpenApiV3_1.IDocument
+      | OpenApi.IDocument,
+  ): IValidation<NestiaMigrateApplication> {
+    const result: IValidation<
+      | SwaggerV2.IDocument
+      | OpenApiV3.IDocument
+      | OpenApiV3_1.IDocument
+      | OpenApi.IDocument
+    > = typia.validate(document);
+    if (result.success === false) return result;
+    return {
+      success: true,
+      data: new NestiaMigrateApplication(OpenApi.convert(document)),
+    };
+  }
+
+  public getErrors(): IHttpMigrateApplication.IError[] {
+    return this.application_.errors;
+  }
+
+  public nest(config: INestiaMigrateConfig): Record<string, string> {
+    const context: INestiaMigrateContext = createContext(
+      "nest",
+      this.document,
+      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) : {}),
+    };
+    return config.package ? this.rename(config.package, files) : files;
+  }
+
+  public sdk(config: INestiaMigrateConfig): Record<string, string> {
+    const context: INestiaMigrateContext = createContext(
+      "sdk",
+      this.document,
+      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 ? this.rename(config.package, files) : files;
+  }
+
+  private rename(
+    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),
+      ]),
+    );
+  }
+}
+export namespace MigrateApplication {
+  export interface IOutput {
+    context: INestiaMigrateContext;
+    files: INestiaMigrateFile[];
+    errors: IHttpMigrateApplication.IError[];
+  }
+}
+
+const createContext = (
+  mode: "nest" | "sdk",
+  document: OpenApi.IDocument,
+  config: INestiaMigrateConfig,
+): INestiaMigrateContext => {
+  const application: IHttpMigrateApplication =
+    HttpMigration.application(document);
+  return {
+    mode,
+    document,
+    config,
+    routes: application.routes,
+    errors: application.errors,
+  };
+};

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

@@ -1,51 +1,51 @@
-import { IHttpMigrateRoute } from "@samchon/openapi";
-
-import { IHttpMigrateController } from "../structures/IHttpMigrateController";
-import { MapUtil } from "../utils/MapUtil";
-import { StringUtil } from "../utils/StringUtil";
-
-export namespace MigrateControllerAnalyzer {
-  export const analyze = (props: {
-    routes: IHttpMigrateRoute[];
-  }): IHttpMigrateController[] => {
-    const collection: Map<string, IHttpMigrateController> = new Map();
-    for (const route of props.routes) {
-      const name: string =
-        route.operation()["x-samchon-controller"] ??
-        (route.accessor.length <= 1
-          ? "__App"
-          : route.accessor.slice(0, -1).map(StringUtil.capitalize).join("")) +
-          "Controller";
-      MapUtil.take(collection)(name)(() => ({
-        name,
-        path: "@lazy",
-        location: "@lazy",
-        routes: [],
-      })).routes.push(route);
-    }
-
-    const controllers: IHttpMigrateController[] = [...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 "@samchon/openapi";
+
+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

@@ -0,0 +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);
+    }
+  };
+}