@nestia/sdk 12.0.0-dev.20260601.1 → 12.0.0-dev.20260612.2

package/src/generates/internal/SdkAliasCollection.ts

@@ -1,261 +1,274 @@
-import { Node, SyntaxKind, TypeScriptFactory } from "@nestia/factory";
-import { TypeFactory } from "@nestia/factory";
-import { MetadataSchema, sizeOf } from "../../internal/legacy";
-
-import { INestiaProject } from "../../structures/INestiaProject";
-import { IReflectType } from "../../structures/IReflectType";
-import { ITypedHttpRoute } from "../../structures/ITypedHttpRoute";
-import { ITypedHttpRouteParameter } from "../../structures/ITypedHttpRouteParameter";
-import { ITypedWebSocketRoute } from "../../structures/ITypedWebSocketRoute";
-import { FilePrinter } from "./FilePrinter";
-import { ImportDictionary } from "./ImportDictionary";
-import { SdkHttpParameterProgrammer } from "./SdkHttpParameterProgrammer";
-import { SdkTypeProgrammer } from "./SdkTypeProgrammer";
-
-export namespace SdkAliasCollection {
-  export const name = ({ type }: { type: IReflectType }): Node =>
-    TypeScriptFactory.createTypeReferenceNode(
-      type.name,
-      type.typeArguments
-        ? type.typeArguments.map((a) => name({ type: a }))
-        : undefined,
-    );
-
-  export const from =
-    (project: INestiaProject) =>
-    (importer: ImportDictionary) =>
-    (metadata: MetadataSchema) =>
-      SdkTypeProgrammer.write(project)(importer)(metadata);
-
-  export const httpProps =
-    (project: INestiaProject) =>
-    (importer: ImportDictionary) =>
-    (route: ITypedHttpRoute): Node =>
-      TypeScriptFactory.createTypeLiteralNode(
-        SdkHttpParameterProgrammer.getEntries({
-          project,
-          importer,
-          route,
-          body: true,
-          prefix: false,
-        })
-          .map((e) => {
-            const signature: Node =
-              TypeScriptFactory.createPropertySignature(
-                undefined,
-                e.key,
-                e.required
-                  ? undefined
-                  : TypeScriptFactory.createToken(SyntaxKind.QuestionToken),
-                e.type,
-              );
-            const description: string | null =
-              e.parameter.description ??
-              route.jsDocTags
-                ?.find(
-                  (tag) =>
-                    tag.name === "param" &&
-                    tag.text?.[0]?.kind === "parameterName" &&
-                    tag.text?.[0]?.text === e.key,
-                )
-                ?.text?.find((t) => t.kind === "text")?.text ??
-              null;
-            return description?.length
-              ? [
-                  TypeScriptFactory.createIdentifier("\n") as any,
-                  FilePrinter.description(signature, description),
-                ]
-              : [signature];
-          })
-          .flat(),
-      );
-
-  export const websocketProps = (route: ITypedWebSocketRoute): Node =>
-    TypeScriptFactory.createTypeLiteralNode([
-      ...route.pathParameters.map((p) =>
-        TypeScriptFactory.createPropertySignature(
-          undefined,
-          p.name,
-          undefined,
-          SdkAliasCollection.name(p),
-        ),
-      ),
-      ...(route.query
-        ? [
-            TypeScriptFactory.createPropertySignature(
-              undefined,
-              "query",
-              undefined,
-              TypeScriptFactory.createTypeReferenceNode("Query"),
-            ),
-          ]
-        : []),
-      TypeScriptFactory.createPropertySignature(
-        undefined,
-        "provider",
-        undefined,
-        TypeScriptFactory.createTypeReferenceNode("Provider"),
-      ),
-    ]);
-
-  export const headers =
-    (project: INestiaProject) =>
-    (importer: ImportDictionary) =>
-    (param: ITypedHttpRouteParameter.IHeaders): Node => {
-      if (project.config.clone === true)
-        return from(project)(importer)(param.metadata);
-      const type: Node = name(param);
-      if (project.config.primitive === false) return type;
-      return TypeScriptFactory.createTypeReferenceNode(
-        importer.external({
-          file: "typia",
-          declaration: true,
-          type: "element",
-          name: "Resolved",
-        }),
-        [type],
-      );
-    };
-
-  export const query =
-    (project: INestiaProject) =>
-    (importer: ImportDictionary) =>
-    (param: ITypedHttpRouteParameter.IQuery): Node => {
-      if (project.config.clone === true)
-        return from(project)(importer)(param.metadata);
-      const type: Node = name(param);
-      if (project.config.primitive === false) return type;
-      return TypeScriptFactory.createTypeReferenceNode(
-        importer.external({
-          file: "typia",
-          declaration: true,
-          type: "element",
-          name: "Resolved",
-        }),
-        [type],
-      );
-    };
-
-  export const body =
-    (project: INestiaProject) =>
-    (importer: ImportDictionary) =>
-    (param: ITypedHttpRouteParameter.IBody): Node => {
-      if (project.config.clone === true) {
-        const type: Node = from(project)(importer)(param.metadata);
-        return param.contentType === "multipart/form-data"
-          ? formDataInput(importer)(type)
-          : type;
-      }
-      const type: Node = name(param);
-      if (param.contentType === "multipart/form-data")
-        return formDataInput(importer)(type);
-      else if (project.config.primitive === false) return type;
-      return TypeScriptFactory.createTypeReferenceNode(
-        importer.external({
-          file: "typia",
-          declaration: true,
-          type: "element",
-          name:
-            param.contentType === "application/json" || param.encrypted === true
-              ? "Primitive"
-              : "Resolved",
-        }),
-        [type],
-      );
-    };
-
-  export const response =
-    (project: INestiaProject) =>
-    (importer: ImportDictionary) =>
-    (route: ITypedHttpRoute): Node => {
-      const schema = (p: { metadata: MetadataSchema; type: IReflectType }) =>
-        sizeOf(p.metadata) === 0
-          ? TypeFactory.keyword("void")
-          : project.config.clone === true
-            ? from(project)(importer)(p.metadata)
-            : project.config.primitive !== false
-              ? TypeScriptFactory.createTypeReferenceNode(
-                  importer.external({
-                    file: "typia",
-                    declaration: true,
-                    type: "element",
-                    name:
-                      route.success.contentType === "application/json" ||
-                      route.success.encrypted === true
-                        ? "Primitive"
-                        : "Resolved",
-                  }),
-                  [name(p)],
-                )
-              : name(p);
-      if (project.config.propagate !== true) return schema(route.success);
-
-      const branches: IBranch[] = [
-        {
-          status: String(
-            route.success.status ?? (route.method === "POST" ? 201 : 200),
-          ),
-          type: schema(route.success),
-        },
-        ...Object.entries(route.exceptions).map(([status, value]) => ({
-          status,
-          type: schema(value),
-        })),
-      ];
-      return TypeScriptFactory.createTypeReferenceNode(
-        importer.external({
-          file: "@nestia/fetcher",
-          declaration: true,
-          type: "element",
-          name: "IPropagation",
-        }),
-        [
-          TypeScriptFactory.createTypeLiteralNode(
-            branches.map((b) =>
-              TypeScriptFactory.createPropertySignature(
-                undefined,
-                TypeScriptFactory.createNumericLiteral(b.status),
-                undefined,
-                b.type,
-              ),
-            ),
-          ),
-          ...(route.success.status
-            ? [
-                TypeScriptFactory.createLiteralTypeNode(
-                  TypeScriptFactory.createNumericLiteral(route.success.status),
-                ),
-              ]
-            : []),
-        ],
-      );
-    };
-
-  export const responseBody =
-    (project: INestiaProject) =>
-    (importer: ImportDictionary) =>
-    (route: ITypedHttpRoute): Node =>
-      response({
-        ...project,
-        config: {
-          ...project.config,
-          propagate: false,
-        },
-      })(importer)(route);
-
-  const formDataInput = (importer: ImportDictionary) => (type: Node) =>
-    TypeScriptFactory.createTypeReferenceNode(
-      importer.external({
-        file: "@nestia/fetcher",
-        declaration: true,
-        type: "element",
-        name: "FormDataInput",
-      }),
-      [type],
-    );
-}
-
-interface IBranch {
-  status: string;
-  type: Node;
-}
+import { Node, SyntaxKind, TypeScriptFactory } from "@nestia/factory";
+import { TypeFactory } from "@nestia/factory";
+
+import { MetadataSchema, sizeOf } from "../../internal/legacy";
+import { INestiaProject } from "../../structures/INestiaProject";
+import { IReflectType } from "../../structures/IReflectType";
+import { ITypedHttpRoute } from "../../structures/ITypedHttpRoute";
+import { ITypedHttpRouteParameter } from "../../structures/ITypedHttpRouteParameter";
+import { ITypedWebSocketRoute } from "../../structures/ITypedWebSocketRoute";
+import { FilePrinter } from "./FilePrinter";
+import { ImportDictionary } from "./ImportDictionary";
+import { SdkHttpParameterProgrammer } from "./SdkHttpParameterProgrammer";
+import { SdkTypeProgrammer } from "./SdkTypeProgrammer";
+
+export namespace SdkAliasCollection {
+  export const name = ({ type }: { type: IReflectType }): Node =>
+    TypeScriptFactory.createTypeReferenceNode(
+      type.name,
+      type.typeArguments
+        ? type.typeArguments.map((a) => name({ type: a }))
+        : undefined,
+    );
+
+  export const binaryChunk = (): Node =>
+    TypeScriptFactory.createTypeReferenceNode("Uint8Array", [
+      TypeScriptFactory.createTypeReferenceNode("ArrayBufferLike"),
+    ]);
+
+  export const binaryResponse = (): Node =>
+    TypeScriptFactory.createTypeReferenceNode("ReadableStream", [
+      binaryChunk(),
+    ]);
+
+  export const from =
+    (project: INestiaProject) =>
+    (importer: ImportDictionary) =>
+    (metadata: MetadataSchema) =>
+      SdkTypeProgrammer.write(project)(importer)(metadata);
+
+  export const httpProps =
+    (project: INestiaProject) =>
+    (importer: ImportDictionary) =>
+    (route: ITypedHttpRoute): Node =>
+      TypeScriptFactory.createTypeLiteralNode(
+        SdkHttpParameterProgrammer.getEntries({
+          project,
+          importer,
+          route,
+          body: true,
+          prefix: false,
+        })
+          .map((e) => {
+            const signature: Node = TypeScriptFactory.createPropertySignature(
+              undefined,
+              e.key,
+              e.required
+                ? undefined
+                : TypeScriptFactory.createToken(SyntaxKind.QuestionToken),
+              e.type,
+            );
+            const description: string | null =
+              e.parameter.description ??
+              route.jsDocTags
+                ?.find(
+                  (tag) =>
+                    tag.name === "param" &&
+                    tag.text?.[0]?.kind === "parameterName" &&
+                    tag.text?.[0]?.text === e.key,
+                )
+                ?.text?.find((t) => t.kind === "text")?.text ??
+              null;
+            return description?.length
+              ? [
+                  TypeScriptFactory.createIdentifier("\n") as any,
+                  FilePrinter.description(signature, description),
+                ]
+              : [signature];
+          })
+          .flat(),
+      );
+
+  export const websocketProps = (route: ITypedWebSocketRoute): Node =>
+    TypeScriptFactory.createTypeLiteralNode([
+      ...route.pathParameters.map((p) =>
+        TypeScriptFactory.createPropertySignature(
+          undefined,
+          p.name,
+          undefined,
+          SdkAliasCollection.name(p),
+        ),
+      ),
+      ...(route.query
+        ? [
+            TypeScriptFactory.createPropertySignature(
+              undefined,
+              "query",
+              undefined,
+              TypeScriptFactory.createTypeReferenceNode("Query"),
+            ),
+          ]
+        : []),
+      TypeScriptFactory.createPropertySignature(
+        undefined,
+        "provider",
+        undefined,
+        TypeScriptFactory.createTypeReferenceNode("Provider"),
+      ),
+    ]);
+
+  export const headers =
+    (project: INestiaProject) =>
+    (importer: ImportDictionary) =>
+    (param: ITypedHttpRouteParameter.IHeaders): Node => {
+      if (project.config.clone === true)
+        return from(project)(importer)(param.metadata);
+      const type: Node = name(param);
+      if (project.config.primitive === false) return type;
+      return TypeScriptFactory.createTypeReferenceNode(
+        importer.external({
+          file: "typia",
+          declaration: true,
+          type: "element",
+          name: "Resolved",
+        }),
+        [type],
+      );
+    };
+
+  export const query =
+    (project: INestiaProject) =>
+    (importer: ImportDictionary) =>
+    (param: ITypedHttpRouteParameter.IQuery): Node => {
+      if (project.config.clone === true)
+        return from(project)(importer)(param.metadata);
+      const type: Node = name(param);
+      if (project.config.primitive === false) return type;
+      return TypeScriptFactory.createTypeReferenceNode(
+        importer.external({
+          file: "typia",
+          declaration: true,
+          type: "element",
+          name: "Resolved",
+        }),
+        [type],
+      );
+    };
+
+  export const body =
+    (project: INestiaProject) =>
+    (importer: ImportDictionary) =>
+    (param: ITypedHttpRouteParameter.IBody): Node => {
+      if (project.config.clone === true) {
+        const type: Node = from(project)(importer)(param.metadata);
+        return param.contentType === "multipart/form-data"
+          ? formDataInput(importer)(type)
+          : type;
+      }
+      const type: Node = name(param);
+      if (param.contentType === "multipart/form-data")
+        return formDataInput(importer)(type);
+      else if (project.config.primitive === false) return type;
+      return TypeScriptFactory.createTypeReferenceNode(
+        importer.external({
+          file: "typia",
+          declaration: true,
+          type: "element",
+          name:
+            param.contentType === "application/json" || param.encrypted === true
+              ? "Primitive"
+              : "Resolved",
+        }),
+        [type],
+      );
+    };
+
+  export const response =
+    (project: INestiaProject) =>
+    (importer: ImportDictionary) =>
+    (route: ITypedHttpRoute): Node => {
+      const schema = (p: { metadata: MetadataSchema; type: IReflectType }) =>
+        sizeOf(p.metadata) === 0
+          ? TypeFactory.keyword("void")
+          : project.config.clone === true
+            ? from(project)(importer)(p.metadata)
+            : project.config.primitive !== false
+              ? TypeScriptFactory.createTypeReferenceNode(
+                  importer.external({
+                    file: "typia",
+                    declaration: true,
+                    type: "element",
+                    name:
+                      route.success.contentType === "application/json" ||
+                      route.success.encrypted === true
+                        ? "Primitive"
+                        : "Resolved",
+                  }),
+                  [name(p)],
+                )
+              : name(p);
+      const success: Node =
+        route.success.binary === true
+          ? binaryResponse()
+          : schema(route.success);
+      if (project.config.propagate !== true) return success;
+
+      const branches: IBranch[] = [
+        {
+          status: String(
+            route.success.status ?? (route.method === "POST" ? 201 : 200),
+          ),
+          type: success,
+        },
+        ...Object.entries(route.exceptions).map(([status, value]) => ({
+          status,
+          type: schema(value),
+        })),
+      ];
+      return TypeScriptFactory.createTypeReferenceNode(
+        importer.external({
+          file: "@nestia/fetcher",
+          declaration: true,
+          type: "element",
+          name: "IPropagation",
+        }),
+        [
+          TypeScriptFactory.createTypeLiteralNode(
+            branches.map((b) =>
+              TypeScriptFactory.createPropertySignature(
+                undefined,
+                TypeScriptFactory.createNumericLiteral(b.status),
+                undefined,
+                b.type,
+              ),
+            ),
+          ),
+          ...(route.success.status
+            ? [
+                TypeScriptFactory.createLiteralTypeNode(
+                  TypeScriptFactory.createNumericLiteral(route.success.status),
+                ),
+              ]
+            : []),
+        ],
+      );
+    };
+
+  export const responseBody =
+    (project: INestiaProject) =>
+    (importer: ImportDictionary) =>
+    (route: ITypedHttpRoute): Node =>
+      response({
+        ...project,
+        config: {
+          ...project.config,
+          propagate: false,
+        },
+      })(importer)(route);
+
+  const formDataInput = (importer: ImportDictionary) => (type: Node) =>
+    TypeScriptFactory.createTypeReferenceNode(
+      importer.external({
+        file: "@nestia/fetcher",
+        declaration: true,
+        type: "element",
+        name: "FormDataInput",
+      }),
+      [type],
+    );
+}
+
+interface IBranch {
+  status: string;
+  type: Node;
+}