@nestia/migrate 14.0.1 → 14.0.2

package/lib/programmers/NestiaMigrateApiProgrammer.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaMigrateApiProgrammer.js","sourceRoot":"","sources":["../../src/programmers/NestiaMigrateApiProgrammer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NestiaMigrateApiProgrammer.js","sourceRoot":"","sources":["../../src/programmers/NestiaMigrateApiProgrammer.ts"],"names":[],"mappings":";;;AAAA,2CAA+D;AAC/D,+BAAqC;AAIrC,sDAAmD;AACnD,qFAAkF;AAClF,6EAA0E;AAC1E,mFAAgF;AAEhF;;;;;;;;GAQG;AACH,IAAiB,0BAA0B,CAiH1C;AAjHD,WAAiB,0BAA0B;IACzC;;;;;;;;OAQG;IACU,gCAAK,GAAG,CAAC,GAA0B,EAA0B,EAAE;QAC1E,MAAM,IAAI,GACR,IAAI,cAAO,CACT,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,WAAI,EAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EACxB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAC/D,CAAC;QACJ,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YACnB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,UAAU,EAAE,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,UAAU;YACjD,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,IAAI,GAAG,EAAE;SACpB,CAAC,CAAC,CAAC;QACJ,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAa,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACxD,IAAI,IAAI,GAA0C,IAAI,CAAC,IAAI,CACzD,SAAS,EACT,GAAG,EAAE,CAAC,CAAC;gBACL,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,UAAU,EAAE,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,UAAU;gBACjD,SAAS;gBACT,MAAM,EAAE,EAAE;gBACV,QAAQ,EAAE,IAAI,GAAG,EAAE;aACpB,CAAC,CACH,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxB,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE;gBACjC,MAAM,OAAO,GAAa,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;gBACnE,MAAM,KAAK,GAA0C,IAAI,CAAC,IAAI,CAC5D,OAAO,EACP,GAAG,EAAE,CAAC,CAAC;oBACL,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,UAAU,EAAE,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,UAAU;oBACjD,SAAS,EAAE,OAAO;oBAClB,QAAQ,EAAE,IAAI,GAAG,EAAE;oBACnB,MAAM,EAAE,EAAE;iBACX,CAAC,CACH,CAAC;gBACF,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;gBAC3C,IAAI,GAAG,KAAK,CAAC;YACf,CAAC,CAAC,CAAC;QACL,CAAC;QAED,cAAc;QACd,MAAM,KAAK,GAA2B,MAAM,CAAC,WAAW,CACtD,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACvC,GAAG,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,eAAe,CAAC,GAAG,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YAC9G,yBAAW,CAAC,KAAK,CAAC;gBAChB,UAAU,EAAE,+DAA8B,CAAC,KAAK,iCAC3C,KAAK,KACR,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,UAAU,EAAE,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,UAAU,IACjD;aACH,CAAC;SACH,CAAC,CACH,CAAC;QACF,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK;YACpB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,uDAA0B,CAAC,OAAO,CAAC;gBAC5D,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,UAAU,EAAE,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,UAAU;aAClD,CAAC,CAAC,OAAO,EAAE;gBACV,KAAK,CAAC,kBAAkB,GAAG,KAAK,CAAC,GAAG,yBAAW,CAAC,KAAK,CAAC;oBACpD,UAAU,EAAE,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC;iBACrC,CAAC,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,CACnB,GAAW,EACX,MAA0C,EAC1B,EAAE;QAClB,MAAM,QAAQ,GAAG,IAAI,6DAA6B,EAAE,CAAC;QACrD,MAAM,UAAU,GAAmB,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACvC,OAAO;YACL,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC;YACpD,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,yBAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,GAAG,UAAU;SACd,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,CACd,QAAuC,EACvC,MAA0C,EAC1B,EAAE;QAClB,MAAM,MAAM,GAAmB,EAAE,CAAC;QAClC,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;YAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzE,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAmB,EAAE,CAAC;YACpC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;gBAC1C,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;YAC7C,MAAM,CAAC,IAAI,CACT,iBAAO,CAAC,uBAAuB,CAC7B,CAAC,iBAAO,CAAC,cAAc,CAAC,oBAAU,CAAC,aAAa,CAAC,CAAC,EAClD,iBAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,EACrC,iBAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EACnC,mBAAS,CAAC,SAAS,CACpB,CACF,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,yBAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC,EAjHgB,0BAA0B,aAA1B,0BAA0B,GAA1B,0BAA0B,QAiH1C"}

