@nestia/core 11.2.0 → 11.3.0

package/lib/adaptors/McpAdaptor.d.ts

@@ -0,0 +1,75 @@
+import { INestApplication } from "@nestjs/common";
+/**
+ * MCP (Model Context Protocol) adaptor.
+ *
+ * `McpAdaptor` exposes every method decorated with {@link McpRoute} as an MCP
+ * tool, reachable by LLM clients through a stateless Streamable HTTP endpoint.
+ *
+ * At bootstrap the adaptor walks the {@link NestContainer}, collects every
+ * controller method carrying `"nestia/McpRoute"` metadata, and caches a tool
+ * registry. A fresh MCP server and transport pair is spun up per incoming HTTP
+ * request, following MCP stateless Streamable HTTP mode. This adaptor
+ * intentionally does not manage `Mcp-Session-Id` state.
+ *
+ * Typia-generated JSON Schemas flow through unchanged; the Zod-based high-level
+ * registration API of `McpServer` is bypassed by accessing the low-level
+ * `.server` handler.
+ *
+ * Error mapping follows the MCP specification:
+ *
+ * - Unknown tool name: JSON-RPC `-32601`.
+ * - Typia validation failure: JSON-RPC `-32602` with structured diagnostics.
+ * - Handler throws {@link HttpException}: success response with `isError: true`,
+ *   so the LLM can read the message and recover.
+ * - Any other throw: JSON-RPC `-32603`.
+ *
+ * @author wildduck - https://github.com/wildduck2
+ * @example
+ *   ```typescript
+ *   import core from "@nestia/core";
+ *   import { NestFactory } from "@nestjs/core";
+ *
+ *   const app = await NestFactory.create(AppModule);
+ *   await core.McpAdaptor.upgrade(app, { path: "/mcp" });
+ *   await app.listen(3000);
+ *   ```;
+ */
+export declare class McpAdaptor {
+    /**
+     * Upgrade a running Nest application with a stateless MCP endpoint.
+     *
+     * Scans the application container for methods decorated with {@link McpRoute},
+     * then registers a catch-all HTTP route at the configured path. Each incoming
+     * request builds a fresh MCP server + transport on demand, wires the
+     * registered tools into it, and delegates handling.
+     *
+     * Must be called after `NestFactory.create(...)` but before `app.listen(...)`
+     * if you want the MCP endpoint to be reachable alongside your regular HTTP
+     * routes.
+     *
+     * @param app Running Nest application instance.
+     * @param options Transport and identity overrides.
+     */
+    static upgrade(app: INestApplication, options?: McpAdaptor.IOptions): Promise<void>;
+}
+export declare namespace McpAdaptor {
+    /** Configuration options for {@link McpAdaptor.upgrade}. */
+    interface IOptions {
+        /**
+         * HTTP path where the MCP endpoint will be mounted.
+         *
+         * @default "/mcp"
+         */
+        path?: string;
+        /**
+         * Identity advertised to MCP clients during the initialize handshake. Shows
+         * up in Claude Desktop / Cursor's MCP panel.
+         *
+         * @default { name: "nestia-mcp", version: "1.0.0" }
+         */
+        serverInfo?: {
+            name: string;
+            version: string;
+        };
+    }
+}

package/lib/adaptors/McpAdaptor.js

