@nestia/sdk 14.0.1 → 14.0.3

package/lib/analyses/PathAnalyzer.d.ts

@@ -1,11 +1,37 @@
 import { RequestMethod } from "@nestjs/common";
+/**
+ * Helpers for route paths: joining, prefixing, and reading their parameters the
+ * way the router does.
+ *
+ * @evidence contracts/common.md#principled-implementation Paths are parsed by `path-to-regexp` after Fastify colon escapes are converted, so the parameters and literals are those the server reads.
+ * @evidence contracts/common.md#clear-and-simple-design Several small functions over one tokenizer and one parser.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The router's own grammar decides, and no path is special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 export declare namespace PathAnalyzer {
     /**
      * The route paths joined as the router joins them: one `/` between them, and
      * none doubled. A route path is router syntax, never a file path, so a
      * backslash stays the escape of the character after it (`items\\:batchGet`).
+     *
+     * @evidence contracts/common.md#principled-implementation The parts are joined, split on slashes, and empty segments are dropped, so any number of slashes at the boundaries collapses.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It applies to every input.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result form.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.join interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     export const join: (...args: string[]) => string;
+    /**
+     * Joins a path with the global prefix, unless the route is excluded from the
+     * prefix.
+     *
+     * @evidence contracts/common.md#principled-implementation The exclusion list is matched by method and by exact path or pattern, as NestJS does, and an excluded route is joined with an empty prefix.
+     * @evidence contracts/common.md#clear-and-simple-design One function delegating the exclusion test to a private helper.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The exclusion rule is NestJS's.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the exclusion.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.joinWithGlobalPrefix interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     export const joinWithGlobalPrefix: (props: {
         globalPrefix: string;
         exclude: IGlobalPrefixExclude[] | undefined;
@@ -13,10 +39,15 @@ export declare namespace PathAnalyzer {
         method: string;
         path: string;
     }) => string;
-    export const escape: (str: string) => string | null;
     /**
      * Whether a route path holds a wildcard: a `*` not escaped as the literal
      * character (`\\*`), which a route path may hold since #1713.
+     *
+     * @evidence contracts/common.md#principled-implementation A star preceded by a backslash is a literal, so the test looks for a star at the start or after a non-backslash character.
+     * @evidence contracts/common.md#clear-and-simple-design One regular expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It follows the router's escaping rule.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the escaped case.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.wildcard interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     export const wildcard: (str: string) => boolean;
     /**
@@ -25,13 +56,34 @@ export declare namespace PathAnalyzer {
      * and `/range/:from-:to` holds two parameters parted by `-`. Every generator
      * that writes a path with its parameters filled in reads it from here, never
      * by splitting the text at `:` or `/`. `null` for a path it cannot parse.
+     *
+     * @evidence contracts/common.md#principled-implementation Tokens come from `path-to-regexp`, so text next to a parameter in one segment, such as `/files/:id.json`, is kept in place, adjacent literals merge, and an unnamed parameter makes the path unreadable.
+     * @evidence contracts/common.md#clear-and-simple-design One function over the tokenizer.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The grammar is the router's.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result and why generators use it.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.segments interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     export const segments: (str: string) => ISegment[] | null;
     /**
      * The path in OpenAPI's template syntax, each parameter written `{name}`:
      * `/files/:id.json` is `/files/{id}.json`.
+     *
+     * @evidence contracts/common.md#principled-implementation The segments are joined with literals verbatim and parameters in braces.
+     * @evidence contracts/common.md#clear-and-simple-design One expression over `segments`.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It uses the same segmenter as the SDK generator.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the fallback.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.toOpenApi interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     export const toOpenApi: (str: string) => string;
+    /**
+     * A segment of a path: literal text or a named parameter.
+     *
+     * @evidence contracts/common.md#principled-implementation The union is discriminated by `type`, so a consumer handles each case once.
+     * @evidence contracts/common.md#clear-and-simple-design A two-member union.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a type and adds no runtime behavior.
+     * @evidence contracts/common.md#meaningful-documentation The comment names the two cases.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.ISegment interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     export type ISegment = {
         type: "literal";
         value: string;
@@ -39,6 +91,16 @@ export declare namespace PathAnalyzer {
         type: "param";
         name: string;
     };
+    /**
+     * Returns the names of the parameters of a path, or `null` when the path
+     * cannot be parsed.
+     *
+     * @evidence contracts/common.md#principled-implementation The parsed arguments are filtered to the parameters, and an empty parameter name makes the path unreadable.
+     * @evidence contracts/common.md#clear-and-simple-design One filter over the private parser.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The grammar is the router's.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.parameters interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     export const parameters: (str: string) => string[] | null;
     interface IGlobalPrefixExclude {
         path: string;

package/lib/analyses/PathAnalyzer.js

@@ -3,12 +3,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PathAnalyzer = void 0;
 const common_1 = require("@nestjs/common");
 const path_to_regexp_1 = require("path-to-regexp");
+/**
+ * Helpers for route paths: joining, prefixing, and reading their parameters the
+ * way the router does.
+ *
+ * @evidence contracts/common.md#principled-implementation Paths are parsed by `path-to-regexp` after Fastify colon escapes are converted, so the parameters and literals are those the server reads.
+ * @evidence contracts/common.md#clear-and-simple-design Several small functions over one tokenizer and one parser.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The router's own grammar decides, and no path is special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 var PathAnalyzer;
 (function (PathAnalyzer) {
     /**
      * The route paths joined as the router joins them: one `/` between them, and
      * none doubled. A route path is router syntax, never a file path, so a
      * backslash stays the escape of the character after it (`items\\:batchGet`).
+     *
+     * @evidence contracts/common.md#principled-implementation The parts are joined, split on slashes, and empty segments are dropped, so any number of slashes at the boundaries collapses.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It applies to every input.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result form.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.join interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     PathAnalyzer.join = (...args) => "/" +
         args
@@ -16,21 +32,28 @@ var PathAnalyzer;
             .split("/")
             .filter((str) => str.length !== 0)
             .join("/");
+    /**
+     * Joins a path with the global prefix, unless the route is excluded from the
+     * prefix.
+     *
+     * @evidence contracts/common.md#principled-implementation The exclusion list is matched by method and by exact path or pattern, as NestJS does, and an excluded route is joined with an empty prefix.
+     * @evidence contracts/common.md#clear-and-simple-design One function delegating the exclusion test to a private helper.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The exclusion rule is NestJS's.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the exclusion.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.joinWithGlobalPrefix interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     PathAnalyzer.joinWithGlobalPrefix = (props) => { var _a; return PathAnalyzer.join(isGlobalPrefixExcluded(props.exclude, (_a = props.excludePath) !== null && _a !== void 0 ? _a : props.path, props.method)
         ? ""
         : props.globalPrefix, props.path); };
-    PathAnalyzer.escape = (str) => {
-        const args = _Parse(str);
-        if (args === null)
-            return null;
-        return ("/" +
-            args
-                .map((arg) => (arg.type === "param" ? `:${arg.value}` : arg.value))
-                .join("/"));
-    };
     /**
      * Whether a route path holds a wildcard: a `*` not escaped as the literal
      * character (`\\*`), which a route path may hold since #1713.
+     *
+     * @evidence contracts/common.md#principled-implementation A star preceded by a backslash is a literal, so the test looks for a star at the start or after a non-backslash character.
+     * @evidence contracts/common.md#clear-and-simple-design One regular expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It follows the router's escaping rule.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the escaped case.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.wildcard interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     PathAnalyzer.wildcard = (str) => /(^|[^\\])\*/.test(str);
     /**
@@ -39,6 +62,12 @@ var PathAnalyzer;
      * and `/range/:from-:to` holds two parameters parted by `-`. Every generator
      * that writes a path with its parameters filled in reads it from here, never
      * by splitting the text at `:` or `/`. `null` for a path it cannot parse.
+     *
+     * @evidence contracts/common.md#principled-implementation Tokens come from `path-to-regexp`, so text next to a parameter in one segment, such as `/files/:id.json`, is kept in place, adjacent literals merge, and an unnamed parameter makes the path unreadable.
+     * @evidence contracts/common.md#clear-and-simple-design One function over the tokenizer.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The grammar is the router's.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result and why generators use it.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.segments interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     PathAnalyzer.segments = (str) => {
         const tokens = _Tokenize(str);
@@ -69,6 +98,12 @@ var PathAnalyzer;
     /**
      * The path in OpenAPI's template syntax, each parameter written `{name}`:
      * `/files/:id.json` is `/files/{id}.json`.
+     *
+     * @evidence contracts/common.md#principled-implementation The segments are joined with literals verbatim and parameters in braces.
+     * @evidence contracts/common.md#clear-and-simple-design One expression over `segments`.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It uses the same segmenter as the SDK generator.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the fallback.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.toOpenApi interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     PathAnalyzer.toOpenApi = (str) => {
         const list = PathAnalyzer.segments(str);
@@ -78,6 +113,16 @@ var PathAnalyzer;
                 .map((s) => (s.type === "literal" ? s.value : `{${s.name}}`))
                 .join("");
     };
+    /**
+     * Returns the names of the parameters of a path, or `null` when the path
+     * cannot be parsed.
+     *
+     * @evidence contracts/common.md#principled-implementation The parsed arguments are filtered to the parameters, and an empty parameter name makes the path unreadable.
+     * @evidence contracts/common.md#clear-and-simple-design One filter over the private parser.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The grammar is the router's.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.parameters interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     PathAnalyzer.parameters = (str) => {
         const args = _Parse(str);
         if (args === null)

package/lib/analyses/PathAnalyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"PathAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/PathAnalyzer.ts"],"names":[],"mappings":";;;AAAA,2CAA+C;AAC/C,mDAA8C;AAE9C,IAAiB,YAAY,CAiL5B;AAjLD,WAAiB,YAAY;IAC3B;;;;OAIG;IACU,iBAAI,GAAG,CAAC,GAAG,IAAc,EAAE,EAAE,CACxC,GAAG;QACH,IAAI;aACD,IAAI,CAAC,GAAG,CAAC;aACT,KAAK,CAAC,GAAG,CAAC;aACV,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC;aACjC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEF,iCAAoB,GAAG,CAAC,KAMpC,EAAU,EAAE,kBACX,iBAAI,CACF,sBAAsB,CACpB,KAAK,CAAC,OAAO,QACb,KAAK,CAAC,WAAW,mCAAI,KAAK,CAAC,IAAI,EAC/B,KAAK,CAAC,MAAM,CACb;QACC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,KAAK,CAAC,YAAY,EACtB,KAAK,CAAC,IAAI,CACX,GAAA,CAAC;IAES,mBAAM,GAAG,CAAC,GAAW,EAAiB,EAAE;QACnD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC/B,OAAO,CACL,GAAG;YACH,IAAI;iBACD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;iBAClE,IAAI,CAAC,GAAG,CAAC,CACb,CAAC;IACJ,CAAC,CAAC;IAEF;;;OAGG;IACU,qBAAQ,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE1E;;;;;;OAMG;IACU,qBAAQ,GAAG,CAAC,GAAW,EAAqB,EAAE;QACzD,MAAM,MAAM,GAAmB,SAAS,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACjC,MAAM,MAAM,GAAe,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,CAAC,KAAa,EAAQ,EAAE;YACtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAC/B,MAAM,IAAI,GAAyB,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC7D,IAAI,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,MAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;;gBAC7C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/C,CAAC,CAAC;QACF,KAAK,MAAM,KAAK,IAAI,MAAM;YACxB,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,CAAC,KAAK,CAAC,CAAC;iBACzC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;iBAChD,CAAC;gBACJ,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;gBACjD,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACxB,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF;;;OAGG;IACU,sBAAS,GAAG,CAAC,GAAW,EAAU,EAAE;QAC/C,MAAM,IAAI,GAAsB,qBAAQ,CAAC,GAAG,CAAC,CAAC;QAC9C,OAAO,IAAI,KAAK,IAAI;YAClB,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,IAAI;iBACD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;iBAC5D,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC,CAAC;IAMW,uBAAU,GAAG,CAAC,GAAW,EAAmB,EAAE;QACzD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5E,CAAC,CAAC;IAEF;;;;OAIG;IACH,SAAS,SAAS,CAAC,GAAW;QAC5B,IAAI,CAAC;YACH,OAAO,IAAA,sBAAK,EAAC,iBAAiB,CAAC,iBAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;mBAAO,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,SAAS,MAAM,CAAC,GAAW;QACzB,MAAM,MAAM,GAAmB,SAAS,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAEjC,MAAM,MAAM,GAAgB,EAAE,CAAC;QAC/B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,OAAO,GAAG,KAAK,QAAQ;gBACzB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,MAAM;oBACZ,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC;iBAClB,CAAC,CAAC;iBACA,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE;gBAC7D,OAAO,IAAI,CAAC;;gBAEZ,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;iBACvB,CAAC,CAAC;QACP,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,SAAS,KAAK,CAAC,GAAW;QACxB,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG;YAAE,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACxE,OAAO,GAAG,CAAC;IACb,CAAC;IAED,SAAS,sBAAsB,CAC7B,OAA2C,EAC3C,IAAY,EACZ,MAAc;QAEd,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACxC,MAAM,aAAa,GAA8B,eAAe,CAAC,MAAM,CAAC,CAAC;QACzE,IAAI,aAAa,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAE9C,MAAM,QAAQ,GAAW,iBAAI,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;;YAC5B,MAAM,WAAW,SACf,KAAK,CAAC,aAAa,mCAAI,KAAK,CAAC,MAAM,CAAC;YACtC,IACE,WAAW,KAAK,SAAS;gBACzB,WAAW,KAAK,sBAAa,CAAC,GAAG;gBACjC,WAAW,KAAK,aAAa;gBAE7B,OAAO,KAAK,CAAC;YACf,IAAI,KAAK,CAAC,SAAS,YAAY,MAAM;gBACnC,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC9C,OAAO,iBAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC;AAaH,CAAC,EAjLgB,YAAY,aAAZ,YAAY,GAAZ,YAAY,QAiL5B;AAED,MAAM,eAAe,GAAkC;IACrD,MAAM,EAAE,sBAAa,CAAC,MAAM;IAC5B,GAAG,EAAE,sBAAa,CAAC,GAAG;IACtB,IAAI,EAAE,sBAAa,CAAC,IAAI;IACxB,OAAO,EAAE,sBAAa,CAAC,OAAO;IAC9B,KAAK,EAAE,sBAAa,CAAC,KAAK;IAC1B,IAAI,EAAE,sBAAa,CAAC,IAAI;IACxB,GAAG,EAAE,sBAAa,CAAC,GAAG;CACvB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAAU,EAAE;IAClD,IAAI,MAAM,GAAW,EAAE,CAAC;IACxB,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAI,CAAC;QAC3C,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAChC,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;aAAM,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC;YAChB,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;aAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAW,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;YACjE,MAAM,IAAI,IAAI,CAAC;YACf,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC;YACjB,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,IAAI,CAAC;gBACf,CAAC,IAAI,CAAC,CAAC;YACT,CAAC;QACH,CAAC;;YAAM,MAAM,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}
+{"version":3,"file":"PathAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/PathAnalyzer.ts"],"names":[],"mappings":"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"}

package/lib/analyses/ReflectControllerAnalyzer.d.ts

@@ -1,11 +1,43 @@
 import { INestiaProject } from "../structures/INestiaProject";
 import { INestiaSdkInput } from "../structures/INestiaSdkInput";
 import { IReflectController } from "../structures/IReflectController";
+/**
+ * Reflects a NestJS controller class into an operation list.
+ *
+ * @evidence contracts/common.md#principled-implementation A controller is recognized by Nest's own path, host, and scope metadata, its methods are visited along the prototype chain with a subclass method hiding an inherited one, and each method is classified as MCP, WebSocket, or HTTP.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and one prototype walker.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The recognition uses the metadata Nest writes, and no class name is special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectControllerAnalyzer 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 ReflectControllerAnalyzer {
+    /**
+     * The input of the controller analysis: the project, the controller, and a
+     * set of visited functions.
+     *
+     * @evidence contracts/common.md#principled-implementation The record holds what one analysis needs and the shared error lists live in the project.
+     * @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 ReflectControllerAnalyzer.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: INestiaSdkInput.IController;
         unique: WeakSet<Function>;
     }
+    /**
+     * Returns the reflected controller with its operations, or `null` for a class
+     * that is not a controller.
+     *
+     * Wildcard controller paths are dropped with a warning, and methods marked
+     * `@ignore` are skipped.
+     *
+     * @evidence contracts/common.md#principled-implementation The metadata keys of the class decide whether it is a controller, every own and inherited method with operation metadata is offered to the MCP, WebSocket, and HTTP analyzers in that order, and the first analyzer that accepts it owns it.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The order of the analyzers is fixed by the mutual exclusion of the decorators.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the null result, the warning, and the ignore tag.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectControllerAnalyzer.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: IProps) => IReflectController | null;
 }

package/lib/analyses/ReflectControllerAnalyzer.js

@@ -8,11 +8,33 @@ const ReflectHttpOperationAnalyzer_1 = require("./ReflectHttpOperationAnalyzer")
 const ReflectMcpOperationAnalyzer_1 = require("./ReflectMcpOperationAnalyzer");
 const ReflectMetadataAnalyzer_1 = require("./ReflectMetadataAnalyzer");
 const ReflectWebSocketOperationAnalyzer_1 = require("./ReflectWebSocketOperationAnalyzer");
+/**
+ * Reflects a NestJS controller class into an operation list.
+ *
+ * @evidence contracts/common.md#principled-implementation A controller is recognized by Nest's own path, host, and scope metadata, its methods are visited along the prototype chain with a subclass method hiding an inherited one, and each method is classified as MCP, WebSocket, or HTTP.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and one prototype walker.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The recognition uses the metadata Nest writes, and no class name is special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectControllerAnalyzer 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 ReflectControllerAnalyzer;
 (function (ReflectControllerAnalyzer) {
     /* ---------------------------------------------------------
       CONTROLLER
     --------------------------------------------------------- */