package/lib/programmers/NestiaMigrateApiProgrammer.mjs

@@ -2,8 +2,8 @@ import { FilePrinter } from "../utils/FilePrinter.mjs";
 import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer.mjs";
 import { NestiaMigrateApiFileProgrammer } from "./NestiaMigrateApiFileProgrammer.mjs";
 import { NestiaMigrateDtoProgrammer } from "./NestiaMigrateDtoProgrammer.mjs";
-import { NodeFlags, SyntaxKind, factory } from "@ttsc/factory";
 import { HashMap, hash } from "tstl";
+import { NodeFlags, SyntaxKind, factory } from "@ttsc/factory";
 //#region src/programmers/NestiaMigrateApiProgrammer.ts
 let NestiaMigrateApiProgrammer;
 (function(_NestiaMigrateApiProgrammer) {

package/lib/programmers/NestiaMigrateApiSimulationProgrammer.d.ts

@@ -3,13 +3,53 @@ import { OpenApi } from "typia";
 import ts from "../internal/ts";
 import { INestiaMigrateConfig } from "../structures/INestiaMigrateConfig";
 import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer";
+/**
+ * Generates the mockup simulator members of a route: a random response and a
+ * simulate function that validates the request first.
+ *
+ * @evidence contracts/common.md#principled-implementation The random member calls `typia.random` for the response type, and the simulate function validates the parameters, query, body, and headers with `typia.assert` through the fetcher's simulator, so an invalid simulated request throws the error the real server answers.
+ * @evidence contracts/common.md#clear-and-simple-design Two public functions and one private assertion writer.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The simulation follows the schemas of the route.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 export declare namespace NestiaMigrateApiSimulationProgrammer {
+    /**
+     * The input of the simulation members: the configuration, the components, the
+     * importer, and the route.
+     *
+     * @evidence contracts/common.md#principled-implementation The record holds exactly what the generation needs.
+     * @evidence contracts/common.md#clear-and-simple-design A flat record.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a type and adds no runtime behavior.
+     * @evidence contracts/common.md#meaningful-documentation The comment lists the fields.
+     */
     interface IContext {
+        /** Calling convention and optional generated features for this operation. */
         config: INestiaMigrateConfig;
+        /** Component schemas used to resolve DTO references. */
         components: OpenApi.IComponents;
+        /** File-local import collector shared with the surrounding file writer. */
         importer: NestiaMigrateImportProgrammer;
+        /** Analyzed operation, with the accessor chosen for this generation. */
         route: IHttpMigrateRoute;
     }
+    /**
+     * Returns the `random` constant: a function that returns a random value of
+     * the response type.
+     *
+     * @evidence contracts/common.md#principled-implementation The response schema is written as a type and given to `typia.random`, and a route without a response uses `void`.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The value is produced by typia at run time.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     const random: (ctx: IContext) => import("@ttsc/factory").VariableStatement;
+    /**
+     * Returns the `simulate` constant: a function with the route's parameters
+     * that validates the request and returns a random response.
+     *
+     * @evidence contracts/common.md#principled-implementation The parameters are those of the real function, the assertions run first, and an unused connection is renamed so the compiler does not report it.
+     * @evidence contracts/common.md#clear-and-simple-design One expression over the shared parameter builder.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The validation is generated from the same schemas as the real function's types.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     const simulate: (ctx: IContext) => ts.VariableStatement;
 }

package/lib/programmers/NestiaMigrateApiSimulationProgrammer.js

@@ -8,8 +8,26 @@ const TypeFactory_1 = require("../factories/TypeFactory");
 const NestiaMigrateApiFunctionProgrammer_1 = require("./NestiaMigrateApiFunctionProgrammer");
 const NestiaMigrateApiNamespaceProgrammer_1 = require("./NestiaMigrateApiNamespaceProgrammer");
 const NestiaMigrateSchemaProgrammer_1 = require("./NestiaMigrateSchemaProgrammer");
+/**
+ * Generates the mockup simulator members of a route: a random response and a
+ * simulate function that validates the request first.
+ *
+ * @evidence contracts/common.md#principled-implementation The random member calls `typia.random` for the response type, and the simulate function validates the parameters, query, body, and headers with `typia.assert` through the fetcher's simulator, so an invalid simulated request throws the error the real server answers.
+ * @evidence contracts/common.md#clear-and-simple-design Two public functions and one private assertion writer.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The simulation follows the schemas of the route.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 var NestiaMigrateApiSimulationProgrammer;
 (function (NestiaMigrateApiSimulationProgrammer) {
+    /**
+     * Returns the `random` constant: a function that returns a random value of
+     * the response type.
+     *
+     * @evidence contracts/common.md#principled-implementation The response schema is written as a type and given to `typia.random`, and a route without a response uses `void`.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The value is produced by typia at run time.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     NestiaMigrateApiSimulationProgrammer.random = (ctx) => {
         const output = ctx.route.success
             ? NestiaMigrateSchemaProgrammer_1.NestiaMigrateSchemaProgrammer.write({
@@ -24,6 +42,15 @@ var NestiaMigrateApiSimulationProgrammer;
             name: "typia",
         })), "random"), [output], undefined)));
     };
+    /**
+     * Returns the `simulate` constant: a function with the route's parameters
+     * that validates the request and returns a random response.
+     *
+     * @evidence contracts/common.md#principled-implementation The parameters are those of the real function, the assertions run first, and an unused connection is renamed so the compiler does not report it.
+     * @evidence contracts/common.md#clear-and-simple-design One expression over the shared parameter builder.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The validation is generated from the same schemas as the real function's types.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     NestiaMigrateApiSimulationProgrammer.simulate = (ctx) => {
         const caller = () => factory_1.factory.createCallExpression(factory_1.factory.createIdentifier("random"), undefined, undefined);
         return constant("simulate", factory_1.factory.createArrowFunction(undefined, undefined, NestiaMigrateApiFunctionProgrammer_1.NestiaMigrateApiFunctionProgrammer.writeParameterDeclarations(ctx, ctx.route.parameters.length === 0 &&

package/lib/programmers/NestiaMigrateApiSimulationProgrammer.js.map

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

package/lib/programmers/NestiaMigrateApiStartProgrammer.d.ts

@@ -1,4 +1,21 @@
 import { INestiaMigrateContext } from "../structures/INestiaMigrateContext";
+/**
+ * Generates the `test/start.ts` of an SDK project: a small program that calls
+ * one API function.
+ *
+ * @evidence contracts/common.md#principled-implementation The program builds a connection from the global test settings and the first server of the document, adds the simulate flag when requested, and calls the first route the way the generated e2e tests do, so one command can check that the SDK and a server agree.
+ * @evidence contracts/common.md#clear-and-simple-design One entry function and private helpers for the connection, the main function, and the starter.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The route is the first one, so the same document always generates the same file.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 export declare namespace NestiaMigrateApiStartProgrammer {
+    /**
+     * Returns the `test/start.ts` file of an SDK project.
+     *
+     * @evidence contracts/common.md#principled-implementation The file imports what the body uses, defines `main`, and starts it, exiting with a failure status when it rejects.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The content derives from the document.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     const write: (context: INestiaMigrateContext) => Record<string, string>;
 }

package/lib/programmers/NestiaMigrateApiStartProgrammer.js

@@ -7,11 +7,29 @@ const StatementFactory_1 = require("../factories/StatementFactory");
 const FilePrinter_1 = require("../utils/FilePrinter");
 const NestiaMigrateE2eFileProgrammer_1 = require("./NestiaMigrateE2eFileProgrammer");
 const NestiaMigrateImportProgrammer_1 = require("./NestiaMigrateImportProgrammer");
+/**
+ * Generates the `test/start.ts` of an SDK project: a small program that calls
+ * one API function.
+ *
+ * @evidence contracts/common.md#principled-implementation The program builds a connection from the global test settings and the first server of the document, adds the simulate flag when requested, and calls the first route the way the generated e2e tests do, so one command can check that the SDK and a server agree.
+ * @evidence contracts/common.md#clear-and-simple-design One entry function and private helpers for the connection, the main function, and the starter.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The route is the first one, so the same document always generates the same file.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 var NestiaMigrateApiStartProgrammer;
 (function (NestiaMigrateApiStartProgrammer) {
+    /**
+     * Returns the `test/start.ts` file of an SDK project.
+     *
+     * @evidence contracts/common.md#principled-implementation The file imports what the body uses, defines `main`, and starts it, exiting with a failure status when it rejects.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The content derives from the document.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     NestiaMigrateApiStartProgrammer.write = (context) => {
         const importer = new NestiaMigrateImportProgrammer_1.NestiaMigrateImportProgrammer();
-        const route = pick(context.application.routes);
+        // the first route, so the same document always generates the same file
+        const route = context.application.routes[0];
         const main = writeMain(context, importer, route);
         const statements = [
             ...importer.toStatements((name) => `@ORGANIZATION/PROJECT-api/lib/structures/${name}`),
@@ -75,11 +93,4 @@ var NestiaMigrateApiStartProgrammer;
         ], true)),
     ]);
 })(NestiaMigrateApiStartProgrammer || (exports.NestiaMigrateApiStartProgrammer = NestiaMigrateApiStartProgrammer = {}));
-const pick = (array) => {
-    if (array.length === 0)
-        return undefined;
-    const rand = Math.random() * array.length;
-    const index = Math.min(array.length - 1, Math.floor(rand));
-    return array[index];
-};
 //# sourceMappingURL=NestiaMigrateApiStartProgrammer.js.map

package/lib/programmers/NestiaMigrateApiStartProgrammer.js.map

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

package/lib/programmers/NestiaMigrateApiStartProgrammer.mjs

@@ -9,7 +9,7 @@ let NestiaMigrateApiStartProgrammer;
 (function(_NestiaMigrateApiStartProgrammer) {
 	_NestiaMigrateApiStartProgrammer.write = (context) => {
 		const importer = new NestiaMigrateImportProgrammer();
-		const route = pick(context.application.routes);
+		const route = context.application.routes[0];
 		const main = writeMain(context, importer, route);
 		const statements = [
 			...importer.toStatements((name) => `@ORGANIZATION/PROJECT-api/lib/structures/${name}`),
@@ -40,11 +40,6 @@ let NestiaMigrateApiStartProgrammer;
 	], true))], NodeFlags.Const));
 	const writeStarter = () => factory.createCallExpression(factory.createPropertyAccessExpression(factory.createCallExpression(factory.createIdentifier("main"), void 0, void 0), "catch"), void 0, [factory.createArrowFunction(void 0, void 0, [IdentifierFactory.parameter("exp")], void 0, void 0, factory.createBlock([factory.createExpressionStatement(factory.createCallExpression(factory.createPropertyAccessExpression(factory.createIdentifier("console"), "log"), void 0, [factory.createIdentifier("exp")])), factory.createExpressionStatement(factory.createCallExpression(factory.createPropertyAccessExpression(factory.createIdentifier("process"), "exit"), void 0, [factory.createPrefixMinus(factory.createNumericLiteral("1"))]))], true))]);
 })(NestiaMigrateApiStartProgrammer || (NestiaMigrateApiStartProgrammer = {}));
-const pick = (array) => {
-	if (array.length === 0) return void 0;
-	const rand = Math.random() * array.length;
-	return array[Math.min(array.length - 1, Math.floor(rand))];
-};
 //#endregion
 export { NestiaMigrateApiStartProgrammer };
 

package/lib/programmers/NestiaMigrateDtoProgrammer.d.ts

@@ -2,14 +2,44 @@ import { OpenApi } from "@typia/interface";
 import ts from "../internal/ts";
 import { INestiaMigrateConfig } from "../structures/INestiaMigrateConfig";
 import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer";
+/**
+ * Generates the DTO type aliases from the component schemas.
+ *
+ * @evidence contracts/common.md#principled-implementation Each component name is normalized into a valid dotted name, the dots become nested namespaces, and each schema becomes an exported type alias with its description and its tags as a comment.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and private builders for the module tree and the alias.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The names derive from the schema names.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 export declare namespace NestiaMigrateDtoProgrammer {
+    /**
+     * A node of the DTO namespace tree: its name, its children, and the writer of
+     * its alias, or `null` for a namespace without a type of its own.
+     *
+     * @evidence contracts/common.md#principled-implementation The tree mirrors the dotted names of the schemas, so a namespace exists exactly when a name passes through it.
+     * @evidence contracts/common.md#clear-and-simple-design A three-member record.
+     * @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 the meaning of each member.
+     */
     interface IModule {
         name: string;
+        /** Child segments of qualified schema names, preserving insertion order. */
         children: Map<string, IModule>;
+        /** Alias writer for a schema at this node, or null for a namespace alone. */
         programmer: null | ((importer: NestiaMigrateImportProgrammer) => ts.TypeAliasDeclaration);
     }
+    /**
+     * Returns the root of the DTO tree: a map from the first name segment to its
+     * module.
+     *
+     * @evidence contracts/common.md#principled-implementation Each schema key is split on slashes, its segments are escaped into valid identifiers and joined, and the result is inserted along its dotted path.
+     * @evidence contracts/common.md#clear-and-simple-design One function over one insertion helper.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The names come from the document.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     const compose: (props: {
+        /** Calling convention and optional generated features for this operation. */
         config: INestiaMigrateConfig;
+        /** Component schemas used to resolve DTO references. */
         components: OpenApi.IComponents;
     }) => Map<string, IModule>;
 }