@@ -0,0 +1,256 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpAdaptor = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * MCP (Model Context Protocol) adaptor.
+ *
+ * `McpAdaptor` exposes every method decorated with {@link McpRoute} as an MCP
+ * tool, reachable by LLM clients through a stateless Streamable HTTP endpoint.
+ *
+ * At bootstrap the adaptor walks the {@link NestContainer}, collects every
+ * controller method carrying `"nestia/McpRoute"` metadata, and caches a tool
+ * registry. A fresh MCP server and transport pair is spun up per incoming HTTP
+ * request, following MCP stateless Streamable HTTP mode. This adaptor
+ * intentionally does not manage `Mcp-Session-Id` state.
+ *
+ * Typia-generated JSON Schemas flow through unchanged; the Zod-based high-level
+ * registration API of `McpServer` is bypassed by accessing the low-level
+ * `.server` handler.
+ *
+ * Error mapping follows the MCP specification:
+ *
+ * - Unknown tool name: JSON-RPC `-32601`.
+ * - Typia validation failure: JSON-RPC `-32602` with structured diagnostics.
+ * - Handler throws {@link HttpException}: success response with `isError: true`,
+ *   so the LLM can read the message and recover.
+ * - Any other throw: JSON-RPC `-32603`.
+ *
+ * @author wildduck - https://github.com/wildduck2
+ * @example
+ *   ```typescript
+ *   import core from "@nestia/core";
+ *   import { NestFactory } from "@nestjs/core";
+ *
+ *   const app = await NestFactory.create(AppModule);
+ *   await core.McpAdaptor.upgrade(app, { path: "/mcp" });
+ *   await app.listen(3000);
+ *   ```;
+ */
+class McpAdaptor {
+    /**
+     * Upgrade a running Nest application with a stateless MCP endpoint.
+     *
+     * Scans the application container for methods decorated with {@link McpRoute},
+     * then registers a catch-all HTTP route at the configured path. Each incoming
+     * request builds a fresh MCP server + transport on demand, wires the
+     * registered tools into it, and delegates handling.
+     *
+     * Must be called after `NestFactory.create(...)` but before `app.listen(...)`
+     * if you want the MCP endpoint to be reachable alongside your regular HTTP
+     * routes.
+     *
+     * @param app Running Nest application instance.
+     * @param options Transport and identity overrides.
+     */
+    static upgrade(app_1) {
+        return __awaiter(this, arguments, void 0, function* (app, options = {}) {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            if ("sessioned" in options)
+                throw new Error("McpAdaptor.upgrade() supports stateless Streamable HTTP only; sessioned mode is not implemented.");
+            const tools = [];
+            const container = app.container;
+            for (const module of container.getModules().values()) {
+                for (const wrapper of module.controllers.values()) {
+                    const instance = wrapper.instance;
+                    if (!instance)
+                        continue;
+                    const proto = Object.getPrototypeOf(instance);
+                    for (const key of Object.getOwnPropertyNames(proto)) {
+                        if (key === "constructor")
+                            continue;
+                        const method = proto[key];
+                        if (typeof method !== "function")
+                            continue;
+                        const meta = Reflect.getMetadata("nestia/McpRoute", method);
+                        if (!meta)
+                            continue;
+                        const params = (_a = Reflect.getMetadata("nestia/McpRoute/Parameters", proto, key)) !== null && _a !== void 0 ? _a : [];
+                        const paramValidator = (_b = params.find((p) => p.category === "params")) === null || _b === void 0 ? void 0 : _b.validate;
+                        tools.push({
+                            meta,
+                            source: `${(_f = (_d = (_c = wrapper.metatype) === null || _c === void 0 ? void 0 : _c.name) !== null && _d !== void 0 ? _d : (_e = proto.constructor) === null || _e === void 0 ? void 0 : _e.name) !== null && _f !== void 0 ? _f : "UnknownController"}.${String(key)}`,
+                            validateArgs: paramValidator,
+                            handler: (args) => __awaiter(this, void 0, void 0, function* () { return method.call(instance, args); }),
+                        });
+                    }
+                }
+            }
+            assertUniqueTools(tools);
+            const serverInfo = (_g = options.serverInfo) !== null && _g !== void 0 ? _g : {
+                name: "nestia-mcp",
+                version: "1.0.0",
+            };
+            const { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, McpServer, StreamableHTTPServerTransport, } = yield loadMcpSdk();
+            const http = app.getHttpAdapter();
+            const route = (_h = options.path) !== null && _h !== void 0 ? _h : "/mcp";
+            http.all(route, (req, res) => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b;
+                // Stateless mode requires a fresh transport per request; sharing one
+                // across clients races on internal initialization and request IDs.
+                const mcp = new McpServer(serverInfo, {
+                    capabilities: { tools: {} },
+                });
+                const server = mcp.server;
+                server.setRequestHandler(ListToolsRequestSchema, () => __awaiter(this, void 0, void 0, function* () {
+                    return ({
+                        tools: tools.map((t) => ({
+                            name: t.meta.name,
+                            title: t.meta.title,
+                            description: t.meta.description,
+                            inputSchema: t.meta.inputSchema,
+                            outputSchema: t.meta.outputSchema,
+                            annotations: t.meta.annotations,
+                        })),
+                    });
+                }));
+                server.setRequestHandler(CallToolRequestSchema, (reqMsg) => __awaiter(this, void 0, void 0, function* () {
+                    var _a;
+                    const tool = tools.find((t) => t.meta.name === reqMsg.params.name);
+                    if (!tool)
+                        throw new McpError(ErrorCode.MethodNotFound, `Tool not found: ${reqMsg.params.name}`);
+                    const args = (_a = reqMsg.params.arguments) !== null && _a !== void 0 ? _a : {};
+                    if (tool.validateArgs) {
+                        const err = tool.validateArgs(args);
+                        if (err !== null) {
+                            const body = err instanceof common_1.BadRequestException
+                                ? err.getResponse()
+                                : undefined;
+                            throw new McpError(ErrorCode.InvalidParams, err.message, {
+                                errors: body === null || body === void 0 ? void 0 : body.errors,
+                                path: body === null || body === void 0 ? void 0 : body.path,
+                                expected: body === null || body === void 0 ? void 0 : body.expected,
+                                value: body === null || body === void 0 ? void 0 : body.value,
+                                reason: body === null || body === void 0 ? void 0 : body.reason,
+                            });
+                        }
+                    }
+                    try {
+                        const result = yield tool.handler(args);
+                        if (result === undefined)
+                            return { content: [] };
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: typeof result === "string" ? result : JSON.stringify(result),
+                                },
+                            ],
+                        };
+                    }
+                    catch (e) {
+                        if (e instanceof common_1.HttpException) {
+                            return {
+                                content: [{ type: "text", text: e.message }],
+                                isError: true,
+                            };
+                        }
+                        throw new McpError(ErrorCode.InternalError, e instanceof Error ? e.message : "Internal error");
+                    }
+                }));
+                const transport = new StreamableHTTPServerTransport({
+                    sessionIdGenerator: undefined,
+                    enableJsonResponse: true,
+                });
+                try {
+                    yield mcp.connect(transport);
+                    yield transport.handleRequest((_a = req.raw) !== null && _a !== void 0 ? _a : req, (_b = res.raw) !== null && _b !== void 0 ? _b : res, req.body);
+                }
+                finally {
+                    yield transport.close().catch(() => { });
+                    yield mcp.close().catch(() => { });
+                }
+            }));
+        });
+    }
+}
+exports.McpAdaptor = McpAdaptor;
+const assertUniqueTools = (tools) => {
+    var _a;
+    const dict = new Map();
+    for (const tool of tools) {
+        const array = (_a = dict.get(tool.meta.name)) !== null && _a !== void 0 ? _a : [];
+        array.push(tool);
+        dict.set(tool.meta.name, array);
+    }
+    const duplicated = Array.from(dict.entries()).filter(([, list]) => list.length > 1);
+    if (duplicated.length === 0)
+        return;
+    throw new Error([
+        "Duplicated MCP tool names are not allowed.",
+        ...duplicated.map(([name, list]) => `  - ${JSON.stringify(name)}: ${list.map((tool) => tool.source).join(", ")}`),
+    ].join("\n"));
+};
+const loadMcpSdk = () => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        const [server, transport, types] = yield Promise.all([
+            Promise.resolve().then(() => __importStar(require("@modelcontextprotocol/sdk/server/mcp.js"))),
+            Promise.resolve().then(() => __importStar(require("@modelcontextprotocol/sdk/server/streamableHttp.js"))),
+            Promise.resolve().then(() => __importStar(require("@modelcontextprotocol/sdk/types.js"))),
+        ]);
+        return {
+            McpServer: server.McpServer,
+            StreamableHTTPServerTransport: transport.StreamableHTTPServerTransport,
+            CallToolRequestSchema: types.CallToolRequestSchema,
+            ErrorCode: types.ErrorCode,
+            ListToolsRequestSchema: types.ListToolsRequestSchema,
+            McpError: types.McpError,
+        };
+    }
+    catch (_a) {
+        throw new Error("McpAdaptor.upgrade() requires @modelcontextprotocol/sdk. Install it before enabling MCP routes.");
+    }
+});
+//# sourceMappingURL=McpAdaptor.js.map

