nestia 1.0.0 → 2.0.0-dev.20220413-2

package/.github/FUNDING.yml

@@ -0,0 +1,3 @@
+# These are supported funding model platforms
+
+open_collective: nestia

package/README.md

@@ -7,8 +7,14 @@ Automatic SDK generator for the NestJS.
 [![Build Status](https://github.com/samchon/nestia/workflows/build/badge.svg)](https://github.com/samchon/nestia/actions?query=workflow%3Abuild)
 
 ```bash
+# INSTALL NESTIA
 npm install --save-dev nestia
+
+# WHEN ALL OF THE CONTROLLRES ARE GATHERED INTO A DIRECTORY
 npx nestia sdk "src/controller" --out "src/api"
+
+# REGULAR NESTJS PATTERN
+npx nestia sdk "src/**/*.controller.ts" --out "src/api"
 ```
 
 Don't write any `swagger` comment. Just deliver the SDK.
@@ -60,13 +66,15 @@ Just type the `npm install --save-dev nestia` command in your NestJS backend pro
 ```bash
 npx nestia sdk <source_controller_directory> --out <output_sdk_directory>
 
+npx nestia sdk "src/**/*.controller.ts" --out "src/api"
 npx nestia sdk "src/controllers" --out "src/api"
-npx nestia sdk "src/controllers/consumers" "src/controllers/sellers" --out "src/api
+npx nestia sdk "src/controllers/consumers" "src/controllers/sellers" --out "src/api"
+npx nestia sdk "src/controllers" --exclude "src/**/Fake*.ts" --out "src/api"
 ```
 
 To generate a SDK library through the **Nestia** is very easy. 
 
-Just type the `nestia sdk <input> --out <output>` command in the console. If there're multiple source directories containing the NestJS controller classes, type all of them separating by a `space` word.
+Just type the `nestia sdk <input> --out <output>` command in the console. When there're multiple source directories containing the NestJS controller classes, type all of them separating by a `space` word. If you want to exclude some directories or files from the SDK generation, the `--exclude` option would be useful.
 
 Also, when generating a SDK using the cli options, `compilerOptions` would follow the `tsconfig.json`, that is configured for the backend server. If no `tsconfig.json` file exists in your project, the configuration would be default option (`ES5` with `strict` mode). If you want to use different `compilerOptions` with the `tsconfig.json`, you should configure the [nestia.config.ts](#nestiaconfigts).
 
@@ -89,26 +97,38 @@ Therefore, when you publish an SDK library generated by this **Nestia**, you hav
 ## Advanced
 ### `nestia.config.ts`
 ```typescript
-export namespace NestiaApplication
+export interface IConfiguration
 {
-    export interface IConfiguration
-    {
-        /**
-         * List of directories containing the NestJS controller classes.
-         */
-        input: string | string[];
+    /**
+     * List of files or directories containing the NestJS controller classes.
+     */
+    input: string | string[] | IConfiguration.IInput;
 
+    /**
+     * Output directory that SDK would be placed in.
+     */
+    output: string;
+
+    /**
+     * Compiler options for the TypeScript.
+     * 
+     * If omitted, the configuration would follow the `tsconfig.json`.
+     */
+    compilerOptions?: tsc.CompilerOptions
+}
+export namespace IConfiguration
+{
+    export interface IInput
+    {
         /**
-         * Output directory that SDK would be placed in.
+         * List of files or directories containing the NestJS controller classes.
          */
-        output: string;
+        include: string[];
 
         /**
-         * Compiler options for the TypeScript.
-         * 
-         * If omitted, the configuration would follow the `tsconfig.json`.
+         * List of files or directories to be excluded.
          */
-        compilerOptions?: tsc.CompilerOptions
+        exclude: string[];
     }
 }
 ```
@@ -119,11 +139,24 @@ Write below content as the `nestia.config.ts` file and place it onto the root di
 
 ```typescript
 export = {
-    input: "src/controllers`",
+    input: "src/controllers",
     output: "src/api"
 };
 ```
 
+> Alternative options for the regular NestJS project:
+> 
+> ```typescript
+> export = {
+>     input: "src/**/*.controller.ts",
+>     /* input: {
+>         include: ["src/controllers/*.controller.ts"],
+>         exclude: ["src/controllers/fake_*.controller.ts"]
+>     },*/
+>     output: "src/api"   
+> }
+> ```
+
 
 
 ### Recommended Structures
@@ -214,18 +247,15 @@ export function store
         connection: IConnection,
         section: string,
         saleId: number,
-        input: store.Input
+        input: Primitive<store.Input>
     ): Promise<store.Output>
 {
     return Fetcher.fetch
     (
         connection,
-        {
-            input_encrypted: false,
-            output_encrypted: false
-        },
-        "POST",
-        `/consumers/${section}/sales/${saleId}/questions/`,
+        store.ENCRYPTED,
+        store.METHOD,
+        store.path(section, saleId),
         input
     );
 }
@@ -233,6 +263,18 @@ export namespace store
 {
     export type Input = Primitive<ISaleInquiry.IStore>;
     export type Output = Primitive<ISaleInquiry<ISaleArticle.IContent>>;
+
+    export const METHOD = "POST" as const;
+    export const PATH: string = "/consumers/:section/sales/:saleId/questions";
+    export const ENCRYPTED: Fetcher.IEncrypted = {
+        request: true,
+        response: true,
+    };
+
+    export function path(section: string, saleId: number): string
+    {
+        return `/consumers/${section}/sales/${saleId}/questions`;
+    }
 }
 ```
 
@@ -240,26 +282,55 @@ export namespace store
 
 
 ## Appendix
-### Safe-TypeORM
-https://github.com/samchon/safe-typeorm
+### Template Project
+https://github.com/samchon/backend
 
-[safe-typeorm](https://github.com/samchon/safe-typeorm) is another library that what I've developed, helping typeorm in the compilation level and optimizes DB performance automatically without any extra dedication.
+I support template backend project using this **Nestia*** library, [backend](https://github.com/samchon/backend).
 
-Therefore, this **Nestia** makes you to be much convenient in the API interaction level and safe-typeorm helps you to be much convenient in the DB interaction level. With those **Nestia** and [safe-typeorm](https://github.com/samchon/safe-typeorm), let's implement the backend server much easily and conveniently.
+Also, reading the README content of the [backend](https://github.com/samchon/backend) template repository, you can find lots of example backend projects who've been generated from the [backend](https://github.com/samchon/backend). Furthermore, the example projects guide how to generate SDK library from the **Nestia** and how to distribute the SDK library thorugh the NPM module.
+
+Therefore, if you're planning to compose your own backend project using this **Nestia**, I recommend you to create the repository and learn from the [backend](https://github.com/samchon/backend) template project.
+
+### Nestia-Helper
+https://github.com/samchon/nestia-helper
 
-### Technial Support
-samchon.github@gmail.com
+Helper library of the `NestJS` with **Nestia**.
 
-I can provide technical support about those **Nestia** and [safe-typeorm](https://github.com/samchon/safe-typeorm). 
+[nestia-helper](https://github.com/samchon/nestia-helper) is a type of helper library for `Nestia` by enhancing decorator functions. Also, all of the decorator functions provided by this [nestia-helper](https://github.com/samchon/nestia-helper) are all fully compatible with the **Nestia**, who can generate SDK library by analyzing NestJS controller classes in the compilation level.
 
-Therefore, if you have any question or need help, feel free to contact me. If you want to adapt those **Nestia** and [safe-typeorm](https://github.com/samchon/safe-typeorm) in your commercial project, I can provide you the best guidance. 
+Of course, this [nestia-helper](https://github.com/samchon/nestia-helper) is not essential for utilizing the `NestJS` and **Nestia**. You can generate SDK library of your NestJS developed backend server without this [nestia-helper](https://github.com/samchon/nestia-helper). However, as decorator functions of this [nestia-helper](https://github.com/samchon/nestia-helper) is enough strong, I recommend you to adapt this [nestia-helper](https://github.com/samchon/nestia-helper) when using `NestJS` and **Nestia**.
 
-I also can help your backend project in the entire development level. If you're suffering by DB architecture design or API structure design, just contact me and get help. I'll help you with my best effort.
+  - Supported decorator functions
+    - [EncryptedController](https://github.com/samchon/nestia-helper#encryptedcontroller), [EncryptedModule](https://github.com/samchon/nestia-helper#encryptedmodule)
+    - [TypedRoute](https://github.com/samchon/nestia-helper#typedroute), [EncryptedRoute](https://github.com/samchon/nestia-helper#encryptedroute)
+    - [TypedParam](https://github.com/samchon/nestia-helper#typedparam), [EncryptedBody](https://github.com/samchon/nestia-helper#encryptedbody), [PlainBody](https://github.com/samchon/nestia-helper#plainbody)
+    - [ExceptionManager](https://github.com/samchon/nestia-helper#exceptionmanager)
+
+### Safe-TypeORM
+https://github.com/samchon/safe-typeorm
+
+[safe-typeorm](https://github.com/samchon/safe-typeorm) is another library that what I've developed, helping `TypeORM` in the compilation level and optimizes DB performance automatically without any extra dedication.
+
+Therefore, this **Nestia** makes you to be much convenient in the API interaction level and safe-typeorm helps you to be much convenient in the DB interaction level. With those **Nestia** and [safe-typeorm](https://github.com/samchon/safe-typeorm), let's implement the backend server much easily and conveniently.
+
+  - When writing [**SQL query**](https://github.com/samchon/safe-typeorm#safe-query-builder),
+    - Errors would be detected in the **compilation** level
+    - **Auto Completion** would be provided
+    - **Type Hint** would be supported
+  - You can implement [**App-join**](https://github.com/samchon/safe-typeorm#app-join-builder) very conveniently
+  - When [**SELECT**ing for **JSON** conversion](https://github.com/samchon/safe-typeorm#json-select-builder)
+    - [**App-Join**](https://github.com/samchon/safe-typeorm#app-join-builder) with the related entities would be automatically done
+    - Exact JSON **type** would be automatically **deduced**
+    - The **performance** would be **automatically tuned**
+  - When [**INSERT**](https://github.com/samchon/safe-typeorm#insert-collection)ing records
+    - Sequence of tables would be automatically sorted by analyzing dependencies
+    - The **performance** would be **automatically tuned**
+
+![Safe-TypeORM Demo](https://raw.githubusercontent.com/samchon/safe-typeorm/master/assets/demonstrations/safe-query-builder.gif)
 
 ### Archidraw
 https://www.archisketch.com/
 
 I have special thanks to the Archidraw, where I'm working for.
 
-The Archidraw is a great IT company developing 3D interior editor and lots of solutions based on the 3D assets. Also, the Archidraw is the first company who had adopted this **Nestia** on their commercial backend project, even this **Nestia** was in the alpha level.
-
+The Archidraw is a great IT company developing 3D interior editor and lots of solutions based on the 3D assets. Also, the Archidraw is the first company who had adopted this **Nestia** on their commercial backend project, even this **Nestia** was in the alpha level.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nestia",
-  "version": "1.0.0",
+  "version": "2.0.0-dev.20220413-2",
   "description": "Automatic SDK and Document generator for the NestJS",
   "main": "src/index.ts",
   "bin": {
@@ -30,16 +30,21 @@
   "homepage": "https://github.com/samchon/nestia#readme",
   "dependencies": {
     "@types/cli": "^0.11.19",
-    "@types/node": "^14.14.22",
+    "@types/glob": "^7.2.0",
+    "@types/node": "^17.0.23",
     "@types/reflect-metadata": "^0.1.0",
     "cli": "^1.0.1",
     "del": "^6.0.0",
+    "glob": "^7.2.0",
     "ts-node": "^9.1.1",
-    "tstl": "^2.5.0",
-    "typescript": "^4.3.2"
+    "tstl": "^2.5.3",
+    "ttypescript": "^1.5.13",
+    "typescript": "^4.6.3",
+    "typescript-is": "^0.19.0",
+    "typescript-transform-paths": "^3.3.1"
   },
   "devDependencies": {
-    "nestia-helper": "^1.0.0",
+    "nestia-helper": "^2.0.0",
     "rimraf": "^3.0.2"
   }
 }

package/src/IConfiguration.ts

@@ -0,0 +1,17 @@
+import type tsc from "typescript";
+
+export interface IConfiguration
+{
+    input: string | string[] | IConfiguration.IInput;
+    output: string;
+    compilerOptions?: tsc.CompilerOptions;
+    assert?: boolean;
+}
+export namespace IConfiguration
+{
+    export interface IInput
+    {
+        include: string[];
+        exclude?: string[];
+    }
+}

package/src/NestiaApplication.ts

@@ -1,6 +1,6 @@
-import * as fs from "fs";
-import * as path from "path";
-import * as tsc from "typescript";
+import fs from "fs";
+import path from "path";
+import tsc from "typescript";
 import { Pair } from "tstl/utility/Pair";
 import { Singleton } from "tstl/thread/Singleton";
 
@@ -9,16 +9,17 @@ import { ReflectAnalyzer } from "./analyses/ReflectAnalyzer";
 import { SourceFinder } from "./analyses/SourceFinder";
 import { SdkGenerator } from "./generates/SdkGenerator";
 
+import { IConfiguration } from "./IConfiguration";
 import { IController } from "./structures/IController";
 import { IRoute } from "./structures/IRoute";
 import { ArrayUtil } from "./utils/ArrayUtil";
 
 export class NestiaApplication
 {
-    private readonly config_: NestiaApplication.IConfiguration;
+    private readonly config_: IConfiguration;
     private readonly bundle_checker_: Singleton<Promise<(str: string) => boolean>>;
 
-    public constructor(config: NestiaApplication.IConfiguration)
+    public constructor(config: IConfiguration)
     {
         this.config_ = config;
         this.bundle_checker_ = new Singleton(async () =>
@@ -47,18 +48,16 @@ export class NestiaApplication
     public async generate(): Promise<void>
     {
         // LOAD CONTROLLER FILES
-        const fileList: string[] = [];
-        const inputList: string[] = this.config_.input instanceof Array
-            ? this.config_.input
-            : [this.config_.input];
-
-        for (const file of inputList.map(str => path.resolve(str)))
-        {
-            const found: string[] = await SourceFinder.find(file);
-            const filtered: string[] = await ArrayUtil.asyncFilter(found, file => this.is_not_excluded(file));
-
-            fileList.push(...filtered);
-        }
+        const input: IConfiguration.IInput = this.config_.input instanceof Array
+            ? { include: this.config_.input }
+            : typeof this.config_.input === "string"
+                ? { include: [ this.config_.input ] }
+                : this.config_.input;
+        const fileList: string[] = await ArrayUtil.asyncFilter
+        (
+            await SourceFinder.find(input),
+            file => this.is_not_excluded(file)
+        );
 
         // ANALYZE REFLECTS
         const unique: WeakSet<any> = new WeakSet();
@@ -86,7 +85,7 @@ export class NestiaApplication
         }
 
         // DO GENERATE
-        await SdkGenerator.generate(this.config_.output, routeList);
+        await SdkGenerator.generate(this.config_, routeList);
     }
 
     private async is_not_excluded(file: string): Promise<boolean>
@@ -94,14 +93,4 @@ export class NestiaApplication
         return file.indexOf(`${this.config_.output}${path.sep}functional`) === -1
             && (await this.bundle_checker_.get())(file) === false;
     }
-}
-
-export namespace NestiaApplication
-{
-    export interface IConfiguration
-    {
-        input: string | string[];
-        output: string;
-        compilerOptions?: tsc.CompilerOptions;
-    }
 }

package/src/analyses/ControllerAnalyzer.ts

@@ -1,5 +1,5 @@
-import * as NodePath from "path";
-import * as tsc from "typescript";
+import NodePath from "path";
+import tsc from "typescript";
 import { HashMap } from "tstl/container/HashMap";
 
 import { IController } from "../structures/IController";

package/src/analyses/GenericAnalyzer.ts

@@ -1,4 +1,4 @@
-import * as tsc from "typescript";
+import tsc from "typescript";
 
 export namespace GenericAnalyzer
 {

package/src/analyses/ImportAnalyzer.ts

@@ -1,4 +1,4 @@
-import * as tsc from "typescript";
+import tsc from "typescript";
 
 import { HashMap } from "tstl/container/HashMap";
 import { HashSet } from "tstl/container/HashSet";

package/src/analyses/SourceFinder.ts

@@ -1,33 +1,73 @@
-import * as fs from  "fs";
-import * as path from "path";
+import fs from  "fs";
+import glob from "glob";
+import path from "path";
+
+import { IConfiguration } from "../IConfiguration";
 
 export namespace SourceFinder
 {
-    export async function find(directory: string): Promise<string[]>
+    export async function find(input: IConfiguration.IInput): Promise<string[]>
     {
-        const output: string[] = [];
-        await gather(output, directory);
+        const dict: Set<string> = new Set();
+        await decode(input.include, str => dict.add(str));
+        if (input.exclude)
+            await decode(input.exclude, str => dict.delete(str));
+            
+        return [...dict];
+    }
 
-        return output;
+    async function decode
+        (
+            input: string[],
+            closure: (location: string) => void,
+        ): Promise<void>
+    {
+        for (const pattern of input)
+            for (const location of await _Glob(path.resolve(pattern)))
+            {
+                const stats: fs.Stats = await fs.promises.stat(location);
+                if (stats.isDirectory() === true)
+                    await iterate(closure, location);
+                else if (stats.isFile() && _Is_ts_file(location))
+                    closure(location);
+            }
     }
 
-    async function gather(output: string[], directory: string): Promise<void>
+    async function iterate
+        (
+            closure: (location: string) => void,
+            location: string
+        ): Promise<void>
     {
-        const children: string[] = await fs.promises.readdir(directory);
-        for (const file of children)
+        const directory: string[] = await fs.promises.readdir(location);
+        for (const file of directory)
         {
-            const current: string = `${directory}${path.sep}${file}`;
-            const stats: fs.Stats = await fs.promises.lstat(current);
+            const next: string = path.resolve(`${location}/${file}`);
+            const stats: fs.Stats = await fs.promises.stat(next);
 
             if (stats.isDirectory() === true)
-            {
-                await gather(output, current);
-                continue;
-            }
-            else if (file.substr(-3) !== ".ts" || file.substr(-5) === ".d.ts")
-                continue;
-                
-            output.push(current);
+                await iterate(closure, next);
+            else if (stats.isFile() && _Is_ts_file(file))
+                closure(next);
         }
     }
+
+    function _Glob(pattern: string): Promise<string[]>
+    {
+        return new Promise((resolve, reject) =>
+        {
+            glob(pattern, (err, matches) =>
+            {
+                if (err)
+                    reject(err);
+                else
+                    resolve(matches.map(str => path.resolve(str)));
+            });
+        });
+    }
+
+    function _Is_ts_file(file: string): boolean
+    {
+        return file.substr(-3) === ".ts" && file.substr(-5) !== ".d.ts";
+    }
 }

package/src/bin/nestia.ts

@@ -1,117 +1,138 @@
-#!/usr/bin/env ts-node-script
+#!/usr/bin/env ts-node
 
-import cli from "cli";
-import fs from "fs";
-import path from "path";
-import tsc from "typescript";
+import * as cp from "child_process";
+import * as fs from "fs";
 
-import { NestiaApplication } from "../NestiaApplication";
-
-import { Terminal } from "../utils/Terminal";
+import { CompilerOptions } from "../internal/CompilerOptions";
 import { stripJsonComments } from "../utils/stripJsonComments";
 
-interface ICommand
+interface IConfig
 {
-    out: string | null;
+    compilerOptions?: CompilerOptions;
 }
 
-async function sdk(input: string[], command: ICommand): Promise<void>
+function install(): void
 {
-    let compilerOptions: tsc.CompilerOptions | undefined = {};
-
-    //----
-    // NESTIA.CONFIG.TS
-    //----
-    if (fs.existsSync("nestia.config.ts") === true)
+    // INSTALL DEPENDENCIES
+    for (const lib of ["nestia-fetcher", "typescript-is"])
     {
-        const config: NestiaApplication.IConfiguration = await import(path.resolve("nestia.config.ts"));
-        compilerOptions = config.compilerOptions;
-        input = config.input instanceof Array ? config.input : [config.input];
-        command.out = config.output;
+        const command: string = `npm install ${lib}`;
+        cp.execSync(command, { stdio: "inherit" });
     }
-    
-    //----
-    // VALIDATIONS
-    //----
-    // CHECK OUTPUT
-    if (command.out === null)
-        throw new Error(`Output directory is not specified. Add the "--out <output_directory>" option.`);
-
-    // CHECK PARENT DIRECTORY
-    const parentPath: string = path.resolve(command.out + "/..");
-    const parentStats: fs.Stats = await fs.promises.stat(parentPath);
+}
 
-    if (parentStats.isDirectory() === false)
-        throw new Error(`Unable to find parent directory of the output path: "${parentPath}".`);
+function sdk(): void
+{
+    // PREPARE COMMAND
+    const parameters: string[] = [
+        "npx ts-node -C ttypescript",
+        __dirname + "/../executable/sdk",
+        ...process.argv.slice(3)
+    ];
+    const command: string = parameters.join(" ");
+
+    // EXECUTE THE COMMAND, BUT IGNORE WARNINGS
+    cp.execSync
+    (
+        command, 
+        { 
+            stdio: "inherit",
+            env: { "NODE_NO_WARNINGS": "1" } 
+        }
+    );
+}
 
-    // CHECK INPUTS
-    for (const path of input)
+function configure(config: IConfig): boolean
+{
+    if (!config.compilerOptions)
     {
-        const inputStats: fs.Stats = await fs.promises.stat(path);
-        if (inputStats.isDirectory() === false)
-            throw new Error(`Target "${path}" is not a directory.`);
+        config.compilerOptions = CompilerOptions.DEFAULT;
+        return true;
     }
+    else
+        return CompilerOptions.emend(config.compilerOptions);
+}
 
+async function tsconfig(task: () => void): Promise<void>
+{
     //----
-    // GENERATION
+    // PREPARE ASSETS
     //----
-    if (fs.existsSync("tsconfig.json") === true)
+    let prepare: null | (() => Promise<void>) = null;
+    let restore: null | (() => Promise<void>) = null;
+
+    if (fs.existsSync("tsconfig.json") === false)
     {
+        // NO TSCONFIG.JSON
+        const config: IConfig = {
+            compilerOptions: CompilerOptions.DEFAULT
+        };
+        prepare = () => fs.promises.writeFile
+        (
+            "tsconfig.json",
+            JSON.stringify(config, null, 2),
+            "utf8"
+        );
+        restore = () => fs.promises.unlink("tsconfig.json")
+    }
+    else
+    {
+        // HAS TSCONFIG.JSON
         const content: string = await fs.promises.readFile("tsconfig.json", "utf8");
-        const options: tsc.CompilerOptions = JSON.parse(stripJsonComments(content)).compilerOptions;
+        const config: IConfig = JSON.parse(stripJsonComments(content));
+        const changed: boolean = configure(config);
 
-        compilerOptions = compilerOptions
-            ? { ...options, ...compilerOptions }
-            : options;
+        if (changed === true)
+        {
+            // NEED TO ADD TRANSFORM PLUGINS
+            prepare = () => fs.promises.writeFile
+            (
+                "tsconfig.json", 
+                JSON.stringify(config, null, 2),
+                "utf8"
+            );
+            restore = () => fs.promises.writeFile("tsconfig.json", content, "utf8");
+        }
     }
 
-    // CHECK NESTIA.CONFIG.TS
+    //----
+    // EXECUTION
+    //----
+    // PREPARE SOMETHING
+    if (prepare !== null)
+        await prepare();
 
-    // CALL THE APP.GENERATE()
-    const app: NestiaApplication = new NestiaApplication({
-        output: command.out,
-        input,
-        compilerOptions,
-    });
-    await app.generate();
-}
+    // EXECUTE THE TASK
+    let error: Error | null = null;
+    try
+    {
+        task();
+    }
+    catch (exp)
+    {
+        error = exp as Error;
+    }
 
-async function install(): Promise<void>
-{
-    await Terminal.execute("npm install --save nestia-fetcher");
+    // RESTORE THE TSCONFIG.JSON
+    if (restore !== null)
+        await restore();
+
+    // THROW ERROR IF EXISTS
+    if (error)
+        throw error;
 }
 
-async function main(): Promise<void>
+async function main()
 {
     if (process.argv[2] === "install")
         await install();
     else if (process.argv[2] === "sdk")
-    {
-        const command: ICommand = cli.parse({
-            out: ["o", "Output path of the SDK files", "string", null],
-        });
-
-        try
-        {
-            const inputs: string[] = [];
-            for (const arg of process.argv.slice(3))
-            {
-                if (arg[0] === "-")
-                    break;
-                inputs.push(arg);
-            }
-            await sdk(inputs, command);
-        }
-        catch (exp)
-        {
-            console.log(exp);
-            process.exit(-1);
-        }
-    }
+        await tsconfig(sdk);
     else
-    {
-        console.log(`nestia supports only two commands; install and sdk, however you typed ${process.argv[2]}`);
-        process.exit(-1);
-    }
+        throw new Error(`nestia supports only two commands; install and sdk, however you typed ${process.argv[2]}`);
 }
-main();
+main().catch(exp =>
+{
+    console.log(exp.message);
+    process.exit(-1);
+});

package/src/executable/sdk.ts

@@ -0,0 +1,89 @@
+import cli from "cli";
+import fs from "fs";
+import path from "path";
+import tsc from "typescript";
+import { Primitive } from "nestia-fetcher";
+
+import { IConfiguration } from "../IConfiguration";
+import { NestiaApplication } from "../NestiaApplication";
+import { stripJsonComments } from "../utils/stripJsonComments";
+
+interface ICommand
+{
+    exclude: string | null;
+    out: string | null;
+}
+
+async function sdk(include: string[], command: ICommand): Promise<void>
+{
+    // CONFIGURATION
+    let config: IConfiguration;
+    if (fs.existsSync("nestia.config.ts") === true)
+        config = Primitive.clone
+        (
+            await import(path.resolve("nestia.config.ts"))
+        );
+    else
+    {
+        if (command.out === null)
+            throw new Error(`Output directory is not specified. Add the "--out <output_directory>" option.`);
+        config = {
+            input: {
+                include,
+                exclude: command.exclude
+                    ? [command.exclude]
+                    : undefined
+            },
+            output: command.out
+        };
+    }
+    
+    // VALIDATE OUTPUT DIRECTORY
+    const parentPath: string = path.resolve(config.output + "/..");
+    const parentStats: fs.Stats = await fs.promises.stat(parentPath);
+
+    if (parentStats.isDirectory() === false)
+        throw new Error(`Unable to find parent directory of the output path: "${parentPath}".`);
+
+    // GENERATION
+    if (fs.existsSync("tsconfig.json") === true)
+    {
+        const content: string = await fs.promises.readFile("tsconfig.json", "utf8");
+        const options: tsc.CompilerOptions = JSON.parse(stripJsonComments(content)).compilerOptions;
+
+        config.compilerOptions = {
+            ...options,
+            ...(config.compilerOptions || {})
+        };
+    }
+
+    // CALL THE APP.GENERATE()
+    const app: NestiaApplication = new NestiaApplication(config);
+    await app.generate();
+}
+
+async function main(): Promise<void>
+{
+    const command: ICommand = cli.parse({
+        exclude: ["e", "Something to exclude", "string", null],
+        out: ["o", "Output path of the SDK files", "string", null],
+    });
+
+    try
+    {
+        const inputs: string[] = [];
+        for (const arg of process.argv.slice(2))
+        {
+            if (arg[0] === "-")
+                break;
+            inputs.push(arg);
+        }
+        await sdk(inputs, command);
+    }
+    catch (exp)
+    {
+        console.log(exp);
+        process.exit(-1);
+    }
+}
+main();

package/src/generates/FileGenerator.ts

@@ -1,5 +1,6 @@
-import * as fs from "fs";
+import fs from "fs";
 import { HashMap } from "tstl/container/HashMap";
+import { IConfiguration } from "../IConfiguration";
 
 import { IRoute } from "../structures/IRoute";
 import { ImportDictionary } from "../utils/ImportDictionary";
@@ -10,7 +11,7 @@ export namespace FileGenerator
     /* ---------------------------------------------------------
         CONSTRUCTOR
     --------------------------------------------------------- */
-    export async function generate(outDir: string, routeList: IRoute[]): Promise<void>
+    export async function generate(config: IConfiguration, routeList: IRoute[]): Promise<void>
     {
         // CONSTRUCT FOLDER TREE
         const root: Directory = new Directory(null, "functional");
@@ -21,7 +22,7 @@ export namespace FileGenerator
         relocate(root);
 
         // ITERATE FILES
-        await iterate(outDir + "/functional", root);
+        await iterate(!!config.assert, config.output + "/functional", root);
     }
 
     function emplace(directory: Directory, route: IRoute): void
@@ -63,7 +64,12 @@ export namespace FileGenerator
     /* ---------------------------------------------------------
         FILE ITERATOR
     --------------------------------------------------------- */
-    async function iterate(outDir: string, directory: Directory): Promise<void>
+    async function iterate
+        (
+            assert: boolean, 
+            outDir: string, 
+            directory: Directory
+        ): Promise<void>
     {
         // CREATE A NEW DIRECTORY
         try
@@ -76,7 +82,7 @@ export namespace FileGenerator
         let content: string = "";
         for (const it of directory.directories)
         {
-            await iterate(`${outDir}/${it.first}`, it.second);
+            await iterate(assert, `${outDir}/${it.first}`, it.second);
             content += `export * as ${it.first} from "./${it.first}";\n`;
         }
         content += "\n";
@@ -88,27 +94,34 @@ export namespace FileGenerator
             for (const tuple of route.imports)
                 for (const instance of tuple[1])
                     importDict.emplace(tuple[0], false, instance);
-            content += FunctionGenerator.generate(route) + "\n\n";
+            content += FunctionGenerator.generate(assert, route) + "\n\n";
         }
 
         // FINALIZE THE CONTENT
         if (directory.routes.length !== 0)
+        {
+            const primitived: boolean = directory.routes.some(route => route.output !== "void" 
+                || route.parameters.some(param => param.category !== "param")
+            );
+            const asserted: boolean = assert 
+                && directory.routes.some(route => route.parameters.length !== 0);
+            
+            const fetcher: string[] = ["Fetcher"];
+            if (primitived) 
+                fetcher.push("Primitive");
+            
             content = ""
-                + `import { AesPkcs5, Fetcher, Primitive } from "nestia-fetcher";\n`
+                + `import { ${fetcher.join(", ")} } from "nestia-fetcher";\n`
                 + `import type { IConnection } from "nestia-fetcher";\n`
+                + (asserted ? `import { assertType } from "typescript-is";\n` : "")
                 + 
                 (
                     importDict.empty()
                         ? ""
                         : "\n" + importDict.toScript(outDir) + "\n"
                 )
-                + content + "\n\n"
-                + "//---------------------------------------------------------\n"
-                + "// TO PREVENT THE UNUSED VARIABLE ERROR\n"
-                + "//---------------------------------------------------------\n"
-                + "AesPkcs5;\n"
-                + "Fetcher;\n"
-                + "Primitive;";
+                + content;
+        }
 
         content = "/**\n"
             + " * @packageDocumentation\n"

package/src/generates/FunctionGenerator.ts

@@ -1,4 +1,4 @@
-import type * as tsc from "typescript";
+import type tsc from "typescript";
 import { Pair } from "tstl/utility/Pair";
 import { Vector } from "tstl/container/Vector";
 
@@ -6,13 +6,13 @@ import { IRoute } from "../structures/IRoute";
 
 export namespace FunctionGenerator
 {
-    export function generate(route: IRoute): string
+    export function generate(assert: boolean, route: IRoute): string
     {
         const query: IRoute.IParameter | undefined = route.parameters.find(param => param.category === "query");
         const input: IRoute.IParameter | undefined = route.parameters.find(param => param.category === "body");
 
         return [head, body, tail]
-            .map(closure => closure(route, query, input))
+            .map(closure => closure(route, query, input, assert))
             .filter(str => !!str)
             .join("\n");
     }
@@ -20,7 +20,13 @@ export namespace FunctionGenerator
     /* ---------------------------------------------------------
         BODY
     --------------------------------------------------------- */
-    function body(route: IRoute, query: IRoute.IParameter | undefined, input: IRoute.IParameter | undefined): string
+    function body
+        (
+            route: IRoute, 
+            query: IRoute.IParameter | undefined, 
+            input: IRoute.IParameter | undefined,
+            assert: boolean
+        ): string
     {
         // FETCH ARGUMENTS WITH REQUST BODY
         const parameters = filter_parameters(route, query);
@@ -34,8 +40,15 @@ export namespace FunctionGenerator
         if (input !== undefined)
             fetchArguments.push(input.name);
 
+        const assertions: string = assert === true && route.parameters.length !== 0
+            ? route.parameters
+                .map(param => `    assertType<typeof ${param.name}>(${param.name});`)
+                .join("\n") + "\n\n"
+            : "";
+
         // RETURNS WITH FINALIZATION
         return "{\n"
+            + assertions
             + "    return Fetcher.fetch\n"
             + "    (\n"
             + fetchArguments.map(param => `        ${param}`).join(",\n") + "\n"
@@ -54,7 +67,12 @@ export namespace FunctionGenerator
     /* ---------------------------------------------------------
         HEAD & TAIL
     --------------------------------------------------------- */
-    function head(route: IRoute, query: IRoute.IParameter | undefined, input: IRoute.IParameter | undefined): string
+    function head
+        (
+            route: IRoute, 
+            query: IRoute.IParameter | undefined, 
+            input: IRoute.IParameter | undefined
+        ): string
     {
         //----
         // CONSTRUCT COMMENT
@@ -132,7 +150,12 @@ export namespace FunctionGenerator
             + `    ): Promise<${output}>`;
     }
 
-    function tail(route: IRoute, query: IRoute.IParameter | undefined, input: IRoute.IParameter | undefined): string | null
+    function tail
+        (
+            route: IRoute, 
+            query: IRoute.IParameter | undefined, 
+            input: IRoute.IParameter | undefined
+        ): string | null
     {
         // LIST UP TYPES
         const types: Pair<string, string>[] = [];

package/src/generates/SdkGenerator.ts

@@ -1,15 +1,20 @@
-import * as fs from "fs";
+import fs from "fs";
 import { DirectoryUtil } from "../utils/DirectoryUtil";
 
 import { IRoute } from "../structures/IRoute";
 import { FileGenerator } from "./FileGenerator";
+import { IConfiguration } from "../IConfiguration";
 
 export namespace SdkGenerator
 {
-    export async function generate(outDir: string, routeList: IRoute[]): Promise<void>
+    export async function generate
+        (
+            config: IConfiguration,
+            routeList: IRoute[],
+        ): Promise<void>
     {
         // PREPARE NEW DIRECTORIES
-        try { await fs.promises.mkdir(outDir); } catch {}
+        try { await fs.promises.mkdir(config.output); } catch {}
 
         // BUNDLING
         const bundle: string[] = await fs.promises.readdir(BUNDLE);
@@ -21,13 +26,13 @@ export namespace SdkGenerator
             if (stats.isFile() === true)
             {
                 const content: string = await fs.promises.readFile(current, "utf8");
-                await fs.promises.writeFile(`${outDir}/${file}`, content, "utf8");
+                await fs.promises.writeFile(`${config.output}/${file}`, content, "utf8");
             }
         }
-        await DirectoryUtil.copy(BUNDLE + "/__internal", outDir + "/__internal");
+        await DirectoryUtil.copy(BUNDLE + "/__internal", config.output + "/__internal");
         
         // FUNCTIONAL
-        await FileGenerator.generate(outDir, routeList);
+        await FileGenerator.generate(config, routeList);
     }
 }
 

package/src/internal/CompilerOptions.ts

@@ -0,0 +1,113 @@
+export interface CompilerOptions
+{
+    target: string;
+    module: string;
+    lib: string[];
+    strict: boolean;
+    downlevelIteration: boolean;
+    esModuleInterop?: boolean;
+    plugins?: Array<{ 
+        transform?: string 
+    }>;
+    types?: string[];
+    experimentalDecorators?: boolean;
+    emitDecoratorMetadata?: boolean;
+}
+export namespace CompilerOptions
+{   
+    export const DEPENDENCIES: string[] = [
+        "nestia-fetcher", 
+        "typescript-is"
+    ];
+
+    export const TRANSFORMERS: string[] = [
+        "typescript-is/lib/transform-inline/transformer", 
+        "typescript-transform-paths"
+    ];
+
+    export const TYPES: string[] = []
+
+    export const DEFAULT = {
+        target: "es5",
+        module: "commonjs",
+        lib: [
+            "DOM", 
+            "ES2015"
+        ],
+        strict: true,
+        downlevelIteration: true,
+        esModuleInterop: true,
+        plugins: TRANSFORMERS.map(transform => ({ transform })),
+        types: [
+            "node",
+            "reflect-metadata"
+        ],
+        experimentalDecorators: true,
+        emitDecoratorMetadata: true,
+    };
+
+    export function emend(options: CompilerOptions): boolean
+    {
+        // FILL ARRAY DATA
+        if (!options.plugins)
+            options.plugins = [];
+        if (!options.types)
+            options.types = [];
+        
+        // CONSTRUCT CHECKERS
+        const emended: Required<CompilerOptions> = options as Required<CompilerOptions>;
+        const checkers: Array<() => boolean> = [
+            () => 
+            {
+                let changed: boolean = false;
+                for (const transform of CompilerOptions.TRANSFORMERS)
+                {
+                    if (emended.plugins.find(elem => elem.transform === transform) !== undefined)
+                        continue;
+    
+                    changed = true;
+                    emended.plugins.push({ transform });
+                }
+                return changed;
+            },
+            () =>
+            {
+                let changed: boolean = false;
+                for (const type of CompilerOptions.TYPES)
+                {
+                    if (emended.types.find(elem => elem === type) !== undefined)
+                        continue;
+    
+                    changed = true;
+                    emended.types.push(type);
+                }
+                return changed;
+            },
+            () =>
+            {
+                const changed: boolean = emended.experimentalDecorators !== true;
+                if (changed)
+                    emended.experimentalDecorators = true;
+                return changed;
+            },
+            () =>
+            {
+                const changed: boolean = emended.emitDecoratorMetadata !== true;
+                if (changed)
+                    emended.emitDecoratorMetadata = true;
+                return changed;
+            },
+            () =>
+            {
+                const changed: boolean = emended.esModuleInterop !== true;
+                if (changed)
+                    emended.esModuleInterop = true;
+                return changed;
+            }
+        ];
+
+        // DO CHECK IT
+        const checks: boolean[] = checkers.map(func => func());
+        return checks.some(flag => flag);
+    }
+}

package/src/structures/IRoute.ts

@@ -1,4 +1,4 @@
-import type * as tsc from "typescript";
+import type tsc from "typescript";
 import { ParamCategory } from "./ParamCategory";
 
 export interface IRoute

package/src/utils/DirectoryUtil.ts

@@ -1,5 +1,5 @@
 import del from "del";
-import * as fs from "fs";
+import fs from "fs";
 
 export namespace DirectoryUtil
 {

package/src/utils/ImportDictionary.ts

@@ -1,4 +1,4 @@
-import * as path from "path";
+import path from "path";
 
 import { HashMap } from "tstl/container/HashMap";
 import { HashSet } from "tstl/container/HashSet";

package/tsconfig.json

@@ -72,12 +72,11 @@
 
     /* Advanced Options */
     "skipLibCheck": true,                     /* Skip type checking of declaration files. */
-    "forceConsistentCasingInFileNames": true  /* Disallow inconsistently-cased references to the same file. */
+    "forceConsistentCasingInFileNames": true,  /* Disallow inconsistently-cased references to the same file. */
+    "plugins": [
+      { "transform": "typescript-is/lib/transform-inline/transformer" },
+      { "transform": "typescript-transform-paths" }
+    ]
   },
-  "include": [
-    "src",
-    "test/default/src",
-    "test/nestia.config.ts/src",
-    // "test/tsconfig.json/src"
-  ]
+  "include": ["src"]
 }

package/src/utils/Terminal.ts

@@ -1,19 +0,0 @@
-import * as cp from "child_process";
-import { Pair } from "tstl/utility/Pair";
-
-export namespace Terminal
-{
-    export function execute(...commands: string[]): Promise<Pair<string, string>>
-    {
-        return new Promise((resolve, reject) =>
-        {
-            cp.exec(commands.join(" && "), (error: Error | null, stdout: string, stderr: string) =>
-            {
-                if (error)
-                    reject(error);
-                else
-                    resolve(new Pair(stdout, stderr));
-            });
-        });
-    }
-}