@nestia/sdk 14.0.1 → 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

@@ -18,8 +18,29 @@ const legacy_1 = require("../internal/legacy");
 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 = [];

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

@@ -6,8 +6,30 @@ 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;

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":";;;AACA,wDAIkC;AAElC,+CAAiE;AAKjE,sFAAmF;AACnF,yEAAsE;AACtE,qEAAkE;AAElE;;;;;;;;GAQG;AACH,IAAiB,oCAAoC,CAwKpD;AAxKD,WAAiB,oCAAoC;IAoBnD;;;;;;;;;;;;OAYG;IACU,4CAAO,GAAG,CACrB,GAAa,EACwB,EAAE;;;QACvC,MAAM,MAAM,GAA8C,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI;gBACzB,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI;gBAChC,QAAQ,EAAE,GAAG,CAAC,YAAY;gBAC1B,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QAEF,MAAM,SAAS,GAAY,cAAc,CAAC;YACxC,IAAI,EAAE,2BAA2B;YACjC,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB,CAAC,CAAC;QACH,MAAM,WAAW,GAAkB,SAAS;YAC1C,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,cAAc,CAAC;gBACX,IAAI,EAAE,4BAA4B;gBAClC,QAAQ,EAAE,GAAG,CAAC,QAAQ;aACvB,CAAC;gBACJ,CAAC,CAAC,mCAAmC;gBACrC,CAAC,CAAC,aAAC,MAAA,MAAA,OAAO,CAAC,WAAW,CAAC,4BAAgB,EAAE,GAAG,CAAC,QAAQ,CAAC,0CAAE,IAAI,CACxD,CAAC,CAAyB,EAAE,EAAE,CAC5B,QAAO,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,IAAI,CAAA,KAAK,QAAQ;oBAC3B,QAAO,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,KAAK,CAAA,KAAK,QAAQ;oBAC5B,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,cAAc,CAC1C,0CAAE,KAAK,mCACR,MAAA,OAAO,CAAC,WAAW,CAAC,qBAAqB,EAAE,GAAG,CAAC,QAAQ,CAAC,0CAAG,CAAC,CAAC,mCAC7D,CAAC,GAAG,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAE/D,MAAM,MAAM,GAAY,yDAA2B,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,MAAM;YACnB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAa,EAAE,IAAI,EAAE,YAAY,EAAE;YAChD,CAAC,CAAC,WAAW,KAAK,kBAAkB;gBAClC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS;gBAChC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;QACpC,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,GAAG,CAAC,UAAU,KAAK,MAAM,IAAI,WAAW,KAAK,IAAI;YACnD,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC3D,IAAI,yDAA2B,CAAC,WAAW,CAAC,WAAW,CAAC,KAAK,KAAK;YAChE,MAAM,CAAC,IAAI,CACT,gCAAgC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,gBAAgB,CAC5E,CAAC;QAEJ,IAAI,MAAM,CAAC,MAAM;YAAE,OAAO,MAAM,EAAE,CAAC;aAC9B,IACH,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC;YACxD,MAAM,CAAC,OAAO,KAAK,KAAK;YACxB,CAAC,yDAA2B,CAAC,WAAW,CAAC,WAAW,CAAC;YAErD,OAAO,IAAI,CAAC;QAEd,MAAM,OAAO,GAA0C,OAAO,CAAC,WAAW,CACxE,gCAAgC,EAChC,GAAG,CAAC,QAAQ,CACb,CAAC;QACF,qCACE,WAAW;YACX,MAAM;YACN,SAAS,EACT,MAAM,QACJ,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,mCAAI,CAAC,GAAG,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EACpE,IAAI,QAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,mCAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAC1D,MAAM,CAAC,IAAI,KACd,QAAQ,EACN,MAAM,KAAK,IAAI;gBACb,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE;gBACV,CAAC,CAAC,WAAW,KAAK,kBAAkB,IAAI,SAAS,KAAK,IAAI;oBACxD,CAAC,CAAC,4BAAmB,CAAC,QAAQ;oBAC9B,CAAC,CAAC,WAAW,KAAK,mCAAmC;wBACnD,CAAC,CAAC,6DAA6D;4BAC7D,iBAAiB;4BACjB,SAAS;wBACX,CAAC,CAAC,WAAW,KAAK,YAAY;4BAC5B,CAAC,CAAC,uCAAkB,CAAC,QAAQ;4BAC7B,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CACP,IAAA,eAAM,EAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gCACzB,CAAC,CAAC,CAAC,6CAA6C,CAAC;gCACjD,CAAC,CAAC,EAAE,EACpB,OAAO,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,EACzB,QAAQ,EAAE,+CAAsB,CAAC,QAAQ,CAAC,OAAO,CAAC,IAClD;IACJ,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,IAAc,EAAiB,EAAE;QAClD,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,8BAAkB,EAAE,IAAI,CAAC,CAAC;QAC3D,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACpC,MAAM,KAAK,GAAW,MAAM,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IACrC,CAAC,CAAC;IAEF,MAAM,cAAc,GAAG,CAAC,KAGvB,EAAW,EAAE;QACZ,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,iCAAqB,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxE,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,kBAAC,CAAA,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,WAAW,0CAAE,IAAI,MAAK,KAAK,CAAC,IAAI,GAAA,CAAC,CAAC;IACrE,CAAC,CAAC;IAEF,MAAM,YAAY,GAA+B;QAC/C,UAAU,EAAE;YACV,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,EAAE;SACX;QACD,QAAQ,EAAE;YACR,OAAO,EAAE,EAAE;YACX,GAAG,EAAE,KAAK;YACV,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,EAAE;YACb,IAAI,EAAE,EAAE;YACR,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,KAAK;YACf,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,EAAE;YACR,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,EAAE;YACV,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,IAAI;SAC8B;KAC5C,CAAC;AACJ,CAAC,EAxKgB,oCAAoC,aAApC,oCAAoC,GAApC,oCAAoC,QAwKpD"}

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

