nestia 2.0.8 → 2.0.11-dev.20220419

package/README.md

@@ -150,7 +150,8 @@ Write below content as the `nestia.config.ts` file and place it onto the root di
 ```typescript
 export = {
     input: "src/controllers",
-    output: "src/api"
+    output: "src/api",
+    assert: false
 };
 ```
 
@@ -160,10 +161,11 @@ export = {
 > export = {
 >     input: "src/**/*.controller.ts",
 >     /* input: {
->         include: ["src/controllers/*.controller.ts"],
->         exclude: ["src/controllers/fake_*.controller.ts"]
+>         include: ["src/controllers/**\/*.controller.ts"],
+>         exclude: ["src/controllers/**\/fake_*.controller.ts"]
 >     },*/
->     output: "src/api"   
+>     output: "src/api",
+>     assert: true
 > }
 > ```
 
@@ -196,9 +198,20 @@ For your deep understanding about this directory structure with this **Nestia**,
 ## Demonstration
 To demonstrate which SDK codes would be generated by this **Nestia**:
 
-  - [Controllers of the NestJS](https://github.surf/samchon/nestia/blob/HEAD/test/default/src/controllers/base/SaleCommentsController.ts)
-  - [Structures used in the RestAPI](https://github.surf/samchon/nestia/blob/HEAD/test/default/src/api/structures/sales/articles/ISaleArticle.ts)
-  - [SDK generated by this **Nestia**](https://github.surf/samchon/nestia/blob/HEAD/test/default/src/api/functional/consumers/sales/reviews/index.ts)
+  - Representative files
+    - [Controllers of the NestJS](https://github.com/samchon/nestia/tree/master/src/test/demonstrations/default/src/controllers/base/SaleCommentsController.ts)
+    - [Structures used in the RestAPI](https://github.com/samchon/nestia/tree/master/src/test/demonstrations/default/src/api/structures/sales/articles/ISaleArticle.ts)
+    - [SDK generated by this **Nestia**](https://github.com/samchon/nestia/tree/master/src/test/demonstrations/default/src/api/functional/consumers/sales/reviews/index.ts)
+  - Demonstration Projects
+    - [absolute](https://github.com/samchon/nestia/tree/master/src/test/demonstrations/absolute): Absolute path with the `baseUrl` option
+    - [alias@api](https://github.com/samchon/nestia/tree/master/src/test/demonstrations/alias@api): The `src/api` directory has been aliased by `paths` option
+    - [alias@src](https://github.com/samchon/nestia/tree/master/src/test/demonstrations/alias@src): Entire `src` directory has been aliased by `paths` option
+    - [default](https://github.com/samchon/nestia/tree/master/src/test/demonstrations/default): No `tsconfig.json` and `nestia.config.ts`
+    - [esnext](https://github.com/samchon/nestia/tree/master/src/test/demonstrations/esnext): ECMAScript target version is `ESNEXT`
+    - [exclude](https://github.com/samchon/nestia/tree/master/src/test/demonstrations/exclude): Exclude option using the `--exclude` commad
+    - [nestia.config.ts](https://github.com/samchon/nestia/tree/master/src/test/demonstrations/nestia.config.ts): Configured `nestia.config.ts` with `assert` mode
+    - [reference](https://github.com/samchon/nestia/tree/master/src/test/demonstrations/reference): Configured input files as `src/**/*.controller.ts`
+    - [tsconfig.json](https://github.com/samchon/nestia/tree/master/src/test/demonstrations/tsconfig.json): Special configuration through the `tsconfig.json`
 
 ### Controller
 If you've decided to adapt this **Nestia** and you want to generate the SDK directly, you don't need any extra work. Just keep you controller class down and do noting. The only one exceptional case that you need an extra dedication is, when you want to explain about the API function to the client developers through the comments.

package/bin/IConfiguration.d.ts

@@ -4,6 +4,7 @@ export interface IConfiguration {
     output: string;
     compilerOptions?: tsc.CompilerOptions;
     assert?: boolean;
+    json?: boolean;
 }
 export declare namespace IConfiguration {
     interface IInput {

package/bin/IConfiguration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IConfiguration.d.ts","sourceRoot":"","sources":["../src/IConfiguration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAElC,MAAM,WAAW,cAAc;IAE3B,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AACD,yBAAiB,cAAc,CAC/B;IACI,UAAiB,MAAM;QAEnB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB;CACJ"}
+{"version":3,"file":"IConfiguration.d.ts","sourceRoot":"","sources":["../src/IConfiguration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAElC,MAAM,WAAW,cAAc;IAE3B,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AACD,yBAAiB,cAAc,CAC/B;IACI,UAAiB,MAAM;QAEnB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB;CACJ"}

package/bin/analyses/ReflectAnalyzer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReflectAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analyses/ReflectAnalyzer.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAQxD,yBAAiB,eAAe,CAChC;IACI,SAAsB,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAiBxF;CA2LJ"}
+{"version":3,"file":"ReflectAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analyses/ReflectAnalyzer.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAQxD,yBAAiB,eAAe,CAChC;IACI,SAAsB,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAiBxF;CA4LJ"}

package/bin/analyses/ReflectAnalyzer.js

@@ -181,11 +181,12 @@ var ReflectAnalyzer;
         return meta;
     }
     function _Get_prototype_entries(creator) {
-        var tuple = Object.entries(creator.prototype);
+        var keyList = Object.getOwnPropertyNames(creator.prototype);
+        var entries = keyList.map(function (key) { return [key, creator.prototype[key]]; });
         var parent = Object.getPrototypeOf(creator);
         if (parent.prototype !== undefined)
-            tuple.push.apply(tuple, __spreadArray([], __read(_Get_prototype_entries(parent)), false));
-        return tuple;
+            entries.push.apply(entries, __spreadArray([], __read(_Get_prototype_entries(parent)), false));
+        return entries;
     }
     /* ---------------------------------------------------------
         FUNCTION

package/bin/executable/internal/NestiaConfig.js

@@ -136,6 +136,14 @@ var NestiaConfig;
                 if (error)
                     return error;
             }
+        } {
+            if ("json" in object) {
+                path.push("json");
+                var error = su__undefined__3__4_eu(object["json"]);
+                path.pop();
+                if (error)
+                    return error;
+            }
         } return null; } return _0(object); });
         if ((0, typescript_is_1.is)(config.input, function (object) { function _string(object) { ; if (typeof object !== "string")
             return {};

package/bin/generates/FileGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileGenerator.d.ts","sourceRoot":"","sources":["../../src/generates/FileGenerator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAI9C,yBAAiB,aAAa,CAC9B;IAII,SAAsB,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAYzF;CA4GJ"}
+{"version":3,"file":"FileGenerator.d.ts","sourceRoot":"","sources":["../../src/generates/FileGenerator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAI9C,yBAAiB,aAAa,CAC9B;IAII,SAAsB,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAYzF;CA+GJ"}

package/bin/generates/FileGenerator.js

@@ -104,7 +104,7 @@ var FileGenerator;
                         // RELOCATE FOR ONLY ONE CONTROLLER METHOD IN AN URL CASE
                         relocate(root);
                         // ITERATE FILES
-                        return [4 /*yield*/, iterate(!!config.assert, config.output + "/functional", root)];
+                        return [4 /*yield*/, iterate(config, config.output + "/functional", root)];
                     case 1:
                         // ITERATE FILES
                         _b.sent();
@@ -168,9 +168,9 @@ var FileGenerator;
     /* ---------------------------------------------------------
         FILE ITERATOR
     --------------------------------------------------------- */
-    function iterate(assert, outDir, directory) {
+    function iterate(config, outDir, directory) {
         return __awaiter(this, void 0, void 0, function () {
-            var _a, content, _b, _c, it, e_4_1, importDict, _d, _e, route, _f, _g, tuple, _h, _j, instance, primitived, asserted, fetcher;
+            var _a, content, _b, _c, it, e_4_1, importDict, _d, _e, route, _f, _g, tuple, _h, _j, instance, primitived, asserted, json, fetcher;
             var e_4, _k, e_5, _l, e_6, _m, e_7, _o;
             return __generator(this, function (_p) {
                 switch (_p.label) {
@@ -193,7 +193,7 @@ var FileGenerator;
                     case 5:
                         if (!!_c.done) return [3 /*break*/, 8];
                         it = _c.value;
-                        return [4 /*yield*/, iterate(assert, "".concat(outDir, "/").concat(it.first), it.second)];
+                        return [4 /*yield*/, iterate(config, "".concat(outDir, "/").concat(it.first), it.second)];
                     case 6:
                         _p.sent();
                         content += "export * as ".concat(it.first, " from \"./").concat(it.first, "\";\n");
@@ -243,7 +243,7 @@ var FileGenerator;
                                     }
                                     finally { if (e_6) throw e_6.error; }
                                 }
-                                content += FunctionGenerator_1.FunctionGenerator.generate(assert, route) + "\n\n";
+                                content += FunctionGenerator_1.FunctionGenerator.generate(config, route) + "\n\n";
                             }
                         }
                         catch (e_5_1) { e_5 = { error: e_5_1 }; }
@@ -257,8 +257,10 @@ var FileGenerator;
                         if (directory.routes.length !== 0) {
                             primitived = directory.routes.some(function (route) { return route.output !== "void"
                                 || route.parameters.some(function (param) { return param.category !== "param"; }); });
-                            asserted = assert
+                            asserted = config.assert === true
                                 && directory.routes.some(function (route) { return route.parameters.length !== 0; });
+                            json = config.json === true
+                                && directory.routes.some(function (route) { return route.method === "POST" || route.method === "PUT" || route.method === "PATCH"; });
                             fetcher = ["Fetcher"];
                             if (primitived)
                                 fetcher.push("Primitive");
@@ -266,6 +268,7 @@ var FileGenerator;
                                 + "import { ".concat(fetcher.join(", "), " } from \"nestia-fetcher\";\n")
                                 + "import type { IConnection } from \"nestia-fetcher\";\n"
                                 + (asserted ? "import { assertType } from \"typescript-is\";\n" : "")
+                                + (json ? "import { createStringifier } from \"typescript-json\";\n" : "")
                                 +
                                     (importDict.empty()
                                         ? ""

package/bin/generates/FunctionGenerator.d.ts

@@ -1,5 +1,6 @@
+import { IConfiguration } from "../IConfiguration";
 import { IRoute } from "../structures/IRoute";
 export declare namespace FunctionGenerator {
-    function generate(assert: boolean, route: IRoute): string;
+    function generate(config: IConfiguration, route: IRoute): string;
 }
 //# sourceMappingURL=FunctionGenerator.d.ts.map

package/bin/generates/FunctionGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FunctionGenerator.d.ts","sourceRoot":"","sources":["../../src/generates/FunctionGenerator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,yBAAiB,iBAAiB,CAClC;IACI,SAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAS/D;CAuLJ"}
+{"version":3,"file":"FunctionGenerator.d.ts","sourceRoot":"","sources":["../../src/generates/FunctionGenerator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,yBAAiB,iBAAiB,CAClC;IACI,SAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAStE;CAkMJ"}

package/bin/generates/FunctionGenerator.js

@@ -41,11 +41,11 @@ var Pair_1 = require("tstl/utility/Pair");
 var Vector_1 = require("tstl/container/Vector");
 var FunctionGenerator;
 (function (FunctionGenerator) {
-    function generate(assert, route) {
+    function generate(config, route) {
         var query = route.parameters.find(function (param) { return param.category === "query"; });
         var input = route.parameters.find(function (param) { return param.category === "body"; });
         return [head, body, tail]
-            .map(function (closure) { return closure(route, query, input, assert); })
+            .map(function (closure) { return closure(route, query, input, config); })
             .filter(function (str) { return !!str; })
             .join("\n");
     }
@@ -53,7 +53,7 @@ var FunctionGenerator;
     /* ---------------------------------------------------------
         BODY
     --------------------------------------------------------- */
-    function body(route, query, input, assert) {
+    function body(route, query, input, config) {
         // FETCH ARGUMENTS WITH REQUST BODY
         var parameters = filter_parameters(route, query);
         var fetchArguments = [
@@ -62,9 +62,12 @@ var FunctionGenerator;
             "".concat(route.name, ".METHOD"),
             "".concat(route.name, ".path(").concat(parameters.map(function (p) { return p.name; }).join(", "), ")")
         ];
-        if (input !== undefined)
+        if (input !== undefined) {
             fetchArguments.push(input.name);
-        var assertions = assert === true && route.parameters.length !== 0
+            if (config.json === true)
+                fetchArguments.push("".concat(route.name, ".stringify"));
+        }
+        var assertions = config.assert === true && route.parameters.length !== 0
             ? route.parameters
                 .map(function (param) { return "    assertType<typeof ".concat(param.name, ">(").concat(param.name, ");"); })
                 .join("\n") + "\n\n"
@@ -153,7 +156,7 @@ var FunctionGenerator;
             + "".concat(parameters.map(function (str) { return "        ".concat(str); }).join(",\n"), "\n")
             + "    ): Promise<".concat(output, ">");
     }
-    function tail(route, query, input) {
+    function tail(route, query, input, config) {
         var e_1, _a;
         // LIST UP TYPES
         var types = [];
@@ -201,6 +204,10 @@ var FunctionGenerator;
             + "    {\n"
             + "        return ".concat(path, ";\n")
             + "    }\n"
+            +
+                (config.json === true && (route.method === "POST" || route.method === "PUT" || route.method === "PATCH")
+                    ? "    export const stringify = createStringifier<Input>()\n"
+                    : "")
             + "}";
     }
 })(FunctionGenerator = exports.FunctionGenerator || (exports.FunctionGenerator = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nestia",
-  "version": "2.0.8",
+  "version": "2.0.11-dev.20220419",
   "description": "Automatic SDK and Document generator for the NestJS",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -34,6 +34,7 @@
     "del": "^6.0.0",
     "glob": "^7.2.0",
     "jsonc-simple-parser": "^2.2.1",
+    "nestia-fetcher": "^2.0.1",
     "tgrid": "^0.8.6",
     "ts-node": "^10.4.0",
     "tsconfig-paths": "^3.14.1",
@@ -41,6 +42,7 @@
     "ttypescript": "^1.5.13",
     "typescript": "^4.6.3",
     "typescript-is": "^0.19.0",
+    "typescript-json": "^2.0.0",
     "typescript-transform-paths": "^3.3.1"
   },
   "devDependencies": {