@typia/core 12.0.0-dev.20260225

package/src/programmers/http/HttpFormDataProgrammer.ts

@@ -0,0 +1,304 @@
+import { Atomic } from "@typia/interface";
+import { NamingConvention } from "@typia/utils";
+import ts from "typescript";
+
+import { IProgrammerProps } from "../../context/IProgrammerProps";
+import { ITypiaContext } from "../../context/ITypiaContext";
+import { TransformerError } from "../../context/TransformerError";
+import { IdentifierFactory } from "../../factories/IdentifierFactory";
+import { MetadataFactory } from "../../factories/MetadataFactory";
+import { StatementFactory } from "../../factories/StatementFactory";
+import { TypeFactory } from "../../factories/TypeFactory";
+import { MetadataArrayType } from "../../schemas/metadata/MetadataArrayType";
+import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
+import { MetadataProperty } from "../../schemas/metadata/MetadataProperty";
+import { MetadataSchema } from "../../schemas/metadata/MetadataSchema";
+import { MetadataStorage } from "../../schemas/metadata/MetadataStorage";
+import { FunctionProgrammer } from "../helpers/FunctionProgrammer";
+import { HttpMetadataUtil } from "../helpers/HttpMetadataUtil";
+import { FeatureProgrammer } from "../internal/FeatureProgrammer";
+
+export namespace HttpFormDataProgrammer {
+  export const decompose = (props: {
+    context: ITypiaContext;
+    functor: FunctionProgrammer;
+    type: ts.Type;
+    name: string | undefined;
+  }): FeatureProgrammer.IDecomposed => {
+    // ANALYZE TYPE
+    const collection: MetadataStorage = new MetadataStorage();
+    const result = MetadataFactory.analyze({
+      checker: props.context.checker,
+      transformer: props.context.transformer,
+      options: {
+        escape: false,
+        constant: true,
+        absorb: true,
+        validate,
+      },
+      components: collection,
+      type: props.type,
+    });
+    if (result.success === false)
+      throw TransformerError.from({
+        code: props.functor.method,
+        errors: result.errors,
+      });
+
+    // DO TRANSFORM
+    const object: MetadataObjectType = result.data.objects[0]!.type;
+    const statements: ts.Statement[] = decode_object({
+      context: props.context,
+      object,
+    });
+    return {
+      functions: {},
+      statements: [],
+      arrow: ts.factory.createArrowFunction(
+        undefined,
+        undefined,
+        [
+          IdentifierFactory.parameter(
+            "input",
+            ts.factory.createTypeReferenceNode("FormData"),
+          ),
+        ],
+        props.context.importer.type({
+          file: "typia",
+          name: "Resolved",
+          arguments: [
+            ts.factory.createTypeReferenceNode(
+              props.name ??
+                TypeFactory.getFullName({
+                  checker: props.context.checker,
+                  type: props.type,
+                }),
+            ),
+          ],
+        }),
+        undefined,
+        ts.factory.createBlock(statements, true),
+      ),
+    };
+  };
+
+  export const write = (props: IProgrammerProps): ts.CallExpression => {
+    const functor: FunctionProgrammer = new FunctionProgrammer(
+      props.modulo.getText(),
+    );
+    const result: FeatureProgrammer.IDecomposed = decompose({
+      ...props,
+      functor,
+    });
+    return FeatureProgrammer.writeDecomposed({
+      modulo: props.modulo,
+      functor,
+      result,
+    });
+  };
+
+  export const validate = (
+    meta: MetadataSchema,
+    explore: MetadataFactory.IExplore,
+  ): string[] => {
+    const errors: string[] = [];
+    const insert = (msg: string) => errors.push(msg);
+
+    if (explore.top === true) {
+      // TOP MUST BE ONLY OBJECT
+      if (meta.objects.length !== 1 || meta.bucket() !== 1)
+        insert("only one object type is allowed.");
+      if (meta.nullable === true) insert("formdata parameters cannot be null.");
+      if (meta.isRequired() === false)
+        insert("formdata parameters cannot be undefined.");
+    } else if (
+      explore.nested !== null &&
+      explore.nested instanceof MetadataArrayType
+    ) {
+      //----
+      // ARRAY
+      //----
+      const atomics = HttpMetadataUtil.atomics(meta);
+      const expected: number =
+        meta.atomics.length +
+        meta.templates.length +
+        meta.constants.map((c) => c.values.length).reduce((a, b) => a + b, 0) +
+        meta.natives.filter(
+          (native) => native.name === "Blob" || native.name === "File",
+        ).length;
+      if (atomics.size > 1) insert("union type is not allowed in array.");
+      if (meta.size() !== expected)
+        insert(
+          "only atomic, constant or blob (file) types are allowed in array.",
+        );
+    } else if (explore.object && explore.property !== null) {
+      //----
+      // COMMON
+      //----
+      // PROPERTY MUST BE SOLE
+      if (typeof explore.property === "object")
+        insert("dynamic property is not allowed.");
+      // DO NOT ALLOW TUPLE TYPE
+      if (meta.tuples.length) insert("tuple type is not allowed.");
+      // DO NOT ALLOW UNION TYPE
+      if (HttpMetadataUtil.isUnion(meta)) insert("union type is not allowed.");
+      // DO NOT ALLOW NESTED OBJECT
+      if (
+        meta.objects.length ||
+        meta.sets.length ||
+        meta.maps.length ||
+        meta.natives.filter(
+          (native) => native.name !== "Blob" && native.name !== "File",
+        ).length
+      )
+        insert("nested object type is not allowed.");
+    }
+    return errors;
+  };
+
+  const decode_object = (props: {
+    context: ITypiaContext;
+    object: MetadataObjectType;
+  }): ts.Statement[] => {
+    // const input: ts.Identifier = ts.factory.createIdentifier("input");
+    const output: ts.Identifier = ts.factory.createIdentifier("output");
+    return [
+      StatementFactory.constant({
+        name: "output",
+        value: ts.factory.createObjectLiteralExpression(
+          props.object.properties.map((p) =>
+            decode_regular_property({
+              context: props.context,
+              property: p,
+            }),
+          ),
+          true,
+        ),
+      }),
+      ts.factory.createReturnStatement(
+        ts.factory.createAsExpression(output, TypeFactory.keyword("any")),
+      ),
+    ];
+  };
+
+  const decode_regular_property = (props: {
+    context: ITypiaContext;
+    property: MetadataProperty;
+  }): ts.PropertyAssignment => {
+    const key: string = props.property.key.constants[0]!.values[0]!
+      .value as string;
+    const value: MetadataSchema = props.property.value;
+
+    const [type, isArray]: [Atomic.Literal | "blob" | "file", boolean] = value
+      .atomics.length
+      ? [value.atomics[0]!.type, false]
+      : value.constants.length
+        ? [value.constants[0]!.type, false]
+        : value.templates.length
+          ? ["string", false]
+          : value.natives.some((native) => native.name === "Blob")
+            ? ["blob", false]
+            : value.natives.some((native) => native.name === "File")
+              ? ["file", false]
+              : (() => {
+                  const meta =
+                    value.arrays[0]?.type.value ??
+                    value.tuples[0]!.type.elements[0]!;
+                  return meta.atomics.length
+                    ? [meta.atomics[0]!.type, true]
+                    : meta.templates.length
+                      ? ["string", true]
+                      : meta.natives.some((native) => native.name === "Blob")
+                        ? ["blob", true]
+                        : meta.natives.some((native) => native.name === "File")
+                          ? ["file", true]
+                          : [meta.constants[0]!.type, true];
+                })();
+    return ts.factory.createPropertyAssignment(
+      NamingConvention.variable(key)
+        ? key
+        : ts.factory.createStringLiteral(key),
+      isArray
+        ? decode_array({
+            context: props.context,
+            metadata: value,
+            input: ts.factory.createCallExpression(
+              IdentifierFactory.access(
+                ts.factory.createCallExpression(
+                  ts.factory.createIdentifier("input.getAll"),
+                  undefined,
+                  [ts.factory.createStringLiteral(key)],
+                ),
+                "map",
+              ),
+              undefined,
+              [
+                ts.factory.createArrowFunction(
+                  undefined,
+                  undefined,
+                  [IdentifierFactory.parameter("elem")],
+                  undefined,
+                  undefined,
+                  decode_value({
+                    context: props.context,
+                    type,
+                    coalesce: false,
+                    input: ts.factory.createIdentifier("elem"),
+                  }),
+                ),
+              ],
+            ),
+          })
+        : decode_value({
+            context: props.context,
+            type,
+            coalesce: value.nullable === false && value.isRequired() === false,
+            input: ts.factory.createCallExpression(
+              ts.factory.createIdentifier("input.get"),
+              undefined,
+              [ts.factory.createStringLiteral(key)],
+            ),
+          }),
+    );
+  };
+
+  const decode_value = (props: {
+    context: ITypiaContext;
+    type: Atomic.Literal | "blob" | "file";
+    coalesce: boolean;
+    input: ts.Expression;
+  }) => {
+    const call = ts.factory.createCallExpression(
+      props.context.importer.internal(
+        `httpFormDataRead${NamingConvention.capitalize(props.type)}`,
+      ),
+      undefined,
+      [props.input],
+    );
+    return props.coalesce
+      ? ts.factory.createBinaryExpression(
+          call,
+          ts.factory.createToken(ts.SyntaxKind.QuestionQuestionToken),
+          ts.factory.createIdentifier("undefined"),
+        )
+      : call;
+  };
+
+  const decode_array = (props: {
+    context: ITypiaContext;
+    metadata: MetadataSchema;
+    input: ts.Expression;
+  }): ts.Expression =>
+    props.metadata.nullable || props.metadata.isRequired() === false
+      ? ts.factory.createCallExpression(
+          props.context.importer.internal("httpFormDataReadArray"),
+          undefined,
+          [
+            props.input,
+            props.metadata.nullable
+              ? ts.factory.createNull()
+              : ts.factory.createIdentifier("undefined"),
+          ],
+        )
+      : props.input;
+}