+    /**
+     * Returns the reflected controller with its operations, or `null` for a class
+     * that is not a controller.
+     *
+     * Wildcard controller paths are dropped with a warning, and methods marked
+     * `@ignore` are skipped.
+     *
+     * @evidence contracts/common.md#principled-implementation The metadata keys of the class decide whether it is a controller, every own and inherited method with operation metadata is offered to the MCP, WebSocket, and HTTP analyzers in that order, and the first analyzer that accepts it owns it.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The order of the analyzers is fixed by the mutual exclusion of the decorators.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the null result, the warning, and the ignore tag.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectControllerAnalyzer.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.
+     */
     ReflectControllerAnalyzer.analyze = (props) => {
         var _a, _b, _c;
         // MUST BE TYPE OF A CREATOR WHO HAS THE CONSTRUCTOR

package/lib/analyses/ReflectControllerAnalyzer.js.map

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

package/lib/analyses/ReflectHttpOperationAnalyzer.d.ts

@@ -2,7 +2,26 @@ import { INestiaProject } from "../structures/INestiaProject";
 import { IOperationMetadata } from "../structures/IOperationMetadata";
 import { IReflectController } from "../structures/IReflectController";
 import { IReflectHttpOperation } from "../structures/IReflectHttpOperation";
+/**
+ * Reflects an HTTP route method into an operation.
+ *
+ * @evidence contracts/common.md#principled-implementation The method, the path list, the parameters, the success response, the exceptions, the imports, the security, and the extensions are composed from Nest's metadata and the compile-time metadata, and the path parameters of the decorator are checked against the parameter decorators.
+ * @evidence contracts/common.md#clear-and-simple-design One public function over the parameter, response, and exception analyzers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The checks follow the decorators and no route is special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationAnalyzer 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 ReflectHttpOperationAnalyzer {
+    /**
+     * The input of the HTTP operation analysis: the project, the controller, the
+     * method, and its compile-time metadata.
+     *
+     * @evidence contracts/common.md#principled-implementation The record holds the reflected function and the metadata the transform attached to it.
+     * @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 ReflectHttpOperationAnalyzer.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"> & Partial<Pick<INestiaProject, "config">>;
         controller: IReflectController;
@@ -10,5 +29,15 @@ export declare namespace ReflectHttpOperationAnalyzer {
         name: string;
         metadata: IOperationMetadata;
     }
+    /**
+     * Returns the reflected HTTP operation, or `null` when the method is not a
+     * route or has errors, which are pushed to the project.
+     *
+     * @evidence contracts/common.md#principled-implementation A method is a route when it has Nest's path and method metadata; `ALL` is treated as POST and OPTIONS is skipped; a mismatch between the path parameters and the parameter decorators is an error.
+     * @evidence contracts/common.md#clear-and-simple-design One function that collects errors and returns nothing when there is one.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The rules follow the HTTP semantics of the decorators.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the null result and the collected errors.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationAnalyzer.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: IProps) => IReflectHttpOperation | null;
 }

package/lib/analyses/ReflectHttpOperationAnalyzer.js

@@ -10,8 +10,27 @@ const ReflectHttpOperationExceptionAnalyzer_1 = require("./ReflectHttpOperationE
 const ReflectHttpOperationParameterAnalyzer_1 = require("./ReflectHttpOperationParameterAnalyzer");
 const ReflectHttpOperationResponseAnalyzer_1 = require("./ReflectHttpOperationResponseAnalyzer");
 const ReflectMetadataAnalyzer_1 = require("./ReflectMetadataAnalyzer");
+/**
+ * Reflects an HTTP route method into an operation.
+ *
+ * @evidence contracts/common.md#principled-implementation The method, the path list, the parameters, the success response, the exceptions, the imports, the security, and the extensions are composed from Nest's metadata and the compile-time metadata, and the path parameters of the decorator are checked against the parameter decorators.
+ * @evidence contracts/common.md#clear-and-simple-design One public function over the parameter, response, and exception analyzers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The checks follow the decorators and no route is special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationAnalyzer 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 ReflectHttpOperationAnalyzer;
 (function (ReflectHttpOperationAnalyzer) {
+    /**
+     * Returns the reflected HTTP operation, or `null` when the method is not a
+     * route or has errors, which are pushed to the project.
+     *
+     * @evidence contracts/common.md#principled-implementation A method is a route when it has Nest's path and method metadata; `ALL` is treated as POST and OPTIONS is skipped; a mismatch between the path parameters and the parameter decorators is an error.
+     * @evidence contracts/common.md#clear-and-simple-design One function that collects errors and returns nothing when there is one.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The rules follow the HTTP semantics of the decorators.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the null result and the collected errors.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationAnalyzer.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.
+     */
     ReflectHttpOperationAnalyzer.analyze = (props) => {
         var _a, _b, _c, _d;
         var _e;
@@ -29,22 +48,14 @@ var ReflectHttpOperationAnalyzer;
             functionName: props.name,
             errors,
         });