package/lib/programmers/NestiaMigrateDtoProgrammer.js

@@ -6,8 +6,25 @@ const FilePrinter_1 = require("../utils/FilePrinter");
 const MapUtil_1 = require("../utils/MapUtil");
 const StringUtil_1 = require("../utils/StringUtil");
 const NestiaMigrateSchemaProgrammer_1 = require("./NestiaMigrateSchemaProgrammer");
+/**
+ * Generates the DTO type aliases from the component schemas.
+ *
+ * @evidence contracts/common.md#principled-implementation Each component name is normalized into a valid dotted name, the dots become nested namespaces, and each schema becomes an exported type alias with its description and its tags as a comment.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and private builders for the module tree and the alias.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The names derive from the schema names.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 var NestiaMigrateDtoProgrammer;
 (function (NestiaMigrateDtoProgrammer) {
+    /**
+     * Returns the root of the DTO tree: a map from the first name segment to its
+     * module.
+     *
+     * @evidence contracts/common.md#principled-implementation Each schema key is split on slashes, its segments are escaped into valid identifiers and joined, and the result is inserted along its dotted path.
+     * @evidence contracts/common.md#clear-and-simple-design One function over one insertion helper.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The names come from the document.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     NestiaMigrateDtoProgrammer.compose = (props) => {
         var _a;
         const dict = new Map();

package/lib/programmers/NestiaMigrateDtoProgrammer.js.map

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

package/lib/programmers/NestiaMigrateE2eFileProgrammer.d.ts

@@ -3,13 +3,52 @@ import { OpenApi } from "typia";
 import ts from "../internal/ts";
 import { INestiaMigrateConfig } from "../structures/INestiaMigrateConfig";
 import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer";
+/**
+ * Generates the e2e test function of one route.
+ *
+ * @evidence contracts/common.md#principled-implementation The function calls the route through the SDK with random arguments made by `typia.random`, including generated headers, and asserts the response with `typia.assert`, so the test checks that the server's answer matches the declared type.
+ * @evidence contracts/common.md#clear-and-simple-design One entry function, one public body writer shared with the start programmer, and a private call writer.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The arguments are drawn at run time, and no route is special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 export declare namespace NestiaMigrateE2eFunctionProgrammer {
+    /**
+     * The input of one test function: the configuration, the components, the
+     * importer, and the route.
+     *
+     * @evidence contracts/common.md#principled-implementation The record holds exactly what the generation needs.
+     * @evidence contracts/common.md#clear-and-simple-design A flat record.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a type and adds no runtime behavior.
+     * @evidence contracts/common.md#meaningful-documentation The comment lists the fields.
+     */
     interface IContext {
+        /** Calling convention and optional generated features for this operation. */
         config: INestiaMigrateConfig;
+        /** Component schemas used to resolve DTO references. */
         components: OpenApi.IComponents;
+        /** File-local import collector shared with the surrounding file writer. */
         importer: NestiaMigrateImportProgrammer;
+        /** Analyzed operation, with the accessor chosen for this generation. */
         route: IHttpMigrateRoute;
     }
