@nestia/sdk 14.0.0 → 14.0.2

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":";;;AAAA,wDAA0E;AAQ1E,qDAAkD;AAClD,mEAAgE;AAEhE;;;;;;;;GAQG;AACH,IAAiB,2BAA2B,CA0I3C;AA1ID,WAAiB,2BAA2B;IAmB1C;;;;;;;;;OASG;IACU,mCAAO,GAAG,CAAC,GAAW,EAA+B,EAAE;;;QAClE,MAAM,KAAK,GASK,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QACrE,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAErC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,YAAY,GAChB,OAAO,CAAC,WAAW,CAAC,yBAAa,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS;YAC9D,OAAO,CAAC,WAAW,CAAC,2BAAe,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC;QACnE,MAAM,iBAAiB,GACrB,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC;QAE3E,IAAI,YAAY,IAAI,iBAAiB;YACnC,MAAM,CAAC,IAAI,CACT,4FAA4F,CAC7F,CAAC;QAEJ,MAAM,aAAa,GACjB,OAAC,OAAO,CAAC,WAAW,CAClB,4BAA4B,EAC5B,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,EAC9B,GAAG,CAAC,IAAI,CACT,mCAAI,EAAE,CACR,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAEpC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC;YAC1B,MAAM,CAAC,IAAI,CACT,uEAAuE,CACxE,CAAC;QACJ,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YACzB,MAAM,CAAC,IAAI,CACT,yEAAyE,CAC1E,CAAC;QAEJ,MAAM,OAAO,GAAqB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAoC,aAAa;aAC5D,GAAG,CAAC,CAAC,CAAC,EAAwC,EAAE;YAC/C,MAAM,OAAO,GACX,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAC1B,CAAC,CAAgC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAC1D,CAAC;YACJ,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,CACT,wCAAwC,CAAC,CAAC,KAAK,iBAAiB,CACjE,CAAC;gBACF,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,CACT,2CAA2C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,gBAAgB,GAAG,CAC3H,CAAC;gBACF,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YACjC,OAAO;gBACL,QAAQ,EAAE,QAAiB;gBAC3B,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,QAAQ,EAAE,OAAO,CAAC,SAAS;gBAC3B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC;QACJ,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAAsC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,gEAAgE;QAChE,MAAM,UAAU,GACd,6CAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEvC,IAAI,MAAA,MAAA,GAAG,CAAC,QAAQ,CAAC,OAAO,0CAAE,OAAO,0CAAE,MAAM;YACvC,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEhD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;gBACtB,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI;gBACzB,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI;gBAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI;gBAC3B,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,QAAQ,EAAE,KAAK,CAAC,IAAI;YACpB,KAAK,QAAE,KAAK,CAAC,KAAK,mCAAI,IAAI;YAC1B,eAAe,QAAE,KAAK,CAAC,WAAW,mCAAI,IAAI;YAC1C,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,YAAY,QAAE,KAAK,CAAC,YAAY,mCAAI,IAAI;YACxC,WAAW,QAAE,KAAK,CAAC,WAAW,mCAAI,IAAI;YACtC,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,UAAU;YACV,UAAU,QAAE,MAAA,GAAG,CAAC,QAAQ,CAAC,OAAO,0CAAE,IAAI,mCAAI,IAAI;YAC9C,cAAc,EAAE,MAAA,GAAG,CAAC,QAAQ,CAAC,OAAO,0CAAE,SAAS;YAC/C,OAAO,EAAE,+BAAc,CAAC,KAAK,CAAC,OAAO,CAAC;YACtC,WAAW,QAAE,GAAG,CAAC,QAAQ,CAAC,WAAW,mCAAI,IAAI;YAC7C,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,SAAS;SAClC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,EA1IgB,2BAA2B,aAA3B,2BAA2B,GAA3B,2BAA2B,QA0I3C"}

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

@@ -4,10 +4,30 @@ exports.ReflectWebSocketOperationAnalyzer = void 0;
 const tstl_1 = require("tstl");
 const StringUtil_1 = require("../utils/StringUtil");
 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);
@@ -28,7 +48,7 @@ var ReflectWebSocketOperationAnalyzer;
                 "  - @WebSocketRoute.Query()",
             ].join("\n"));
         const imports = [];
