@nestia/sdk 1.0.4 → 1.0.5

package/src/executable/sdk.ts

@@ -1,74 +1,74 @@
-#!/usr/bin/env node
-import cp from "child_process";
-import fs from "fs";
-import process from "process";
-
-import { CommandParser } from "./internal/CommandParser";
-import type { NestiaSdkCommand } from "./internal/NestiaSdkCommand";
-
-const USAGE = `Wrong command has been detected. Use like below:
-
-npx @nestia/sdk [command] [options?]
-
-  1. npx @nestia/sdk dependencies --manager (npm|pnpm|yarn)
-    - npx @nestia/sdk dependencies
-    - npx @nestia/sdk dependencies --manager pnpm
-  2. npx @nestia/sdk init
-  3. npx @nestia/sdk sdk <input> --out <output>
-    - npx @nestia/sdk sdk # when "nestia.config.ts" be configured
-    - npx @nestia/sdk sdk src/controllers --out src/api
-    - npx @nestia/sdk sdk src/**/*.controller.ts --out src/api
-  4. npx @nestia/sdk swagger <input> --out <output>
-    - npx @nestia/sdk swagger # when "nestia.config.ts" be configured
-    - npx @nestia/sdk swagger src/controllers --out src/api
-    - npx @nestia/sdk swagger src/**/*.controller.ts --out src/api       
-`;
-
-function halt(desc: string): never {
-    console.error(desc);
-    process.exit(-1);
-}
-
-function dependencies(argv: string[]): void {
-    // INSTALL DEPENDENCIES
-    const module = CommandParser.parse(argv).module ?? "npm";
-    const prefix: string = module === "yarn" ? "yarn add" : `${module} install`;
-
-    for (const lib of ["@nestia/fetcher", "typia"]) {
-        const command: string = `${prefix} ${lib}`;
-        cp.execSync(command, { stdio: "inherit" });
-    }
-}
-
-async function initialize(): Promise<void> {
-    if (fs.existsSync("nestia.config.ts") === true)
-        halt(
-            `Error on nestia.sdk.initialize(): "nestia.config.ts" file already has been configured.`,
-        );
-    await fs.promises.copyFile(
-        `${__dirname}/../../assets/config/nestia.config.ts`,
-        "nestia.config.ts",
-    );
-}
-
-async function execute(
-    closure: (commander: typeof NestiaSdkCommand) => Promise<void>,
-): Promise<void> {
-    const module = await import("./internal/NestiaSdkCommand");
-    await closure(module.NestiaSdkCommand);
-}
-
-async function main() {
-    const type: string | undefined = process.argv[2];
-    const argv: string[] = process.argv.slice(3);
-
-    if (type === "dependencies") dependencies(argv);
-    else if (type === "init") await initialize();
-    else if (type === "sdk") await execute((c) => c.sdk(argv));
-    else if (type === "swagger") await execute((c) => c.swagger(argv));
-    else halt(USAGE);
-}
-main().catch((exp) => {
-    console.log(exp.message);
-    process.exit(-1);
-});
+#!/usr/bin/env node
+import cp from "child_process";
+import fs from "fs";
+import process from "process";
+
+import { CommandParser } from "./internal/CommandParser";
+import type { NestiaSdkCommand } from "./internal/NestiaSdkCommand";
+
+const USAGE = `Wrong command has been detected. Use like below:
+
+npx @nestia/sdk [command] [options?]
+
+  1. npx @nestia/sdk dependencies --manager (npm|pnpm|yarn)
+    - npx @nestia/sdk dependencies
+    - npx @nestia/sdk dependencies --manager pnpm
+  2. npx @nestia/sdk init
+  3. npx @nestia/sdk sdk <input> --out <output>
+    - npx @nestia/sdk sdk # when "nestia.config.ts" be configured
+    - npx @nestia/sdk sdk src/controllers --out src/api
+    - npx @nestia/sdk sdk src/**/*.controller.ts --out src/api
+  4. npx @nestia/sdk swagger <input> --out <output>
+    - npx @nestia/sdk swagger # when "nestia.config.ts" be configured
+    - npx @nestia/sdk swagger src/controllers --out src/api
+    - npx @nestia/sdk swagger src/**/*.controller.ts --out src/api       
+`;
+
+function halt(desc: string): never {
+    console.error(desc);
+    process.exit(-1);
+}
+
+function dependencies(argv: string[]): void {
+    // INSTALL DEPENDENCIES
+    const module = CommandParser.parse(argv).module ?? "npm";
+    const prefix: string = module === "yarn" ? "yarn add" : `${module} install`;
+
+    for (const lib of ["@nestia/fetcher", "typia"]) {
+        const command: string = `${prefix} ${lib}`;
+        cp.execSync(command, { stdio: "inherit" });
+    }
+}
+
+async function initialize(): Promise<void> {
+    if (fs.existsSync("nestia.config.ts") === true)
+        halt(
+            `Error on nestia.sdk.initialize(): "nestia.config.ts" file already has been configured.`,
+        );
+    await fs.promises.copyFile(
+        `${__dirname}/../../assets/config/nestia.config.ts`,
+        "nestia.config.ts",
+    );
+}
+
+async function execute(
+    closure: (commander: typeof NestiaSdkCommand) => Promise<void>,
+): Promise<void> {
+    const module = await import("./internal/NestiaSdkCommand");
+    await closure(module.NestiaSdkCommand);
+}
+
+async function main() {
+    const type: string | undefined = process.argv[2];
+    const argv: string[] = process.argv.slice(3);
+
+    if (type === "dependencies") dependencies(argv);
+    else if (type === "init") await initialize();
+    else if (type === "sdk") await execute((c) => c.sdk(argv));
+    else if (type === "swagger") await execute((c) => c.swagger(argv));
+    else halt(USAGE);
+}
+main().catch((exp) => {
+    console.log(exp.message);
+    process.exit(-1);
+});