@@ -4,11 +4,30 @@ 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;
@@ -18,7 +37,7 @@ 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)
@@ -41,6 +60,7 @@ var ReflectMcpOperationAnalyzer;
                 name: matched.name,
                 index: p.index,
                 type: matched.type,
+                metadata: matched.primitive,
                 imports: matched.imports,
                 description: matched.description,
                 jsDocTags: matched.jsDocTags,
@@ -65,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,
         };
     };

package/lib/analyses/ReflectMcpOperationAnalyzer.js.map

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

package/lib/analyses/ReflectMetadataAnalyzer.d.ts

@@ -1,7 +1,54 @@
 import { VERSION_NEUTRAL } from "@nestjs/common";
+/**
+ * Reads the NestJS and Swagger metadata of a class or method.
+ *
+ * @evidence contracts/common.md#principled-implementation The functions read the reflect metadata keys that Nest and `@nestjs/swagger` define and normalize them into arrays.
+ * @evidence contracts/common.md#clear-and-simple-design Four small readers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts They read only public metadata keys.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectMetadataAnalyzer 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 ReflectMetadataAnalyzer {
+    /**
+     * Returns the path list of a controller or route: a string is a one-element
+     * list and an empty list is one empty path.
+     *
+     * @evidence contracts/common.md#principled-implementation Nest stores a path as a string or an array, and an empty array means the root path, so the result is never empty.
+     * @evidence contracts/common.md#clear-and-simple-design One conditional.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It normalizes without changing paths.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the normalization.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectMetadataAnalyzer.paths 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 paths: (target: Function) => string[];
+    /**
+     * Returns the `@ApiExtension` values of a target.
+     *
+     * @evidence contracts/common.md#principled-implementation The metadata is returned as recorded, and an absent value is an empty object.
+     * @evidence contracts/common.md#clear-and-simple-design One read.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It reads the Swagger metadata key.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectMetadataAnalyzer.extensions 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 extensions: (value: any) => Record<string, any>;
+    /**
+     * Returns the deduplicated security requirements of a target.
+     *
+     * @evidence contracts/common.md#principled-implementation The `@ApiSecurity` metadata is merged by `SecurityAnalyzer.merge`, and an absent value is an empty list.
+     * @evidence contracts/common.md#clear-and-simple-design One read and one merge.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It reads the Swagger metadata key.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectMetadataAnalyzer.securities 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 securities: (value: any) => Record<string, string[]>[];
+    /**
+     * Returns the version list of a target, or `undefined` when it is
+     * unversioned.
+     *
+     * @evidence contracts/common.md#principled-implementation A single version becomes a one-element list, and an absent value stays absent so callers can tell unversioned from versioned.
+     * @evidence contracts/common.md#clear-and-simple-design One conditional.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It reads Nest's version metadata.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the three cases.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectMetadataAnalyzer.versions 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 versions: (target: any) => Array<string | typeof VERSION_NEUTRAL> | undefined;
 }

package/lib/analyses/ReflectMetadataAnalyzer.js

@@ -3,8 +3,27 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReflectMetadataAnalyzer = void 0;
 const constants_1 = require("@nestjs/common/constants");
 const SecurityAnalyzer_1 = require("./SecurityAnalyzer");
+/**
+ * Reads the NestJS and Swagger metadata of a class or method.
+ *
+ * @evidence contracts/common.md#principled-implementation The functions read the reflect metadata keys that Nest and `@nestjs/swagger` define and normalize them into arrays.
+ * @evidence contracts/common.md#clear-and-simple-design Four small readers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts They read only public metadata keys.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectMetadataAnalyzer 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 ReflectMetadataAnalyzer;
 (function (ReflectMetadataAnalyzer) {
+    /**
+     * Returns the path list of a controller or route: a string is a one-element
+     * list and an empty list is one empty path.
+     *
+     * @evidence contracts/common.md#principled-implementation Nest stores a path as a string or an array, and an empty array means the root path, so the result is never empty.
+     * @evidence contracts/common.md#clear-and-simple-design One conditional.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It normalizes without changing paths.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the normalization.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectMetadataAnalyzer.paths 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.
+     */
     ReflectMetadataAnalyzer.paths = (target) => {
         const value = Reflect.getMetadata(constants_1.PATH_METADATA, target);
         if (typeof value === "string")
@@ -14,14 +33,42 @@ var ReflectMetadataAnalyzer;
         else
             return value;
     };
