@nestia/core 11.0.0-dev.20260313-5 → 11.0.0

package/src/programmers/TypedFormDataBodyProgrammer.ts

@@ -1,118 +1,118 @@
-import {
-  HttpAssertFormDataProgrammer,
-  HttpFormDataProgrammer,
-  HttpIsFormDataProgrammer,
-  HttpValidateFormDataProgrammer,
-  ITypiaContext,
-  LiteralFactory,
-  MetadataCollection,
-  MetadataFactory,
-  MetadataSchema,
-  TransformerError,
-} from "@typia/core";
-import ts from "typescript";
-
-import { INestiaTransformContext } from "../options/INestiaTransformProject";
-import { IRequestFormDataProps } from "../options/IRequestFormDataProps";
-
-export namespace TypedFormDataBodyProgrammer {
-  export const generate = (props: {
-    context: INestiaTransformContext;
-    modulo: ts.LeftHandSideExpression;
-    type: ts.Type;
-  }): ts.ObjectLiteralExpression => {
-    // VALIDATE TYPE
-    const storage: MetadataCollection = new MetadataCollection();
-    const result = MetadataFactory.analyze({
-      checker: props.context.checker,
-      transformer: props.context.transformer,
-      options: {
-        escape: false,
-        constant: true,
-        absorb: true,
-        validate: HttpFormDataProgrammer.validate,
-      },
-      type: props.type,
-      components: storage,
-    });
-    if (result.success === false)
-      throw TransformerError.from({
-        code: "nestia.core.TypedFormData.Body",
-        errors: result.errors,
-      });
-
-    const files: IRequestFormDataProps.IFile[] =
-      result.data.objects[0]!.type.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: (next: {
-          context: ITypiaContext;
-          modulo: ts.LeftHandSideExpression;
-          type: ts.Type;
-          name: string | undefined;
-        }) => ts.Expression,
-      ) =>
-        ts.factory.createObjectLiteralExpression(
-          [
-            ts.factory.createPropertyAssignment(
-              ts.factory.createIdentifier("files"),
-              LiteralFactory.write(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({
-                      context: {
-                        ...props.context,
-                        options: {
-                          numeric: false,
-                          finite: false,
-                          functional: false,
-                        },
-                      },
-                      modulo: props.modulo,
-                      type: props.type,
-                      name: undefined,
-                    }),
-                  ),
-                ],
-                true,
-              ),
-            ),
-          ],
-          true,
-        );
-
-    // RETURNS
-    const category = props.context.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: MetadataSchema) =>
-  meta.natives.some(({ name }) => name === "File" || name === "Blob");
+import {
+  HttpAssertFormDataProgrammer,
+  HttpFormDataProgrammer,
+  HttpIsFormDataProgrammer,
+  HttpValidateFormDataProgrammer,
+  ITypiaContext,
+  LiteralFactory,
+  MetadataCollection,
+  MetadataFactory,
+  MetadataSchema,
+  TransformerError,
+} from "@typia/core";
+import ts from "typescript";
+
+import { INestiaTransformContext } from "../options/INestiaTransformProject";
+import { IRequestFormDataProps } from "../options/IRequestFormDataProps";
+
+export namespace TypedFormDataBodyProgrammer {
+  export const generate = (props: {
+    context: INestiaTransformContext;
+    modulo: ts.LeftHandSideExpression;
+    type: ts.Type;
+  }): ts.ObjectLiteralExpression => {
+    // VALIDATE TYPE
+    const storage: MetadataCollection = new MetadataCollection();
+    const result = MetadataFactory.analyze({
+      checker: props.context.checker,
+      transformer: props.context.transformer,
+      options: {
+        escape: false,
+        constant: true,
+        absorb: true,
+        validate: HttpFormDataProgrammer.validate,
+      },
+      type: props.type,
+      components: storage,
+    });
+    if (result.success === false)
+      throw TransformerError.from({
+        code: "nestia.core.TypedFormData.Body",
+        errors: result.errors,
+      });
+
+    const files: IRequestFormDataProps.IFile[] =
+      result.data.objects[0]!.type.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: (next: {
+          context: ITypiaContext;
+          modulo: ts.LeftHandSideExpression;
+          type: ts.Type;
+          name: string | undefined;
+        }) => ts.Expression,
+      ) =>
+        ts.factory.createObjectLiteralExpression(
+          [
+            ts.factory.createPropertyAssignment(
+              ts.factory.createIdentifier("files"),
+              LiteralFactory.write(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({
+                      context: {
+                        ...props.context,
+                        options: {
+                          numeric: false,
+                          finite: false,
+                          functional: false,
+                        },
+                      },
+                      modulo: props.modulo,
+                      type: props.type,
+                      name: undefined,
+                    }),
+                  ),
+                ],
+                true,
+              ),
+            ),
+          ],
+          true,
+        );
+
+    // RETURNS
+    const category = props.context.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: MetadataSchema) =>
+  meta.natives.some(({ name }) => name === "File" || name === "Blob");