+    /**
+     * Returns the exported async test function of a route, named `test_api_`
+     * followed by its accessor.
+     *
+     * @evidence contracts/common.md#principled-implementation The name joins `test`, `api`, and the accessor with underscores, so it is unique for a route and matches the prefix that the e2e executor discovers.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The name derives from the accessor.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the naming rule.
+     */
     const write: (ctx: IContext) => ts.FunctionDeclaration;
+    /**
+     * Returns the statements of the test body: the call with random arguments and
+     * the type assertion of its output.
+     *
+     * @evidence contracts/common.md#principled-implementation The call expression follows the parameter mode of the configuration, and the output is typed by the response schema when there is one.
+     * @evidence contracts/common.md#clear-and-simple-design One function shared with the start programmer.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The body follows the route.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     const writeBody: (ctx: IContext) => ts.Statement[];
 }

package/lib/programmers/NestiaMigrateE2eFileProgrammer.js

@@ -5,8 +5,25 @@ const factory_1 = require("@ttsc/factory");
 const IdentifierFactory_1 = require("../factories/IdentifierFactory");
 const LiteralFactory_1 = require("../factories/LiteralFactory");
 const NestiaMigrateSchemaProgrammer_1 = require("./NestiaMigrateSchemaProgrammer");
+/**
+ * Generates the e2e test function of one route.
+ *
+ * @evidence contracts/common.md#principled-implementation The function calls the route through the SDK with random arguments made by `typia.random`, including generated headers, and asserts the response with `typia.assert`, so the test checks that the server's answer matches the declared type.
+ * @evidence contracts/common.md#clear-and-simple-design One entry function, one public body writer shared with the start programmer, and a private call writer.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The arguments are drawn at run time, and no route is special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 var NestiaMigrateE2eFunctionProgrammer;
 (function (NestiaMigrateE2eFunctionProgrammer) {
+    /**
+     * Returns the exported async test function of a route, named `test_api_`
+     * followed by its accessor.
+     *
+     * @evidence contracts/common.md#principled-implementation The name joins `test`, `api`, and the accessor with underscores, so it is unique for a route and matches the prefix that the e2e executor discovers.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The name derives from the accessor.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the naming rule.
+     */
     NestiaMigrateE2eFunctionProgrammer.write = (ctx) => factory_1.factory.createFunctionDeclaration([
         factory_1.factory.createModifier(factory_1.SyntaxKind.ExportKeyword),
         factory_1.factory.createModifier(factory_1.SyntaxKind.AsyncKeyword),
@@ -17,6 +34,15 @@ var NestiaMigrateE2eFunctionProgrammer;
             name: "api",
         })), factory_1.factory.createIdentifier("IConnection")))),
     ], undefined, factory_1.factory.createBlock(NestiaMigrateE2eFunctionProgrammer.writeBody(ctx), true));
