@nestia/core 13.0.4 → 14.0.1

package/lib/utils/ExceptionManager.d.ts

@@ -11,18 +11,17 @@ import { Creator } from "../typings/Creator";
  * {@link EncryptedRoute} instead of the basic router decorator functions like
  * {@link nest.Get} or {@link nest.Post} and the API function throws a custom
  * error whose class has been {@link ExceptionManager.insert inserted} in this
- * `EntityManager`, the error would be automatically converted to the regular
+ * `ExceptionManager`, the error would be automatically converted to the regular
  * {@link nest.HttpException} instance by the {@link ExceptionManager.Closure}
  * function.
  *
  * Therefore, with this `ExceptionManager` and {@link TypedRoute} or
  * {@link EncryptedRoute}, you can manage your custom error classes much
- * systemtically. You can avoid 500 internal server error or hard coding
+ * systematically. You can avoid 500 internal server error or hard coding
  * implementation about the custom error classes.
  *
- * Below error classes are defaultly configured in this `ExceptionManager`
+ * Below error class is configured in this `ExceptionManager` by default.
  *
- * - `typia.TypeGuardError`
  * - `@nestia/fetcher.HttpError`
  *
  * @author Jeongho Nam - https://github.com/samchon

package/lib/utils/ExceptionManager.js

@@ -14,18 +14,17 @@ const common_1 = require("@nestjs/common");
  * {@link EncryptedRoute} instead of the basic router decorator functions like
  * {@link nest.Get} or {@link nest.Post} and the API function throws a custom
  * error whose class has been {@link ExceptionManager.insert inserted} in this
- * `EntityManager`, the error would be automatically converted to the regular
+ * `ExceptionManager`, the error would be automatically converted to the regular
  * {@link nest.HttpException} instance by the {@link ExceptionManager.Closure}
  * function.
  *
  * Therefore, with this `ExceptionManager` and {@link TypedRoute} or
  * {@link EncryptedRoute}, you can manage your custom error classes much
- * systemtically. You can avoid 500 internal server error or hard coding
+ * systematically. You can avoid 500 internal server error or hard coding
  * implementation about the custom error classes.
  *
- * Below error classes are defaultly configured in this `ExceptionManager`
+ * Below error class is configured in this `ExceptionManager` by default.
  *
- * - `typia.TypeGuardError`
  * - `@nestia/fetcher.HttpError`
  *
  * @author Jeongho Nam - https://github.com/samchon
@@ -45,8 +44,13 @@ var ExceptionManager;
         const index = ExceptionManager.tuples.findIndex((tuple) => tuple[0] === creator);
         if (index !== -1)
             ExceptionManager.tuples.splice(index, 1);