package/src/generates/FileGenerator.ts

@@ -1,156 +1,156 @@
-import fs from "fs";
-import { HashMap } from "tstl/container/HashMap";
-
-import { INestiaConfig } from "../INestiaConfig";
-import { IRoute } from "../structures/IRoute";
-import { ImportDictionary } from "../utils/ImportDictionary";
-import { FunctionGenerator } from "./FunctionGenerator";
-
-export namespace FileGenerator {
-    /* ---------------------------------------------------------
-        CONSTRUCTOR
-    --------------------------------------------------------- */
-    export async function generate(
-        config: INestiaConfig,
-        routeList: IRoute[],
-    ): Promise<void> {
-        // CONSTRUCT FOLDER TREE
-        const root: Directory = new Directory(null, "functional");
-        for (const route of routeList) emplace(root, route);
-
-        // RELOCATE FOR ONLY ONE CONTROLLER METHOD IN AN URL CASE
-        relocate(root);
-
-        // ITERATE FILES
-        await iterate(config, config.output + "/functional", root);
-    }
-
-    function emplace(directory: Directory, route: IRoute): void {
-        // SEPARATE IDENTIFIERS
-        const identifiers: string[] = route.path
-            .split("/")
-            .filter((str) => str.length && str[0] !== ":")
-            .map((str) => str.split("-").join("_").split(".").join("_"));
-
-        // OPEN DIRECTORIES
-        for (const key of identifiers) {
-            directory = directory.directories.take(
-                key,
-                () => new Directory(directory, key),
-            );
-        }
-
-        // ADD ROUTE
-        directory.routes.push(route);
-    }
-
-    function relocate(directory: Directory): void {
-        if (
-            directory.parent !== null &&
-            directory.directories.empty() &&
-            directory.routes.length === 1 &&
-            directory.name === directory.routes[0].name
-        ) {
-            directory.parent.routes.push(directory.routes[0]);
-            directory.parent.directories.erase(directory.name);
-        } else if (directory.directories.empty() === false)
-            for (const it of directory.directories) relocate(it.second);
-    }
-
-    /* ---------------------------------------------------------
-        FILE ITERATOR
-    --------------------------------------------------------- */
-    async function iterate(
-        config: INestiaConfig,
-        outDir: string,
-        directory: Directory,
-    ): Promise<void> {
-        // CREATE A NEW DIRECTORY
-        try {
-            await fs.promises.mkdir(outDir);
-        } catch {}
-
-        // ITERATE CHILDREN
-        const content: string[] = [];
-        for (const it of directory.directories) {
-            await iterate(config, `${outDir}/${it.first}`, it.second);
-            content.push(`export * as ${it.first} from "./${it.first}";`);
-        }
-        if (content.length && directory.routes.length) content.push("");
-
-        // ITERATE ROUTES
-        const importDict: ImportDictionary = new ImportDictionary();
-        directory.routes.forEach((route, i) => {
-            for (const tuple of route.imports)
-                for (const instance of tuple[1])
-                    importDict.emplace(tuple[0], false, instance);
-
-            content.push(FunctionGenerator.generate(config, route));
-            if (i !== directory.routes.length - 1) content.push("");
-        });
-
-        // FINALIZE THE CONTENT
-        if (directory.routes.length !== 0) {
-            const primitived: boolean =
-                config.primitive !== false &&
-                directory.routes.some(
-                    (route) =>
-                        route.output.name !== "void" ||
-                        route.parameters.some(
-                            (param) => param.category !== "param",
-                        ),
-                );
-            const asserted: boolean =
-                config.assert === true &&
-                directory.routes.some((route) => route.parameters.length !== 0);
-            const json: boolean =
-                config.json === true &&
-                directory.routes.some(
-                    (route) =>
-                        route.method === "POST" ||
-                        route.method === "PUT" ||
-                        route.method === "PATCH",
-                );
-
-            const fetcher: string[] = ["Fetcher"];
-            if (primitived) fetcher.push("Primitive");
-
-            const head: string[] = [
-                `import { ${fetcher.join(", ")} } from "@nestia/fetcher";`,
-                `import type { IConnection } from "@nestia/fetcher";`,
-            ];
-            if (asserted || json) head.push(`import typia from "typia";`);
-            if (!importDict.empty()) head.push("", importDict.toScript(outDir));
-
-            content.push(...head, "", ...content.splice(0, content.length));
-        }
-
-        const script: string =
-            "/**\n" +
-            " * @packageDocumentation\n" +
-            ` * @module ${directory.module}\n` +
-            " * @nestia Generated by Nestia - https://github.com/samchon/nestia \n" +
-            " */\n" +
-            "//================================================================\n" +
-            content.join("\n");
-        await fs.promises.writeFile(`${outDir}/index.ts`, script, "utf8");
-    }
-}
-
-class Directory {
-    public readonly module: string;
-    public readonly directories: HashMap<string, Directory>;
-    public readonly routes: IRoute[];
-
-    public constructor(
-        readonly parent: Directory | null,
-        readonly name: string,
-    ) {
-        this.directories = new HashMap();
-        this.routes = [];
-        this.module =
-            this.parent !== null
-                ? `${this.parent.module}.${name}`
-                : `api.${name}`;
-    }
-}
+import fs from "fs";
+import { HashMap } from "tstl/container/HashMap";
+
+import { INestiaConfig } from "../INestiaConfig";
+import { IRoute } from "../structures/IRoute";
+import { ImportDictionary } from "../utils/ImportDictionary";
+import { FunctionGenerator } from "./FunctionGenerator";
+
+export namespace FileGenerator {
+    /* ---------------------------------------------------------
+        CONSTRUCTOR
+    --------------------------------------------------------- */
+    export async function generate(
+        config: INestiaConfig,
+        routeList: IRoute[],
+    ): Promise<void> {
+        // CONSTRUCT FOLDER TREE
+        const root: Directory = new Directory(null, "functional");
+        for (const route of routeList) emplace(root, route);
+
+        // RELOCATE FOR ONLY ONE CONTROLLER METHOD IN AN URL CASE
+        relocate(root);
+
+        // ITERATE FILES
+        await iterate(config, config.output + "/functional", root);
+    }
+
+    function emplace(directory: Directory, route: IRoute): void {
+        // SEPARATE IDENTIFIERS
+        const identifiers: string[] = route.path
+            .split("/")
+            .filter((str) => str.length && str[0] !== ":")
+            .map((str) => str.split("-").join("_").split(".").join("_"));
+
+        // OPEN DIRECTORIES
+        for (const key of identifiers) {
+            directory = directory.directories.take(
+                key,
+                () => new Directory(directory, key),
+            );
+        }
+
+        // ADD ROUTE
+        directory.routes.push(route);
+    }
+
+    function relocate(directory: Directory): void {
+        if (
+            directory.parent !== null &&
+            directory.directories.empty() &&
+            directory.routes.length === 1 &&
+            directory.name === directory.routes[0].name
+        ) {
+            directory.parent.routes.push(directory.routes[0]);
+            directory.parent.directories.erase(directory.name);
+        } else if (directory.directories.empty() === false)
+            for (const it of directory.directories) relocate(it.second);
+    }
+
+    /* ---------------------------------------------------------
+        FILE ITERATOR
+    --------------------------------------------------------- */
+    async function iterate(
+        config: INestiaConfig,
+        outDir: string,
+        directory: Directory,
+    ): Promise<void> {
+        // CREATE A NEW DIRECTORY
+        try {
+            await fs.promises.mkdir(outDir);
+        } catch {}
+
+        // ITERATE CHILDREN
+        const content: string[] = [];
+        for (const it of directory.directories) {
+            await iterate(config, `${outDir}/${it.first}`, it.second);
+            content.push(`export * as ${it.first} from "./${it.first}";`);
+        }
+        if (content.length && directory.routes.length) content.push("");
+
+        // ITERATE ROUTES
+        const importDict: ImportDictionary = new ImportDictionary();
+        directory.routes.forEach((route, i) => {
+            for (const tuple of route.imports)
+                for (const instance of tuple[1])
+                    importDict.emplace(tuple[0], false, instance);
+
+            content.push(FunctionGenerator.generate(config, route));
+            if (i !== directory.routes.length - 1) content.push("");
+        });
+
+        // FINALIZE THE CONTENT
+        if (directory.routes.length !== 0) {
+            const primitived: boolean =
+                config.primitive !== false &&
+                directory.routes.some(
+                    (route) =>
+                        route.output.name !== "void" ||
+                        route.parameters.some(
+                            (param) => param.category !== "param",
+                        ),
+                );
+            const asserted: boolean =
+                config.assert === true &&
+                directory.routes.some((route) => route.parameters.length !== 0);
+            const json: boolean =
+                config.json === true &&
+                directory.routes.some(
+                    (route) =>
+                        route.method === "POST" ||
+                        route.method === "PUT" ||
+                        route.method === "PATCH",
+                );
+
+            const fetcher: string[] = ["Fetcher"];
+            if (primitived) fetcher.push("Primitive");
+
+            const head: string[] = [
+                `import { ${fetcher.join(", ")} } from "@nestia/fetcher";`,
+                `import type { IConnection } from "@nestia/fetcher";`,
+            ];
+            if (asserted || json) head.push(`import typia from "typia";`);
+            if (!importDict.empty()) head.push("", importDict.toScript(outDir));
+
+            content.push(...head, "", ...content.splice(0, content.length));
+        }
+
+        const script: string =
+            "/**\n" +
+            " * @packageDocumentation\n" +
+            ` * @module ${directory.module}\n` +
+            " * @nestia Generated by Nestia - https://github.com/samchon/nestia \n" +
+            " */\n" +
+            "//================================================================\n" +
+            content.join("\n");
+        await fs.promises.writeFile(`${outDir}/index.ts`, script, "utf8");
+    }
+}
+
+class Directory {
+    public readonly module: string;
+    public readonly directories: HashMap<string, Directory>;
+    public readonly routes: IRoute[];
+
+    public constructor(
+        readonly parent: Directory | null,
+        readonly name: string,
+    ) {
+        this.directories = new HashMap();
+        this.routes = [];
+        this.module =
+            this.parent !== null
+                ? `${this.parent.module}.${name}`
+                : `api.${name}`;
+    }
+}