@nestia/core 3.0.0 → 3.0.1-dev.20240412

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/core",
-  "version": "3.0.0",
+  "version": "3.0.1-dev.20240412",
   "description": "Super-fast validation decorators of NestJS",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -36,25 +36,25 @@
   },
   "homepage": "https://nestia.io",
   "dependencies": {
-    "@nestia/fetcher": "^3.0.0",
+    "@nestia/fetcher": "^3.0.1-dev.20240412",
     "@nestjs/common": ">=7.0.1",
     "@nestjs/core": ">=7.0.1",
-    "@samchon/openapi": "^0.1.2",
+    "@samchon/openapi": "^0.1.4",
     "detect-ts-node": "^1.0.5",
     "glob": "^7.2.0",
     "multer": "1.4.5-lts.1",
     "raw-body": "^2.0.0",
     "reflect-metadata": ">=0.1.12",
-    "rxjs": ">=6.0.0",
-    "typia": "^6.0.0"
+    "rxjs": ">=6.0.1",
+    "typia": "^6.0.1"
   },
   "peerDependencies": {
-    "@nestia/fetcher": ">=3.0.0",
+    "@nestia/fetcher": ">=3.0.1-dev.20240412",
     "@nestjs/common": ">=7.0.1",
     "@nestjs/core": ">=7.0.1",
     "reflect-metadata": ">=0.1.12",
-    "rxjs": ">=6.0.0",
-    "typia": ">=6.0.0 <7.0.0"
+    "rxjs": ">=6.0.1",
+    "typia": ">=6.0.1 <7.0.0"
   },
   "devDependencies": {
     "@fastify/multipart": "^8.1.0",

package/src/decorators/SwaggerCustomizer.ts

@@ -1,115 +1,115 @@
-import { OpenApi } from "@samchon/openapi";
-
-/**
- * Swagger customization decorator.
- *
- * `SwaggerCustomizer` is a method decorator function which can used for
- * customizing the swagger data with `npx nestia swagger` command. Furthermore,
- * it is possible to add plugin properties starting with `x-` characters.
- *
- * In other words, this decorator function does not affect to the runtime,
- * but only for the swagger data customization.
- *
- * @param closure Callback function which can customize the swagger data
- * @returns Method decorator
- * @author Jeongho Nam - https://github.com/samchon
- */
-export function SwaggerCustomizer(
-  closure: (props: SwaggerCustomizer.IProps) => unknown,
-): MethodDecorator {
-  return function SwaggerCustomizer(
-    target: Object,
-    propertyKey: string | symbol,
-    descriptor: TypedPropertyDescriptor<any>,
-  ) {
-    const array: Array<(props: SwaggerCustomizer.IProps) => unknown> = (() => {
-      if (Reflect.hasMetadata("nestia/SwaggerCustomizer", target, propertyKey))
-        return Reflect.getMetadata(
-          "nestia/SwaggerCustomizer",
-          target,
-          propertyKey,
-        );
-      const array: Array<(props: SwaggerCustomizer.IProps) => unknown> = [];
-      Reflect.defineMetadata(
-        "nestia/SwaggerCustomizer",
-        array,
-        target,
-        propertyKey,
-      );
-      return array;
-    })();
-    array.push(closure);
-    return descriptor;
-  };
-}
-export namespace SwaggerCustomizer {
-  /**
-   * Properties for the `SwaggerCustomizer` decorator.
-   *
-   * `SwaggerCustomizer.IProps` is a type for the `closure` parameter of the
-   * `SwaggerCustomizer` decorator. It's a callback function which can customize
-   * the swagger data.
-   */
-  export interface IProps {
-    /**
-     * Swagger data.
-     */
-    swagger: OpenApi.IDocument;
-
-    /**
-     * Method of the route.
-     */
-    method: string;
-
-    /**
-     * Path of the route.
-     */
-    path: string;
-
-    /**
-     * Route data.
-     */
-    route: OpenApi.IOperation;
-
-    /**
-     * Get neighbor endpoint data through the controller method.
-     *
-     * @param func Controller method to find the neighbor endpoint
-     * @returns Neighbor endpoint data
-     */
-    at(func: Function): ISwaggerEndpoint | undefined;
-
-    /**
-     * Get neighbor route data.
-     *
-     * @param accessor Accessor for getting neighbor route data
-     * @returns Neighbor route data
-     */
-    get(accessor: IAccessor): OpenApi.IOperation | undefined;
-  }
-
-  /**
-   * Accessor for getting neighbor route data.
-   */
-  export interface IAccessor {
-    /**
-     * Path of the neighbor route.
-     */
-    path: string;
-
-    /**
-     * Method of the neighbor route.
-     */
-    method: string;
-  }
-
-  /**
-   * Endpoint info of the route.
-   */
-  export interface ISwaggerEndpoint extends IAccessor {
-    /**
-     * Route data.
-     */
-    route: OpenApi.IOperation;
-  }
-}
+import { OpenApi } from "@samchon/openapi";
+
+/**
+ * Swagger customization decorator.
+ *
+ * `SwaggerCustomizer` is a method decorator function which can used for
+ * customizing the swagger data with `npx nestia swagger` command. Furthermore,
+ * it is possible to add plugin properties starting with `x-` characters.
+ *
+ * In other words, this decorator function does not affect to the runtime,
+ * but only for the swagger data customization.
+ *
+ * @param closure Callback function which can customize the swagger data
+ * @returns Method decorator
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export function SwaggerCustomizer(
+  closure: (props: SwaggerCustomizer.IProps) => unknown,
+): MethodDecorator {
+  return function SwaggerCustomizer(
+    target: Object,
+    propertyKey: string | symbol,
+    descriptor: TypedPropertyDescriptor<any>,
+  ) {
+    const array: Array<(props: SwaggerCustomizer.IProps) => unknown> = (() => {
+      if (Reflect.hasMetadata("nestia/SwaggerCustomizer", target, propertyKey))
+        return Reflect.getMetadata(
+          "nestia/SwaggerCustomizer",
+          target,
+          propertyKey,
+        );
+      const array: Array<(props: SwaggerCustomizer.IProps) => unknown> = [];
+      Reflect.defineMetadata(
+        "nestia/SwaggerCustomizer",
+        array,
+        target,
+        propertyKey,
+      );
+      return array;
+    })();
+    array.push(closure);
+    return descriptor;
+  };
+}
+export namespace SwaggerCustomizer {
+  /**
+   * Properties for the `SwaggerCustomizer` decorator.
+   *
+   * `SwaggerCustomizer.IProps` is a type for the `closure` parameter of the
+   * `SwaggerCustomizer` decorator. It's a callback function which can customize
+   * the swagger data.
+   */
+  export interface IProps {
+    /**
+     * Swagger data.
+     */
+    swagger: OpenApi.IDocument;
+
+    /**
+     * Method of the route.
+     */
+    method: string;
+
+    /**
+     * Path of the route.
+     */
+    path: string;
+
+    /**
+     * Route data.
+     */
+    route: OpenApi.IOperation;
+
+    /**
+     * Get neighbor endpoint data through the controller method.
+     *
+     * @param func Controller method to find the neighbor endpoint
+     * @returns Neighbor endpoint data
+     */
+    at(func: Function): ISwaggerEndpoint | undefined;
+
+    /**
+     * Get neighbor route data.
+     *
+     * @param accessor Accessor for getting neighbor route data
+     * @returns Neighbor route data
+     */
+    get(accessor: IAccessor): OpenApi.IOperation | undefined;
+  }
+
+  /**
+   * Accessor for getting neighbor route data.
+   */
+  export interface IAccessor {
+    /**
+     * Path of the neighbor route.
+     */
+    path: string;
+
+    /**
+     * Method of the neighbor route.
+     */
+    method: string;
+  }
+
+  /**
+   * Endpoint info of the route.
+   */
+  export interface ISwaggerEndpoint extends IAccessor {
+    /**
+     * Route data.
+     */
+    route: OpenApi.IOperation;
+  }
+}

