@nestia/sdk 10.0.2 → 11.0.0-dev.20260312

package/src/generates/internal/SdkFileProgrammer.ts

@@ -1,110 +1,110 @@
-import fs from "fs";
-import ts from "typescript";
-
-import { INestiaProject } from "../../structures/INestiaProject";
-import { ITypedApplication } from "../../structures/ITypedApplication";
-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 = async (app: ITypedApplication): Promise<void> => {
-    // CONSTRUCT FOLDER TREE
-    const root: SdkRouteDirectory = new SdkRouteDirectory(null, "functional");
-    for (const route of app.routes) emplace(root)(route);
-
-    // ITERATE FILES
-    await iterate(app.project)(root)(`${app.project.config.output}/functional`);
-  };
-
-  const emplace =
-    (directory: SdkRouteDirectory) =>
-    (route: ITypedHttpRoute | ITypedWebSocketRoute): void => {
-      // OPEN DIRECTORIES
-      for (const key of route.accessor.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}/index`),
-            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 && route.protocol === "http"))
-          importer.declarations(route.imports);
-        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 { ITypedApplication } from "../../structures/ITypedApplication";
+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 = async (app: ITypedApplication): Promise<void> => {
+    // CONSTRUCT FOLDER TREE
+    const root: SdkRouteDirectory = new SdkRouteDirectory(null, "functional");
+    for (const route of app.routes) emplace(root)(route);
+
+    // ITERATE FILES
+    await iterate(app.project)(root)(`${app.project.config.output}/functional`);
+  };
+
+  const emplace =
+    (directory: SdkRouteDirectory) =>
+    (route: ITypedHttpRoute | ITypedWebSocketRoute): void => {
+      // OPEN DIRECTORIES
+      for (const key of route.accessor.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}/index`),
+            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 && route.protocol === "http"))
+          importer.declarations(route.imports);
+        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,124 +1,126 @@
-import { IPointer } from "tstl";
-import ts from "typescript";
-import { IJsDocTagInfo } from "typia";
-import { MetadataAliasType } from "typia/lib/schemas/metadata/MetadataAliasType";
-import { MetadataAtomic } from "typia/lib/schemas/metadata/MetadataAtomic";
-import { MetadataObjectType } from "typia/lib/schemas/metadata/MetadataObjectType";
-
-import { INestiaProject } from "../../structures/INestiaProject";
-import { ITypedApplication } from "../../structures/ITypedApplication";
-import { MapUtil } from "../../utils/MapUtil";
-import { StringUtil } from "../../utils/StringUtil";
-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 = (app: ITypedApplication): Map<string, IModule> => {
-    // COMPOSE THE DICTIONARY
-    const dict: Map<string, IModule> = new Map();
-    for (const [k, v] of app.collection.objects.entries())
-      if (StringUtil.isImplicit(k) === false)
-        prepare({
-          dict,
-          name: k,
-          programmer: (importer) => writeObject(app.project)(importer)(v),
-        });
-    for (const [k, v] of app.collection.aliases.entries())
-      if (StringUtil.isImplicit(k) === false)
-        prepare({
-          dict,
-          name: k,
-          programmer: (importer) => writeAlias(app.project)(importer)(v),
-        });
-    return dict;
-  };
-
-  const prepare = (props: {
-    dict: Map<string, IModule>;
-    name: string;
-    programmer: (importer: ImportDictionary) => ts.TypeAliasDeclaration;
-  }) => {
-    let next: Map<string, IModule> = props.dict;
-    const accessors: string[] = props.name.split(".");
-    const modulo: IPointer<IModule> = { value: null! };
-
-    accessors.forEach((acc, i) => {
-      modulo.value = MapUtil.take(next, acc, () => ({
-        name: acc,
-        children: new Map(),
-        programmer: null,
-      }));
-      if (i === accessors.length - 1)
-        modulo.value.programmer = props.programmer;
-      next = modulo.value.children;
-    });
-    return modulo!;
-  };
-
-  const writeAlias =
-    (project: INestiaProject) =>
-    (importer: ImportDictionary) =>
-    (alias: MetadataAliasType): 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 writeObject =
-    (project: INestiaProject) =>
-    (importer: ImportDictionary) =>
-    (object: MetadataObjectType): 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 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 {
+  MetadataAliasType,
+  MetadataAtomic,
+  MetadataObjectType,
+} from "@typia/core";
+import { IPointer } from "tstl";
+import ts from "typescript";
+import { IJsDocTagInfo } from "typia";
+
+import { INestiaProject } from "../../structures/INestiaProject";
+import { ITypedApplication } from "../../structures/ITypedApplication";
+import { MapUtil } from "../../utils/MapUtil";
+import { StringUtil } from "../../utils/StringUtil";
+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 = (app: ITypedApplication): Map<string, IModule> => {
+    // COMPOSE THE DICTIONARY
+    const dict: Map<string, IModule> = new Map();
+    for (const [k, v] of app.collection.objects.entries())
+      if (StringUtil.isImplicit(k) === false)
+        prepare({
+          dict,
+          name: k,
+          programmer: (importer) => writeObject(app.project)(importer)(v),
+        });
+    for (const [k, v] of app.collection.aliases.entries())
+      if (StringUtil.isImplicit(k) === false)
+        prepare({
+          dict,
+          name: k,
+          programmer: (importer) => writeAlias(app.project)(importer)(v),
+        });
+    return dict;
+  };
+
+  const prepare = (props: {
+    dict: Map<string, IModule>;
+    name: string;
+    programmer: (importer: ImportDictionary) => ts.TypeAliasDeclaration;
+  }) => {
+    let next: Map<string, IModule> = props.dict;
+    const accessors: string[] = props.name.split(".");
+    const modulo: IPointer<IModule> = { value: null! };
+
+    accessors.forEach((acc, i) => {
+      modulo.value = MapUtil.take(next, acc, () => ({
+        name: acc,
+        children: new Map(),
+        programmer: null,
+      }));
+      if (i === accessors.length - 1)
+        modulo.value.programmer = props.programmer;
+      next = modulo.value.children;
+    });
+    return modulo!;
+  };
+
+  const writeAlias =
+    (project: INestiaProject) =>
+    (importer: ImportDictionary) =>
+    (alias: MetadataAliasType): 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 writeObject =
+    (project: INestiaProject) =>
+    (importer: ImportDictionary) =>
+    (object: MetadataObjectType): 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 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");
+  };

