@nestia/migrate 0.7.5 → 0.7.6

package/src/archivers/{FileArchiver.ts → MigrateFileArchiver.ts}

@@ -1,38 +1,38 @@
-import { IMigrateFile } from "../structures/IMigrateFile";
-
-export namespace FileArchiver {
-  export interface IOperator {
-    mkdir(path: string): Promise<void>;
-    writeFile(path: string, content: string): Promise<void>;
-  }
-
-  export const archive =
-    (operator: IOperator) =>
-    (output: string) =>
-    async (files: IMigrateFile[]): Promise<void> => {
-      const visited: Set<string> = new Set();
-      for (const f of files) {
-        await mkdir(operator.mkdir)(output)(visited)(f.location);
-        await operator.writeFile(
-          [output, f.location, f.file].join("/"),
-          f.content,
-        );
-      }
-    };
-
-  const mkdir =
-    (creator: (path: string) => void) =>
-    (output: string) =>
-    (visited: Set<string>) =>
-    async (path: string): Promise<void> => {
-      const sequence: string[] = path
-        .split("/")
-        .map((_str, i, entire) => entire.slice(0, i + 1).join("/"));
-      for (const s of sequence)
-        if (visited.has(s) === false)
-          try {
-            await creator([output, s].join("/"));
-            visited.add(s);
-          } catch {}
-    };
-}
+import { IMigrateFile } from "../structures/IMigrateFile";
+
+export namespace MigrateFileArchiver {
+  export interface IOperator {
+    mkdir(path: string): Promise<void>;
+    writeFile(path: string, content: string): Promise<void>;
+  }
+
+  export const archive =
+    (operator: IOperator) =>
+    (output: string) =>
+    async (files: IMigrateFile[]): Promise<void> => {
+      const visited: Set<string> = new Set();
+      for (const f of files) {
+        await mkdir(operator.mkdir)(output)(visited)(f.location);
+        await operator.writeFile(
+          [output, f.location, f.file].join("/"),
+          f.content,
+        );
+      }
+    };
+
+  const mkdir =
+    (creator: (path: string) => void) =>
+    (output: string) =>
+    (visited: Set<string>) =>
+    async (path: string): Promise<void> => {
+      const sequence: string[] = path
+        .split("/")
+        .map((_str, i, entire) => entire.slice(0, i + 1).join("/"));
+      for (const s of sequence)
+        if (visited.has(s) === false)
+          try {
+            await creator([output, s].join("/"));
+            visited.add(s);
+          } catch {}
+    };
+}

package/src/bundles/SDK_TEMPLATE.ts