-        ExceptionManager.tuples.push([creator, closure]);
-        ExceptionManager.tuples.sort(([x], [y]) => (x.prototype instanceof y ? -1 : 1));
+        // an error converts by the first class it is an instance of, so a class
+        // must precede every superclass of it: insert before the first one
+        const ancestor = ExceptionManager.tuples.findIndex(([registered]) => creator.prototype instanceof registered);
+        if (ancestor === -1)
+            ExceptionManager.tuples.push([creator, closure]);
+        else
+            ExceptionManager.tuples.splice(ancestor, 0, [creator, closure]);
     }
     ExceptionManager.insert = insert;
     /**

package/lib/utils/ExceptionManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExceptionManager.js","sourceRoot":"","sources":["../../src/utils/ExceptionManager.ts"],"names":[],"mappings":";;;AAAA,6CAA4C;AAC5C,2CAA+C;AAI/C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,IAAiB,gBAAgB,CAsEhC;AAtED,WAAiB,gBAAgB;IAC/B;;;;;;;;OAQG;IACH,SAAgB,MAAM,CACpB,OAAmB,EACnB,OAAmB;QAEnB,MAAM,KAAK,GAAW,uBAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;QACxE,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,uBAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAE1C,uBAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAChC,uBAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IATe,iBAAA,MAAM,SASrB,CAAA;IAED;;;;;OAKG;IACH,SAAgB,KAAK,CAAkB,OAAmB;QACxD,MAAM,KAAK,GAAW,uBAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;QACxE,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAE/B,uBAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IANe,iBAAA,KAAK,QAMpB,CAAA;IAED,SAAgB,EAAE,CAAC,OAA4B;QAC7C,0BAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAFe,iBAAA,EAAE,KAEjB,CAAA;IAED,SAAgB,GAAG,CAAC,OAA4B;QAC9C,0BAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAFe,iBAAA,GAAG,MAElB,CAAA;IAwBD,gBAAgB;IACH,uBAAM,GAAwC,EAAE,CAAC;IAE9D,gBAAgB;IACH,0BAAS,GAA6B,IAAI,GAAG,EAAE,CAAC;AAC/D,CAAC,EAtEgB,gBAAgB,aAAhB,gBAAgB,GAAhB,gBAAgB,QAsEhC;AAED,gBAAgB,CAAC,MAAM,CACrB,mBAAS,EACT,CAAC,KAAK,EAAE,EAAE,CACR,IAAI,sBAAa,CACf;IACE,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,OAAO,EAAE,KAAK,CAAC,OAAO;CACvB,EACD,KAAK,CAAC,MAAM,CACb,CACJ,CAAC"}
+{"version":3,"file":"ExceptionManager.js","sourceRoot":"","sources":["../../src/utils/ExceptionManager.ts"],"names":[],"mappings":";;;AAAA,6CAA4C;AAC5C,2CAA+C;AAI/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,IAAiB,gBAAgB,CA2EhC;AA3ED,WAAiB,gBAAgB;IAC/B;;;;;;;;OAQG;IACH,SAAgB,MAAM,CACpB,OAAmB,EACnB,OAAmB;QAEnB,MAAM,KAAK,GAAW,uBAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;QACxE,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,uBAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAE1C,wEAAwE;QACxE,mEAAmE;QACnE,MAAM,QAAQ,GAAW,uBAAM,CAAC,SAAS,CACvC,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,YAAY,UAAU,CAC1D,CAAC;QACF,IAAI,QAAQ,KAAK,CAAC,CAAC;YAAE,uBAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;;YAChD,uBAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAde,iBAAA,MAAM,SAcrB,CAAA;IAED;;;;;OAKG;IACH,SAAgB,KAAK,CAAkB,OAAmB;QACxD,MAAM,KAAK,GAAW,uBAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;QACxE,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAE/B,uBAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IANe,iBAAA,KAAK,QAMpB,CAAA;IAED,SAAgB,EAAE,CAAC,OAA4B;QAC7C,0BAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAFe,iBAAA,EAAE,KAEjB,CAAA;IAED,SAAgB,GAAG,CAAC,OAA4B;QAC9C,0BAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAFe,iBAAA,GAAG,MAElB,CAAA;IAwBD,gBAAgB;IACH,uBAAM,GAAwC,EAAE,CAAC;IAE9D,gBAAgB;IACH,0BAAS,GAA6B,IAAI,GAAG,EAAE,CAAC;AAC/D,CAAC,EA3EgB,gBAAgB,aAAhB,gBAAgB,GAAhB,gBAAgB,QA2EhC;AAED,gBAAgB,CAAC,MAAM,CACrB,mBAAS,EACT,CAAC,KAAK,EAAE,EAAE,CACR,IAAI,sBAAa,CACf;IACE,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,OAAO,EAAE,KAAK,CAAC,OAAO;CACvB,EACD,KAAK,CAAC,MAAM,CACb,CACJ,CAAC"}

package/lib/utils/SourceFinder.js

@@ -28,7 +28,7 @@ var SourceFinder;
     });
     const emplace = (filter) => (input) => (closure) => __awaiter(this, void 0, void 0, function* () {
         for (const pattern of input) {
-            for (const file of yield _Glob(path_1.default.resolve(pattern))) {
+            for (const file of yield _Glob(pattern)) {
                 const stats = yield fs_1.default.promises.stat(file);
                 if (stats.isDirectory() === true)
                     yield iterate(filter)(closure)(file);
@@ -48,9 +48,32 @@ var SourceFinder;
                 closure(next);
         }
     });
+    /**
+     * Files and directories a path or glob pattern names.
+     *
+     * An existing path is taken literally, whatever characters it holds, as a
+     * directory such as `app [v2]` would otherwise read as a character class. For
+     * a pattern, the longest existing ancestor is the literal base and only the
+     * rest is globbed, with `/` separators, since glob reads a Windows backslash
+     * as an escape.
+     */
     const _Glob = (pattern) => __awaiter(this, void 0, void 0, function* () {
-        const matches = yield (0, glob_1.glob)(pattern);
-        return matches.map((str) => path_1.default.resolve(str));
+        const absolute = path_1.default.resolve(pattern);
+        if (fs_1.default.existsSync(absolute))
+            return [absolute];
+        let base = absolute;
+        while (fs_1.default.existsSync(base) === false) {
+            const parent = path_1.default.dirname(base);
+            if (parent === base)
+                return [];
+            base = parent;
+        }
+        const rest = path_1.default
+            .relative(base, absolute)
+            .split(path_1.default.sep)
+            .join("/");
+        const matches = yield (0, glob_1.glob)(rest, { cwd: base });
+        return matches.map((str) => path_1.default.resolve(base, str));
     });
 })(SourceFinder || (exports.SourceFinder = SourceFinder = {}));
 //# sourceMappingURL=SourceFinder.js.map

package/lib/utils/SourceFinder.js.map

