nestia 3.0.15 → 3.0.16-dev.20220930

package/lib/IConfiguration.d.ts

@@ -1,110 +1,110 @@
-import ts from "typescript";
-import type { StripEnums } from "./utils/StripEnums";
-/**
- * Definition for the `nestia.config.ts` file.
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export interface IConfiguration {
-    /**
-     * List of files or directories containing the NestJS controller classes.
-     */
-    input: string | string[] | IConfiguration.IInput;
-    /**
-     * Output directory that SDK would be placed in.
-     *
-     * If not configured, you can't build the SDK library.
-     */
-    output?: string;
-    /**
-     * Compiler options for the TypeScript.
-     *
-     * If you've omitted this property or the assigned property cannot fully cover the
-     * `tsconfig.json`, the properties from the `tsconfig.json` would be assigned to here.
-     * Otherwise, this property has been configured and it's detailed values are different
-     * with the `tsconfig.json`, this property values would be used instead.
-     *
-     * ```typescript
-     * import ts from "typescript";
-     *
-     * const tsconfig: ts.TsConfig;
-     * const nestiaConfig: IConfiguration;
-     *
-     * const compilerOptions: ts.CompilerOptions = {
-     *     ...tsconfig.compilerOptions,
-     *     ...(nestiaConfig.compilerOptions || {})
-     * }
-     * ```
-     */
-    compilerOptions?: StripEnums<ts.CompilerOptions>;
-    /**
-     * Whether to assert parameter types or not.
-     *
-     * If you configure this property to be `true`, all of the function parameters would be
-     * checked through the [typescript-json](https://github.com/samchon/typescript-json#runtime-type-checkers).
-     * This option would make your SDK library slower, but would enahcne the type safety even
-     * in the runtime level.
-     *
-     * @default false
-     */
-    assert?: boolean;
-    /**
-     * Whether to optimize JSON string conversion 2x faster or not.
-     *
-     * If you configure this property to be `true`, the SDK library would utilize the
-     * [typescript-json](https://github.com/samchon/typescript-json#fastest-json-string-converter)
-     * and the JSON string conversion speed really be 2x faster.
-     *
-     * @default false
-     */
-    json?: boolean;
-    /**
-     * Whether to wrap DTO by primitive type.
-     *
-     * If you don't configure this property as `false`, all of DTOs in the
-     * SDK library would be automatically wrapped by {@link Primitive} type.
-     *
-     * For refenrece, if a DTO type be capsuled by the {@link Primitive} type,
-     * all of methods in the DTO type would be automatically erased. Also, if
-     * the DTO has a `toJSON()` method, the DTO type would be automatically
-     * converted to return type of the `toJSON()` method.
-     *
-     * @default true
-     */
-    primitive?: boolean;
-    /**
-     * Building `swagger.json` is also possible.
-     *
-     * If not specified, you can't build the `swagger.json`.
-     */
-    swagger?: IConfiguration.ISwagger;
-}
-export declare namespace IConfiguration {
-    /**
-     * List of files or directories to include or exclude to specifying the NestJS
-     * controllers.
-     */
-    interface IInput {
-        /**
-         * List of files or directories containing the NestJS controller classes.
-         */
-        include: string[];
-        /**
-         * List of files or directories to be excluded.
-         */
-        exclude?: string[];
-    }
-    /**
-     * Building `swagger.json` is also possible.
-     */
-    interface ISwagger {
-        /**
-         * Output path of the `swagger.json`.
-         *
-         * If you've configured only directory, the file name would be the `swagger.json`.
-         * Otherwise you've configured the full path with file name and extension, the
-         * `swagger.json` file would be renamed to it.
-         */
-        output: string;
-    }
-}
+import ts from "typescript";
+import type { StripEnums } from "./utils/StripEnums";
+/**
+ * Definition for the `nestia.config.ts` file.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface IConfiguration {
+    /**
+     * List of files or directories containing the NestJS controller classes.
+     */
+    input: string | string[] | IConfiguration.IInput;
+    /**
+     * Output directory that SDK would be placed in.
+     *
+     * If not configured, you can't build the SDK library.
+     */
+    output?: string;
+    /**
+     * Compiler options for the TypeScript.
+     *
+     * If you've omitted this property or the assigned property cannot fully cover the
+     * `tsconfig.json`, the properties from the `tsconfig.json` would be assigned to here.
+     * Otherwise, this property has been configured and it's detailed values are different
+     * with the `tsconfig.json`, this property values would be used instead.
+     *
+     * ```typescript
+     * import ts from "typescript";
+     *
+     * const tsconfig: ts.TsConfig;
+     * const nestiaConfig: IConfiguration;
+     *
+     * const compilerOptions: ts.CompilerOptions = {
+     *     ...tsconfig.compilerOptions,
+     *     ...(nestiaConfig.compilerOptions || {})
+     * }
+     * ```
+     */
+    compilerOptions?: StripEnums<ts.CompilerOptions>;
+    /**
+     * Whether to assert parameter types or not.
+     *
+     * If you configure this property to be `true`, all of the function parameters would be
+     * checked through the [typescript-json](https://github.com/samchon/typescript-json#runtime-type-checkers).
+     * This option would make your SDK library slower, but would enahcne the type safety even
+     * in the runtime level.
+     *
+     * @default false
+     */
+    assert?: boolean;
+    /**
+     * Whether to optimize JSON string conversion 2x faster or not.
+     *
+     * If you configure this property to be `true`, the SDK library would utilize the
+     * [typescript-json](https://github.com/samchon/typescript-json#fastest-json-string-converter)
+     * and the JSON string conversion speed really be 2x faster.
+     *
+     * @default false
+     */
+    json?: boolean;
+    /**
+     * Whether to wrap DTO by primitive type.
+     *
+     * If you don't configure this property as `false`, all of DTOs in the
+     * SDK library would be automatically wrapped by {@link Primitive} type.
+     *
+     * For refenrece, if a DTO type be capsuled by the {@link Primitive} type,
+     * all of methods in the DTO type would be automatically erased. Also, if
+     * the DTO has a `toJSON()` method, the DTO type would be automatically
+     * converted to return type of the `toJSON()` method.
+     *
+     * @default true
+     */
+    primitive?: boolean;
+    /**
+     * Building `swagger.json` is also possible.
+     *
+     * If not specified, you can't build the `swagger.json`.
+     */
+    swagger?: IConfiguration.ISwagger;
+}
+export declare namespace IConfiguration {
+    /**
+     * List of files or directories to include or exclude to specifying the NestJS
+     * controllers.
+     */
+    interface IInput {
+        /**
+         * List of files or directories containing the NestJS controller classes.
+         */
+        include: string[];
+        /**
+         * List of files or directories to be excluded.
+         */
+        exclude?: string[];
+    }
+    /**
+     * Building `swagger.json` is also possible.
+     */
+    interface ISwagger {
+        /**
+         * Output path of the `swagger.json`.
+         *
+         * If you've configured only directory, the file name would be the `swagger.json`.
+         * Otherwise you've configured the full path with file name and extension, the
+         * `swagger.json` file would be renamed to it.
+         */
+        output: string;
+    }
+}

