@nestia/core 2.6.3-dev.20240328 → 2.6.3

package/src/structures/ISwaggerRoute.ts

@@ -1,50 +1,50 @@
-import { IJsonSchema } from "typia";
-
-export interface ISwaggerRoute {
-  deprecated?: boolean;
-  security?: Record<string, string[]>[];
-  operationId?: string;
-  tags: string[];
-  parameters: ISwaggerRoute.IParameter[];
-  requestBody?: ISwaggerRoute.IRequestBody;
-  responses: ISwaggerRoute.IResponseBody;
-  summary?: string;
-  description?: string;
-}
-export namespace ISwaggerRoute {
-  export interface IParameter {
-    name: string;
-    in: string;
-    schema: IJsonSchema;
-    required: boolean;
-    description?: string;
-  }
-  export interface IRequestBody {
-    description?: string;
-    content: IContent;
-    required: true;
-    "x-nestia-encrypted"?: boolean;
-  }
-  export type IResponseBody = Record<
-    string,
-    {
-      description: string;
-      content?: IContent;
-      "x-nestia-encrypted"?: boolean;
-    }
-  >;
-  export interface IContent {
-    "application/x-www-form-urlencoded"?: {
-      schema: IJsonSchema;
-    };
-    "application/json"?: {
-      schema: IJsonSchema;
-    };
-    "text/plain"?: {
-      schema: IJsonSchema;
-    };
-    "multipart/form-data"?: {
-      schema: IJsonSchema;
-    };
-  }
-}
+import { IJsonSchema } from "typia";
+
+export interface ISwaggerRoute {
+  deprecated?: boolean;
+  security?: Record<string, string[]>[];
+  operationId?: string;
+  tags: string[];
+  parameters: ISwaggerRoute.IParameter[];
+  requestBody?: ISwaggerRoute.IRequestBody;
+  responses: ISwaggerRoute.IResponseBody;
+  summary?: string;
+  description?: string;
+}
+export namespace ISwaggerRoute {
+  export interface IParameter {
+    name: string;
+    in: string;
+    schema: IJsonSchema;
+    required: boolean;
+    description?: string;
+  }
+  export interface IRequestBody {
+    description?: string;
+    content: IContent;
+    required: true;
+    "x-nestia-encrypted"?: boolean;
+  }
+  export type IResponseBody = Record<
+    string,
+    {
+      description: string;
+      content?: IContent;
+      "x-nestia-encrypted"?: boolean;
+    }
+  >;
+  export interface IContent {
+    "application/x-www-form-urlencoded"?: {
+      schema: IJsonSchema;
+    };
+    "application/json"?: {
+      schema: IJsonSchema;
+    };
+    "text/plain"?: {
+      schema: IJsonSchema;
+    };
+    "multipart/form-data"?: {
+      schema: IJsonSchema;
+    };
+  }
+}

package/src/structures/ISwaggerSecurityScheme.ts

@@ -1,65 +1,65 @@
-/**
- * Security scheme of Swagger Documents.
- *
- * `ISwaggerSecurityScheme` is a data structure representing content of
- * `securitySchemes` in `swagger.json` file. It is composed with 5 types of security
- * schemes as an union type like below.
- *
- * @reference https://swagger.io/specification/#security-scheme-object
- * @author Jeongho Nam - https://github.com/samchon
- */
-export type ISwaggerSecurityScheme =
-  | ISwaggerSecurityScheme.IHttpBasic
-  | ISwaggerSecurityScheme.IHttpBearer
-  | ISwaggerSecurityScheme.IApiKey
-  | ISwaggerSecurityScheme.IOpenId
-  | ISwaggerSecurityScheme.IOAuth2;
-export namespace ISwaggerSecurityScheme {
-  export interface IHttpBasic {
-    type: "http";
-    scheme: "basic";
-  }
-  export interface IHttpBearer {
-    type: "http";
-    scheme: "bearer";
-    bearerFormat?: string;
-  }
-  export interface IApiKey {
-    type: "apiKey";
-
-    /**
-     * @default header
-     */
-    in?: "header" | "query" | "cookie";
-
-    /**
-     * @default Authorization
-     */
-    name?: string;
-  }
-
-  export interface IOpenId {
-    type: "openIdConnect";
-    openIdConnectUrl: string;
-  }
-
-  export interface IOAuth2 {
-    type: "oauth2";
-    flows: IOAuth2.IFlowSet;
-    description?: string;
-  }
-  export namespace IOAuth2 {
-    export interface IFlowSet {
-      authorizationCode?: IFlow;
-      implicit?: Omit<IFlow, "tokenUrl">;
-      password?: Omit<IFlow, "authorizationUrl">;
-      clientCredentials?: Omit<IFlow, "authorizationUrl">;
-    }
-    export interface IFlow {
-      authorizationUrl: string;
-      tokenUrl?: string;
-      refreshUrl?: string;
-      scopes?: Record<string, string>;
-    }
-  }
-}
+/**
+ * Security scheme of Swagger Documents.
+ *
+ * `ISwaggerSecurityScheme` is a data structure representing content of
+ * `securitySchemes` in `swagger.json` file. It is composed with 5 types of security
+ * schemes as an union type like below.
+ *
+ * @reference https://swagger.io/specification/#security-scheme-object
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export type ISwaggerSecurityScheme =
+  | ISwaggerSecurityScheme.IHttpBasic
+  | ISwaggerSecurityScheme.IHttpBearer
+  | ISwaggerSecurityScheme.IApiKey
+  | ISwaggerSecurityScheme.IOpenId
+  | ISwaggerSecurityScheme.IOAuth2;
+export namespace ISwaggerSecurityScheme {
+  export interface IHttpBasic {
+    type: "http";
+    scheme: "basic";
+  }
+  export interface IHttpBearer {
+    type: "http";
+    scheme: "bearer";
+    bearerFormat?: string;
+  }
+  export interface IApiKey {
+    type: "apiKey";
+
+    /**
+     * @default header
+     */
+    in?: "header" | "query" | "cookie";
+
+    /**
+     * @default Authorization
+     */
+    name?: string;
+  }
+
+  export interface IOpenId {
+    type: "openIdConnect";
+    openIdConnectUrl: string;
+  }
+
+  export interface IOAuth2 {
+    type: "oauth2";
+    flows: IOAuth2.IFlowSet;
+    description?: string;
+  }
+  export namespace IOAuth2 {
+    export interface IFlowSet {
+      authorizationCode?: IFlow;
+      implicit?: Omit<IFlow, "tokenUrl">;
+      password?: Omit<IFlow, "authorizationUrl">;
+      clientCredentials?: Omit<IFlow, "authorizationUrl">;
+    }
+    export interface IFlow {
+      authorizationUrl: string;
+      tokenUrl?: string;
+      refreshUrl?: string;
+      scopes?: Record<string, string>;
+    }
+  }
+}

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,120 +1,120 @@
-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)],
+};
+
+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/transformers/TypedExceptionTransformer.ts

