@nestia/sdk 0.2.0 → 1.0.1

package/src/executable/internal/CommandParser.ts

@@ -1,15 +1,15 @@
-export namespace CommandParser {
-    export function parse(argList: string[]): Record<string, string> {
-        const output: Record<string, string> = {};
-        argList.forEach((arg, i) => {
-            if (arg.startsWith("--") === false) return;
-
-            const key = arg.slice(2);
-            const value: string | undefined = argList[i + 1];
-            if (value === undefined || value.startsWith("--")) return;
-
-            output[key] = value;
-        });
-        return output;
-    }
-}
+export namespace CommandParser {
+    export function parse(argList: string[]): Record<string, string> {
+        const output: Record<string, string> = {};
+        argList.forEach((arg, i) => {
+            if (arg.startsWith("--") === false) return;
+
+            const key = arg.slice(2);
+            const value: string | undefined = argList[i + 1];
+            if (value === undefined || value.startsWith("--")) return;
+
+            output[key] = value;
+        });
+        return output;
+    }
+}

package/src/executable/internal/NestiaConfigCompilerOptions.ts

@@ -1,18 +1,18 @@
-export namespace NestiaConfigCompilerOptions {
-    /* -----------------------------------------------------------
-        DEFAULT VALUES
-    ----------------------------------------------------------- */
-    const ESSENTIAL_OPTIONS = {
-        types: ["node", "reflect-metadata"],
-        noEmit: true,
-        esModuleInterop: true,
-        experimentalDecorators: true,
-        emitDecoratorMetadata: true,
-    };
-
-    export const DEFAULT_OPTIONS = {
-        ...ESSENTIAL_OPTIONS,
-        target: "es5",
-        module: "commonjs",
-    };
-}
+export namespace NestiaConfigCompilerOptions {
+    /* -----------------------------------------------------------
+        DEFAULT VALUES
+    ----------------------------------------------------------- */
+    const ESSENTIAL_OPTIONS = {
+        types: ["node", "reflect-metadata"],
+        noEmit: true,
+        esModuleInterop: true,
+        experimentalDecorators: true,
+        emitDecoratorMetadata: true,
+    };
+
+    export const DEFAULT_OPTIONS = {
+        ...ESSENTIAL_OPTIONS,
+        target: "es5",
+        module: "commonjs",
+    };
+}

package/src/executable/internal/NestiaSdkCommand.ts

