@nestia/core 1.1.1 → 1.1.2-dev.20230503-2

package/lib/utils/SourceFinder.js

@@ -0,0 +1,239 @@
+"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 __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SourceFinder = void 0;
+var fs_1 = __importDefault(require("fs"));
+var glob_1 = __importDefault(require("glob"));
+var path_1 = __importDefault(require("path"));
+var SourceFinder;
+(function (SourceFinder) {
+    var _this = this;
+    SourceFinder.find = function (props) { return __awaiter(_this, void 0, void 0, function () {
+        var dict;
+        var _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    dict = new Set();
+                    return [4 /*yield*/, emplace(props.filter)(props.include)(function (str) { return dict.add(str); })];
+                case 1:
+                    _b.sent();
+                    if (!((_a = props.exclude) === null || _a === void 0 ? void 0 : _a.length)) return [3 /*break*/, 3];
+                    return [4 /*yield*/, emplace(props.filter)(props.exclude)(function (str) {
+                            return dict.delete(str);
+                        })];
+                case 2:
+                    _b.sent();
+                    _b.label = 3;
+                case 3: return [2 /*return*/, __spreadArray([], __read(dict), false)];
+            }
+        });
+    }); };
+    var emplace = function (filter) {
+        return function (input) {
+            return function (closure) { return __awaiter(_this, void 0, void 0, function () {
+                var input_1, input_1_1, pattern, _a, _b, file, stats, e_1_1, e_2_1;
+                var e_2, _c, e_1, _d;
+                return __generator(this, function (_e) {
+                    switch (_e.label) {
+                        case 0:
+                            _e.trys.push([0, 14, 15, 16]);
+                            input_1 = __values(input), input_1_1 = input_1.next();
+                            _e.label = 1;
+                        case 1:
+                            if (!!input_1_1.done) return [3 /*break*/, 13];
+                            pattern = input_1_1.value;
+                            _e.label = 2;
+                        case 2:
+                            _e.trys.push([2, 10, 11, 12]);
+                            e_1 = void 0;
+                            return [4 /*yield*/, _Glob(path_1.default.resolve(pattern))];
+                        case 3:
+                            _a = (__values.apply(void 0, [_e.sent()])), _b = _a.next();
+                            _e.label = 4;
+                        case 4:
+                            if (!!_b.done) return [3 /*break*/, 9];
+                            file = _b.value;
+                            return [4 /*yield*/, fs_1.default.promises.stat(file)];
+                        case 5:
+                            stats = _e.sent();
+                            if (!(stats.isDirectory() === true)) return [3 /*break*/, 7];
+                            return [4 /*yield*/, iterate(filter)(closure)(file)];
+                        case 6:
+                            _e.sent();
+                            return [3 /*break*/, 8];
+                        case 7:
+                            if (stats.isFile() && filter(file))
+                                closure(file);
+                            _e.label = 8;
+                        case 8:
+                            _b = _a.next();
+                            return [3 /*break*/, 4];
+                        case 9: return [3 /*break*/, 12];
+                        case 10:
+                            e_1_1 = _e.sent();
+                            e_1 = { error: e_1_1 };
+                            return [3 /*break*/, 12];
+                        case 11:
+                            try {
+                                if (_b && !_b.done && (_d = _a.return)) _d.call(_a);
+                            }
+                            finally { if (e_1) throw e_1.error; }
+                            return [7 /*endfinally*/];
+                        case 12:
+                            input_1_1 = input_1.next();
+                            return [3 /*break*/, 1];
+                        case 13: return [3 /*break*/, 16];
+                        case 14:
+                            e_2_1 = _e.sent();
+                            e_2 = { error: e_2_1 };
+                            return [3 /*break*/, 16];
+                        case 15:
+                            try {
+                                if (input_1_1 && !input_1_1.done && (_c = input_1.return)) _c.call(input_1);
+                            }
+                            finally { if (e_2) throw e_2.error; }
+                            return [7 /*endfinally*/];
+                        case 16: return [2 /*return*/];
+                    }
+                });
+            }); };
+        };
+    };
+    var iterate = function (filter) {
+        return function (closure) {
+            return function (location) { return __awaiter(_this, void 0, void 0, function () {
+                var directory, directory_1, directory_1_1, file, next, stats, e_3_1;
+                var e_3, _a;
+                return __generator(this, function (_b) {
+                    switch (_b.label) {
+                        case 0: return [4 /*yield*/, fs_1.default.promises.readdir(location)];
+                        case 1:
+                            directory = _b.sent();
+                            _b.label = 2;
+                        case 2:
+                            _b.trys.push([2, 9, 10, 11]);
+                            directory_1 = __values(directory), directory_1_1 = directory_1.next();
+                            _b.label = 3;
+                        case 3:
+                            if (!!directory_1_1.done) return [3 /*break*/, 8];
+                            file = directory_1_1.value;
+                            next = path_1.default.resolve("".concat(location, "/").concat(file));
+                            return [4 /*yield*/, fs_1.default.promises.stat(next)];
+                        case 4:
+                            stats = _b.sent();
+                            if (!(stats.isDirectory() === true)) return [3 /*break*/, 6];
+                            return [4 /*yield*/, iterate(filter)(closure)(next)];
+                        case 5:
+                            _b.sent();
+                            return [3 /*break*/, 7];
+                        case 6:
+                            if (stats.isFile() && filter(next))
+                                closure(next);
+                            _b.label = 7;
+                        case 7:
+                            directory_1_1 = directory_1.next();
+                            return [3 /*break*/, 3];
+                        case 8: return [3 /*break*/, 11];
+                        case 9:
+                            e_3_1 = _b.sent();
+                            e_3 = { error: e_3_1 };
+                            return [3 /*break*/, 11];
+                        case 10:
+                            try {
+                                if (directory_1_1 && !directory_1_1.done && (_a = directory_1.return)) _a.call(directory_1);
+                            }
+                            finally { if (e_3) throw e_3.error; }
+                            return [7 /*endfinally*/];
+                        case 11: return [2 /*return*/];
+                    }
+                });
+            }); };
+        };
+    };
+    var _Glob = function (pattern) {
+        return new Promise(function (resolve, reject) {
+            (0, glob_1.default)(pattern, function (err, matches) {
+                if (err)
+                    reject(err);
+                else
+                    resolve(matches.map(function (str) { return path_1.default.resolve(str); }));
+            });
+        });
+    };
+})(SourceFinder = exports.SourceFinder || (exports.SourceFinder = {}));
+//# sourceMappingURL=SourceFinder.js.map