package/src/programmers/http/HttpHeadersProgrammer.ts

@@ -0,0 +1,395 @@
+import { Atomic } from "@typia/interface";
+import { MapUtil, NamingConvention } from "@typia/utils";
+import ts from "typescript";
+
+import { IProgrammerProps } from "../../context/IProgrammerProps";
+import { ITypiaContext } from "../../context/ITypiaContext";
+import { TransformerError } from "../../context/TransformerError";
+import { ExpressionFactory } from "../../factories/ExpressionFactory";
+import { IdentifierFactory } from "../../factories/IdentifierFactory";
+import { MetadataFactory } from "../../factories/MetadataFactory";
+import { StatementFactory } from "../../factories/StatementFactory";
+import { TypeFactory } from "../../factories/TypeFactory";
+import { MetadataArrayType } from "../../schemas/metadata/MetadataArrayType";
+import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
+import { MetadataProperty } from "../../schemas/metadata/MetadataProperty";
+import { MetadataSchema } from "../../schemas/metadata/MetadataSchema";
+import { MetadataStorage } from "../../schemas/metadata/MetadataStorage";
+import { FunctionProgrammer } from "../helpers/FunctionProgrammer";
+import { HttpMetadataUtil } from "../helpers/HttpMetadataUtil";
+import { FeatureProgrammer } from "../internal/FeatureProgrammer";
+
+export namespace HttpHeadersProgrammer {
+  export const INPUT_TYPE = "Record<string, string | string[] | undefined>";
+
+  export const decompose = (props: {
+    context: ITypiaContext;
+    functor: FunctionProgrammer;
+    type: ts.Type;
+    name: string | undefined;
+  }): FeatureProgrammer.IDecomposed => {
+    // ANALYZE TYPE
+    const collection: MetadataStorage = new MetadataStorage();
+    const result = MetadataFactory.analyze({
+      checker: props.context.checker,
+      transformer: props.context.transformer,
+      options: {
+        escape: false,
+        constant: true,
+        absorb: true,
+        validate,
+      },
+      components: collection,
+      type: props.type,
+    });
+    if (result.success === false)
+      throw TransformerError.from({
+        code: props.functor.method,
+        errors: result.errors,
+      });
+
+    // DO TRANSFORM
+    const object: MetadataObjectType = result.data.objects[0]!.type;
+    const statements: ts.Statement[] = decode_object({
+      context: props.context,
+      object,
+    });
+    return {
+      functions: {},
+      statements: [],
+      arrow: ts.factory.createArrowFunction(
+        undefined,
+        undefined,
+        [
+          IdentifierFactory.parameter(
+            "input",
+            ts.factory.createTypeReferenceNode(INPUT_TYPE),
+          ),
+        ],
+        props.context.importer.type({
+          file: "typia",
+          name: "Resolved",
+          arguments: [
+            ts.factory.createTypeReferenceNode(
+              props.name ??
+                TypeFactory.getFullName({
+                  checker: props.context.checker,
+                  type: props.type,
+                }),
+            ),
+          ],
+        }),
+        undefined,
+        ts.factory.createBlock(statements, true),
+      ),
+    };
+  };
+
+  export const write = (props: IProgrammerProps): ts.CallExpression => {
+    const functor: FunctionProgrammer = new FunctionProgrammer(
+      props.modulo.getText(),
+    );
+    const result: FeatureProgrammer.IDecomposed = decompose({
+      ...props,
+      functor,
+    });
+    return FeatureProgrammer.writeDecomposed({
+      modulo: props.modulo,
+      functor,
+      result,
+    });
+  };
+
+  export const validate = (
+    metadata: MetadataSchema,
+    explore: MetadataFactory.IExplore,
+  ): string[] => {
+    const errors: string[] = [];
+    const insert = (msg: string) => errors.push(msg);
+
+    if (explore.top === true) {
+      // TOP MUST BE ONLY OBJECT
+      if (metadata.objects.length !== 1 || metadata.bucket() !== 1)
+        insert("only one object type is allowed.");
+      if (metadata.nullable === true) insert("headers cannot be null.");
+      if (metadata.isRequired() === false) insert("headers cannot be null.");
+    } else if (
+      explore.nested !== null &&
+      explore.nested instanceof MetadataArrayType
+    ) {
+      //----
+      // ARRAY
+      //----
+      const atomics = HttpMetadataUtil.atomics(metadata);
+      const expected: number =
+        metadata.atomics.length +
+        metadata.templates.length +
+        metadata.constants
+          .map((c) => c.values.length)
+          .reduce((a, b) => a + b, 0);
+      if (atomics.size > 1) insert("union type is not allowed in array.");
+      if (metadata.size() !== expected)
+        insert("only atomic or constant types are allowed in array.");
+      if (metadata.nullable === true)
+        insert("nullable type is not allowed in array.");
+      if (metadata.isRequired() === false)
+        insert("optional type is not allowed in array.");
+    } else if (explore.object && explore.property !== null) {
+      //----
+      // COMMON
+      //----
+      // PROPERTY MUST BE SOLE
+      if (typeof explore.property === "object")
+        insert("dynamic property is not allowed.");
+      // DO NOT ALLOW TUPLE TYPE
+      if (metadata.tuples.length) insert("tuple type is not allowed.");
+      // DO NOT ALLOW UNION TYPE
+      if (HttpMetadataUtil.isUnion(metadata))
+        insert("union type is not allowed.");
+      // DO NOT ALLOW NESTED OBJECT
+      if (
+        metadata.objects.length ||
+        metadata.sets.length ||
+        metadata.maps.length ||
+        metadata.natives.length
+      )
+        insert("nested object type is not allowed.");
+      // DO NOT ALLOW NULLABLE
+      if (metadata.nullable === true) insert("nullable type is not allowed.");
+
+      //----
+      // SPECIAL KEY NAMES
+      //----
+      const isArray: boolean =
+        metadata.arrays.length >= 1 || metadata.tuples.length >= 1;
+      // SET-COOKIE MUST BE ARRAY
+      if (
+        typeof explore.property === "string" &&
+        explore.property.toLowerCase() === "set-cookie" &&
+        isArray === false
+      )
+        insert(`${explore.property} property must be array.`);
+      // MUST BE SINGULAR CASE
+      if (
+        typeof explore.property === "string" &&
+        SINGULAR.has(explore.property.toLowerCase()) &&
+        isArray === true
+      )
+        insert("property cannot be array.");
+    } else if (explore.object && explore.property === null) {
+      const counter: Map<string, Set<string>> = new Map();
+      for (const prop of explore.object.properties) {
+        const key: string | null = prop.key.getSoleLiteral();
+        if (key === null) continue;
+
+        MapUtil.take(counter, key.toLowerCase(), () => new Set()).add(key);
+      }
+      for (const [key, set] of counter)
+        if (set.size > 1)
+          insert(
+            `duplicated keys when converting to lowercase letters: [${[
+              ...set,
+            ].join(", ")}] -> ${key}`,
+          );
+    }
+    return errors;
+  };
+
+  const decode_object = (props: {
+    context: ITypiaContext;
+    object: MetadataObjectType;
+  }): ts.Statement[] => {
+    const output: ts.Identifier = ts.factory.createIdentifier("output");
+    const optionals: string[] = [];
+    return [
+      StatementFactory.constant({
+        name: "output",
+        value: ts.factory.createObjectLiteralExpression(
+          props.object.properties.map((p) => {
+            if (
+              !p.value.isRequired() &&
+              p.value.arrays.length + p.value.tuples.length > 0
+            )
+              optionals.push(p.key.constants[0]!.values[0]!.value as string);
+            return decode_regular_property({
+              context: props.context,
+              property: p,
+            });
+          }),
+          true,
+        ),
+      }),
+      ...optionals.map((key) => {
+        const access = IdentifierFactory.access(output, key);
+        return ts.factory.createIfStatement(
+          ts.factory.createStrictEquality(
+            ExpressionFactory.number(0),
+            IdentifierFactory.access(access, "length"),
+          ),
+          ts.factory.createExpressionStatement(
+            ts.factory.createDeleteExpression(access),
+          ),
+        );
+      }),
+      ts.factory.createReturnStatement(
+        ts.factory.createAsExpression(output, TypeFactory.keyword("any")),
+      ),
+    ];
+  };
+
+  const decode_regular_property = (props: {
+    context: ITypiaContext;
+    property: MetadataProperty;
+  }): ts.PropertyAssignment => {
+    const key: string = props.property.key.constants[0]!.values[0]!
+      .value as string;
+    const value: MetadataSchema = props.property.value;
+
+    const [type, isArray]: [Atomic.Literal, boolean] = value.atomics.length
+      ? [value.atomics[0]!.type, false]
+      : value.constants.length
+        ? [value.constants[0]!.type, false]
+        : value.templates.length
+          ? ["string", false]
+          : (() => {
+              const meta: MetadataSchema =
+                value.arrays[0]?.type.value ??
+                value.tuples[0]!.type.elements[0]!;
+              return meta.atomics.length
+                ? [meta.atomics[0]!.type, true]
+                : meta.templates.length
+                  ? ["string", true]
+                  : [meta.constants[0]!.type, true];
+            })();
+    const input = IdentifierFactory.access(
+      ts.factory.createIdentifier("input"),
+      key.toLowerCase(),
+    );
+
+    return ts.factory.createPropertyAssignment(
+      NamingConvention.variable(key)
+        ? key
+        : ts.factory.createStringLiteral(key),
+      isArray
+        ? key === "set-cookie"
+          ? input
+          : decode_array({
+              context: props.context,
+              type,
+              key,
+              value,
+              input,
+            })
+        : decode_value({
+            context: props.context,
+            type,
+            input,
+          }),
+    );
+  };
+
+  const decode_value = (props: {
+    context: ITypiaContext;
+    type: Atomic.Literal;
+    input: ts.Expression;
+  }) =>
+    props.type === "string"
+      ? props.input
+      : ts.factory.createCallExpression(
+          props.context.importer.internal(
+            `httpHeaderRead${NamingConvention.capitalize(props.type)}`,
+          ),
+          undefined,
+          [props.input],
+        );
+
+  const decode_array = (props: {
+    context: ITypiaContext;
+    type: Atomic.Literal;
+    key: string;
+    value: MetadataSchema;
+    input: ts.Expression;
+  }) => {
+    const reader =
+      props.type === "string"
+        ? ts.factory.createArrowFunction(
+            undefined,
+            undefined,
+            [IdentifierFactory.parameter("str")],
+            undefined,
+            undefined,
+            ts.factory.createCallExpression(
+              IdentifierFactory.access(
+                ts.factory.createIdentifier("str"),
+                "trim",
+              ),
+              undefined,
+              undefined,
+            ),
+          )
+        : props.context.importer.internal(
+            `httpHeaderRead${NamingConvention.capitalize(props.type)}`,
+          );
+    const split: ts.CallChain = ts.factory.createCallChain(
+      ts.factory.createPropertyAccessChain(
+        ts.factory.createCallChain(
+          ts.factory.createPropertyAccessChain(
+            props.input,
+            ts.factory.createToken(ts.SyntaxKind.QuestionDotToken),
+            ts.factory.createIdentifier("split"),
+          ),
+          undefined,
+          undefined,
+          [
+            ts.factory.createStringLiteral(
+              props.key === "cookie" ? "; " : ", ",
+            ),
+          ],
+        ),
+        ts.factory.createToken(ts.SyntaxKind.QuestionDotToken),
+        ts.factory.createIdentifier("map"),
+      ),
+      undefined,
+      undefined,
+      [reader],
+    );
+    return ts.factory.createConditionalExpression(
+      ExpressionFactory.isArray(props.input),
+      undefined,
+      ts.factory.createCallExpression(
+        IdentifierFactory.access(props.input, "map"),
+        undefined,
+        [reader],
+      ),
+      undefined,
+      props.value.isRequired() === false
+        ? split
+        : ts.factory.createBinaryExpression(
+            split,
+            ts.factory.createToken(ts.SyntaxKind.QuestionQuestionToken),
+            ts.factory.createArrayLiteralExpression([], false),
+          ),
+    );
+  };
+}
+
+const SINGULAR: Set<string> = new Set([
+  "age",
+  "authorization",
+  "content-length",
+  "content-type",
+  "etag",
+  "expires",
+  "from",
+  "host",
+  "if-modified-since",
+  "if-unmodified-since",
+  "last-modified",
+  "location",
+  "max-forwards",
+  "proxy-authorization",
+  "referer",
+  "retry-after",
+  "server",
+  "user-agent",
+]);