@nestia/core 3.0.5 → 3.1.0-dev.20240426

package/src/decorators/internal/validate_request_headers.ts

@@ -1,83 +1,83 @@
-import { BadRequestException } from "@nestjs/common";
-import typia, { IValidation, TypeGuardError } from "typia";
-
-import { IRequestHeadersValidator } from "../../options/IRequestHeadersValidator";
-import { NoTransformConfigureError } from "./NoTransformConfigureError";
-
-/**
- * @internal
- */
-export const validate_request_headers = <T>(
-  validator?: IRequestHeadersValidator<T>,
-) => {
-  if (!validator) return () => NoTransformConfigureError("TypedHeaders");
-  else if (validator.type === "assert") return assert(validator.assert);
-  else if (validator.type === "is") return is(validator.is);
-  else if (validator.type === "validate") return validate(validator.validate);
-  return () =>
-    new Error(`Error on nestia.core.TypedHeaders(): invalid typed validator.`);
-};
-
-/**
- * @internal
- */
-const assert =
-  <T>(closure: (input: Record<string, string | string[] | undefined>) => T) =>
-  (
-    input: Record<string, string | string[] | undefined>,
-  ): T | BadRequestException => {
-    try {
-      return closure(input);
-    } catch (exp) {
-      if (typia.is<TypeGuardError>(exp)) {
-        return new BadRequestException({
-          path: exp.path,
-          reason: exp.message,
-          expected: exp.expected,
-          value: exp.value,
-          message: MESSAGE,
-        });
-      }
-      throw exp;
-    }
-  };
-
-/**
- * @internal
- */
-const is =
-  <T>(
-    closure: (input: Record<string, string | string[] | undefined>) => T | null,
-  ) =>
-  (
-    input: Record<string, string | string[] | undefined>,
-  ): T | BadRequestException => {
-    const result: T | null = closure(input);
-    return result !== null ? result : new BadRequestException(MESSAGE);
-  };
-
-/**
- * @internal
- */
-const validate =
-  <T>(
-    closure: (
-      input: Record<string, string | string[] | undefined>,
-    ) => IValidation<T>,
-  ) =>
-  (
-    input: Record<string, string | string[] | undefined>,
-  ): T | BadRequestException => {
-    const result: IValidation<T> = closure(input);
-    return result.success
-      ? result.data
-      : new BadRequestException({
-          errors: result.errors,
-          message: MESSAGE,
-        });
-  };
-
-/**
- * @internal
- */
-const MESSAGE = "Request headers data is not following the promised type.";
+import { BadRequestException } from "@nestjs/common";
+import typia, { IValidation, TypeGuardError } from "typia";
+
+import { IRequestHeadersValidator } from "../../options/IRequestHeadersValidator";
+import { NoTransformConfigureError } from "./NoTransformConfigureError";
+
+/**
+ * @internal
+ */
+export const validate_request_headers = <T>(
+  validator?: IRequestHeadersValidator<T>,
+) => {
+  if (!validator) throw NoTransformConfigureError("TypedHeaders");
+  else if (validator.type === "assert") return assert(validator.assert);
+  else if (validator.type === "is") return is(validator.is);
+  else if (validator.type === "validate") return validate(validator.validate);
+  return () =>
+    new Error(`Error on nestia.core.TypedHeaders(): invalid typed validator.`);
+};
+
+/**
+ * @internal
+ */
+const assert =
+  <T>(closure: (input: Record<string, string | string[] | undefined>) => T) =>
+  (
+    input: Record<string, string | string[] | undefined>,
+  ): T | BadRequestException => {
+    try {
+      return closure(input);
+    } catch (exp) {
+      if (typia.is<TypeGuardError>(exp)) {
+        return new BadRequestException({
+          path: exp.path,
+          reason: exp.message,
+          expected: exp.expected,
+          value: exp.value,
+          message: MESSAGE,
+        });
+      }
+      throw exp;
+    }
+  };
+
+/**
+ * @internal
+ */
+const is =
+  <T>(
+    closure: (input: Record<string, string | string[] | undefined>) => T | null,
+  ) =>
+  (
+    input: Record<string, string | string[] | undefined>,
+  ): T | BadRequestException => {
+    const result: T | null = closure(input);
+    return result !== null ? result : new BadRequestException(MESSAGE);
+  };
+
+/**
+ * @internal
+ */
+const validate =
+  <T>(
+    closure: (
+      input: Record<string, string | string[] | undefined>,
+    ) => IValidation<T>,
+  ) =>
+  (
+    input: Record<string, string | string[] | undefined>,
+  ): T | BadRequestException => {
+    const result: IValidation<T> = closure(input);
+    return result.success
+      ? result.data
+      : new BadRequestException({
+          errors: result.errors,
+          message: MESSAGE,
+        });
+  };
+
+/**
+ * @internal
+ */
+const MESSAGE = "Request headers data is not following the promised type.";

