nestia 3.0.17 → 3.1.1-dev.20221015

package/README.md

@@ -75,6 +75,16 @@ export async function trace_sale_question_and_comment
 
 
 ## Setup
+### Starter Kit
+```bash
+npx nestia start <directory>
+```
+
+Just run the upper command with target directory. Then, boilerplate project would be copied to the target directory.
+
+After the composition being completed, read the README content of the boilderplate project and start developing your backend server.
+
+### Manual Installation
 Just like any other package, you've got to install it before you can use it.
 
 For reference, `ttypescript` is not mis-writing. Don't forget to install it.

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

@@ -0,0 +1,3 @@
+export declare namespace NestiaStarter {
+    function start(dest: string | undefined): Promise<void>;
+}

package/lib/executable/internal/NestiaStarter.js

@@ -0,0 +1,61 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NestiaStarter = void 0;
+const child_process_1 = __importDefault(require("child_process"));
+const fs_1 = __importDefault(require("fs"));
+var NestiaStarter;
+(function (NestiaStarter) {
+    function start(dest) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // VALIDATION
+            if (dest === undefined)
+                throw new Error(message("is not specified."));
+            else if (fs_1.default.existsSync(dest) === true)
+                throw new Error(message("already exists"));
+            // COPY PROJECTS
+            console.log("Copying files...");
+            yield copy(__dirname + "/../../../template", dest);
+            process.chdir(dest);
+            // INSTALL DEPENDENCIES
+            console.log("Installing dependencies...");
+            child_process_1.default.execSync("npm install", { stdio: "inherit" });
+            // BUILD TYPESCRIPT
+            console.log("Building project...");
+            child_process_1.default.execSync("npm run build", { stdio: "inherit" });
+            // DO TEST
+            console.log("Running test program...");
+            child_process_1.default.execSync("npm run test", { stdio: "inherit" });
+        });
+    }
+    NestiaStarter.start = start;
+    function copy(src, dest) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const stats = yield fs_1.default.promises.lstat(src);
+            if (stats.isDirectory()) {
+                if (src === __dirname + "/../../../template/.git")
+                    return;
+                yield fs_1.default.promises.mkdir(dest);
+                for (const file of yield fs_1.default.promises.readdir(src))
+                    yield copy(src + "/" + file, dest + "/" + file);
+            }
+            else {
+                const content = yield fs_1.default.promises.readFile(src, "utf8");
+                yield fs_1.default.promises.writeFile(dest, content, "utf8");
+            }
+        });
+    }
+})(NestiaStarter = exports.NestiaStarter || (exports.NestiaStarter = {}));
+const message = (content) => `Error on nestia.start(): target directory ${content}.`;
+//# sourceMappingURL=NestiaStarter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NestiaStarter.js","sourceRoot":"","sources":["../../../src/executable/internal/NestiaStarter.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,kEAA+B;AAC/B,4CAAoB;AAEpB,IAAiB,aAAa,CAsC7B;AAtCD,WAAiB,aAAa;IAC1B,SAAsB,KAAK,CAAC,IAAwB;;YAChD,aAAa;YACb,IAAI,IAAI,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC;iBACjE,IAAI,YAAE,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI;gBACjC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAE/C,gBAAgB;YAChB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAChC,MAAM,IAAI,CAAC,SAAS,GAAG,oBAAoB,EAAE,IAAI,CAAC,CAAC;YACnD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEpB,uBAAuB;YACvB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;YAC1C,uBAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YAEjD,mBAAmB;YACnB,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YACnC,uBAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YAEnD,UAAU;YACV,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;YACvC,uBAAE,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACtD,CAAC;KAAA;IAtBqB,mBAAK,QAsB1B,CAAA;IAED,SAAe,IAAI,CAAC,GAAW,EAAE,IAAY;;YACzC,MAAM,KAAK,GAAa,MAAM,YAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACrD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE;gBACrB,IAAI,GAAG,KAAK,SAAS,GAAG,yBAAyB;oBAAE,OAAO;gBAE1D,MAAM,YAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9B,KAAK,MAAM,IAAI,IAAI,MAAM,YAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC;oBAC7C,MAAM,IAAI,CAAC,GAAG,GAAG,GAAG,GAAG,IAAI,EAAE,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC;aACvD;iBAAM;gBACH,MAAM,OAAO,GAAW,MAAM,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBAChE,MAAM,YAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;aACtD;QACL,CAAC;KAAA;AACL,CAAC,EAtCgB,aAAa,GAAb,qBAAa,KAAb,qBAAa,QAsC7B;AAED,MAAM,OAAO,GAAG,CAAC,OAAe,EAAE,EAAE,CAChC,6CAA6C,OAAO,GAAG,CAAC"}

