@nestia/core 2.5.0-dev.20240131 → 2.5.0

package/src/transformers/FileTransformer.ts

@@ -1,66 +1,66 @@
-import ts from "typescript";
-import { TransformerError } from "typia/lib/transformers/TransformerError";
-
-import { INestiaTransformProject } from "../options/INestiaTransformProject";
-import { NodeTransformer } from "./NodeTransformer";
-
-export namespace FileTransformer {
-  export const transform =
-    (project: Omit<INestiaTransformProject, "context">) =>
-    (context: ts.TransformationContext) =>
-    (file: ts.SourceFile): ts.SourceFile =>
-      file.isDeclarationFile
-        ? file
-        : ts.visitEachChild(
-            file,
-            (node) =>
-              iterate_node({
-                ...project,
-                context,
-              })(context)(file)(node),
-            context,
-          );
-
-  const iterate_node =
-    (project: INestiaTransformProject) =>
-    (context: ts.TransformationContext) =>
-    (file: ts.SourceFile) =>
-    (node: ts.Node): ts.Node =>
-      ts.visitEachChild(
-        try_transform_node(project)(file)(node) ?? node,
-        (child) => iterate_node(project)(context)(file)(child),
-        context,
-      );
-
-  const try_transform_node =
-    (project: INestiaTransformProject) =>
-    (file: ts.SourceFile) =>
-    (node: ts.Node): ts.Node | null => {
-      try {
-        return NodeTransformer.transform(project)(node);
-      } catch (exp) {
-        // ONLY ACCEPT TRANSFORMER-ERROR
-        if (!isTransformerError(exp)) throw exp;
-
-        // AVOID SPECIAL BUG OF TYPESCRIPT COMPILER API
-        (node as any).parent ??= file;
-
-        // REPORT DIAGNOSTIC
-        const diagnostic = ts.createDiagnosticForNode(node, {
-          key: exp.code,
-          category: ts.DiagnosticCategory.Error,
-          message: exp.message,
-          code: `(${exp.code})` as any,
-        });
-        project.extras.addDiagnostic(diagnostic);
-        return null;
-      }
-    };
-}
-
-const isTransformerError = (error: any): error is TransformerError =>
-  typeof error === "object" &&
-  error !== null &&
-  error.constructor.name === "TransformerError" &&
-  typeof error.code === "string" &&
-  typeof error.message === "string";
+import ts from "typescript";
+import { TransformerError } from "typia/lib/transformers/TransformerError";
+
+import { INestiaTransformProject } from "../options/INestiaTransformProject";
+import { NodeTransformer } from "./NodeTransformer";
+
+export namespace FileTransformer {
+  export const transform =
+    (project: Omit<INestiaTransformProject, "context">) =>
+    (context: ts.TransformationContext) =>
+    (file: ts.SourceFile): ts.SourceFile =>
+      file.isDeclarationFile
+        ? file
+        : ts.visitEachChild(
+            file,
+            (node) =>
+              iterate_node({
+                ...project,
+                context,
+              })(context)(file)(node),
+            context,
+          );
+
+  const iterate_node =
+    (project: INestiaTransformProject) =>
+    (context: ts.TransformationContext) =>
+    (file: ts.SourceFile) =>
+    (node: ts.Node): ts.Node =>
+      ts.visitEachChild(
+        try_transform_node(project)(file)(node) ?? node,
+        (child) => iterate_node(project)(context)(file)(child),
+        context,
+      );
+
+  const try_transform_node =
+    (project: INestiaTransformProject) =>
+    (file: ts.SourceFile) =>
+    (node: ts.Node): ts.Node | null => {
+      try {
+        return NodeTransformer.transform(project)(node);
+      } catch (exp) {
+        // ONLY ACCEPT TRANSFORMER-ERROR
+        if (!isTransformerError(exp)) throw exp;
+
+        // AVOID SPECIAL BUG OF TYPESCRIPT COMPILER API
+        (node as any).parent ??= file;
+
+        // REPORT DIAGNOSTIC
+        const diagnostic = ts.createDiagnosticForNode(node, {
+          key: exp.code,
+          category: ts.DiagnosticCategory.Error,
+          message: exp.message,
+          code: `(${exp.code})` as any,
+        });
+        project.extras.addDiagnostic(diagnostic);
+        return null;
+      }
+    };
+}
+
+const isTransformerError = (error: any): error is TransformerError =>
+  typeof error === "object" &&
+  error !== null &&
+  error.constructor.name === "TransformerError" &&
+  typeof error.code === "string" &&
+  typeof error.message === "string";

