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

package/src/generates/internal/SdkDistributionComposer.ts

@@ -1,116 +1,123 @@
-import cp from "child_process";
-import fs from "fs";
-import path from "path";
-
-import { INestiaConfig } from "../../INestiaConfig";
-
-export namespace SdkDistributionComposer {
-  export const compose = async (props: {
-    config: INestiaConfig;
-    websocket: boolean;
-  }) => {
-    if (!fs.existsSync(props.config.distribute!))
-      await fs.promises.mkdir(props.config.distribute!);
-
-    const root: string = process.cwd();
-    const output: string = path.resolve(props.config.output!);
-    process.chdir(props.config.distribute!);
-
-    const exit = () => process.chdir(root);
-    if (await configured()) return exit();
-
-    // COPY FILES
-    console.log("Composing SDK distribution environments...");
-    for (const file of await fs.promises.readdir(BUNDLE))
-      await fs.promises.copyFile(`${BUNDLE}/${file}`, file);
-
-    // CONFIGURE PATHS
-    for (const file of ["package.json", "tsconfig.json"])
-      await replace({ root, output })(file);
-
-    // INSTALL PACKAGES
-    const v: IDependencies = await dependencies({ websocket: props.websocket });
-    execute("npm install --save-dev rimraf");
-    execute(`npm install --save @nestia/fetcher@${v.version}`);
-    execute(`npm install --save typia@${v.typia}`);
-    if (props.websocket && v.tgrid !== undefined)
-      execute(`npm install --save tgrid@${v.tgrid}`);
-    execute("npx typia setup --manager npm");
-
-    exit();
-  };
-
-  const configured = async (): Promise<boolean> =>
-    ["package.json", "tsconfig.json"].every(fs.existsSync) &&
-    (await (async () => {
-      const content = JSON.parse(
-        await fs.promises.readFile("package.json", "utf8"),
-      );
-      return !!content.dependencies?.["@nestia/fetcher"];
-    })());
-
-  const execute = (command: string) => {
-    console.log(`  - ${command}`);
-    cp.execSync(command, { stdio: "ignore" });
-  };
-
-  const replace =
-    (props: { root: string; output: string }) =>
-    async (file: string): Promise<void> => {
-      const relative = (from: string) => (to: string) =>
-        path.relative(from, to).split("\\").join("/");
-      const root: string = relative(process.cwd())(props.root);
-      const output: string = relative(process.cwd())(props.output);
-      const current: string = relative(props.root)(process.cwd());
-
-      const content: string = await fs.promises.readFile(file, "utf8");
-      await fs.promises.writeFile(
-        file,
-        content
-          .split("${root}")
-          .join(root)
-          .split("${output}")
-          .join(output)
-          .split("${current}")
-          .join(current),
-        "utf8",
-      );
-    };
-
-  const dependencies = async (opts: {
-    websocket: boolean;
-  }): Promise<IDependencies> => {
-    const content: string = await fs.promises.readFile(
-      __dirname + "/../../../package.json",
-      "utf8",
-    );
-    const json: {
-      version: string;
-      dependencies: Record<string, string>;
-      devDependencies: Record<string, string>;
-    } = JSON.parse(content);
-    const dependencies: Record<string, string> = {
-      ...json.devDependencies,
-      ...json.dependencies,
-    };
-    const required = (key: "version" | "typia"): string => {
-      const value: string | undefined =
-        key === "version" ? json.version : dependencies[key];
-      if (typeof value !== "string" || value.length === 0)
-        throw new Error(`Unable to resolve ${key} version for SDK distribution.`);
-      return value;
-    };
-    return {
-      version: required("version"),
-      typia: required("typia"),
-      tgrid: opts.websocket ? dependencies.tgrid : undefined,
-    };
-  };
-}
-
-interface IDependencies {
-  version: string;
-  typia: string;
-  tgrid: string | undefined;
-}
-const BUNDLE = __dirname + "/../../../assets/bundle/distribute";
+import cp from "child_process";
+import fs from "fs";
+import path from "path";
+
+import { INestiaConfig } from "../../INestiaConfig";
+
+export namespace SdkDistributionComposer {
+  export const compose = async (props: {
+    config: INestiaConfig;
+    mcp: boolean;
+    websocket: boolean;
+  }) => {
+    if (!fs.existsSync(props.config.distribute!))
+      await fs.promises.mkdir(props.config.distribute!);
+
+    const root: string = process.cwd();
+    const output: string = path.resolve(props.config.output!);
+    process.chdir(props.config.distribute!);
+
+    const exit = () => process.chdir(root);
+    if (await configured()) return exit();
+
+    // COPY FILES
+    console.log("Composing SDK distribution environments...");
+    for (const file of await fs.promises.readdir(BUNDLE))
+      await fs.promises.copyFile(`${BUNDLE}/${file}`, file);
+
+    // CONFIGURE PATHS
+    for (const file of ["package.json", "tsconfig.json"])
+      await replace({ root, output })(file);
+
+    // INSTALL PACKAGES
+    const v: IDependencies = await dependencies({ websocket: props.websocket });
+    execute("npm install --save-dev rimraf");
+    execute(`npm install --save @nestia/fetcher@${v.version}`);
+    execute(`npm install --save typia@${v.typia}`);
+    if (props.mcp && v.mcp !== undefined)
+      execute(`npm install --save @modelcontextprotocol/sdk@${v.mcp}`);
+    if (props.websocket && v.tgrid !== undefined)
+      execute(`npm install --save tgrid@${v.tgrid}`);
+    execute("npx typia setup --manager npm");
+
+    exit();
+  };
+
+  const configured = async (): Promise<boolean> =>
+    ["package.json", "tsconfig.json"].every(fs.existsSync) &&
+    (await (async () => {
+      const content = JSON.parse(
+        await fs.promises.readFile("package.json", "utf8"),
+      );
+      return !!content.dependencies?.["@nestia/fetcher"];
+    })());
+
+  const execute = (command: string) => {
+    console.log(`  - ${command}`);
+    cp.execSync(command, { stdio: "ignore" });
+  };
+
+  const replace =
+    (props: { root: string; output: string }) =>
+    async (file: string): Promise<void> => {
+      const relative = (from: string) => (to: string) =>
+        path.relative(from, to).split("\\").join("/");
+      const root: string = relative(process.cwd())(props.root);
+      const output: string = relative(process.cwd())(props.output);
+      const current: string = relative(props.root)(process.cwd());
+
+      const content: string = await fs.promises.readFile(file, "utf8");
+      await fs.promises.writeFile(
+        file,
+        content
+          .split("${root}")
+          .join(root)
+          .split("${output}")
+          .join(output)
+          .split("${current}")
+          .join(current),
+        "utf8",
+      );
+    };
+
+  const dependencies = async (opts: {
+    websocket: boolean;
+  }): Promise<IDependencies> => {
+    const content: string = await fs.promises.readFile(
+      __dirname + "/../../../package.json",
+      "utf8",
+    );
+    const json: {
+      version: string;
+      dependencies: Record<string, string>;
+      devDependencies: Record<string, string>;
+    } = JSON.parse(content);
+    const dependencies: Record<string, string> = {
+      ...json.devDependencies,
+      ...json.dependencies,
+    };
+    const required = (key: "version" | "typia"): string => {
+      const value: string | undefined =
+        key === "version" ? json.version : dependencies[key];
+      if (typeof value !== "string" || value.length === 0)
+        throw new Error(
+          `Unable to resolve ${key} version for SDK distribution.`,
+        );
+      return value;
+    };
+    return {
+      version: required("version"),
+      typia: required("typia"),
+      tgrid: opts.websocket ? dependencies.tgrid : undefined,
+      mcp: dependencies["@modelcontextprotocol/sdk"],
+    };
+  };
+}
+
+interface IDependencies {
+  version: string;
+  typia: string;
+  tgrid: string | undefined;
+  mcp: string | undefined;
+}
+const BUNDLE = __dirname + "/../../../assets/bundle/distribute";