package/src/programmers/TypedFormDataBodyProgrammer.ts

@@ -1,108 +1,108 @@
-import ts from "typescript";
-import { LiteralFactory } from "typia/lib/factories/LiteralFactory";
-import { MetadataCollection } from "typia/lib/factories/MetadataCollection";
-import { MetadataFactory } from "typia/lib/factories/MetadataFactory";
-import { HttpAssertFormDataProgrammer } from "typia/lib/programmers/http/HttpAssertFormDataProgrammer";
-import { HttpFormDataProgrammer } from "typia/lib/programmers/http/HttpFormDataProgrammer";
-import { HttpIsFormDataProgrammer } from "typia/lib/programmers/http/HttpIsFormDataProgrammer";
-import { HttpValidateFormDataProgrammer } from "typia/lib/programmers/http/HttpValidateFormDataProgrammer";
-import { Metadata } from "typia/lib/schemas/metadata/Metadata";
-import { IProject } from "typia/lib/transformers/IProject";
-import { TransformerError } from "typia/lib/transformers/TransformerError";
-
-import { INestiaTransformProject } from "../options/INestiaTransformProject";
-import { IRequestFormDataProps } from "../options/IRequestFormDataProps";
-
-export namespace TypedFormDataBodyProgrammer {
-  export const generate =
-    (project: INestiaTransformProject) =>
-    (modulo: ts.LeftHandSideExpression) =>
-    (type: ts.Type): ts.ObjectLiteralExpression => {
-      // VALIDATE TYPE
-      const collection: MetadataCollection = new MetadataCollection();
-      const result = MetadataFactory.analyze(
-        project.checker,
-        project.context,
-      )({
-        escape: false,
-        constant: true,
-        absorb: true,
-        validate: HttpFormDataProgrammer.validate,
-      })(collection)(type);
-      if (result.success === false)
-        throw TransformerError.from("nestia.core.TypedFormData.Body")(
-          result.errors,
-        );
-
-      const files: IRequestFormDataProps.IFile[] =
-        result.data.objects[0].properties
-          .filter(
-            (p) =>
-              isFile(p.value) ||
-              p.value.arrays.some((a) => isFile(a.type.value)),
-          )
-          .map((p) => ({
-            name: p.key.constants[0].values[0].value as string,
-            limit: !!p.value.natives.length ? 1 : null,
-          }));
-
-      // GENERATE VALIDATION PLAN
-      const parameter =
-        (key: IRequestFormDataProps<any>["validator"]["type"]) =>
-        (
-          programmer: (
-            project: IProject,
-          ) => (
-            modulo: ts.LeftHandSideExpression,
-          ) => (type: ts.Type) => ts.ArrowFunction,
-        ) =>
-          ts.factory.createObjectLiteralExpression(
-            [
-              ts.factory.createPropertyAssignment(
-                ts.factory.createIdentifier("files"),
-                LiteralFactory.generate(files),
-              ),
-              ts.factory.createPropertyAssignment(
-                ts.factory.createIdentifier("validator"),
-                ts.factory.createObjectLiteralExpression(
-                  [
-                    ts.factory.createPropertyAssignment(
-                      ts.factory.createIdentifier("type"),
-                      ts.factory.createStringLiteral(key),
-                    ),
-                    ts.factory.createPropertyAssignment(
-                      ts.factory.createIdentifier(key),
-                      programmer({
-                        ...project,
-                        options: {
-                          numeric: false,
-                          finite: false,
-                          functional: false,
-                        },
-                      })(modulo)(type),
-                    ),
-                  ],
-                  true,
-                ),
-              ),
-            ],
-            true,
-          );
-
-      // RETURNS
-      const category = project.options.validate;
-      if (category === "is" || category === "equals")
-        return parameter("is")(HttpIsFormDataProgrammer.write);
-      else if (
-        category === "validate" ||
-        category === "validateEquals" ||
-        category === "validateClone" ||
-        category === "validatePrune"
-      )
-        return parameter("validate")(HttpValidateFormDataProgrammer.write);
-      return parameter("assert")(HttpAssertFormDataProgrammer.write);
-    };
-}
-
-const isFile = (meta: Metadata) =>
-  meta.natives.some((n) => n === "File" || n === "Blob");
+import ts from "typescript";
+import { LiteralFactory } from "typia/lib/factories/LiteralFactory";
+import { MetadataCollection } from "typia/lib/factories/MetadataCollection";
+import { MetadataFactory } from "typia/lib/factories/MetadataFactory";
+import { HttpAssertFormDataProgrammer } from "typia/lib/programmers/http/HttpAssertFormDataProgrammer";
+import { HttpFormDataProgrammer } from "typia/lib/programmers/http/HttpFormDataProgrammer";
+import { HttpIsFormDataProgrammer } from "typia/lib/programmers/http/HttpIsFormDataProgrammer";
+import { HttpValidateFormDataProgrammer } from "typia/lib/programmers/http/HttpValidateFormDataProgrammer";
+import { Metadata } from "typia/lib/schemas/metadata/Metadata";
+import { IProject } from "typia/lib/transformers/IProject";
+import { TransformerError } from "typia/lib/transformers/TransformerError";
+
+import { INestiaTransformProject } from "../options/INestiaTransformProject";
+import { IRequestFormDataProps } from "../options/IRequestFormDataProps";
+
+export namespace TypedFormDataBodyProgrammer {
+  export const generate =
+    (project: INestiaTransformProject) =>
+    (modulo: ts.LeftHandSideExpression) =>
+    (type: ts.Type): ts.ObjectLiteralExpression => {
+      // VALIDATE TYPE
+      const collection: MetadataCollection = new MetadataCollection();
+      const result = MetadataFactory.analyze(
+        project.checker,
+        project.context,
+      )({
+        escape: false,
+        constant: true,
+        absorb: true,
+        validate: HttpFormDataProgrammer.validate,
+      })(collection)(type);
+      if (result.success === false)
+        throw TransformerError.from("nestia.core.TypedFormData.Body")(
+          result.errors,
+        );
+
+      const files: IRequestFormDataProps.IFile[] =
+        result.data.objects[0].properties
+          .filter(
+            (p) =>
+              isFile(p.value) ||
+              p.value.arrays.some((a) => isFile(a.type.value)),
+          )
+          .map((p) => ({
+            name: p.key.constants[0].values[0].value as string,
+            limit: !!p.value.natives.length ? 1 : null,
+          }));
+
+      // GENERATE VALIDATION PLAN
+      const parameter =
+        (key: IRequestFormDataProps<any>["validator"]["type"]) =>
+        (
+          programmer: (
+            project: IProject,
+          ) => (
+            modulo: ts.LeftHandSideExpression,
+          ) => (type: ts.Type) => ts.ArrowFunction,
+        ) =>
+          ts.factory.createObjectLiteralExpression(
+            [
+              ts.factory.createPropertyAssignment(
+                ts.factory.createIdentifier("files"),
+                LiteralFactory.generate(files),
+              ),
+              ts.factory.createPropertyAssignment(
+                ts.factory.createIdentifier("validator"),
+                ts.factory.createObjectLiteralExpression(
+                  [
+                    ts.factory.createPropertyAssignment(
+                      ts.factory.createIdentifier("type"),
+                      ts.factory.createStringLiteral(key),
+                    ),
+                    ts.factory.createPropertyAssignment(
+                      ts.factory.createIdentifier(key),
+                      programmer({
+                        ...project,
+                        options: {
+                          numeric: false,
+                          finite: false,
+                          functional: false,
+                        },
+                      })(modulo)(type),
+                    ),
+                  ],
+                  true,
+                ),
+              ),
+            ],
+            true,
+          );
+
+      // RETURNS
+      const category = project.options.validate;
+      if (category === "is" || category === "equals")
+        return parameter("is")(HttpIsFormDataProgrammer.write);
+      else if (
+        category === "validate" ||
+        category === "validateEquals" ||
+        category === "validateClone" ||
+        category === "validatePrune"
+      )
+        return parameter("validate")(HttpValidateFormDataProgrammer.write);
+      return parameter("assert")(HttpAssertFormDataProgrammer.write);
+    };
+}
+
+const isFile = (meta: Metadata) =>
+  meta.natives.some((n) => n === "File" || n === "Blob");