package/src/transformers/MethodTransformer.ts

@@ -1,94 +1,94 @@
-import ts from "typescript";
-
-import { INestiaTransformProject } from "../options/INestiaTransformProject";
-import { TypedExceptionTransformer } from "./TypedExceptionTransformer";
-import { TypedRouteTransformer } from "./TypedRouteTransformer";
-
-export namespace MethodTransformer {
-  export const transform =
-    (project: INestiaTransformProject) =>
-    (method: ts.MethodDeclaration): ts.MethodDeclaration => {
-      const decorators: readonly ts.Decorator[] | undefined = ts.getDecorators
-        ? ts.getDecorators(method)
-        : (method as any).decorators;
-      if (!decorators?.length) return method;
-
-      const signature: ts.Signature | undefined =
-        project.checker.getSignatureFromDeclaration(method);
-      const original: ts.Type | undefined =
-        signature && project.checker.getReturnTypeOfSignature(signature);
-      const escaped: ts.Type | undefined =
-        original && get_escaped_type(project.checker)(original);
-
-      if (escaped === undefined) return method;
-
-      const operator = (deco: ts.Decorator): ts.Decorator => {
-        deco = TypedExceptionTransformer.transform(project)(deco);
-        deco = TypedRouteTransformer.transform(project)(escaped)(deco);
-        return deco;
-      };
-      if (ts.getDecorators !== undefined)
-        return ts.factory.updateMethodDeclaration(
-          method,
-          (method.modifiers || []).map((mod) =>
-            ts.isDecorator(mod) ? operator(mod) : mod,
-          ),
-          method.asteriskToken,
-          method.name,
-          method.questionToken,
-          method.typeParameters,
-          method.parameters,
-          method.type,
-          method.body,
-        );
-      // eslint-disable-next-line
-      return (ts.factory.updateMethodDeclaration as any)(
-        method,
-        decorators.map(operator),
-        (method as any).modifiers,
-        method.asteriskToken,
-        method.name,
-        method.questionToken,
-        method.typeParameters,
-        method.parameters,
-        method.type,
-        method.body,
-      );
-    };
-}
-
-const get_escaped_type =
-  (checker: ts.TypeChecker) =>
-  (type: ts.Type): ts.Type => {
-    const symbol: ts.Symbol | undefined = type.getSymbol() || type.aliasSymbol;
-    return symbol && get_name(symbol) === "Promise"
-      ? escape_promise(checker)(type)
-      : type;
-  };
-
-const escape_promise =
-  (checker: ts.TypeChecker) =>
-  (type: ts.Type): ts.Type => {
-    const generic: readonly ts.Type[] = checker.getTypeArguments(
-      type as ts.TypeReference,
-    );
-    if (generic.length !== 1)
-      throw new Error(
-        "Error on ImportAnalyzer.analyze(): invalid promise type.",
-      );
-    return generic[0];
-  };
-
-const get_name = (symbol: ts.Symbol): string =>
-  explore_name(symbol.getDeclarations()![0].parent)(
-    symbol.escapedName.toString(),
-  );
-
-const explore_name =
-  (decl: ts.Node) =>
-  (name: string): string =>
-    ts.isModuleBlock(decl)
-      ? explore_name(decl.parent.parent)(
-          `${decl.parent.name.getFullText().trim()}.${name}`,
-        )
-      : name;
+import ts from "typescript";
+
+import { INestiaTransformProject } from "../options/INestiaTransformProject";
+import { TypedExceptionTransformer } from "./TypedExceptionTransformer";
+import { TypedRouteTransformer } from "./TypedRouteTransformer";
+
+export namespace MethodTransformer {
+  export const transform =
+    (project: INestiaTransformProject) =>
+    (method: ts.MethodDeclaration): ts.MethodDeclaration => {
+      const decorators: readonly ts.Decorator[] | undefined = ts.getDecorators
+        ? ts.getDecorators(method)
+        : (method as any).decorators;
+      if (!decorators?.length) return method;
+
+      const signature: ts.Signature | undefined =
+        project.checker.getSignatureFromDeclaration(method);
+      const original: ts.Type | undefined =
+        signature && project.checker.getReturnTypeOfSignature(signature);
+      const escaped: ts.Type | undefined =
+        original && get_escaped_type(project.checker)(original);
+
+      if (escaped === undefined) return method;
+
+      const operator = (deco: ts.Decorator): ts.Decorator => {
+        deco = TypedExceptionTransformer.transform(project)(deco);
+        deco = TypedRouteTransformer.transform(project)(escaped)(deco);
+        return deco;
+      };
+      if (ts.getDecorators !== undefined)
+        return ts.factory.updateMethodDeclaration(
+          method,
+          (method.modifiers || []).map((mod) =>
+            ts.isDecorator(mod) ? operator(mod) : mod,
+          ),
+          method.asteriskToken,
+          method.name,
+          method.questionToken,
+          method.typeParameters,
+          method.parameters,
+          method.type,
+          method.body,
+        );
+      // eslint-disable-next-line
+      return (ts.factory.updateMethodDeclaration as any)(
+        method,
+        decorators.map(operator),
+        (method as any).modifiers,
+        method.asteriskToken,
+        method.name,
+        method.questionToken,
+        method.typeParameters,
+        method.parameters,
+        method.type,
+        method.body,
+      );
+    };
+}
+
+const get_escaped_type =
+  (checker: ts.TypeChecker) =>
+  (type: ts.Type): ts.Type => {
+    const symbol: ts.Symbol | undefined = type.getSymbol() || type.aliasSymbol;
+    return symbol && get_name(symbol) === "Promise"
+      ? escape_promise(checker)(type)
+      : type;
+  };
+
+const escape_promise =
+  (checker: ts.TypeChecker) =>
+  (type: ts.Type): ts.Type => {
+    const generic: readonly ts.Type[] = checker.getTypeArguments(
+      type as ts.TypeReference,
+    );
+    if (generic.length !== 1)
+      throw new Error(
+        "Error on ImportAnalyzer.analyze(): invalid promise type.",
+      );
+    return generic[0];
+  };
+
+const get_name = (symbol: ts.Symbol): string =>
+  explore_name(symbol.getDeclarations()![0].parent)(
+    symbol.escapedName.toString(),
+  );
+
+const explore_name =
+  (decl: ts.Node) =>
+  (name: string): string =>
+    ts.isModuleBlock(decl)
+      ? explore_name(decl.parent.parent)(
+          `${decl.parent.name.getFullText().trim()}.${name}`,
+        )
+      : name;