+    /**
+     * Returns the `@ApiExtension` values of a target.
+     *
+     * @evidence contracts/common.md#principled-implementation The metadata is returned as recorded, and an absent value is an empty object.
+     * @evidence contracts/common.md#clear-and-simple-design One read.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It reads the Swagger metadata key.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectMetadataAnalyzer.extensions 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.
+     */
     ReflectMetadataAnalyzer.extensions = (value) => {
         const entire = Reflect.getMetadata("swagger/apiExtension", value);
         return entire !== null && entire !== void 0 ? entire : {};
     };
+    /**
+     * Returns the deduplicated security requirements of a target.
+     *
+     * @evidence contracts/common.md#principled-implementation The `@ApiSecurity` metadata is merged by `SecurityAnalyzer.merge`, and an absent value is an empty list.
+     * @evidence contracts/common.md#clear-and-simple-design One read and one merge.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It reads the Swagger metadata key.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectMetadataAnalyzer.securities 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.
+     */
     ReflectMetadataAnalyzer.securities = (value) => {
         const entire = Reflect.getMetadata("swagger/apiSecurity", value);
         return entire ? SecurityAnalyzer_1.SecurityAnalyzer.merge(...entire) : [];
     };
+    /**
+     * Returns the version list of a target, or `undefined` when it is
+     * unversioned.
+     *
+     * @evidence contracts/common.md#principled-implementation A single version becomes a one-element list, and an absent value stays absent so callers can tell unversioned from versioned.
+     * @evidence contracts/common.md#clear-and-simple-design One conditional.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It reads Nest's version metadata.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the three cases.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectMetadataAnalyzer.versions 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.
+     */
     ReflectMetadataAnalyzer.versions = (target) => {
         const value = Reflect.getMetadata(constants_1.VERSION_METADATA, target);
         return value === undefined

package/lib/analyses/ReflectMetadataAnalyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReflectMetadataAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/ReflectMetadataAnalyzer.ts"],"names":[],"mappings":";;;AACA,wDAA2E;AAG3E,yDAAsD;AAEtD,IAAiB,uBAAuB,CAqCvC;AArCD,WAAiB,uBAAuB;IACzB,6BAAK,GAAG,CAAC,MAAgB,EAAY,EAAE;QAClD,MAAM,KAAK,GAAsB,OAAO,CAAC,WAAW,CAAC,yBAAa,EAAE,MAAM,CAAC,CAAC;QAC5E,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,CAAC,KAAK,CAAC,CAAC;aACzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,EAAE,CAAC,CAAC;;YACpC,OAAO,KAAK,CAAC;IACpB,CAAC,CAAC;IAEW,kCAAU,GAAG,CAAC,KAAU,EAAuB,EAAE;QAC5D,MAAM,MAAM,GAAsC,OAAO,CAAC,WAAW,CACnE,sBAAsB,EACtB,KAAK,CACN,CAAC;QACF,OAAO,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC;IACtB,CAAC,CAAC;IAEW,kCAAU,GAAG,CAAC,KAAU,EAA8B,EAAE;QACnE,MAAM,MAAM,GAA2C,OAAO,CAAC,WAAW,CACxE,qBAAqB,EACrB,KAAK,CACN,CAAC;QACF,OAAO,MAAM,CAAC,CAAC,CAAC,mCAAgB,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,CAAC,CAAC;IAEW,gCAAQ,GAAG,CACtB,MAAW,EACyC,EAAE;QACtD,MAAM,KAAK,GAA6B,OAAO,CAAC,WAAW,CACzD,4BAAgB,EAChB,MAAM,CACP,CAAC;QACF,OAAO,KAAK,KAAK,SAAS;YACxB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBACpB,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC,EArCgB,uBAAuB,aAAvB,uBAAuB,GAAvB,uBAAuB,QAqCvC"}
+{"version":3,"file":"ReflectMetadataAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/ReflectMetadataAnalyzer.ts"],"names":[],"mappings":";;;AACA,wDAA2E;AAG3E,yDAAsD;AAEtD;;;;;;;;GAQG;AACH,IAAiB,uBAAuB,CA2EvC;AA3ED,WAAiB,uBAAuB;IACtC;;;;;;;;;OASG;IACU,6BAAK,GAAG,CAAC,MAAgB,EAAY,EAAE;QAClD,MAAM,KAAK,GAAsB,OAAO,CAAC,WAAW,CAAC,yBAAa,EAAE,MAAM,CAAC,CAAC;QAC5E,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,CAAC,KAAK,CAAC,CAAC;aACzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,EAAE,CAAC,CAAC;;YACpC,OAAO,KAAK,CAAC;IACpB,CAAC,CAAC;IAEF;;;;;;;;OAQG;IACU,kCAAU,GAAG,CAAC,KAAU,EAAuB,EAAE;QAC5D,MAAM,MAAM,GAAsC,OAAO,CAAC,WAAW,CACnE,sBAAsB,EACtB,KAAK,CACN,CAAC;QACF,OAAO,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC;IACtB,CAAC,CAAC;IAEF;;;;;;;;OAQG;IACU,kCAAU,GAAG,CAAC,KAAU,EAA8B,EAAE;QACnE,MAAM,MAAM,GAA2C,OAAO,CAAC,WAAW,CACxE,qBAAqB,EACrB,KAAK,CACN,CAAC;QACF,OAAO,MAAM,CAAC,CAAC,CAAC,mCAAgB,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,CAAC,CAAC;IAEF;;;;;;;;;OASG;IACU,gCAAQ,GAAG,CACtB,MAAW,EACyC,EAAE;QACtD,MAAM,KAAK,GAA6B,OAAO,CAAC,WAAW,CACzD,4BAAgB,EAChB,MAAM,CACP,CAAC;QACF,OAAO,KAAK,KAAK,SAAS;YACxB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBACpB,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC,EA3EgB,uBAAuB,aAAvB,uBAAuB,GAAvB,uBAAuB,QA2EvC"}