package/src/generates/internal/SdkFileProgrammer.ts

@@ -1,112 +1,116 @@
-import { Node, TypeScriptFactory } from "@nestia/factory";
-import fs from "fs";
-
-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: Node[] = [];
-      for (const [key, value] of directory.children) {
-        await iterate(project)(value)(`${outDir}/${key}`);
-        statements.push(
-          TypeScriptFactory.createExportDeclaration(
-            undefined,
-            false,
-            TypeScriptFactory.createNamespaceExport(
-              TypeScriptFactory.createIdentifier(key),
-            ),
-            TypeScriptFactory.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 { Node, TypeScriptFactory } from "@nestia/factory";
+import fs from "fs";
+
+import { INestiaProject } from "../../structures/INestiaProject";
+import { ITypedApplication } from "../../structures/ITypedApplication";
+import { ITypedHttpRoute } from "../../structures/ITypedHttpRoute";
+import { ITypedMcpRoute } from "../../structures/ITypedMcpRoute";
+import { ITypedWebSocketRoute } from "../../structures/ITypedWebSocketRoute";
+import { MapUtil } from "../../utils/MapUtil";
+import { FilePrinter } from "./FilePrinter";
+import { ImportDictionary } from "./ImportDictionary";
+import { SdkHttpRouteProgrammer } from "./SdkHttpRouteProgrammer";
+import { SdkMcpRouteProgrammer } from "./SdkMcpRouteProgrammer";
+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 | ITypedMcpRoute): 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: Node[] = [];
+      for (const [key, value] of directory.children) {
+        await iterate(project)(value)(`${outDir}/${key}`);
+        statements.push(
+          TypeScriptFactory.createExportDeclaration(
+            undefined,
+            false,
+            TypeScriptFactory.createNamespaceExport(
+              TypeScriptFactory.createIdentifier(key),
+            ),
+            TypeScriptFactory.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)
+            : route.protocol === "websocket"
+              ? SdkWebSocketRouteProgrammer.write(project)(importer)(route)
+              : SdkMcpRouteProgrammer.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",
+      });
+    };
+}