@nestia/sdk 4.6.2 → 5.0.0-dev.20250301

package/src/generates/internal/SdkWebSocketRouteProgrammer.ts

@@ -1,265 +1,265 @@
-import ts from "typescript";
-import { IJsDocTagInfo } from "typia";
-import { IdentifierFactory } from "typia/lib/factories/IdentifierFactory";
-
-import { ITypedWebSocketRoute } from "../../structures/ITypedWebSocketRoute";
-import { FilePrinter } from "./FilePrinter";
-import { ImportDictionary } from "./ImportDictionary";
-import { SdkAliasCollection } from "./SdkAliasCollection";
-import { SdkImportWizard } from "./SdkImportWizard";
-import { SdkWebSocketNamespaceProgrammer } from "./SdkWebSocketNamespaceProgrammer";
-
-export namespace SdkWebSocketRouteProgrammer {
-  export const write =
-    (importer: ImportDictionary) =>
-    (route: ITypedWebSocketRoute): ts.Statement[] => [
-      FilePrinter.description(
-        writeFunction(importer)(route),
-        writeDescription(route),
-      ),
-      SdkWebSocketNamespaceProgrammer.write(importer)(route),
-    ];
-
-  const writeDescription = (route: ITypedWebSocketRoute): string => {
-    // MAIN DESCRIPTION
-    const comments: string[] = route.description
-      ? route.description.split("\n")
-      : [];
-
-    // COMMENT TAGS
-    const tags: IJsDocTagInfo[] = route.jsDocTags.filter(
-      (tag) =>
-        tag.name !== "param" ||
-        route.parameters
-          .filter((p) => p.category === "param" || p.category === "query")
-          .some((p) => p.name === tag.text?.[0]?.text),
-    );
-    if (tags.length !== 0) {
-      const content: string[] = tags.map((t) =>
-        t.text?.length
-          ? `@${t.name} ${t.text.map((e) => e.text).join("")}`
-          : `@${t.name}`,
-      );
-      comments.push("", ...new Set(content));
-    }
-
-    // POSTFIX
-    if (!!comments.length) comments.push("");
-    comments.push(
-      `@controller ${route.controller.class.name}.${route.name}`,
-      `@path ${route.path}`,
-      `@nestia Generated by Nestia - https://github.com/samchon/nestia`,
-    );
-    return comments.join("\n");
-  };
-
-  const writeFunction =
-    (importer: ImportDictionary) =>
-    (route: ITypedWebSocketRoute): ts.FunctionDeclaration =>
-      ts.factory.createFunctionDeclaration(
-        [
-          ts.factory.createModifier(ts.SyntaxKind.ExportKeyword),
-          ts.factory.createModifier(ts.SyntaxKind.AsyncKeyword),
-        ],
-        undefined,
-        route.name,
-        undefined,
-        [
-          IdentifierFactory.parameter(
-            "connection",
-            ts.factory.createTypeReferenceNode(
-              SdkImportWizard.IConnection(importer),
-              [ts.factory.createTypeReferenceNode(`${route.name}.Header`)],
-            ),
-          ),
-          ...route.parameters
-            .filter((p) => p.category === "param" || p.category === "query")
-            .map((p) =>
-              IdentifierFactory.parameter(
-                p.name,
-                p.category === "param"
-                  ? SdkAliasCollection.name(p)
-                  : ts.factory.createTypeReferenceNode(`${route.name}.Query`),
-              ),
-            ),
-          IdentifierFactory.parameter(
-            "provider",
-            ts.factory.createTypeReferenceNode(`${route.name}.Provider`),
-          ),
-        ],
-        ts.factory.createTypeReferenceNode("Promise", [
-          ts.factory.createTypeReferenceNode(`${route.name}.Output`),
-        ]),
-        ts.factory.createBlock(writeFunctionBody(importer)(route), true),
-      );
-
-  const writeFunctionBody =
-    (importer: ImportDictionary) =>
-    (route: ITypedWebSocketRoute): ts.Statement[] => [
-      local("connector")(
-        ts.factory.createTypeReferenceNode(
-          importer.external({
-            type: false,
-            library: "tgrid",
-            instance: "WebSocketConnector",
-          }),
-          [
-            ts.factory.createTypeReferenceNode(`${route.name}.Header`),
-            ts.factory.createTypeReferenceNode(`${route.name}.Provider`),
-            ts.factory.createTypeReferenceNode(`${route.name}.Listener`),
-          ],
-        ),
-      )(
-        ts.factory.createNewExpression(
-          ts.factory.createIdentifier(
-            importer.external({
-              type: false,
-              library: "tgrid",
-              instance: "WebSocketConnector",
-            }),
-          ),
-          undefined,
-          [
-            ts.factory.createAsExpression(
-              ts.factory.createBinaryExpression(
-                ts.factory.createPropertyAccessExpression(
-                  ts.factory.createIdentifier("connection"),
-                  "headers",
-                ),
-                ts.factory.createToken(ts.SyntaxKind.QuestionQuestionToken),
-                ts.factory.createObjectLiteralExpression([], false),
-              ),
-              ts.factory.createKeywordTypeNode(ts.SyntaxKind.AnyKeyword),
-            ),
-            ts.factory.createIdentifier("provider"),
-          ],
-        ),
-      ),
-      ts.factory.createExpressionStatement(
-        ts.factory.createAwaitExpression(
-          ts.factory.createCallExpression(
-            ts.factory.createPropertyAccessExpression(
-              ts.factory.createIdentifier("connector"),
-              "connect",
-            ),
-            undefined,
-            [
-              joinPath(
-                ts.factory.createCallExpression(
-                  ts.factory.createPropertyAccessExpression(
-                    ts.factory.createIdentifier(route.name),
-                    "path",
-                  ),
-                  [],
-                  route.parameters
-                    .filter(
-                      (p) => p.category === "param" || p.category === "query",
-                    )
-                    .map((x) => ts.factory.createIdentifier(x.name)),
-                ),
-              ),
-            ],
-          ),
-        ),
-      ),
-      local("driver")(
-        ts.factory.createTypeReferenceNode(
-          importer.external({
-            type: true,
-            library: "tgrid",
-            instance: "Driver",
-          }),
-          [ts.factory.createTypeReferenceNode(`${route.name}.Listener`)],
-        ),
-      )(
-        ts.factory.createCallExpression(
-          ts.factory.createPropertyAccessExpression(
-            ts.factory.createIdentifier("connector"),
-            "getDriver",
-          ),
-          undefined,
-          undefined,
-        ),
-      ),
-      ts.factory.createReturnStatement(
-        ts.factory.createObjectLiteralExpression(
-          [
-            ts.factory.createShorthandPropertyAssignment("connector"),
-            ts.factory.createShorthandPropertyAssignment("driver"),
-          ],
-          true,
-        ),
-      ),
-    ];
-}
-
-const local =
-  (name: string) => (type: ts.TypeNode) => (expression: ts.Expression) =>
-    ts.factory.createVariableStatement(
-      [],
-      ts.factory.createVariableDeclarationList(
-        [
-          ts.factory.createVariableDeclaration(
-            name,
-            undefined,
-            type,
-            expression,
-          ),
-        ],
-        ts.NodeFlags.Const,
-      ),
-    );
-
-const joinPath = (caller: ts.Expression) =>
-  ts.factory.createTemplateExpression(ts.factory.createTemplateHead("", ""), [
-    ts.factory.createTemplateSpan(
-      ts.factory.createConditionalExpression(
-        ts.factory.createCallExpression(
-          ts.factory.createPropertyAccessExpression(
-            ts.factory.createPropertyAccessExpression(
-              ts.factory.createIdentifier("connection"),
-              ts.factory.createIdentifier("host"),
-            ),
-            ts.factory.createIdentifier("endsWith"),
-          ),
-          undefined,
-          [ts.factory.createStringLiteral("/")],
-        ),
-        ts.factory.createToken(ts.SyntaxKind.QuestionToken),
-        ts.factory.createCallExpression(
-          ts.factory.createPropertyAccessExpression(
-            ts.factory.createPropertyAccessExpression(
-              ts.factory.createIdentifier("connection"),
-              ts.factory.createIdentifier("host"),
-            ),
-            ts.factory.createIdentifier("substring"),
-          ),
-          undefined,
-          [
-            ts.factory.createNumericLiteral("0"),
-            ts.factory.createBinaryExpression(
-              ts.factory.createPropertyAccessExpression(
-                ts.factory.createPropertyAccessExpression(
-                  ts.factory.createIdentifier("connection"),
-                  ts.factory.createIdentifier("host"),
-                ),
-                ts.factory.createIdentifier("length"),
-              ),
-              ts.factory.createToken(ts.SyntaxKind.MinusToken),
-              ts.factory.createNumericLiteral("1"),
-            ),
-          ],
-        ),
-        ts.factory.createToken(ts.SyntaxKind.ColonToken),
-        ts.factory.createPropertyAccessExpression(
-          ts.factory.createIdentifier("connection"),
-          ts.factory.createIdentifier("host"),
-        ),
-      ),
-      ts.factory.createTemplateMiddle("", ""),
-    ),
-    ts.factory.createTemplateSpan(
-      caller,
-      ts.factory.createTemplateTail("", ""),
-    ),
-  ]);
+import ts from "typescript";
+import { IJsDocTagInfo } from "typia";
+import { IdentifierFactory } from "typia/lib/factories/IdentifierFactory";
+
+import { ITypedWebSocketRoute } from "../../structures/ITypedWebSocketRoute";
+import { FilePrinter } from "./FilePrinter";
+import { ImportDictionary } from "./ImportDictionary";
+import { SdkAliasCollection } from "./SdkAliasCollection";
+import { SdkImportWizard } from "./SdkImportWizard";
+import { SdkWebSocketNamespaceProgrammer } from "./SdkWebSocketNamespaceProgrammer";
+
+export namespace SdkWebSocketRouteProgrammer {
+  export const write =
+    (importer: ImportDictionary) =>
+    (route: ITypedWebSocketRoute): ts.Statement[] => [
+      FilePrinter.description(
+        writeFunction(importer)(route),
+        writeDescription(route),
+      ),
+      SdkWebSocketNamespaceProgrammer.write(importer)(route),
+    ];
+
+  const writeDescription = (route: ITypedWebSocketRoute): string => {
+    // MAIN DESCRIPTION
+    const comments: string[] = route.description
+      ? route.description.split("\n")
+      : [];
+
+    // COMMENT TAGS
+    const tags: IJsDocTagInfo[] = route.jsDocTags.filter(
+      (tag) =>
+        tag.name !== "param" ||
+        route.parameters
+          .filter((p) => p.category === "param" || p.category === "query")
+          .some((p) => p.name === tag.text?.[0]?.text),
+    );
+    if (tags.length !== 0) {
+      const content: string[] = tags.map((t) =>
+        t.text?.length
+          ? `@${t.name} ${t.text.map((e) => e.text).join("")}`
+          : `@${t.name}`,
+      );
+      comments.push("", ...new Set(content));
+    }
+
+    // POSTFIX
+    if (!!comments.length) comments.push("");
+    comments.push(
+      `@controller ${route.controller.class.name}.${route.name}`,
+      `@path ${route.path}`,
+      `@nestia Generated by Nestia - https://github.com/samchon/nestia`,
+    );
+    return comments.join("\n");
+  };
+
+  const writeFunction =
+    (importer: ImportDictionary) =>
+    (route: ITypedWebSocketRoute): ts.FunctionDeclaration =>
+      ts.factory.createFunctionDeclaration(
+        [
+          ts.factory.createModifier(ts.SyntaxKind.ExportKeyword),
+          ts.factory.createModifier(ts.SyntaxKind.AsyncKeyword),
+        ],
+        undefined,
+        route.name,
+        undefined,
+        [
+          IdentifierFactory.parameter(
+            "connection",
+            ts.factory.createTypeReferenceNode(
+              SdkImportWizard.IConnection(importer),
+              [ts.factory.createTypeReferenceNode(`${route.name}.Header`)],
+            ),
+          ),
+          ...route.parameters
+            .filter((p) => p.category === "param" || p.category === "query")
+            .map((p) =>
+              IdentifierFactory.parameter(
+                p.name,
+                p.category === "param"
+                  ? SdkAliasCollection.name(p)
+                  : ts.factory.createTypeReferenceNode(`${route.name}.Query`),
+              ),
+            ),
+          IdentifierFactory.parameter(
+            "provider",
+            ts.factory.createTypeReferenceNode(`${route.name}.Provider`),
+          ),
+        ],
+        ts.factory.createTypeReferenceNode("Promise", [
+          ts.factory.createTypeReferenceNode(`${route.name}.Output`),
+        ]),
+        ts.factory.createBlock(writeFunctionBody(importer)(route), true),
+      );
+
+  const writeFunctionBody =
+    (importer: ImportDictionary) =>
+    (route: ITypedWebSocketRoute): ts.Statement[] => [
+      local("connector")(
+        ts.factory.createTypeReferenceNode(
+          importer.external({
+            type: false,
+            library: "tgrid",
+            instance: "WebSocketConnector",
+          }),
+          [
+            ts.factory.createTypeReferenceNode(`${route.name}.Header`),
+            ts.factory.createTypeReferenceNode(`${route.name}.Provider`),
+            ts.factory.createTypeReferenceNode(`${route.name}.Listener`),
+          ],
+        ),
+      )(
+        ts.factory.createNewExpression(
+          ts.factory.createIdentifier(
+            importer.external({
+              type: false,
+              library: "tgrid",
+              instance: "WebSocketConnector",
+            }),
+          ),
+          undefined,
+          [
+            ts.factory.createAsExpression(
+              ts.factory.createBinaryExpression(
+                ts.factory.createPropertyAccessExpression(
+                  ts.factory.createIdentifier("connection"),
+                  "headers",
+                ),
+                ts.factory.createToken(ts.SyntaxKind.QuestionQuestionToken),
+                ts.factory.createObjectLiteralExpression([], false),
+              ),
+              ts.factory.createKeywordTypeNode(ts.SyntaxKind.AnyKeyword),
+            ),
+            ts.factory.createIdentifier("provider"),
+          ],
+        ),
+      ),
+      ts.factory.createExpressionStatement(
+        ts.factory.createAwaitExpression(
+          ts.factory.createCallExpression(
+            ts.factory.createPropertyAccessExpression(
+              ts.factory.createIdentifier("connector"),
+              "connect",
+            ),
+            undefined,
+            [
+              joinPath(
+                ts.factory.createCallExpression(
+                  ts.factory.createPropertyAccessExpression(
+                    ts.factory.createIdentifier(route.name),
+                    "path",
+                  ),
+                  [],
+                  route.parameters
+                    .filter(
+                      (p) => p.category === "param" || p.category === "query",
+                    )
+                    .map((x) => ts.factory.createIdentifier(x.name)),
+                ),
+              ),
+            ],
+          ),
+        ),
+      ),
+      local("driver")(
+        ts.factory.createTypeReferenceNode(
+          importer.external({
+            type: true,
+            library: "tgrid",
+            instance: "Driver",
+          }),
+          [ts.factory.createTypeReferenceNode(`${route.name}.Listener`)],
+        ),
+      )(
+        ts.factory.createCallExpression(
+          ts.factory.createPropertyAccessExpression(
+            ts.factory.createIdentifier("connector"),
+            "getDriver",
+          ),
+          undefined,
+          undefined,
+        ),
+      ),
+      ts.factory.createReturnStatement(
+        ts.factory.createObjectLiteralExpression(
+          [
+            ts.factory.createShorthandPropertyAssignment("connector"),
+            ts.factory.createShorthandPropertyAssignment("driver"),
+          ],
+          true,
+        ),
+      ),
+    ];
+}
+
+const local =
+  (name: string) => (type: ts.TypeNode) => (expression: ts.Expression) =>
+    ts.factory.createVariableStatement(
+      [],
+      ts.factory.createVariableDeclarationList(
+        [
+          ts.factory.createVariableDeclaration(
+            name,
+            undefined,
+            type,
+            expression,
+          ),
+        ],
+        ts.NodeFlags.Const,
+      ),
+    );
+
+const joinPath = (caller: ts.Expression) =>
+  ts.factory.createTemplateExpression(ts.factory.createTemplateHead("", ""), [
+    ts.factory.createTemplateSpan(
+      ts.factory.createConditionalExpression(
+        ts.factory.createCallExpression(
+          ts.factory.createPropertyAccessExpression(
+            ts.factory.createPropertyAccessExpression(
+              ts.factory.createIdentifier("connection"),
+              ts.factory.createIdentifier("host"),
+            ),
+            ts.factory.createIdentifier("endsWith"),
+          ),
+          undefined,
+          [ts.factory.createStringLiteral("/")],
+        ),
+        ts.factory.createToken(ts.SyntaxKind.QuestionToken),
+        ts.factory.createCallExpression(
+          ts.factory.createPropertyAccessExpression(
+            ts.factory.createPropertyAccessExpression(
+              ts.factory.createIdentifier("connection"),
+              ts.factory.createIdentifier("host"),
+            ),
+            ts.factory.createIdentifier("substring"),
+          ),
+          undefined,
+          [
+            ts.factory.createNumericLiteral("0"),
+            ts.factory.createBinaryExpression(
+              ts.factory.createPropertyAccessExpression(
+                ts.factory.createPropertyAccessExpression(
+                  ts.factory.createIdentifier("connection"),
+                  ts.factory.createIdentifier("host"),
+                ),
+                ts.factory.createIdentifier("length"),
+              ),
+              ts.factory.createToken(ts.SyntaxKind.MinusToken),
+              ts.factory.createNumericLiteral("1"),
+            ),
+          ],
+        ),
+        ts.factory.createToken(ts.SyntaxKind.ColonToken),
+        ts.factory.createPropertyAccessExpression(
+          ts.factory.createIdentifier("connection"),
+          ts.factory.createIdentifier("host"),
+        ),
+      ),
+      ts.factory.createTemplateMiddle("", ""),
+    ),
+    ts.factory.createTemplateSpan(
+      caller,
+      ts.factory.createTemplateTail("", ""),
+    ),
+  ]);