@@ -1,9 +1,4 @@
 export const SDK_TEMPLATE = [
-  {
-    "location": ".github/workflows",
-    "file": "build.yml",
-    "content": "name: build\r\non: [push, pull_request]\r\n\r\njobs:\r\n  Ubuntu:\r\n    runs-on: ubuntu-latest\r\n    steps:\r\n      - uses: actions/checkout@v4\r\n      - uses: actions/setup-node@v4\r\n        with:\r\n          node-version: 20.x\r\n      - uses: pnpm/action-setup@v2\r\n        with:\r\n          version: 8\r\n\r\n      - name: Install\r\n        run: pnpm install\r\n\r\n      - name: Build\r\n        run: npm run build\r\n"
-  },
   {
     "location": "",
     "file": ".gitignore",

package/src/executable/bundle.ts

@@ -1,108 +1,109 @@
-import cp from "child_process";
-import fs from "fs";
-
-import { IMigrateFile } from "../structures/IMigrateFile";
-
-const ROOT: string = `${__dirname}/../..`;
-const ASSETS: string = `${ROOT}/assets`;
-
-const bundle = async (props: {
-  mode: "nest" | "sdk";
-  repository: string;
-  exceptions?: string[];
-}): Promise<void> => {
-  const root: string = `${__dirname}/../..`;
-  const assets: string = `${root}/assets`;
-  const template: string = `${assets}/${props.mode}`;
-
-  const clone = async () => {
-    // CLONE REPOSITORY
-    if (fs.existsSync(template))
-      await fs.promises.rm(template, { recursive: true });
-    else
-      try {
-        await fs.promises.mkdir(ASSETS);
-      } catch {}
-
-    cp.execSync(
-      `git clone https://github.com/samchon/${props.repository} ${props.mode}`,
-      {
-        cwd: ASSETS,
-      },
-    );
-
-    // REMOVE VUNLERABLE FILES
-    for (const location of props.exceptions ?? [])
-      await fs.promises.rm(`${template}/${location}`, { recursive: true });
-  };
-
-  const iterate = (collection: IMigrateFile[]) => async (location: string) => {
-    const directory: string[] = await fs.promises.readdir(location);
-    for (const file of directory) {
-      const absolute: string = location + "/" + file;
-      const stats: fs.Stats = await fs.promises.stat(absolute);
-      if (stats.isDirectory()) await iterate(collection)(absolute);
-      else {
-        const content: string = await fs.promises.readFile(absolute, "utf-8");
-        collection.push({
-          location: (() => {
-            const str: string = location.replace(template, "");
-            return str[0] === "/" ? str.substring(1) : str;
-          })(),
-          file,
-          content,
-        });
-      }
-    }
-  };
-
-  const archive = async (collection: IMigrateFile[]): Promise<void> => {
-    const name: string = `${props.mode.toUpperCase()}_TEMPLATE`;
-    const body: string = JSON.stringify(collection, null, 2);
-    const content: string = `export const ${name} = ${body}`;
-
-    try {
-      await fs.promises.mkdir(`${ROOT}/src/bundles`);
-    } catch {}
-    await fs.promises.writeFile(
-      `${ROOT}/src/bundles/${name}.ts`,
-      content,
-      "utf8",
-    );
-  };
-
-  const collection: IMigrateFile[] = [];
-  await clone();
-  await iterate(collection)(template);
-  await archive(collection);
-};
-
-const main = async (): Promise<void> => {
-  await bundle({
-    mode: "nest",
-    repository: "nestia-start",
-    exceptions: [
-      ".git",
-      ".github/dependabot.yml",
-      "src/api/functional",
-      "src/controllers",
-      "src/MyModule.ts",
-      "src/providers",
-      "test/features",
-    ],
-  });
-  await bundle({
-    mode: "sdk",
-    repository: "nestia-sdk-template",
-    exceptions: [
-      ".git",
-      ".github/dependabot.yml",
-      "src/functional",
-      "src/structures",
-    ],
-  });
-};
-main().catch((exp) => {
-  console.error(exp);
-  process.exit(-1);
-});
+import cp from "child_process";
+import fs from "fs";
+
+import { IMigrateFile } from "../structures/IMigrateFile";
+
+const ROOT: string = `${__dirname}/../..`;
+const ASSETS: string = `${ROOT}/assets`;
+
+const bundle = async (props: {
+  mode: "nest" | "sdk";
+  repository: string;
+  exceptions?: string[];
+}): Promise<void> => {
+  const root: string = `${__dirname}/../..`;
+  const assets: string = `${root}/assets`;
+  const template: string = `${assets}/${props.mode}`;
+
+  const clone = async () => {
+    // CLONE REPOSITORY
+    if (fs.existsSync(template))
+      await fs.promises.rm(template, { recursive: true });
+    else
+      try {
+        await fs.promises.mkdir(ASSETS);
+      } catch {}
+
+    cp.execSync(
+      `git clone https://github.com/samchon/${props.repository} ${props.mode}`,
+      {
+        cwd: ASSETS,
+      },
+    );
+
+    // REMOVE VUNLERABLE FILES
+    for (const location of props.exceptions ?? [])
+      await fs.promises.rm(`${template}/${location}`, { recursive: true });
+  };
+
+  const iterate = (collection: IMigrateFile[]) => async (location: string) => {
+    const directory: string[] = await fs.promises.readdir(location);
+    for (const file of directory) {
+      const absolute: string = location + "/" + file;
+      const stats: fs.Stats = await fs.promises.stat(absolute);
+      if (stats.isDirectory()) await iterate(collection)(absolute);
+      else {
+        const content: string = await fs.promises.readFile(absolute, "utf-8");
+        collection.push({
+          location: (() => {
+            const str: string = location.replace(template, "");
+            return str[0] === "/" ? str.substring(1) : str;
+          })(),
+          file,
+          content,
+        });
+      }
+    }
+  };
+
+  const archive = async (collection: IMigrateFile[]): Promise<void> => {
+    const name: string = `${props.mode.toUpperCase()}_TEMPLATE`;
+    const body: string = JSON.stringify(collection, null, 2);
+    const content: string = `export const ${name} = ${body}`;
+
+    try {
+      await fs.promises.mkdir(`${ROOT}/src/bundles`);
+    } catch {}
+    await fs.promises.writeFile(
+      `${ROOT}/src/bundles/${name}.ts`,
+      content,
+      "utf8",
+    );
+  };
+
+  const collection: IMigrateFile[] = [];
+  await clone();
+  await iterate(collection)(template);
+  await archive(collection);
+};
+
+const main = async (): Promise<void> => {
+  await bundle({
+    mode: "nest",
+    repository: "nestia-start",
+    exceptions: [
+      ".git",
+      ".github/dependabot.yml",
+      "src/api/functional",
+      "src/controllers",
+      "src/MyModule.ts",
+      "src/providers",
+      "test/features",
+    ],
+  });
+  await bundle({
+    mode: "sdk",
+    repository: "nestia-sdk-template",
+    exceptions: [
+      ".git",
+      ".github/dependabot.yml",
+      ".github/workflows/build.yml",
+      "src/functional",
+      "src/structures",
+    ],
+  });
+};
+main().catch((exp) => {
+  console.error(exp);
+  process.exit(-1);
+});

package/src/executable/migrate.ts

@@ -1,7 +1,7 @@
-#!/usr/bin/env node
-import { MigrateCommander } from "../internal/MigrateCommander";
-
-MigrateCommander.main().catch((exp) => {
-  console.error(exp);
-  process.exit(-1);
-});
+#!/usr/bin/env node
+import { MigrateCommander } from "../internal/MigrateCommander";
+
+MigrateCommander.main().catch((exp) => {
+  console.error(exp);
+  process.exit(-1);
+});

package/src/internal/MigrateCommander.ts

@@ -1,52 +1,51 @@
-import fs from "fs";
-import path from "path";
-
-import { FileArchiver } from "../archivers/FileArchiver";
-import { MigrateApplication } from "../module";
-import { IMigrateFile } from "../structures/IMigrateFile";
-import { ISwagger } from "../structures/ISwagger";
-import { MigrateInquirer } from "./MigrateInquirer";
-
-export namespace MigrateCommander {
-  export const main = async (): Promise<void> => {
-    const resolve = (str: string | undefined) =>
-      str ? path.resolve(str).split("\\").join("/") : undefined;
-    const options: MigrateInquirer.IOutput = await MigrateInquirer.parse();
-
-    // VALIDATE OUTPUT DIRECTORY
-    const parent: string = resolve(options.output + "/..")!;
-    if (fs.existsSync(options.output)) halt("Output directory alreay exists.");
-    else if (fs.existsSync(parent) === false)
-      halt("Output directory's parent directory does not exist.");
-    else if (fs.statSync(parent).isDirectory() === false)
-      halt("Output directory's parent is not a directory.");
-
-    // READ SWAGGER
-    const swagger: ISwagger = (() => {
-      if (fs.existsSync(options.input) === false)
-        halt("Unable to find the input swagger.json file.");
-      const stats: fs.Stats = fs.statSync(options.input);
-      if (stats.isFile() === false)
-        halt("The input swagger.json is not a file.");
-      const content: string = fs.readFileSync(options.input, "utf-8");
-      const swagger: ISwagger = JSON.parse(content);
-      return swagger;
-    })();
-
-    const app: MigrateApplication = new MigrateApplication(swagger);
-    const files: IMigrateFile[] =
-      options.mode === "nest"
-        ? app.nest(options.simulate)
-        : app.sdk(options.simulate);
-    await FileArchiver.archive({
-      mkdir: fs.promises.mkdir,
-      writeFile: (file, content) =>
-        fs.promises.writeFile(file, content, "utf-8"),
-    })(options.output)(files);
-  };
-
-  const halt = (desc: string): never => {
-    console.error(desc);
-    process.exit(-1);
-  };
-}
+import fs from "fs";
+import path from "path";
+
+import { MigrateFileArchiver } from "../archivers/MigrateFileArchiver";
+import { MigrateApplication } from "../module";
+import { ISwagger } from "../structures/ISwagger";
+import { MigrateInquirer } from "./MigrateInquirer";
+
+export namespace MigrateCommander {
+  export const main = async (): Promise<void> => {
+    const resolve = (str: string | undefined) =>
+      str ? path.resolve(str).split("\\").join("/") : undefined;
+    const options: MigrateInquirer.IOutput = await MigrateInquirer.parse();
+
+    // VALIDATE OUTPUT DIRECTORY
+    const parent: string = resolve(options.output + "/..")!;
+    if (fs.existsSync(options.output)) halt("Output directory alreay exists.");
+    else if (fs.existsSync(parent) === false)
+      halt("Output directory's parent directory does not exist.");
+    else if (fs.statSync(parent).isDirectory() === false)
+      halt("Output directory's parent is not a directory.");
+
+    // READ SWAGGER
+    const swagger: ISwagger = (() => {
+      if (fs.existsSync(options.input) === false)
+        halt("Unable to find the input swagger.json file.");
+      const stats: fs.Stats = fs.statSync(options.input);
+      if (stats.isFile() === false)
+        halt("The input swagger.json is not a file.");
+      const content: string = fs.readFileSync(options.input, "utf-8");
+      const swagger: ISwagger = JSON.parse(content);
+      return swagger;
+    })();
+
+    const app: MigrateApplication = new MigrateApplication(swagger);
+    const { files } =
+      options.mode === "nest"
+        ? app.nest(options.simulate)
+        : app.sdk(options.simulate);
+    await MigrateFileArchiver.archive({
+      mkdir: fs.promises.mkdir,
+      writeFile: (file, content) =>
+        fs.promises.writeFile(file, content, "utf-8"),
+    })(options.output)(files);
+  };
+
+  const halt = (desc: string): never => {
+    console.error(desc);
+    process.exit(-1);
+  };
+}

package/src/internal/MigrateInquirer.ts

@@ -1,79 +1,79 @@
-import commander from "commander";
-import inquirer from "inquirer";
-
-export namespace MigrateInquirer {
-  export interface IOutput {
-    mode: "nest" | "sdk";
-    simulate: boolean;
-    input: string;
-    output: string;
-  }
-
-  export const parse = async (): Promise<IOutput> => {
-    // PREPARE ASSETS
-    commander.program.option("--mode [nest/sdk]", "migration mode");
-    commander.program.option(
-      "--input [swagger.json]",
-      "location of target swagger.json file",
-    );
-    commander.program.option("--output [directory]", "output directory path");
-    commander.program.option("--simulate", "Mockup simulator");
-
-    // INTERNAL PROCEDURES
-    const questioned = { value: false };
-    const action = (closure: (options: Partial<IOutput>) => Promise<IOutput>) =>
-      new Promise<IOutput>((resolve, reject) => {
-        commander.program.action(async (options) => {
-          try {
-            resolve(await closure(options));
-          } catch (exp) {
-            reject(exp);
-          }
-        });
-        commander.program.parseAsync().catch(reject);
-      });
-    const select =
-      (name: string) =>
-      (message: string) =>
-      async <Choice extends string>(
-        choices: Choice[],
-        filter?: (value: string) => Choice,
-      ): Promise<Choice> => {
-        questioned.value = true;
-        return (
-          await inquirer.createPromptModule()({
-            type: "list",
-            name: name,
-            message: message,
-            choices: choices,
-            filter,
-          })
-        )[name];
-      };
-    const input = (name: string) => async (message: string) =>
-      (
-        await inquirer.createPromptModule()({
-          type: "input",
-          name,
-          message,
-        })
-      )[name];
-
-    // DO CONSTRUCT
-    return action(async (partial) => {
-      partial.mode ??= await select("mode")("Migration mode")(
-        ["NestJS" as "nest", "SDK" as "sdk"],
-        (value) => (value === "NestJS" ? "nest" : "sdk"),
-      );
-      partial.input ??= await input("input")("Swagger file location");
-      partial.output ??= await input("output")("Output directory path");
-      if (partial.simulate)
-        partial.simulate = (partial.simulate as any) === "true";
-      else
-        partial.simulate =
-          (await select("simulate")("Mokup Simulator")(["true", "false"])) ===
-          "true";
-      return partial as IOutput;
-    });
-  };
-}
+import commander from "commander";
+import inquirer from "inquirer";
+
+export namespace MigrateInquirer {
+  export interface IOutput {
+    mode: "nest" | "sdk";
+    simulate: boolean;
+    input: string;
+    output: string;
+  }
+
+  export const parse = async (): Promise<IOutput> => {
+    // PREPARE ASSETS
+    commander.program.option("--mode [nest/sdk]", "migration mode");
+    commander.program.option(
+      "--input [swagger.json]",
+      "location of target swagger.json file",
+    );
+    commander.program.option("--output [directory]", "output directory path");
+    commander.program.option("--simulate", "Mockup simulator");
+
+    // INTERNAL PROCEDURES
+    const questioned = { value: false };
+    const action = (closure: (options: Partial<IOutput>) => Promise<IOutput>) =>
+      new Promise<IOutput>((resolve, reject) => {
+        commander.program.action(async (options) => {
+          try {
+            resolve(await closure(options));
+          } catch (exp) {
+            reject(exp);
+          }
+        });
+        commander.program.parseAsync().catch(reject);
+      });
+    const select =
+      (name: string) =>
+      (message: string) =>
+      async <Choice extends string>(
+        choices: Choice[],
+        filter?: (value: string) => Choice,
+      ): Promise<Choice> => {
+        questioned.value = true;
+        return (
+          await inquirer.createPromptModule()({
+            type: "list",
+            name: name,
+            message: message,
+            choices: choices,
+            filter,
+          })
+        )[name];
+      };
+    const input = (name: string) => async (message: string) =>
+      (
+        await inquirer.createPromptModule()({
+          type: "input",
+          name,
+          message,
+        })
+      )[name];
+
+    // DO CONSTRUCT
+    return action(async (partial) => {
+      partial.mode ??= await select("mode")("Migration mode")(
+        ["NestJS" as "nest", "SDK" as "sdk"],
+        (value) => (value === "NestJS" ? "nest" : "sdk"),
+      );
+      partial.input ??= await input("input")("Swagger file location");
+      partial.output ??= await input("output")("Output directory path");
+      if (partial.simulate)
+        partial.simulate = (partial.simulate as any) === "true";
+      else
+        partial.simulate =
+          (await select("simulate")("Mokup Simulator")(["true", "false"])) ===
+          "true";
+      return partial as IOutput;
+    });
+  };
+}

package/src/module.ts

@@ -1,4 +1,4 @@
-export * from "./MigrateApplication";
-
-export * from "./structures/ISwagger";
-export * from "./structures/IMigrateProgram";
+export * from "./MigrateApplication";
+
+export * from "./structures/ISwagger";
+export * from "./structures/IMigrateProgram";