@@ -1,174 +1,174 @@
-import cli from "cli";
-import path from "path";
-import { WorkerConnector } from "tgrid/protocols/workers/WorkerConnector";
-import { parseNative } from "tsconfck";
-import ts from "typescript";
-
-import { INestiaConfig } from "../../INestiaConfig";
-import { NestiaSdkApplication } from "../../NestiaSdkApplication";
-import { NestiaSdkConfig } from "./NestiaSdkConfig";
-
-interface ICommand {
-    exclude: string | null;
-    out: string | null;
-}
-
-interface IOutput {
-    assign: (config: INestiaConfig, output: string) => void;
-    validate: (config: INestiaConfig) => boolean;
-    location: (config: INestiaConfig) => string;
-}
-
-export namespace NestiaSdkCommand {
-    export function sdk(
-        elements: string[],
-        pure: boolean = true,
-    ): Promise<void> {
-        return main(
-            (app) => app.sdk(),
-            {
-                assign: (config, output) => (config.output = output),
-                validate: (config) => !!config.output,
-                location: (config) => config.output!,
-            },
-            elements,
-            pure,
-        );
-    }
-
-    export function swagger(
-        elements: string[],
-        pure: boolean = true,
-    ): Promise<void> {
-        return main(
-            (app) => app.swagger(),
-            {
-                assign: (config, output) => {
-                    if (!config.swagger) config.swagger = { output };
-                    else config.swagger.output = output;
-                },
-                validate: (config) =>
-                    !!config.swagger && !!config.swagger.output,
-                location: (config) => config.swagger!.output!,
-            },
-            elements,
-            pure,
-        );
-    }
-
-    async function main(
-        task: (app: NestiaSdkApplication) => Promise<void>,
-        output: IOutput,
-        elements: string[],
-        pure: boolean,
-    ): Promise<void> {
-        if (pure === false)
-            cli.setArgv([
-                process.argv[0],
-                process.argv[1],
-                "nestia",
-                ...elements,
-            ]);
-        const command: ICommand = cli.parse({
-            exclude: ["e", "Something to exclude", "string", null],
-            out: ["o", "Output path of the SDK files", "string", null],
-        });
-
-        const inputs: string[] = [];
-        for (const arg of elements) {
-            if (arg[0] === "-") break;
-            inputs.push(arg);
-        }
-        await generate(task, inputs, command, output);
-    }
-
-    async function generate(
-        task: (app: NestiaSdkApplication) => Promise<void>,
-        include: string[],
-        command: ICommand,
-        output: IOutput,
-    ): Promise<void> {
-        // CONFIGURATION
-        const config: INestiaConfig =
-            (await get_nestia_config(output.validate)) ??
-            parse_cli(include, command, output);
-
-        const options = await get_typescript_options();
-
-        config.compilerOptions = {
-            ...options,
-            ...(config.compilerOptions || {}),
-        };
-
-        // CALL THE APP.GENERATE()
-        const app: NestiaSdkApplication = new NestiaSdkApplication(config);
-        await task(app);
-    }
-
-    async function get_typescript_options(): Promise<ts.CompilerOptions | null> {
-        const configFileName = ts.findConfigFile(
-            process.cwd(),
-            ts.sys.fileExists,
-            "tsconfig.json",
-        );
-
-        if (!configFileName) return null;
-
-        const { tsconfig } = await parseNative(configFileName);
-
-        const configFileText = JSON.stringify(tsconfig);
-
-        const { config } = ts.parseConfigFileTextToJson(
-            configFileName,
-            configFileText,
-        );
-
-        const configParseResult = ts.parseJsonConfigFileContent(
-            config,
-            ts.sys,
-            path.dirname(configFileName),
-        );
-
-        const { moduleResolution, ...result } =
-            configParseResult.raw.compilerOptions;
-        return result;
-    }
-
-    async function get_nestia_config(
-        validate: (config: INestiaConfig) => boolean,
-    ): Promise<INestiaConfig | null> {
-        const connector = new WorkerConnector(null, null, "process");
-        await connector.connect(`${__dirname}/nestia.config.getter.js`);
-
-        const driver = await connector.getDriver<typeof NestiaSdkConfig>();
-        const config: INestiaConfig | null = await driver.get();
-        await connector.close();
-
-        if (config !== null && validate(config) === false)
-            throw new Error(
-                `Error on NestiaCommand.main(): output path is not specified in the "nestia.config.ts".`,
-            );
-
-        return config;
-    }
-
-    function parse_cli(
-        include: string[],
-        command: ICommand,
-        output: IOutput,
-    ): INestiaConfig {
-        if (command.out === null)
-            throw new Error(
-                `Error on NestiaCommand.main(): output directory is not specified. Add the "--out <output_directory>" option.`,
-            );
-
-        const config: INestiaConfig = {
-            input: {
-                include,
-                exclude: command.exclude ? [command.exclude] : undefined,
-            },
-        };
-        output.assign(config, command.out);
-        return config;
-    }
-}
+import cli from "cli";
+import path from "path";
+import { WorkerConnector } from "tgrid/protocols/workers/WorkerConnector";
+import { parseNative } from "tsconfck";
+import ts from "typescript";
+
+import { INestiaConfig } from "../../INestiaConfig";
+import { NestiaSdkApplication } from "../../NestiaSdkApplication";
+import { NestiaSdkConfig } from "./NestiaSdkConfig";
+
+interface ICommand {
+    exclude: string | null;
+    out: string | null;
+}
+
+interface IOutput {
+    assign: (config: INestiaConfig, output: string) => void;
+    validate: (config: INestiaConfig) => boolean;
+    location: (config: INestiaConfig) => string;
+}
+
+export namespace NestiaSdkCommand {
+    export function sdk(
+        elements: string[],
+        pure: boolean = true,
+    ): Promise<void> {
+        return main(
+            (app) => app.sdk(),
+            {
+                assign: (config, output) => (config.output = output),
+                validate: (config) => !!config.output,
+                location: (config) => config.output!,
+            },
+            elements,
+            pure,
+        );
+    }
+
+    export function swagger(
+        elements: string[],
+        pure: boolean = true,
+    ): Promise<void> {
+        return main(
+            (app) => app.swagger(),
+            {
+                assign: (config, output) => {
+                    if (!config.swagger) config.swagger = { output };
+                    else config.swagger.output = output;
+                },
+                validate: (config) =>
+                    !!config.swagger && !!config.swagger.output,
+                location: (config) => config.swagger!.output!,
+            },
+            elements,
+            pure,
+        );
+    }
+
+    async function main(
+        task: (app: NestiaSdkApplication) => Promise<void>,
+        output: IOutput,
+        elements: string[],
+        pure: boolean,
+    ): Promise<void> {
+        if (pure === false)
+            cli.setArgv([
+                process.argv[0],
+                process.argv[1],
+                "nestia",
+                ...elements,
+            ]);
+        const command: ICommand = cli.parse({
+            exclude: ["e", "Something to exclude", "string", null],
+            out: ["o", "Output path of the SDK files", "string", null],
+        });
+
+        const inputs: string[] = [];
+        for (const arg of elements) {
+            if (arg[0] === "-") break;
+            inputs.push(arg);
+        }
+        await generate(task, inputs, command, output);
+    }
+
+    async function generate(
+        task: (app: NestiaSdkApplication) => Promise<void>,
+        include: string[],
+        command: ICommand,
+        output: IOutput,
+    ): Promise<void> {
+        // CONFIGURATION
+        const config: INestiaConfig =
+            (await get_nestia_config(output.validate)) ??
+            parse_cli(include, command, output);
+
+        const options = await get_typescript_options();
+
+        config.compilerOptions = {
+            ...options,
+            ...(config.compilerOptions || {}),
+        };
+
+        // CALL THE APP.GENERATE()
+        const app: NestiaSdkApplication = new NestiaSdkApplication(config);
+        await task(app);
+    }
+
+    async function get_typescript_options(): Promise<ts.CompilerOptions | null> {
+        const configFileName = ts.findConfigFile(
+            process.cwd(),
+            ts.sys.fileExists,
+            "tsconfig.json",
+        );
+
+        if (!configFileName) return null;
+
+        const { tsconfig } = await parseNative(configFileName);
+
+        const configFileText = JSON.stringify(tsconfig);
+
+        const { config } = ts.parseConfigFileTextToJson(
+            configFileName,
+            configFileText,
+        );
+
+        const configParseResult = ts.parseJsonConfigFileContent(
+            config,
+            ts.sys,
+            path.dirname(configFileName),
+        );
+
+        const { moduleResolution, ...result } =
+            configParseResult.raw.compilerOptions;
+        return result;
+    }
+
+    async function get_nestia_config(
+        validate: (config: INestiaConfig) => boolean,
+    ): Promise<INestiaConfig | null> {
+        const connector = new WorkerConnector(null, null, "process");
+        await connector.connect(`${__dirname}/nestia.config.getter.js`);
+
+        const driver = await connector.getDriver<typeof NestiaSdkConfig>();
+        const config: INestiaConfig | null = await driver.get();
+        await connector.close();
+
+        if (config !== null && validate(config) === false)
+            throw new Error(
+                `Error on NestiaCommand.main(): output path is not specified in the "nestia.config.ts".`,
+            );
+
+        return config;
+    }
+
+    function parse_cli(
+        include: string[],
+        command: ICommand,
+        output: IOutput,
+    ): INestiaConfig {
+        if (command.out === null)
+            throw new Error(
+                `Error on NestiaCommand.main(): output directory is not specified. Add the "--out <output_directory>" option.`,
+            );
+
+        const config: INestiaConfig = {
+            input: {
+                include,
+                exclude: command.exclude ? [command.exclude] : undefined,
+            },
+        };
+        output.assign(config, command.out);
+        return config;
+    }
+}