package/lib/adaptors/McpAdaptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpAdaptor.js","sourceRoot":"","sources":["../../src/adaptors/McpAdaptor.ts"],"names":[],"mappings":"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"}

package/lib/decorators/McpRoute.d.ts

@@ -0,0 +1,73 @@
+import { IRequestBodyValidator } from "../options/IRequestBodyValidator";
+/**
+ * MCP (Model Context Protocol) route decorator.
+ *
+ * `@McpRoute()` marks a controller method as a callable MCP tool. When the
+ * application bootstraps, every method annotated with this decorator is
+ * registered on the MCP server built by {@link McpAdaptor.upgrade}, making it
+ * reachable by LLM clients (Claude Desktop, Cursor, OpenAI function calling,
+ * etc.) through the standard Streamable HTTP transport.
+ *
+ * The public form takes only the tool's `name` (string). Human-readable
+ * `description` and `title` are read from the method's JSDoc:
+ *
+ * - `description`: the JSDoc comment body.
+ * - `title`: the value of an optional `@title` JSDoc tag.
+ *
+ * For type-safe tool inputs, decorate exactly one parameter of the method with
+ * {@link McpRoute.Params}. The parameter type `T` is analyzed at compile time by
+ * the nestia transformer, which generates both a runtime validator (powered by
+ * typia) and the JSON Schema attached to `inputSchema` in `tools/list`
+ * responses.
+ *
+ * For the MCP endpoint to actually be served, you must call
+ * {@link McpAdaptor.upgrade} on the {@link INestApplication} instance at
+ * bootstrap. The decorator alone only stores reflection metadata.
+ *
+ * @author wildduck - https://github.com/wildduck2
+ * @example
+ *   ```typescript
+ *   import core from "@nestia/core";
+ *
+ *   @Controller()
+ *   export class WeatherController {
+ *     /**
+ *      * Return current weather for a city.
+ *      *
+ *      * @title Get weather
+ *      *\/
+ *     @core.McpRoute("get_weather")
+ *     public async get(
+ *       @core.McpRoute.Params() params: { city: string },
+ *     ): Promise<{ temp: number }> {
+ *       return { temp: 22 };
+ *     }
+ *   }
+ *   ```;
+ *
+ * @param name Unique tool identifier exposed to MCP clients via `tools/list`.
+ * @returns Method decorator.
+ */
+export declare function McpRoute(name: string): MethodDecorator;
+export declare namespace McpRoute {
+    /**
+     * Parameter decorator for an MCP tool's input arguments.
+     *
+     * `@McpRoute.Params<T>()` validates the `arguments` object from a
+     * `tools/call` request against the TypeScript type `T` using typia. A failed
+     * validation surfaces to the client as a JSON-RPC `-32602` (`InvalidParams`)
+     * error with structured diagnostics, giving the LLM precise feedback to
+     * self-correct.
+     *
+     * MCP tools accept exactly one arguments object; applying this decorator more
+     * than once on a single method is a compile-time error. The decorated type
+     * `T` must be an object type without dynamic properties (no `Record<string,
+     * X>`, no index signatures); the nestia transformer enforces this through
+     * `LlmSchemaProgrammer.validate`.
+     *
+     * @author wildduck - https://github.com/wildduck2
+     * @param validator Optional custom validator. Default is `typia.assert()`.
+     * @returns Parameter decorator.
+     */
+    function Params<T>(validator?: IRequestBodyValidator<T>): ParameterDecorator;
+}

