@nestia/sdk 2.4.3-dev.20231207 → 3.0.0-dev.20231209

package/src/generates/internal/SdkFileProgrammer.ts

@@ -1,106 +1,106 @@
-import fs from "fs";
-
-import { INestiaConfig } from "../../INestiaConfig";
-import { IRoute } from "../../structures/IRoute";
-import { ImportDictionary } from "../../utils/ImportDictionary";
-import { MapUtil } from "../../utils/MapUtil";
-import { SdkFunctionProgrammer } from "./SdkFunctionProgrammer";
-import { SdkRouteDirectory } from "./SdkRouteDirectory";
-
-export namespace SdkFileProgrammer {
-  /* ---------------------------------------------------------
-        CONSTRUCTOR
-    --------------------------------------------------------- */
-  export const generate =
-    (config: INestiaConfig) =>
-    async (routeList: IRoute[]): Promise<void> => {
-      // CONSTRUCT FOLDER TREE
-      const root: SdkRouteDirectory = new SdkRouteDirectory(null, "functional");
-      for (const route of routeList) emplace(root)(route);
-
-      // ITERATE FILES
-      await iterate(config)(root)(config.output + "/functional");
-    };
-
-  const emplace =
-    (directory: SdkRouteDirectory) =>
-    (route: IRoute): 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 =
-    (config: INestiaConfig) =>
-    (directory: SdkRouteDirectory) =>
-    async (outDir: string): Promise<void> => {
-      // CREATE A NEW DIRECTORY
-      try {
-        await fs.promises.mkdir(outDir);
-      } catch {}
-
-      // ITERATE CHILDREN
-      const content: string[] = [];
-      for (const [key, value] of directory.children) {
-        await iterate(config)(value)(`${outDir}/${key}`);
-        content.push(`export * as ${key} from "./${key}";`);
-      }
-      if (content.length && directory.routes.length) content.push("");
-
-      // ITERATE ROUTES
-      const importer: ImportDictionary = new ImportDictionary(
-        `${outDir}/index.ts`,
-      );
-      if (
-        config.simulate === true &&
-        directory.routes.some((r) => !!r.parameters.length)
-      )
-        importer.internal({
-          file: `${config.output}/utils/NestiaSimulator.ts`,
-          instance: "NestiaSimulator",
-          type: false,
-        });
-      directory.routes.forEach((route, i) => {
-        if (config.clone !== true)
-          for (const tuple of route.imports)
-            for (const instance of tuple[1])
-              importer.internal({
-                file: tuple[0],
-                instance,
-                type: true,
-              });
-
-        content.push(SdkFunctionProgrammer.generate(config)(importer)(route));
-        if (i !== directory.routes.length - 1) content.push("");
-      });
-
-      // FINALIZE THE CONTENT
-      if (directory.routes.length !== 0)
-        content.push(
-          importer.toScript(outDir),
-          "",
-          ...content.splice(0, content.length),
-        );
-
-      const script: string =
-        "/**\n" +
-        " * @packageDocumentation\n" +
-        ` * @module ${directory.module}\n` +
-        " * @nestia Generated by Nestia - https://github.com/samchon/nestia \n" +
-        " */\n" +
-        "//================================================================\n" +
-        content.join("\n");
-      await fs.promises.writeFile(importer.file, script, "utf8");
-    };
-}
+import fs from "fs";
+
+import { INestiaConfig } from "../../INestiaConfig";
+import { IRoute } from "../../structures/IRoute";
+import { ImportDictionary } from "../../utils/ImportDictionary";
+import { MapUtil } from "../../utils/MapUtil";
+import { SdkFunctionProgrammer } from "./SdkFunctionProgrammer";
+import { SdkRouteDirectory } from "./SdkRouteDirectory";
+
+export namespace SdkFileProgrammer {
+  /* ---------------------------------------------------------
+        CONSTRUCTOR
+    --------------------------------------------------------- */
+  export const generate =
+    (config: INestiaConfig) =>
+    async (routeList: IRoute[]): Promise<void> => {
+      // CONSTRUCT FOLDER TREE
+      const root: SdkRouteDirectory = new SdkRouteDirectory(null, "functional");
+      for (const route of routeList) emplace(root)(route);
+
+      // ITERATE FILES
+      await iterate(config)(root)(config.output + "/functional");
+    };
+
+  const emplace =
+    (directory: SdkRouteDirectory) =>
+    (route: IRoute): 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 =
+    (config: INestiaConfig) =>
+    (directory: SdkRouteDirectory) =>
+    async (outDir: string): Promise<void> => {
+      // CREATE A NEW DIRECTORY
+      try {
+        await fs.promises.mkdir(outDir);
+      } catch {}
+
+      // ITERATE CHILDREN
+      const content: string[] = [];
+      for (const [key, value] of directory.children) {
+        await iterate(config)(value)(`${outDir}/${key}`);
+        content.push(`export * as ${key} from "./${key}";`);
+      }
+      if (content.length && directory.routes.length) content.push("");
+
+      // ITERATE ROUTES
+      const importer: ImportDictionary = new ImportDictionary(
+        `${outDir}/index.ts`,
+      );
+      if (
+        config.simulate === true &&
+        directory.routes.some((r) => !!r.parameters.length)
+      )
+        importer.internal({
+          file: `${config.output}/utils/NestiaSimulator.ts`,
+          instance: "NestiaSimulator",
+          type: false,
+        });
+      directory.routes.forEach((route, i) => {
+        if (config.clone !== true)
+          for (const tuple of route.imports)
+            for (const instance of tuple[1])
+              importer.internal({
+                file: tuple[0],
+                instance,
+                type: true,
+              });
+
+        content.push(SdkFunctionProgrammer.generate(config)(importer)(route));
+        if (i !== directory.routes.length - 1) content.push("");
+      });
+
+      // FINALIZE THE CONTENT
+      if (directory.routes.length !== 0)
+        content.push(
+          importer.toScript(outDir),
+          "",
+          ...content.splice(0, content.length),
+        );
+
+      const script: string =
+        "/**\n" +
+        " * @packageDocumentation\n" +
+        ` * @module ${directory.module}\n` +
+        " * @nestia Generated by Nestia - https://github.com/samchon/nestia \n" +
+        " */\n" +
+        "//================================================================\n" +
+        content.join("\n");
+      await fs.promises.writeFile(importer.file, script, "utf8");
+    };
+}