package/src/decorators/internal/validate_request_query.ts

@@ -1,71 +1,71 @@
-import { BadRequestException } from "@nestjs/common";
-import typia, { IValidation, TypeGuardError } from "typia";
-
-import { IRequestQueryValidator } from "../../options/IRequestQueryValidator";
-import { NoTransformConfigureError } from "./NoTransformConfigureError";
-
-/**
- * @internal
- */
-export const validate_request_query = <T>(
-  validator?: IRequestQueryValidator<T>,
-) => {
-  if (!validator) return () => NoTransformConfigureError("TypedQuery");
-  else if (validator.type === "assert") return assert(validator.assert);
-  else if (validator.type === "is") return is(validator.is);
-  else if (validator.type === "validate") return validate(validator.validate);
-  return () =>
-    new Error(`Error on nestia.core.TypedQuery(): invalid typed validator.`);
-};
-
-/**
- * @internal
- */
-const assert =
-  <T>(closure: (input: URLSearchParams) => T) =>
-  (input: URLSearchParams): T | BadRequestException => {
-    try {
-      return closure(input);
-    } catch (exp) {
-      if (typia.is<TypeGuardError>(exp)) {
-        return new BadRequestException({
-          path: exp.path,
-          reason: exp.message,
-          expected: exp.expected,
-          value: exp.value,
-          message: MESSAGE,
-        });
-      }
-      throw exp;
-    }
-  };
-
-/**
- * @internal
- */
-const is =
-  <T>(closure: (input: URLSearchParams) => T | null) =>
-  (input: URLSearchParams): T | BadRequestException => {
-    const result: T | null = closure(input);
-    return result !== null ? result : new BadRequestException(MESSAGE);
-  };
-
-/**
- * @internal
- */
-const validate =
-  <T>(closure: (input: URLSearchParams) => IValidation<T>) =>
-  (input: URLSearchParams): T | BadRequestException => {
-    const result: IValidation<T> = closure(input);
-    return result.success
-      ? result.data
-      : new BadRequestException({
-          errors: result.errors,
-          message: MESSAGE,
-        });
-  };
-
-/**
- * @internal
- */
-const MESSAGE = "Request query data is not following the promised type.";
+import { BadRequestException } from "@nestjs/common";
+import typia, { IValidation, TypeGuardError } from "typia";
+
+import { IRequestQueryValidator } from "../../options/IRequestQueryValidator";
+import { NoTransformConfigureError } from "./NoTransformConfigureError";
+
+/**
+ * @internal
+ */
+export const validate_request_query =
+  (method: string) =>
+  <T>(validator?: IRequestQueryValidator<T>) => {
+    if (!validator) throw NoTransformConfigureError(method);
+    else if (validator.type === "assert") return assert(validator.assert);
+    else if (validator.type === "is") return is(validator.is);
+    else if (validator.type === "validate") return validate(validator.validate);
+    return () =>
+      new Error(`Error on nestia.core.${method}(): invalid typed validator.`);
+  };
+
+/**
+ * @internal
+ */
+const assert =
+  <T>(closure: (input: URLSearchParams) => T) =>
+  (input: URLSearchParams): T | BadRequestException => {
+    try {
+      return closure(input);
+    } catch (exp) {
+      if (typia.is<TypeGuardError>(exp)) {
+        return new BadRequestException({
+          path: exp.path,
+          reason: exp.message,
+          expected: exp.expected,
+          value: exp.value,
+          message: MESSAGE,
+        });
+      }
+      throw exp;
+    }
+  };
+
+/**
+ * @internal
+ */
+const is =
+  <T>(closure: (input: URLSearchParams) => T | null) =>
+  (input: URLSearchParams): T | BadRequestException => {
+    const result: T | null = closure(input);
+    return result !== null ? result : new BadRequestException(MESSAGE);
+  };
+
+/**
+ * @internal
+ */
+const validate =
+  <T>(closure: (input: URLSearchParams) => IValidation<T>) =>
+  (input: URLSearchParams): T | BadRequestException => {
+    const result: IValidation<T> = closure(input);
+    return result.success
+      ? result.data
+      : new BadRequestException({
+          errors: result.errors,
+          message: MESSAGE,
+        });
+  };
+
+/**
+ * @internal
+ */
+const MESSAGE = "Request query data is not following the promised type.";

package/src/module.ts

