@nestia/core 4.4.0 → 4.4.1-dev.20241216

package/src/decorators/internal/validate_request_query.ts

@@ -1,74 +1,74 @@
-import { BadRequestException } from "@nestjs/common";
-import typia, { IValidation, TypeGuardError } from "typia";
-
-import { IRequestQueryValidator } from "../../options/IRequestQueryValidator";
-import { NoTransformConfigurationError } from "../NoTransformConfigurationError";
-
-/**
- * @internal
- */
-export const validate_request_query =
-  (method: string) =>
-  <T>(validator?: IRequestQueryValidator<T>) => {
-    if (!validator) {
-      NoTransformConfigurationError(method);
-      return (input: URLSearchParams) =>
-        Object.fromEntries(input.entries()) as T;
-    } 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.";
+import { BadRequestException } from "@nestjs/common";
+import typia, { IValidation, TypeGuardError } from "typia";
+
+import { IRequestQueryValidator } from "../../options/IRequestQueryValidator";
+import { NoTransformConfigurationError } from "../NoTransformConfigurationError";
+
+/**
+ * @internal
+ */
+export const validate_request_query =
+  (method: string) =>
+  <T>(validator?: IRequestQueryValidator<T>) => {
+    if (!validator) {
+      NoTransformConfigurationError(method);
+      return (input: URLSearchParams) =>
+        Object.fromEntries(input.entries()) as T;
+    } 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/index.ts

@@ -1,5 +1,5 @@
-import * as core from "./module";
-
-export * from "./module";
-
-export default core;
+import * as core from "./module";
+
+export * from "./module";
+
+export default core;

package/src/module.ts

@@ -1,21 +1,21 @@
-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 "./decorators/SwaggerExample";
-
-export * from "./adaptors/WebSocketAdaptor";
-export * from "./decorators/WebSocketRoute";
+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 "./decorators/SwaggerExample";
+
+export * from "./adaptors/WebSocketAdaptor";
+export * from "./decorators/WebSocketRoute";

package/src/options/INestiaTransformOptions.ts

@@ -1,29 +1,38 @@
-export interface INestiaTransformOptions {
-  validate?: INestiaTransformOptions.Validate;
-  stringify?: INestiaTransformOptions.Stringify | null;
-  throws?: boolean;
-}
-export namespace INestiaTransformOptions {
-  export type Validate =
-    // NORMAL
-    | "assert"
-    | "is"
-    | "validate"
-    // STRICT
-    | "assertEquals"
-    | "equals"
-    | "validateEquals"
-    // CLONE
-    | "assertClone"
-    | "validateClone"
-    // PRUNE
-    | "assertPrune"
-    | "validatePrune";
-
-  export type Stringify =
-    | "stringify"
-    | "assert"
-    | "is"
-    | "validate"
-    | "validate.log";
-}
+import { ILlmSchema } from "@samchon/openapi";
+
+export interface INestiaTransformOptions {
+  validate?: INestiaTransformOptions.Validate;
+  stringify?: INestiaTransformOptions.Stringify | null;
+  llm?: INestiaTransformOptions.ILlm<"chatgpt" | "gemini" | "3.0">;
+  throws?: boolean;
+}
+export namespace INestiaTransformOptions {
+  export type Validate =
+    // NORMAL
+    | "assert"
+    | "is"
+    | "validate"
+    // STRICT
+    | "assertEquals"
+    | "equals"
+    | "validateEquals"
+    // CLONE
+    | "assertClone"
+    | "validateClone"
+    // PRUNE
+    | "assertPrune"
+    | "validatePrune";
+
+  export type Stringify =
+    | "stringify"
+    | "assert"
+    | "is"
+    | "validate"
+    | "validate.log";
+
+  export interface ILlm<Model extends ILlmSchema.Model> {
+    model: Model;
+    strict?: Model extends "chatgpt" ? boolean : never;
+    recursive?: Model extends "gemini" | "3.0" ? false | number : never;
+  }
+}

package/src/options/INestiaTransformProject.ts

@@ -1,8 +1,8 @@
-import { ITypiaContext } from "typia/lib/transformers/ITypiaContext";
-
-import { INestiaTransformOptions } from "./INestiaTransformOptions";
-
-export interface INestiaTransformContext
-  extends Omit<ITypiaContext, "options"> {
-  options: INestiaTransformOptions;
-}
+import { ITypiaContext } from "typia/lib/transformers/ITypiaContext";
+
+import { INestiaTransformOptions } from "./INestiaTransformOptions";
+
+export interface INestiaTransformContext
+  extends Omit<ITypiaContext, "options"> {
+  options: INestiaTransformOptions;
+}

package/src/options/IRequestBodyValidator.ts

@@ -1,20 +1,20 @@
-import { IValidation } from "typia";
-
-export type IRequestBodyValidator<T> =
-  | IRequestBodyValidator.IAssert<T>
-  | IRequestBodyValidator.IIs<T>
-  | IRequestBodyValidator.IValidate<T>;
-export namespace IRequestBodyValidator {
-  export interface IAssert<T> {
-    type: "assert";
-    assert: (input: T) => T;
-  }
-  export interface IIs<T> {
-    type: "is";
-    is: (input: T) => boolean;
-  }
-  export interface IValidate<T> {
-    type: "validate";
-    validate: (input: T) => IValidation<T>;
-  }
-}
+import { IValidation } from "typia";
+
+export type IRequestBodyValidator<T> =
+  | IRequestBodyValidator.IAssert<T>
+  | IRequestBodyValidator.IIs<T>
+  | IRequestBodyValidator.IValidate<T>;
+export namespace IRequestBodyValidator {
+  export interface IAssert<T> {
+    type: "assert";
+    assert: (input: T) => T;
+  }
+  export interface IIs<T> {
+    type: "is";
+    is: (input: T) => boolean;
+  }
+  export interface IValidate<T> {
+    type: "validate";
+    validate: (input: T) => IValidation<T>;
+  }
+}

package/src/options/IRequestFormDataProps.ts

@@ -1,27 +1,27 @@
-import { IValidation } from "typia";
-
-export interface IRequestFormDataProps<T> {
-  files: Array<IRequestFormDataProps.IFile>;
-  validator:
-    | IRequestFormDataProps.IAssert<T>
-    | IRequestFormDataProps.IIs<T>
-    | IRequestFormDataProps.IValidate<T>;
-}
-export namespace IRequestFormDataProps {
-  export interface IAssert<T> {
-    type: "assert";
-    assert: (input: FormData) => T;
-  }
-  export interface IIs<T> {
-    type: "is";
-    is: (input: FormData) => T | null;
-  }
-  export interface IValidate<T> {
-    type: "validate";
-    validate: (input: FormData) => IValidation<T>;
-  }
-  export interface IFile {
-    name: string;
-    limit: number | null;
-  }
-}
+import { IValidation } from "typia";
+
+export interface IRequestFormDataProps<T> {
+  files: Array<IRequestFormDataProps.IFile>;
+  validator:
+    | IRequestFormDataProps.IAssert<T>
+    | IRequestFormDataProps.IIs<T>
+    | IRequestFormDataProps.IValidate<T>;
+}
+export namespace IRequestFormDataProps {
+  export interface IAssert<T> {
+    type: "assert";
+    assert: (input: FormData) => T;
+  }
+  export interface IIs<T> {
+    type: "is";
+    is: (input: FormData) => T | null;
+  }
+  export interface IValidate<T> {
+    type: "validate";
+    validate: (input: FormData) => IValidation<T>;
+  }
+  export interface IFile {
+    name: string;
+    limit: number | null;
+  }
+}

package/src/options/IRequestHeadersValidator.ts

@@ -1,22 +1,22 @@
-import { IValidation } from "typia";
-
-export type IRequestHeadersValidator<T> =
-  | IRequestHeadersValidator.IAssert<T>
-  | IRequestHeadersValidator.IIs<T>
-  | IRequestHeadersValidator.IValidate<T>;
-export namespace IRequestHeadersValidator {
-  export interface IAssert<T> {
-    type: "assert";
-    assert: (input: Record<string, string | string[] | undefined>) => T;
-  }
-  export interface IIs<T> {
-    type: "is";
-    is: (input: Record<string, string | string[] | undefined>) => T | null;
-  }
-  export interface IValidate<T> {
-    type: "validate";
-    validate: (
-      input: Record<string, string | string[] | undefined>,
-    ) => IValidation<T>;
-  }
-}
+import { IValidation } from "typia";
+
+export type IRequestHeadersValidator<T> =
+  | IRequestHeadersValidator.IAssert<T>
+  | IRequestHeadersValidator.IIs<T>
+  | IRequestHeadersValidator.IValidate<T>;
+export namespace IRequestHeadersValidator {
+  export interface IAssert<T> {
+    type: "assert";
+    assert: (input: Record<string, string | string[] | undefined>) => T;
+  }
+  export interface IIs<T> {
+    type: "is";
+    is: (input: Record<string, string | string[] | undefined>) => T | null;
+  }
+  export interface IValidate<T> {
+    type: "validate";
+    validate: (
+      input: Record<string, string | string[] | undefined>,
+    ) => IValidation<T>;
+  }
+}

package/src/options/IRequestQueryValidator.ts

@@ -1,20 +1,20 @@
-import { IValidation } from "typia";
-
-export type IRequestQueryValidator<T> =
-  | IRequestQueryValidator.IAssert<T>
-  | IRequestQueryValidator.IIs<T>
-  | IRequestQueryValidator.IValidate<T>;
-export namespace IRequestQueryValidator {
-  export interface IAssert<T> {
-    type: "assert";
-    assert: (input: URLSearchParams) => T;
-  }
-  export interface IIs<T> {
-    type: "is";
-    is: (input: URLSearchParams) => T | null;
-  }
-  export interface IValidate<T> {
-    type: "validate";
-    validate: (input: URLSearchParams) => IValidation<T>;
-  }
-}
+import { IValidation } from "typia";
+
+export type IRequestQueryValidator<T> =
+  | IRequestQueryValidator.IAssert<T>
+  | IRequestQueryValidator.IIs<T>
+  | IRequestQueryValidator.IValidate<T>;
+export namespace IRequestQueryValidator {
+  export interface IAssert<T> {
+    type: "assert";
+    assert: (input: URLSearchParams) => T;
+  }
+  export interface IIs<T> {
+    type: "is";
+    is: (input: URLSearchParams) => T | null;
+  }
+  export interface IValidate<T> {
+    type: "validate";
+    validate: (input: URLSearchParams) => IValidation<T>;
+  }
+}

package/src/options/IResponseBodyQuerifier.ts

@@ -1,25 +1,25 @@
-import { IValidation } from "typia";
-
-export type IResponseBodyQuerifier<T> =
-  | IResponseBodyquerifier.IStringify<T>
-  | IResponseBodyquerifier.IIs<T>
-  | IResponseBodyquerifier.IAssert<T>
-  | IResponseBodyquerifier.IValidate<T>;
-export namespace IResponseBodyquerifier {
-  export interface IStringify<T> {
-    type: "stringify";
-    stringify: (input: T) => URLSearchParams;
-  }
-  export interface IIs<T> {
-    type: "is";
-    is: (input: T) => URLSearchParams | null;
-  }
-  export interface IAssert<T> {
-    type: "assert";
-    assert: (input: T) => URLSearchParams;
-  }
-  export interface IValidate<T> {
-    type: "validate";
-    validate: (input: T) => IValidation<URLSearchParams>;
-  }
-}
+import { IValidation } from "typia";
+
+export type IResponseBodyQuerifier<T> =
+  | IResponseBodyquerifier.IStringify<T>
+  | IResponseBodyquerifier.IIs<T>
+  | IResponseBodyquerifier.IAssert<T>
+  | IResponseBodyquerifier.IValidate<T>;
+export namespace IResponseBodyquerifier {
+  export interface IStringify<T> {
+    type: "stringify";
+    stringify: (input: T) => URLSearchParams;
+  }
+  export interface IIs<T> {
+    type: "is";
+    is: (input: T) => URLSearchParams | null;
+  }
+  export interface IAssert<T> {
+    type: "assert";
+    assert: (input: T) => URLSearchParams;
+  }
+  export interface IValidate<T> {
+    type: "validate";
+    validate: (input: T) => IValidation<URLSearchParams>;
+  }
+}

package/src/options/IResponseBodyStringifier.ts

@@ -1,30 +1,30 @@
-import { IValidation } from "typia";
-
-export type IResponseBodyStringifier<T> =
-  | IResponseBodyStringifier.IStringify<T>
-  | IResponseBodyStringifier.IIs<T>
-  | IResponseBodyStringifier.IAssert<T>
-  | IResponseBodyStringifier.IValidate<T>
-  | IResponseBodyStringifier.IValidateLog<T>;
-export namespace IResponseBodyStringifier {
-  export interface IStringify<T> {
-    type: "stringify";
-    stringify: (input: T) => string;
-  }
-  export interface IIs<T> {
-    type: "is";
-    is: (input: T) => string | null;
-  }
-  export interface IAssert<T> {
-    type: "assert";
-    assert: (input: T) => string;
-  }
-  export interface IValidate<T> {
-    type: "validate";
-    validate: (input: T) => IValidation<string>;
-  }
-  export interface IValidateLog<T> {
-    type: "validate.log";
-    validate: (input: T) => IValidation<string>;
-  }
-}
+import { IValidation } from "typia";
+
+export type IResponseBodyStringifier<T> =
+  | IResponseBodyStringifier.IStringify<T>
+  | IResponseBodyStringifier.IIs<T>
+  | IResponseBodyStringifier.IAssert<T>
+  | IResponseBodyStringifier.IValidate<T>
+  | IResponseBodyStringifier.IValidateLog<T>;
+export namespace IResponseBodyStringifier {
+  export interface IStringify<T> {
+    type: "stringify";
+    stringify: (input: T) => string;
+  }
+  export interface IIs<T> {
+    type: "is";
+    is: (input: T) => string | null;
+  }
+  export interface IAssert<T> {
+    type: "assert";
+    assert: (input: T) => string;
+  }
+  export interface IValidate<T> {
+    type: "validate";
+    validate: (input: T) => IValidation<string>;
+  }
+  export interface IValidateLog<T> {
+    type: "validate.log";
+    validate: (input: T) => IValidation<string>;
+  }
+}