@nestia/sdk 3.1.0-dev.20240429 → 3.1.0-dev.20240430

package/src/generates/internal/SdkFileProgrammer.ts

@@ -1,119 +1,119 @@
-import fs from "fs";
-import ts from "typescript";
-
-import { INestiaProject } from "../../structures/INestiaProject";
-import { ITypedHttpRoute } from "../../structures/ITypedHttpRoute";
-import { ITypedWebSocketRoute } from "../../structures/ITypedWebSocketRoute";
-import { MapUtil } from "../../utils/MapUtil";
-import { FilePrinter } from "./FilePrinter";
-import { ImportDictionary } from "./ImportDictionary";
-import { SdkHttpRouteProgrammer } from "./SdkHttpRouteProgrammer";
-import { SdkRouteDirectory } from "./SdkRouteDirectory";
-import { SdkWebSocketRouteProgrammer } from "./SdkWebSocketRouteProgrammer";
-
-export namespace SdkFileProgrammer {
-  /* ---------------------------------------------------------
-        CONSTRUCTOR
-    --------------------------------------------------------- */
-  export const generate =
-    (project: INestiaProject) =>
-    async (
-      routeList: Array<ITypedHttpRoute | ITypedWebSocketRoute>,
-    ): Promise<void> => {
-      // CONSTRUCT FOLDER TREE
-      const root: SdkRouteDirectory = new SdkRouteDirectory(null, "functional");
-      for (const route of routeList) emplace(root)(route);
-
-      // ITERATE FILES
-      await iterate(project)(root)(project.config.output + "/functional");
-    };
-
-  const emplace =
-    (directory: SdkRouteDirectory) =>
-    (route: ITypedHttpRoute | ITypedWebSocketRoute): void => {
-      // OPEN DIRECTORIES
-      for (const key of route.accessors.slice(0, -1)) {
-        directory = MapUtil.take(
-          directory.children,
-          key,
-          () => new SdkRouteDirectory(directory, key),
-        );
-      }
-
-      // ADD ROUTE
-      directory.routes.push(route);
-    };
-
-  /* ---------------------------------------------------------
-        FILE ITERATOR
-    --------------------------------------------------------- */
-  const iterate =
-    (project: INestiaProject) =>
-    (directory: SdkRouteDirectory) =>
-    async (outDir: string): Promise<void> => {
-      // CREATE A NEW DIRECTORY
-      try {
-        await fs.promises.mkdir(outDir);
-      } catch {}
-
-      // ITERATE CHILDREN
-      const statements: ts.Statement[] = [];
-      for (const [key, value] of directory.children) {
-        await iterate(project)(value)(`${outDir}/${key}`);
-        statements.push(
-          ts.factory.createExportDeclaration(
-            undefined,
-            false,
-            ts.factory.createNamespaceExport(ts.factory.createIdentifier(key)),
-            ts.factory.createStringLiteral(`./${key}`),
-            undefined,
-          ),
-        );
-      }
-      if (statements.length && directory.routes.length)
-        statements.push(FilePrinter.enter());
-
-      // ITERATE ROUTES
-      const importer: ImportDictionary = new ImportDictionary(
-        `${outDir}/index.ts`,
-      );
-      directory.routes.forEach((route, i) => {
-        if (project.config.clone !== true)
-          for (const tuple of route.imports)
-            for (const instance of tuple[1])
-              importer.internal({
-                file: tuple[0],
-                instance,
-                type: true,
-              });
-        statements.push(
-          ...(route.protocol === "http"
-            ? SdkHttpRouteProgrammer.write(project)(importer)(route)
-            : SdkWebSocketRouteProgrammer.write(project)(importer)(route)),
-        );
-        if (i !== directory.routes.length - 1)
-          statements.push(FilePrinter.enter());
-      });
-
-      // FINALIZE THE CONTENT
-      if (directory.routes.length !== 0)
-        statements.push(
-          ...importer.toStatements(outDir),
-          ...(!importer.empty() && statements.length
-            ? [FilePrinter.enter()]
-            : []),
-          ...statements.splice(0, statements.length),
-        );
-      await FilePrinter.write({
-        location: importer.file,
-        statements,
-        top:
-          "/**\n" +
-          " * @packageDocumentation\n" +
-          ` * @module ${directory.module}\n` +
-          " * @nestia Generated by Nestia - https://github.com/samchon/nestia \n" +
-          " */\n" +
-          "//================================================================\n",
-      });
-    };
-}
+import fs from "fs";
+import ts from "typescript";
+
+import { INestiaProject } from "../../structures/INestiaProject";
+import { ITypedHttpRoute } from "../../structures/ITypedHttpRoute";
+import { ITypedWebSocketRoute } from "../../structures/ITypedWebSocketRoute";
+import { MapUtil } from "../../utils/MapUtil";
+import { FilePrinter } from "./FilePrinter";
+import { ImportDictionary } from "./ImportDictionary";
+import { SdkHttpRouteProgrammer } from "./SdkHttpRouteProgrammer";
+import { SdkRouteDirectory } from "./SdkRouteDirectory";
+import { SdkWebSocketRouteProgrammer } from "./SdkWebSocketRouteProgrammer";
+
+export namespace SdkFileProgrammer {
+  /* ---------------------------------------------------------
+        CONSTRUCTOR
+    --------------------------------------------------------- */
+  export const generate =
+    (project: INestiaProject) =>
+    async (
+      routeList: Array<ITypedHttpRoute | ITypedWebSocketRoute>,
+    ): Promise<void> => {
+      // CONSTRUCT FOLDER TREE
+      const root: SdkRouteDirectory = new SdkRouteDirectory(null, "functional");
+      for (const route of routeList) emplace(root)(route);
+
+      // ITERATE FILES
+      await iterate(project)(root)(project.config.output + "/functional");
+    };
+
+  const emplace =
+    (directory: SdkRouteDirectory) =>
+    (route: ITypedHttpRoute | ITypedWebSocketRoute): void => {
+      // OPEN DIRECTORIES
+      for (const key of route.accessors.slice(0, -1)) {
+        directory = MapUtil.take(
+          directory.children,
+          key,
+          () => new SdkRouteDirectory(directory, key),
+        );
+      }
+
+      // ADD ROUTE
+      directory.routes.push(route);
+    };
+
+  /* ---------------------------------------------------------
+        FILE ITERATOR
+    --------------------------------------------------------- */
+  const iterate =
+    (project: INestiaProject) =>
+    (directory: SdkRouteDirectory) =>
+    async (outDir: string): Promise<void> => {
+      // CREATE A NEW DIRECTORY
+      try {
+        await fs.promises.mkdir(outDir);
+      } catch {}
+
+      // ITERATE CHILDREN
+      const statements: ts.Statement[] = [];
+      for (const [key, value] of directory.children) {
+        await iterate(project)(value)(`${outDir}/${key}`);
+        statements.push(
+          ts.factory.createExportDeclaration(
+            undefined,
+            false,
+            ts.factory.createNamespaceExport(ts.factory.createIdentifier(key)),
+            ts.factory.createStringLiteral(`./${key}`),
+            undefined,
+          ),
+        );
+      }
+      if (statements.length && directory.routes.length)
+        statements.push(FilePrinter.enter());
+
+      // ITERATE ROUTES
+      const importer: ImportDictionary = new ImportDictionary(
+        `${outDir}/index.ts`,
+      );
+      directory.routes.forEach((route, i) => {
+        if (project.config.clone !== true)
+          for (const tuple of route.imports)
+            for (const instance of tuple[1])
+              importer.internal({
+                file: tuple[0],
+                instance,
+                type: true,
+              });
+        statements.push(
+          ...(route.protocol === "http"
+            ? SdkHttpRouteProgrammer.write(project)(importer)(route)
+            : SdkWebSocketRouteProgrammer.write(project)(importer)(route)),
+        );
+        if (i !== directory.routes.length - 1)
+          statements.push(FilePrinter.enter());
+      });
+
+      // FINALIZE THE CONTENT
+      if (directory.routes.length !== 0)
+        statements.push(
+          ...importer.toStatements(outDir),
+          ...(!importer.empty() && statements.length
+            ? [FilePrinter.enter()]
+            : []),
+          ...statements.splice(0, statements.length),
+        );
+      await FilePrinter.write({
+        location: importer.file,
+        statements,
+        top:
+          "/**\n" +
+          " * @packageDocumentation\n" +
+          ` * @module ${directory.module}\n` +
+          " * @nestia Generated by Nestia - https://github.com/samchon/nestia \n" +
+          " */\n" +
+          "//================================================================\n",
+      });
+    };
+}