@@ -1,16 +1,20 @@
-export * from "./decorators/DynamicModule";
-export * from "./decorators/EncryptedBody";
-export * from "./decorators/EncryptedController";
-export * from "./decorators/EncryptedModule";
-export * from "./decorators/EncryptedRoute";
-export * from "./utils/ExceptionManager";
-export * from "./decorators/PlainBody";
-export * from "./decorators/SwaggerCustomizer";
-export * from "./decorators/TypedBody";
-export * from "./decorators/TypedException";
-export * from "./decorators/TypedHeaders";
-export * from "./decorators/TypedFormData";
-export * from "./decorators/TypedParam";
-export * from "./decorators/TypedRoute";
-export * from "./decorators/TypedQuery";
-export * from "./options/INestiaTransformOptions";
+export * from "./decorators/DynamicModule";
+export * from "./utils/ExceptionManager";
+
+export * from "./decorators/TypedRoute";
+export * from "./decorators/TypedBody";
+export * from "./decorators/TypedQuery";
+export * from "./decorators/TypedException";
+export * from "./decorators/TypedHeaders";
+export * from "./decorators/TypedFormData";
+export * from "./decorators/TypedParam";
+
+export * from "./decorators/EncryptedController";
+export * from "./decorators/EncryptedRoute";
+export * from "./decorators/EncryptedBody";
+export * from "./decorators/EncryptedModule";
+export * from "./decorators/PlainBody";
+export * from "./decorators/SwaggerCustomizer";
+
+export * from "./adaptors/WebSocketAdaptor";
+export * from "./decorators/WebSocketRoute";

package/src/transformers/ParameterDecoratorTransformer.ts

@@ -1,120 +1,129 @@
-import path from "path";
-import ts from "typescript";
-
-import { INestiaTransformProject } from "../options/INestiaTransformProject";
-import { PlainBodyProgrammer } from "../programmers/PlainBodyProgrammer";
-import { TypedBodyProgrammer } from "../programmers/TypedBodyProgrammer";
-import { TypedFormDataBodyProgrammer } from "../programmers/TypedFormDataBodyProgrammer";
-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)],
-  "TypedFormData.Body": (project) => (modulo) => (parameters) => (type) =>
-    parameters.length
-      ? parameters
-      : [TypedFormDataBodyProgrammer.generate(project)(modulo)(type)],
-  PlainBody: (project) => (modulo) => (parameters) => (type) =>
-    parameters.length
-      ? parameters
-      : [PlainBodyProgrammer.generate(project)(modulo)(type)],
-};
-
-const LIB_PATH = path.join("@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 { TypedFormDataBodyProgrammer } from "../programmers/TypedFormDataBodyProgrammer";
+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)],
+  "TypedFormData.Body": (project) => (modulo) => (parameters) => (type) =>
+    parameters.length
+      ? parameters
+      : [TypedFormDataBodyProgrammer.generate(project)(modulo)(type)],
+  PlainBody: (project) => (modulo) => (parameters) => (type) =>
+    parameters.length
+      ? parameters
+      : [PlainBodyProgrammer.generate(project)(modulo)(type)],
+  "WebSocketRoute.Header": (project) => (modulo) => (parameters) => (type) =>
+    parameters.length
+      ? parameters
+      : [TypedBodyProgrammer.generate(project)(modulo)(type)],
+  "WebSocketRoute.Param": (project) => TypedParamProgrammer.generate(project),
+  "WebSocketRoute.Query": (project) => (modulo) => (parameters) => (type) =>
+    parameters.length
+      ? parameters
+      : [TypedQueryProgrammer.generate(project)(modulo)(type)],
+};
+
+const LIB_PATH = path.join("@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/typings/get-function-location.d.ts

@@ -0,0 +1,7 @@
+declare module "get-function-location" {
+  export default function (func: any): Promise<{
+    source: string;
+    line: number;
+    column: number;
+  }>;
+}

package/src/utils/ArrayUtil.ts

@@ -0,0 +1,7 @@
+export namespace ArrayUtil {
+  export function has<T>(array: T[], ...items: T[]): boolean {
+    return items.every(
+      (elem) => array.find((org) => org === elem) !== undefined,
+    );
+  }
+}

package/src/utils/VersioningStrategy.ts

@@ -0,0 +1,27 @@
+import { VERSION_NEUTRAL, VersionValue } from "@nestjs/common/interfaces";
+
+export namespace VersioningStrategy {
+  export interface IConfig {
+    prefix: string;
+    defaultVersion?: VersionValue;
+  }
+
+  export const cast = (
+    value: VersionValue | undefined,
+  ): Array<string | typeof VERSION_NEUTRAL> =>
+    value === undefined ? [] : Array.isArray(value) ? value : [value];
+
+  export const merge =
+    (config: IConfig | undefined) =>
+    (values: Array<string | typeof VERSION_NEUTRAL>): string[] => {
+      if (config === undefined) return [""];
+      const set: Set<string | typeof VERSION_NEUTRAL> = new Set(values);
+      const array: Array<string | typeof VERSION_NEUTRAL> =
+        set.size === 0 ? cast(config.defaultVersion) : Array.from(set);
+      return !!array?.length
+        ? array.map((x) =>
+            typeof x === "symbol" ? "" : `${config.prefix}${x}`,
+          )
+        : [];
+    };
+}