-        const success = (() => {
-            const localErrors = [];
-            const success = ReflectHttpOperationResponseAnalyzer_1.ReflectHttpOperationResponseAnalyzer.analyze({
-                controller: props.controller,
-                function: props.function,
-                functionName: props.name,
-                httpMethod: method,
-                metadata: props.metadata,
-                errors,
-            });
-            if (localErrors.length) {
-                errors.push(...localErrors);
-                return null;
-            }
-            return success;
-        })();
+        const success = ReflectHttpOperationResponseAnalyzer_1.ReflectHttpOperationResponseAnalyzer.analyze({
+            controller: props.controller,
+            function: props.function,
+            functionName: props.name,
+            httpMethod: method,
+            metadata: props.metadata,
+            errors,
+        });
         if (errors.length) {
             props.project.errors.push(...errors);
             return null;
@@ -108,7 +119,7 @@ var ReflectHttpOperationAnalyzer;
                 // LIST UP PARAMETERS
                 const binded = PathAnalyzer_1.PathAnalyzer.parameters(location);
                 if (binded === null) {
-                    props.project.errors.push({
+                    errors.push({
                         file: props.controller.file,
                         class: props.controller.class.name,
                         function: props.name,

package/lib/analyses/ReflectHttpOperationAnalyzer.js.map

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

package/lib/analyses/ReflectHttpOperationExceptionAnalyzer.d.ts

@@ -2,7 +2,26 @@ import { IOperationMetadata } from "../structures/IOperationMetadata";
 import { IReflectController } from "../structures/IReflectController";
 import { IReflectHttpOperationException } from "../structures/IReflectHttpOperationException";
 import { IReflectOperationError } from "../structures/IReflectOperationError";
+/**
+ * Reflects the `@TypedException` declarations of a method.
+ *
+ * @evidence contracts/common.md#principled-implementation The declarations are read in declaration order and matched by position with the exception types the transform recorded.
+ * @evidence contracts/common.md#clear-and-simple-design One public function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The matching is by position because both lists are produced in declaration order.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationExceptionAnalyzer 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 ReflectHttpOperationExceptionAnalyzer {
+    /**
+     * The input of the exception 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 ReflectHttpOperationExceptionAnalyzer.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 ReflectHttpOperationExceptionAnalyzer {
         metadata: IOperationMetadata;
         errors: IReflectOperationError[];
     }
+    /**
+     * Returns the exceptions of a method by status.
+     *
+     * A declaration without a matching type, or with an unreadable one, is an
+     * error.
+     *
+     * @evidence contracts/common.md#principled-implementation Decorators apply bottom-up, so the metadata array is reversed to declaration order before it is paired with the transform's exception list, and the result is keyed by status, so the last declaration of a status wins.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The pairing follows the documented order, and every mismatch is reported.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the matching and the errors.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationExceptionAnalyzer.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) => Record<string, IReflectHttpOperationException>;
 }

package/lib/analyses/ReflectHttpOperationExceptionAnalyzer.js

@@ -2,8 +2,29 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReflectHttpOperationExceptionAnalyzer = void 0;
 const legacy_1 = require("../internal/legacy");
+/**
+ * Reflects the `@TypedException` declarations of a method.
+ *
+ * @evidence contracts/common.md#principled-implementation The declarations are read in declaration order and matched by position with the exception types the transform recorded.
+ * @evidence contracts/common.md#clear-and-simple-design One public function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The matching is by position because both lists are produced in declaration order.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationExceptionAnalyzer 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 ReflectHttpOperationExceptionAnalyzer;
 (function (ReflectHttpOperationExceptionAnalyzer) {
+    /**
+     * Returns the exceptions of a method by status.
+     *
+     * A declaration without a matching type, or with an unreadable one, is an
+     * error.
+     *
+     * @evidence contracts/common.md#principled-implementation Decorators apply bottom-up, so the metadata array is reversed to declaration order before it is paired with the transform's exception list, and the result is keyed by status, so the last declaration of a status wins.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The pairing follows the documented order, and every mismatch is reported.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the matching and the errors.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ReflectHttpOperationExceptionAnalyzer.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.
+     */
     ReflectHttpOperationExceptionAnalyzer.analyze = (ctx) => {
         // TypeScript applies decorators bottom-up, so Reflect's metadata array
         // is the reverse of declaration order. Reverse it once here so the

package/lib/analyses/ReflectHttpOperationExceptionAnalyzer.js.map

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