@nestia/core 2.4.2 → 2.4.3-dev.20231207

package/src/transformers/FileTransformer.ts

@@ -1,67 +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,97 +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/NodeTransformer.ts

@@ -1,16 +1,16 @@
-import ts from "typescript";
-
-import { INestiaTransformProject } from "../options/INestiaTransformProject";
-import { MethodTransformer } from "./MethodTransformer";
-import { ParameterTransformer } from "./ParameterTransformer";
-
-export namespace NodeTransformer {
-    export const transform =
-        (project: INestiaTransformProject) =>
-        (node: ts.Node): ts.Node =>
-            ts.isMethodDeclaration(node)
-                ? MethodTransformer.transform(project)(node)
-                : ts.isParameter(node)
-                ? ParameterTransformer.transform(project)(node)
-                : node;
-}
+import ts from "typescript";
+
+import { INestiaTransformProject } from "../options/INestiaTransformProject";
+import { MethodTransformer } from "./MethodTransformer";
+import { ParameterTransformer } from "./ParameterTransformer";
+
+export namespace NodeTransformer {
+  export const transform =
+    (project: INestiaTransformProject) =>
+    (node: ts.Node): ts.Node =>
+      ts.isMethodDeclaration(node)
+        ? MethodTransformer.transform(project)(node)
+        : ts.isParameter(node)
+        ? ParameterTransformer.transform(project)(node)
+        : node;
+}

package/src/transformers/ParameterDecoratorTransformer.ts

@@ -1,126 +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;