package/lib/decorators/McpRoute.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpRoute = McpRoute;
+const validate_request_body_1 = require("./internal/validate_request_body");
+function McpRoute(input) {
+    const config = typeof input === "string" ? { name: input } : input;
+    return function McpRoute(_target, _propertyKey, descriptor) {
+        var _a;
+        Reflect.defineMetadata("nestia/McpRoute", {
+            name: config.name,
+            title: config.title,
+            description: config.description,
+            inputSchema: (_a = config.inputSchema) !== null && _a !== void 0 ? _a : { type: "object", properties: {} },
+            outputSchema: config.outputSchema,
+            annotations: config.annotations,
+        }, descriptor.value);
+        return descriptor;
+    };
+}
+(function (McpRoute) {
+    /**
+     * Parameter decorator for an MCP tool's input arguments.
+     *
+     * `@McpRoute.Params<T>()` validates the `arguments` object from a
+     * `tools/call` request against the TypeScript type `T` using typia. A failed
+     * validation surfaces to the client as a JSON-RPC `-32602` (`InvalidParams`)
+     * error with structured diagnostics, giving the LLM precise feedback to
+     * self-correct.
+     *
+     * MCP tools accept exactly one arguments object; applying this decorator more
+     * than once on a single method is a compile-time error. The decorated type
+     * `T` must be an object type without dynamic properties (no `Record<string,
+     * X>`, no index signatures); the nestia transformer enforces this through
+     * `LlmSchemaProgrammer.validate`.
+     *
+     * @author wildduck - https://github.com/wildduck2
+     * @param validator Optional custom validator. Default is `typia.assert()`.
+     * @returns Parameter decorator.
+     */
+    function Params(validator) {
+        const validate = (0, validate_request_body_1.validate_request_body)("McpRoute.Params")(validator);
+        return function McpRouteParams(target, propertyKey, parameterIndex) {
+            emplace(target, propertyKey !== null && propertyKey !== void 0 ? propertyKey : "", {
+                category: "params",
+                index: parameterIndex,
+                validate,
+            });
+        };
+    }
+    McpRoute.Params = Params;
+    /** @internal */
+    const emplace = (target, propertyKey, value) => {
+        const array = Reflect.getMetadata("nestia/McpRoute/Parameters", target, propertyKey);
+        if (array !== undefined)
+            array.push(value);
+        else
+            Reflect.defineMetadata("nestia/McpRoute/Parameters", [value], target, propertyKey);
+    };
+})(McpRoute || (exports.McpRoute = McpRoute = {}));
+//# sourceMappingURL=McpRoute.js.map