package/src/generates/internal/SdkFunctionProgrammer.ts

@@ -56,7 +56,7 @@ export namespace SdkFunctionProgrammer {
       const contentType: string | undefined =
         props.input !== undefined
           ? (props.input as IController.IBodyParameter).encrypted
-            ? "text/plain"
+            ? "application/octet-stream"
             : (props.input as IController.IBodyParameter).contentType ??
               "application/json"
           : undefined;
@@ -359,7 +359,7 @@ export namespace SdkFunctionProgrammer {
                 `request: {`,
                 `    type: "${
                   (props.input as IController.IBodyParameter).encrypted
-                    ? "text/plain"
+                    ? "application/octet-stream"
                     : (props.input as IController.IBodyParameter).contentType ??
                       "application/json"
                 }",`,

package/src/generates/internal/SdkImportWizard.ts

@@ -1,55 +1,55 @@
-import { ImportDictionary } from "../../utils/ImportDictionary";
-
-export namespace SdkImportWizard {
-  export const Fetcher = (encrypted: boolean) =>
-    encrypted ? EncryptedFetcher : PlainFetcher;
-
-  export const HttpError = (importer: ImportDictionary) =>
-    importer.external({
-      type: true,
-      library: "@nestia/fetcher",
-      instance: "HttpError",
-    });
-
-  export const IConnection = (importer: ImportDictionary) =>
-    importer.external({
-      type: true,
-      library: "@nestia/fetcher",
-      instance: "IConnection",
-    });
-
-  export const Primitive = (importer: ImportDictionary) =>
-    importer.external({
-      type: true,
-      library: "@nestia/fetcher",
-      instance: "Primitive",
-    });
-
-  export const Resolved = (importer: ImportDictionary) =>
-    importer.external({
-      type: true,
-      library: "@nestia/fetcher",
-      instance: "Resolved",
-    });
-
-  export const typia = (importer: ImportDictionary) =>
-    importer.external({
-      type: false,
-      library: "typia",
-      instance: null,
-    });
-}
-
-const PlainFetcher = (importer: ImportDictionary) =>
-  importer.external({
-    type: false,
-    library: "@nestia/fetcher/lib/PlainFetcher",
-    instance: "PlainFetcher",
-  });
-
-const EncryptedFetcher = (importer: ImportDictionary) =>
-  importer.external({
-    type: false,
-    library: "@nestia/fetcher/lib/EncryptedFetcher",
-    instance: "EncryptedFetcher",
-  });
+import { ImportDictionary } from "../../utils/ImportDictionary";
+
+export namespace SdkImportWizard {
+  export const Fetcher = (encrypted: boolean) =>
+    encrypted ? EncryptedFetcher : PlainFetcher;
+
+  export const HttpError = (importer: ImportDictionary) =>
+    importer.external({
+      type: true,
+      library: "@nestia/fetcher",
+      instance: "HttpError",
+    });
+
+  export const IConnection = (importer: ImportDictionary) =>
+    importer.external({
+      type: true,
+      library: "@nestia/fetcher",
+      instance: "IConnection",
+    });
+
+  export const Primitive = (importer: ImportDictionary) =>
+    importer.external({
+      type: true,
+      library: "@nestia/fetcher",
+      instance: "Primitive",
+    });
+
+  export const Resolved = (importer: ImportDictionary) =>
+    importer.external({
+      type: true,
+      library: "@nestia/fetcher",
+      instance: "Resolved",
+    });
+
+  export const typia = (importer: ImportDictionary) =>
+    importer.external({
+      type: false,
+      library: "typia",
+      instance: null,
+    });
+}
+
+const PlainFetcher = (importer: ImportDictionary) =>
+  importer.external({
+    type: false,
+    library: "@nestia/fetcher/lib/PlainFetcher",
+    instance: "PlainFetcher",
+  });
+
+const EncryptedFetcher = (importer: ImportDictionary) =>
+  importer.external({
+    type: false,
+    library: "@nestia/fetcher/lib/EncryptedFetcher",
+    instance: "EncryptedFetcher",
+  });

package/src/generates/internal/SdkRouteDirectory.ts

@@ -1,17 +1,17 @@
-import { IRoute } from "../../structures/IRoute";
-
-export class SdkRouteDirectory {
-  public readonly module: string;
-  public readonly children: Map<string, SdkRouteDirectory>;
-  public readonly routes: IRoute[];
-
-  public constructor(
-    readonly parent: SdkRouteDirectory | null,
-    readonly name: string,
-  ) {
-    this.children = new Map();
-    this.routes = [];
-    this.module =
-      this.parent !== null ? `${this.parent.module}.${name}` : `api.${name}`;
-  }
-}
+import { IRoute } from "../../structures/IRoute";
+
+export class SdkRouteDirectory {
+  public readonly module: string;
+  public readonly children: Map<string, SdkRouteDirectory>;
+  public readonly routes: IRoute[];
+
+  public constructor(
+    readonly parent: SdkRouteDirectory | null,
+    readonly name: string,
+  ) {
+    this.children = new Map();
+    this.routes = [];
+    this.module =
+      this.parent !== null ? `${this.parent.module}.${name}` : `api.${name}`;
+  }
+}

package/src/generates/internal/SdkSimulationProgrammer.ts

@@ -1,133 +1,133 @@
-import { INestiaConfig } from "../../INestiaConfig";
-import { IRoute } from "../../structures/IRoute";
-import { ImportDictionary } from "../../utils/ImportDictionary";
-import { SdkImportWizard } from "./SdkImportWizard";
-import { SdkTypeDefiner } from "./SdkTypeDefiner";
-
-export namespace SdkSimulationProgrammer {
-  export const generate =
-    (config: INestiaConfig) =>
-    (importer: ImportDictionary) =>
-    (route: IRoute): string => {
-      const output: boolean =
-        config.propagate === true || route.output.typeName !== "void";
-      const body: string[] = [
-        ...(route.parameters.filter((p) => p.category !== "headers").length !==
-        0
-          ? assert(config)(importer)(route)
-          : []),
-        ...(output ? returns(config)(route) : []),
-      ];
-      return [
-        `export const simulate = async (`,
-        `    ${
-          route.parameters.filter((p) => p.category !== "headers").length ===
-            0 && route.output.typeName === "void"
-            ? "_connection"
-            : "connection"
-        }: ${
-          route.parameters.some(
-            (p) => p.category === "headers" && p.field === undefined,
-          )
-            ? `${SdkImportWizard.IConnection(importer)}<${route.name}.Headers>`
-            : SdkImportWizard.IConnection(importer)
-        },`,
-        ...route.parameters
-          .filter((p) => p.category !== "headers")
-          .map(
-            (p) =>
-              `    ${p.name}: ${
-                p.category === "query" || p.category === "body"
-                  ? `${route.name}.${
-                      p.category === "query" ? "Query" : "Input"
-                    }`
-                  : SdkTypeDefiner.name(config)(importer)(p)
-              },`,
-          ),
-        `): Promise<${output ? "Output" : "void"}> => {`,
-        ...body.map((l) => `    ${l}`),
-        `}`,
-      ]
-        .map((line) => `    ${line}`)
-        .join("\n");
-    };
-
-  const assert =
-    (config: INestiaConfig) =>
-    (importer: ImportDictionary) =>
-    (route: IRoute): string[] => {
-      const typia = SdkImportWizard.typia(importer);
-      const func: string[] = [
-        `const assert = ${importer.internal({
-          file: `${config.output}/utils/NestiaSimulator.ts`,
-          instance: "NestiaSimulator",
-          type: false,
-        })}.assert({`,
-        `    method: METADATA.method,`,
-        `    host: connection.host,`,
-        `    path: path(${route.parameters
-          .filter((p) => p.category === "param" || p.category === "query")
-          .map((p) => p.name)
-          .join(", ")}),`,
-        `    contentType: ${JSON.stringify(route.output.contentType)},`,
-        `});`,
-      ];
-      const individual: string[] = route.parameters
-        .filter((p) => p.category !== "headers")
-        .map((p) =>
-          p.category === "body"
-            ? `assert.body(() => ${typia}.assert(${p.name}));`
-            : p.category === "query"
-            ? `assert.query(() => ${typia}.assert(${p.name}));`
-            : p.category === "headers"
-            ? `assert.headers(() => ${typia}.assert(connection.headers);`
-            : `assert.param("${p.field}")(() => ${typia}.assert(${p.name}));`,
-        );
-      if (config.propagate !== true) return [...func, ...individual];
-
-      return [
-        ...func,
-        `try {`,
-        ...individual.map((l) => `    ${l}`),
-        `} catch (exp) {`,
-        `    if (!${typia}.is<${SdkImportWizard.HttpError(
-          importer,
-        )}>(exp)) throw exp;`,
-        `    return {`,
-        `        success: false,`,
-        `        status: exp.status,`,
-        `        headers: exp.headers,`,
-        `        data: exp.toJSON().message,`,
-        `    } as any;`,
-        `}`,
-      ];
-    };
-
-  const returns =
-    (config: INestiaConfig) =>
-    (route: IRoute): string[] => {
-      const random = (prefix: string, postfix: string) =>
-        route.output.typeName === "void"
-          ? [`${prefix} undefined${postfix}`]
-          : [
-              `${prefix} random(`,
-              `    typeof connection.simulate === 'object' &&`,
-              `        connection.simulate !== null`,
-              `        ? connection.simulate`,
-              `        : undefined`,
-              `)${postfix}`,
-            ];
-      if (config.propagate !== true) return random("return", ";");
-
-      return [
-        `return {`,
-        `    success: true,`,
-        `    status: ${route.status ?? (route.method === "POST" ? 201 : 200)},`,
-        `    headers: {`,
-        `        "Content-Type": "${route.output.contentType}",`,
-        `    },`,
-        ...random("data:", ",").map((r) => `    ${r}`),
-        `}`,
-      ];
-    };
-}
+import { INestiaConfig } from "../../INestiaConfig";
+import { IRoute } from "../../structures/IRoute";
+import { ImportDictionary } from "../../utils/ImportDictionary";
+import { SdkImportWizard } from "./SdkImportWizard";
+import { SdkTypeDefiner } from "./SdkTypeDefiner";
+
+export namespace SdkSimulationProgrammer {
+  export const generate =
+    (config: INestiaConfig) =>
+    (importer: ImportDictionary) =>
+    (route: IRoute): string => {
+      const output: boolean =
+        config.propagate === true || route.output.typeName !== "void";
+      const body: string[] = [
+        ...(route.parameters.filter((p) => p.category !== "headers").length !==
+        0
+          ? assert(config)(importer)(route)
+          : []),
+        ...(output ? returns(config)(route) : []),
+      ];
+      return [
+        `export const simulate = async (`,
+        `    ${
+          route.parameters.filter((p) => p.category !== "headers").length ===
+            0 && route.output.typeName === "void"
+            ? "_connection"
+            : "connection"
+        }: ${
+          route.parameters.some(
+            (p) => p.category === "headers" && p.field === undefined,
+          )
+            ? `${SdkImportWizard.IConnection(importer)}<${route.name}.Headers>`
+            : SdkImportWizard.IConnection(importer)
+        },`,
+        ...route.parameters
+          .filter((p) => p.category !== "headers")
+          .map(
+            (p) =>
+              `    ${p.name}: ${
+                p.category === "query" || p.category === "body"
+                  ? `${route.name}.${
+                      p.category === "query" ? "Query" : "Input"
+                    }`
+                  : SdkTypeDefiner.name(config)(importer)(p)
+              },`,
+          ),
+        `): Promise<${output ? "Output" : "void"}> => {`,
+        ...body.map((l) => `    ${l}`),
+        `}`,
+      ]
+        .map((line) => `    ${line}`)
+        .join("\n");
+    };
+
+  const assert =
+    (config: INestiaConfig) =>
+    (importer: ImportDictionary) =>
+    (route: IRoute): string[] => {
+      const typia = SdkImportWizard.typia(importer);
+      const func: string[] = [
+        `const assert = ${importer.internal({
+          file: `${config.output}/utils/NestiaSimulator.ts`,
+          instance: "NestiaSimulator",
+          type: false,
+        })}.assert({`,
+        `    method: METADATA.method,`,
+        `    host: connection.host,`,
+        `    path: path(${route.parameters
+          .filter((p) => p.category === "param" || p.category === "query")
+          .map((p) => p.name)
+          .join(", ")}),`,
+        `    contentType: ${JSON.stringify(route.output.contentType)},`,
+        `});`,
+      ];
+      const individual: string[] = route.parameters
+        .filter((p) => p.category !== "headers")
+        .map((p) =>
+          p.category === "body"
+            ? `assert.body(() => ${typia}.assert(${p.name}));`
+            : p.category === "query"
+            ? `assert.query(() => ${typia}.assert(${p.name}));`
+            : p.category === "headers"
+            ? `assert.headers(() => ${typia}.assert(connection.headers);`
+            : `assert.param("${p.field}")(() => ${typia}.assert(${p.name}));`,
+        );
+      if (config.propagate !== true) return [...func, ...individual];
+
+      return [
+        ...func,
+        `try {`,
+        ...individual.map((l) => `    ${l}`),
+        `} catch (exp) {`,
+        `    if (!${typia}.is<${SdkImportWizard.HttpError(
+          importer,
+        )}>(exp)) throw exp;`,
+        `    return {`,
+        `        success: false,`,
+        `        status: exp.status,`,
+        `        headers: exp.headers,`,
+        `        data: exp.toJSON().message,`,
+        `    } as any;`,
+        `}`,
+      ];
+    };
+
+  const returns =
+    (config: INestiaConfig) =>
+    (route: IRoute): string[] => {
+      const random = (prefix: string, postfix: string) =>
+        route.output.typeName === "void"
+          ? [`${prefix} undefined${postfix}`]
+          : [
+              `${prefix} random(`,
+              `    typeof connection.simulate === 'object' &&`,
+              `        connection.simulate !== null`,
+              `        ? connection.simulate`,
+              `        : undefined`,
+              `)${postfix}`,
+            ];
+      if (config.propagate !== true) return random("return", ";");
+
+      return [
+        `return {`,
+        `    success: true,`,
+        `    status: ${route.status ?? (route.method === "POST" ? 201 : 200)},`,
+        `    headers: {`,
+        `        "Content-Type": "${route.output.contentType}",`,
+        `    },`,
+        ...random("data:", ",").map((r) => `    ${r}`),
+        `}`,
+      ];
+    };
+}