@nestia/sdk 14.0.1 → 14.0.3

package/lib/analyses/ReflectWebSocketOperationAnalyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReflectWebSocketOperationAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/ReflectWebSocketOperationAnalyzer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ReflectWebSocketOperationAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/ReflectWebSocketOperationAnalyzer.ts"],"names":[],"mappings":";;;AAAA,+BAA8B;AAQ9B,oDAAiD;AACjD,qDAAkD;AAClD,mEAAgE;AAChE,iDAA8C;AAC9C,uEAAoE;AAEpE;;;;;;;;GAQG;AACH,IAAiB,iCAAiC,CAmLjD;AAnLD,WAAiB,iCAAiC;IAkBhD;;;;;;;;;OASG;IACU,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,QAAQ,GAA0C,aAAa;aAClE,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,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,eAAe,GAAG,CAC1H,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,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YACjC,IACE,CAAC,CAAC,QAAQ,KAAK,UAAU;gBACzB,CAAC,CAAC,QAAQ,KAAK,QAAQ;gBACvB,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,MAAM,CACJ,mBAAmB,uBAAU,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,yEAAyE,CAC9H,CAAC;gBACF,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAA4C,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,gEAAgE;QAChE,MAAM,UAAU,GACd,6CAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEvC,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,2BAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBAAE,SAAS;gBAE9C,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,EAnLgB,iCAAiC,aAAjC,iCAAiC,GAAjC,iCAAiC,QAmLjD"}

package/lib/analyses/SecurityAnalyzer.d.ts

@@ -1,3 +1,12 @@
+/**
+ * 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.
@@ -8,6 +17,12 @@ export declare namespace SecurityAnalyzer {
      * `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,6 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SecurityAnalyzer = void 0;
+/**
+ * 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) {
     /**
@@ -12,6 +21,12 @@ var SecurityAnalyzer;
      * `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 output = [];

package/lib/analyses/SecurityAnalyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"SecurityAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/SecurityAnalyzer.ts"],"names":[],"mappings":";;;AAAA,IAAiB,gBAAgB,CAkChC;AAlCD,WAAiB,gBAAgB;IAC/B;;;;;;;;;OASG;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,EAlCgB,gBAAgB,aAAhB,gBAAgB,GAAhB,gBAAgB,QAkChC"}
+{"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

@@ -1,5 +1,15 @@
 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
@@ -10,6 +20,12 @@ export declare namespace SwaggerExampleAnalyzer {
      * 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

@@ -1,6 +1,16 @@
 "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) {
     /**
@@ -12,6 +22,12 @@ var SwaggerExampleAnalyzer;
      * 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

package/lib/analyses/SwaggerExampleAnalyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"SwaggerExampleAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/SwaggerExampleAnalyzer.ts"],"names":[],"mappings":";;;AAGA,IAAiB,sBAAsB,CAmBtC;AAnBD,WAAiB,sBAAsB;IACrC;;;;;;;;;OASG;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,EAnBgB,sBAAsB,aAAtB,sBAAsB,GAAtB,sBAAsB,QAmBtC"}
+{"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;
 }