@nestia/core 1.0.10 → 1.0.12

package/src/executable/internal/ArgumentParser.ts

@@ -0,0 +1,146 @@
+import type CommanderModule from "commander";
+import fs from "fs";
+import type * as InquirerModule from "inquirer";
+import path from "path";
+import { FileRetriever } from "./FileRetriever";
+
+import { PackageManager } from "./PackageManager";
+
+export namespace ArgumentParser {
+    export interface IArguments {
+        compiler: "ts-patch" | "ttypescript";
+        manager: "npm" | "pnpm" | "yarn";
+        project: string | null;
+    }
+
+    export async function parse(pack: PackageManager): Promise<IArguments> {
+        // INSTALL TEMPORARY PACKAGES
+        const newbie = {
+            commander: pack.install({
+                dev: true,
+                modulo: "commander",
+                version: "10.0.0",
+                silent: true,
+            }),
+            inquirer: pack.install({
+                dev: true,
+                modulo: "inquirer",
+                version: "8.2.5",
+                silent: true,
+            }),
+        };
+
+        // TAKE OPTIONS
+        const output: IArguments | Error = await (async () => {
+            try {
+                return await _Parse(pack);
+            } catch (error) {
+                return error as Error;
+            }
+        })();
+
+        // REMOVE TEMPORARY PACKAGES
+        if (newbie.commander) pack.erase({ modulo: "commander", silent: true });
+        if (newbie.inquirer) pack.erase({ modulo: "inquirer", silent: true });
+
+        // RETURNS
+        if (output instanceof Error) throw output;
+        return output;
+    }
+
+    async function _Parse(pack: PackageManager): Promise<IArguments> {
+        // PREPARE ASSETS
+        const { createPromptModule }: typeof InquirerModule =
+            await FileRetriever.require(path.join("node_modules", "inquirer"))(
+                pack.directory,
+            );
+        const { program }: typeof CommanderModule = await FileRetriever.require(
+            path.join("node_modules", "commander"),
+        )(pack.directory);
+
+        program.option("--compiler [compiler]", "compiler type");
+        program.option("--manager [manager", "package manager");
+        program.option("--project [project]", "tsconfig.json file location");
+
+        // INTERNAL PROCEDURES
+        const questioned = { value: false };
+        const action = (
+            closure: (options: Partial<IArguments>) => Promise<IArguments>,
+        ) => {
+            return new Promise<IArguments>((resolve, reject) => {
+                program.action(async (options) => {
+                    try {
+                        resolve(await closure(options));
+                    } catch (exp) {
+                        reject(exp);
+                    }
+                });
+                program.parseAsync().catch(reject);
+            });
+        };
+        const select =
+            (name: string) =>
+            (message: string) =>
+            async <Choice extends string>(
+                choices: Choice[],
+            ): Promise<Choice> => {
+                questioned.value = true;
+                return (
+                    await createPromptModule()({
+                        type: "list",
+                        name: name,
+                        message: message,
+                        choices: choices,
+                    })
+                )[name];
+            };
+        const configure = async () => {
+            const fileList: string[] = await (
+                await fs.promises.readdir(process.cwd())
+            ).filter(
+                (str) =>
+                    str.substring(0, 8) === "tsconfig" &&
+                    str.substring(str.length - 5) === ".json",
+            );
+            if (fileList.length === 0) {
+                if (process.cwd() !== pack.directory)
+                    throw new Error(`Unable to find "tsconfig.json" file.`);
+                return null;
+            } else if (fileList.length === 1) return fileList[0];
+            return select("tsconfig")("TS Config File")(fileList);
+        };
+
+        // DO CONSTRUCT
+        return action(async (options) => {
+            if (options.compiler === undefined) {
+                console.log(COMPILER_DESCRIPTION);
+                options.compiler = await select("compiler")(`Compiler`)(
+                    pack.data.scripts?.build === "nest build"
+                        ? ["ts-patch" as const, "ttypescript" as const]
+                        : ["ttypescript" as const, "ts-patch" as const],
+                );
+            }
+            options.manager ??= await select("manager")("Package Manager")([
+                "npm" as const,
+                "pnpm" as const,
+                "yarn" as const,
+            ]);
+            pack.manager = options.manager;
+            options.project ??= await configure();
+
+            if (questioned.value) console.log("");
+            return options as IArguments;
+        });
+    }
+}
+
+const COMPILER_DESCRIPTION = [
+    `About compiler, if you adapt "ttypescript", you should use "ttsc" instead.`,
+    ``,
+    `Otherwise, you choose "ts-patch", you can use the original "tsc" command.`,
+    `However, the "ts-patch" hacks "node_modules/typescript" source code.`,
+    `Also, whenever update "typescript", you've to run "npm run prepare" command.`,
+    ``,
+    `By the way, when using "@nest/cli", you must just choose "ts-patch".`,
+    ``,
+].join("\n");

package/src/executable/internal/CommandExecutor.ts

@@ -0,0 +1,8 @@
+import cp from "child_process";
+
+export namespace CommandExecutor {
+    export function run(str: string, silent: boolean): void {
+        if (silent === false) console.log(str);
+        cp.execSync(str, { stdio: "ignore" });
+    }
+}

