@nestia/core 14.0.0 → 14.0.2

package/MIGRATION.md

@@ -93,6 +93,26 @@ Add `compilerOptions.plugins` only when you want to override those options:
 The `typia` entry is a host tombstone for tools that inspect plugin arrays.
 The actual typia transform is composed by the native Nestia binary.
 
+### A plugin list kept from nestia v11
+
+A project upgraded from nestia v11 may still list the plugins that version documented:
+
+```jsonc
+{
+  "compilerOptions": {
+    "plugins": [
+      { "transform": "typia/lib/transform" },
+      { "transform": "@nestia/core/lib/transform", "validate": "assert", "stringify": "assert" },
+      { "transform": "@nestia/sdk/lib/transform" }
+    ]
+  }
+}
+```
+
+It builds unchanged. `@nestia/core/lib/transform` resolves to the same descriptor as `@nestia/core/native/transform.cjs`, which composes the `typia` entry and applies the `validate` and `stringify` options. The `@nestia/sdk/lib/transform` entry attaches SDK metadata in every build, as it did in v11, so `@nestia/sdk` must stay installed at runtime. Replace the list with the override above, or remove it for the defaults.
+
+Releases before this change gave `@nestia/core/lib/transform` a host of its own, and ttsc stopped with `multiple compiler native backends cannot share one emit pass`. On such a release, replace the list as above.
+
 ## CLI setup flow
 
 The CLI no longer provides an interactive setup command. Install packages and

package/README.md