-        const parameters = preconfigured
+        const declared = preconfigured
             .map((p) => {
             var _a, _b, _c, _d, _e;
             const reject = (message) => {
@@ -41,7 +61,7 @@ var ReflectWebSocketOperationAnalyzer;
             if (matched === undefined)
                 return reject(`Unable to find parameter type of the ${p.index} (th).`);
             else if (matched.type === null)
-                return reject(`Failed to analyze the parameter type of the ${JSON.stringify(matched.name)}.`);
+                return reject(`Failed to analyze the parameter type of the ${matched.name ? JSON.stringify(matched.name) : `${p.index} th parameter`}.`);
             else if (p.category === "param" &&
                 !((_a = p.field) === null || _a === void 0 ? void 0 : _a.length))
                 return reject(`@WebSocketRoute.Param() must have a field name.`);
@@ -57,18 +77,20 @@ 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;
             }
         })
             .filter((p) => !!p);
+        // a destructured parameter declares no name, so it is given one
+        const parameters = ParameterNameAnalyzer_1.ParameterNameAnalyzer.name(declared);
         const fields = preconfigured
             .filter((p) => p.category === "param")
             .map((p) => { var _a; return (_a = p.field) !== null && _a !== void 0 ? _a : ""; })
@@ -77,7 +99,7 @@ var ReflectWebSocketOperationAnalyzer;
         for (const cLoc of ctx.controller.paths)
             for (const mLoc of route.paths) {
                 const location = PathAnalyzer_1.PathAnalyzer.join(cLoc, mLoc);
-                if (location.includes("*"))
+                if (PathAnalyzer_1.PathAnalyzer.wildcard(location))
                     continue;
                 const binded = PathAnalyzer_1.PathAnalyzer.parameters(location);
                 if (binded === null)

package/lib/analyses/ReflectWebSocketOperationAnalyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReflectWebSocketOperationAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/ReflectWebSocketOperationAnalyzer.ts"],"names":[],"mappings":";;;AAAA,+BAA8B;AAQ9B,oDAAiD;AACjD,qDAAkD;AAClD,iDAA8C;AAC9C,uEAAoE;AAEpE,IAAiB,iCAAiC,CAqKjD;AArKD,WAAiB,iCAAiC;IAQnC,yCAAO,GAAG,CAAC,GAAW,EAAqC,EAAE;;QACxE,MAAM,KAAK,GAAoC,OAAO,CAAC,WAAW,CAChE,uBAAuB,EACvB,GAAG,CAAC,QAAQ,CACb,CAAC;QACF,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAErC,iCAAiC;QACjC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,aAAa,GAEf,OAAC,OAAO,CAAC,WAAW,CAClB,kCAAkC,EAClC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,EAC9B,GAAG,CAAC,IAAI,CACT,mCAAI,EAAE,CACR,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,KAAK,SAAS;YACpE,MAAM,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;QACpE,IAAI,aAAa,CAAC,MAAM,KAAK,GAAG,CAAC,QAAQ,CAAC,MAAM;YAC9C,MAAM,CAAC,IAAI,CACT;gBACE,wCAAwC;gBACxC,gCAAgC;gBAChC,8BAA8B;gBAC9B,8BAA8B;gBAC9B,6BAA6B;gBAC7B,6BAA6B;aAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QAEJ,MAAM,OAAO,GAAqB,EAAE,CAAC;QACrC,MAAM,UAAU,GAA0C,aAAa;aACpE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;;YACT,MAAM,MAAM,GAAG,CAAC,OAAe,EAAQ,EAAE;gBACvC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrB,OAAO,IAAI,CAAC;YACd,CAAC,CAAC;YAEF,gBAAgB;YAChB,MAAM,OAAO,GACX,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;YAE3D,qBAAqB;YACrB,IAAI,OAAO,KAAK,SAAS;gBACvB,OAAO,MAAM,CACX,wCAAwC,CAAC,CAAC,KAAK,QAAQ,CACxD,CAAC;iBACC,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;gBAC5B,OAAO,MAAM,CACX,+CAA+C,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAC/E,CAAC;iBACC,IACH,CAAC,CAAC,QAAQ,KAAK,OAAO;gBACtB,EAAC,MAAC,CAAgD,CAAC,KAAK,0CAAE,MAAM,CAAA;gBAEhE,OAAO,MAAM,CAAC,iDAAiD,CAAC,CAAC;iBAC9D,IACH,CAAC,CAAC,QAAQ,KAAK,UAAU;gBACzB,CAAA,MAAA,MAAA,OAAO,CAAC,IAAI,0CAAE,aAAa,0CAAE,MAAM,MAAK,CAAC;gBAEzC,OAAO,MAAM,CACX,4DAA4D,CAC7D,CAAC;iBACC,IACH,CAAC,CAAC,QAAQ,KAAK,QAAQ;gBACvB,CAAA,MAAA,MAAA,OAAO,CAAC,IAAI,0CAAE,aAAa,0CAAE,MAAM,MAAK,CAAC;gBAEzC,OAAO,MAAM,CACX,uDAAuD,CACxD,CAAC;YAEJ,uBAAuB;YACvB,OAAO,CAAC,IAAI,CACV,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CACvB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CACC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAC5B,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;oBAC7B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC,CAC7C,CACJ,CACF,CAAC;YACF,IACE,CAAC,CAAC,QAAQ,KAAK,UAAU;gBACzB,CAAC,CAAC,QAAQ,KAAK,QAAQ;gBACvB,CAAC,CAAC,QAAQ,KAAK,OAAO;gBAEtB,uCACK,CAAC,KACJ,IAAI,EAAE,OAAO,CAAC,IAAI,EAClB,IAAI,EAAE,OAAO,CAAC,IAAI,IAClB;iBACC,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO;gBAC7B,OAAO,gCACF,CAAC,KACJ,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,CAAC,CAAC,KAAM,EACf,IAAI,EAAE,OAAO,CAAC,IAAI,EAClB,IAAI,EAAE,OAAO,CAAC,IAAI,EAClB,OAAO,EAAE,OAAO,CAAC,OAAO,EACxB,WAAW,EAAE,OAAO,CAAC,WAAW,EAChC,SAAS,EAAE,OAAO,CAAC,SAAS,GACwB,CAAC;YACzD,kCAAkC;iBAC7B,CAAC;gBACJ,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ;oBACzB,MAAM,CACJ,mBAAmB,uBAAU,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,yEAAyE,CAC9H,CAAC;gBACJ,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAA4C,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEhE,MAAM,MAAM,GAAa,aAAa;aACnC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC;aACrC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,wBAAC,CAAC,CAAC,KAAK,mCAAI,EAAE,GAAA,CAAC;aACzB,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,CAAC,EAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,MAAM,CAAA,CAAC;aACnD,IAAI,EAAE,CAAC;QACV,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK;YACrC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAW,2BAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACvD,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAAE,SAAS;gBAErC,MAAM,MAAM,GAAoB,2BAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBAClE,IAAI,MAAM,KAAK,IAAI;oBACjB,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;qBACvD,IAAI,aAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,KAAK,KAAK;oBACpD,MAAM,CAAC,IAAI,CACT,oHAAoH,MAAM,CAAC,IAAI,CAC7H,IAAI,CACL,mBAAmB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAC3C,CAAC;YACN,CAAC;QACH,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;gBACtB,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI;gBACzB,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI;gBAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI;gBAC3B,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,WAAW;YACrB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,QAAQ,EAAE,iDAAuB,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;YACxD,UAAU;YACV,OAAO,EAAE,+BAAc,CAAC,KAAK,CAAC,OAAO,CAAC;YACtC,WAAW,QAAE,GAAG,CAAC,QAAQ,CAAC,WAAW,mCAAI,IAAI;YAC7C,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,SAAS;SAClC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,EArKgB,iCAAiC,aAAjC,iCAAiC,GAAjC,iCAAiC,QAqKjD"}
+{"version":3,"file":"ReflectWebSocketOperationAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/ReflectWebSocketOperationAnalyzer.ts"],"names":[],"mappings":"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"}