package/src/transformers/ParameterDecoratorTransformer.ts

@@ -1,121 +1,121 @@
-import path from "path";
-import ts from "typescript";
-
-import { INestiaTransformProject } from "../options/INestiaTransformProject";
-import { PlainBodyProgrammer } from "../programmers/PlainBodyProgrammer";
-import { TypedBodyProgrammer } from "../programmers/TypedBodyProgrammer";
-import { TypedHeadersProgrammer } from "../programmers/TypedHeadersProgrammer";
-import { TypedParamProgrammer } from "../programmers/TypedParamProgrammer";
-import { TypedQueryBodyProgrammer } from "../programmers/TypedQueryBodyProgrammer";
-import { TypedQueryProgrammer } from "../programmers/TypedQueryProgrammer";
-
-export namespace ParameterDecoratorTransformer {
-  export const transform =
-    (project: INestiaTransformProject) =>
-    (type: ts.Type) =>
-    (decorator: ts.Decorator): ts.Decorator => {
-      //----
-      // VALIDATIONS
-      //----
-      // CHECK DECORATOR
-      if (!ts.isCallExpression(decorator.expression)) return decorator;
-
-      // SIGNATURE DECLARATION
-      const declaration: ts.Declaration | undefined =
-        project.checker.getResolvedSignature(decorator.expression)?.declaration;
-      if (declaration === undefined) return decorator;
-
-      // FILE PATH
-      const file: string = path.resolve(declaration.getSourceFile().fileName);
-      if (file.indexOf(LIB_PATH) === -1 && file.indexOf(SRC_PATH) === -1)
-        return decorator;
-
-      //----
-      // TRANSFORMATION
-      //----
-      // FIND PROGRAMMER
-      const programmer: Programmer | undefined =
-        FUNCTORS[
-          getName(project.checker.getTypeAtLocation(declaration).symbol)
-        ];
-      if (programmer === undefined) return decorator;
-
-      // GET TYPE INFO
-      const typeNode: ts.TypeNode | undefined = project.checker.typeToTypeNode(
-        type,
-        undefined,
-        undefined,
-      );
-      if (typeNode === undefined) return decorator;
-
-      // DO TRANSFORM
-      return ts.factory.createDecorator(
-        ts.factory.updateCallExpression(
-          decorator.expression,
-          decorator.expression.expression,
-          decorator.expression.typeArguments,
-          programmer(project)(decorator.expression.expression)(
-            decorator.expression.arguments,
-          )(type),
-        ),
-      );
-    };
-}
-
-type Programmer = (
-  project: INestiaTransformProject,
-) => (
-  modulo: ts.LeftHandSideExpression,
-) => (
-  parameters: readonly ts.Expression[],
-) => (type: ts.Type) => readonly ts.Expression[];
-
-const FUNCTORS: Record<string, Programmer> = {
-  EncryptedBody: (project) => (modulo) => (parameters) => (type) =>
-    parameters.length
-      ? parameters
-      : [TypedBodyProgrammer.generate(project)(modulo)(type)],
-  TypedBody: (project) => (modulo) => (parameters) => (type) =>
-    parameters.length
-      ? parameters
-      : [TypedBodyProgrammer.generate(project)(modulo)(type)],
-  TypedHeaders: (project) => (modulo) => (parameters) => (type) =>
-    parameters.length
-      ? parameters
-      : [TypedHeadersProgrammer.generate(project)(modulo)(type)],
-  TypedParam: (project) => TypedParamProgrammer.generate(project),
-  TypedQuery: (project) => (modulo) => (parameters) => (type) =>
-    parameters.length
-      ? parameters
-      : [TypedQueryProgrammer.generate(project)(modulo)(type)],
-  "TypedQuery.Body": (project) => (modulo) => (parameters) => (type) =>
-    parameters.length
-      ? parameters
-      : [TypedQueryBodyProgrammer.generate(project)(modulo)(type)],
-  PlainBody: (project) => (modulo) => (parameters) => (type) =>
-    parameters.length
-      ? parameters
-      : [PlainBodyProgrammer.generate(project)(modulo)(type)],
-};
-
-const LIB_PATH = path.join(
-  "node_modules",
-  "@nestia",
-  "core",
-  "lib",
-  "decorators",
-);
-const SRC_PATH = path.resolve(path.join(__dirname, "..", "decorators"));
-
-const getName = (symbol: ts.Symbol): string => {
-  const parent = symbol.getDeclarations()?.[0]?.parent;
-  return parent ? exploreName(parent)(symbol.escapedName.toString()) : "__type";
-};
-const exploreName =
-  (decl: ts.Node) =>
-  (name: string): string =>
-    ts.isModuleBlock(decl)
-      ? exploreName(decl.parent.parent)(
-          `${decl.parent.name.getFullText().trim()}.${name}`,
-        )
-      : name;
+import path from "path";
+import ts from "typescript";
+
+import { INestiaTransformProject } from "../options/INestiaTransformProject";
+import { PlainBodyProgrammer } from "../programmers/PlainBodyProgrammer";
+import { TypedBodyProgrammer } from "../programmers/TypedBodyProgrammer";
+import { TypedHeadersProgrammer } from "../programmers/TypedHeadersProgrammer";
+import { TypedParamProgrammer } from "../programmers/TypedParamProgrammer";
+import { TypedQueryBodyProgrammer } from "../programmers/TypedQueryBodyProgrammer";
+import { TypedQueryProgrammer } from "../programmers/TypedQueryProgrammer";
+
+export namespace ParameterDecoratorTransformer {
+  export const transform =
+    (project: INestiaTransformProject) =>
+    (type: ts.Type) =>
+    (decorator: ts.Decorator): ts.Decorator => {
+      //----
+      // VALIDATIONS
+      //----
+      // CHECK DECORATOR
+      if (!ts.isCallExpression(decorator.expression)) return decorator;
+
+      // SIGNATURE DECLARATION
+      const declaration: ts.Declaration | undefined =
+        project.checker.getResolvedSignature(decorator.expression)?.declaration;
+      if (declaration === undefined) return decorator;
+
+      // FILE PATH
+      const file: string = path.resolve(declaration.getSourceFile().fileName);
+      if (file.indexOf(LIB_PATH) === -1 && file.indexOf(SRC_PATH) === -1)
+        return decorator;
+
+      //----
+      // TRANSFORMATION
+      //----
+      // FIND PROGRAMMER
+      const programmer: Programmer | undefined =
+        FUNCTORS[
+          getName(project.checker.getTypeAtLocation(declaration).symbol)
+        ];
+      if (programmer === undefined) return decorator;
+
+      // GET TYPE INFO
+      const typeNode: ts.TypeNode | undefined = project.checker.typeToTypeNode(
+        type,
+        undefined,
+        undefined,
+      );
+      if (typeNode === undefined) return decorator;
+
+      // DO TRANSFORM
+      return ts.factory.createDecorator(
+        ts.factory.updateCallExpression(
+          decorator.expression,
+          decorator.expression.expression,
+          decorator.expression.typeArguments,
+          programmer(project)(decorator.expression.expression)(
+            decorator.expression.arguments,
+          )(type),
+        ),
+      );
+    };
+}
+
+type Programmer = (
+  project: INestiaTransformProject,
+) => (
+  modulo: ts.LeftHandSideExpression,
+) => (
+  parameters: readonly ts.Expression[],
+) => (type: ts.Type) => readonly ts.Expression[];
+
+const FUNCTORS: Record<string, Programmer> = {
+  EncryptedBody: (project) => (modulo) => (parameters) => (type) =>
+    parameters.length
+      ? parameters
+      : [TypedBodyProgrammer.generate(project)(modulo)(type)],
+  TypedBody: (project) => (modulo) => (parameters) => (type) =>
+    parameters.length
+      ? parameters
+      : [TypedBodyProgrammer.generate(project)(modulo)(type)],
+  TypedHeaders: (project) => (modulo) => (parameters) => (type) =>
+    parameters.length
+      ? parameters
+      : [TypedHeadersProgrammer.generate(project)(modulo)(type)],
+  TypedParam: (project) => TypedParamProgrammer.generate(project),
+  TypedQuery: (project) => (modulo) => (parameters) => (type) =>
+    parameters.length
+      ? parameters
+      : [TypedQueryProgrammer.generate(project)(modulo)(type)],
+  "TypedQuery.Body": (project) => (modulo) => (parameters) => (type) =>
+    parameters.length
+      ? parameters
+      : [TypedQueryBodyProgrammer.generate(project)(modulo)(type)],
+  PlainBody: (project) => (modulo) => (parameters) => (type) =>
+    parameters.length
+      ? parameters
+      : [PlainBodyProgrammer.generate(project)(modulo)(type)],
+};
+
+const LIB_PATH = path.join(
+  "node_modules",
+  "@nestia",
+  "core",
+  "lib",
+  "decorators",
+);
+const SRC_PATH = path.resolve(path.join(__dirname, "..", "decorators"));
+
+const getName = (symbol: ts.Symbol): string => {
+  const parent = symbol.getDeclarations()?.[0]?.parent;
+  return parent ? exploreName(parent)(symbol.escapedName.toString()) : "__type";
+};
+const exploreName =
+  (decl: ts.Node) =>
+  (name: string): string =>
+    ts.isModuleBlock(decl)
+      ? exploreName(decl.parent.parent)(
+          `${decl.parent.name.getFullText().trim()}.${name}`,
+        )
+      : name;

