@nestia/sdk 14.0.1 → 14.0.2

package/lib/utils/TtscExecutor.d.ts

@@ -1,9 +1,31 @@
 import cp from "child_process";
+/**
+ * Runs the `ttsc` compiler of the project.
+ *
+ * @evidence contracts/common.md#principled-implementation The binary is found from the project's own `ttsc` package, with the SDK's dependency as a fallback, and is run with the current Node.
+ * @evidence contracts/common.md#clear-and-simple-design One function and a resolution cache.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The binary comes from the package manifest, not a fixed path.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidence contracts/portability.md#os-neutral-implementation The compiler runs as a child of the current Node executable (`process.execPath`) on the JavaScript entry that the package manifest's `bin` names, found through Node module resolution from the project directory, so no platform shim (`.cmd`, `.ps1` or shell script) and no `PATH` lookup is involved. Arguments are an array, never a command line, and the entry path is joined with `path.join` and checked with `existsSync`.
+ */
 export declare namespace TtscExecutor {
+    /**
+     * Compiles a project with `ttsc` and returns captured output, or null when
+     * the selected stdio does not pipe standard output.
+     *
+     * The cache directory of the environment is passed on, and a non-zero exit
+     * throws.
+     *
+     * @evidence contracts/common.md#principled-implementation The command is run with an argument array and the current Node executable, so no shell or platform shim is involved.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The environment is extended, not replaced.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the arguments and the failure.
+     * @evidence contracts/portability.md#os-neutral-implementation The working directory and the environment are explicit. Standard output is piped by default with a 64 MiB buffer; callers may select another stdio mode. A non-zero exit surfaces as Node's process error carrying `status` and available captured output.
+     */
     const run: (props: {
         cwd: string;
         env?: NodeJS.ProcessEnv;
         project: string;
         stdio?: cp.StdioOptions;
-    }) => Buffer;
+    }) => Buffer | null;
 }

package/lib/utils/TtscExecutor.js