@@ -1 +1 @@
-{"version":3,"file":"SourceFinder.js","sourceRoot":"","sources":["../../src/utils/SourceFinder.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,4CAAoB;AACpB,+BAA4B;AAC5B,gDAAwB;AAExB,IAAiB,YAAY,CA2C5B;AA3CD,WAAiB,YAAY;IACd,iBAAI,GAAG,CAAO,KAAa,EAAqB,EAAE;;QAC7D,MAAM,IAAI,GAAgB,IAAI,GAAG,EAAE,CAAC;QAEpC,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACnE,IAAI,MAAA,KAAK,CAAC,OAAO,0CAAE,MAAM;YACvB,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAExE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACnB,CAAC,CAAA,CAAC;IAEF,MAAM,OAAO,GACX,CAAC,MAAiC,EAAE,EAAE,CACtC,CAAC,KAAe,EAAE,EAAE,CACpB,CAAO,OAAmC,EAAiB,EAAE;QAC3D,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;YAC5B,KAAK,MAAM,IAAI,IAAI,MAAM,KAAK,CAAC,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;gBACtD,MAAM,KAAK,GAAa,MAAM,YAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrD,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,IAAI;oBAC9B,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;qBAClC,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC;oBAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC,CAAA,CAAC;IAEJ,MAAM,OAAO,GACX,CAAC,MAAqC,EAAE,EAAE,CAC1C,CAAC,OAAmC,EAAE,EAAE,CACxC,CAAO,QAAgB,EAAiB,EAAE;QACxC,MAAM,SAAS,GAAa,MAAM,YAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAW,cAAI,CAAC,OAAO,CAAC,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;YACzD,MAAM,KAAK,GAAa,MAAM,YAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAErD,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,IAAI;gBAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;iBAClE,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAA,CAAC;IAEJ,MAAM,KAAK,GAAG,CAAO,OAAe,EAAqB,EAAE;QACzD,MAAM,OAAO,GAAG,MAAM,IAAA,WAAI,EAAC,OAAO,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,cAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC,CAAA,CAAC;AACJ,CAAC,EA3CgB,YAAY,aAAZ,YAAY,GAAZ,YAAY,QA2C5B"}
+{"version":3,"file":"SourceFinder.js","sourceRoot":"","sources":["../../src/utils/SourceFinder.ts"],"names":[],"mappings":"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"}

package/lib/utils/VersioningStrategy.d.ts

@@ -5,5 +5,13 @@ export declare namespace VersioningStrategy {
         defaultVersion?: VersionValue;
     }
     const cast: (value: VersionValue | undefined) => Array<string | typeof VERSION_NEUTRAL>;
-    const merge: (config: IConfig | undefined) => (values: Array<string | typeof VERSION_NEUTRAL>) => string[];
+    /**
+     * Version path segments of a route, resolved as NestJS resolves them: the
+     * method's versions, else the controller's, else the default version, and no
+     * version at all is the unversioned path (#1735).
+     */
+    const merge: (config: IConfig | undefined) => (props: {
+        controller: Array<string | typeof VERSION_NEUTRAL> | undefined;
+        method: Array<string | typeof VERSION_NEUTRAL> | undefined;
+    }) => string[];
 }

package/lib/utils/VersioningStrategy.js

