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

package/src/NestiaSdkApplication.ts

@@ -1,4 +1,3 @@
-import { IMetadataDictionary } from "./internal/legacy";
 import fs from "fs";
 import path from "path";
 import { HashSet, Pair, TreeMap } from "tstl";
@@ -9,17 +8,20 @@ import { ConfigAnalyzer } from "./analyses/ConfigAnalyzer";
 import { PathAnalyzer } from "./analyses/PathAnalyzer";
 import { ReflectControllerAnalyzer } from "./analyses/ReflectControllerAnalyzer";
 import { TypedHttpRouteAnalyzer } from "./analyses/TypedHttpRouteAnalyzer";
+import { TypedMcpRouteAnalyzer } from "./analyses/TypedMcpRouteAnalyzer";
 import { TypedWebSocketRouteAnalyzer } from "./analyses/TypedWebSocketRouteAnalyzer";
 import { E2eGenerator } from "./generates/E2eGenerator";
 import { SdkGenerator } from "./generates/SdkGenerator";
 import { SwaggerGenerator } from "./generates/SwaggerGenerator";
+import { IMetadataDictionary } from "./internal/legacy";
 import { INestiaProject } from "./structures/INestiaProject";
+import { IOperationMetadata } from "./structures/IOperationMetadata";
 import { IReflectController } from "./structures/IReflectController";
 import { IReflectOperationError } from "./structures/IReflectOperationError";
 import { ITypedApplication } from "./structures/ITypedApplication";
 import { ITypedHttpRoute } from "./structures/ITypedHttpRoute";
+import { ITypedMcpRoute } from "./structures/ITypedMcpRoute";
 import { ITypedWebSocketRoute } from "./structures/ITypedWebSocketRoute";
-import { IOperationMetadata } from "./structures/IOperationMetadata";
 import { StringUtil } from "./utils/StringUtil";
 import { VersioningStrategy } from "./utils/VersioningStrategy";
 
@@ -161,7 +163,11 @@ export class NestiaSdkApplication {
       const set: HashSet<Pair<string, string>> = new HashSet();
       for (const controller of controllers)
         for (const controllerPath of controller.paths)
-          for (const operation of controller.operations)
+          for (const operation of controller.operations) {
+            if (operation.protocol === "mcp") {
+              set.insert(new Pair(`mcp:${operation.toolName}`, "mcp"));
+              continue;
+            }
             for (const operationPath of operation.paths)
               set.insert(
                 new Pair(
@@ -169,6 +175,7 @@ export class NestiaSdkApplication {
                   operation.protocol === "http" ? operation.method : "",
                 ),
               );
+          }
       return set.size();
     })();
 