package/src/generates/internal/SdkHttpCloneProgrammer.ts

@@ -1,154 +1,154 @@
-import { IPointer } from "tstl";
-import ts from "typescript";
-import { IJsDocTagInfo } from "typia";
-import { MetadataCollection } from "typia/lib/factories/MetadataCollection";
-import { MetadataFactory } from "typia/lib/factories/MetadataFactory";
-import { MetadataAlias } from "typia/lib/schemas/metadata/MetadataAlias";
-import { MetadataAtomic } from "typia/lib/schemas/metadata/MetadataAtomic";
-import { MetadataObject } from "typia/lib/schemas/metadata/MetadataObject";
-
-import { INestiaProject } from "../../structures/INestiaProject";
-import { ITypedHttpRoute } from "../../structures/ITypedHttpRoute";
-import { MapUtil } from "../../utils/MapUtil";
-import { FilePrinter } from "./FilePrinter";
-import { ImportDictionary } from "./ImportDictionary";
-import { SdkTypeProgrammer } from "./SdkTypeProgrammer";
-
-export namespace SdkHttpCloneProgrammer {
-  export interface IModule {
-    name: string;
-    children: Map<string, IModule>;
-    programmer:
-      | null
-      | ((importer: ImportDictionary) => ts.TypeAliasDeclaration);
-  }
-
-  export const write =
-    (project: INestiaProject) =>
-    (routes: ITypedHttpRoute[]): Map<string, IModule> => {
-      const collection = new MetadataCollection({
-        replace: MetadataCollection.replace,
-      });
-      for (const r of routes) {
-        for (const p of r.parameters) {
-          const res = MetadataFactory.analyze(project.checker)({
-            escape: false,
-            constant: true,
-            absorb: false,
-          })(collection)(p.type);
-          if (res.success) p.metadata = res.data;
-        }
-        for (const e of Object.values(r.exceptions)) {
-          const res = MetadataFactory.analyze(project.checker)({
-            escape: true,
-            constant: true,
-            absorb: false,
-          })(collection)(e.type);
-          if (res.success) e.metadata = res.data;
-        }
-        const res = MetadataFactory.analyze(project.checker)({
-          escape: true,
-          constant: true,
-          absorb: false,
-        })(collection)(r.output.type);
-        if (res.success) r.output.metadata = res.data;
-      }
-
-      const dict: Map<string, IModule> = new Map();
-      for (const alias of collection.aliases())
-        if (isNamedDeclaration(alias.name))
-          prepare(dict)(alias.name)((importer) =>
-            write_alias(project)(importer)(alias),
-          );
-      for (const object of collection.objects())
-        if (isNamedDeclaration(object.name))
-          prepare(dict)(object.name)((importer) =>
-            write_object(project)(importer)(object),
-          );
-      return dict;
-    };
-
-  const prepare =
-    (dict: Map<string, IModule>) =>
-    (name: string) =>
-    (programmer: (importer: ImportDictionary) => ts.TypeAliasDeclaration) => {
-      const accessors: string[] = name.split(".");
-      const modulo: IPointer<IModule> = { value: null! };
-
-      accessors.forEach((acc, i) => {
-        modulo.value = MapUtil.take(dict, acc, () => ({
-          name: acc,
-          children: new Map(),
-          programmer: null,
-        }));
-        if (i === accessors.length - 1) modulo.value.programmer = programmer;
-        dict = modulo.value.children;
-      });
-      return modulo!;
-    };
-
-  const write_alias =
-    (project: INestiaProject) =>
-    (importer: ImportDictionary) =>
-    (alias: MetadataAlias): ts.TypeAliasDeclaration =>
-      FilePrinter.description(
-        ts.factory.createTypeAliasDeclaration(
-          [ts.factory.createToken(ts.SyntaxKind.ExportKeyword)],
-          alias.name.split(".").at(-1)!,
-          [],
-          SdkTypeProgrammer.write(project)(importer)(alias.value),
-        ),
-        writeComment([])(alias.description, alias.jsDocTags),
-      );
-
-  const write_object =
-    (project: INestiaProject) =>
-    (importer: ImportDictionary) =>
-    (object: MetadataObject): ts.TypeAliasDeclaration => {
-      return FilePrinter.description(
-        ts.factory.createTypeAliasDeclaration(
-          [ts.factory.createToken(ts.SyntaxKind.ExportKeyword)],
-          object.name.split(".").at(-1)!,
-          [],
-          SdkTypeProgrammer.write_object(project)(importer)(object),
-        ),
-        writeComment([])(object.description ?? null, object.jsDocTags),
-      );
-    };
-}
-
-const isNamedDeclaration = (name: string) =>
-  name !== "object" &&
-  name !== "__type" &&
-  !name.startsWith("__type.") &&
-  name !== "__object" &&
-  !name.startsWith("__object.");
-
-const writeComment =
-  (atomics: MetadataAtomic[]) =>
-  (description: string | null, jsDocTags: IJsDocTagInfo[]): string => {
-    const lines: string[] = [];
-    if (description?.length)
-      lines.push(...description.split("\n").map((s) => `${s}`));
-
-    const filtered: IJsDocTagInfo[] =
-      !!atomics.length && !!jsDocTags?.length
-        ? jsDocTags.filter(
-            (tag) =>
-              !atomics.some((a) =>
-                a.tags.some((r) => r.some((t) => t.kind === tag.name)),
-              ),
-          )
-        : jsDocTags ?? [];
-
-    if (description?.length && filtered.length) lines.push("");
-    if (filtered.length)
-      lines.push(
-        ...filtered.map((t) =>
-          t.text?.length
-            ? `@${t.name} ${t.text.map((e) => e.text).join("")}`
-            : `@${t.name}`,
-        ),
-      );
-    return lines.join("\n");
-  };
+import { IPointer } from "tstl";
+import ts from "typescript";
+import { IJsDocTagInfo } from "typia";
+import { MetadataCollection } from "typia/lib/factories/MetadataCollection";
+import { MetadataFactory } from "typia/lib/factories/MetadataFactory";
+import { MetadataAlias } from "typia/lib/schemas/metadata/MetadataAlias";
+import { MetadataAtomic } from "typia/lib/schemas/metadata/MetadataAtomic";
+import { MetadataObject } from "typia/lib/schemas/metadata/MetadataObject";
+
+import { INestiaProject } from "../../structures/INestiaProject";
+import { ITypedHttpRoute } from "../../structures/ITypedHttpRoute";
+import { MapUtil } from "../../utils/MapUtil";
+import { FilePrinter } from "./FilePrinter";
+import { ImportDictionary } from "./ImportDictionary";
+import { SdkTypeProgrammer } from "./SdkTypeProgrammer";
+
+export namespace SdkHttpCloneProgrammer {
+  export interface IModule {
+    name: string;
+    children: Map<string, IModule>;
+    programmer:
+      | null
+      | ((importer: ImportDictionary) => ts.TypeAliasDeclaration);
+  }
+
+  export const write =
+    (project: INestiaProject) =>
+    (routes: ITypedHttpRoute[]): Map<string, IModule> => {
+      const collection = new MetadataCollection({
+        replace: MetadataCollection.replace,
+      });
+      for (const r of routes) {
+        for (const p of r.parameters) {
+          const res = MetadataFactory.analyze(project.checker)({
+            escape: false,
+            constant: true,
+            absorb: false,
+          })(collection)(p.type);
+          if (res.success) p.metadata = res.data;
+        }
+        for (const e of Object.values(r.exceptions)) {
+          const res = MetadataFactory.analyze(project.checker)({
+            escape: true,
+            constant: true,
+            absorb: false,
+          })(collection)(e.type);
+          if (res.success) e.metadata = res.data;
+        }
+        const res = MetadataFactory.analyze(project.checker)({
+          escape: true,
+          constant: true,
+          absorb: false,
+        })(collection)(r.output.type);
+        if (res.success) r.output.metadata = res.data;
+      }
+
+      const dict: Map<string, IModule> = new Map();
+      for (const alias of collection.aliases())
+        if (isNamedDeclaration(alias.name))
+          prepare(dict)(alias.name)((importer) =>
+            write_alias(project)(importer)(alias),
+          );
+      for (const object of collection.objects())
+        if (isNamedDeclaration(object.name))
+          prepare(dict)(object.name)((importer) =>
+            write_object(project)(importer)(object),
+          );
+      return dict;
+    };
+
+  const prepare =
+    (dict: Map<string, IModule>) =>
+    (name: string) =>
+    (programmer: (importer: ImportDictionary) => ts.TypeAliasDeclaration) => {
+      const accessors: string[] = name.split(".");
+      const modulo: IPointer<IModule> = { value: null! };
+
+      accessors.forEach((acc, i) => {
+        modulo.value = MapUtil.take(dict, acc, () => ({
+          name: acc,
+          children: new Map(),
+          programmer: null,
+        }));
+        if (i === accessors.length - 1) modulo.value.programmer = programmer;
+        dict = modulo.value.children;
+      });
+      return modulo!;
+    };
+
+  const write_alias =
+    (project: INestiaProject) =>
+    (importer: ImportDictionary) =>
+    (alias: MetadataAlias): ts.TypeAliasDeclaration =>
+      FilePrinter.description(
+        ts.factory.createTypeAliasDeclaration(
+          [ts.factory.createToken(ts.SyntaxKind.ExportKeyword)],
+          alias.name.split(".").at(-1)!,
+          [],
+          SdkTypeProgrammer.write(project)(importer)(alias.value),
+        ),
+        writeComment([])(alias.description, alias.jsDocTags),
+      );
+
+  const write_object =
+    (project: INestiaProject) =>
+    (importer: ImportDictionary) =>
+    (object: MetadataObject): ts.TypeAliasDeclaration => {
+      return FilePrinter.description(
+        ts.factory.createTypeAliasDeclaration(
+          [ts.factory.createToken(ts.SyntaxKind.ExportKeyword)],
+          object.name.split(".").at(-1)!,
+          [],
+          SdkTypeProgrammer.write_object(project)(importer)(object),
+        ),
+        writeComment([])(object.description ?? null, object.jsDocTags),
+      );
+    };
+}
+
+const isNamedDeclaration = (name: string) =>
+  name !== "object" &&
+  name !== "__type" &&
+  !name.startsWith("__type.") &&
+  name !== "__object" &&
+  !name.startsWith("__object.");
+
+const writeComment =
+  (atomics: MetadataAtomic[]) =>
+  (description: string | null, jsDocTags: IJsDocTagInfo[]): string => {
+    const lines: string[] = [];
+    if (description?.length)
+      lines.push(...description.split("\n").map((s) => `${s}`));
+
+    const filtered: IJsDocTagInfo[] =
+      !!atomics.length && !!jsDocTags?.length
+        ? jsDocTags.filter(
+            (tag) =>
+              !atomics.some((a) =>
+                a.tags.some((r) => r.some((t) => t.kind === tag.name)),
+              ),
+          )
+        : jsDocTags ?? [];
+
+    if (description?.length && filtered.length) lines.push("");
+    if (filtered.length)
+      lines.push(
+        ...filtered.map((t) =>
+          t.text?.length
+            ? `@${t.name} ${t.text.map((e) => e.text).join("")}`
+            : `@${t.name}`,
+        ),
+      );
+    return lines.join("\n");
+  };