package/lib/decorators/McpRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpRoute.js","sourceRoot":"","sources":["../../src/decorators/McpRoute.ts"],"names":[],"mappings":";;AA0DA,4BAsBC;AA9ED,4EAAyE;AAwDzE,SAAgB,QAAQ,CAAC,KAAgC;IACvD,MAAM,MAAM,GACV,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACtD,OAAO,SAAS,QAAQ,CACtB,OAAe,EACf,YAA6B,EAC7B,UAAwC;;QAExC,OAAO,CAAC,cAAc,CACpB,iBAAiB,EACjB;YACE,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,MAAA,MAAM,CAAC,WAAW,mCAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;YACrE,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,WAAW,EAAE,MAAM,CAAC,WAAW;SACL,EAC5B,UAAU,CAAC,KAAK,CACjB,CAAC;QACF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED,WAAiB,QAAQ;IAoBvB;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAgB,MAAM,CACpB,SAAoC;QAEpC,MAAM,QAAQ,GAAG,IAAA,6CAAqB,EAAC,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC;QACrE,OAAO,SAAS,cAAc,CAC5B,MAAc,EACd,WAAwC,EACxC,cAAsB;YAEtB,OAAO,CAAC,MAAM,EAAE,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,EAAE,EAAE;gBACjC,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,cAAc;gBACrB,QAAQ;aACT,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;IAfe,eAAM,SAerB,CAAA;IAED,gBAAgB;IAChB,MAAM,OAAO,GAAG,CACd,MAAc,EACd,WAA4B,EAC5B,KAAiC,EACjC,EAAE;QACF,MAAM,KAAK,GAA6C,OAAO,CAAC,WAAW,CACzE,4BAA4B,EAC5B,MAAM,EACN,WAAW,CACZ,CAAC;QACF,IAAI,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;YAEzC,OAAO,CAAC,cAAc,CACpB,4BAA4B,EAC5B,CAAC,KAAK,CAAC,EACP,MAAM,EACN,WAAW,CACZ,CAAC;IACN,CAAC,CAAC;AACJ,CAAC,EA5EgB,QAAQ,wBAAR,QAAQ,QA4ExB"}

package/lib/decorators/internal/IMcpRouteReflect.d.ts

@@ -0,0 +1,2 @@
+export declare namespace IMcpRouteReflect {
+}

package/lib/decorators/internal/IMcpRouteReflect.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IMcpRouteReflect.js.map

package/lib/decorators/internal/IMcpRouteReflect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMcpRouteReflect.js","sourceRoot":"","sources":["../../../src/decorators/internal/IMcpRouteReflect.ts"],"names":[],"mappings":""}

package/lib/module.d.ts

@@ -17,4 +17,6 @@ export * from "./decorators/SwaggerCustomizer";
 export * from "./decorators/SwaggerExample";
 export * from "./adaptors/WebSocketAdaptor";
 export * from "./decorators/WebSocketRoute";
+export * from "./adaptors/McpAdaptor";
+export * from "./decorators/McpRoute";
 export * from "./decorators/doNotThrowTransformError";