package/lib/IConfiguration.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=IConfiguration.js.map

package/lib/NestiaApplication.d.ts

@@ -1,11 +1,11 @@
-import { IConfiguration } from "./IConfiguration";
-export declare class NestiaApplication {
-    private readonly config_;
-    private readonly bundle_checker_;
-    constructor(config: IConfiguration);
-    sdk(): Promise<void>;
-    swagger(): Promise<void>;
-    private generate;
-    private prepare;
-    private is_not_excluded;
-}
+import { IConfiguration } from "./IConfiguration";
+export declare class NestiaApplication {
+    private readonly config_;
+    private readonly bundle_checker_;
+    constructor(config: IConfiguration);
+    sdk(): Promise<void>;
+    swagger(): Promise<void>;
+    private generate;
+    private prepare;
+    private is_not_excluded;
+}

package/lib/NestiaApplication.js

@@ -1,156 +1,156 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-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.NestiaApplication = void 0;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const runner = __importStar(require("ts-node"));
-const typescript_1 = __importDefault(require("typescript"));
-const Pair_1 = require("tstl/utility/Pair");
-const Singleton_1 = require("tstl/thread/Singleton");
-const ControllerAnalyzer_1 = require("./analyses/ControllerAnalyzer");
-const ReflectAnalyzer_1 = require("./analyses/ReflectAnalyzer");
-const SourceFinder_1 = require("./analyses/SourceFinder");
-const SdkGenerator_1 = require("./generates/SdkGenerator");
-const SwaggerGenerator_1 = require("./generates/SwaggerGenerator");
-const ArrayUtil_1 = require("./utils/ArrayUtil");
-const CompilerOptions_1 = require("./executable/internal/CompilerOptions");
-class NestiaApplication {
-    constructor(config) {
-        this.config_ = config;
-        this.bundle_checker_ = new Singleton_1.Singleton(() => __awaiter(this, void 0, void 0, function* () {
-            if (!this.config_.output)
-                return () => false;
-            const bundles = yield fs_1.default.promises.readdir(SdkGenerator_1.SdkGenerator.BUNDLE_PATH);
-            const tuples = yield ArrayUtil_1.ArrayUtil.asyncMap(bundles, (file) => __awaiter(this, void 0, void 0, function* () {
-                const relative = path_1.default.join(this.config_.output, file);
-                const location = path_1.default.join(SdkGenerator_1.SdkGenerator.BUNDLE_PATH, file);
-                const stats = yield fs_1.default.promises.stat(location);
-                return new Pair_1.Pair(relative, stats.isDirectory());
-            }));
-            return (file) => {
-                for (const it of tuples)
-                    if (it.second === false && file === it.first)
-                        return true;
-                    else if (it.second === true && file.indexOf(it.first) === 0)
-                        return true;
-                return false;
-            };
-        }));
-    }
-    sdk() {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!this.config_.output)
-                throw new Error("Error on NestiaApplication.sdk(): output path is not specified.");
-            const parent = path_1.default.resolve(this.config_.output + "/..");
-            const stats = yield fs_1.default.promises.lstat(parent);
-            if (stats.isDirectory() === false)
-                throw new Error("Error on NestiaApplication.sdk(): output directory does not exists.");
-            yield this.generate((config) => config, SdkGenerator_1.SdkGenerator.generate);
-        });
-    }
-    swagger() {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!this.config_.swagger || !this.config_.swagger.output)
-                throw new Error(`Error on NestiaApplication.swagger(): output path of the "swagger.json" is not specified.`);
-            const parsed = path_1.default.parse(this.config_.swagger.output);
-            const directory = !!parsed.ext
-                ? path_1.default.resolve(parsed.dir)
-                : this.config_.swagger.output;
-            const stats = yield fs_1.default.promises.lstat(directory);
-            if (stats.isDirectory() === false)
-                throw new Error("Error on NestiaApplication.swagger(): output directory does not exists.");
-            yield this.generate((config) => config.swagger, SwaggerGenerator_1.SwaggerGenerator.generate);
-        });
-    }
-    generate(config, archiver) {
-        return __awaiter(this, void 0, void 0, function* () {
-            // MOUNT TS-NODE
-            this.prepare();
-            // LOAD CONTROLLER FILES
-            const input = this.config_.input instanceof Array
-                ? { include: this.config_.input }
-                : typeof this.config_.input === "string"
-                    ? { include: [this.config_.input] }
-                    : this.config_.input;
-            const fileList = yield ArrayUtil_1.ArrayUtil.asyncFilter(yield SourceFinder_1.SourceFinder.find(input), (file) => this.is_not_excluded(file));
-            // ANALYZE REFLECTS
-            const unique = new WeakSet();
-            const controllerList = [];
-            for (const file of fileList)
-                controllerList.push(...(yield ReflectAnalyzer_1.ReflectAnalyzer.analyze(unique, file)));
-            // ANALYZE TYPESCRIPT CODE
-            const program = typescript_1.default.createProgram(controllerList.map((c) => c.file), this.config_.compilerOptions || { noEmit: true });
-            const checker = program.getTypeChecker();
-            const routeList = [];
-            for (const controller of controllerList) {
-                const sourceFile = program.getSourceFile(controller.file);
-                if (sourceFile === undefined)
-                    continue;
-                routeList.push(...ControllerAnalyzer_1.ControllerAnalyzer.analyze(checker, sourceFile, controller));
-            }
-            // DO GENERATE
-            yield archiver(checker, config(this.config_), routeList);
-        });
-    }
-    prepare() {
-        var _a;
-        // CONSTRUCT OPTIONS
-        if (!this.config_.compilerOptions)
-            this.config_.compilerOptions =
-                CompilerOptions_1.CompilerOptions.DEFAULT_OPTIONS;
-        const absoluted = !!((_a = this.config_.compilerOptions) === null || _a === void 0 ? void 0 : _a.baseUrl);
-        // MOUNT TS-NODE
-        runner.register({
-            emit: false,
-            compiler: "ttypescript",
-            compilerOptions: this.config_.compilerOptions,
-            require: absoluted ? ["tsconfig-paths/register"] : undefined,
-        });
-    }
-    is_not_excluded(file) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (this.config_.output)
-                return (file.indexOf(path_1.default.join(this.config_.output, "functional")) ===
-                    -1 && (yield this.bundle_checker_.get())(file) === false);
-            const content = yield fs_1.default.promises.readFile(file, "utf8");
-            return (content.indexOf(" * @nestia Generated by Nestia - https://github.com/samchon/nestia") === -1);
-        });
-    }
-}
-exports.NestiaApplication = NestiaApplication;
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+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.NestiaApplication = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const runner = __importStar(require("ts-node"));
+const typescript_1 = __importDefault(require("typescript"));
+const Pair_1 = require("tstl/utility/Pair");
+const Singleton_1 = require("tstl/thread/Singleton");
+const ControllerAnalyzer_1 = require("./analyses/ControllerAnalyzer");
+const ReflectAnalyzer_1 = require("./analyses/ReflectAnalyzer");
+const SourceFinder_1 = require("./analyses/SourceFinder");
+const SdkGenerator_1 = require("./generates/SdkGenerator");
+const SwaggerGenerator_1 = require("./generates/SwaggerGenerator");
+const ArrayUtil_1 = require("./utils/ArrayUtil");
+const CompilerOptions_1 = require("./executable/internal/CompilerOptions");
+class NestiaApplication {
+    constructor(config) {
+        this.config_ = config;
+        this.bundle_checker_ = new Singleton_1.Singleton(() => __awaiter(this, void 0, void 0, function* () {
+            if (!this.config_.output)
+                return () => false;
+            const bundles = yield fs_1.default.promises.readdir(SdkGenerator_1.SdkGenerator.BUNDLE_PATH);
+            const tuples = yield ArrayUtil_1.ArrayUtil.asyncMap(bundles, (file) => __awaiter(this, void 0, void 0, function* () {
+                const relative = path_1.default.join(this.config_.output, file);
+                const location = path_1.default.join(SdkGenerator_1.SdkGenerator.BUNDLE_PATH, file);
+                const stats = yield fs_1.default.promises.stat(location);
+                return new Pair_1.Pair(relative, stats.isDirectory());
+            }));
+            return (file) => {
+                for (const it of tuples)
+                    if (it.second === false && file === it.first)
+                        return true;
+                    else if (it.second === true && file.indexOf(it.first) === 0)
+                        return true;
+                return false;
+            };
+        }));
+    }
+    sdk() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.config_.output)
+                throw new Error("Error on NestiaApplication.sdk(): output path is not specified.");
+            const parent = path_1.default.resolve(this.config_.output + "/..");
+            const stats = yield fs_1.default.promises.lstat(parent);
+            if (stats.isDirectory() === false)
+                throw new Error("Error on NestiaApplication.sdk(): output directory does not exists.");
+            yield this.generate((config) => config, SdkGenerator_1.SdkGenerator.generate);
+        });
+    }
+    swagger() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.config_.swagger || !this.config_.swagger.output)
+                throw new Error(`Error on NestiaApplication.swagger(): output path of the "swagger.json" is not specified.`);
+            const parsed = path_1.default.parse(this.config_.swagger.output);
+            const directory = !!parsed.ext
+                ? path_1.default.resolve(parsed.dir)
+                : this.config_.swagger.output;
+            const stats = yield fs_1.default.promises.lstat(directory);
+            if (stats.isDirectory() === false)
+                throw new Error("Error on NestiaApplication.swagger(): output directory does not exists.");
+            yield this.generate((config) => config.swagger, SwaggerGenerator_1.SwaggerGenerator.generate);
+        });
+    }
+    generate(config, archiver) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // MOUNT TS-NODE
+            this.prepare();
+            // LOAD CONTROLLER FILES
+            const input = this.config_.input instanceof Array
+                ? { include: this.config_.input }
+                : typeof this.config_.input === "string"
+                    ? { include: [this.config_.input] }
+                    : this.config_.input;
+            const fileList = yield ArrayUtil_1.ArrayUtil.asyncFilter(yield SourceFinder_1.SourceFinder.find(input), (file) => this.is_not_excluded(file));
+            // ANALYZE REFLECTS
+            const unique = new WeakSet();
+            const controllerList = [];
+            for (const file of fileList)
+                controllerList.push(...(yield ReflectAnalyzer_1.ReflectAnalyzer.analyze(unique, file)));
+            // ANALYZE TYPESCRIPT CODE
+            const program = typescript_1.default.createProgram(controllerList.map((c) => c.file), this.config_.compilerOptions || { noEmit: true });
+            const checker = program.getTypeChecker();
+            const routeList = [];
+            for (const controller of controllerList) {
+                const sourceFile = program.getSourceFile(controller.file);
+                if (sourceFile === undefined)
+                    continue;
+                routeList.push(...ControllerAnalyzer_1.ControllerAnalyzer.analyze(checker, sourceFile, controller));
+            }
+            // DO GENERATE
+            yield archiver(checker, config(this.config_), routeList);
+        });
+    }
+    prepare() {
+        var _a;
+        // CONSTRUCT OPTIONS
+        if (!this.config_.compilerOptions)
+            this.config_.compilerOptions =
+                CompilerOptions_1.CompilerOptions.DEFAULT_OPTIONS;
+        const absoluted = !!((_a = this.config_.compilerOptions) === null || _a === void 0 ? void 0 : _a.baseUrl);
+        // MOUNT TS-NODE
+        runner.register({
+            emit: false,
+            compiler: "ttypescript",
+            compilerOptions: this.config_.compilerOptions,
+            require: absoluted ? ["tsconfig-paths/register"] : undefined,
+        });
+    }
+    is_not_excluded(file) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.config_.output)
+                return (file.indexOf(path_1.default.join(this.config_.output, "functional")) ===
+                    -1 && (yield this.bundle_checker_.get())(file) === false);
+            const content = yield fs_1.default.promises.readFile(file, "utf8");
+            return (content.indexOf(" * @nestia Generated by Nestia - https://github.com/samchon/nestia") === -1);
+        });
+    }
+}
+exports.NestiaApplication = NestiaApplication;
 //# sourceMappingURL=NestiaApplication.js.map

package/lib/analyses/ControllerAnalyzer.d.ts

@@ -1,6 +1,6 @@
-import ts from "typescript";
-import { IController } from "../structures/IController";
-import { IRoute } from "../structures/IRoute";
-export declare namespace ControllerAnalyzer {
-    function analyze(checker: ts.TypeChecker, sourceFile: ts.SourceFile, controller: IController): IRoute[];
-}
+import ts from "typescript";
+import { IController } from "../structures/IController";
+import { IRoute } from "../structures/IRoute";
+export declare namespace ControllerAnalyzer {
+    function analyze(checker: ts.TypeChecker, sourceFile: ts.SourceFile, controller: IController): IRoute[];
+}