package/src/executable/internal/FileRetriever.ts

@@ -0,0 +1,33 @@
+import fs from "fs";
+import path from "path";
+
+export namespace FileRetriever {
+    export const directory =
+        (name: string) =>
+        (directory: string, depth: number = 0): string | null => {
+            const location: string = path.join(directory, name);
+            if (fs.existsSync(location)) return directory;
+            else if (depth > 2) return null;
+            return file(name)(path.join(directory, ".."), depth + 1);
+        };
+
+    export const file =
+        (name: string) =>
+        (directory: string, depth: number = 0): string | null => {
+            const location: string = path.join(directory, name);
+            if (fs.existsSync(location)) return location;
+            else if (depth > 2) return null;
+            return file(name)(path.join(directory, ".."), depth + 1);
+        };
+
+    export const require =
+        (name: string) =>
+        async (directory: string, depth: number = 0) => {
+            const location: string | null = file(name)(directory, depth);
+            if (location === null)
+                throw new Error(
+                    `Unable to find installed module. Please report to the nestia - https://github.com/samchon/nestia/issues`,
+                );
+            return import(location);
+        };
+}

package/src/executable/internal/PackageManager.ts

@@ -0,0 +1,92 @@
+import fs from "fs";
+import path from "path";
+
+import { CommandExecutor } from "./CommandExecutor";
+import { FileRetriever } from "./FileRetriever";
+
+export class PackageManager {
+    public manager: string = "npm";
+    public get file(): string {
+        return path.join(this.directory, "package.json");
+    }
+
+    public static async mount(): Promise<PackageManager> {
+        const location: string | null = await FileRetriever.directory(
+            "package.json",
+        )(process.cwd());
+        if (location === null)
+            throw new Error(`Unable to find "package.json" file`);
+
+        return new PackageManager(
+            location,
+            await this.load(path.join(location, "package.json")),
+        );
+    }
+
+    public async save(modifier: (data: Package.Data) => void): Promise<void> {
+        const content: string = await fs.promises.readFile(this.file, "utf8");
+        this.data = JSON.parse(content);
+        modifier(this.data);
+
+        return fs.promises.writeFile(
+            this.file,
+            JSON.stringify(this.data, null, 2),
+            "utf8",
+        );
+    }
+
+    public install(props: {
+        dev: boolean;
+        silent?: boolean;
+        modulo: string;
+        version?: string;
+    }): boolean {
+        const container = props.dev
+            ? this.data.devDependencies
+            : this.data.dependencies;
+        if (
+            !!container?.[props.modulo] &&
+            FileRetriever.file(path.join("node_modules", props.modulo))(
+                this.directory,
+            ) !== null
+        )
+            return false;
+
+        const middle: string =
+            this.manager === "yarn"
+                ? `add${props.dev ? " -D" : ""}`
+                : `install ${props.dev ? "--save-dev" : "--save"}`;
+        CommandExecutor.run(
+            `${this.manager} ${middle} ${props.modulo}${
+                props.version ? `@${props.version}` : ""
+            }`,
+            !!props.silent,
+        );
+        return true;
+    }
+
+    public erase(props: { modulo: string; silent?: boolean }): void {
+        const middle: string = this.manager === "yarn" ? "remove" : "uninstall";
+        CommandExecutor.run(
+            `${this.manager} ${middle} ${props.modulo}`,
+            !!props.silent,
+        );
+    }
+
+    private constructor(
+        public readonly directory: string,
+        public data: Package.Data,
+    ) {}
+
+    private static async load(file: string): Promise<Package.Data> {
+        const content: string = await fs.promises.readFile(file, "utf8");
+        return JSON.parse(content);
+    }
+}
+export namespace Package {
+    export interface Data {
+        scripts?: Record<string, string>;
+        dependencies?: Record<string, string>;
+        devDependencies?: Record<string, string>;
+    }
+}

package/src/executable/internal/PluginConfigurator.ts