package/src/programmers/TypedHeadersProgrammer.ts

@@ -1,65 +1,65 @@
-import {
-  HttpAssertHeadersProgrammer,
-  HttpIsHeadersProgrammer,
-  HttpValidateHeadersProgrammer,
-  ITypiaContext,
-} from "@typia/core";
-import ts from "typescript";
-
-import { INestiaTransformContext } from "../options/INestiaTransformProject";
-import { IRequestHeadersValidator } from "../options/IRequestHeadersValidator";
-
-export namespace TypedHeadersProgrammer {
-  export const generate = (props: {
-    context: INestiaTransformContext;
-    modulo: ts.LeftHandSideExpression;
-    type: ts.Type;
-  }): ts.Expression => {
-    // GENERATE VALIDATION PLAN
-    const parameter =
-      (key: IRequestHeadersValidator<any>["type"]) =>
-      (
-        programmer: (next: {
-          context: ITypiaContext;
-          modulo: ts.LeftHandSideExpression;
-          type: ts.Type;
-          name: string | undefined;
-        }) => ts.Expression,
-      ) =>
-        ts.factory.createObjectLiteralExpression([
-          ts.factory.createPropertyAssignment(
-            ts.factory.createIdentifier("type"),
-            ts.factory.createStringLiteral(key),
-          ),
-          ts.factory.createPropertyAssignment(
-            ts.factory.createIdentifier(key),
-            programmer({
-              context: {
-                ...props.context,
-                options: {
-                  numeric: false,
-                  finite: false,
-                  functional: false,
-                },
-              },
-              modulo: props.modulo,
-              type: props.type,
-              name: undefined,
-            }),
-          ),
-        ]);
-
-    // RETURNS
-    const category = props.context.options.validate;
-    if (category === "is" || category === "equals")
-      return parameter("is")(HttpIsHeadersProgrammer.write);
-    else if (
-      category === "validate" ||
-      category === "validateEquals" ||
-      category === "validateClone" ||
-      category === "validatePrune"
-    )
-      return parameter("validate")(HttpValidateHeadersProgrammer.write);
-    return parameter("assert")(HttpAssertHeadersProgrammer.write);
-  };
-}
+import {
+  HttpAssertHeadersProgrammer,
+  HttpIsHeadersProgrammer,
+  HttpValidateHeadersProgrammer,
+  ITypiaContext,
+} from "@typia/core";
+import ts from "typescript";
+
+import { INestiaTransformContext } from "../options/INestiaTransformProject";
+import { IRequestHeadersValidator } from "../options/IRequestHeadersValidator";
+
+export namespace TypedHeadersProgrammer {
+  export const generate = (props: {
+    context: INestiaTransformContext;
+    modulo: ts.LeftHandSideExpression;
+    type: ts.Type;
+  }): ts.Expression => {
+    // GENERATE VALIDATION PLAN
+    const parameter =
+      (key: IRequestHeadersValidator<any>["type"]) =>
+      (
+        programmer: (next: {
+          context: ITypiaContext;
+          modulo: ts.LeftHandSideExpression;
+          type: ts.Type;
+          name: string | undefined;
+        }) => ts.Expression,
+      ) =>
+        ts.factory.createObjectLiteralExpression([
+          ts.factory.createPropertyAssignment(
+            ts.factory.createIdentifier("type"),
+            ts.factory.createStringLiteral(key),
+          ),
+          ts.factory.createPropertyAssignment(
+            ts.factory.createIdentifier(key),
+            programmer({
+              context: {
+                ...props.context,
+                options: {
+                  numeric: false,
+                  finite: false,
+                  functional: false,
+                },
+              },
+              modulo: props.modulo,
+              type: props.type,
+              name: undefined,
+            }),
+          ),
+        ]);
+
+    // RETURNS
+    const category = props.context.options.validate;
+    if (category === "is" || category === "equals")
+      return parameter("is")(HttpIsHeadersProgrammer.write);
+    else if (
+      category === "validate" ||
+      category === "validateEquals" ||
+      category === "validateClone" ||
+      category === "validatePrune"
+    )
+      return parameter("validate")(HttpValidateHeadersProgrammer.write);
+    return parameter("assert")(HttpAssertHeadersProgrammer.write);
+  };
+}