@@ -1,48 +1,48 @@
-import path from "path";
-import ts from "typescript";
-
-import { INestiaTransformProject } from "../options/INestiaTransformProject";
-import { TypedExceptionProgrammer } from "../programmers/TypedExceptionProgrammer";
-
-export namespace TypedExceptionTransformer {
-  export const transform =
-    (project: INestiaTransformProject) =>
-    (decorator: ts.Decorator): ts.Decorator => {
-      if (!ts.isCallExpression(decorator.expression)) return decorator;
-
-      // CHECK SIGNATURE
-      const signature: ts.Signature | undefined =
-        project.checker.getResolvedSignature(decorator.expression);
-      if (!signature || !signature.declaration) return decorator;
-
-      // CHECK TO BE TRANSFORMED
-      const done: boolean = (() => {
-        // CHECK FILENAME
-        const location: string = path.resolve(
-          signature.declaration.getSourceFile().fileName,
-        );
-        if (location.indexOf(LIB_PATH) === -1 && location !== SRC_PATH)
-          return false;
-
-        // CHECK DUPLICATED
-        return decorator.expression.arguments.length !== 3;
-      })();
-      if (done === false) return decorator;
-
-      // DO TRANSFORM
-      return ts.factory.createDecorator(
-        TypedExceptionProgrammer.generate(project)(decorator.expression),
-      );
-    };
-
-  const LIB_PATH = path.join(
-    "@nestia",
-    "core",
-    "lib",
-    "decorators",
-    `TypedException.d.ts`,
-  );
-  const SRC_PATH = path.resolve(
-    path.join(__dirname, "..", "decorators", `TypedException.ts`),
-  );
-}
+import path from "path";
+import ts from "typescript";
+
+import { INestiaTransformProject } from "../options/INestiaTransformProject";
+import { TypedExceptionProgrammer } from "../programmers/TypedExceptionProgrammer";
+
+export namespace TypedExceptionTransformer {
+  export const transform =
+    (project: INestiaTransformProject) =>
+    (decorator: ts.Decorator): ts.Decorator => {
+      if (!ts.isCallExpression(decorator.expression)) return decorator;
+
+      // CHECK SIGNATURE
+      const signature: ts.Signature | undefined =
+        project.checker.getResolvedSignature(decorator.expression);
+      if (!signature || !signature.declaration) return decorator;
+
+      // CHECK TO BE TRANSFORMED
+      const done: boolean = (() => {
+        // CHECK FILENAME
+        const location: string = path.resolve(
+          signature.declaration.getSourceFile().fileName,
+        );
+        if (location.indexOf(LIB_PATH) === -1 && location !== SRC_PATH)
+          return false;
+
+        // CHECK DUPLICATED
+        return decorator.expression.arguments.length !== 3;
+      })();
+      if (done === false) return decorator;
+
+      // DO TRANSFORM
+      return ts.factory.createDecorator(
+        TypedExceptionProgrammer.generate(project)(decorator.expression),
+      );
+    };
+
+  const LIB_PATH = path.join(
+    "@nestia",
+    "core",
+    "lib",
+    "decorators",
+    `TypedException.d.ts`,
+  );
+  const SRC_PATH = path.resolve(
+    path.join(__dirname, "..", "decorators", `TypedException.ts`),
+  );
+}