package/lib/module.js

@@ -33,5 +33,7 @@ __exportStar(require("./decorators/SwaggerCustomizer"), exports);
 __exportStar(require("./decorators/SwaggerExample"), exports);
 __exportStar(require("./adaptors/WebSocketAdaptor"), exports);
 __exportStar(require("./decorators/WebSocketRoute"), exports);
+__exportStar(require("./adaptors/McpAdaptor"), exports);
+__exportStar(require("./decorators/McpRoute"), exports);
 __exportStar(require("./decorators/doNotThrowTransformError"), exports);
 //# sourceMappingURL=module.js.map

package/lib/module.js.map

@@ -1 +1 @@
-{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,2DAAyC;AAEzC,0DAAwC;AACxC,0DAAwC;AACxC,yDAAuC;AACvC,0DAAwC;AACxC,8DAA4C;AAC5C,4DAA0C;AAC1C,6DAA2C;AAC3C,0DAAwC;AAExC,mEAAiD;AACjD,8DAA4C;AAC5C,6DAA2C;AAC3C,+DAA6C;AAC7C,yDAAuC;AACvC,iEAA+C;AAC/C,8DAA4C;AAE5C,8DAA4C;AAC5C,8DAA4C;AAC5C,wEAAsD"}
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,2DAAyC;AAEzC,0DAAwC;AACxC,0DAAwC;AACxC,yDAAuC;AACvC,0DAAwC;AACxC,8DAA4C;AAC5C,4DAA0C;AAC1C,6DAA2C;AAC3C,0DAAwC;AAExC,mEAAiD;AACjD,8DAA4C;AAC5C,6DAA2C;AAC3C,+DAA6C;AAC7C,yDAAuC;AACvC,iEAA+C;AAC/C,8DAA4C;AAE5C,8DAA4C;AAC5C,8DAA4C;AAC5C,wDAAsC;AACtC,wDAAsC;AACtC,wEAAsD"}

package/lib/programmers/McpRouteProgrammer.d.ts

@@ -0,0 +1,26 @@
+import ts from "typescript";
+import { INestiaTransformContext } from "../options/INestiaTransformProject";
+/**
+ * Compile-time JSON Schema emitter for `@McpRoute.Params<T>()` types.
+ *
+ * Mirrors {@link TypedBodyProgrammer} for runtime validators, but instead of
+ * emitting a `typia.assert` closure it emits a literal JSON Schema object.
+ * The MCP specification requires `inputSchema` to be a single static object
+ * type — no primitives, no unions, no dynamic-key records — so this
+ * programmer rejects anything else with a {@link TransformerError}.
+ *
+ * The emitted shape is `LlmParametersProgrammer`'s parameters block —
+ * `{ type: "object", properties, required, $defs }` — which is exactly what
+ * the MCP `tools/list` response requires for `inputSchema`. Plain
+ * `JsonSchemaProgrammer.write` cannot be used here because it may produce a
+ * top-level `$ref` to a `$defs` entry, which MCP clients reject.
+ *
+ * @author wildduck - https://github.com/wildduck2
+ */
+export declare namespace McpRouteProgrammer {
+    const generate: (props: {
+        context: INestiaTransformContext;
+        modulo: ts.LeftHandSideExpression;
+        type: ts.Type;
+    }) => ts.Expression;
+}

package/lib/programmers/McpRouteProgrammer.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpRouteProgrammer = void 0;
+const core_1 = require("@typia/core");
+const check_mcp_object_1 = require("./internal/check_mcp_object");
+/**
+ * Compile-time JSON Schema emitter for `@McpRoute.Params<T>()` types.
+ *
+ * Mirrors {@link TypedBodyProgrammer} for runtime validators, but instead of
+ * emitting a `typia.assert` closure it emits a literal JSON Schema object.
+ * The MCP specification requires `inputSchema` to be a single static object
+ * type — no primitives, no unions, no dynamic-key records — so this
+ * programmer rejects anything else with a {@link TransformerError}.
+ *
+ * The emitted shape is `LlmParametersProgrammer`'s parameters block —
+ * `{ type: "object", properties, required, $defs }` — which is exactly what
+ * the MCP `tools/list` response requires for `inputSchema`. Plain
+ * `JsonSchemaProgrammer.write` cannot be used here because it may produce a
+ * top-level `$ref` to a `$defs` entry, which MCP clients reject.
+ *
+ * @author wildduck - https://github.com/wildduck2
+ */
+var McpRouteProgrammer;
+(function (McpRouteProgrammer) {
+    McpRouteProgrammer.generate = (props) => {
+        const result = core_1.MetadataFactory.analyze({
+            checker: props.context.checker,
+            transformer: props.context.transformer,
+            options: {
+                escape: true,
+                constant: true,
+                absorb: true,
+            },
+            components: new core_1.MetadataCollection(),
+            type: props.type,
+        });
+        if (result.success === false)
+            throw core_1.TransformerError.from({
+                code: "@nestia.core.McpRoute.Params",
+                errors: result.errors,
+            });
+        const violations = (0, check_mcp_object_1.check_mcp_object)("params")(result.data);
+        if (violations.length)
+            throw new Error(`[@nestia.core.McpRoute.Params] ${violations.join(" ")}`);
+        return core_1.LlmParametersProgrammer.write({
+            context: Object.assign(Object.assign({}, props.context), { options: {
+                    numeric: false,
+                    finite: false,
+                    functional: false,
+                } }),
+            config: { strict: false },
+            metadata: result.data,
+        });
+    };
+})(McpRouteProgrammer || (exports.McpRouteProgrammer = McpRouteProgrammer = {}));
+//# sourceMappingURL=McpRouteProgrammer.js.map

package/lib/programmers/McpRouteProgrammer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpRouteProgrammer.js","sourceRoot":"","sources":["../../src/programmers/McpRouteProgrammer.ts"],"names":[],"mappings":";;;AAAA,sCAMqB;AAKrB,kEAA+D;AAE/D;;;;;;;;;;;;;;;;GAgBG;AACH,IAAiB,kBAAkB,CA4ClC;AA5CD,WAAiB,kBAAkB;IACpB,2BAAQ,GAAG,CAAC,KAIxB,EAAiB,EAAE;QAClB,MAAM,MAAM,GACV,sBAAe,CAAC,OAAO,CAAC;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO;YAC9B,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW;YACtC,OAAO,EAAE;gBACP,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,IAAI;aACb;YACD,UAAU,EAAE,IAAI,yBAAkB,EAAE;YACpC,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC;QACL,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK;YAC1B,MAAM,uBAAgB,CAAC,IAAI,CAAC;gBAC1B,IAAI,EAAE,8BAA8B;gBACpC,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC,CAAC;QAEL,MAAM,UAAU,GAAa,IAAA,mCAAgB,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,UAAU,CAAC,MAAM;YACnB,MAAM,IAAI,KAAK,CACb,kCAAkC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACzD,CAAC;QAEJ,OAAO,8BAAuB,CAAC,KAAK,CAAC;YACnC,OAAO,kCACF,KAAK,CAAC,OAAO,KAChB,OAAO,EAAE;oBACP,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,KAAK;oBACb,UAAU,EAAE,KAAK;iBAClB,GACF;YACD,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;YACzB,QAAQ,EAAE,MAAM,CAAC,IAAI;SACtB,CAAC,CAAC;IACL,CAAC,CAAC;AAEJ,CAAC,EA5CgB,kBAAkB,kCAAlB,kBAAkB,QA4ClC"}

package/lib/programmers/McpRouteReturnProgrammer.d.ts

@@ -0,0 +1,24 @@
+import ts from "typescript";
+import { INestiaTransformContext } from "../options/INestiaTransformProject";
+/**
+ * Compile-time validator for the return type of an `@McpRoute()` method.
+ *
+ * Mirrors {@link TypedRouteProgrammer} but adapted to MCP's structured-output
+ * rules. The MCP specification requires every tool's output to be a single
+ * object value or nothing at all. To enforce that:
+ *
+ * - `void` returns short-circuit (nothing emitted).
+ * - Object returns are inspected directly on the analyzed metadata to reject
+ *   primitives, unions, and dynamic-key records.
+ * - Mixed unions of `void` and a value type are rejected outright; MCP has no
+ *   way to model "sometimes returns nothing, sometimes returns X".
+ *
+ * @author wildduck - https://github.com/wildduck2
+ */
+export declare namespace McpRouteReturnProgrammer {
+    const generate: (props: {
+        context: INestiaTransformContext;
+        modulo: ts.LeftHandSideExpression;
+        type: ts.Type;
+    }) => void;
+}