package/src/generates/internal/SdkHttpCloneReferencer.ts

@@ -1,77 +1,77 @@
-import { Metadata } from "typia/lib/schemas/metadata/Metadata";
-
-import { IReflectType } from "../../structures/IReflectType";
-import { ITypedApplication } from "../../structures/ITypedApplication";
-import { ITypedHttpRoute } from "../../structures/ITypedHttpRoute";
-import { StringUtil } from "../../utils/StringUtil";
-import { SdkHttpParameterProgrammer } from "./SdkHttpParameterProgrammer";
-
-export namespace SdkHttpCloneReferencer {
-  export const replace = (app: ITypedApplication): void => {
-    const directory: string = `${app.project.config.output}/structures`;
-    for (const route of app.routes)
-      if (route.protocol === "http")
-        visitRoute({
-          directory,
-          route,
-        });
-  };
-
-  const visitRoute = (props: {
-    directory: string;
-    route: ITypedHttpRoute;
-  }): void => {
-    const unique: Set<string> = new Set();
-    for (const p of SdkHttpParameterProgrammer.getSignificant(
-      props.route,
-      true,
-    ))
-      visitType({
-        unique,
-        metadata: p.metadata,
-        type: p.type,
-        name: (name) => (p.type = { name }),
-      });
-    for (const v of Object.values(props.route.exceptions))
-      visitType({
-        unique,
-        metadata: v.metadata,
-        type: v.type,
-        name: (name) => (v.type = { name }),
-      });
-    visitType({
-      unique,
-      metadata: props.route.success.metadata,
-      type: props.route.success.type,
-      name: (name) => (props.route.success.type = { name }),
-    });
-    props.route.imports = Array.from(unique).map((str) => ({
-      file: `${props.directory}/${str}`,
-      asterisk: null,
-      default: null,
-      elements: [str],
-    }));
-  };
-
-  const visitType = (p: {
-    unique: Set<string>;
-    metadata: Metadata;
-    type: IReflectType;
-    name: (key: string) => void;
-  }): void => {
-    const enroll = (key: string) => {
-      if (key.length && StringUtil.isImplicit(key) === false)
-        p.unique.add(key.split(".")[0]);
-    };
-    for (const alias of p.metadata.aliases) enroll(alias.type.name);
-    for (const array of p.metadata.arrays) enroll(array.type.name);
-    for (const tuple of p.metadata.tuples) enroll(tuple.type.name);
-    for (const object of p.metadata.objects) enroll(object.type.name);
-    p.name(p.metadata.getName());
-  };
-}
-
-const getFullText = (type: IReflectType): string =>
-  type.typeArguments === undefined
-    ? type.name
-    : `${type.name}<${type.typeArguments.map(getFullText).join(", ")}>`;
+import { MetadataSchema } from "@typia/core";
+
+import { IReflectType } from "../../structures/IReflectType";
+import { ITypedApplication } from "../../structures/ITypedApplication";
+import { ITypedHttpRoute } from "../../structures/ITypedHttpRoute";
+import { StringUtil } from "../../utils/StringUtil";
+import { SdkHttpParameterProgrammer } from "./SdkHttpParameterProgrammer";
+
+export namespace SdkHttpCloneReferencer {
+  export const replace = (app: ITypedApplication): void => {
+    const directory: string = `${app.project.config.output}/structures`;
+    for (const route of app.routes)
+      if (route.protocol === "http")
+        visitRoute({
+          directory,
+          route,
+        });
+  };
+
+  const visitRoute = (props: {
+    directory: string;
+    route: ITypedHttpRoute;
+  }): void => {
+    const unique: Set<string> = new Set();
+    for (const p of SdkHttpParameterProgrammer.getSignificant(
+      props.route,
+      true,
+    ))
+      visitType({
+        unique,
+        metadata: p.metadata,
+        type: p.type,
+        name: (name) => (p.type = { name }),
+      });
+    for (const v of Object.values(props.route.exceptions))
+      visitType({
+        unique,
+        metadata: v.metadata,
+        type: v.type,
+        name: (name) => (v.type = { name }),
+      });
+    visitType({
+      unique,
+      metadata: props.route.success.metadata,
+      type: props.route.success.type,
+      name: (name) => (props.route.success.type = { name }),
+    });
+    props.route.imports = Array.from(unique).map((str) => ({
+      file: `${props.directory}/${str}`,
+      asterisk: null,
+      default: null,
+      elements: [str],
+    }));
+  };
+
+  const visitType = (p: {
+    unique: Set<string>;
+    metadata: MetadataSchema;
+    type: IReflectType;
+    name: (key: string) => void;
+  }): void => {
+    const enroll = (key: string) => {
+      if (key.length && StringUtil.isImplicit(key) === false)
+        p.unique.add(key.split(".")[0]!);
+    };
+    for (const alias of p.metadata.aliases) enroll(alias.type.name);
+    for (const array of p.metadata.arrays) enroll(array.type.name);
+    for (const tuple of p.metadata.tuples) enroll(tuple.type.name);
+    for (const object of p.metadata.objects) enroll(object.type.name);
+    p.name(p.metadata.getName());
+  };
+}
+
+const getFullText = (type: IReflectType): string =>
+  type.typeArguments === undefined
+    ? type.name
+    : `${type.name}<${type.typeArguments.map(getFullText).join(", ")}>`;