@@ -60,7 +60,7 @@ Check out the document in the [website](https://nestia.io/docs/):
 ### 🏠 Home
   - [Introduction](https://nestia.io/docs/)
   - [Setup](https://nestia.io/docs/setup/)
-  - [Pure TypeScript](https://nestia.io/docs/pure)
+  - [Pure TypeScript](https://nestia.io/docs/core/TypedBody/)
 
 ### 📖 Features
   - Core Library

package/lib/adaptors/McpAdaptor.d.ts

@@ -15,6 +15,11 @@ import { INestApplication } from "@nestjs/common";
  * registration API of `McpServer` is bypassed by accessing the low-level
  * `.server` handler.
  *
+ * A tool call passes the guards, interceptors, pipes, and exception filters
+ * NestJS applies to an HTTP route on the same method, with the MCP HTTP request
+ * as the execution context. The endpoint is mounted at `path` as given, outside
+ * the application's global prefix.
+ *
  * Error mapping follows the MCP specification:
  *
  * - Unknown tool name: JSON-RPC `-32601`.
@@ -25,14 +30,12 @@ import { INestApplication } from "@nestjs/common";
  *
  * @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 {
     /**
@@ -49,11 +52,34 @@ export declare class McpAdaptor {
      *
      * @param app Running Nest application instance.
      * @param options Transport and identity overrides.
+     * @evidence contracts/common.md#principled-implementation Tools are collected once from the prototype chain of every controller instance by the `nestia/McpRoute` metadata, with the first definition of a property name winning and accessors skipped without execution, duplicates by tool name refused before serving, and each call runs through NestJS's `ExternalContextCreator` so guards, interceptors, pipes, and exception filters apply as for an HTTP route; every request gets a fresh MCP server and Streamable HTTP transport, which stateless mode requires, and both are closed in a `finally`.
+     * @evidence contracts/common.md#clear-and-simple-design One entry point does discovery and registration; the per-tool call (`createHandler`), the duplicate check, the SDK loader, and the per-request response facade are separate module-private functions.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Reading the module graph goes through the internal `app.container`, because `INestApplication` exposes no public accessor for it, `create_external_context_creator` constructs an owned subclass through the Nest constructor and overrides module selection on that type, because the default looks for provider classes while controllers belong to the controller collection, and `get_request_context_id` registers the request provider on the request object as NestJS's router does for an HTTP route, and a per-request response facade forwards native state, events and method receivers without replacing raw methods. After a tool or its exception filter has sent headers, only the facade suppresses subsequent transport writes and preserves callbacks and chaining. Native transport writes do not themselves activate takeover. The remaining foreign-internal reads are the application container and Nest request context registration; the MCP SDK uses its public Node response injection boundary.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the stateless mode, what is discovered, and that the SDK is an optional dependency; the options documentation states the path and server information.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation MCP tool discovery and HTTP transport callbacks carry protocol values; optional SDK imports use Node module resolution and no native file identity or child process is defined here.
      */
     static upgrade(app: INestApplication, options?: McpAdaptor.IOptions): Promise<void>;
 }
+/**
+ * Types of {@link McpAdaptor}: the options of `upgrade` and the record of a
+ * registered tool.
+ *
+ * @evidence contracts/common.md#principled-implementation The class exposes one static entry point, so the adapter has no instance state: the tool list is closed over by the registered route handler.
+ * @evidence contracts/common.md#clear-and-simple-design One static method and two nested types.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It has no fixture or tool name, and the MCP SDK is loaded lazily so an application that never enables MCP does not need it.
+ * @evidence contracts/common.md#meaningful-documentation The class comment explains what an MCP route is and how to enable it.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation MCP tool discovery and HTTP transport callbacks carry protocol values; optional SDK imports use Node module resolution and no native file identity or child process is defined here.
+ */
 export declare namespace McpAdaptor {
-    /** Configuration options for {@link McpAdaptor.upgrade}. */
+    /**
+     * Configuration options for {@link McpAdaptor.upgrade}.
+     *
+     * @evidence contracts/common.md#principled-implementation The two options are the route path, with `/mcp` as the default, and the server information reported to clients, with a default name and version.
+     * @evidence contracts/common.md#clear-and-simple-design A flat record of two optional values.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a type; the defaults are stated in the code that reads them.
+     * @evidence contracts/common.md#meaningful-documentation Each option documents its meaning.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation MCP tool discovery and HTTP transport callbacks carry protocol values; optional SDK imports use Node module resolution and no native file identity or child process is defined here.
+     */
     interface IOptions {
         /**
          * HTTP path where the MCP endpoint will be mounted.

package/lib/adaptors/McpAdaptor.js

@@ -44,6 +44,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.McpAdaptor = void 0;
 const common_1 = require("@nestjs/common");
+const route_paramtypes_enum_1 = require("@nestjs/common/enums/route-paramtypes.enum");
+const injector_1 = require("@nestjs/core/injector/injector");
+const validate_request_body_1 = require("../decorators/internal/validate_request_body");
+const external_context_1 = require("./internal/external_context");
 /**
  * MCP (Model Context Protocol) adaptor.
  *
@@ -60,6 +64,11 @@ const common_1 = require("@nestjs/common");
  * registration API of `McpServer` is bypassed by accessing the low-level
  * `.server` handler.
  *
+ * A tool call passes the guards, interceptors, pipes, and exception filters
+ * NestJS applies to an HTTP route on the same method, with the MCP HTTP request
+ * as the execution context. The endpoint is mounted at `path` as given, outside
+ * the application's global prefix.
+ *
  * Error mapping follows the MCP specification:
  *
  * - Unknown tool name: JSON-RPC `-32601`.
@@ -70,14 +79,12 @@ const common_1 = require("@nestjs/common");
  *
  * @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 {
     /**
@@ -94,6 +101,11 @@ class McpAdaptor {
      *
      * @param app Running Nest application instance.
      * @param options Transport and identity overrides.
+     * @evidence contracts/common.md#principled-implementation Tools are collected once from the prototype chain of every controller instance by the `nestia/McpRoute` metadata, with the first definition of a property name winning and accessors skipped without execution, duplicates by tool name refused before serving, and each call runs through NestJS's `ExternalContextCreator` so guards, interceptors, pipes, and exception filters apply as for an HTTP route; every request gets a fresh MCP server and Streamable HTTP transport, which stateless mode requires, and both are closed in a `finally`.
+     * @evidence contracts/common.md#clear-and-simple-design One entry point does discovery and registration; the per-tool call (`createHandler`), the duplicate check, the SDK loader, and the per-request response facade are separate module-private functions.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Reading the module graph goes through the internal `app.container`, because `INestApplication` exposes no public accessor for it, `create_external_context_creator` constructs an owned subclass through the Nest constructor and overrides module selection on that type, because the default looks for provider classes while controllers belong to the controller collection, and `get_request_context_id` registers the request provider on the request object as NestJS's router does for an HTTP route, and a per-request response facade forwards native state, events and method receivers without replacing raw methods. After a tool or its exception filter has sent headers, only the facade suppresses subsequent transport writes and preserves callbacks and chaining. Native transport writes do not themselves activate takeover. The remaining foreign-internal reads are the application container and Nest request context registration; the MCP SDK uses its public Node response injection boundary.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the stateless mode, what is discovered, and that the SDK is an optional dependency; the options documentation states the path and server information.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation MCP tool discovery and HTTP transport callbacks carry protocol values; optional SDK imports use Node module resolution and no native file identity or child process is defined here.
      */
     static upgrade(app_1) {
         return __awaiter(this, arguments, void 0, function* (app, options = {}) {
@@ -103,7 +115,9 @@ class McpAdaptor {
                 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()) {
+            const injector = new injector_1.Injector();
+            for (const [moduleKey, module] of container.getModules()) {
+                const creator = (0, external_context_1.create_external_context_creator)(container, moduleKey);
                 for (const wrapper of module.controllers.values()) {
                     const instance = wrapper.instance;
                     if (!instance)
@@ -114,19 +128,26 @@ class McpAdaptor {
                             if (key === "constructor" || visited.has(key))
                                 continue;
                             visited.add(key);
-                            const method = proto[key];
+                            // Route discovery inspects data descriptors without invoking accessors.
+                            const method = (_a = Object.getOwnPropertyDescriptor(proto, key)) === null || _a === void 0 ? void 0 : _a.value;
                             if (typeof method !== "function")
                                 continue;
                             const meta = Reflect.getMetadata("nestia/McpRoute", method);
                             if (!meta)
                                 continue;
                             const params = (_d = Reflect.getMetadata("nestia/McpRoute/Parameters", proto, key)) !== null && _d !== void 0 ? _d : [];
-                            const paramValidator = (_a = params.find((p) => p.category === "params")) === null || _a === void 0 ? void 0 : _a.validate;
                             tools.push({
                                 meta,
                                 source: `${(_f = (_e = (_b = wrapper.metatype) === null || _b === void 0 ? void 0 : _b.name) !== null && _e !== void 0 ? _e : (_c = proto.constructor) === null || _c === void 0 ? void 0 : _c.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); }),
+                                handler: createHandler({
+                                    container,
+                                    injector,
+                                    creator,
+                                    module,
+                                    wrapper,
+                                    key,
+                                    argument: params.find((p) => p.category === "params"),
+                                }),
                             });
                         }
                     }
@@ -148,6 +169,7 @@ class McpAdaptor {
                     capabilities: { tools: {} },
                 });
                 const server = mcp.server;
+                const relay = transportResponse((_a = res.raw) !== null && _a !== void 0 ? _a : res);
                 server.setRequestHandler(ListToolsRequestSchema, () => __awaiter(this, void 0, void 0, function* () {
                     return ({
                         tools: tools.map((t) => ({
@@ -166,23 +188,16 @@ class McpAdaptor {
                     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);
+                        const result = yield tool.handler({
+                            request: req,
+                            response: res,
+                            args,
+                        });
+                        if (relay.takeOver())
+                            return { content: [] };
+                        if (result instanceof Error)
+                            throw result;
                         if (result === undefined)
                             return { content: [] };
                         return {
@@ -195,6 +210,18 @@ class McpAdaptor {
                         };
                     }
                     catch (e) {
+                        if (relay.takeOver())
+                            return { content: [] };
+                        if (INVALID_ARGUMENTS.has(e)) {
+                            const body = e.getResponse();
+                            throw new McpError(ErrorCode.InvalidParams, e.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,
+                            });
+                        }
                         if (e instanceof common_1.HttpException) {
                             return {
                                 content: [{ type: "text", text: e.message }],
@@ -210,7 +237,7 @@ class McpAdaptor {
                 });
                 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);
+                    yield transport.handleRequest((_b = req.raw) !== null && _b !== void 0 ? _b : req, relay.response, req.body);
                 }
                 finally {
                     yield transport.close().catch(() => { });
@@ -221,6 +248,105 @@ class McpAdaptor {
     }
 }
 exports.McpAdaptor = McpAdaptor;
+/**
+ * The tool's call through the enhancers NestJS applies to a route of the same
+ * method: guards, interceptors, pipes, and exception filters, bound to the
+ * method, its controller, or globally. The MCP HTTP request is the execution
+ * context, so a guard reading `switchToHttp().getRequest()` works unchanged.
+ *
+ * The arguments reach the method through the pipes as its body would, validated
+ * by typia at that stage: after the guards, as `@TypedBody()` is. An invalid
+ * argument is thrown as the validator's `BadRequestException`, which an
+ * exception filter may map; unmapped, it becomes JSON-RPC `-32602`. Successful
+ * resolver data becomes the argument before pipes execute. Legacy error-only
+ * metadata callbacks retain raw input on null success.
+ *
+ * A controller that is request-scoped, itself or through an enhancer or a
+ * dependency, is built per request with its enhancers, as NestJS builds it for
+ * an HTTP route; the static instance is only a placeholder without them.
+ */
+const createHandler = (props) => {
+    var _a, _b;
+    var _c;
+    // the arguments stand at the params' position, or first when undecorated
+    const index = (_c = (_a = props.argument) === null || _a === void 0 ? void 0 : _a.index) !== null && _c !== void 0 ? _c : 0;
+    Reflect.defineMetadata(PARAMS_METADATA, { [`${route_paramtypes_enum_1.RouteParamtypes.BODY}:${index}`]: { index, data: undefined } }, props.wrapper.instance.constructor, props.key);
+    const validate = (_b = props.argument) === null || _b === void 0 ? void 0 : _b.validate;
+    const create = (instance, contextId) => props.creator.create(instance, instance[props.key], props.key, PARAMS_METADATA, {
+        // [request, response, next] as an HTTP route has, then the arguments
+        exchangeKeyForValue: (_type, _data, [, , , args]) => {
+            if (!validate)
+                return args;
+            const result = (0, validate_request_body_1.resolve_request_body)(validate, args);
+            if (result.success)
+                return result.data;
+            INVALID_ARGUMENTS.add(result.error);
+            throw result.error;
+        },
+    }, contextId, contextId && props.wrapper.id);
+    let target;
+    return (input) => __awaiter(void 0, void 0, void 0, function* () {
+        const call = (fn) => fn(input.request, input.response, undefined, input.args);
+        // resolved at the first call, so global enhancers init() registers count
+        if (props.wrapper.isDependencyTreeStatic())
+            return call((target !== null && target !== void 0 ? target : (target = create(props.wrapper.instance))));
+        const contextId = (0, external_context_1.get_request_context_id)(props.container, input.request, props.wrapper.isDependencyTreeDurable());
+        const instance = yield props.injector.loadPerContext(props.wrapper.instance, props.module, props.module.controllers, contextId);
+        return call(create(instance, contextId));
+    });
+};
+/**
+ * The transport's response view. Native state, events and method receivers stay
+ * on the real response; only this view's writes stop after a tool's exception
+ * filter has already answered. Normal transport writes never activate
+ * takeover.
+ */
+const transportResponse = (raw) => {
+    let takenOver = false;
+    const respond = (key, args) => {
+        if (takenOver) {
+            const callback = args.find((arg) => typeof arg === "function");
+            if ((key === "write" || key === "end") && typeof callback === "function")
+                queueMicrotask(() => callback());
+            return key === "write"
+                ? true
+                : key === "flushHeaders"
+                    ? undefined
+                    : response;
+        }
+        const result = Reflect.apply(raw[key], raw, args);
+        return result === raw ? response : result;
+    };
+    const writes = new Map(["writeHead", "flushHeaders", "write", "end"].map((key) => [
+        key,
+        (...args) => respond(key, args),
+    ]));
+    const response = new Proxy(raw, {
+        get: (target, key) => {
+            const write = writes.get(key);
+            if (write !== undefined)
+                return write;
+            const value = Reflect.get(target, key, target);
+            if (typeof value !== "function")
+                return value;
+            return (...args) => {
+                const result = Reflect.apply(value, target, args);
+                return result === target ? response : result;
+            };
+        },
+        set: (target, key, value) => Reflect.set(target, key, value, target),
+    });
+    return {
+        response,
+        takeOver: () => {
+            takenOver || (takenOver = raw.headersSent === true);
+            return takenOver;
+        },
+    };
+};
+const PARAMS_METADATA = "nestia/McpRoute/ExternalParameters";
+/** The validators' exceptions, told apart from a handler's own. */
+const INVALID_ARGUMENTS = new WeakSet();
 const assertUniqueTools = (tools) => {
     var _a;
     const dict = new Map();

package/lib/adaptors/McpAdaptor.js.map

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

package/lib/adaptors/WebSocketAdaptor.d.ts

@@ -1,6 +1,43 @@
 import { INestApplication } from "@nestjs/common";
+/**
+ * Serves the `@WebSocketRoute()` methods of a NestJS application over
+ * WebSocket.
+ *
+ * Call {@link upgrade} after the application has been created. It finds the
+ * routes, checks them, and takes over the HTTP server's `upgrade` events. A
+ * handshake whose path matches no route is rejected with close code 1002.
+ *
+ * @evidence contracts/common.md#principled-implementation Routes are matched by paths built from the global prefix, the version, the module prefix, the controller path, and the method path, joined and normalized the same way for every combination; the adapter answers upgrade events itself through a `ws` server in no-server mode and removes its listeners when the HTTP server closes.
+ * @evidence contracts/common.md#clear-and-simple-design A class with one static factory, one `close` property, and the private handler; discovery, method checks, termination, and close reasons are module-private functions.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The global prefix, versioning options, and module graph are read from `app.config` and `app.container`, which NestJS keeps internal because `INestApplication` has no public accessor for them; this is the limitation of the adapter, not a fixture-specific branch.
+ * @evidence contracts/common.md#meaningful-documentation The comment states when to call it and what happens to an unmatched handshake.
+ * @evidence contracts/portability.md#os-neutral-implementation Diagnostic source URLs are converted by fileURLToPath before path.relative uses native paths; route matching uses HTTP path segments separately from filesystem paths. No filesystem case policy is inferred from the OS.
+ */
 export declare class WebSocketAdaptor {
+    /**
+     * Creates the adapter for the application: it visits every controller,
+     * validates the WebSocket routes, and starts listening for upgrade events.
+     *
+     * All route errors of the application are collected and thrown together, with
+     * the controller, method, source location, and reasons of each.
+     *
+     * @evidence contracts/common.md#principled-implementation Controller data-method descriptors are checked before any handshake is served, with child properties shadowing inherited methods and accessors never executed, and all defects are reported in one error, so a misconfigured route fails at start and not at the first client; source locations come from `get-function-location`, converted with `fileURLToPath` so a `file:` URL becomes the path on every platform.
+     * @evidence contracts/common.md#clear-and-simple-design One asynchronous factory that awaits the visitor and hands the operator list to the private constructor.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The visitor reports through the same error path for every controller; no controller or route name is special-cased.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the collected error report and the effect on the server.
+     * @evidence contracts/portability.md#os-neutral-implementation Diagnostic source URLs are converted by fileURLToPath before path.relative uses native paths; route matching uses HTTP path segments separately from filesystem paths. No filesystem case policy is inferred from the OS.
+     */
     static upgrade(app: INestApplication): Promise<WebSocketAdaptor>;
+    /**
+     * Stops the adapter: removes its listeners from the HTTP server and closes
+     * the WebSocket server.
+     *
+     * @evidence contracts/common.md#principled-implementation The listeners are removed before the `ws` server closes, so no upgrade event reaches a closing server, and the returned promise resolves when the server has closed.
+     * @evidence contracts/common.md#clear-and-simple-design An arrow property so the same function value can be registered and unregistered as the HTTP server's close listener.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It releases exactly what the adapter registered.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what is released.
+     * @evidence contracts/portability.md#os-neutral-implementation Diagnostic source URLs are converted by fileURLToPath before path.relative uses native paths; route matching uses HTTP path segments separately from filesystem paths. No filesystem case policy is inferred from the OS.
+     */
     readonly close: () => Promise<void>;
     private constructor();
     private readonly handleUpgrade;