package/src/programmers/TypedParamProgrammer.ts

@@ -1,33 +1,33 @@
-import { HttpParameterProgrammer } from "@typia/core";
-import ts from "typescript";
-
-import { INestiaTransformContext } from "../options/INestiaTransformProject";
-
-export namespace TypedParamProgrammer {
-  export const generate = (props: {
-    context: INestiaTransformContext;
-    modulo: ts.LeftHandSideExpression;
-    arguments: readonly ts.Expression[];
-    type: ts.Type;
-  }): readonly ts.Expression[] => {
-    // ALREADY BEING TRANSFORMED
-    if (props.arguments.length !== 1) return props.arguments;
-    return [
-      props.arguments[0]!,
-      HttpParameterProgrammer.write({
-        context: {
-          ...props.context,
-          options: {
-            numeric: true,
-          },
-        },
-        modulo: props.modulo,
-        type: props.type,
-        name: undefined,
-      }),
-      ...(props.context.options?.validate?.startsWith("validate")
-        ? [ts.factory.createTrue()]
-        : []),
-    ];
-  };
-}
+import { HttpParameterProgrammer } from "@typia/core";
+import ts from "typescript";
+
+import { INestiaTransformContext } from "../options/INestiaTransformProject";
+
+export namespace TypedParamProgrammer {
+  export const generate = (props: {
+    context: INestiaTransformContext;
+    modulo: ts.LeftHandSideExpression;
+    arguments: readonly ts.Expression[];
+    type: ts.Type;
+  }): readonly ts.Expression[] => {
+    // ALREADY BEING TRANSFORMED
+    if (props.arguments.length !== 1) return props.arguments;
+    return [
+      props.arguments[0]!,
+      HttpParameterProgrammer.write({
+        context: {
+          ...props.context,
+          options: {
+            numeric: true,
+          },
+        },
+        modulo: props.modulo,
+        type: props.type,
+        name: undefined,
+      }),
+      ...(props.context.options?.validate?.startsWith("validate")
+        ? [ts.factory.createTrue()]
+        : []),
+    ];
+  };
+}

package/src/programmers/TypedQueryBodyProgrammer.ts

