@nestia/sdk 14.0.0 → 14.0.2

package/lib/analyses/ReflectHttpOperationParameterAnalyzer.d.ts

@@ -2,7 +2,26 @@ import { IOperationMetadata } from "../structures/IOperationMetadata";
 import { IReflectController } from "../structures/IReflectController";
 import { IReflectHttpOperationParameter } from "../structures/IReflectHttpOperationParameter";
 import { IReflectOperationError } from "../structures/IReflectOperationError";
+/**
+ * Reflects the parameters of a route method.
+ *
+ * @evidence contracts/common.md#principled-implementation Nest's route argument metadata gives each parameter's category and position, the nestia decorators are recognized by the name of their factory function, the metadata of the transform gives the type, and the wire rules of the HTTP input are checked against it.
+ * @evidence contracts/common.md#clear-and-simple-design One public function with private classification and duplicate checks.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The recognition by factory name couples this package to the function names of `@nestia/core`, a contract between the two packages.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationParameterAnalyzer analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 export declare namespace ReflectHttpOperationParameterAnalyzer {
+    /**
+     * The input of the parameter analysis: the controller, the method, its name,
+     * the HTTP method, the metadata, and the error list.
+     *
+     * @evidence contracts/common.md#principled-implementation The record holds what the analysis needs.
+     * @evidence contracts/common.md#clear-and-simple-design A flat record with no behavior.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a type and adds no runtime behavior.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the type describes and the meaning of its members.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationParameterAnalyzer.IContext analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     interface IContext {
         controller: IReflectController;
         function: Function;
@@ -11,5 +30,17 @@ export declare namespace ReflectHttpOperationParameterAnalyzer {
         metadata: IOperationMetadata;
         errors: IReflectOperationError[];
     }
+    /**
+     * Returns the parameters of a route method in position order.
+     *
+     * Contradictions, such as a body on GET, duplicated bodies or fields,
+     * unreadable types, and types the HTTP input cannot carry, are errors.
+     *
+     * @evidence contracts/common.md#principled-implementation Contradictions are collected first, each parameter is composed with the schema that matches its content type, its wire rules are checked, unnamed parameters are named, and duplicate keys between field parameters and objects are reported.
+     * @evidence contracts/common.md#clear-and-simple-design One function that gathers every error before returning.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Every rule follows the HTTP or NestJS contract, and a parameter that cannot be sent is an error, not silently dropped.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the errors.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationParameterAnalyzer.analyze analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const analyze: (ctx: IContext) => IReflectHttpOperationParameter[];
 }

package/lib/analyses/ReflectHttpOperationParameterAnalyzer.js

@@ -1,14 +1,46 @@
 "use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReflectHttpOperationParameterAnalyzer = void 0;
 const constants_1 = require("@nestjs/common/constants");
 const route_paramtypes_enum_1 = require("@nestjs/common/enums/route-paramtypes.enum");
 const legacy_1 = require("../internal/legacy");
-const HttpHeadersValidator_1 = require("../validators/HttpHeadersValidator");
-const HttpQueryValidator_1 = require("../validators/HttpQueryValidator");
 const TextPlainValidator_1 = require("../validators/TextPlainValidator");
+const ParameterNameAnalyzer_1 = require("./ParameterNameAnalyzer");
+const SwaggerExampleAnalyzer_1 = require("./SwaggerExampleAnalyzer");
+/**
+ * Reflects the parameters of a route method.
+ *
+ * @evidence contracts/common.md#principled-implementation Nest's route argument metadata gives each parameter's category and position, the nestia decorators are recognized by the name of their factory function, the metadata of the transform gives the type, and the wire rules of the HTTP input are checked against it.
+ * @evidence contracts/common.md#clear-and-simple-design One public function with private classification and duplicate checks.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The recognition by factory name couples this package to the function names of `@nestia/core`, a contract between the two packages.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationParameterAnalyzer analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 var ReflectHttpOperationParameterAnalyzer;
 (function (ReflectHttpOperationParameterAnalyzer) {
+    /**
+     * Returns the parameters of a route method in position order.
+     *
+     * Contradictions, such as a body on GET, duplicated bodies or fields,
+     * unreadable types, and types the HTTP input cannot carry, are errors.
+     *
+     * @evidence contracts/common.md#principled-implementation Contradictions are collected first, each parameter is composed with the schema that matches its content type, its wire rules are checked, unnamed parameters are named, and duplicate keys between field parameters and objects are reported.
+     * @evidence contracts/common.md#clear-and-simple-design One function that gathers every error before returning.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Every rule follows the HTTP or NestJS contract, and a parameter that cannot be sent is an error, not silently dropped.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the errors.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationParameterAnalyzer.analyze analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     ReflectHttpOperationParameterAnalyzer.analyze = (ctx) => {
         const preconfigured = analyzePreconfigured(ctx);
         const errors = [];
@@ -44,7 +76,9 @@ var ReflectHttpOperationParameterAnalyzer;
         if (isUnique(preconfigured
             .filter((x) => x.category === "headers")
             .map((x) => x.field)
-            .filter((field) => field !== undefined)) === false)
+            .filter((field) => field !== undefined)
+            // NestJS reads `req.headers[name.toLowerCase()]`
+            .map((field) => field.toLowerCase())) === false)
             contradict(`Duplicated field names of headers are not allowed.`);
         if (contradictErrors.length)
             errors.push({
@@ -57,9 +91,10 @@ var ReflectHttpOperationParameterAnalyzer;
         //----
         // COMPOSE PARAMETERS
         //----
-        const parameters = preconfigured
+        const declared = preconfigured
             .map((p) => {
-            var _a, _b, _c;
+            var _a;
+            var _b, _c, _d, _e;
             // METADATA INFO
             const pErrorContents = [];
             const matched = ctx.metadata.parameters.find((x) => x.index === p.index);
@@ -68,7 +103,8 @@ var ReflectHttpOperationParameterAnalyzer;
                     file: ctx.controller.file,
                     class: ctx.controller.class.name,
                     function: ctx.functionName,
-                    from: `parameter ${matched ? JSON.stringify(matched.name) : `of ${p.index} th`}`,
+                    // a destructured parameter has no name to report
+                    from: `parameter ${(matched === null || matched === void 0 ? void 0 : matched.name) ? JSON.stringify(matched.name) : `of ${p.index} th`}`,
                     contents: pErrorContents,
                 });
                 return null;
@@ -79,55 +115,138 @@ var ReflectHttpOperationParameterAnalyzer;
             else if (matched.type === null)
                 pErrorContents.push(`Failed to get the type info.`);
             // CONSIDER KIND
-            const schema = (() => {
+            const pipe = (() => {
                 if (matched === undefined)
                     return null;
-                const result = p.category === "body" &&
+                return p.category === "body" &&
                     (p.contentType === "application/json" || p.encrypted === true)
                     ? matched.primitive
                     : matched.resolved;
-                return result.success ? result.data : null;
             })();
+            const schema = (pipe === null || pipe === void 0 ? void 0 : pipe.success) === true ? pipe.data : null;
+            // A type the metadata analysis could not read has no SDK or Swagger
+            // form; dropping the parameter would leave a function that cannot
+            // send what the route requires.
+            if ((pipe === null || pipe === void 0 ? void 0 : pipe.success) === false)
+                pErrorContents.push(...pipe.errors);
             if (p.category === "body" && p.field !== undefined)
                 pErrorContents.push(`@Body() must not have a field name.`);
             else if (p.category === "param" && p.field === undefined)
                 pErrorContents.push(`@Param() must have a field name.`);
+            // The wire rules of the parameter's HTTP input: a type they reject
+            // cannot be carried as a query string, headers, a path segment, or a
+            // form, so the SDK would send garbage and the document would lie.
+            const rule = httpRuleOf(p);
+            if (rule !== null && schema !== null)
+                pErrorContents.push(...((_b = (_a = schema.http) === null || _a === void 0 ? void 0 : _a[rule]) !== null && _b !== void 0 ? _b : []));
             if (pErrorContents.length)
                 return report();
             else if (matched === undefined ||
                 matched.type === null ||
                 schema === null)
                 return null; // unreachable
-            const example = ((_a = Reflect.getMetadata("nestia/SwaggerExample/Parameters", ctx.controller.class.prototype, ctx.functionName)) !== null && _a !== void 0 ? _a : []).find((x) => x.index === matched.index);
+            const { http: _http } = schema, shape = __rest(schema, ["http"]);
+            const example = ((_c = Reflect.getMetadata("nestia/SwaggerExample/Parameters", ctx.controller.class.prototype, ctx.functionName)) !== null && _c !== void 0 ? _c : []).find((x) => x.index === matched.index);
             // COMPOSITION
             if (p.category === "param")
-                return Object.assign({ category: p.category, index: p.index, field: p.field, name: matched.name, type: matched.type, validate: legacy_1.HttpParameterProgrammer.validate, description: matched.description, jsDocTags: matched.jsDocTags, example: example === null || example === void 0 ? void 0 : example.example, examples: example === null || example === void 0 ? void 0 : example.examples }, schema);
+                return Object.assign({ category: p.category, index: p.index, field: p.field, name: matched.name, type: matched.type, description: matched.description, jsDocTags: matched.jsDocTags, example: example === null || example === void 0 ? void 0 : example.example, examples: SwaggerExampleAnalyzer_1.SwaggerExampleAnalyzer.examples(example) }, shape);
             else if (p.category === "query")
-                return Object.assign({ category: p.category, index: p.index, field: (_b = p.field) !== null && _b !== void 0 ? _b : null, name: matched.name, type: matched.type, validate: p.field
-                        ? HttpQueryValidator_1.HttpQueryValidator.validate
-                        : legacy_1.HttpQueryProgrammer.validate, description: matched.description, jsDocTags: matched.jsDocTags, example: example === null || example === void 0 ? void 0 : example.example, examples: example === null || example === void 0 ? void 0 : example.examples }, schema);
+                return Object.assign({ category: p.category, index: p.index, field: (_d = p.field) !== null && _d !== void 0 ? _d : null, name: matched.name, type: matched.type, description: matched.description, jsDocTags: matched.jsDocTags, example: example === null || example === void 0 ? void 0 : example.example, examples: SwaggerExampleAnalyzer_1.SwaggerExampleAnalyzer.examples(example) }, shape);
             else if (p.category === "headers")
-                return Object.assign({ category: p.category, index: p.index, field: (_c = p.field) !== null && _c !== void 0 ? _c : null, name: matched.name, type: matched.type, validate: p.field
-                        ? HttpHeadersValidator_1.HttpHeadersValidator.validate
-                        : legacy_1.HttpHeadersProgrammer.validate, description: matched.description, jsDocTags: matched.jsDocTags, example: example === null || example === void 0 ? void 0 : example.example, examples: example === null || example === void 0 ? void 0 : example.examples }, schema);
+                return Object.assign({ category: p.category, index: p.index, field: (_e = p.field) !== null && _e !== void 0 ? _e : null, name: matched.name, type: matched.type, description: matched.description, jsDocTags: matched.jsDocTags, example: example === null || example === void 0 ? void 0 : example.example, examples: SwaggerExampleAnalyzer_1.SwaggerExampleAnalyzer.examples(example) }, shape);
             else if (p.category === "body")
                 return Object.assign({ category: p.category, index: p.index, encrypted: !!p.encrypted, contentType: p.contentType, name: matched.name, type: matched.type, validate: p.contentType === "application/json" || p.encrypted === true
                         ? legacy_1.JsonMetadataFactory.validate
-                        : p.contentType === "application/x-www-form-urlencoded"
-                            ? legacy_1.HttpQueryProgrammer.validate
-                            : p.contentType === "multipart/form-data"
-                                ? legacy_1.HttpFormDataProgrammer.validate
-                                : TextPlainValidator_1.TextPlainValidator.validate, description: matched.description, jsDocTags: matched.jsDocTags, example: example === null || example === void 0 ? void 0 : example.example, examples: example === null || example === void 0 ? void 0 : example.examples }, schema);
+                        : p.contentType === "text/plain"
+                            ? TextPlainValidator_1.TextPlainValidator.validate
+                            : undefined, description: matched.description, jsDocTags: matched.jsDocTags, example: example === null || example === void 0 ? void 0 : example.example, examples: SwaggerExampleAnalyzer_1.SwaggerExampleAnalyzer.examples(example) }, shape);
             else {
                 pErrorContents.push(`Unknown kind of the parameter.`);
                 return report();
             }
         })
             .filter((x) => x !== null);
+        // a destructured parameter declares no name, so it is given one
+        const parameters = ParameterNameAnalyzer_1.ParameterNameAnalyzer.name(declared);
+        const duplicated = findDuplicatedKeys(parameters);
+        if (duplicated.length)
+            errors.push({
+                file: ctx.controller.file,
+                class: ctx.controller.class.name,
+                function: ctx.functionName,
+                from: "",
+                contents: duplicated,
+            });
         if (errors.length)
             ctx.errors.push(...errors);
         return parameters;
     };
+    /**
+     * The HTTP input rules a parameter's type must satisfy, or `null` for a JSON
+     * or text body, whose policies are checked on the TypeScript side.
+     *
+     * The rules are typia's, baked per parameter by the SDK transform (see
+     * `nestiaSDKHttpRules`), because only this analyzer knows the decorator. A
+     * typed decorator was already held to them by the core transform, so the
+     * verdict is only news for a vanilla `@Query()`, `@Headers()`, or `@Param()`,
+     * which no transform touches.
+     */
+    const httpRuleOf = (p) => {
+        if (p.category === "param")
+            return "param";
+        else if (p.category === "query")
+            return p.field !== undefined ? "field" : "query";
+        else if (p.category === "headers")
+            return p.field !== undefined ? "field" : "headers";
+        else if (p.contentType === "application/x-www-form-urlencoded")
+            return "query";
+        else if (p.contentType === "multipart/form-data")
+            return "formData";
+        return null;
+    };
+    /**
+     * Reports a query key or header both a field parameter and the object
+     * parameter of its category declare.
+     *
+     * On the wire they are one key: NestJS hands both parameters the same
+     * `req.query.keyword`, and header names match case-insensitively, as NestJS
+     * lowercases the name a `@Headers("X-Tenant")` reads. Documenting both lists
+     * one `name` + `in` pair twice, which OpenAPI forbids, and the SDK would ask
+     * its caller for the same key twice and send one of the two values. Like two
+     * field parameters of the same name, the declaration is contradictory.
+     */
+    const findDuplicatedKeys = (parameters) => {
+        const messages = [];
+        for (const [category, normalize, noun] of [
+            ["query", (key) => key, "Query key"],
+            ["headers", (key) => key.toLowerCase(), "Header"],
+        ]) {
+            const fields = new Map();
+            for (const p of parameters)
+                if (p.category === category && p.field !== null)
+                    fields.set(normalize(p.field), p.field);
+            for (const p of parameters) {
+                if (p.category !== category || p.field !== null)
+                    continue;
+                for (const key of objectKeys(p)) {
+                    const field = fields.get(normalize(key));
+                    if (field !== undefined)
+                        messages.push(`${noun} ${JSON.stringify(field)} is declared both by a field parameter and by the ${category} object.`);
+                }
+            }
+        }
+        return messages;
+    };
+    /** Literal property keys of an object parameter's object type. */
+    const objectKeys = (p) => {
+        var _a;
+        var _b;
+        const name = (_a = p.metadata.objects[0]) === null || _a === void 0 ? void 0 : _a.name;
+        const object = p.components.objects.find((o) => o.name === name);
+        return ((_b = object === null || object === void 0 ? void 0 : object.properties) !== null && _b !== void 0 ? _b : [])
+            .map((property) => { var _a, _b; return (_b = (_a = property.key.constants[0]) === null || _a === void 0 ? void 0 : _a.values[0]) === null || _b === void 0 ? void 0 : _b.value; })
+            .filter((key) => typeof key === "string");
+    };
     const analyzePreconfigured = (props) => {
         const dict = Reflect.getMetadata(constants_1.ROUTE_ARGS_METADATA, props.controller.class, props.functionName);
         if (dict === undefined)
@@ -141,7 +260,8 @@ var ReflectHttpOperationParameterAnalyzer;
         const symbol = key.split(":")[0];
         if (symbol.indexOf("__custom") !== -1)
             return analyzeCustomParameter(param);
-        const category = getNestParamType(Number(symbol[0]));
+        // the whole number: `RAW_BODY` is 12, which the first digit misread as 1
+        const category = getNestParamType(Number(symbol));
         if (category === null)
             return null;
         if (category === "body")

package/lib/analyses/ReflectHttpOperationParameterAnalyzer.js.map

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

package/lib/analyses/ReflectHttpOperationResponseAnalyzer.d.ts

@@ -2,7 +2,26 @@ import { IOperationMetadata } from "../structures/IOperationMetadata";
 import { IReflectController } from "../structures/IReflectController";
 import { IReflectHttpOperationSuccess } from "../structures/IReflectHttpOperationSuccess";
 import { IReflectOperationError } from "../structures/IReflectOperationError";
+/**
+ * Reflects the success response of a route method.
+ *
+ * @evidence contracts/common.md#principled-implementation The content type comes from the encryption and query interceptors, then the headers metadata, then the produces metadata, then the method default; the status comes from the HTTP code metadata or the method default; binary types skip the schema.
+ * @evidence contracts/common.md#clear-and-simple-design One public function with small private helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The order follows how NestJS and nestia decorate a route.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationResponseAnalyzer analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 export declare namespace ReflectHttpOperationResponseAnalyzer {
+    /**
+     * The input of the response analysis: the controller, the method, its name,
+     * the HTTP method, the metadata, and the error list.
+     *
+     * @evidence contracts/common.md#principled-implementation The record holds what the analysis needs.
+     * @evidence contracts/common.md#clear-and-simple-design A flat record with no behavior.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a type and adds no runtime behavior.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the type describes and the meaning of its members.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationResponseAnalyzer.IContext analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     interface IContext {
         controller: IReflectController;
         function: Function;
@@ -11,5 +30,18 @@ export declare namespace ReflectHttpOperationResponseAnalyzer {
         metadata: IOperationMetadata;
         errors: IReflectOperationError[];
     }
+    /**
+     * Returns the success response of a method, or `null` when it cannot be
+     * described; the reasons are pushed to the errors.
+     *
+     * A HEAD method must have no content type, and an unsupported content type is
+     * an error.
+     *
+     * @evidence contracts/common.md#principled-implementation The schema is the primitive form for JSON and the resolved form for other types, the validator depends on the content type, and the status defaults to 201 for POST and 200 otherwise.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The defaults are NestJS's.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the null result and the two errors.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationResponseAnalyzer.analyze analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const analyze: (ctx: IContext) => IReflectHttpOperationSuccess | null;
 }

package/lib/analyses/ReflectHttpOperationResponseAnalyzer.js

@@ -5,8 +5,31 @@ const constants_1 = require("@nestjs/common/constants");
 const legacy_1 = require("../internal/legacy");
 const HttpResponseContentTypeUtil_1 = require("../utils/HttpResponseContentTypeUtil");
 const TextPlainValidator_1 = require("../validators/TextPlainValidator");
+const SwaggerExampleAnalyzer_1 = require("./SwaggerExampleAnalyzer");
+/**
+ * Reflects the success response of a route method.
+ *
+ * @evidence contracts/common.md#principled-implementation The content type comes from the encryption and query interceptors, then the headers metadata, then the produces metadata, then the method default; the status comes from the HTTP code metadata or the method default; binary types skip the schema.
+ * @evidence contracts/common.md#clear-and-simple-design One public function with small private helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The order follows how NestJS and nestia decorate a route.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationResponseAnalyzer analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 var ReflectHttpOperationResponseAnalyzer;
 (function (ReflectHttpOperationResponseAnalyzer) {
+    /**
+     * Returns the success response of a method, or `null` when it cannot be
+     * described; the reasons are pushed to the errors.
+     *
+     * A HEAD method must have no content type, and an unsupported content type is
+     * an error.
+     *
+     * @evidence contracts/common.md#principled-implementation The schema is the primitive form for JSON and the resolved form for other types, the validator depends on the content type, and the status defaults to 201 for POST and 200 otherwise.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The defaults are NestJS's.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the null result and the two errors.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationResponseAnalyzer.analyze analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     ReflectHttpOperationResponseAnalyzer.analyze = (ctx) => {
         var _a, _b, _c;
         var _d, _e, _f, _g;
@@ -61,12 +84,14 @@ var ReflectHttpOperationResponseAnalyzer;
                 : contentType === "application/json" || encrypted === true
                     ? legacy_1.JsonMetadataFactory.validate
                     : contentType === "application/x-www-form-urlencoded"
-                        ? legacy_1.HttpQueryProgrammer.validate
+                        ? // a typed query response, held to typia's query rules by the
+                            // core transform
+                            undefined
                         : contentType === "text/plain"
                             ? TextPlainValidator_1.TextPlainValidator.validate
                             : (next) => (0, legacy_1.sizeOf)(next.metadata) !== 0
                                 ? ["HEAD method must not have any return value."]
-                                : [], example: example === null || example === void 0 ? void 0 : example.example, examples: example === null || example === void 0 ? void 0 : example.examples });
+                                : [], example: example === null || example === void 0 ? void 0 : example.example, examples: SwaggerExampleAnalyzer_1.SwaggerExampleAnalyzer.examples(example) });
     };
     const getStatus = (func) => {
         const text = Reflect.getMetadata(constants_1.HTTP_CODE_METADATA, func);

package/lib/analyses/ReflectHttpOperationResponseAnalyzer.js.map

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

package/lib/analyses/ReflectMcpOperationAnalyzer.d.ts

@@ -2,7 +2,26 @@ import { INestiaProject } from "../structures/INestiaProject";
 import { IOperationMetadata } from "../structures/IOperationMetadata";
 import { IReflectController } from "../structures/IReflectController";
 import { IReflectMcpOperation } from "../structures/IReflectMcpOperation";
+/**
+ * Reflects an `@McpRoute` method into a tool operation.
+ *
+ * @evidence contracts/common.md#principled-implementation The tool definition comes from the route metadata, the single params parameter is matched with its compile-time type, and combinations with HTTP or WebSocket decorators and extra parameters are errors.
+ * @evidence contracts/common.md#clear-and-simple-design One public function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The rules follow the decorator contract.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectMcpOperationAnalyzer analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 export declare namespace ReflectMcpOperationAnalyzer {
+    /**
+     * The input of the MCP operation analysis: the project, the controller, the
+     * method, and its metadata.
+     *
+     * @evidence contracts/common.md#principled-implementation The record holds what the analysis needs.
+     * @evidence contracts/common.md#clear-and-simple-design A flat record with no behavior.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a type and adds no runtime behavior.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the type describes and the meaning of its members.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectMcpOperationAnalyzer.IProps analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     interface IProps {
         project: Omit<INestiaProject, "config">;
         controller: IReflectController;
@@ -10,5 +29,15 @@ export declare namespace ReflectMcpOperationAnalyzer {
         name: string;
         metadata: IOperationMetadata;
     }
+    /**
+     * Returns the tool operation of a method, or `null` when the method is not an
+     * MCP route or has errors.
+     *
+     * @evidence contracts/common.md#principled-implementation The method is an MCP route when it carries the route metadata; at most one params parameter is allowed and the function may have at most one argument; the return type and imports come from the metadata.
+     * @evidence contracts/common.md#clear-and-simple-design One function that collects errors once and reports them together.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The rules follow the decorator contract.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the null result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectMcpOperationAnalyzer.analyze analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const analyze: (ctx: IProps) => IReflectMcpOperation | null;
 }

package/lib/analyses/ReflectMcpOperationAnalyzer.js

@@ -3,11 +3,31 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReflectMcpOperationAnalyzer = void 0;
 const constants_1 = require("@nestjs/common/constants");
 const ImportAnalyzer_1 = require("./ImportAnalyzer");
+const ParameterNameAnalyzer_1 = require("./ParameterNameAnalyzer");
+/**
+ * Reflects an `@McpRoute` method into a tool operation.
+ *
+ * @evidence contracts/common.md#principled-implementation The tool definition comes from the route metadata, the single params parameter is matched with its compile-time type, and combinations with HTTP or WebSocket decorators and extra parameters are errors.
+ * @evidence contracts/common.md#clear-and-simple-design One public function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The rules follow the decorator contract.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectMcpOperationAnalyzer analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 var ReflectMcpOperationAnalyzer;
 (function (ReflectMcpOperationAnalyzer) {
+    /**
+     * Returns the tool operation of a method, or `null` when the method is not an
+     * MCP route or has errors.
+     *
+     * @evidence contracts/common.md#principled-implementation The method is an MCP route when it carries the route metadata; at most one params parameter is allowed and the function may have at most one argument; the return type and imports come from the metadata.
+     * @evidence contracts/common.md#clear-and-simple-design One function that collects errors once and reports them together.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The rules follow the decorator contract.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the null result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectMcpOperationAnalyzer.analyze analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     ReflectMcpOperationAnalyzer.analyze = (ctx) => {
-        var _a, _b, _c;
-        var _d, _e, _f, _g, _h, _j, _k;
+        var _a, _b, _c, _d;
+        var _e, _f, _g, _h, _j, _k, _l;
         const route = Reflect.getMetadata("nestia/McpRoute", ctx.function);
         if (route === undefined)
             return null;
@@ -17,13 +37,13 @@ var ReflectMcpOperationAnalyzer;
         const hasWebSocketRoute = Reflect.getMetadata("nestia/WebSocketRoute", ctx.function) !== undefined;
         if (hasHttpRoute || hasWebSocketRoute)
             errors.push("@McpRoute must not be combined with HTTP or WebSocket route decorators on the same method.");
-        const preconfigured = ((_d = Reflect.getMetadata("nestia/McpRoute/Parameters", ctx.controller.class.prototype, ctx.name)) !== null && _d !== void 0 ? _d : []).sort((a, b) => a.index - b.index);
+        const preconfigured = ((_e = Reflect.getMetadata("nestia/McpRoute/Parameters", ctx.controller.class.prototype, ctx.name)) !== null && _e !== void 0 ? _e : []).sort((a, b) => a.index - b.index);
         if (preconfigured.length > 1)
             errors.push("@McpRoute tools may declare at most one @McpRoute.Params() parameter.");
         if (ctx.function.length > 1)
             errors.push("@McpRoute tools must have 0 or 1 parameters (the MCP arguments object).");
         const imports = [];
-        const parameters = preconfigured
+        const declared = preconfigured
             .map((p) => {
             const matched = ctx.metadata.parameters.find((m) => p.index === m.index);
             if (matched === undefined) {
@@ -31,7 +51,7 @@ var ReflectMcpOperationAnalyzer;
                 return null;
             }
             if (matched.type === null) {
-                errors.push(`Failed to analyze the parameter type of ${JSON.stringify(matched.name)}.`);
+                errors.push(`Failed to analyze the parameter type of ${matched.name ? JSON.stringify(matched.name) : `the ${p.index} (th) argument`}.`);
                 return null;
             }
             imports.push(...matched.imports);
@@ -40,12 +60,15 @@ var ReflectMcpOperationAnalyzer;
                 name: matched.name,
                 index: p.index,
                 type: matched.type,
+                metadata: matched.primitive,
                 imports: matched.imports,
                 description: matched.description,
                 jsDocTags: matched.jsDocTags,
             };
         })
             .filter((p) => !!p);
+        // a destructured parameter declares no name, so it is given one
+        const parameters = ParameterNameAnalyzer_1.ParameterNameAnalyzer.name(declared);
         if ((_b = (_a = ctx.metadata.success) === null || _a === void 0 ? void 0 : _a.imports) === null || _b === void 0 ? void 0 : _b.length)
             imports.push(...ctx.metadata.success.imports);
         if (errors.length) {
@@ -62,16 +85,17 @@ var ReflectMcpOperationAnalyzer;
             protocol: "mcp",
             name: ctx.name,
             toolName: route.name,
-            title: (_e = route.title) !== null && _e !== void 0 ? _e : null,
-            toolDescription: (_f = route.description) !== null && _f !== void 0 ? _f : null,
+            title: (_f = route.title) !== null && _f !== void 0 ? _f : null,
+            toolDescription: (_g = route.description) !== null && _g !== void 0 ? _g : null,
             inputSchema: route.inputSchema,
-            outputSchema: (_g = route.outputSchema) !== null && _g !== void 0 ? _g : null,
-            annotations: (_h = route.annotations) !== null && _h !== void 0 ? _h : null,
+            outputSchema: (_h = route.outputSchema) !== null && _h !== void 0 ? _h : null,
+            annotations: (_j = route.annotations) !== null && _j !== void 0 ? _j : null,
             function: ctx.function,
             parameters,
-            returnType: (_j = (_c = ctx.metadata.success) === null || _c === void 0 ? void 0 : _c.type) !== null && _j !== void 0 ? _j : null,
+            returnType: (_k = (_c = ctx.metadata.success) === null || _c === void 0 ? void 0 : _c.type) !== null && _k !== void 0 ? _k : null,
+            returnMetadata: (_d = ctx.metadata.success) === null || _d === void 0 ? void 0 : _d.primitive,
             imports: ImportAnalyzer_1.ImportAnalyzer.merge(imports),
-            description: (_k = ctx.metadata.description) !== null && _k !== void 0 ? _k : null,
+            description: (_l = ctx.metadata.description) !== null && _l !== void 0 ? _l : null,
             jsDocTags: ctx.metadata.jsDocTags,
         };
     };