@@ -4,14 +4,26 @@ exports.VersioningStrategy = void 0;
 var VersioningStrategy;
 (function (VersioningStrategy) {
     VersioningStrategy.cast = (value) => value === undefined ? [] : Array.isArray(value) ? value : [value];
-    VersioningStrategy.merge = (config) => (values) => {
+    /**
+     * Version path segments of a route, resolved as NestJS resolves them: the
+     * method's versions, else the controller's, else the default version, and no
+     * version at all is the unversioned path (#1735).
+     */
+    VersioningStrategy.merge = (config) => (props) => {
+        var _a, _b;
         if (config === undefined)
             return [""];
-        const set = new Set(values);
-        const array = set.size === 0 ? VersioningStrategy.cast(config.defaultVersion) : Array.from(set);
-        return !!(array === null || array === void 0 ? void 0 : array.length)
-            ? array.map((x) => typeof x === "symbol" ? "" : `${config.prefix}${x}`)
-            : [];
+        const chosen = ((_a = props.method) === null || _a === void 0 ? void 0 : _a.length)
+            ? props.method
+            : ((_b = props.controller) === null || _b === void 0 ? void 0 : _b.length)
+                ? props.controller
+                : VersioningStrategy.cast(config.defaultVersion);
+        const unique = [
+            ...new Set(chosen),
+        ];
+        return unique.length
+            ? unique.map((x) => typeof x === "symbol" ? "" : `${config.prefix}${x}`)
+            : [""];
     };
 })(VersioningStrategy || (exports.VersioningStrategy = VersioningStrategy = {}));
 //# sourceMappingURL=VersioningStrategy.js.map

package/lib/utils/VersioningStrategy.js.map

@@ -1 +1 @@
-{"version":3,"file":"VersioningStrategy.js","sourceRoot":"","sources":["../../src/utils/VersioningStrategy.ts"],"names":[],"mappings":";;;AAEA,IAAiB,kBAAkB,CAwBlC;AAxBD,WAAiB,kBAAkB;IAMpB,uBAAI,GAAG,CAClB,KAA+B,EACS,EAAE,CAC1C,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAEvD,wBAAK,GAChB,CAAC,MAA2B,EAAE,EAAE,CAChC,CAAC,MAA8C,EAAY,EAAE;QAC3D,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,GAAG,GAAyC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAClE,MAAM,KAAK,GACT,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,uBAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,EAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,MAAM,CAAA;YACpB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACd,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CACpD;YACH,CAAC,CAAC,EAAE,CAAC;IACT,CAAC,CAAC;AACN,CAAC,EAxBgB,kBAAkB,aAAlB,kBAAkB,GAAlB,kBAAkB,QAwBlC"}
+{"version":3,"file":"VersioningStrategy.js","sourceRoot":"","sources":["../../src/utils/VersioningStrategy.ts"],"names":[],"mappings":";;;AAEA,IAAiB,kBAAkB,CAsClC;AAtCD,WAAiB,kBAAkB;IAMpB,uBAAI,GAAG,CAClB,KAA+B,EACS,EAAE,CAC1C,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAEpE;;;;OAIG;IACU,wBAAK,GAChB,CAAC,MAA2B,EAAE,EAAE,CAChC,CAAC,KAGA,EAAY,EAAE;;QACb,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,MAAM,GAA2C,CAAA,MAAA,KAAK,CAAC,MAAM,0CAC/D,MAAM;YACR,CAAC,CAAC,KAAK,CAAC,MAAM;YACd,CAAC,CAAC,CAAA,MAAA,KAAK,CAAC,UAAU,0CAAE,MAAM;gBACxB,CAAC,CAAC,KAAK,CAAC,UAAU;gBAClB,CAAC,CAAC,uBAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAClC,MAAM,MAAM,GAA2C;YACrD,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC;SACnB,CAAC;QACF,OAAO,MAAM,CAAC,MAAM;YAClB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACf,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CACpD;YACH,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACX,CAAC,CAAC;AACN,CAAC,EAtCgB,kBAAkB,aAAlB,kBAAkB,GAAlB,kBAAkB,QAsClC"}

package/native/go.mod

@@ -10,7 +10,7 @@ require (
 	github.com/microsoft/typescript-go/shim/printer v0.0.0
 	github.com/microsoft/typescript-go/shim/scanner v0.0.0
 	github.com/samchon/ttsc/packages/ttsc v0.0.0
-	github.com/samchon/typia/packages/typia/native v0.0.0-20260818045905-f692fd63a846
+	github.com/samchon/typia/packages/typia/native v0.0.0-20260922081121-78124b0523b4
 )
 
 require (

package/native/go.sum

@@ -38,8 +38,8 @@ github.com/samchon/ttsc/packages/ttsc/shim/vfs/cachedvfs v0.0.0-20260820075544-3
 github.com/samchon/ttsc/packages/ttsc/shim/vfs/cachedvfs v0.0.0-20260820075544-3fe6b732f888/go.mod h1:XS3LhXkn5xadyRe3tW+9+suW/7gh7dPdL43Q+s/lUDo=
 github.com/samchon/ttsc/packages/ttsc/shim/vfs/osvfs v0.0.0-20260820075544-3fe6b732f888 h1:ihiKD2OhuYc7Dngxw3uFYbVoiA/xuPwwQoUakB59E40=
 github.com/samchon/ttsc/packages/ttsc/shim/vfs/osvfs v0.0.0-20260820075544-3fe6b732f888/go.mod h1:otX+qw8aZLNCoBmCwMAn53Nw0RQTPzSoId3DxmE67So=
-github.com/samchon/typia/packages/typia/native v0.0.0-20260818045905-f692fd63a846 h1:x9xL0zn2AqPf19lTp8dNal+Ia3cIu0uYnyXlY4mo3QI=
-github.com/samchon/typia/packages/typia/native v0.0.0-20260818045905-f692fd63a846/go.mod h1:pUTSG5IZxw8Hohle//RsDXnE+8ZhAus7mPDKFqzvZnk=
+github.com/samchon/typia/packages/typia/native v0.0.0-20260922081121-78124b0523b4 h1:ZL20GliY1kZk/PYHwJX+n5cp8ljx8YToGP1wWFtaOYs=
+github.com/samchon/typia/packages/typia/native v0.0.0-20260922081121-78124b0523b4/go.mod h1:pUTSG5IZxw8Hohle//RsDXnE+8ZhAus7mPDKFqzvZnk=
 github.com/zeebo/assert v1.3.0 h1:g7C04CbJuIDKNPFHmsk4hwZDO5O+kntRxzaUoNXj+IQ=
 github.com/zeebo/assert v1.3.0/go.mod h1:Pq9JiuJQpG8JLJdtkwrJESF0Foym2/D9XMU5ciN/wJ0=
 github.com/zeebo/xxh3 v1.1.0 h1:s7DLGDK45Dyfg7++yxI0khrfwq9661w9EN78eP/UZVs=

package/native/transform/ast.go

@@ -7,12 +7,14 @@ import (
 )
 
 // NodeName returns the trimmed identifier text of a named AST node
-// (method, parameter, ...). Empty when the node has no name.
+// (method, parameter, ...). Empty when the node has no name. A name that is no
+// identifier, a destructured parameter's `{ a }` or a computed method name's
+// `[key]`, reads as its source, since typescript-go's `Text()` panics on it.
 func NodeName(node *shimast.Node) string {
 	if node == nil || node.Name() == nil {
 		return ""
 	}
-	return strings.Trim(node.Name().Text(), "\"'")
+	return strings.Trim(shimast.NodeText(node.Name()), "\"'")
 }
 
 // NodeText returns the verbatim source slice spanned by a node.

package/native/transform/core_querify.go

@@ -1,8 +1,6 @@
 package transform
 
 import (
-	"fmt"
-
 	shimast "github.com/microsoft/typescript-go/shim/ast"
 	shimchecker "github.com/microsoft/typescript-go/shim/checker"
 	shimprinter "github.com/microsoft/typescript-go/shim/printer"
@@ -44,7 +42,13 @@ func nestiaCoreHttpQuerifyProgrammer(prog *driver.Program, ec *shimprinter.EmitC
 		Type:       typ,
 	})
 	if result.Success == false {
-		panic(fmt.Errorf("failed to analyze query-string metadata: %d error(s)", len(result.Errors)))
+		panic(nativecontext.TransformerError_from(struct {
+			Code   string
+			Errors []nativecontext.TransformerError_MetadataFactory_IError
+		}{
+			Code:   "nestia.core.TypedQueryRoute",
+			Errors: nestiaCoreMetadataErrors(result.Errors),
+		}))
 	}
 	statements := []*shimast.Node{
 		nativefactories.StatementFactory.Constant(nativefactories.StatementFactory_ConstantProps{
@@ -149,12 +153,28 @@ func nestiaCoreHttpValidateQuerifyProgrammer(prog *driver.Program, importer *nat
 			Name:  "query",
 			Value: nestiaCoreHttpQuerifyProgrammer(prog, ec, typ),
 		}),
+		// the object is validated, then querified: validating the
+		// URLSearchParams against the object type found every property absent
 		nativefactories.StatementFactory.Constant(nativefactories.StatementFactory_ConstantProps{
-			Name:  "output",
-			Value: nestiaCoreCall("query", nestiaCoreFactory.NewIdentifier("input")),
+			Name:  "result",
+			Value: nestiaCoreCall("validate", nestiaCoreFactory.NewIdentifier("input")),
 		}),
 		nestiaCoreFactory.NewReturnStatement(nestiaCoreFactory.NewAsExpression(
-			nestiaCoreCall("validate", nestiaCoreFactory.NewIdentifier("output")),
+			nestiaCoreFactory.NewConditionalExpression(
+				nestiaCoreFactory.NewPropertyAccessExpression(
+					nestiaCoreFactory.NewIdentifier("result"),
+					nil,
+					nestiaCoreFactory.NewIdentifier("success"),
+					shimast.NodeFlagsNone,
+				),
+				nil,
+				nestiaCoreFactory.NewObjectLiteralExpression(nestiaCoreFactory.NewNodeList([]*shimast.Node{
+					nestiaCoreProperty("success", nestiaCoreFactory.NewKeywordExpression(shimast.KindTrueKeyword), ec),
+					nestiaCoreProperty("data", nestiaCoreCall("query", nestiaCoreFactory.NewIdentifier("input")), ec),
+				}), false),
+				nil,
+				nestiaCoreFactory.NewIdentifier("result"),
+			),
 			nativefactories.TypeFactory.Keyword("any"),
 		)),
 	})

package/native/transform/core_transform.go

@@ -94,6 +94,60 @@ type nestiaCoreFileContext struct {
 	coreImports map[string]string
 }
 
+// The values the validate and stringify options accept.
+var (
+	nestiaCoreValidateModes = []string{
+		"assert", "is", "validate", "equals",
+		"assertEquals", "validateEquals",
+		"assertClone", "validateClone",
+		"assertPrune", "validatePrune",
+	}
+	nestiaCoreStringifyModes = []string{"stringify", "assert", "is", "validate", "validate.log"}
+)
+
+// nestiaCoreOptionErrors reports each validate or stringify option value that
+// is no mode: a generator would otherwise take its default branch, and a typo
+// such as "assertEqual" silently weakens validation.
+func nestiaCoreOptionErrors(plan plugin.Plan) []string {
+	errors := []string{}
+	check := func(name string, value any, modes []string, nullable bool) {
+		if value == nil && nullable {
+			return
+		}
+		if text, ok := value.(string); ok {
+			for _, mode := range modes {
+				if mode == text {
+					return
+				}
+			}
+		}
+		accepted := "\"" + strings.Join(modes, "\", \"") + "\""
+		if nullable {
+			accepted += ", or null"
+		}
+		errors = append(errors, fmt.Sprintf("invalid %q option %s: it must be one of %s.", name, nestiaCoreOptionText(value), accepted))
+	}
+	for _, entry := range plan.Entries {
+		if entry.Name != "@nestia/core" && !strings.Contains(entry.Transform, "@nestia/core") {
+			continue
+		}
+		if value, ok := entry.Config["validate"]; ok {
+			check("validate", value, nestiaCoreValidateModes, false)
+		}
+		if value, ok := entry.Config["stringify"]; ok {
+			check("stringify", value, nestiaCoreStringifyModes, true)
+		}
+	}
+	return errors
+}
+
+func nestiaCoreOptionText(value any) string {
+	if text, ok := value.(string); ok {
+		return fmt.Sprintf("%q", text)
+	}
+	return fmt.Sprintf("%v", value)
+}
+
 func readNestiaCoreOptions(plan plugin.Plan) nestiaCoreOptions {
 	options := nestiaCoreOptions{}
 	for _, entry := range plan.Entries {
@@ -174,6 +228,19 @@ func nestiaCoreDecoratorCall(prog *driver.Program, decorator *shimast.Node) (*sh
 	return call, canonical, true
 }
 
+// NestiaCoreCanonicalDecoratorSegments names a decorator call's callee by the
+// @nestia/core export its import binds, so `import { TypedException as TE }`
+// reads `TE<T>()` as `TypedException`. It returns nil for a decorator that is
+// no call.
+func NestiaCoreCanonicalDecoratorSegments(decorator *shimast.Node) []string {
+	_, segments, ok := nestiaCoreRawDecoratorCall(decorator)
+	if !ok {
+		return nil
+	}
+	context := newNestiaCoreFileContext(shimast.GetSourceFileOfNode(decorator))
+	return nestiaCoreCanonicalSegments(context, segments)
+}
+
 func newNestiaCoreFileContext(file *shimast.SourceFile) nestiaCoreFileContext {
 	context := nestiaCoreFileContext{
 		file:        file,
@@ -538,7 +605,13 @@ func nestiaCoreFormDataFiles(prog *driver.Program, typ *shimchecker.Type) []nest
 		Type:       typ,
 	})
 	if result.Success == false {
-		panic(fmt.Errorf("failed to analyze form-data metadata: %d error(s)", len(result.Errors)))
+		panic(nativecontext.TransformerError_from(struct {
+			Code   string
+			Errors []nativecontext.TransformerError_MetadataFactory_IError
+		}{
+			Code:   "nestia.core.TypedFormDataBody",
+			Errors: nestiaCoreMetadataErrors(result.Errors),
+		}))
 	}
 	files := []nestiaCoreFormDataFile{}
 	if result.Data == nil || len(result.Data.Objects) == 0 || result.Data.Objects[0] == nil || result.Data.Objects[0].Type == nil {
@@ -678,6 +751,8 @@ func nestiaCoreGenerateTypedQueryRoute(prog *driver.Program, importer *nativecon
 		return nestiaCoreValidatorObject("type", "validate", nestiaCoreHttpValidateQuerifyProgrammer(prog, importer, ec, modulo, typ), ec)
 	case "stringify":
 		return nestiaCoreValidatorObject("type", "stringify", nestiaCoreHttpQuerifyProgrammer(prog, ec, typ), ec)
+	case "validate.log":
+		return nestiaCoreValidatorObjectWithKey("type", "validate.log", "validate", nestiaCoreHttpValidateQuerifyProgrammer(prog, importer, ec, modulo, typ), ec)
 	default:
 		return nestiaCoreValidatorObject("type", "assert", nestiaCoreHttpAssertQuerifyProgrammer(prog, importer, ec, modulo, typ), ec)
 	}

package/native/transform/core_websocket.go

@@ -2,9 +2,11 @@ package transform
 
 import (
 	"fmt"
+	"path/filepath"
 	"strings"
 
 	shimast "github.com/microsoft/typescript-go/shim/ast"
+	shimchecker "github.com/microsoft/typescript-go/shim/checker"
 	shimscanner "github.com/microsoft/typescript-go/shim/scanner"
 	"github.com/samchon/ttsc/packages/ttsc/driver"
 )
@@ -42,14 +44,14 @@ func validateNestiaCoreWebSocketRoute(
 		switch category {
 		case "Acceptor":
 			accepted = true
-			if strings.HasPrefix(nestiaCoreWebSocketParameterTypeName(param), "WebSocketAcceptor") == false {
+			if _, target := NestiaCoreWebSocketTypeReference(prog, nestiaCoreWebSocketParameterTypeNode(param)); target != "WebSocketAcceptor" {
 				diagnostics = append(diagnostics, nestiaCoreWebSocketDiagnostic(context.file, param, "WebSocketRoute", fmt.Sprintf(
 					"parameter %q must have WebSocketAcceptor<Header, Provider, Listener> type.",
 					name,
 				)))
 			}
 		case "Driver":
-			if strings.HasPrefix(nestiaCoreWebSocketParameterTypeName(param), "Driver") == false {
+			if _, target := NestiaCoreWebSocketTypeReference(prog, nestiaCoreWebSocketParameterTypeNode(param)); target != "Driver" {
 				diagnostics = append(diagnostics, nestiaCoreWebSocketDiagnostic(context.file, param, "WebSocketRoute", fmt.Sprintf(
 					"parameter %q must have Driver<Listener> type.",
 					name,
@@ -66,6 +68,12 @@ func validateNestiaCoreWebSocketRoute(
 	return diagnostics
 }
 
+// NestiaCoreWebSocketParameterCategory names the WebSocketRoute parameter
+// decorator on a parameter, such as "Acceptor" or "Driver", or "" for none.
+func NestiaCoreWebSocketParameterCategory(prog *driver.Program, param *shimast.Node) string {
+	return nestiaCoreWebSocketParameterCategory(prog, param)
+}
+
 func nestiaCoreWebSocketParameterCategory(prog *driver.Program, param *shimast.Node) string {
 	if param == nil || len(param.Decorators()) != 1 {
 		return ""
@@ -78,19 +86,90 @@ func nestiaCoreWebSocketParameterCategory(prog *driver.Program, param *shimast.N
 	return segments[len(segments)-1]
 }
 
-func nestiaCoreWebSocketParameterTypeName(param *shimast.Node) string {
-	if param == nil || param.AsParameterDeclaration() == nil || param.AsParameterDeclaration().Type == nil {
-		return ""
+func nestiaCoreWebSocketParameterTypeNode(param *shimast.Node) *shimast.Node {
+	if param == nil || param.AsParameterDeclaration() == nil {
+		return nil
+	}
+	return param.AsParameterDeclaration().Type
+}
+
+// NestiaCoreWebSocketTypeReference follows a parameter's type annotation
+// through renamed imports, import types, and type aliases to the tgrid type
+// reference it spells, such as `WebSocketAcceptor<Header, Provider, Listener>`
+// or `Driver<Listener>`, so the transform and the SDK accept every spelling of
+// the same type and still reject another type of the same name. It returns the
+// type references it passed, each a type reference or an import type such as
+// `import("tgrid").Driver<Listener>`, from the annotation to the tgrid
+// reference, each after the first written in the type alias the one before it
+// names, and the name tgrid declares the type by; or nil and "" when the
+// annotation leads to no tgrid type.
+func NestiaCoreWebSocketTypeReference(prog *driver.Program, node *shimast.Node) ([]*shimast.Node, string) {
+	chain := []*shimast.Node{}
+	for depth := 0; node != nil && depth < 32; depth++ {
+		if node.Kind == shimast.KindParenthesizedType {
+			node = node.AsParenthesizedTypeNode().Type
+			continue
+		}
+		name := nestiaCoreTypeReferenceName(node)
+		if name == nil || prog == nil || prog.Checker == nil {
+			return nil, ""
+		}
+		chain = append(chain, node)
+		symbol := prog.Checker.GetSymbolAtLocation(name)
+		if symbol != nil && symbol.Flags&shimast.SymbolFlagsAlias != 0 {
+			if aliased := shimchecker.Checker_getAliasedSymbol(prog.Checker, symbol); aliased != nil {
+				symbol = aliased
+			}
+		}
+		if symbol == nil {
+			return nil, ""
+		}
+		if nestiaCoreIsTgridDeclarations(symbol.Declarations) {
+			return chain, symbol.Name
+		}
+		if symbol.Flags&shimast.SymbolFlagsTypeAlias == 0 {
+			return nil, ""
+		}
+		var alias *shimast.Node
+		for _, declaration := range symbol.Declarations {
+			if declaration != nil && declaration.Kind == shimast.KindTypeAliasDeclaration {
+				alias = declaration
+				break
+			}
+		}
+		if alias == nil {
+			return nil, ""
+		}
+		node = alias.AsTypeAliasDeclaration().Type
 	}
-	text := NodeText(param.AsParameterDeclaration().Type)
-	text = strings.TrimSpace(text)
-	if index := strings.Index(text, "<"); index >= 0 {
-		text = text[:index]
+	return nil, ""
+}
+
+// nestiaCoreTypeReferenceName is the entity a type names: the `A.B` of
+// `A.B<T>`, or the qualifier of an import type such as `import("m").A.B<T>`.
+// It is nil for any other type, including `typeof import("m")`, the type of a
+// module's value.
+func nestiaCoreTypeReferenceName(node *shimast.Node) *shimast.Node {
+	switch node.Kind {
+	case shimast.KindTypeReference:
+		return node.AsTypeReferenceNode().TypeName
+	case shimast.KindImportType:
+		if node.AsImportTypeNode().IsTypeOf {
+			return nil
+		}
+		return node.AsImportTypeNode().Qualifier
 	}
-	if index := strings.LastIndex(text, "."); index >= 0 {
-		text = text[index+1:]
+	return nil
+}
+
+func nestiaCoreIsTgridDeclarations(declarations []*shimast.Node) bool {
+	for _, declaration := range declarations {
+		source := shimast.GetSourceFileOfNode(declaration)
+		if source != nil && strings.Contains(filepath.ToSlash(source.FileName()), "/tgrid/") {
+			return true
+		}
 	}
-	return text
+	return false
 }
 
 func nestiaCoreWebSocketDiagnostic(file *shimast.SourceFile, node *shimast.Node, kind string, message string) Diagnostic {
@@ -99,7 +178,9 @@ func nestiaCoreWebSocketDiagnostic(file *shimast.SourceFile, node *shimast.Node,
 	if file != nil {
 		filePath = file.FileName()
 		if node != nil {
-			if pos := node.Pos(); pos >= 0 {
+			// the first token's position: Pos() starts at the leading trivia,
+			// the previous line's end and any JSDoc
+			if pos := shimscanner.GetTokenPosOfNode(node, file, false); pos >= 0 {
 				l, c := shimscanner.GetECMALineAndByteOffsetOfPosition(file, pos)
 				line, column = l+1, c+1
 			}

package/native/transform/node_transform.go

@@ -30,6 +30,7 @@ func nestiaCoreNodeTransform(
 		}
 	}
 	options := readNestiaCoreOptions(plan)
+	optionErrors := nestiaCoreOptionErrors(plan)
 	strictReported := false
 	return func(ec *shimprinter.EmitContext, sf *shimast.SourceFile) *shimast.SourceFile {
 		if sf == nil || sf.IsDeclarationFile {
@@ -39,6 +40,11 @@ func nestiaCoreNodeTransform(
 			strictReported = true
 			addDiagnostic(nestiaCoreGlobalDiagnostic("@nestia/core", "strict mode is required."))
 		}
+		// reported once, with the first file transformed
+		for _, message := range optionErrors {
+			addDiagnostic(nestiaCoreGlobalDiagnostic("@nestia/core", message))
+		}
+		optionErrors = nil
 		importer := nativecontext.NewImportProgrammer(nativecontext.ImportProgrammer_IOptions{
 			InternalPrefix: "typia_transform_",
 			Runtime:        "typia",

package/native/transform/transform.go

@@ -7,7 +7,6 @@ import (
 	"fmt"
 	"os"
 	"path/filepath"
-	"regexp"
 	"strings"
 
 	shimast "github.com/microsoft/typescript-go/shim/ast"
@@ -169,7 +168,14 @@ func runTransformProject(
 		sf := prog.SourceFile(fileName)
 		return sf != nil && prog.TSProgram.IsLibFile(sf)
 	})
-	schemametadata.MetadataDependency_listen(prog.Checker, collector.Touch)
+	// `File` alone is the whole listener this host needs. `Callee` falls back
+	// to it, and the two channels differ only in whether a default library
+	// withholds a completeness declaration, which this host never makes;
+	// `Unbounded` is ignorable for the same reason, since an unreported input
+	// is still watched through the reference graph.
+	schemametadata.MetadataDependency_listen(prog.Checker, schemametadata.MetadataDependency_IListener{
+		File: collector.Touch,
+	})
 	defer schemametadata.MetadataDependency_release(prog.Checker)
 	for _, sf := range prog.SourceFiles() {
 		if sf.IsDeclarationFile {
@@ -256,22 +262,6 @@ func SourceFileText(target any) (string, bool) {
 	return file.Text(), true
 }
 
-// These patterns run once per transformed file in cleanupTypeScriptTransformText
-// / normalizeParenthesizedTypeAnnotations. Compiling them at package scope keeps
-// the per-file cost to a match instead of a recompile (the SDK `transform` path
-// runs this for every emitted source file).
-var (
-	cleanupImportTypeBlockPattern   = regexp.MustCompile(`(?m)^import type \{([^{}\n]+)\} from`)
-	cleanupImportTypeLinePattern    = regexp.MustCompile(`^import type \{\s*([^{}\n]+?)\s*\} from`)
-	cleanupImportBlankLinePattern   = regexp.MustCompile(`(?m)(^import [^\n]+;\n)\n+(const |let |var |export )`)
-	cleanupInputIsParenPattern      = regexp.MustCompile(`input is \(([A-Za-z_$][A-Za-z0-9_$.]*)\)`)
-	cleanupCollapseBlankCallPattern = regexp.MustCompile(`\n\n([A-Za-z_$][A-Za-z0-9_$]*\([^;\n]*\);?)`)
-)
-var (
-	normalizeParenArrowTypePattern = regexp.MustCompile(`: \(([A-Za-z_$][A-Za-z0-9_$.]*(<[^()\n;{}]*>)?)\)(\s*=>)`)
-	normalizeParenNullishPattern   = regexp.MustCompile(`\| \((null|undefined)\)`)
-)
-
 func transformDiagnosticToCompilerDiagnostic(
 	diag Diagnostic,
 ) transformCompilerDiagnostic {

package/native/transform/typia_fast.go

@@ -1,6 +1,8 @@
 package transform
 
 import (
+	"sync"
+
 	shimast "github.com/microsoft/typescript-go/shim/ast"
 	shimprinter "github.com/microsoft/typescript-go/shim/printer"
 	shimscanner "github.com/microsoft/typescript-go/shim/scanner"
@@ -22,6 +24,10 @@ func nestiaTypiaNodeTransform(
 ) driver.PluginTransform {
 	transformOptions := pluginOptions.TransformOptions()
 	extras := nativecontext.ITypiaContext_Extras{
+		// One cache for the whole program, as typia's own hosts share it: left
+		// nil, typia makes one per file, and a program-wide analysis such as
+		// `llm.evaluation`'s `@probability` scan reruns for every file.
+		Shared: &sync.Map{},
 		AddDiagnostic: func(diag *nativecontext.ITypiaDiagnostic) int {
 			addDiagnostic(nestiaTypiaDiagnosticFrom(diag))
 			return 1