+    /**
+     * Returns the statements of the test body: the call with random arguments and
+     * the type assertion of its output.
+     *
+     * @evidence contracts/common.md#principled-implementation The call expression follows the parameter mode of the configuration, and the output is typed by the response schema when there is one.
+     * @evidence contracts/common.md#clear-and-simple-design One function shared with the start programmer.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The body follows the route.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     NestiaMigrateE2eFunctionProgrammer.writeBody = (ctx) => [
         factory_1.factory.createVariableStatement([], factory_1.factory.createVariableDeclarationList([
             factory_1.factory.createVariableDeclaration("output", undefined, ctx.route.success

package/lib/programmers/NestiaMigrateE2eFileProgrammer.js.map

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

package/lib/programmers/NestiaMigrateE2eProgrammer.d.ts

@@ -1,4 +1,20 @@
 import { INestiaMigrateContext } from "../structures/INestiaMigrateContext";
+/**
+ * Generates the e2e test files, one per route.
+ *
+ * @evidence contracts/common.md#principled-implementation Each route becomes a file whose path depends on the mode and whose imports are resolved through the package name for a monorepo and through the built library path otherwise.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and one private file writer.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The layout follows the accessors.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 export declare namespace NestiaMigrateE2eProgrammer {
+    /**
+     * Returns the map from file path to content of the e2e tests.
+     *
+     * @evidence contracts/common.md#principled-implementation The file name is `test_api_` plus the accessor, so each route has exactly one file.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The names follow the accessors.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     const write: (ctx: INestiaMigrateContext) => Record<string, string>;
 }

package/lib/programmers/NestiaMigrateE2eProgrammer.js

@@ -4,8 +4,24 @@ exports.NestiaMigrateE2eProgrammer = void 0;
 const FilePrinter_1 = require("../utils/FilePrinter");
 const NestiaMigrateE2eFileProgrammer_1 = require("./NestiaMigrateE2eFileProgrammer");
 const NestiaMigrateImportProgrammer_1 = require("./NestiaMigrateImportProgrammer");
+/**
+ * Generates the e2e test files, one per route.
+ *
+ * @evidence contracts/common.md#principled-implementation Each route becomes a file whose path depends on the mode and whose imports are resolved through the package name for a monorepo and through the built library path otherwise.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and one private file writer.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The layout follows the accessors.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 var NestiaMigrateE2eProgrammer;
 (function (NestiaMigrateE2eProgrammer) {
+    /**
+     * Returns the map from file path to content of the e2e tests.
+     *
+     * @evidence contracts/common.md#principled-implementation The file name is `test_api_` plus the accessor, so each route has exactly one file.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The names follow the accessors.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     NestiaMigrateE2eProgrammer.write = (ctx) => Object.fromEntries(ctx.application.routes
         .map((r) => writeFile(ctx.mode, ctx.config, ctx.application.document().components, r))
         .map((r) => [`${r.location}/${r.file}`, r.content]));

package/lib/programmers/NestiaMigrateE2eProgrammer.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaMigrateE2eProgrammer.js","sourceRoot":"","sources":["../../src/programmers/NestiaMigrateE2eProgrammer.ts"],"names":[],"mappings":";;;AAMA,sDAAmD;AACnD,qFAAsF;AACtF,mFAAgF;AAEhF,IAAiB,0BAA0B,CAmD1C;AAnDD,WAAiB,0BAA0B;IAC5B,gCAAK,GAAG,CAAC,GAA0B,EAA0B,EAAE,CAC1E,MAAM,CAAC,WAAW,CAChB,GAAG,CAAC,WAAW,CAAC,MAAM;SACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,SAAS,CACP,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,UAAU,EACrC,CAAC,CACF,CACF;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CACtD,CAAC;IAEJ,MAAM,SAAS,GAAG,CAChB,IAAmC,EACnC,MAA4B,EAC5B,UAA+B,EAC/B,KAAwB,EACJ,EAAE;QACtB,MAAM,QAAQ,GACZ,IAAI,6DAA6B,EAAE,CAAC;QACtC,MAAM,IAAI,GACR,mEAAkC,CAAC,KAAK,CAAC;YACvC,MAAM;YACN,UAAU;YACV,QAAQ;YACR,KAAK;SACN,CAAC,CAAC;QACL,MAAM,UAAU,GAAmB;YACjC,uEAAuE;YACvE,sEAAsE;YACtE,wDAAwD;YACxD,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE,CAChC,IAAI,KAAK,MAAM;gBACb,CAAC,CAAC,2BAA2B;gBAC7B,CAAC,CAAC,4CAA4C,IAAI,EAAE,CACvD;YACD,yBAAW,CAAC,OAAO,EAAE;YACrB,IAAI;SACL,CAAC;QACF,OAAO;YACL,QAAQ,EACN,IAAI,KAAK,MAAM;gBACb,CAAC,CAAC,oCAAoC;gBACtC,CAAC,CAAC,mBAAmB;YACzB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK;YAC1D,OAAO,EAAE,yBAAW,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;SAC3C,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,EAnDgB,0BAA0B,aAA1B,0BAA0B,GAA1B,0BAA0B,QAmD1C"}
+{"version":3,"file":"NestiaMigrateE2eProgrammer.js","sourceRoot":"","sources":["../../src/programmers/NestiaMigrateE2eProgrammer.ts"],"names":[],"mappings":";;;AAMA,sDAAmD;AACnD,qFAAsF;AACtF,mFAAgF;AAEhF;;;;;;;GAOG;AACH,IAAiB,0BAA0B,CA2D1C;AA3DD,WAAiB,0BAA0B;IACzC;;;;;;;OAOG;IACU,gCAAK,GAAG,CAAC,GAA0B,EAA0B,EAAE,CAC1E,MAAM,CAAC,WAAW,CAChB,GAAG,CAAC,WAAW,CAAC,MAAM;SACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,SAAS,CACP,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,UAAU,EACrC,CAAC,CACF,CACF;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CACtD,CAAC;IAEJ,MAAM,SAAS,GAAG,CAChB,IAAmC,EACnC,MAA4B,EAC5B,UAA+B,EAC/B,KAAwB,EACJ,EAAE;QACtB,MAAM,QAAQ,GACZ,IAAI,6DAA6B,EAAE,CAAC;QACtC,MAAM,IAAI,GACR,mEAAkC,CAAC,KAAK,CAAC;YACvC,MAAM;YACN,UAAU;YACV,QAAQ;YACR,KAAK;SACN,CAAC,CAAC;QACL,MAAM,UAAU,GAAmB;YACjC,uEAAuE;YACvE,sEAAsE;YACtE,wDAAwD;YACxD,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE,CAChC,IAAI,KAAK,MAAM;gBACb,CAAC,CAAC,2BAA2B;gBAC7B,CAAC,CAAC,4CAA4C,IAAI,EAAE,CACvD;YACD,yBAAW,CAAC,OAAO,EAAE;YACrB,IAAI;SACL,CAAC;QACF,OAAO;YACL,QAAQ,EACN,IAAI,KAAK,MAAM;gBACb,CAAC,CAAC,oCAAoC;gBACtC,CAAC,CAAC,mBAAmB;YACzB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK;YAC1D,OAAO,EAAE,yBAAW,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;SAC3C,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,EA3DgB,0BAA0B,aAA1B,0BAA0B,GAA1B,0BAA0B,QA2D1C"}