@@ -0,0 +1,130 @@
+import type Comment from "comment-json";
+import fs from "fs";
+import path from "path";
+
+import { ArgumentParser } from "./ArgumentParser";
+import { FileRetriever } from "./FileRetriever";
+import { PackageManager } from "./PackageManager";
+
+export namespace PluginConfigurator {
+    export async function configure(
+        pack: PackageManager,
+        args: ArgumentParser.IArguments,
+    ): Promise<void> {
+        // INSTALL COMMENT-JSON
+        const installed: boolean = pack.install({
+            dev: true,
+            modulo: "comment-json",
+            version: "4.2.3",
+            silent: true,
+        });
+
+        // DO CONFIGURE
+        const error: Error | null = await (async () => {
+            try {
+                await _Configure(pack, args);
+                return null;
+            } catch (exp) {
+                return exp as Error;
+            }
+        })();
+
+        // REMOVE IT
+        if (installed)
+            pack.erase({
+                modulo: "comment-json",
+                silent: true,
+            });
+        if (error !== null) throw error;
+    }
+
+    async function _Configure(
+        pack: PackageManager,
+        args: ArgumentParser.IArguments,
+    ): Promise<void> {
+        // GET COMPILER-OPTIONS
+        const Comment: typeof import("comment-json") =
+            await FileRetriever.require(
+                path.join("node_modules", "comment-json"),
+            )(pack.directory);
+
+        const config: Comment.CommentObject = Comment.parse(
+            await fs.promises.readFile(args.project!, "utf8"),
+        ) as Comment.CommentObject;
+        const compilerOptions = config.compilerOptions as
+            | Comment.CommentObject
+            | undefined;
+        if (compilerOptions === undefined)
+            throw new Error(
+                `${args.project} file does not have "compilerOptions" property.`,
+            );
+
+        // PREPARE PLUGINS
+        const plugins: Comment.CommentArray<Comment.CommentObject> = (() => {
+            const plugins = compilerOptions.plugins as
+                | Comment.CommentArray<Comment.CommentObject>
+                | undefined;
+            if (plugins === undefined)
+                return (compilerOptions.plugins = [] as any);
+            else if (!Array.isArray(plugins))
+                throw new Error(
+                    `"plugins" property of ${args.project} must be array type.`,
+                );
+            return plugins;
+        })();
+
+        // CHECK WHETHER CONFIGURED
+        const strict: boolean = compilerOptions.strict === true;
+        const core: Comment.CommentObject | undefined = plugins.find(
+            (p) =>
+                typeof p === "object" &&
+                p !== null &&
+                p.transform === "@nestia/core/lib/transform",
+        );
+        const typia: Comment.CommentObject | undefined = plugins.find(
+            (p) =>
+                typeof p === "object" &&
+                p !== null &&
+                p.transform === "typia/lib/transform",
+        );
+        if (strict && !!core && !!typia) return;
+
+        // DO CONFIGURE
+        compilerOptions.strict = true;
+        if (core === undefined)
+            plugins.push(
+                Comment.parse(`{
+                    "transform": "@nestia/core/lib/transform",
+        /**
+         * Validate request body.
+         * 
+         *   - "assert": Use typia.assert() function
+         *   - "is": Use typia.is() function
+         *   - "validate": Use typia.validate() function
+         */
+                            "validate": "assert",
+
+        /**
+         * Validate JSON typed response body.
+         * 
+         *   - null: Just use JSON.stringify() function, without boosting
+         *   - "stringify": Use typia.stringify() function, but dangerous
+         *   - "assert": Use typia.assertStringify() function
+         *   - "is": Use typia.isStringify() function
+         *   - "validate": Use typia.validateStringify() function
+         */
+                    "stringify": "is"
+                }`) as Comment.CommentObject,
+            );
+        if (typia === undefined)
+            plugins.push(
+                Comment.parse(
+                    `{ "transform": "typia/lib/transform" }`,
+                ) as Comment.CommentObject,
+            );
+        await fs.promises.writeFile(
+            args.project!,
+            Comment.stringify(config, null, 2),
+        );
+    }
+}

package/lib/executable/internal/CommandParser.d.ts

@@ -1,3 +0,0 @@
-export declare namespace CommandParser {
-    function parse(argList: string[]): Record<string, string>;
-}

package/lib/executable/internal/CommandParser.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CommandParser = void 0;
-var CommandParser;
-(function (CommandParser) {
-    function parse(argList) {
-        var output = {};
-        argList.forEach(function (arg, i) {
-            if (arg.startsWith("--") === false)
-                return;
-            var key = arg.slice(2);
-            var value = argList[i + 1];
-            if (value === undefined || value.startsWith("--"))
-                return;
-            output[key] = value;
-        });
-        return output;
-    }
-    CommandParser.parse = parse;
-})(CommandParser = exports.CommandParser || (exports.CommandParser = {}));
-//# sourceMappingURL=CommandParser.js.map

package/lib/executable/internal/CommandParser.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CommandParser.js","sourceRoot":"","sources":["../../../src/executable/internal/CommandParser.ts"],"names":[],"mappings":";;;AAAA,IAAiB,aAAa,CAc7B;AAdD,WAAiB,aAAa;IAC1B,SAAgB,KAAK,CAAC,OAAiB;QACnC,IAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,OAAO,CAAC,OAAO,CAAC,UAAC,GAAG,EAAE,CAAC;YACnB,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,KAAK;gBAAE,OAAO;YAE3C,IAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACzB,IAAM,KAAK,GAAuB,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,OAAO;YAE1D,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAClB,CAAC;IAZe,mBAAK,QAYpB,CAAA;AACL,CAAC,EAdgB,aAAa,GAAb,qBAAa,KAAb,qBAAa,QAc7B"}

package/lib/executable/internal/CoreSetupWizard.d.ts

@@ -1,8 +0,0 @@
-export declare namespace CoreSetupWizard {
-    interface IArguments {
-        manager: "npm" | "pnpm" | "yarn";
-        project: string;
-    }
-    function ttypescript(args: string | IArguments): Promise<void>;
-    function tsPatch(args: string | IArguments): Promise<void>;
-}