@nestia/core 12.0.0 → 12.1.0

package/native/transform/typia_fast.go

@@ -1,11 +1,7 @@
 package transform
 
 import (
-	"path/filepath"
-	"strings"
-
 	shimast "github.com/microsoft/typescript-go/shim/ast"
-	shimchecker "github.com/microsoft/typescript-go/shim/checker"
 	shimprinter "github.com/microsoft/typescript-go/shim/printer"
 	shimscanner "github.com/microsoft/typescript-go/shim/scanner"
 	"github.com/samchon/ttsc/packages/ttsc/driver"
@@ -57,319 +53,3 @@ func nestiaTypiaDiagnosticFrom(diag *nativecontext.ITypiaDiagnostic) Diagnostic
 	}
 	return out
 }
-
-type nestiaTypiaImportRoot struct {
-	module string
-}
-
-func collectNestiaTypiaCallSites(files []*shimast.SourceFile, checker *shimchecker.Checker) []typiaadapter.CallSite {
-	sites := []typiaadapter.CallSite{}
-	for _, file := range files {
-		if file == nil || file.IsDeclarationFile {
-			continue
-		}
-		roots, fallback := nestiaTypiaImportRoots(file)
-		if len(roots) == 0 {
-			if fallback {
-				sites = append(sites, typiaadapter.CollectCallSites([]*shimast.SourceFile{file}, checker)...)
-			}
-			continue
-		}
-		file.ForEachChild(func(node *shimast.Node) bool {
-			visitNestiaTypiaCallSite(file, checker, roots, node, &sites)
-			return false
-		})
-	}
-	return sites
-}
-
-func visitNestiaTypiaCallSite(
-	file *shimast.SourceFile,
-	checker *shimchecker.Checker,
-	roots map[string]nestiaTypiaImportRoot,
-	node *shimast.Node,
-	sites *[]typiaadapter.CallSite,
-) {
-	if node == nil {
-		return
-	}
-	if node.Kind == shimast.KindCallExpression {
-		call := node.AsCallExpression()
-		if call != nil && nestiaTypiaCallLooksPossible(call, roots) {
-			if site, ok := tryNestiaTypiaCallSite(file, checker, node); ok {
-				*sites = append(*sites, site)
-			}
-		}
-	}
-	node.ForEachChild(func(child *shimast.Node) bool {
-		visitNestiaTypiaCallSite(file, checker, roots, child, sites)
-		return false
-	})
-}
-
-func nestiaTypiaImportRoots(file *shimast.SourceFile) (map[string]nestiaTypiaImportRoot, bool) {
-	roots := map[string]nestiaTypiaImportRoot{}
-	fallback := false
-	if file == nil || file.Statements == nil {
-		return roots, fallback
-	}
-	for _, stmt := range file.Statements.Nodes {
-		if stmt == nil || stmt.Kind != shimast.KindImportDeclaration {
-			continue
-		}
-		decl := stmt.AsImportDeclaration()
-		if decl == nil || decl.ImportClause == nil || decl.ModuleSpecifier == nil || decl.ModuleSpecifier.Kind != shimast.KindStringLiteral {
-			continue
-		}
-		moduleText := decl.ModuleSpecifier.Text()
-		module, ok := nestiaTypiaImportModule(moduleText)
-		if ok == false {
-			continue
-		}
-		clause := decl.ImportClause.AsImportClause()
-		if clause == nil || clause.PhaseModifier == shimast.KindTypeKeyword {
-			continue
-		}
-		if name := clause.Name(); name != nil {
-			roots[name.Text()] = nestiaTypiaImportRoot{module: module}
-		}
-		if clause.NamedBindings == nil {
-			continue
-		}
-		if clause.NamedBindings.Kind == shimast.KindNamespaceImport {
-			if name := clause.NamedBindings.Name(); name != nil {
-				roots[name.Text()] = nestiaTypiaImportRoot{module: module}
-			}
-			continue
-		}
-		if clause.NamedBindings.Kind != shimast.KindNamedImports {
-			continue
-		}
-		named := clause.NamedBindings.AsNamedImports()
-		if named == nil || named.Elements == nil {
-			continue
-		}
-		for _, elem := range named.Elements.Nodes {
-			if elem == nil {
-				continue
-			}
-			spec := elem.AsImportSpecifier()
-			if spec == nil || spec.IsTypeOnly {
-				continue
-			}
-			name := spec.Name()
-			if name == nil {
-				continue
-			}
-			imported := name.Text()
-			if spec.PropertyName != nil {
-				imported = spec.PropertyName.Text()
-			}
-			if module == "" {
-				if nestiaTypiaKnownModule(imported) == false {
-					continue
-				}
-				roots[name.Text()] = nestiaTypiaImportRoot{module: imported}
-			} else {
-				roots[name.Text()] = nestiaTypiaImportRoot{module: module}
-			}
-		}
-	}
-	return roots, fallback
-}
-
-func nestiaTypiaImportModule(specifier string) (string, bool) {
-	switch specifier {
-	case "typia":
-		return "", true
-	}
-	for _, prefix := range []string{"typia/lib/", "typia/src/"} {
-		if strings.HasPrefix(specifier, prefix) {
-			name := strings.TrimPrefix(specifier, prefix)
-			if strings.Contains(name, "/") || nestiaTypiaKnownModule(name) == false {
-				return "", false
-			}
-			return name, true
-		}
-	}
-	return "", false
-}
-
-func nestiaTypiaKnownModule(name string) bool {
-	switch name {
-	case "functional", "http", "json", "llm", "misc", "module", "notations", "protobuf", "reflect":
-		return true
-	default:
-		return false
-	}
-}
-
-func nestiaTypiaCallLooksPossible(call *shimast.CallExpression, roots map[string]nestiaTypiaImportRoot) bool {
-	root, parts, ok := nestiaTypiaCallSegments(call)
-	if ok == false {
-		return false
-	}
-	info, ok := roots[root]
-	if ok == false || len(parts) == 0 {
-		return false
-	}
-	if info.module != "" {
-		return true
-	}
-	if len(parts) == 1 {
-		return true
-	}
-	return nestiaTypiaKnownModule(parts[0])
-}
-
-func nestiaTypiaCallSegments(call *shimast.CallExpression) (string, []string, bool) {
-	if call == nil {
-		return "", nil, false
-	}
-	expression := call.Expression
-	parts := []string{}
-	for expression != nil && expression.Kind == shimast.KindPropertyAccessExpression {
-		property := expression.AsPropertyAccessExpression()
-		if property == nil {
-			return "", nil, false
-		}
-		name := property.Name()
-		if name == nil || name.Kind != shimast.KindIdentifier {
-			return "", nil, false
-		}
-		id := name.AsIdentifier()
-		if id == nil || id.Text == "" {
-			return "", nil, false
-		}
-		parts = append([]string{id.Text}, parts...)
-		expression = property.Expression
-	}
-	if expression == nil || expression.Kind != shimast.KindIdentifier {
-		return "", nil, false
-	}
-	root := expression.AsIdentifier()
-	if root == nil || root.Text == "" {
-		return "", nil, false
-	}
-	return root.Text, parts, true
-}
-
-func tryNestiaTypiaCallSite(file *shimast.SourceFile, checker *shimchecker.Checker, node *shimast.Node) (typiaadapter.CallSite, bool) {
-	if checker == nil {
-		return typiaadapter.CallSite{}, false
-	}
-	call := node.AsCallExpression()
-	if call == nil {
-		return typiaadapter.CallSite{}, false
-	}
-	signature := checker.GetResolvedSignature(node)
-	if signature == nil {
-		return typiaadapter.CallSite{}, false
-	}
-	declaration := signature.Declaration()
-	if declaration == nil {
-		return typiaadapter.CallSite{}, false
-	}
-	sourceFile := shimast.GetSourceFileOfNode(declaration)
-	if sourceFile == nil {
-		return typiaadapter.CallSite{}, false
-	}
-	module, ok := nestiaTypiaMatchModule(sourceFile.FileName())
-	if !ok {
-		return typiaadapter.CallSite{}, false
-	}
-	method := nestiaTypiaCallSiteMethodName(checker, declaration, call)
-	if method == "" {
-		return typiaadapter.CallSite{}, false
-	}
-	root, namespaces, ok := nestiaTypiaExtractRootAndNamespaces(call, method)
-	if !ok {
-		return typiaadapter.CallSite{}, false
-	}
-	return typiaadapter.CallSite{
-		File:       file,
-		FilePath:   file.FileName(),
-		Module:     module,
-		Method:     method,
-		Call:       call,
-		RootName:   root,
-		Namespaces: namespaces,
-	}, true
-}
-
-func nestiaTypiaMatchModule(location string) (string, bool) {
-	location = filepath.ToSlash(location)
-	for _, suffix := range []string{".d.ts", ".ts"} {
-		for _, middle := range []string{"typia/lib/", "typia/src/", "packages/typia/src/"} {
-			index := strings.LastIndex(location, middle)
-			if index < 0 {
-				continue
-			}
-			name := location[index+len(middle):]
-			if !strings.HasSuffix(name, suffix) {
-				continue
-			}
-			name = strings.TrimSuffix(name, suffix)
-			if strings.Contains(name, "/") {
-				continue
-			}
-			return name, true
-		}
-	}
-	return "", false
-}
-
-func nestiaTypiaCallSiteMethodName(checker *shimchecker.Checker, declaration *shimast.Node, call *shimast.CallExpression) string {
-	if name := declaration.Name(); name != nil {
-		if symbol := checker.GetSymbolAtLocation(name); symbol != nil && symbol.Name != "" {
-			return symbol.Name
-		}
-		if name.Kind == shimast.KindIdentifier {
-			if id := name.AsIdentifier(); id != nil {
-				return id.Text
-			}
-		}
-	}
-	if call.Expression != nil && call.Expression.Kind == shimast.KindPropertyAccessExpression {
-		if property := call.Expression.AsPropertyAccessExpression(); property != nil {
-			if name := property.Name(); name != nil && name.Kind == shimast.KindIdentifier {
-				if id := name.AsIdentifier(); id != nil {
-					return id.Text
-				}
-			}
-		}
-	}
-	return ""
-}
-
-func nestiaTypiaExtractRootAndNamespaces(call *shimast.CallExpression, method string) (string, []string, bool) {
-	expression := call.Expression
-	segments := []string{}
-	for expression != nil && expression.Kind == shimast.KindPropertyAccessExpression {
-		property := expression.AsPropertyAccessExpression()
-		if property == nil {
-			break
-		}
-		name := property.Name()
-		if name == nil || name.Kind != shimast.KindIdentifier {
-			return "", nil, false
-		}
-		id := name.AsIdentifier()
-		if id == nil || id.Text == "" {
-			return "", nil, false
-		}
-		segments = append([]string{id.Text}, segments...)
-		expression = property.Expression
-	}
-	if expression == nil || expression.Kind != shimast.KindIdentifier {
-		return "", nil, false
-	}
-	root := expression.AsIdentifier()
-	if root == nil || root.Text == "" || len(segments) == 0 {
-		return "", nil, false
-	}
-	if segments[len(segments)-1] != method {
-		return "", nil, false
-	}
-	return root.Text, segments[:len(segments)-1], true
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/core",
-  "version": "12.0.0",
+  "version": "12.1.0",
   "description": "Super-fast validation decorators of NestJS",
   "main": "lib/index.js",
   "exports": {
@@ -45,8 +45,8 @@
   },
   "homepage": "https://nestia.io",
   "dependencies": {
-    "@typia/interface": "^13.0.2",
-    "@typia/utils": "^13.0.2",
+    "@typia/interface": "^13.2.0",
+    "@typia/utils": "^13.2.0",
     "get-function-location": "^2.0.0",
     "glob": "^11.0.3",
     "path-parser": "^6.1.0",
@@ -54,9 +54,9 @@
     "reflect-metadata": ">=0.1.12",
     "rxjs": ">=6.0.3",
     "tgrid": "^1.1.0",
-    "typia": "^13.0.2",
+    "typia": "^13.2.0",
     "ws": "^7.5.3",
-    "@nestia/fetcher": "^12.0.0"
+    "@nestia/fetcher": "^12.1.0"
   },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "^1.18.0",
@@ -64,8 +64,8 @@
     "@nestjs/core": ">=7.0.1",
     "reflect-metadata": ">=0.1.12",
     "rxjs": ">=6.0.3",
-    "typia": "^13.0.2",
-    "@nestia/fetcher": "^12.0.0"
+    "typia": "^13.2.0",
+    "@nestia/fetcher": "^12.1.0"
   },
   "peerDependenciesMeta": {
     "@modelcontextprotocol/sdk": {
@@ -82,7 +82,7 @@
     "@types/ws": "^8.5.10",
     "fastify": "^4.28.1",
     "rimraf": "^6.1.3",
-    "ttsc": "^0.18.4",
+    "ttsc": "^0.20.0",
     "tstl": "^3.0.0",
     "typescript": "^7.0.2"
   },

package/src/adaptors/McpAdaptor.ts

@@ -73,30 +73,38 @@ export class McpAdaptor {
       for (const wrapper of module.controllers.values()) {
         const instance = wrapper.instance;
         if (!instance) continue;
-        const proto = Object.getPrototypeOf(instance);
-        for (const key of Object.getOwnPropertyNames(proto)) {
-          if (key === "constructor") continue;
-          const method = proto[key];
-          if (typeof method !== "function") continue;
+        const visited: Set<string> = new Set();
+        for (
+          let proto: any = Object.getPrototypeOf(instance);
+          proto !== null && proto !== Object.prototype;
+          proto = Object.getPrototypeOf(proto)
+        ) {
+          for (const key of Object.getOwnPropertyNames(proto)) {
+            if (key === "constructor" || visited.has(key)) continue;
+            visited.add(key);
+            const method = proto[key];
+            if (typeof method !== "function") continue;
 
-          const meta: IMcpRouteReflect | undefined = Reflect.getMetadata(
-            "nestia/McpRoute",
-            method,
-          );
-          if (!meta) continue;
+            const meta: IMcpRouteReflect | undefined = Reflect.getMetadata(
+              "nestia/McpRoute",
+              method,
+            );
+            if (!meta) continue;
 
-          const params: IMcpRouteReflect.IArgument[] =
-            Reflect.getMetadata("nestia/McpRoute/Parameters", proto, key) ?? [];
-          const paramValidator = params.find(
-            (p) => p.category === "params",
-          )?.validate;
+            const params: IMcpRouteReflect.IArgument[] =
+              Reflect.getMetadata("nestia/McpRoute/Parameters", proto, key) ??
+              [];
+            const paramValidator = params.find(
+              (p) => p.category === "params",
+            )?.validate;
 
-          tools.push({
-            meta,
-            source: `${wrapper.metatype?.name ?? proto.constructor?.name ?? "UnknownController"}.${String(key)}`,
-            validateArgs: paramValidator,
-            handler: async (args) => method.call(instance, args),
-          });
+            tools.push({
+              meta,
+              source: `${wrapper.metatype?.name ?? proto.constructor?.name ?? "UnknownController"}.${String(key)}`,
+              validateArgs: paramValidator,
+              handler: async (args) => method.call(instance, args),
+            });
+          }
         }
       }
     }

package/src/decorators/EncryptedBody.ts

@@ -13,6 +13,7 @@ import { Singleton } from "../utils/Singleton";
 import { ENCRYPTION_METADATA_KEY } from "./internal/EncryptedConstant";
 import { get_text_body } from "./internal/get_text_body";
 import { headers_to_object } from "./internal/headers_to_object";
+import { is_media_type } from "./internal/is_media_type";
 import { validate_request_body } from "./internal/validate_request_body";
 
 /**
@@ -47,7 +48,7 @@ export function EncryptedBody<T>(
     const request: express.Request | FastifyRequest = context
       .switchToHttp()
       .getRequest();
-    if (isTextPlain(request.headers["content-type"]) === false)
+    if (is_media_type(request.headers["content-type"], "text/plain") === false)
       throw new BadRequestException(`Request body type is not "text/plain".`);
 
     const param: IEncryptionPassword | IEncryptionPassword.Closure | undefined =
@@ -87,11 +88,3 @@ const decrypt = (body: string, key: string, iv: string): string => {
     else throw exp;
   }
 };
-
-/** @internal */
-const isTextPlain = (text?: string): boolean =>
-  text !== undefined &&
-  text
-    .split(";")
-    .map((str) => str.trim())
-    .some((str) => str === "text/plain");

package/src/decorators/EncryptedRoute.ts

@@ -173,7 +173,7 @@ class EncryptedRouteInterceptor implements NestInterceptor {
           context.getClass(),
         );
         if (!param)
-          return Error(
+          throw new Error(
             `Error on EncryptedRoute.${this.method}(): no password found.`,
           );
 

package/src/decorators/McpRoute.ts

@@ -137,11 +137,12 @@ export namespace McpRoute {
     propertyKey: string | symbol,
     value: IMcpRouteReflect.IArgument,
   ) => {
-    const array: IMcpRouteReflect.IArgument[] | undefined = Reflect.getMetadata(
-      "nestia/McpRoute/Parameters",
-      target,
-      propertyKey,
-    );
+    const array: IMcpRouteReflect.IArgument[] | undefined =
+      Reflect.getOwnMetadata(
+        "nestia/McpRoute/Parameters",
+        target,
+        propertyKey,
+      );
     if (array !== undefined) array.push(value);
     else
       Reflect.defineMetadata(

package/src/decorators/NoTransformConfigurationError.ts

@@ -24,8 +24,8 @@ export namespace NoTransformConfigurationError {
    *
    * Even if the transform did not run, the error will not be thrown and the
    * program will be continued. Instead, every validation and assertion will be
-   * skipped and the value
-   * will be returned as it is. Furthermore, unexpected behaviors may occur.
+   * skipped and the value will be returned as it is. Furthermore, unexpected
+   * behaviors may occur.
    *
    * Therefore, it is not recommended to set this value to `false` in production
    * environment. Configure this value to be `false` only when you're debugging

package/src/decorators/PlainBody.ts

@@ -7,6 +7,7 @@ import type express from "express";
 import type { FastifyRequest } from "fastify";
 
 import { get_text_body } from "./internal/get_text_body";
+import { is_media_type } from "./internal/is_media_type";
 import { is_request_body_undefined } from "./internal/is_request_body_undefined";
 import { validate_request_body } from "./internal/validate_request_body";
 
@@ -56,7 +57,7 @@ export function PlainBody(
       (checker ?? (() => null))(undefined as any) === null
     )
       return undefined;
-    else if (!isTextPlain(request.headers["content-type"]))
+    else if (!is_media_type(request.headers["content-type"], "text/plain"))
       throw new BadRequestException(`Request body type is not "text/plain".`);
     const value: string = await get_text_body(request);
     if (checker) {
@@ -66,11 +67,3 @@ export function PlainBody(
     return value;
   })();
 }
-
-/** @internal */
-const isTextPlain = (text?: string): boolean =>
-  text !== undefined &&
-  text
-    .split(";")
-    .map((str) => str.trim())
-    .some((str) => str === "text/plain");

package/src/decorators/SwaggerCustomizer.ts

@@ -23,8 +23,14 @@ export function SwaggerCustomizer(
     descriptor: TypedPropertyDescriptor<any>,
   ) {
     const array: Array<(props: SwaggerCustomizer.IProps) => unknown> = (() => {
-      if (Reflect.hasMetadata("nestia/SwaggerCustomizer", target, propertyKey))
-        return Reflect.getMetadata(
+      if (
+        Reflect.hasOwnMetadata(
+          "nestia/SwaggerCustomizer",
+          target,
+          propertyKey,
+        )
+      )
+        return Reflect.getOwnMetadata(
           "nestia/SwaggerCustomizer",
           target,
           propertyKey,