package/lib/analyses/SecurityAnalyzer.d.ts

@@ -1,3 +1,28 @@
+/**
+ * Helpers for security requirements.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace merges requirement lists into a canonical, duplicate-free list.
+ * @evidence contracts/common.md#clear-and-simple-design One function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a plain helper.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation SecurityAnalyzer 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 SecurityAnalyzer {
+    /**
+     * Joins lists of security requirements into one, as OpenAPI reads them.
+     *
+     * Each requirement is an alternative, any one of which suffices, and every
+     * scheme of one requirement must hold, so each is kept as declared. Merging
+     * them by scheme name turned `{ a, b }` (both) into `a` or `b`, and the
+     * `read` or `write` scope alternatives of one scheme into both scopes. Only a
+     * requirement repeating an earlier one, such as a controller's restated on
+     * its method, is dropped; an empty one, anonymous access, is kept.
+     *
+     * @evidence contracts/common.md#principled-implementation Each requirement is normalized to unique scopes and keyed by its sorted schemes and sorted scopes, so equality does not depend on order, and the first occurrence keeps its position.
+     * @evidence contracts/common.md#clear-and-simple-design One function with one key computation.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Equality is defined by content.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the equality and the order.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SecurityAnalyzer.merge 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 merge: (...entire: Record<string, string[]>[]) => Record<string, string[]>[];
 }

package/lib/analyses/SecurityAnalyzer.js

@@ -1,30 +1,50 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SecurityAnalyzer = void 0;
-const MapUtil_1 = require("../utils/MapUtil");
+/**
+ * Helpers for security requirements.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace merges requirement lists into a canonical, duplicate-free list.
+ * @evidence contracts/common.md#clear-and-simple-design One function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a plain helper.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation SecurityAnalyzer 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 SecurityAnalyzer;
 (function (SecurityAnalyzer) {
+    /**
+     * Joins lists of security requirements into one, as OpenAPI reads them.
+     *
+     * Each requirement is an alternative, any one of which suffices, and every
+     * scheme of one requirement must hold, so each is kept as declared. Merging
+     * them by scheme name turned `{ a, b }` (both) into `a` or `b`, and the
+     * `read` or `write` scope alternatives of one scheme into both scopes. Only a
+     * requirement repeating an earlier one, such as a controller's restated on
+     * its method, is dropped; an empty one, anonymous access, is kept.
+     *
+     * @evidence contracts/common.md#principled-implementation Each requirement is normalized to unique scopes and keyed by its sorted schemes and sorted scopes, so equality does not depend on order, and the first occurrence keeps its position.
+     * @evidence contracts/common.md#clear-and-simple-design One function with one key computation.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Equality is defined by content.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the equality and the order.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SecurityAnalyzer.merge 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.
+     */
     SecurityAnalyzer.merge = (...entire) => {
-        const dict = new Map();
-        for (const obj of entire) {
-            const entries = Object.entries(obj);
-            for (const [key, value] of entries) {
-                const set = MapUtil_1.MapUtil.take(dict, key, () => new Set());
-                for (const val of value)
-                    set.add(val);
-            }
-            if (entries.length === 0)
-                MapUtil_1.MapUtil.take(dict, none, () => new Set());
-        }
         const output = [];
-        for (const [key, set] of dict)
-            key === none
-                ? output.push({})
-                : output.push({
-                    [key]: [...set],
-                });
+        const visited = new Set();
+        for (const requirement of entire) {
+            const normalized = Object.fromEntries(Object.entries(requirement).map(([name, scopes]) => [
+                name,
+                [...new Set(scopes)],
+            ]));
+            const key = JSON.stringify(Object.entries(normalized)
+                .map(([name, scopes]) => [name, [...scopes].sort()])
+                .sort(([x], [y]) => (x < y ? -1 : x > y ? 1 : 0)));
+            if (visited.has(key))
+                continue;
+            visited.add(key);
+            output.push(normalized);
+        }
         return output;
     };