@@ -179,7 +186,9 @@ export class NestiaSdkApplication {
         .map(
           (c) =>
             c.paths.length *
-            c.operations.map((f) => f.paths.length).reduce((a, b) => a + b, 0),
+            c.operations
+              .map((f) => (f.protocol === "mcp" ? 1 : f.paths.length))
+              .reduce((a, b) => a + b, 0),
         )
         .reduce((a, b) => a + b, 0)}`,
     );
@@ -194,10 +203,20 @@ export class NestiaSdkApplication {
       TypedHttpRouteAnalyzer.dictionary(controllers);
 
     // CONVERT TO TYPED OPERATIONS
-    const globalPrefix: string = project.input.globalPrefix?.prefix ?? "";
-    const routes: Array<ITypedHttpRoute | ITypedWebSocketRoute> = [];
+    const routes: Array<
+      ITypedHttpRoute | ITypedWebSocketRoute | ITypedMcpRoute
+    > = [];
     for (const c of controllers)
       for (const o of c.operations) {
+        if (o.protocol === "mcp") {
+          routes.push(
+            ...TypedMcpRouteAnalyzer.analyze({
+              controller: c,
+              operation: o,
+            }),
+          );
+          continue;
+        }
         const pathList: Set<string> = new Set();
         const versions: string[] = VersioningStrategy.merge(project)([
           ...(c.versions ?? []),
@@ -206,10 +225,22 @@ export class NestiaSdkApplication {
         for (const v of versions)
           for (const prefix of wrapPaths(c.prefixes))
             for (const cPath of wrapPaths(c.paths))
-              for (const filePath of wrapPaths(o.paths))
+              for (const filePath of wrapPaths(o.paths)) {
+                const localPath: string = PathAnalyzer.join(
+                  prefix,
+                  cPath,
+                  filePath,
+                );
                 pathList.add(
-                  PathAnalyzer.join(globalPrefix, v, prefix, cPath, filePath),
+                  PathAnalyzer.joinWithGlobalPrefix({
+                    globalPrefix: project.input.globalPrefix?.prefix ?? "",
+                    exclude: project.input.globalPrefix?.exclude,
+                    excludePath: localPath,
+                    method: o.protocol === "http" ? o.method : "",
+                    path: PathAnalyzer.join(v, localPath),
+                  }),
                 );
+              }
         if (o.protocol === "http")
           routes.push(
             ...TypedHttpRouteAnalyzer.analyze({

package/src/NestiaSwaggerComposer.ts

@@ -1,142 +1,153 @@
-import { INestApplication } from "@nestjs/common";
-import { IMetadataDictionary } from "./internal/legacy";
-import { OpenApiV3, OpenApiV3_1, SwaggerV2 } from "@typia/interface";
-import { OpenApiConverter } from "@typia/utils";
-import path from "path";
-import { TreeMap } from "tstl";
-import { OpenApi } from "typia";
-
-import { INestiaConfig } from "./INestiaConfig";
-import { AccessorAnalyzer } from "./analyses/AccessorAnalyzer";
-import { ConfigAnalyzer } from "./analyses/ConfigAnalyzer";
-import { PathAnalyzer } from "./analyses/PathAnalyzer";
-import { ReflectControllerAnalyzer } from "./analyses/ReflectControllerAnalyzer";
-import { TypedHttpRouteAnalyzer } from "./analyses/TypedHttpRouteAnalyzer";
-import { SwaggerGenerator } from "./generates/SwaggerGenerator";
-import { INestiaProject } from "./structures/INestiaProject";
-import { INestiaSdkInput } from "./structures/INestiaSdkInput";
-import { IReflectController } from "./structures/IReflectController";
-import { IReflectOperationError } from "./structures/IReflectOperationError";
-import { ITypedHttpRoute } from "./structures/ITypedHttpRoute";
-import { IOperationMetadata } from "./structures/IOperationMetadata";
-import { VersioningStrategy } from "./utils/VersioningStrategy";
-
-export namespace NestiaSwaggerComposer {
-  export const document = async (
-    app: INestApplication,
-    config: Omit<INestiaConfig.ISwaggerConfig, "output">,
-  ): Promise<
-    | OpenApi.IDocument
-    | OpenApiV3_1.IDocument
-    | OpenApiV3.IDocument
-    | SwaggerV2.IDocument
-  > => {
-    const input: INestiaSdkInput = await ConfigAnalyzer.application(app);
-    const document: OpenApi.IDocument = await SwaggerGenerator.compose({
-      config,
-      routes: analyze(input),
-      document: await SwaggerGenerator.initialize(config),
-    });
-    return (config.openapi ?? "3.2") === "3.2"
-      ? document
-      : OpenApiConverter.downgradeDocument(document, config.openapi as "2.0");
-  };
-
-  const analyze = (input: INestiaSdkInput): ITypedHttpRoute[] => {
-    // GET REFLECT CONTROLLERS
-    const unique: WeakSet<any> = new WeakSet();
-    const project: Omit<INestiaProject, "config"> = {
-      input,
-      errors: [],
-      warnings: [],
-    };
-    const controllers: IReflectController[] = project.input.controllers
-      .map((c) =>
-        ReflectControllerAnalyzer.analyze({ project, controller: c, unique }),
-      )
-      .filter((c): c is IReflectController => c !== null);
-    if (project.errors.length)
-      throw report({ type: "error", errors: project.errors });
-
-    // METADATA COMPONENTS
-    const collection: IMetadataDictionary =
-      TypedHttpRouteAnalyzer.dictionary(controllers);
-
-    // CONVERT TO TYPED OPERATIONS
-    const globalPrefix: string = project.input.globalPrefix?.prefix ?? "";
-    const routes: ITypedHttpRoute[] = [];
-    for (const c of controllers)
-      for (const o of c.operations) {
-        const pathList: Set<string> = new Set();
-        const versions: string[] = VersioningStrategy.merge(project)([
-          ...(c.versions ?? []),
-          ...(o.versions ?? []),
-        ]);
-        for (const v of versions)
-          for (const prefix of wrapPaths(c.prefixes))
-            for (const cPath of wrapPaths(c.paths))
-              for (const filePath of wrapPaths(o.paths))
-                pathList.add(
-                  PathAnalyzer.join(globalPrefix, v, prefix, cPath, filePath),
-                );
-        if (o.protocol === "http")
-          routes.push(
-            ...TypedHttpRouteAnalyzer.analyze({
-              controller: c,
-              errors: project.errors,
-              dictionary: collection,
-              operation: o,
-              paths: Array.from(pathList),
-            }),
-          );
-      }
-    AccessorAnalyzer.analyze(routes);
-    return routes;
-  };
-}
-
-const report = (props: {
-  type: "error" | "warning";
-  errors: IReflectOperationError[];
-}): void => {
-  const map: TreeMap<
-    IReflectOperationError.Key,
-    Array<string | IOperationMetadata.IError>
-  > = new TreeMap();
-  for (const e of props.errors)
-    map.take(new IReflectOperationError.Key(e), () => []).push(...e.contents);
-
-  const messages: string[] = [];
-  for (const {
-    first: { error },
-    second: contents,
-  } of map) {
-    if (error.contents.length === 0) continue;
-    const location: string = path.relative(process.cwd(), error.file);
-    messages.push(
-      [
-        `${location} - `,
-        error.class,
-        ...(error.function !== null ? [`.${error.function}()`] : [""]),
-        ...(error.from !== null ? [` from ${error.from}`] : [""]),
-        ":\n",
-        contents
-          .map((c) => {
-            if (typeof c === "string") return `  - ${c}`;
-            else
-              return [
-                c.accessor
-                  ? `  - ${c.name}: `
-                  : `  - ${c.name} (${c.accessor}): `,
-                ...c.messages.map((msg) => `    - ${msg}`),
-              ].join("\n");
-          })
-          .join("\n"),
-      ].join(""),
-    );
-  }
-  throw new Error(`Error on NestiaSwaggerComposer.compose():\n${messages}`);
-};
-
-const wrapPaths = (paths: string[]): string[] =>
-  paths.length === 0 ? [""] : paths;
+import { INestApplication } from "@nestjs/common";
+import { OpenApiV3, OpenApiV3_1, SwaggerV2 } from "@typia/interface";
+import { OpenApiConverter } from "@typia/utils";
+import path from "path";
+import { TreeMap } from "tstl";
+import { OpenApi } from "typia";
+
+import { INestiaConfig } from "./INestiaConfig";
+import { AccessorAnalyzer } from "./analyses/AccessorAnalyzer";
+import { ConfigAnalyzer } from "./analyses/ConfigAnalyzer";
+import { PathAnalyzer } from "./analyses/PathAnalyzer";
+import { ReflectControllerAnalyzer } from "./analyses/ReflectControllerAnalyzer";
+import { TypedHttpRouteAnalyzer } from "./analyses/TypedHttpRouteAnalyzer";
+import { SwaggerGenerator } from "./generates/SwaggerGenerator";
+import { IMetadataDictionary } from "./internal/legacy";
+import { INestiaProject } from "./structures/INestiaProject";
+import { INestiaSdkInput } from "./structures/INestiaSdkInput";
+import { IOperationMetadata } from "./structures/IOperationMetadata";
+import { IReflectController } from "./structures/IReflectController";
+import { IReflectOperationError } from "./structures/IReflectOperationError";
+import { ITypedHttpRoute } from "./structures/ITypedHttpRoute";
+import { VersioningStrategy } from "./utils/VersioningStrategy";
+
+export namespace NestiaSwaggerComposer {
+  export const document = async (
+    app: INestApplication,
+    config: Omit<INestiaConfig.ISwaggerConfig, "output">,
+  ): Promise<
+    | OpenApi.IDocument
+    | OpenApiV3_1.IDocument
+    | OpenApiV3.IDocument
+    | SwaggerV2.IDocument
+  > => {
+    const input: INestiaSdkInput = await ConfigAnalyzer.application(app);
+    const document: OpenApi.IDocument = await SwaggerGenerator.compose({
+      config,
+      routes: analyze(input),
+      document: await SwaggerGenerator.initialize(config),
+    });
+    return (config.openapi ?? "3.2") === "3.2"
+      ? document
+      : OpenApiConverter.downgradeDocument(document, config.openapi as "2.0");
+  };
+
+  const analyze = (input: INestiaSdkInput): ITypedHttpRoute[] => {
+    // GET REFLECT CONTROLLERS
+    const unique: WeakSet<any> = new WeakSet();
+    const project: Omit<INestiaProject, "config"> = {
+      input,
+      errors: [],
+      warnings: [],
+    };
+    const controllers: IReflectController[] = project.input.controllers
+      .map((c) =>
+        ReflectControllerAnalyzer.analyze({ project, controller: c, unique }),
+      )
+      .filter((c): c is IReflectController => c !== null);
+    if (project.errors.length)
+      throw report({ type: "error", errors: project.errors });
+
+    // METADATA COMPONENTS
+    const collection: IMetadataDictionary =
+      TypedHttpRouteAnalyzer.dictionary(controllers);
+
+    // CONVERT TO TYPED OPERATIONS
+    const routes: ITypedHttpRoute[] = [];
+    for (const c of controllers)
+      for (const o of c.operations) {
+        if (o.protocol !== "http") continue;
+        const pathList: Set<string> = new Set();
+        const versions: string[] = VersioningStrategy.merge(project)([
+          ...(c.versions ?? []),
+          ...(o.versions ?? []),
+        ]);
+        for (const v of versions)
+          for (const prefix of wrapPaths(c.prefixes))
+            for (const cPath of wrapPaths(c.paths))
+              for (const filePath of wrapPaths(o.paths)) {
+                const localPath: string = PathAnalyzer.join(
+                  prefix,
+                  cPath,
+                  filePath,
+                );
+                pathList.add(
+                  PathAnalyzer.joinWithGlobalPrefix({
+                    globalPrefix: project.input.globalPrefix?.prefix ?? "",
+                    exclude: project.input.globalPrefix?.exclude,
+                    excludePath: localPath,
+                    method: o.method,
+                    path: PathAnalyzer.join(v, localPath),
+                  }),
+                );
+              }
+        routes.push(
+          ...TypedHttpRouteAnalyzer.analyze({
+            controller: c,
+            errors: project.errors,
+            dictionary: collection,
+            operation: o,
+            paths: Array.from(pathList),
+          }),
+        );
+      }
+    AccessorAnalyzer.analyze(routes);
+    return routes;
+  };
+}
+
+const report = (props: {
+  type: "error" | "warning";
+  errors: IReflectOperationError[];
+}): void => {
+  const map: TreeMap<
+    IReflectOperationError.Key,
+    Array<string | IOperationMetadata.IError>
+  > = new TreeMap();
+  for (const e of props.errors)
+    map.take(new IReflectOperationError.Key(e), () => []).push(...e.contents);
+
+  const messages: string[] = [];
+  for (const {
+    first: { error },
+    second: contents,
+  } of map) {
+    if (error.contents.length === 0) continue;
+    const location: string = path.relative(process.cwd(), error.file);
+    messages.push(
+      [
+        `${location} - `,
+        error.class,
+        ...(error.function !== null ? [`.${error.function}()`] : [""]),
+        ...(error.from !== null ? [` from ${error.from}`] : [""]),
+        ":\n",
+        contents
+          .map((c) => {
+            if (typeof c === "string") return `  - ${c}`;
+            else
+              return [
+                c.accessor
+                  ? `  - ${c.name}: `
+                  : `  - ${c.name} (${c.accessor}): `,
+                ...c.messages.map((msg) => `    - ${msg}`),
+              ].join("\n");
+          })
+          .join("\n"),
+      ].join(""),
+    );
+  }
+  throw new Error(`Error on NestiaSwaggerComposer.compose():\n${messages}`);
+};
+
+const wrapPaths = (paths: string[]): string[] =>
+  paths.length === 0 ? [""] : paths;

package/src/analyses/AccessorAnalyzer.ts

@@ -1,67 +1,64 @@
-import { NamingConvention } from "@typia/utils";
-
-import { ITypedHttpRoute } from "../structures/ITypedHttpRoute";
-import { ITypedWebSocketRoute } from "../structures/ITypedWebSocketRoute";
-
-export namespace AccessorAnalyzer {
-  export const analyze = (
-    routes: Array<ITypedHttpRoute | ITypedWebSocketRoute>,
-  ) => {
-    shrink(routes);
-    variable(routes);
-    shrink(routes);
-    for (const r of routes) r.name = r.accessor.at(-1) ?? r.name;
-  };
-
-  const prepare = (
-    routeList: Array<ITypedHttpRoute | ITypedWebSocketRoute>,
-  ): Map<string, number> => {
-    const dict: Map<string, number> = new Map();
-    for (const route of routeList)
-      route.accessor.forEach((_a, i) => {
-        const key: string = route.accessor.slice(0, i + 1).join(".");
-        dict.set(key, (dict.get(key) ?? 0) + 1);
-      });
-    return dict;
-  };
-
-  const variable = (
-    routeList: Array<ITypedHttpRoute | ITypedWebSocketRoute>,
-  ) => {
-    const dict: Map<string, number> = prepare(routeList);
-    for (const route of routeList) {
-      const emended: string[] = route.accessor.slice();
-      route.accessor.forEach((accessor, i) => {
-        if (NamingConvention.variable(accessor)) return;
-        while (true) {
-          accessor = "_" + accessor;
-          const partial: string = [
-            ...route.accessor.slice(0, i),
-            accessor,
-          ].join(".");
-          if (dict.has(partial) === false) {
-            emended[i] = accessor;
-            break;
-          }
-        }
-      });
-      route.accessor.splice(0, route.accessor.length, ...emended);
-    }
-  };
-
-  const shrink = (routeList: Array<ITypedHttpRoute | ITypedWebSocketRoute>) => {
-    const dict: Map<string, number> = prepare(routeList);
-    for (const route of routeList) {
-      if (
-        route.accessor.length < 2 ||
-        route.accessor.at(-1) !== route.accessor.at(-2)
-      )
-        continue;
-
-      const cut: string[] = route.accessor.slice(0, -1);
-      if ((dict.get(cut.join(".")) ?? 0) > 1) continue;
-
-      route.accessor = cut;
-    }
-  };
-}
+import { NamingConvention } from "@typia/utils";
+
+import { ITypedHttpRoute } from "../structures/ITypedHttpRoute";
+import { ITypedMcpRoute } from "../structures/ITypedMcpRoute";
+import { ITypedWebSocketRoute } from "../structures/ITypedWebSocketRoute";
+
+type AnyRoute = ITypedHttpRoute | ITypedWebSocketRoute | ITypedMcpRoute;
+
+export namespace AccessorAnalyzer {
+  export const analyze = (routes: Array<AnyRoute>) => {
+    shrink(routes);
+    variable(routes);
+    shrink(routes);
+    for (const r of routes) r.name = r.accessor.at(-1) ?? r.name;
+  };
+
+  const prepare = (routeList: Array<AnyRoute>): Map<string, number> => {
+    const dict: Map<string, number> = new Map();
+    for (const route of routeList)
+      route.accessor.forEach((_a, i) => {
+        const key: string = route.accessor.slice(0, i + 1).join(".");
+        dict.set(key, (dict.get(key) ?? 0) + 1);
+      });
+    return dict;
+  };
+
+  const variable = (routeList: Array<AnyRoute>) => {
+    const dict: Map<string, number> = prepare(routeList);
+    for (const route of routeList) {
+      const emended: string[] = route.accessor.slice();
+      route.accessor.forEach((accessor, i) => {
+        if (NamingConvention.variable(accessor)) return;
+        while (true) {
+          accessor = "_" + accessor;
+          const partial: string = [
+            ...route.accessor.slice(0, i),
+            accessor,
+          ].join(".");
+          if (dict.has(partial) === false) {
+            emended[i] = accessor;
+            break;
+          }
+        }
+      });
+      route.accessor.splice(0, route.accessor.length, ...emended);
+    }
+  };
+
+  const shrink = (routeList: Array<AnyRoute>) => {
+    const dict: Map<string, number> = prepare(routeList);
+    for (const route of routeList) {
+      if (
+        route.accessor.length < 2 ||
+        route.accessor.at(-1) !== route.accessor.at(-2)
+      )
+        continue;
+
+      const cut: string[] = route.accessor.slice(0, -1);
+      if ((dict.get(cut.join(".")) ?? 0) > 1) continue;
+
+      route.accessor = cut;
+    }
+  };
+}