package/src/transformers/ParameterTransformer.ts

@@ -1,48 +1,48 @@
-import ts from "typescript";
-
-import { INestiaTransformProject } from "../options/INestiaTransformProject";
-import { ParameterDecoratorTransformer } from "./ParameterDecoratorTransformer";
-
-export namespace ParameterTransformer {
-  export const transform =
-    (project: INestiaTransformProject) =>
-    (param: ts.ParameterDeclaration): ts.ParameterDeclaration => {
-      // CHECK DECORATOR
-      const decorators: readonly ts.Decorator[] | undefined = ts.getDecorators
-        ? ts.getDecorators(param)
-        : (param as any).decorators;
-      if (!decorators?.length) return param;
-
-      // GET TYPE INFO
-      const type: ts.Type = project.checker.getTypeAtLocation(param);
-
-      // WHEN LATEST TS VERSION
-      if (ts.getDecorators !== undefined)
-        return ts.factory.updateParameterDeclaration(
-          param,
-          (param.modifiers || []).map((mod) =>
-            ts.isDecorator(mod)
-              ? ParameterDecoratorTransformer.transform(project)(type)(mod)
-              : mod,
-          ),
-          param.dotDotDotToken,
-          param.name,
-          param.questionToken,
-          param.type,
-          param.initializer,
-        );
-      // eslint-disable-next-line
-      return (ts.factory.updateParameterDeclaration as any)(
-        param,
-        decorators.map((deco) =>
-          ParameterDecoratorTransformer.transform(project)(type)(deco),
-        ),
-        (param as any).modifiers,
-        param.dotDotDotToken,
-        param.name,
-        param.questionToken,
-        param.type,
-        param.initializer,
-      );
-    };
-}
+import ts from "typescript";
+
+import { INestiaTransformProject } from "../options/INestiaTransformProject";
+import { ParameterDecoratorTransformer } from "./ParameterDecoratorTransformer";
+
+export namespace ParameterTransformer {
+  export const transform =
+    (project: INestiaTransformProject) =>
+    (param: ts.ParameterDeclaration): ts.ParameterDeclaration => {
+      // CHECK DECORATOR
+      const decorators: readonly ts.Decorator[] | undefined = ts.getDecorators
+        ? ts.getDecorators(param)
+        : (param as any).decorators;
+      if (!decorators?.length) return param;
+
+      // GET TYPE INFO
+      const type: ts.Type = project.checker.getTypeAtLocation(param);
+
+      // WHEN LATEST TS VERSION
+      if (ts.getDecorators !== undefined)
+        return ts.factory.updateParameterDeclaration(
+          param,
+          (param.modifiers || []).map((mod) =>
+            ts.isDecorator(mod)
+              ? ParameterDecoratorTransformer.transform(project)(type)(mod)
+              : mod,
+          ),
+          param.dotDotDotToken,
+          param.name,
+          param.questionToken,
+          param.type,
+          param.initializer,
+        );
+      // eslint-disable-next-line
+      return (ts.factory.updateParameterDeclaration as any)(
+        param,
+        decorators.map((deco) =>
+          ParameterDecoratorTransformer.transform(project)(type)(deco),
+        ),
+        (param as any).modifiers,
+        param.dotDotDotToken,
+        param.name,
+        param.questionToken,
+        param.type,
+        param.initializer,
+      );
+    };
+}