-    const none = Symbol("none");
 })(SecurityAnalyzer || (exports.SecurityAnalyzer = SecurityAnalyzer = {}));
 //# sourceMappingURL=SecurityAnalyzer.js.map

package/lib/analyses/SecurityAnalyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"SecurityAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/SecurityAnalyzer.ts"],"names":[],"mappings":";;;AAAA,8CAA2C;AAE3C,IAAiB,gBAAgB,CAsBhC;AAtBD,WAAiB,gBAAgB;IAClB,sBAAK,GAAG,CAAC,GAAG,MAAkC,EAAE,EAAE;QAC7D,MAAM,IAAI,GAA2C,IAAI,GAAG,EAAE,CAAC;QAC/D,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;gBACnC,MAAM,GAAG,GAAG,iBAAO,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;gBACrD,KAAK,MAAM,GAAG,IAAI,KAAK;oBAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxC,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,iBAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,MAAM,GAA+B,EAAE,CAAC;QAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,IAAI;YAC3B,GAAG,KAAK,IAAI;gBACV,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;oBACV,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;iBAChB,CAAC,CAAC;QACT,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC,EAtBgB,gBAAgB,aAAhB,gBAAgB,GAAhB,gBAAgB,QAsBhC"}
+{"version":3,"file":"SecurityAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/SecurityAnalyzer.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,IAAiB,gBAAgB,CAwChC;AAxCD,WAAiB,gBAAgB;IAC/B;;;;;;;;;;;;;;;OAeG;IACU,sBAAK,GAAG,CACnB,GAAG,MAAkC,EACT,EAAE;QAC9B,MAAM,MAAM,GAA+B,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAgB,IAAI,GAAG,EAAE,CAAC;QACvC,KAAK,MAAM,WAAW,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,UAAU,GAA6B,MAAM,CAAC,WAAW,CAC7D,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;gBAClD,IAAI;gBACJ,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;aACrB,CAAC,CACH,CAAC;YACF,MAAM,GAAG,GAAW,IAAI,CAAC,SAAS,CAChC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;iBACvB,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAU,CAAC;iBAC5D,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACpD,CAAC;YACF,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC,EAxCgB,gBAAgB,aAAhB,gBAAgB,GAAhB,gBAAgB,QAwChC"}