@@ -1,111 +1,113 @@
-import {
-  HttpAssertQueryProgrammer,
-  HttpIsQueryProgrammer,
-  HttpQueryProgrammer,
-  HttpValidateQueryProgrammer,
-  ITypiaContext,
-  LlmSchemaProgrammer,
-  MetadataCollection,
-  MetadataFactory,
-  MetadataSchema,
-  TransformerError,
-} from "@typia/core";
-import { ValidationPipe } from "@typia/interface";
-import ts from "typescript";
-
-import { INestiaTransformOptions } from "../options/INestiaTransformOptions";
-import { INestiaTransformContext } from "../options/INestiaTransformProject";
-import { IRequestQueryValidator } from "../options/IRequestQueryValidator";
-
-export namespace TypedQueryBodyProgrammer {
-  export const generate = (props: {
-    context: INestiaTransformContext;
-    modulo: ts.LeftHandSideExpression;
-    type: ts.Type;
-  }): ts.ObjectLiteralExpression => {
-    // VALIDATE TYPE
-    if (props.context.options.llm) {
-      const llm: INestiaTransformOptions.ILlm = props.context.options.llm;
-      const result: ValidationPipe<MetadataSchema, MetadataFactory.IError> =
-        MetadataFactory.analyze({
-          checker: props.context.checker,
-          transformer: props.context.transformer,
-          options: {
-            escape: false,
-            constant: true,
-            absorb: true,
-            validate: (meta, explore) => {
-              const errors: string[] = HttpQueryProgrammer.validate(
-                meta,
-                explore,
-                true,
-              );
-              errors.push(
-                ...LlmSchemaProgrammer.validate({
-                  config: {
-                    strict: llm.strict ?? false,
-                  },
-                  metadata: meta,
-                }),
-              );
-              return errors;
-            },
-          },
-          components: new MetadataCollection(),
-          type: props.type,
-        });
-      if (result.success === false)
-        throw TransformerError.from({
-          code: props.modulo.getText(),
-          errors: result.errors,
-        });
-    }
-
-    // GENERATE VALIDATION PLAN
-    const parameter =
-      (key: IRequestQueryValidator<any>["type"]) =>
-      (
-        programmer: (next: {
-          context: ITypiaContext;
-          modulo: ts.LeftHandSideExpression;
-          type: ts.Type;
-          name: string | undefined;
-        }) => ts.Expression,
-      ) =>
-        ts.factory.createObjectLiteralExpression([
-          ts.factory.createPropertyAssignment(
-            ts.factory.createIdentifier("type"),
-            ts.factory.createStringLiteral(key),
-          ),
-          ts.factory.createPropertyAssignment(
-            ts.factory.createIdentifier(key),
-            programmer({
-              context: {
-                ...props.context,
-                options: {
-                  numeric: false,
-                  finite: false,
-                  functional: false,
-                },
-              },
-              modulo: props.modulo,
-              type: props.type,
-              name: undefined,
-            }),
-          ),
-        ]);
-
-    // RETURNS
-    const category = props.context.options.validate;
-    if (category === "is" || category === "equals")
-      return parameter("is")(HttpIsQueryProgrammer.write);
-    else if (
-      category === "validate" ||
-      category === "validateEquals" ||
-      category === "validateClone" ||
-      category === "validatePrune"
-    )
-      return parameter("validate")(HttpValidateQueryProgrammer.write);
-    return parameter("assert")(HttpAssertQueryProgrammer.write);
-  };
-}
+import {
+  HttpAssertQueryProgrammer,
+  HttpIsQueryProgrammer,
+  HttpQueryProgrammer,
+  HttpValidateQueryProgrammer,
+  ITypiaContext,
+  LlmSchemaProgrammer,
+  MetadataCollection,
+  MetadataFactory,
+  MetadataSchema,
+  TransformerError,
+} from "@typia/core";
+import { ValidationPipe } from "@typia/interface";
+import ts from "typescript";
+
+import { INestiaTransformOptions } from "../options/INestiaTransformOptions";
+import { INestiaTransformContext } from "../options/INestiaTransformProject";
+import { IRequestQueryValidator } from "../options/IRequestQueryValidator";
+
+export namespace TypedQueryBodyProgrammer {
+  export const generate = (props: {
+    context: INestiaTransformContext;
+    modulo: ts.LeftHandSideExpression;
+    type: ts.Type;
+  }): ts.ObjectLiteralExpression => {
+    // VALIDATE TYPE
+    if (props.context.options.llm) {
+      const llm: INestiaTransformOptions.ILlm | true =
+        props.context.options.llm;
+      const result: ValidationPipe<MetadataSchema, MetadataFactory.IError> =
+        MetadataFactory.analyze({
+          checker: props.context.checker,
+          transformer: props.context.transformer,
+          options: {
+            escape: false,
+            constant: true,
+            absorb: true,
+            validate: (next) => {
+              const errors: string[] = HttpQueryProgrammer.validate({
+                metadata: next.metadata,
+                explore: next.explore,
+                allowOptional: true,
+              });
+              errors.push(
+                ...LlmSchemaProgrammer.validate({
+                  config: {
+                    strict: llm === true ? false : (llm.strict ?? false),
+                  },
+                  metadata: next.metadata,
+                  explore: next.explore,
+                }),
+              );
+              return errors;
+            },
+          },
+          components: new MetadataCollection(),
+          type: props.type,
+        });
+      if (result.success === false)
+        throw TransformerError.from({
+          code: props.modulo.getText(),
+          errors: result.errors,
+        });
+    }
+
+    // GENERATE VALIDATION PLAN
+    const parameter =
+      (key: IRequestQueryValidator<any>["type"]) =>
+      (
+        programmer: (next: {
+          context: ITypiaContext;
+          modulo: ts.LeftHandSideExpression;
+          type: ts.Type;
+          name: string | undefined;
+        }) => ts.Expression,
+      ) =>
+        ts.factory.createObjectLiteralExpression([
+          ts.factory.createPropertyAssignment(
+            ts.factory.createIdentifier("type"),
+            ts.factory.createStringLiteral(key),
+          ),
+          ts.factory.createPropertyAssignment(
+            ts.factory.createIdentifier(key),
+            programmer({
+              context: {
+                ...props.context,
+                options: {
+                  numeric: false,
+                  finite: false,
+                  functional: false,
+                },
+              },
+              modulo: props.modulo,
+              type: props.type,
+              name: undefined,
+            }),
+          ),
+        ]);
+
+    // RETURNS
+    const category = props.context.options.validate;
+    if (category === "is" || category === "equals")
+      return parameter("is")(HttpIsQueryProgrammer.write);
+    else if (
+      category === "validate" ||
+      category === "validateEquals" ||
+      category === "validateClone" ||
+      category === "validatePrune"
+    )
+      return parameter("validate")(HttpValidateQueryProgrammer.write);
+    return parameter("assert")(HttpAssertQueryProgrammer.write);
+  };
+}