@@ -7,8 +7,30 @@ exports.TtscExecutor = void 0;
 const child_process_1 = __importDefault(require("child_process"));
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+/**
+ * Runs the `ttsc` compiler of the project.
+ *
+ * @evidence contracts/common.md#principled-implementation The binary is found from the project's own `ttsc` package, with the SDK's dependency as a fallback, and is run with the current Node.
+ * @evidence contracts/common.md#clear-and-simple-design One function and a resolution cache.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The binary comes from the package manifest, not a fixed path.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidence contracts/portability.md#os-neutral-implementation The compiler runs as a child of the current Node executable (`process.execPath`) on the JavaScript entry that the package manifest's `bin` names, found through Node module resolution from the project directory, so no platform shim (`.cmd`, `.ps1` or shell script) and no `PATH` lookup is involved. Arguments are an array, never a command line, and the entry path is joined with `path.join` and checked with `existsSync`.
+ */
 var TtscExecutor;
 (function (TtscExecutor) {
+    /**
+     * Compiles a project with `ttsc` and returns captured output, or null when
+     * the selected stdio does not pipe standard output.
+     *
+     * The cache directory of the environment is passed on, and a non-zero exit
+     * throws.
+     *
+     * @evidence contracts/common.md#principled-implementation The command is run with an argument array and the current Node executable, so no shell or platform shim is involved.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The environment is extended, not replaced.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the arguments and the failure.
+     * @evidence contracts/portability.md#os-neutral-implementation The working directory and the environment are explicit. Standard output is piped by default with a 64 MiB buffer; callers may select another stdio mode. A non-zero exit surfaces as Node's process error carrying `status` and available captured output.
+     */
     TtscExecutor.run = (props) => {
         var _a;
         const args = [bin(props.cwd), "-p", props.project];

package/lib/utils/TtscExecutor.js.map

@@ -1 +1 @@
-{"version":3,"file":"TtscExecutor.js","sourceRoot":"","sources":["../../src/utils/TtscExecutor.ts"],"names":[],"mappings":";;;;;;AAAA,kEAA+B;AAC/B,4CAAoB;AACpB,gDAAwB;AAExB,IAAiB,YAAY,CA+D5B;AA/DD,WAAiB,YAAY;IACd,gBAAG,GAAG,CAAC,KAKnB,EAAU,EAAE;;QACX,MAAM,IAAI,GAAa,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,SAAS;YAC1C,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACvD,OAAO,uBAAE,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE;YAC7C,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,GAAG,kCACE,OAAO,CAAC,GAAG,GACX,KAAK,CAAC,GAAG,CACb;YACD,KAAK,QAAE,KAAK,CAAC,KAAK,mCAAI,MAAM;YAC5B,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,IAAI,GAAwB,IAAI,GAAG,EAAE,CAAC;IAE5C,MAAM,GAAG,GAAG,CAAC,GAAW,EAAU,EAAE;;QAClC,MAAM,MAAM,GAAuB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QAExC,sEAAsE;QACtE,oEAAoE;QACpE,wCAAwC;QACxC,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;mBAAO,CAAC;YACP,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,SAAS,GAAW,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,IAAI,GAA8C,IAAI,CAAC,KAAK,CAChE,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAClC,CAAC;QACF,MAAM,QAAQ,GACZ,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAA,IAAI,CAAC,GAAG,0CAAE,IAAI,CAAC;QAC3D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,GACR,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI;gBAC/C,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBAClC,CAAC,CAAC,QAAQ,CAAC;YACf,MAAM,IAAI,KAAK,CACb,sDAAsD;gBACpD,0BAA0B,IAAI,IAAI;gBAClC,6CAA6C,CAChD,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAW,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,+BAA+B,QAAQ,KAAK;gBAC1C,6CAA6C,CAChD,CAAC;QACJ,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACxB,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC,EA/DgB,YAAY,aAAZ,YAAY,GAAZ,YAAY,QA+D5B"}
+{"version":3,"file":"TtscExecutor.js","sourceRoot":"","sources":["../../src/utils/TtscExecutor.ts"],"names":[],"mappings":";;;;;;AAAA,kEAA+B;AAC/B,4CAAoB;AACpB,gDAAwB;AAExB;;;;;;;;GAQG;AACH,IAAiB,YAAY,CA4E5B;AA5ED,WAAiB,YAAY;IAC3B;;;;;;;;;;;;OAYG;IACU,gBAAG,GAAG,CAAC,KAKnB,EAAiB,EAAE;;QAClB,MAAM,IAAI,GAAa,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,SAAS;YAC1C,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACvD,OAAO,uBAAE,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE;YAC7C,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,GAAG,kCACE,OAAO,CAAC,GAAG,GACX,KAAK,CAAC,GAAG,CACb;YACD,KAAK,QAAE,KAAK,CAAC,KAAK,mCAAI,MAAM;YAC5B,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,IAAI,GAAwB,IAAI,GAAG,EAAE,CAAC;IAE5C,MAAM,GAAG,GAAG,CAAC,GAAW,EAAU,EAAE;;QAClC,MAAM,MAAM,GAAuB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QAExC,sEAAsE;QACtE,oEAAoE;QACpE,wCAAwC;QACxC,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;mBAAO,CAAC;YACP,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,SAAS,GAAW,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,IAAI,GAA8C,IAAI,CAAC,KAAK,CAChE,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAClC,CAAC;QACF,MAAM,QAAQ,GACZ,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAA,IAAI,CAAC,GAAG,0CAAE,IAAI,CAAC;QAC3D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,GACR,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI;gBAC/C,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBAClC,CAAC,CAAC,QAAQ,CAAC;YACf,MAAM,IAAI,KAAK,CACb,sDAAsD;gBACpD,0BAA0B,IAAI,IAAI;gBAClC,6CAA6C,CAChD,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAW,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,+BAA+B,QAAQ,KAAK;gBAC1C,6CAA6C,CAChD,CAAC;QACJ,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACxB,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC,EA5EgB,YAAY,aAAZ,YAAY,GAAZ,YAAY,QA4E5B"}

package/lib/utils/VersioningStrategy.d.ts

@@ -1,7 +1,26 @@
 import { VERSION_NEUTRAL, VersionValue } from "@nestjs/common/interfaces";
 import { INestiaProject } from "../structures/INestiaProject";
+/**
+ * Resolves the URI versions of a controller method as NestJS does.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace turns version metadata and the default version into path segments.
+ * @evidence contracts/common.md#clear-and-simple-design Two functions.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The precedence is NestJS's.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation VersioningStrategy maps Nest version metadata to URI segments, which are protocol spelling rather than native file paths.
+ */
 export declare namespace VersioningStrategy {
-    const cast: (value: VersionValue | undefined) => Array<string | typeof VERSION_NEUTRAL>;
+    /**
+     * Casts version metadata to a list: absence stays absent and a single value
+     * is a one-element list.
+     *
+     * @evidence contracts/common.md#principled-implementation A single version becomes a list while absence stays distinct from an explicit empty list, which registers no paths rather than inheriting other versions.
+     * @evidence contracts/common.md#clear-and-simple-design One conditional.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It adds nothing.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the cases.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation VersioningStrategy.cast maps Nest version metadata to URI segments, which are protocol spelling rather than native file paths.
+     */
+    const cast: (value: VersionValue | undefined) => Array<string | typeof VERSION_NEUTRAL> | undefined;
     /**
      * Version path segments of a route, resolved as NestJS resolves them: the
      * method's versions, else the controller's, else the default version, and no
@@ -10,6 +29,12 @@ export declare namespace VersioningStrategy {
      * The controller's and the method's versions were joined, so a method
      * overriding its controller's version was also described at the controller's,
      * and a route with no version and no default got no path at all (#1735).
+     *
+     * @evidence contracts/common.md#principled-implementation The first present method, controller or default list wins, including an empty list that registers no paths. Duplicates are removed, neutral and absent versions have no segment, and with versioning off the only segment is empty.
+     * @evidence contracts/common.md#clear-and-simple-design One curried function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The precedence is NestJS's.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the precedence.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation VersioningStrategy.merge maps Nest version metadata to URI segments, which are protocol spelling rather than native file paths.
      */
     const merge: (project: Omit<INestiaProject, "config">) => (props: {
         controller: Array<string | typeof VERSION_NEUTRAL> | undefined;

package/lib/utils/VersioningStrategy.js

@@ -1,9 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VersioningStrategy = void 0;
+/**
+ * Resolves the URI versions of a controller method as NestJS does.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace turns version metadata and the default version into path segments.
+ * @evidence contracts/common.md#clear-and-simple-design Two functions.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The precedence is NestJS's.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation VersioningStrategy maps Nest version metadata to URI segments, which are protocol spelling rather than native file paths.
+ */
 var VersioningStrategy;
 (function (VersioningStrategy) {
-    VersioningStrategy.cast = (value) => value === undefined ? [] : Array.isArray(value) ? value : [value];
+    /**
+     * Casts version metadata to a list: absence stays absent and a single value
+     * is a one-element list.
+     *
+     * @evidence contracts/common.md#principled-implementation A single version becomes a list while absence stays distinct from an explicit empty list, which registers no paths rather than inheriting other versions.
+     * @evidence contracts/common.md#clear-and-simple-design One conditional.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It adds nothing.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the cases.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation VersioningStrategy.cast maps Nest version metadata to URI segments, which are protocol spelling rather than native file paths.
+     */
+    VersioningStrategy.cast = (value) => value === undefined ? undefined : Array.isArray(value) ? value : [value];
     /**
      * Version path segments of a route, resolved as NestJS resolves them: the
      * method's versions, else the controller's, else the default version, and no
@@ -12,23 +31,25 @@ var VersioningStrategy;
      * The controller's and the method's versions were joined, so a method
      * overriding its controller's version was also described at the controller's,
      * and a route with no version and no default got no path at all (#1735).
+     *
+     * @evidence contracts/common.md#principled-implementation The first present method, controller or default list wins, including an empty list that registers no paths. Duplicates are removed, neutral and absent versions have no segment, and with versioning off the only segment is empty.
+     * @evidence contracts/common.md#clear-and-simple-design One curried function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The precedence is NestJS's.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the precedence.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation VersioningStrategy.merge maps Nest version metadata to URI segments, which are protocol spelling rather than native file paths.
      */
     VersioningStrategy.merge = (project) => (props) => {
         var _a, _b;
         const versioning = project.input.versioning;
         if (versioning === undefined)
             return [""];
-        const chosen = ((_a = props.method) === null || _a === void 0 ? void 0 : _a.length)
-            ? props.method
-            : ((_b = props.controller) === null || _b === void 0 ? void 0 : _b.length)
-                ? props.controller
-                : VersioningStrategy.cast(versioning.defaultVersion);
+        const chosen = (_b = (_a = props.method) !== null && _a !== void 0 ? _a : props.controller) !== null && _b !== void 0 ? _b : VersioningStrategy.cast(versioning.defaultVersion);
+        if (chosen === undefined)
+            return [""];
         const unique = [
             ...new Set(chosen),
         ];
-        return unique.length
-            ? unique.map((x) => typeof x === "symbol" ? "" : `${versioning.prefix}${x}`)
-            : [""];
+        return unique.map((x) => typeof x === "symbol" ? "" : `${versioning.prefix}${x}`);
     };
 })(VersioningStrategy || (exports.VersioningStrategy = VersioningStrategy = {}));
 //# sourceMappingURL=VersioningStrategy.js.map

package/lib/utils/VersioningStrategy.js.map

@@ -1 +1 @@
-{"version":3,"file":"VersioningStrategy.js","sourceRoot":"","sources":["../../src/utils/VersioningStrategy.ts"],"names":[],"mappings":";;;AAIA,IAAiB,kBAAkB,CAsClC;AAtCD,WAAiB,kBAAkB;IACpB,uBAAI,GAAG,CAClB,KAA+B,EACS,EAAE,CAC1C,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAEpE;;;;;;;;OAQG;IACU,wBAAK,GAChB,CAAC,OAAuC,EAAE,EAAE,CAC5C,CAAC,KAGA,EAAY,EAAE;;QACb,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;QAC5C,IAAI,UAAU,KAAK,SAAS;YAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,MAAM,GAA2C,CAAA,MAAA,KAAK,CAAC,MAAM,0CAC/D,MAAM;YACR,CAAC,CAAC,KAAK,CAAC,MAAM;YACd,CAAC,CAAC,CAAA,MAAA,KAAK,CAAC,UAAU,0CAAE,MAAM;gBACxB,CAAC,CAAC,KAAK,CAAC,UAAU;gBAClB,CAAC,CAAC,uBAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QACtC,MAAM,MAAM,GAA2C;YACrD,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC;SACnB,CAAC;QACF,OAAO,MAAM,CAAC,MAAM;YAClB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACf,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CACxD;YACH,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACX,CAAC,CAAC;AACN,CAAC,EAtCgB,kBAAkB,aAAlB,kBAAkB,GAAlB,kBAAkB,QAsClC"}
+{"version":3,"file":"VersioningStrategy.js","sourceRoot":"","sources":["../../src/utils/VersioningStrategy.ts"],"names":[],"mappings":";;;AAIA;;;;;;;;GAQG;AACH,IAAiB,kBAAkB,CAiDlC;AAjDD,WAAiB,kBAAkB;IACjC;;;;;;;;;OASG;IACU,uBAAI,GAAG,CAClB,KAA+B,EACqB,EAAE,CACtD,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAE3E;;;;;;;;;;;;;;OAcG;IACU,wBAAK,GAChB,CAAC,OAAuC,EAAE,EAAE,CAC5C,CAAC,KAGA,EAAY,EAAE;;QACb,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;QAC5C,IAAI,UAAU,KAAK,SAAS;YAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,MAAM,eACV,KAAK,CAAC,MAAM,mCAAI,KAAK,CAAC,UAAU,mCAAI,uBAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QACtE,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,MAAM,GAA2C;YACrD,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC;SACnB,CAAC;QACF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACtB,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CACxD,CAAC;IACJ,CAAC,CAAC;AACN,CAAC,EAjDgB,kBAAkB,aAAlB,kBAAkB,GAAlB,kBAAkB,QAiDlC"}

package/lib/validators/TextPlainValidator.d.ts

@@ -1,5 +1,24 @@
 import { MetadataSchema } from "../internal/legacy";
+/**
+ * Validates that a type can be a `text/plain` body or response.
+ *
+ * @evidence contracts/common.md#principled-implementation A plain text body is a string, so the type may hold only string forms.
+ * @evidence contracts/common.md#clear-and-simple-design One function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The rule follows the content type.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation TextPlainValidator checks the metadata union accepted for a text/plain payload; it owns no native filesystem or executable representation.
+ */
 export declare namespace TextPlainValidator {
+    /**
+     * Returns an error message unless every member of the metadata is a string, a
+     * string constant, a string template, or the native String.
+     *
+     * @evidence contracts/common.md#principled-implementation The number of string forms is counted and compared with the size of the metadata, so any other form makes the counts differ, and an empty type is also refused.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The count is exact and no type is special-cased.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the accepted forms.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation TextPlainValidator.validate checks the metadata union accepted for a text/plain payload; it owns no native filesystem or executable representation.
+     */
     const validate: (props: {
         metadata: MetadataSchema;
     }) => string[];

package/lib/validators/TextPlainValidator.js

@@ -2,8 +2,27 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TextPlainValidator = void 0;
 const legacy_1 = require("../internal/legacy");
+/**
+ * Validates that a type can be a `text/plain` body or response.
+ *
+ * @evidence contracts/common.md#principled-implementation A plain text body is a string, so the type may hold only string forms.
+ * @evidence contracts/common.md#clear-and-simple-design One function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The rule follows the content type.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation TextPlainValidator checks the metadata union accepted for a text/plain payload; it owns no native filesystem or executable representation.
+ */
 var TextPlainValidator;
 (function (TextPlainValidator) {
+    /**
+     * Returns an error message unless every member of the metadata is a string, a
+     * string constant, a string template, or the native String.
+     *
+     * @evidence contracts/common.md#principled-implementation The number of string forms is counted and compared with the size of the metadata, so any other form makes the counts differ, and an empty type is also refused.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The count is exact and no type is special-cased.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the accepted forms.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation TextPlainValidator.validate checks the metadata union accepted for a text/plain payload; it owns no native filesystem or executable representation.
+     */
     TextPlainValidator.validate = (props) => {
         const expected = props.metadata.atomics.filter((a) => a.type === "string").length +
             props.metadata.constants

package/lib/validators/TextPlainValidator.js.map

@@ -1 +1 @@
-{"version":3,"file":"TextPlainValidator.js","sourceRoot":"","sources":["../../src/validators/TextPlainValidator.ts"],"names":[],"mappings":";;;AAAA,+CAA4D;AAE5D,IAAiB,kBAAkB,CAclC;AAdD,WAAiB,kBAAkB;IACpB,2BAAQ,GAAG,CAAC,KAAmC,EAAY,EAAE;QACxE,MAAM,QAAQ,GACZ,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,MAAM;YAChE,KAAK,CAAC,QAAQ,CAAC,SAAS;iBACrB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;iBAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;iBAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7B,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM;YAC/B,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;QACnE,IAAI,IAAA,eAAM,EAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAA,eAAM,EAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,QAAQ;YACrE,OAAO,CAAC,+DAA+D,CAAC,CAAC;QAC3E,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;AACJ,CAAC,EAdgB,kBAAkB,aAAlB,kBAAkB,GAAlB,kBAAkB,QAclC"}
+{"version":3,"file":"TextPlainValidator.js","sourceRoot":"","sources":["../../src/validators/TextPlainValidator.ts"],"names":[],"mappings":";;;AAAA,+CAA4D;AAE5D;;;;;;;;GAQG;AACH,IAAiB,kBAAkB,CAwBlC;AAxBD,WAAiB,kBAAkB;IACjC;;;;;;;;;OASG;IACU,2BAAQ,GAAG,CAAC,KAAmC,EAAY,EAAE;QACxE,MAAM,QAAQ,GACZ,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,MAAM;YAChE,KAAK,CAAC,QAAQ,CAAC,SAAS;iBACrB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;iBAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;iBAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7B,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM;YAC/B,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;QACnE,IAAI,IAAA,eAAM,EAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAA,eAAM,EAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,QAAQ;YACrE,OAAO,CAAC,+DAA+D,CAAC,CAAC;QAC3E,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;AACJ,CAAC,EAxBgB,kBAAkB,aAAlB,kBAAkB,GAAlB,kBAAkB,QAwBlC"}

package/native/go.mod

@@ -9,7 +9,7 @@ require (
 	github.com/microsoft/typescript-go/shim/scanner v0.0.0
 	github.com/samchon/nestia/packages/core/native v0.0.0
 	github.com/samchon/ttsc/packages/ttsc v0.0.0
-	github.com/samchon/typia/packages/typia/native v0.0.0-20260922081121-78124b0523b4
+	github.com/samchon/typia/packages/typia/native v0.0.0-20260926142025-755176823ba3
 )
 
 require (

package/native/go.sum

@@ -38,8 +38,8 @@ github.com/samchon/ttsc/packages/ttsc/shim/vfs/cachedvfs v0.0.0-20260820075544-3
 github.com/samchon/ttsc/packages/ttsc/shim/vfs/cachedvfs v0.0.0-20260820075544-3fe6b732f888/go.mod h1:XS3LhXkn5xadyRe3tW+9+suW/7gh7dPdL43Q+s/lUDo=
 github.com/samchon/ttsc/packages/ttsc/shim/vfs/osvfs v0.0.0-20260820075544-3fe6b732f888 h1:ihiKD2OhuYc7Dngxw3uFYbVoiA/xuPwwQoUakB59E40=
 github.com/samchon/ttsc/packages/ttsc/shim/vfs/osvfs v0.0.0-20260820075544-3fe6b732f888/go.mod h1:otX+qw8aZLNCoBmCwMAn53Nw0RQTPzSoId3DxmE67So=
-github.com/samchon/typia/packages/typia/native v0.0.0-20260922081121-78124b0523b4 h1:ZL20GliY1kZk/PYHwJX+n5cp8ljx8YToGP1wWFtaOYs=
-github.com/samchon/typia/packages/typia/native v0.0.0-20260922081121-78124b0523b4/go.mod h1:pUTSG5IZxw8Hohle//RsDXnE+8ZhAus7mPDKFqzvZnk=
+github.com/samchon/typia/packages/typia/native v0.0.0-20260926142025-755176823ba3 h1:XtRIf6wvDuSHLsphMXiB3lm6p0/2sxHMfc6FMjI5LLA=
+github.com/samchon/typia/packages/typia/native v0.0.0-20260926142025-755176823ba3/go.mod h1:pUTSG5IZxw8Hohle//RsDXnE+8ZhAus7mPDKFqzvZnk=
 github.com/zeebo/assert v1.3.0 h1:g7C04CbJuIDKNPFHmsk4hwZDO5O+kntRxzaUoNXj+IQ=
 github.com/zeebo/assert v1.3.0/go.mod h1:Pq9JiuJQpG8JLJdtkwrJESF0Foym2/D9XMU5ciN/wJ0=
 github.com/zeebo/xxh3 v1.1.0 h1:s7DLGDK45Dyfg7++yxI0khrfwq9661w9EN78eP/UZVs=

package/native/sdk/register.go

@@ -90,6 +90,15 @@ func (linkedPlugin) ApplyProgram(prog *driver.Program, _ driver.PluginContext) e
 // alongside the typia and core transforms, exactly as the typia build command
 // wires `nativetransform.Transform`. A site-collection failure is returned as
 // diagnostics; the returned transform is nil when there are no sites.
+//
+// @evidence contracts/common.md#principled-implementation Decorated class-method sites are collected once for the program, and the returned transform maps each original method to its synthetic counterpart so the decorator lands on the printed node; collection failures return diagnostics and no sites return nil. Private reflection helpers use TypeReference/TypeQuery roles and checker aliases for authored imports, declaration sources for free types, and IsLibFile for actual libraries; locally bound TypeParameter symbols have no module import identity. Async aliases use the checker-resolved payload and TypeToTypeNode to apply generic defaults and substitutions after shared declaration-based Promise/Observable classification; type operators retain valid source or projected syntax and parenthesized operands preserve generic arguments. Only fixed language keywords are excluded by spelling. Readonly array and tuple schema markers follow actual checker numeric-index immutability and tuple target flags; substituted object properties, ordered schema dictionaries, nested and inferred types retain those facts without classifying authored alias names. Metadata nulls use the explicit upstream JSON null marker, so authored strings remain strings without encoded-text substitution. The shared private tag serializer omits a schema member when upstream analysis supplies nil for an absent or undefined optional schema, while preserving explicit empty objects and null instance leaves inside populated schema objects.
+// @evidence contracts/common.md#clear-and-simple-design Site collection and one per-file closure share file grouping and the module specifier. Private import reflection centralizes reference traversal, authored binding selection and declaration fallback so the reflected type forms use one policy. Checker-generated alias payload nodes carry identifier symbols separately because they have no authored source span; the public printer supplies their text. All raw tag matrices share one serialization boundary, keeping optional tag representation separate from JSON Schema baking.
+// @evidence contracts/common.md#prohibited-implementation-shortcuts The shared module specifier binds one generated alias without controller special cases. Import decisions use semantic AST roles, checker bindings and actual library identity rather than regex matches in literals, built-in-name whitelists or fixture/path spelling. Alias projection uses the supported checker and printer APIs without reparsing or mutating foreign behavior. Optional-schema omission depends on the analyzed nil value, never tag names, fixture paths or a TypeScript-writer compensation; invalid top-level null and scalar schemas remain upstream analyzer errors.
+// @evidence contracts/common.md#meaningful-documentation The public comment explains injected metadata, original-to-synthetic mapping and nil/diagnostic results. Private helper comments explain reference roles, shadowable library names, declaration fallback, annotation-local binders, checker projection and type-operator syntax; these details remain documented at their implementation owners. The private tag serializer explains why absence cannot become JSON null and why empty objects and nested null content stay intact.
+// @evidence contracts/portability.md#os-neutral-implementation File grouping converts both collected paths and emitted source names through filepath.ToSlash; it preserves the compiler's filename identity without guessing volume case policy. The contributor receives an existing compiler program and launches no shell. Declaration-package ownership uses the shared SourceFilePackageName ancestor walk through that program's filesystem, retaining its overlay observations and native filepath operations.
+// @evidence contracts/performance.md#efficient-algorithms Site analysis visits the program once; grouping costs O(S) for S sites plus filename lengths. Each participating emitted file is traversed once to index original method identities, followed by O(Sf) injections for its sites. The method index avoids a separate AST traversal for every route.
+// @evidence contracts/performance.md#reuse-equivalent-work The returned closure shares the collected metadata and file grouping across file emissions of this program. A new EmitTransform invocation recollects against its supplied program; these AST identities cannot safely be reused for another compilation.
+// @evidence contracts/performance.md#bound-retention-and-release-resources The closure retains the site's AST nodes and metadata strings for its compiler emission lifetime. Each per-file method index becomes unreachable after that file returns; there are no process-global program caches, file handles or background tasks in this operation.
 func EmitTransform(prog *driver.Program) (driver.PluginTransform, []transform.Diagnostic) {
 	sites, diagnostics := collectNestiaSDKSites(prog)
 	if len(diagnostics) > 0 {
@@ -181,8 +190,9 @@ func synthesized(node *shimast.Node) *shimast.Node {
 
 // injectOperationMetadataDecorator prepends a synthesized
 // `@__OperationMetadata.OperationMetadata("<json>")` decorator to a controller
-// method. Every site is a method that already carries `@nestia/core`
-// decorators, so its modifier list is non-nil and can be mutated in place.
+// method. Site collection visits decorated class methods, including methods
+// outside Nest controllers; their existing modifier lists carry the decorators
+// and can be extended in place. Runtime controller analysis selects routes.
 func injectOperationMetadataDecorator(
 	factory *shimast.NodeFactory,
 	method *shimast.Node,

package/native/sdk/sdk_metadata_json.go

@@ -284,7 +284,12 @@ func nestiaSDKMetadataTypeTag(tag schemametadata.IMetadataTypeTag) map[string]an
 		"kind":      tag.Kind,
 		"exclusive": tag.Exclusive,
 		"value":     value,
-		"schema":    tag.Schema,
+	}
+	// TagBase's optional schema is absent when the analyzer supplies nil.
+	// An explicit empty object and null leaves inside an actual schema object
+	// remain intact; writing an absent schema as null creates an invalid tag.
+	if tag.Schema != nil {
+		output["schema"] = tag.Schema
 	}
 	// A tag's target is the type it tags, not its value's: `tags.Sequence<1>`
 	// on a bigint holds a number, `tags.Example<"Infinity">` on a number a