package/lib/analyses/SwaggerExampleAnalyzer.d.ts

@@ -0,0 +1,31 @@
+import { SwaggerExample } from "@nestia/core";
+import { OpenApi } from "@typia/interface";
+/**
+ * Converts the named examples of `@SwaggerExample` into OpenAPI example
+ * objects.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace maps each named value to an example object.
+ * @evidence contracts/common.md#clear-and-simple-design One function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a plain mapping.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation SwaggerExampleAnalyzer 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 SwaggerExampleAnalyzer {
+    /**
+     * The named examples `@SwaggerExample` attached, as the Example Objects an
+     * OpenAPI `examples` map holds.
+     *
+     * The decorator stores each named example as its value, and documents used to
+     * carry the value itself. OpenAPI 3.x names examples with Example Objects,
+     * whose `value` holds the value, so a tool read the raw value as an Example
+     * Object and found no example in it (#1649). `@TypedException()` examples are
+     * declared as Example Objects already.
+     *
+     * @evidence contracts/common.md#principled-implementation Each value is wrapped as `{ value }`, which is the OpenAPI example object.
+     * @evidence contracts/common.md#clear-and-simple-design One conditional and one mapping.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The values are kept as given.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SwaggerExampleAnalyzer.examples 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 examples: (data: SwaggerExample.IData<any> | undefined) => Record<string, OpenApi.IExample> | undefined;
+}

package/lib/analyses/SwaggerExampleAnalyzer.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwaggerExampleAnalyzer = void 0;
+/**
+ * Converts the named examples of `@SwaggerExample` into OpenAPI example
+ * objects.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace maps each named value to an example object.
+ * @evidence contracts/common.md#clear-and-simple-design One function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a plain mapping.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation SwaggerExampleAnalyzer 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 SwaggerExampleAnalyzer;
+(function (SwaggerExampleAnalyzer) {
+    /**
+     * The named examples `@SwaggerExample` attached, as the Example Objects an
+     * OpenAPI `examples` map holds.
+     *
+     * The decorator stores each named example as its value, and documents used to
+     * carry the value itself. OpenAPI 3.x names examples with Example Objects,
+     * whose `value` holds the value, so a tool read the raw value as an Example
+     * Object and found no example in it (#1649). `@TypedException()` examples are
+     * declared as Example Objects already.
+     *
+     * @evidence contracts/common.md#principled-implementation Each value is wrapped as `{ value }`, which is the OpenAPI example object.
+     * @evidence contracts/common.md#clear-and-simple-design One conditional and one mapping.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The values are kept as given.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SwaggerExampleAnalyzer.examples 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.
+     */
+    SwaggerExampleAnalyzer.examples = (data) => (data === null || data === void 0 ? void 0 : data.examples) === undefined
+        ? undefined
+        : Object.fromEntries(Object.entries(data.examples).map(([key, value]) => [key, { value }]));
+})(SwaggerExampleAnalyzer || (exports.SwaggerExampleAnalyzer = SwaggerExampleAnalyzer = {}));
+//# sourceMappingURL=SwaggerExampleAnalyzer.js.map

package/lib/analyses/SwaggerExampleAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwaggerExampleAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/SwaggerExampleAnalyzer.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;GASG;AACH,IAAiB,sBAAsB,CAyBtC;AAzBD,WAAiB,sBAAsB;IACrC;;;;;;;;;;;;;;;OAeG;IACU,+BAAQ,GAAG,CACtB,IAA2C,EACG,EAAE,CAChD,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,QAAQ,MAAK,SAAS;QAC1B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CACtE,CAAC;AACV,CAAC,EAzBgB,sBAAsB,aAAtB,sBAAsB,GAAtB,sBAAsB,QAyBtC"}