package/src/generates/internal/SwaggerDescriptionComposer.ts

@@ -1,64 +1,64 @@
-import { IJsDocTagInfo } from "typia";
-
-export namespace SwaggerDescriptionComposer {
-  export const compose = <Kind extends "summary" | "title">(props: {
-    description: string | null;
-    jsDocTags: IJsDocTagInfo[];
-    kind: Kind;
-  }): Kind extends "summary"
-    ? { summary?: string; description?: string }
-    : { title?: string; description?: string } => {
-    const title: string | undefined = (() => {
-      const [explicit] = getJsDocTexts({
-        jsDocTags: props.jsDocTags,
-        name: props.kind,
-      });
-      if (explicit?.length) return explicit;
-      else if (!props.description?.length) return undefined;
-
-      const index: number = props.description.indexOf("\n");
-      const top: string = (
-        index === -1 ? props.description : props.description.substring(0, index)
-      ).trim();
-      return top.endsWith(".") ? top.substring(0, top.length - 1) : undefined;
-    })();
-    return {
-      [props.kind]: title,
-      description: props.description?.length ? props.description : undefined,
-    } as any;
-  };
-
-  export const descriptionFromJsDocTag = (props: {
-    jsDocTags: IJsDocTagInfo[];
-    tag: string;
-    parameter?: string;
-  }): string | undefined => {
-    const parametric: (elem: IJsDocTagInfo) => boolean = props.parameter
-      ? (tag) =>
-          tag.text!.find(
-            (elem) =>
-              elem.kind === "parameterName" && elem.text === props.parameter,
-          ) !== undefined
-      : () => true;
-    const tag: IJsDocTagInfo | undefined = props.jsDocTags.find(
-      (tag) => tag.name === props.tag && tag.text && parametric(tag),
-    );
-    return tag && tag.text
-      ? tag.text.find((elem) => elem.kind === "text")?.text
-      : undefined;
-  };
-
-  export const getJsDocTexts = (props: {
-    jsDocTags: IJsDocTagInfo[];
-    name: string;
-  }): string[] =>
-    props.jsDocTags
-      .filter(
-        (tag) =>
-          tag.name === props.name &&
-          tag.text &&
-          tag.text.find((elem) => elem.kind === "text" && elem.text.length) !==
-            undefined,
-      )
-      .map((tag) => tag.text!.find((elem) => elem.kind === "text")!.text);
-}
+import { IJsDocTagInfo } from "typia";
+
+export namespace SwaggerDescriptionComposer {
+  export const compose = <Kind extends "summary" | "title">(props: {
+    description: string | null;
+    jsDocTags: IJsDocTagInfo[];
+    kind: Kind;
+  }): Kind extends "summary"
+    ? { summary?: string; description?: string }
+    : { title?: string; description?: string } => {
+    const title: string | undefined = (() => {
+      const [explicit] = getJsDocTexts({
+        jsDocTags: props.jsDocTags,
+        name: props.kind,
+      });
+      if (explicit?.length) return explicit;
+      else if (!props.description?.length) return undefined;
+
+      const index: number = props.description.indexOf("\n");
+      const top: string = (
+        index === -1 ? props.description : props.description.substring(0, index)
+      ).trim();
+      return top.endsWith(".") ? top.substring(0, top.length - 1) : undefined;
+    })();
+    return {
+      [props.kind]: title,
+      description: props.description?.length ? props.description : undefined,
+    } as any;
+  };
+
+  export const descriptionFromJsDocTag = (props: {
+    jsDocTags: IJsDocTagInfo[];
+    tag: string;
+    parameter?: string;
+  }): string | undefined => {
+    const parametric: (elem: IJsDocTagInfo) => boolean = props.parameter
+      ? (tag) =>
+          tag.text!.find(
+            (elem) =>
+              elem.kind === "parameterName" && elem.text === props.parameter,
+          ) !== undefined
+      : () => true;
+    const tag: IJsDocTagInfo | undefined = props.jsDocTags.find(
+      (tag) => tag.name === props.tag && tag.text && parametric(tag),
+    );
+    return tag && tag.text
+      ? tag.text.find((elem) => elem.kind === "text")?.text
+      : undefined;
+  };
+
+  export const getJsDocTexts = (props: {
+    jsDocTags: IJsDocTagInfo[];
+    name: string;
+  }): string[] =>
+    props.jsDocTags
+      .filter(
+        (tag) =>
+          tag.name === props.name &&
+          tag.text &&
+          tag.text.find((elem) => elem.kind === "text" && elem.text.length) !==
+            undefined,
+      )
+      .map((tag) => tag.text!.find((elem) => elem.kind === "text")!.text);
+}