package/lib/analyses/ReflectWebSocketOperationAnalyzer.d.ts

@@ -2,7 +2,26 @@ import { INestiaProject } from "../structures/INestiaProject";
 import { IOperationMetadata } from "../structures/IOperationMetadata";
 import { IReflectController } from "../structures/IReflectController";
 import { IReflectWebSocketOperation } from "../structures/IReflectWebSocketOperation";
+/**
+ * Reflects a `@WebSocketRoute` method into an operation.
+ *
+ * @evidence contracts/common.md#principled-implementation The parameter decorators give each parameter's category, the acceptor and driver type arguments are checked, the path parameters of the route are matched against the param decorators, and the tgrid declarations are not imported into the SDK.
+ * @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 ReflectWebSocketOperationAnalyzer 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 ReflectWebSocketOperationAnalyzer {
+    /**
+     * The input of the WebSocket 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 ReflectWebSocketOperationAnalyzer.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 ReflectWebSocketOperationAnalyzer {
         name: string;
         metadata: IOperationMetadata;
     }
+    /**
+     * Returns the WebSocket operation of a method, or `null` when the method is
+     * not a WebSocket route or has errors.
+     *
+     * @evidence contracts/common.md#principled-implementation An acceptor is required, every parameter must carry one of the five decorators, the acceptor has three type arguments and the driver one, and the path parameters must equal the param fields.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @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 ReflectWebSocketOperationAnalyzer.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) => IReflectWebSocketOperation | null;
 }

package/lib/analyses/ReflectWebSocketOperationAnalyzer.js

@@ -7,8 +7,27 @@ const ImportAnalyzer_1 = require("./ImportAnalyzer");
 const ParameterNameAnalyzer_1 = require("./ParameterNameAnalyzer");
 const PathAnalyzer_1 = require("./PathAnalyzer");
 const ReflectMetadataAnalyzer_1 = require("./ReflectMetadataAnalyzer");
+/**
+ * Reflects a `@WebSocketRoute` method into an operation.
+ *
+ * @evidence contracts/common.md#principled-implementation The parameter decorators give each parameter's category, the acceptor and driver type arguments are checked, the path parameters of the route are matched against the param decorators, and the tgrid declarations are not imported into the SDK.
+ * @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 ReflectWebSocketOperationAnalyzer 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 ReflectWebSocketOperationAnalyzer;
 (function (ReflectWebSocketOperationAnalyzer) {
+    /**
+     * Returns the WebSocket operation of a method, or `null` when the method is
+     * not a WebSocket route or has errors.
+     *
+     * @evidence contracts/common.md#principled-implementation An acceptor is required, every parameter must carry one of the five decorators, the acceptor has three type arguments and the driver one, and the path parameters must equal the param fields.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @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 ReflectWebSocketOperationAnalyzer.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.
+     */
     ReflectWebSocketOperationAnalyzer.analyze = (ctx) => {
         var _a, _b;
         const route = Reflect.getMetadata("nestia/WebSocketRoute", ctx.function);
@@ -58,14 +77,14 @@ var ReflectWebSocketOperationAnalyzer;
                     i.file.endsWith("WebSocketAcceptor.d.ts")))));
             if (p.category === "acceptor" ||
                 p.category === "driver" ||
+                p.category === "header" ||
                 p.category === "query")
                 return Object.assign(Object.assign({}, p), { name: matched.name, type: matched.type });
             else if (p.category === "param")
                 return Object.assign(Object.assign({}, p), { category: "param", field: p.field, name: matched.name, type: matched.type, imports: matched.imports, description: matched.description, jsDocTags: matched.jsDocTags });
             // UNKNOWN TYPE, MAYBE NEW FEATURE
             else {
-                if (p.category !== "header")
-                    reject(`@WebSocketRoute.${StringUtil_1.StringUtil.capitalize(p.category)}() has not been supported yet. How about upgrading the nestia packages?`);
+                reject(`@WebSocketRoute.${StringUtil_1.StringUtil.capitalize(p.category)}() has not been supported yet. How about upgrading the nestia packages?`);
                 return null;
             }
         })