package/lib/utils/SourceFinder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SourceFinder.js","sourceRoot":"","sources":["../../src/utils/SourceFinder.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,20 +1,18 @@
 {
   "name": "@nestia/core",
-  "version": "1.1.1",
+  "version": "1.1.2-dev.20230503-2",
   "description": "Super-fast validation decorators of NestJS",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "scripts": {
     "build": "rimraf lib && tsc",
-    "build:test": "rimraf bin && tsc -p test/tsconfig.json",
     "dev": "npm run build -- --watch",
     "eslint": "eslint ./**/*.ts",
     "eslint:fix": "eslint ./**/*.ts --fix",
-    "package:latest": "npm run build && npm run build:test && npm run test && npm publish --access public",
+    "package:latest": "npm run build && npm publish --access public",
     "package:next": "npm run package:latest -- --tag next",
     "prepare": "ts-patch install",
-    "prettier": "prettier ./**/*.ts --write",
-    "test": "node bin/test"
+    "prettier": "prettier ./**/*.ts --write"
   },
   "repository": {
     "type": "git",
@@ -41,6 +39,7 @@
     "@nestjs/core": ">= 7.0.1",
     "@nestjs/platform-express": ">= 7.0.1",
     "detect-ts-node": "^1.0.5",
+    "glob": "^7.2.0",
     "raw-body": ">= 2.0.0",
     "reflect-metadata": ">= 0.1.12",
     "rxjs": ">= 6.0.0",
@@ -52,6 +51,7 @@
   "devDependencies": {
     "@trivago/prettier-plugin-sort-imports": "^4.0.0",
     "@types/express": "^4.17.15",
+    "@types/glob": "^7.2.0",
     "@types/inquirer": "^9.0.3",
     "@typescript-eslint/eslint-plugin": "^5.46.1",
     "@typescript-eslint/parser": "^5.46.1",
@@ -63,9 +63,9 @@
     "prettier": "^2.8.7",
     "rimraf": "^3.0.2",
     "ts-node": "^10.9.1",
-    "ts-patch": "3.0.0-beta3",
+    "ts-patch": "^2.1.0",
     "tstl": "^2.5.13",
-    "typescript": "^5.0.4",
+    "typescript": "^4.9.5",
     "typescript-transform-paths": "^3.4.6"
   },
   "files": [

package/src/decorators/DynamicModule.ts

@@ -25,7 +25,7 @@ export namespace DynamicModule {
      * @returns module instance
      */
     export async function mount(
-        path: string,
+        path: string | string[] | { include: string[]; exclude?: string[] },
         metadata: Omit<ModuleMetadata, "controllers"> = {},
     ): Promise<object> {
         // LOAD CONTROLLERS

package/src/decorators/EncryptedModule.ts

@@ -64,7 +64,7 @@ export namespace EncryptedModule {
      * @returns Class decorated module instance
      */
     export async function dynamic(
-        path: string,
+        path: string | string[] | { include: string[]; exclude?: string[] },
         password: IEncryptionPassword | IEncryptionPassword.Closure,
         options: Omit<Parameters<typeof Module>[0], "controllers"> = {},
     ): Promise<object> {

package/src/decorators/TypedParam.ts

@@ -40,10 +40,7 @@ export function TypedParam(
     type?: "boolean" | "number" | "string" | "uuid",
     nullable?: false | true,
 ): ParameterDecorator {
-    return createParamDecorator(function TypedParam(
-        {}: any,
-        ctx: ExecutionContext,
-    ) {
+    const TypedParam = ({}: any, ctx: ExecutionContext) => {
         const request: express.Request = ctx.switchToHttp().getRequest();
         const str: string = request.params[name];
 
@@ -69,7 +66,11 @@ export function TypedParam(
                 );
             return str;
         } else return str;
-    })(name);
+    };
+
+    (TypedParam as any).nullable = !!nullable;
+    (TypedParam as any).type = type;
+    return createParamDecorator(TypedParam)(name);
 }
 
 const UUID_PATTERN =

package/src/decorators/internal/TransformError.ts

@@ -3,6 +3,6 @@
  */
 export function TransformError(method: string): Error {
     return new Error(
-        `Error on nestia.core.${method}(): no transform has been configured. Configure "tsconfig.json" file following [Guide Documents](https://github.com/samchon/nestia/wiki/Setup#tsconfigjson).`,
+        `Error on nestia.core.${method}(): no transform has been configured. Run "npx typia setup" command.`,
     );
 }

package/src/decorators/internal/load_controller.ts

@@ -1,35 +1,42 @@
 import is_ts_node from "detect-ts-node";
-import fs from "fs";
 
 import { Creator } from "../../typings/Creator";
+import { SourceFinder } from "../../utils/SourceFinder";
 
-export async function load_controllers(
-    path: string,
-): Promise<Creator<object>[]> {
-    const output: any[] = [];
-    await iterate(output, path);
-    return output;
-}
-
-async function iterate(
-    controllers: Creator<object>[],
-    path: string,
-): Promise<void> {
-    const directory: string[] = await fs.promises.readdir(path);
-    for (const file of directory) {
-        const current: string = `${path}/${file}`;
-        const stats: fs.Stats = await fs.promises.lstat(current);
+export const load_controllers = async (
+    path: string | string[] | { include: string[]; exclude?: string[] },
+): Promise<Creator<object>[]> => {
+    const sources: string[] = await SourceFinder.find({
+        include: Array.isArray(path)
+            ? path
+            : typeof path === "object"
+            ? path.include
+            : [path],
+        exclude:
+            typeof path === "object" && !Array.isArray(path)
+                ? path.exclude ?? []
+                : [],
+        filter:
+            EXTENSION === "ts"
+                ? (file) =>
+                      file.substring(file.length - 3) === ".ts" &&
+                      file.substring(file.length - 5) !== ".d.ts"
+                : (flle) => flle.substring(flle.length - 3) === ".js",
+    });
+    return mount(sources);
+};
 
-        if (stats.isDirectory() === true) await iterate(controllers, current);
-        else if (file.substring(file.length - 3) === `.${EXTENSION}`) {
-            const external: any = await import(current);
-            for (const key in external) {
-                const instance: Creator<object> = external[key];
-                if (Reflect.getMetadata("path", instance) !== undefined)
-                    controllers.push(instance);
-            }
+async function mount(sources: string[]): Promise<any[]> {
+    const controllers: any[] = [];
+    for (const file of sources) {
+        const external: any = await import(file);
+        for (const key in external) {
+            const instance: Creator<object> = external[key];
+            if (Reflect.getMetadata("path", instance) !== undefined)
+                controllers.push(instance);
         }
     }
+    return controllers;
 }
 
 const EXTENSION = is_ts_node ? "ts" : "js";

package/src/utils/SourceFinder.ts

@@ -0,0 +1,60 @@
+import fs from "fs";
+import glob from "glob";
+import path from "path";
+
+export namespace SourceFinder {
+    export const find = async (props: IProps): Promise<string[]> => {
+        const dict: Set<string> = new Set();
+
+        await emplace(props.filter)(props.include)((str) => dict.add(str));
+        if (props.exclude?.length)
+            await emplace(props.filter)(props.exclude)((str) =>
+                dict.delete(str),
+            );
+
+        return [...dict];
+    };
+
+    const emplace =
+        (filter: (file: string) => boolean) =>
+        (input: string[]) =>
+        async (closure: (location: string) => void): Promise<void> => {
+            for (const pattern of input) {
+                for (const file of await _Glob(path.resolve(pattern))) {
+                    const stats: fs.Stats = await fs.promises.stat(file);
+                    if (stats.isDirectory() === true)
+                        await iterate(filter)(closure)(file);
+                    else if (stats.isFile() && filter(file)) closure(file);
+                }
+            }
+        };
+
+    const iterate =
+        (filter: (location: string) => boolean) =>
+        (closure: (location: string) => void) =>
+        async (location: string): Promise<void> => {
+            const directory: string[] = await fs.promises.readdir(location);
+            for (const file of directory) {
+                const next: string = path.resolve(`${location}/${file}`);
+                const stats: fs.Stats = await fs.promises.stat(next);
+
+                if (stats.isDirectory() === true)
+                    await iterate(filter)(closure)(next);
+                else if (stats.isFile() && filter(next)) closure(next);
+            }
+        };
+
+    const _Glob = (pattern: string): Promise<string[]> =>
+        new Promise((resolve, reject) => {
+            glob(pattern, (err, matches) => {
+                if (err) reject(err);
+                else resolve(matches.map((str) => path.resolve(str)));
+            });
+        });
+}
+
+interface IProps {
+    exclude?: string[];
+    include: string[];
+    filter: (location: string) => boolean;
+}