package/src/executable/internal/NestiaSdkConfig.ts

@@ -1,35 +1,35 @@
-import fs from "fs";
-import path from "path";
-import * as runner from "ts-node";
-import { Singleton } from "tstl/thread/Singleton";
-import { assert } from "typia";
-
-import { INestiaConfig } from "../../INestiaConfig";
-
-export namespace NestiaSdkConfig {
-    export function get(): Promise<INestiaConfig | null> {
-        return singleton.get();
-    }
-
-    const singleton = new Singleton(async () => {
-        if (fs.existsSync("nestia.config.ts") === false) return null;
-
-        runner.register({
-            emit: false,
-            compilerOptions: {
-                module: "CommonJS",
-                noEmit: true,
-            },
-        });
-
-        const loaded: INestiaConfig & { default?: INestiaConfig } =
-            await import(path.resolve("nestia.config.ts"));
-        if (typeof loaded !== "object")
-            throw new Error("Error on NestiaConfig.get(): failed to load data");
-
-        const config: INestiaConfig =
-            typeof loaded.default === "object" ? loaded.default : loaded;
-        const cloned: INestiaConfig = JSON.parse(JSON.stringify(config));
-        return assert(cloned);
-    });
-}
+import fs from "fs";
+import path from "path";
+import * as runner from "ts-node";
+import { Singleton } from "tstl/thread/Singleton";
+import { assert } from "typia";
+
+import { INestiaConfig } from "../../INestiaConfig";
+
+export namespace NestiaSdkConfig {
+    export function get(): Promise<INestiaConfig | null> {
+        return singleton.get();
+    }
+
+    const singleton = new Singleton(async () => {
+        if (fs.existsSync("nestia.config.ts") === false) return null;
+
+        runner.register({
+            emit: false,
+            compilerOptions: {
+                module: "CommonJS",
+                noEmit: true,
+            },
+        });
+
+        const loaded: INestiaConfig & { default?: INestiaConfig } =
+            await import(path.resolve("nestia.config.ts"));
+        if (typeof loaded !== "object")
+            throw new Error("Error on NestiaConfig.get(): failed to load data");
+
+        const config: INestiaConfig =
+            typeof loaded.default === "object" ? loaded.default : loaded;
+        const cloned: INestiaConfig = JSON.parse(JSON.stringify(config));
+        return assert(cloned);
+    });
+}

package/src/executable/internal/nestia.config.getter.ts

@@ -1,12 +1,12 @@
-import { WorkerServer } from "tgrid/protocols/workers/WorkerServer";
-
-import { NestiaSdkConfig } from "./NestiaSdkConfig";
-
-async function main(): Promise<void> {
-    const worker = new WorkerServer();
-    await worker.open(NestiaSdkConfig);
-}
-main().catch((exp) => {
-    console.log(exp);
-    process.exit(-1);
-});
+import { WorkerServer } from "tgrid/protocols/workers/WorkerServer";
+
+import { NestiaSdkConfig } from "./NestiaSdkConfig";
+
+async function main(): Promise<void> {
+    const worker = new WorkerServer();
+    await worker.open(NestiaSdkConfig);
+}
+main().catch((exp) => {
+    console.log(exp);
+    process.exit(-1);
+});

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