package/src/programmers/http/HttpQuerifyProgrammer.ts

@@ -1,96 +1,96 @@
-import ts from "typescript";
-import { IdentifierFactory } from "typia/lib/factories/IdentifierFactory";
-import { MetadataCollection } from "typia/lib/factories/MetadataCollection";
-import { MetadataFactory } from "typia/lib/factories/MetadataFactory";
-import { StatementFactory } from "typia/lib/factories/StatementFactory";
-import { FunctionImporter } from "typia/lib/programmers/helpers/FunctionImporeter";
-import { HttpQueryProgrammer } from "typia/lib/programmers/http/HttpQueryProgrammer";
-import { Metadata } from "typia/lib/schemas/metadata/Metadata";
-import { MetadataObject } from "typia/lib/schemas/metadata/MetadataObject";
-import { IProject } from "typia/lib/transformers/IProject";
-import { TransformerError } from "typia/lib/transformers/TransformerError";
-
-export namespace HttpQuerifyProgrammer {
-  export const write =
-    (project: IProject) =>
-    (modulo: ts.LeftHandSideExpression) =>
-    (type: ts.Type): ts.ArrowFunction => {
-      // GET OBJECT TYPE
-      const importer: FunctionImporter = new FunctionImporter(modulo.getText());
-      const collection: MetadataCollection = new MetadataCollection();
-      const result = MetadataFactory.analyze(project.checker)({
-        escape: false,
-        constant: true,
-        absorb: true,
-        validate: HttpQueryProgrammer.validate,
-      })(collection)(type);
-      if (result.success === false)
-        throw TransformerError.from(
-          `nestia.core.TypedQuery.${importer.method}`,
-        )(result.errors);
-
-      const object: MetadataObject = result.data.objects[0]!;
-      return ts.factory.createArrowFunction(
-        undefined,
-        undefined,
-        [IdentifierFactory.parameter("input")],
-        undefined,
-        undefined,
-        ts.factory.createBlock(
-          [
-            ...importer.declare(modulo),
-            StatementFactory.constant(
-              "output",
-              ts.factory.createNewExpression(
-                ts.factory.createIdentifier("URLSearchParams"),
-                undefined,
-                [],
-              ),
-            ),
-            ...object.properties.map((p) =>
-              ts.factory.createExpressionStatement(
-                decode(p.key.constants[0]!.values[0].value as string)(p.value),
-              ),
-            ),
-            ts.factory.createReturnStatement(
-              ts.factory.createIdentifier("output"),
-            ),
-          ],
-          true,
-        ),
-      );
-    };
-
-  const decode =
-    (key: string) =>
-    (value: Metadata): ts.CallExpression =>
-      !!value.arrays.length
-        ? ts.factory.createCallExpression(
-            IdentifierFactory.access(
-              IdentifierFactory.access(ts.factory.createIdentifier("input"))(
-                key,
-              ),
-            )("forEach"),
-            undefined,
-            [
-              ts.factory.createArrowFunction(
-                undefined,
-                undefined,
-                [IdentifierFactory.parameter("elem")],
-                undefined,
-                undefined,
-                append(key)(ts.factory.createIdentifier("elem")),
-              ),
-            ],
-          )
-        : append(key)(
-            IdentifierFactory.access(ts.factory.createIdentifier("input"))(key),
-          );
-
-  const append = (key: string) => (elem: ts.Expression) =>
-    ts.factory.createCallExpression(
-      IdentifierFactory.access(ts.factory.createIdentifier("output"))("append"),
-      undefined,
-      [ts.factory.createStringLiteral(key), elem],
-    );
-}
+import ts from "typescript";
+import { IdentifierFactory } from "typia/lib/factories/IdentifierFactory";
+import { MetadataCollection } from "typia/lib/factories/MetadataCollection";
+import { MetadataFactory } from "typia/lib/factories/MetadataFactory";
+import { StatementFactory } from "typia/lib/factories/StatementFactory";
+import { FunctionImporter } from "typia/lib/programmers/helpers/FunctionImporeter";
+import { HttpQueryProgrammer } from "typia/lib/programmers/http/HttpQueryProgrammer";
+import { Metadata } from "typia/lib/schemas/metadata/Metadata";
+import { MetadataObject } from "typia/lib/schemas/metadata/MetadataObject";
+import { IProject } from "typia/lib/transformers/IProject";
+import { TransformerError } from "typia/lib/transformers/TransformerError";
+
+export namespace HttpQuerifyProgrammer {
+  export const write =
+    (project: IProject) =>
+    (modulo: ts.LeftHandSideExpression) =>
+    (type: ts.Type): ts.ArrowFunction => {
+      // GET OBJECT TYPE
+      const importer: FunctionImporter = new FunctionImporter(modulo.getText());
+      const collection: MetadataCollection = new MetadataCollection();
+      const result = MetadataFactory.analyze(project.checker)({
+        escape: false,
+        constant: true,
+        absorb: true,
+        validate: HttpQueryProgrammer.validate,
+      })(collection)(type);
+      if (result.success === false)
+        throw TransformerError.from(
+          `nestia.core.TypedQuery.${importer.method}`,
+        )(result.errors);
+
+      const object: MetadataObject = result.data.objects[0]!;
+      return ts.factory.createArrowFunction(
+        undefined,
+        undefined,
+        [IdentifierFactory.parameter("input")],
+        undefined,
+        undefined,
+        ts.factory.createBlock(
+          [
+            ...importer.declare(modulo),
+            StatementFactory.constant(
+              "output",
+              ts.factory.createNewExpression(
+                ts.factory.createIdentifier("URLSearchParams"),
+                undefined,
+                [],
+              ),
+            ),
+            ...object.properties.map((p) =>
+              ts.factory.createExpressionStatement(
+                decode(p.key.constants[0]!.values[0].value as string)(p.value),
+              ),
+            ),
+            ts.factory.createReturnStatement(
+              ts.factory.createIdentifier("output"),
+            ),
+          ],
+          true,
+        ),
+      );
+    };
+
+  const decode =
+    (key: string) =>
+    (value: Metadata): ts.CallExpression =>
+      !!value.arrays.length
+        ? ts.factory.createCallExpression(
+            IdentifierFactory.access(
+              IdentifierFactory.access(ts.factory.createIdentifier("input"))(
+                key,
+              ),
+            )("forEach"),
+            undefined,
+            [
+              ts.factory.createArrowFunction(
+                undefined,
+                undefined,
+                [IdentifierFactory.parameter("elem")],
+                undefined,
+                undefined,
+                append(key)(ts.factory.createIdentifier("elem")),
+              ),
+            ],
+          )
+        : append(key)(
+            IdentifierFactory.access(ts.factory.createIdentifier("input"))(key),
+          );
+
+  const append = (key: string) => (elem: ts.Expression) =>
+    ts.factory.createCallExpression(
+      IdentifierFactory.access(ts.factory.createIdentifier("output"))("append"),
+      undefined,
+      [ts.factory.createStringLiteral(key), elem],
+    );
+}