package/lib/executable/nestia.js

@@ -39,6 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const child_process_1 = __importDefault(require("child_process"));
 const fs_1 = __importDefault(require("fs"));
 const process_1 = __importDefault(require("process"));
+const NestiaStarter_1 = require("./internal/NestiaStarter");
 function dependencies() {
     // INSTALL DEPENDENCIES
     for (const lib of ["nestia-fetcher", "typescript-json"]) {
@@ -64,7 +65,9 @@ function main() {
     return __awaiter(this, void 0, void 0, function* () {
         const type = process_1.default.argv[2];
         const argv = process_1.default.argv.slice(3);
-        if (type === "install")
+        if (type === "start")
+            yield NestiaStarter_1.NestiaStarter.start(argv[0]);
+        else if (type === "install")
             dependencies();
         else if (type === "init")
             yield initialize();
@@ -73,7 +76,7 @@ function main() {
         else if (type === "swagger")
             yield execute((c) => c.swagger(argv));
         else
-            throw new Error(`nestia supports only four commands; (install, init, sdk and swagger), however you've typed the "${process_1.default.argv[2]}"`);
+            throw new Error(`nestia supports only five commands; (start, install, init, sdk and swagger), however you've typed the "${process_1.default.argv[2]}"`);
     });
 }
 main().catch((exp) => {

package/lib/executable/nestia.js.map

@@ -1 +1 @@
-{"version":3,"file":"nestia.js","sourceRoot":"","sources":["../../src/executable/nestia.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,kEAA+B;AAC/B,4CAAoB;AACpB,sDAA8B;AAI9B,SAAS,YAAY;IACjB,uBAAuB;IACvB,KAAK,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,EAAE;QACrD,MAAM,OAAO,GAAW,eAAe,GAAG,EAAE,CAAC;QAC7C,uBAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;KAC9C;AACL,CAAC;AAED,SAAe,UAAU;;QACrB,IAAI,YAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,KAAK,IAAI;YAC1C,MAAM,IAAI,KAAK,CACX,oFAAoF,CACvF,CAAC;QAEN,MAAM,OAAO,GAAW,MAAM,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAC9C,GAAG,SAAS,uCAAuC,EACnD,MAAM,CACT,CAAC;QACF,MAAM,YAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,kBAAkB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;CAAA;AAED,SAAe,OAAO,CAClB,OAA2D;;QAE3D,MAAM,MAAM,GAAG,wDAAa,0BAA0B,GAAC,CAAC;QACxD,MAAM,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACxC,CAAC;CAAA;AAED,SAAe,IAAI;;QACf,MAAM,IAAI,GAAuB,iBAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,IAAI,GAAa,iBAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAE7C,IAAI,IAAI,KAAK,SAAS;YAAE,YAAY,EAAE,CAAC;aAClC,IAAI,IAAI,KAAK,MAAM;YAAE,MAAM,UAAU,EAAE,CAAC;aACxC,IAAI,IAAI,KAAK,KAAK;YAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;aACtD,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;;YAE/D,MAAM,IAAI,KAAK,CACX,mGAAmG,iBAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CACxH,CAAC;IACV,CAAC;CAAA;AACD,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACjB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzB,iBAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACrB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"nestia.js","sourceRoot":"","sources":["../../src/executable/nestia.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,kEAA+B;AAC/B,4CAAoB;AACpB,sDAA8B;AAG9B,4DAAyD;AAEzD,SAAS,YAAY;IACjB,uBAAuB;IACvB,KAAK,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,EAAE;QACrD,MAAM,OAAO,GAAW,eAAe,GAAG,EAAE,CAAC;QAC7C,uBAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;KAC9C;AACL,CAAC;AAED,SAAe,UAAU;;QACrB,IAAI,YAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,KAAK,IAAI;YAC1C,MAAM,IAAI,KAAK,CACX,oFAAoF,CACvF,CAAC;QAEN,MAAM,OAAO,GAAW,MAAM,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAC9C,GAAG,SAAS,uCAAuC,EACnD,MAAM,CACT,CAAC;QACF,MAAM,YAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,kBAAkB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;CAAA;AAED,SAAe,OAAO,CAClB,OAA2D;;QAE3D,MAAM,MAAM,GAAG,wDAAa,0BAA0B,GAAC,CAAC;QACxD,MAAM,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACxC,CAAC;CAAA;AAED,SAAe,IAAI;;QACf,MAAM,IAAI,GAAuB,iBAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,IAAI,GAAa,iBAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAE7C,IAAI,IAAI,KAAK,OAAO;YAAE,MAAM,6BAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;aACpD,IAAI,IAAI,KAAK,SAAS;YAAE,YAAY,EAAE,CAAC;aACvC,IAAI,IAAI,KAAK,MAAM;YAAE,MAAM,UAAU,EAAE,CAAC;aACxC,IAAI,IAAI,KAAK,KAAK;YAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;aACtD,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;;YAE/D,MAAM,IAAI,KAAK,CACX,0GAA0G,iBAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAC/H,CAAC;IACV,CAAC;CAAA;AACD,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACjB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzB,iBAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACrB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nestia",
-  "version": "3.0.17",
+  "version": "3.1.1-dev.20221015",
   "description": "Automatic SDK and Document generator for the NestJS",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",

package/template/.github/workflows/build.yml

@@ -0,0 +1,18 @@
+name: build
+on: [push, pull_request]
+
+jobs:
+  Ubuntu:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+      
+      - name: Install Backend-Server
+        run: npm install
+
+      - name: Compile Backend-Server
+        run: npm run build
+
+      - name: Test Backend-Server
+        run: npm run test

package/template/.vscode/launch.json

@@ -0,0 +1,19 @@
+{
+    // Use IntelliSense to learn about possible Node.js debug attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "type": "node",
+            "request": "launch",
+            "name": "JavaScript Test using SourceMap",
+            "program": "${workspaceRoot}/bin/test/index.js",
+            "cwd": "${workspaceRoot}",
+
+            // TypeScript
+            "sourceMaps": true,
+            "outFiles": ["${workspaceRot}/**.js"]
+        }
+    ]
+}

package/template/.vscode/settings.json

@@ -0,0 +1,10 @@
+{
+  "editor.tabSize": 4,
+  "[typescript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.formatOnSave": true,
+    "editor.codeActionsOnSave": {
+      "source.fixAll.eslint": true
+    },
+  }
+}

package/template/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Jeongho Nam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/template/README.md

@@ -0,0 +1,131 @@
+# Nestia Template
+## Outline
+[![Build Status](https://github.com/samchon/nestia-template/workflows/build/badge.svg)](https://github.com/samchon/nestia-template/actions?query=workflow%3Abuild)
+
+A template repository for backend projects using [nestia](https://github.com/samchon/nestia).
+
+You can create a new project from this boilerplate by running below command:
+
+```bash
+npx nestia start <directory>
+```
+
+For reference, this is a minimal boilerplate project concentrating only on [nestia](https://github.com/samchon/nestia) SDK generation. If you wanna much detailed boilerplate project even configured DB and Non-distruptive update system, visit [samchon/backend](https://github.com/samchon/backend) and create a new repository from that.
+
+
+
+
+## Directories and Files
+This template project has categorized directories like below.
+
+As you can see from the below, all of the TypeScript source files are placed into the [src](src/) directory. When you build the TypeScript source files, compiled files would be placed into the `bin` directory following the [tsconfig.json](tsconfig.json) configuration. Otherwise you build client [SDK](#32-sdk) library for npm publishing and their compiled files would be placed into the [packages](packages) directory.
+
+  - [packages/api/](packages/api): SDK module built by `npm run build:api`
+  - [src/](src): TypeScript source directory
+    - [src/api/](src/api/): Client SDK that would be published to the `@ORGANIZATION/PROJECT-api`
+      - [**src/api/functional/**](src/api/functional/): API functions generated by the [`nestia`](https://github.com/samchon/nestia)
+      - [**src/api/structures/**](src/api/structures/): DTO structures
+    - [src/controllers/](src/controllers/): Controller classes of the Main Program
+    - [**src/test/**](src/test/): Test Automation Program
+  - [nestia.config.ts](nestia.config.ts): Configuration file of [`nestia`](https://github.com/samchon/nestia)
+  - [package.json](package.json): NPM configuration
+  - [tsconfig.json](tsconfig.json): TypeScript configuration for the main program
+  - [tsconfig.api.json](tsconfig.api.json): TypeScript configuration for the SDK generation
+
+
+
+
+## NPM Run Commands
+List of the run commands defined in the [package.json](package.json) are like below:
+
+  - `build`: Compile the source code
+  - `build:api`: Build client SDK libray for the client developers
+  - `build:sdk`: Build SDK into main program only
+  - `build:swagger`: Build Swagger Documents
+  - `dev`: Incremental build for development
+  - `eslint` & `eslint:fix` & `prettier`: Prettier and ESLint execution
+  - `test`: Run test automation program
+
+
+
+
+## Specialization
+Transform this template project to be yours.
+
+When you've created a new backend project through this template project, you can specialize it to be suitable for you by changing some words. Replace below words through IDE specific function like `Edit > Replace in Files` (*Ctrl + Shift + H*), who've been supported by the VSCode.
+
+| Before          | After
+|-----------------|----------------------------------------
+| ORGANIZATION | Your account or corporation name
+| PROJECT      | Your own project name
+| AUTHOR       | Author name
+| https://github.com/samchon/nestia-template | Your repository URL
+
+
+
+
+## Test Driven Development
+With [nestia](https://github.com/samchon/nestia) helps to accomplish TDD (Test Driven Development). 
+
+Just define DTOs and API controllers' methods (only declarations) first. After the definitions, and build SDK (Software Development Kit) through [nestia](https://github.com/samchon/nestia) (`npm run build:sdk`). After buildling those SDK, develop test automation program using the SDK, following use-case scenarios in the framework of client side.
+
+During the test automation program development, you can find that which API is mis-designed or which requirement analysis is not exact. Development of the main program must be the last step after such validation process during TDD.
+
+> Visit the [samchon/backend](https://github.com/samchon/backend), then you may find much detailed story about this TDD.
+>
+> 1. Definitions
+> 2. SDK
+> 3. Test Automation Program
+> 4. Main Program
+
+```typescript
+import TSON from "typescript-json";
+
+import api from "@ORGANIZATION/PROJECT-api/lib/index";
+import { IBbsArticle } from "@ORGANIZATION/PROJECT-api/lib/structures/bbs/IBbsArticle";
+
+import { ArrayUtil } from "../../../../utils/ArrayUtil";
+import { GaffComparator } from "../../../internal/GaffComparator";
+import { RandomGenerator } from "../../../internal/RandomGenerator";
+import { validate_index_sort } from "../../../internal/validate_index_sort";
+
+export async function test_api_bbs_article_index_sort(
+    connection: api.IConnection,
+): Promise<void> {
+    // GENERATE 100 ARTICLES
+    const section: string = "general";
+    const articles: IBbsArticle[] = await ArrayUtil.asyncRepeat(100, () =>
+        api.functional.bbs.articles.store(connection, section, {
+            writer: RandomGenerator.name(),
+            title: RandomGenerator.paragraph(),
+            body: RandomGenerator.content(),
+            format: "txt",
+            files: [],
+            password: RandomGenerator.alphabets(8),
+        }),
+    );
+    TSON.assertEquals(articles);
+
+    // PREPARE VALIDATOR
+    const validator = validate_index_sort("BbsArticleProvider.idex()")(
+        (input: IBbsArticle.IRequest) =>
+            api.functional.bbs.articles.index(connection, section, input),
+    );
+
+    // DO VALIDATE
+    const components = [
+        validator("created_at")(GaffComparator.dates((x) => x.created_at)),
+        validator("updated_at")(GaffComparator.dates((x) => x.updated_at)),
+        validator("title")(GaffComparator.strings((x) => x.title)),
+        validator("writer")(GaffComparator.strings((x) => x.writer)),
+        validator(
+            "writer",
+            "title",
+        )(GaffComparator.strings((x) => [x.writer, x.title])),
+    ];
+    for (const comp of components) {
+        await comp("+");
+        await comp("-");
+    }
+}
+```

package/template/nestia.config.ts

@@ -0,0 +1,12 @@
+// nestia configuration file
+import type nestia from "nestia";
+
+const NESTIA_CONFIG: nestia.IConfiguration = {
+    input: "src/controllers",
+    output: "src/api",
+    swagger: {
+        output: "dist/swagger.json",
+    },
+    primitive: false,
+};
+export default NESTIA_CONFIG;

package/template/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@ORGANIZATION/PROJECT",
+  "version": "0.1.0",
+  "description": "Starter kit of Nestia",
+  "main": "bin/index.js",
+  "scripts": {
+    "build": "rimraf bin && ttsc",
+    "build:api": "rimraf packages/api/lib && npm run build:sdk && ttsc -p tsconfig.api.json",
+    "build:sdk": "npx nestia sdk",
+    "build:swagger": "npx nestia swagger",
+    "eslint": "eslint src",
+    "eslint:fix": "eslint src --fix",
+    "dev": "rimraf bin && ttsc --watch",
+    "prettier": "prettier src --write",
+    "test": "node bin/test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/samchon/nestia-template"
+  },
+  "keywords": [
+    "nestia",
+    "template",
+    "boilerplate"
+  ],
+  "author": "AUTHOR",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/samchon/nestia-template/issues"
+  },
+  "homepage": "https://github.com/samchon/nestia-template#readme",
+  "devDependencies": {
+    "@trivago/prettier-plugin-sort-imports": "^3.3.1",
+    "@types/cli": "^0.11.21",
+    "@types/express": "^4.17.14",
+    "@types/node": "^18.11.0",
+    "@types/uuid": "^8.3.4",
+    "@typescript-eslint/eslint-plugin": "^5.40.0",
+    "@typescript-eslint/parser": "^5.40.0",
+    "chalk": "^4.1.0",
+    "cli": "^1.0.1",
+    "nestia": "^3.1.0",
+    "prettier": "^2.7.1",
+    "rimraf": "^3.0.2",
+    "source-map-support": "^0.5.21",
+    "ts-node": "^10.9.1",
+    "ttypescript": "^1.5.13",
+    "typescript": "^4.8.4",
+    "typescript-transform-paths": "^3.3.1"
+  },
+  "dependencies": {
+    "@nestjs/common": "^9.1.4",
+    "@nestjs/core": "^9.1.4",
+    "@nestjs/platform-express": "^9.1.4",
+    "nestia-helper": "^3.1.6",
+    "raw-body": "^2.5.1",
+    "rxjs": "^7.5.7",
+    "tstl": "^2.5.12",
+    "typescript-json": "^3.3.10",
+    "uuid": "^9.0.0"
+  }
+}

package/template/packages/api/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 ORGANIZATION
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/template/packages/api/README.md

@@ -0,0 +1,66 @@
+# SDK for Client Developers
+## Outline
+[`@ORGANIZATION/PROJECT`](https://github.com/samchon/nestia-template) provides SDK (Software Development Kit) for convenience.
+
+For the client developers who are connecting to this backend server, [`@ORGANIZATION/PROJECT`](https://github.com/samchon/nestia-template) provides not API documents like the Swagger, but provides the API interaction library, one of the typical SDK (Software Development Kit) for the convenience.
+
+With the SDK, client developers never need to re-define the duplicated API interfaces. Just utilize the provided interfaces and asynchronous functions defined in the SDK. It would be much convenient than any other Rest API solutions.
+
+```bash
+npm install --save @ORGANIZATION/PROJECT-api
+```
+
+
+
+
+## Usage
+Import the `@ORGANIZATION/PROJECT-api` and enjoy the auto-completion.
+
+```typescript
+import api from "@ORGINIZATION/PROJECT-api";
+
+import { IBbsArticle } from "@ORGANIZATION/PROJECT-api/lib/structures/bbs/IBbsArticle";
+
+async function main(): Promise<void>
+{
+    //----
+    // PREPARATIONS
+    //----
+    // CONNECTION INFO
+    const connection: api.IConnection = {
+        host: "http://127.0.0.1:37001",
+    };
+
+    const article: IBbsArticle = await api.functional.bbs.articles.store(
+        connection,
+        "general",
+        {
+            writer: "Robot",
+            title: "Hello, world!",
+            body: "Hello, I'm test automation robot",
+            format: "txt",
+            files: [
+                {
+                    name: "logo",
+                    extension: "png",
+                    url: "https://somewhere.com/logo.png",
+                },
+            ],
+            password: "1234",
+        },
+    );
+    TSON.assertEquals(stored);
+
+    const page: IPage<IBbsArticle> = await api.functional.bbs.articles.index(
+        connection,
+        "general",
+        {
+            limit: 100,
+            search: {
+                writer: "Robot"
+            }
+        }
+    );
+    await TSON.assertEquals(page);
+}
+```

package/template/packages/api/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@ORGANIZATION/PROJECT-api",
+  "version": "0.0.0",
+  "description": "API for PROJECT",
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/samchon/nestia-template"
+  },
+  "author": "AUTHOR",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/samchon/nestia-template/issues"
+  },
+  "homepage": "https://github.com/samchon/nestia-template#readme",
+  "dependencies": {
+    "nestia-fetcher": "^2.0.3",
+    "typescript-json": "^3.3.10"
+  }
+}

package/template/src/Backend.ts

@@ -0,0 +1,65 @@
+import { INestApplication } from "@nestjs/common";
+import { NestFactory } from "@nestjs/core";
+import express from "express";
+import helper from "nestia-helper";
+
+import { Configuration } from "./Configuration";
+
+export class Backend {
+    private application_?: INestApplication;
+    private is_closing_: boolean = false;
+
+    public async open(): Promise<void> {
+        //----
+        // OPEN THE BACKEND SERVER
+        //----
+        // MOUNT CONTROLLERS
+        this.application_ = await NestFactory.create(
+            await helper.EncryptedModule.dynamic(
+                __dirname + "/controllers",
+                await Configuration.ENCRYPTION_PASSWORD(),
+            ),
+            { logger: false },
+        );
+
+        // CONFIGURATIONS
+        this.is_closing_ = false;
+        this.application_.enableCors();
+        this.application_.use(this.middleware.bind(this));
+
+        // DO OPEN
+        await this.application_.listen(await Configuration.API_PORT());
+
+        //----
+        // POST-PROCESSES
+        //----
+        // INFORM TO THE PM2
+        if (process.send) process.send("ready");
+
+        // WHEN KILL COMMAND COMES
+        process.on("SIGINT", async () => {
+            this.is_closing_ = true;
+            await this.close();
+            process.exit(0);
+        });
+    }
+
+    public async close(): Promise<void> {
+        if (this.application_ === undefined) return;
+
+        // DO CLOSE
+        await this.application_.close();
+        delete this.application_;
+    }
+
+    private middleware(
+        _request: express.Request,
+        response: express.Response,
+        next: FunctionLike,
+    ): void {
+        if (this.is_closing_ === true) response.set("Connection", "close");
+        next();
+    }
+}
+
+type FunctionLike = (...args: any[]) => any;

package/template/src/Configuration.ts

@@ -0,0 +1,11 @@
+import { IEncryptionPassword } from "nestia-fetcher";
+
+export namespace Configuration {
+    export const API_PORT = async () => 37001;
+    export const ENCRYPTION_PASSWORD = async (): Promise<
+        Readonly<IEncryptionPassword>
+    > => ({
+        key: "pJXhbHlYfzkC1CBK8R67faaBgJWB9Myu",
+        iv: "IXJBt4MflFxvxKkn",
+    });
+}

package/template/src/api/HttpError.ts

@@ -0,0 +1 @@
+export { HttpError } from "nestia-fetcher";

package/template/src/api/IConnection.ts

@@ -0,0 +1 @@
+export { IConnection } from "nestia-fetcher";

package/template/src/api/Primitive.ts

@@ -0,0 +1 @@
+export { Primitive } from "nestia-fetcher";

package/template/src/api/__internal/AesPkcs5.ts

@@ -0,0 +1 @@
+export { AesPkcs5 } from "nestia-fetcher";

package/template/src/api/__internal/Fetcher.ts

@@ -0,0 +1 @@
+export { Fetcher } from "nestia-fetcher";