nestia 0.4.1 → 1.2.0

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,54 +66,69 @@ 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).
 
-```bash
-npx nestia install
-```
-
 ### Dependencies
-SDK library generated by the **Nestia** has some dependencies like below. 
-
-When you type the `nestia install` command in the console, those dependencies would be automatically installed and enrolled to the `dependencies` and `devDependencies` fields in the `package.json`
+SDK library generated by the **Nestia** requires the [nestia-fetcher](https://github.com/samchon/nestia-fetcher) module. 
 
-  - [@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node)
-  - [node-fetch](https://github.com/node-fetch/node-fetch)
+Therefore, when you publish an SDK library generated by this **Nestia**, you have to write the [nestia-fetcher](https://github.com/samchon/nestia-fetcher) module into the `dependencies` property of the `package.json` file like below. You also can configure the `dependencies` property of the `package.json` file by typing the `npm install --save nestia-fetcher` command in the console, too.
 
+```json
+{
+  "name": "payments-server-api",
+  "dependencies": {
+    "nestia-fetcher": "^1.0.2"
+  }
+}
+```
 
 
 
 ## 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[];
     }
 }
 ```
@@ -118,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
@@ -213,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
     );
 }
@@ -232,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`;
+    }
 }
 ```
 
@@ -239,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.
 
-### Technial Support
-samchon.github@gmail.com
+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.
 
-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
 
-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. 
+Helper library of the `NestJS` with **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.
+[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.
+
+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**.
+
+  - 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": "0.4.1",
+  "version": "1.2.0",
   "description": "Automatic SDK and Document generator for the NestJS",
   "main": "src/index.ts",
   "bin": {
@@ -30,17 +30,19 @@
   "homepage": "https://github.com/samchon/nestia#readme",
   "dependencies": {
     "@types/cli": "^0.11.19",
+    "@types/glob": "^7.2.0",
     "@types/node": "^14.14.22",
     "@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",
-    "ttypescript": "^1.5.12",
-    "typescript": "^4.3.2"
+    "tsconfig-paths": "^3.14.1",
+    "tstl": "^2.5.3",
+    "typescript": "^4.6.3"
   },
   "devDependencies": {
-    "encrypted-nestjs": "^0.1.15",
+    "nestia-helper": "^1.2.0-dev.20220411",
     "rimraf": "^3.0.2"
   }
 }

package/src/IConfiguration.ts

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

package/src/NestiaApplication.ts

@@ -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();
@@ -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/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,88 +1,82 @@
-#!/usr/bin/env ts-node-script
+#!/usr/bin/env ts-node
 
-import cli from "cli";
+import cp from "child_process";
 import fs from "fs";
-import path from "path";
 import tsc from "typescript";
 
-import { NestiaApplication } from "../NestiaApplication";
-
-import { Terminal } from "../utils/Terminal";
 import { stripJsonComments } from "../utils/stripJsonComments";
 
-interface ICommand
+function install(): void
 {
-    out: string | null;
+    const command: string = "npm install --save nestia-fetcher";
+    cp.execSync(command, { stdio: "inherit" });
 }
 
-async function sdk(input: string[], command: ICommand): Promise<void>
+function sdk(alias: boolean): void
 {
-    let compilerOptions: tsc.CompilerOptions | undefined = {};
+    const parameters: string[] = [
+        alias ? "npx ts-node -r tsconfig-paths/register" : "npx ts-node",
+        __dirname + "/../executable/sdk",
+        ...process.argv.slice(3)
+    ];
+    const command: string = parameters.join(" ");
+    cp.execSync(command, { stdio: "inherit" });
+}
 
-    //----
-    // NESTIA.CONFIG.TS
-    //----
-    if (fs.existsSync("nestia.config.ts") === true)
+async function tsconfig(task: (alias: boolean) => void): Promise<void>
+{
+    // NO TSCONFIG.JSON?
+    if (fs.existsSync("tsconfig.json") === false)
     {
-        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;
+        task(false);
+        return;
     }
-    
-    //----
-    // 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);
+    const content: string = await fs.promises.readFile("tsconfig.json", "utf8");
+    const json: any = JSON.parse(stripJsonComments(content));
+    const options: tsc.CompilerOptions = json.compilerOptions;
 
-    if (parentStats.isDirectory() === false)
-        throw new Error(`Unable to find parent directory of the output path: "${parentPath}".`);
-
-    // CHECK INPUTS
-    for (const path of input)
+    // NO ALIAS PATHS
+    if (!options.paths || !Object.entries(options.paths).length)
     {
-        const inputStats: fs.Stats = await fs.promises.stat(path);
-        if (inputStats.isDirectory() === false)
-            throw new Error(`Target "${path}" is not a directory.`);
+        task(false);
+        return;
     }
 
-    //----
-    // 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;
+    let closer: null | (() => Promise<void>) = null;
+    let error: Error | null = null;
 
-        compilerOptions = compilerOptions
-            ? { ...options, ...compilerOptions }
-            : options;
+    if (!options.baseUrl)
+    {
+        options.baseUrl = "./";
+        await fs.promises.writeFile
+        (
+            "tsconfig.json", 
+            JSON.stringify(json, null, 2),
+            "utf8"
+        );
+
+        closer = () => fs.promises.writeFile
+        (
+            "tsconfig.json", 
+            content, 
+            "utf8"
+        );
     }
 
-    // CHECK NESTIA.CONFIG.TS
-
-    // CALL THE APP.GENERATE()
-    const app: NestiaApplication = new NestiaApplication({
-        output: command.out,
-        input,
-        compilerOptions,
-    });
-    await app.generate();
-}
-
-async function install(): Promise<void>
-{
-    for (const module of ["@types/node", "node-fetch"])
+    try
     {
-        console.log(`installing ${module}...`);
-        await Terminal.execute(`npm install --save-dev ${module}`);
+        task(true);
     }
+    catch (exp)
+    {
+        error = exp as Error;
+    }
+
+    if (closer)
+        await closer();
+    if (error)
+        throw error;
 }
 
 async function main(): Promise<void>
@@ -90,32 +84,12 @@ async function main(): Promise<void>
     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/bundle/HttpError.ts

@@ -1,33 +1 @@
-/**
- * @packageDocumentation
- * @module api
- */
-//================================================================
-/**
- * HTTP Error from the backend server.
- * 
- * @author Jeongho Nam - https://github.com/samchon
- */
-export class HttpError extends Error
-{
-    public readonly method: string;
-    public readonly path: string;
-    public readonly status: number;
-
-    public constructor(method: string, path: string, status: number, message: string)
-    {
-        super(message);
-
-        // INHERITANCE POLYFILL
-        const proto: HttpError = new.target.prototype;
-        if (Object.setPrototypeOf)
-            Object.setPrototypeOf(this, proto);
-        else
-            (this as any).__proto__ = proto;
-
-        // ASSIGN MEMBERS
-        this.method = method;
-        this.path = path;
-        this.status = status;
-    }
-}
+export { HttpError } from "nestia-fetcher";

package/src/bundle/IConnection.ts

@@ -1,26 +1 @@
-/**
- * @packageDocumentation
- * @module api
- */
-//================================================================
-export interface IConnection
-{
-    host: string;
-    headers?: Record<string, string>;
-    encryption?: IConnection.IEncyptionPassword | IConnection.EncryptionClosure;
-    path?: (path: string) => string;
-}
-
-export namespace IConnection
-{
-    export interface IEncyptionPassword
-    {
-        key: string;
-        iv: string;
-    }
-
-    export interface EncryptionClosure
-    {
-        (content: string, isEncode: boolean): IEncyptionPassword;
-    } 
-}
+export { IConnection } from "nestia-fetcher";

package/src/bundle/Primitive.ts

@@ -1,113 +1 @@
-/**
- * @packageDocumentation
- * @module api
- */
-//================================================================
-/**
- * 객체의 원시 타입.
- * 
- * `Primitive` 는 대상 인스턴스의 모든 메서드를 제거하여, 그 타입을 pritimive object 의 형태로 
- * 바꾸어주는 TMP (Type Meta Programming) 타입이다.
- * 
- * @template Instance 대상 인스턴스
- * @author Samchon
- */
-export type Primitive<Instance> = value_of<Instance> extends object
-    ? Instance extends object
-        ? Instance extends IJsonable<infer Raw>
-            ? value_of<Raw> extends object
-                ? Raw extends object
-                    ? PrimitiveObject<Raw> // object would be primitified
-                    : never // cannot be
-                : value_of<Raw> // atomic value
-            : PrimitiveObject<Instance> // object would be primitified
-        : never // cannot be
-    : value_of<Instance>;
-
-export namespace Primitive
-{
-    /**
-     * Primitive object 하드 카피.
-     * 
-     * `Primitive.clone()` 은 파라미터 인스턴스를 원시 오브젝트 형태로 hard copy 하는 함수이다.
-     * 
-     * @param instance 복사 대상 인스턴스
-     * @return 복사된 객체
-     */
-    export function clone<Instance>(instance: Instance): Primitive<Instance>
-    {
-        return JSON.parse(JSON.stringify(instance));
-    }
-
-    /**
-     * @todo
-     */
-    export function equal_to<Instance>(x: Instance, y: Instance): boolean
-    {
-        return JSON.stringify(x) === JSON.stringify(y) || recursive_equal_to(x, y);
-    }
-}
-
-type PrimitiveObject<Instance extends object> = Instance extends Array<infer T>
-    ? Primitive<T>[]
-    : 
-    {
-        [P in keyof Instance]: Instance[P] extends Function
-            ? never
-            : Primitive<Instance[P]>
-    };
-
-type value_of<Instance> = 
-    is_value_of<Instance, Boolean> extends true ? boolean
-    : is_value_of<Instance, Number> extends true ? number
-    : is_value_of<Instance, String> extends true ? string
-    : Instance;
-
-type is_value_of<Instance, Object extends IValueOf<any>> = 
-    Instance extends Object
-        ? Object extends IValueOf<infer Primitive>
-            ? Instance extends Primitive
-                ? false
-                : true // not Primitive, but Object
-            : false // cannot be
-        : false;
-
-interface IValueOf<T>
-{
-    valueOf(): T;
-}
-
-interface IJsonable<T>
-{
-    toJSON(): T;
-}
-
-function object_equal_to<T extends object>(x: T, y: T): boolean
-{
-    for (const key in x)
-        if (recursive_equal_to(x[key], y[key]) === false)
-            return false;
-    return true;
-}
-
-function array_equal_to<T>(x: T[], y: T[]): boolean
-{
-    if (x.length !== y.length)
-        return false;
-
-    return x.every((value, index) => recursive_equal_to(value, y[index]));
-}
-
-function recursive_equal_to<T>(x: T, y: T): boolean
-{
-    const type = typeof x;
-    if (type !== typeof y)
-        return false;
-    else if (type === "object")
-        if (x instanceof Array)
-            return array_equal_to(x, y as typeof x);
-        else
-            return object_equal_to(<any>x as object, <any>y as object);
-    else
-        return x === y;
-}
+export { Primitive } from "nestia-fetcher";

package/src/bundle/__internal/AesPkcs5.ts

@@ -1,51 +1 @@
-/**
- * @packageDocumentation
- * @module api.__internal
- */
-//================================================================
-import * as crypto from "crypto";
-
-/**
- * Utility class for AES Encryption.
- * 
- *   - AES-128/256
- *   - CBC mode
- *   - PKCS#5 Padding
- *   - Base64 Encoding
- * 
- * @author Jeongho Nam - https://github.com/samchon
- */
-export namespace AesPkcs5
-{
-    /**
-     * Encode data
-     * 
-     * @param data Target data
-     * @param key Key value of the encryption.
-     * @param iv Initializer Vector for the encryption
-     * @return Encoded data
-     */
-    export function encode(data: string, key: string, iv: string): string
-    {
-        const bytes: number = key.length * 8;
-        const cipher: crypto.Cipher = crypto.createCipheriv(`AES-${bytes}-CBC`, key, iv);
-
-        return cipher.update(data, "utf8", "base64") + cipher.final("base64");
-    }
- 
-    /**
-     * Decode data.
-     * 
-     * @param data Target data
-     * @param key Key value of the decryption.
-     * @param iv Initializer Vector for the decryption
-     * @return Decoded data.
-     */
-    export function decode(data: string, key: string, iv: string): string
-    {
-        const bytes: number = key.length * 8;
-        const decipher: crypto.Decipher = crypto.createDecipheriv(`AES-${bytes}-CBC`, key, iv);
-
-        return decipher.update(data, "base64", "utf8") + decipher.final("utf8");
-    }
-}
+export { AesPkcs5 } from "nestia-fetcher";

package/src/bundle/__internal/Fetcher.ts

@@ -1,126 +1 @@
-/**
- * @packageDocumentation
- * @module api.__internal
- */
-//================================================================
-import { AesPkcs5 } from "./AesPkcs5";
-import { HttpError } from "../HttpError";
-import { IConnection } from "../IConnection";
-import { Primitive } from "../Primitive";
-
-// POLYFILL FOR NODE
-if (typeof global === "object"
-    && typeof global.process === "object" 
-    && typeof global.process.versions === "object"
-    && typeof global.process.versions.node !== undefined)
-(global as any).fetch = require("node-fetch");
-
-export class Fetcher
-{
-    public static fetch<Output>(connection: IConnection, config: Fetcher.IConfig, method: "GET" | "DELETE", path: string): Promise<Primitive<Output>>;
-    public static fetch<Input, Output>(connection: IConnection, config: Fetcher.IConfig, method: "POST" | "PUT" | "PATCH", path: string, input: Input): Promise<Primitive<Output>>;
-
-    public static async fetch<Output>
-        (
-            connection: IConnection, 
-            config: Fetcher.IConfig, 
-            method: string, 
-            path: string, 
-            input?: object
-        ): Promise<Primitive<Output>>
-    {
-        if (config.input_encrypted === true || config.output_encrypted === true)
-            if (connection.encryption === undefined)
-                throw new Error("Error on nestia.Fetcher.encrypt(): the encryption password has not been configured.");
-
-        //----
-        // REQUEST MESSSAGE
-        //----
-        // METHOD & HEADERS
-        const init: RequestInit = {
-            method,
-            headers: config.input_encrypted === false && input !== undefined && typeof input === "object"
-                ? { 
-                    ...connection.headers,
-                    "Content-Type": "application/json"
-                }
-                : connection.headers
-        };
-
-        // REQUEST BODY (WITH ENCRYPTION)
-        if (input !== undefined)
-        {
-            let content: string = JSON.stringify(input);
-            if (config.input_encrypted === true)
-            {
-                const password: IConnection.IEncyptionPassword = connection.encryption instanceof Function
-                    ? connection.encryption!(content, true)
-                    : connection.encryption!;
-                content = AesPkcs5.encode(content, password.key, password.iv);
-            }
-            init.body = content;
-        }
-
-        //----
-        // RESPONSE MESSAGE
-        //----
-        // URL SPECIFICATION
-        if (connection.host[connection.host.length - 1] !== "/" && path[0] !== "/")
-            path = "/" + path;
-        if (connection.path)
-            path = connection.path(path);
-        
-        const url: URL = new URL(`${connection.host}${path}`);
-
-        // DO FETCH
-        const response: Response = await fetch(url.href, init);
-        let content: string = await response.text();
-
-        if (!content)
-            return undefined!;
-
-        // CHECK THE STATUS CODE
-        if (response.status !== 200 && response.status !== 201)
-            throw new HttpError(method, path, response.status, content);
-
-        // FINALIZATION (WITH DECODING)
-        if (config.output_encrypted === true)
-        {
-            const password: IConnection.IEncyptionPassword = connection.encryption instanceof Function
-                ? connection.encryption!(content, false)
-                : connection.encryption!;
-            content = AesPkcs5.decode(content, password.key, password.iv);
-        }
-
-        //----
-        // OUTPUT
-        //----
-        let ret: { __set_headers__: Record<string, any> } & Primitive<Output> = content as any;
-        try
-        {
-            // PARSE RESPONSE BODY
-            ret = JSON.parse(ret as any);
-
-            // FIND __SET_HEADERS__ FIELD
-            if (ret.__set_headers__ !== undefined && typeof ret.__set_headers__ === "object")
-            {
-                if (connection.headers === undefined)
-                    connection.headers = {};
-                Object.assign(connection.headers, ret.__set_headers__);
-            }
-        }
-        catch {}
-
-        // RETURNS
-        return ret;
-    }
-}
-
-export namespace Fetcher
-{
-    export interface IConfig
-    {
-        input_encrypted?: boolean;
-        output_encrypted: boolean;
-    }
-}
+export { Fetcher } from "nestia-fetcher";

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

@@ -2,7 +2,6 @@ import * as fs from "fs";
 import { HashMap } from "tstl/container/HashMap";
 
 import { IRoute } from "../structures/IRoute";
-import { DirectoryUtil } from "../utils/DirectoryUtil";
 import { ImportDictionary } from "../utils/ImportDictionary";
 import { FunctionGenerator } from "./FunctionGenerator";
 
@@ -21,14 +20,8 @@ export namespace FileGenerator
         // RELOCATE FOR ONLY ONE CONTROLLER METHOD IN AN URL CASE
         relocate(root);
 
-        const defaultImportDict: ImportDictionary = new ImportDictionary();
-        defaultImportDict.emplace(`${outDir}/__internal/AesPkcs5.ts`, true, "AesPkcs5");
-        defaultImportDict.emplace(`${outDir}/__internal/Fetcher.ts`, true, "Fetcher");
-        defaultImportDict.emplace(`${outDir}/Primitive.ts`, true, "Primitive");
-        defaultImportDict.emplace(`${outDir}/IConnection.ts`, false, "IConnection");
-
-        await DirectoryUtil.remove(outDir + "/functional");
-        await iterate(defaultImportDict, outDir + "/functional", root);
+        // ITERATE FILES
+        await iterate(outDir + "/functional", root);
     }
 
     function emplace(directory: Directory, route: IRoute): void
@@ -70,7 +63,7 @@ export namespace FileGenerator
     /* ---------------------------------------------------------
         FILE ITERATOR
     --------------------------------------------------------- */
-    async function iterate(defaultImportDict: ImportDictionary, outDir: string, directory: Directory): Promise<void>
+    async function iterate(outDir: string, directory: Directory): Promise<void>
     {
         // CREATE A NEW DIRECTORY
         try
@@ -83,7 +76,7 @@ export namespace FileGenerator
         let content: string = "";
         for (const it of directory.directories)
         {
-            await iterate(defaultImportDict, `${outDir}/${it.first}`, it.second);
+            await iterate(`${outDir}/${it.first}`, it.second);
             content += `export * as ${it.first} from "./${it.first}";\n`;
         }
         content += "\n";
@@ -100,10 +93,23 @@ export namespace FileGenerator
 
         // FINALIZE THE CONTENT
         if (directory.routes.length !== 0)
-            content = defaultImportDict.toScript(outDir) + "\n\n" 
-                + importDict.toScript(outDir) + "\n\n" 
+            content = ""
+                + `import { AesPkcs5, Fetcher, Primitive } from "nestia-fetcher";\n`
+                + `import type { IConnection } from "nestia-fetcher";\n`
+                + 
+                (
+                    importDict.empty()
+                        ? ""
+                        : "\n" + importDict.toScript(outDir) + "\n"
+                )
                 + content + "\n\n"
-                + defaultImportDict.listUp();
+                + "//---------------------------------------------------------\n"
+                + "// TO PREVENT THE UNUSED VARIABLE ERROR\n"
+                + "//---------------------------------------------------------\n"
+                + "AesPkcs5;\n"
+                + "Fetcher;\n"
+                + "Primitive;";
+
         content = "/**\n"
             + " * @packageDocumentation\n"
             + ` * @module ${directory.module}\n`

package/src/generates/FunctionGenerator.ts

@@ -27,7 +27,7 @@ export namespace FunctionGenerator
         const fetchArguments: string[] = 
         [
             "connection",
-            `${route.name}.CONFIG`,
+            `${route.name}.ENCRYPTED`,
             `${route.name}.METHOD`,
             `${route.name}.path(${parameters.map(p => p.name).join(", ")})`
         ];
@@ -158,15 +158,15 @@ export namespace FunctionGenerator
             + 
             (
                 types.length !== 0
-                    ? types.map(tuple => `    export type ${tuple.first} = Primitive<${tuple.second}>;`).join("\n") + "\n\n"
+                    ? types.map(tuple => `    export type ${tuple.first} = Primitive<${tuple.second}>;`).join("\n") + "\n"
                     : ""
             )
             + "\n"
             + `    export const METHOD = "${route.method}" as const;\n`
             + `    export const PATH: string = "${route.path}";\n`
-            + `    export const CONFIG = {\n`
-            + `        input_encrypted: ${input !== undefined && input.encrypted},\n`
-            + `        output_encrypted: ${route.encrypted},\n`
+            + `    export const ENCRYPTED: Fetcher.IEncrypted = {\n`
+            + `        request: ${input !== undefined && input.encrypted},\n`
+            + `        response: ${route.encrypted},\n`
             + `    };\n`
             + "\n"
             + `    export function path(${parameters.map(param => `${param.name}: ${param.type}`).join(", ")}): string\n`

package/src/utils/ImportDictionary.ts

@@ -8,6 +8,11 @@ export class ImportDictionary
 {
     private readonly dict_: HashMap<string, Pair<boolean, HashSet<string>>> = new HashMap();
 
+    public empty(): boolean
+    {
+        return this.dict_.empty();
+    }
+
     public emplace(file: string, realistic: boolean, instance: string): void
     {
         if (file.substr(-5) === ".d.ts")
@@ -36,17 +41,4 @@ export class ImportDictionary
         }
         return statements.join("\n");
     }
-
-    public listUp(): string
-    {
-        let content: string = ""
-            + "//---------------------------------------------------------\n"
-            + "// TO PREVENT THE UNUSED VARIABLE ERROR\n"
-            + "//---------------------------------------------------------\n";
-        for (const it of this.dict_)
-            if (it.second.first === true)
-                for (const instance of it.second.second)
-                    content += instance + ";\n";
-        return content;
-    }
 }

package/tsconfig.json

@@ -68,15 +68,11 @@
     /* Experimental Options */
     "experimentalDecorators": true,        /* Enables experimental support for ES7 decorators. */
     "emitDecoratorMetadata": true,         /* Enables experimental support for emitting type metadata for decorators. */
+    "stripInternal": true,
 
     /* Advanced Options */
     "skipLibCheck": true,                     /* Skip type checking of declaration files. */
     "forceConsistentCasingInFileNames": true  /* Disallow inconsistently-cased references to the same file. */
   },
-  "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));
-            });
-        });
-    }
-}