package/lib/analyses/TypedHttpRouteAnalyzer.d.ts

@@ -3,14 +3,52 @@ import { IReflectController } from "../structures/IReflectController";
 import { IReflectHttpOperation } from "../structures/IReflectHttpOperation";
 import { IReflectOperationError } from "../structures/IReflectOperationError";
 import { ITypedHttpRoute } from "../structures/ITypedHttpRoute";
+import { ITypedMcpRoute } from "../structures/ITypedMcpRoute";
+/**
+ * Turns reflected HTTP operations into typed routes, one per path, and builds
+ * the shared dictionary of the JSON components HTTP and MCP routes use.
+ *
+ * @evidence contracts/common.md#principled-implementation Each operation's metadata is resolved against its own components and validated by the policy of its position, the routes carry the typed parameters, the success response, and the exceptions, and the dictionary of the routes is built after component names that collide with different definitions are renamed per controller.
+ * @evidence contracts/common.md#clear-and-simple-design Two public functions and private collectors for the component rename.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The rename mutates only component definitions owned by analysis; consumers emit resolved structural types rather than modifying foreign cache fields or replacing names in strings.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * efficient algorithms: This namespace groups operations; analyze and routeDictionary own the algorithms.
+ * reuse equivalent work: The namespace itself coordinates no completed or in-flight work.
+ * bound retention and release resources: The namespace owns no cache, handle or running task.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation TypedHttpRouteAnalyzer 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 TypedHttpRouteAnalyzer {
-    const dictionary: (controllers: IReflectController[]) => IMetadataDictionary;
+    /**
+     * Returns the typed routes of one operation, one per path, or none when the
+     * metadata violates a policy; the violations are pushed to the errors.
+     *
+     * @evidence contracts/common.md#principled-implementation Each metadata is resolved against its own components and validated with the policy of its position (JSON, query, header, or text), the `@setHeader` and `@assignHeaders` tags become header directives, and the route splits the parameters by category.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The policies come from the validators of the package.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result and the errors.
+     * efficient algorithms: Each supplied parameter and exception is cast once, policy validation belongs to MetadataFactory, and route splitting maps only the supplied paths.
+     * reuse equivalent work: Independently supplied operation metadata and position-specific validation have no shared completed or in-flight request.
+     * bound retention and release resources: Metadata dictionaries and local diagnostics belong to this synchronous operation and its returned routes; no process, handle or persistent history is retained.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation TypedHttpRouteAnalyzer.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: (props: {
         controller: IReflectController;
         errors: IReflectOperationError[];
-        dictionary: IMetadataDictionary;
         operation: IReflectHttpOperation;
         paths: string[];
     }) => ITypedHttpRoute[];
-    const routeDictionary: (routes: Array<ITypedHttpRoute>) => IMetadataDictionary;
+    /**
+     * Returns the dictionary of the components the routes actually use, after
+     * renaming components whose names collide with different definitions.
+     *
+     * @evidence contracts/common.md#principled-implementation Objects, aliases and recursive arrays/tuples share their emitted accessor-path slots, while finite and object-mediated collections remain kind-specific inline groups. Different semantic classes in one slot receive unique controller-qualified names, and the emitted dictionary follows escaped returns rather than original-only toJSON declarations.
+     * @evidence contracts/common.md#clear-and-simple-design One function over private collectors.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Finite partition refinement preserves semantic discriminators and user payloads while component edges reference equivalence classes. Only actual component ordinals are omitted; no foreign name cache or generated text is rewritten.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result and the rename.
+     * efficient algorithms: Each refinement round encodes each distinct component body with constant-sized component edges. The partition only splits and stabilizes within the distinct component count, avoiding exponential expansion of shared DAGs.
+     * reuse equivalent work: One local partition compares all routes together, reuses graph node colors for shared children and supplies all collision groups; equivalent same-slot definitions reuse one emitted representative.
+     * bound retention and release resources: Collected nodes, partitions and visited sets are local to this synchronous call and are released with it; the returned dictionary retains only its reachable emitted representatives.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation TypedHttpRouteAnalyzer.routeDictionary 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 routeDictionary: (routes: Array<ITypedHttpRoute | ITypedMcpRoute>) => IMetadataDictionary;
 }