@nestia/migrate 14.0.0 → 14.0.2

package/lib/programmers/NestiaMigrateImportProgrammer.mjs

@@ -3,14 +3,42 @@ import { TypeLiteralFactory } from "../factories/TypeLiteralFactory.mjs";
 import { MapUtil } from "../utils/MapUtil.mjs";
 import { SyntaxKind, factory } from "@ttsc/factory";
 //#region src/programmers/NestiaMigrateImportProgrammer.ts
+/**
+* Collects the imports that generated code needs and turns them into import
+* statements.
+*
+* @evidence contracts/common.md#principled-implementation External imports are grouped by library into one clause with an optional default and a set of named instances, DTO imports are grouped by module specifier and emitted type-only, and a DTO is never imported into its own file.
+* @evidence contracts/common.md#clear-and-simple-design One class with two collections and one emitter; the tag helper builds `typia.tags` references.
+* @evidence contracts/common.md#prohibited-implementation-shortcuts The imports follow the code that asks for them.
+* @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+*/
 var NestiaMigrateImportProgrammer = class {
 	constructor() {
 		this.external_ = /* @__PURE__ */ new Map();
 		this.dtos_ = /* @__PURE__ */ new Set();
 	}
+	/**
+	* Reports whether no import has been requested.
+	*
+	* @evidence contracts/common.md#principled-implementation The importer is empty exactly when both collections are empty.
+	* @evidence contracts/common.md#clear-and-simple-design One expression.
+	* @evidence contracts/common.md#prohibited-implementation-shortcuts It reads the state.
+	* @evidence contracts/common.md#meaningful-documentation The comment states the meaning.
+	*/
 	empty() {
 		return this.external_.size === 0 && this.dtos_.size === 0;
 	}
+	/**
+	* Requests an import from a library and returns the local name to use.
+	*
+	* The returned name is the first segment of the requested name, so a nested
+	* name such as `tags.Type` imports `tags`.
+	*
+	* @evidence contracts/common.md#principled-implementation A default import replaces the clause's default and an instance import adds a named import, and the first segment of a dotted name is what the code refers to.
+	* @evidence contracts/common.md#clear-and-simple-design One function over one map.
+	* @evidence contracts/common.md#prohibited-implementation-shortcuts The library and the name come from the caller.
+	* @evidence contracts/common.md#meaningful-documentation The comment states the returned name.
+	*/
 	external(props) {
 		const clause = MapUtil.take(this.external_)(props.library)(() => ({
 			default: null,
@@ -21,11 +49,29 @@ var NestiaMigrateImportProgrammer = class {
 		else clause.instances.add(name);
 		return name;
 	}
+	/**
+	* Requests a DTO import and returns a reference to it, qualified by a
+	* namespace when one is given.
+	*
+	* @evidence contracts/common.md#principled-implementation The DTO is recorded by the first segment of its dotted name, which is the file that exports it, and the returned reference keeps the full name, with the namespace prepended when one is given.
+	* @evidence contracts/common.md#clear-and-simple-design One function over one set.
+	* @evidence contracts/common.md#prohibited-implementation-shortcuts The name comes from the caller.
+	* @evidence contracts/common.md#meaningful-documentation The comment states the reference.
+	*/
 	dto(name, namespace) {
-		const file = name.split(".")[0];
-		this.dtos_.add(file);
-		return factory.createTypeReferenceNode(namespace?.length ? factory.createQualifiedName(factory.createIdentifier(namespace), factory.createIdentifier(file)) : name);
+		const segments = name.split(".");
+		this.dtos_.add(segments[0]);
+		return factory.createTypeReferenceNode(namespace?.length ? segments.reduce((left, segment) => factory.createQualifiedName(left, factory.createIdentifier(segment)), factory.createIdentifier(namespace)) : name);
 	}
+	/**
+	* Requests the `typia` tags import and returns a reference to a tag with an
+	* optional literal argument.
+	*
+	* @evidence contracts/common.md#principled-implementation The argument is converted to a literal type, so `Minimum<3>` is written as a type reference with the literal.
+	* @evidence contracts/common.md#clear-and-simple-design One function delegating the literal building.
+	* @evidence contracts/common.md#prohibited-implementation-shortcuts The tag name and the argument come from the caller.
+	* @evidence contracts/common.md#meaningful-documentation The comment states the reference.
+	*/
 	tag(type, arg) {
 		const instance = this.external({
 			type: "instance",
@@ -34,6 +80,15 @@ var NestiaMigrateImportProgrammer = class {
 		});
 		return factory.createTypeReferenceNode(`${instance}.${type}`, arg === void 0 ? [] : [TypeLiteralFactory.generate(arg)]);
 	}
+	/**
+	* Returns the import statements: the external imports, a blank line when both
+	* kinds exist, and the type-only DTO imports.
+	*
+	* @evidence contracts/common.md#principled-implementation DTO names are grouped by the specifier that `dtoPath` returns, a name equal to the current file is skipped so a file never imports itself, and package specifiers merge into one clause.
+	* @evidence contracts/common.md#clear-and-simple-design One function with two emit sections.
+	* @evidence contracts/common.md#prohibited-implementation-shortcuts The specifier rule is the caller's.
+	* @evidence contracts/common.md#meaningful-documentation The comment states the result and the self-import rule.
+	*/
 	toStatements(dtoPath, current) {
 		const modules = /* @__PURE__ */ new Map();
 		for (const name of this.dtos_) if (current === void 0 || name !== current.split(".")[0]) MapUtil.take(modules)(dtoPath(name))(() => []).push(name);

package/lib/programmers/NestiaMigrateNestControllerProgrammer.d.ts

@@ -2,11 +2,39 @@ import { OpenApi } from "@typia/interface";
 import ts from "../internal/ts";
 import { INestiaMigrateConfig } from "../structures/INestiaMigrateConfig";
 import { INestiaMigrateController } from "../structures/INestiaMigrateController";
+/**
+ * Generates the source of one NestJS controller.
+ *
+ * @evidence contracts/common.md#principled-implementation The controller class is decorated with `@Controller` and its path, each route becomes a method written by the configured method programmer or the default one, and the DTO types are imported by package name because they live in the API package.
+ * @evidence contracts/common.md#clear-and-simple-design One function; the method programmer is replaceable through the configuration.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The replaceable programmer is a documented extension point.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 export declare namespace NestiaMigrateNestControllerProgrammer {
+    /**
+     * The input of one controller: the configuration, the components, and the
+     * controller.
+     *
+     * @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 IProps {
+        /** Generation options and an optional controller-method writer. */
         config: INestiaMigrateConfig;
+        /** Schemas needed by generated controller method types. */
         components: OpenApi.IComponents;
+        /** Controller name, router prefix and grouped operations. */
         controller: INestiaMigrateController;
     }
+    /**
+     * Returns the statements of a controller file.
+     *
+     * @evidence contracts/common.md#principled-implementation Blank lines separate the methods, and the imports come first.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The content follows the controller.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     const write: (props: IProps) => ts.Statement[];
 }

package/lib/programmers/NestiaMigrateNestControllerProgrammer.js

@@ -5,8 +5,24 @@ const factory_1 = require("@ttsc/factory");
 const FilePrinter_1 = require("../utils/FilePrinter");
 const NestiaMigrateImportProgrammer_1 = require("./NestiaMigrateImportProgrammer");
 const NestiaMigrateNestMethodProgrammer_1 = require("./NestiaMigrateNestMethodProgrammer");
+/**
+ * Generates the source of one NestJS controller.
+ *
+ * @evidence contracts/common.md#principled-implementation The controller class is decorated with `@Controller` and its path, each route becomes a method written by the configured method programmer or the default one, and the DTO types are imported by package name because they live in the API package.
+ * @evidence contracts/common.md#clear-and-simple-design One function; the method programmer is replaceable through the configuration.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The replaceable programmer is a documented extension point.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 var NestiaMigrateNestControllerProgrammer;
 (function (NestiaMigrateNestControllerProgrammer) {
+    /**
+     * Returns the statements of a controller file.
+     *
+     * @evidence contracts/common.md#principled-implementation Blank lines separate the methods, and the imports come first.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The content follows the controller.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     NestiaMigrateNestControllerProgrammer.write = (props) => {
         const importer = new NestiaMigrateImportProgrammer_1.NestiaMigrateImportProgrammer();
         const $class = factory_1.factory.createClassDeclaration([

package/lib/programmers/NestiaMigrateNestControllerProgrammer.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaMigrateNestControllerProgrammer.js","sourceRoot":"","sources":["../../src/programmers/NestiaMigrateNestControllerProgrammer.ts"],"names":[],"mappings":";;;AAAA,2CAAoD;AAMpD,sDAAmD;AACnD,mFAAgF;AAChF,2FAAwF;AAExF,IAAiB,qCAAqC,CAuDrD;AAvDD,WAAiB,qCAAqC;IAOvC,2CAAK,GAAG,CAAC,KAAa,EAAkB,EAAE;QACrD,MAAM,QAAQ,GACZ,IAAI,6DAA6B,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,iBAAO,CAAC,sBAAsB,CAC3C;YACE,iBAAO,CAAC,eAAe,CACrB,iBAAO,CAAC,oBAAoB,CAC1B,iBAAO,CAAC,gBAAgB,CACtB,QAAQ,CAAC,QAAQ,CAAC;gBAChB,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,gBAAgB;gBACzB,IAAI,EAAE,YAAY;aACnB,CAAC,CACH,EACD,EAAE,EACF,CAAC,iBAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CACrD,CACF;YACD,iBAAO,CAAC,WAAW,CAAC,oBAAU,CAAC,aAAa,CAAC;SAC9C,EACD,KAAK,CAAC,UAAU,CAAC,IAAI,EACrB,EAAE,EACF,EAAE,EACF,KAAK,CAAC,UAAU,CAAC,MAAM;aACpB,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,0BAAC;YACrB,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,yBAAW,CAAC,OAAO,EAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,OACE,MAAA,KAAK,CAAC,MAAM,CAAC,UAAU,0CAAE,gBAAgB,mCACzC,qEAAiC,CAAC,KAAK,CACxC,CAAC;gBACA,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,QAAQ;gBACR,KAAK;aACN,CAAC;SACH,GAAA,CAAC;aACD,IAAI,EAAE,CACV,CAAC;QACF,OAAO;YACL,kEAAkE;YAClE,sEAAsE;YACtE,uDAAuD;YACvD,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,2BAA2B,CAAC;YAC3D,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,yBAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,MAAM;SACP,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,EAvDgB,qCAAqC,aAArC,qCAAqC,GAArC,qCAAqC,QAuDrD"}
+{"version":3,"file":"NestiaMigrateNestControllerProgrammer.js","sourceRoot":"","sources":["../../src/programmers/NestiaMigrateNestControllerProgrammer.ts"],"names":[],"mappings":";;;AAAA,2CAAoD;AAMpD,sDAAmD;AACnD,mFAAgF;AAChF,2FAAwF;AAExF;;;;;;;GAOG;AACH,IAAiB,qCAAqC,CA6ErD;AA7ED,WAAiB,qCAAqC;IAqBpD;;;;;;;OAOG;IACU,2CAAK,GAAG,CAAC,KAAa,EAAkB,EAAE;QACrD,MAAM,QAAQ,GACZ,IAAI,6DAA6B,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,iBAAO,CAAC,sBAAsB,CAC3C;YACE,iBAAO,CAAC,eAAe,CACrB,iBAAO,CAAC,oBAAoB,CAC1B,iBAAO,CAAC,gBAAgB,CACtB,QAAQ,CAAC,QAAQ,CAAC;gBAChB,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,gBAAgB;gBACzB,IAAI,EAAE,YAAY;aACnB,CAAC,CACH,EACD,EAAE,EACF,CAAC,iBAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CACrD,CACF;YACD,iBAAO,CAAC,WAAW,CAAC,oBAAU,CAAC,aAAa,CAAC;SAC9C,EACD,KAAK,CAAC,UAAU,CAAC,IAAI,EACrB,EAAE,EACF,EAAE,EACF,KAAK,CAAC,UAAU,CAAC,MAAM;aACpB,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,0BAAC;YACrB,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,yBAAW,CAAC,OAAO,EAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,OACE,MAAA,KAAK,CAAC,MAAM,CAAC,UAAU,0CAAE,gBAAgB,mCACzC,qEAAiC,CAAC,KAAK,CACxC,CAAC;gBACA,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,QAAQ;gBACR,KAAK;aACN,CAAC;SACH,GAAA,CAAC;aACD,IAAI,EAAE,CACV,CAAC;QACF,OAAO;YACL,kEAAkE;YAClE,sEAAsE;YACtE,uDAAuD;YACvD,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,2BAA2B,CAAC;YAC3D,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,yBAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,MAAM;SACP,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,EA7EgB,qCAAqC,aAArC,qCAAqC,GAArC,qCAAqC,QA6ErD"}

package/lib/programmers/NestiaMigrateNestMethodProgrammer.d.ts

@@ -4,13 +4,43 @@ import ts from "../internal/ts";
 import { INestiaMigrateConfig } from "../structures/INestiaMigrateConfig";
 import { INestiaMigrateController } from "../structures/INestiaMigrateController";
 import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer";
+/**
+ * Generates the controller method of one route.
+ *
+ * @evidence contracts/common.md#principled-implementation The method carries `TypedRoute`, `TypedException`, `HumanRoute`, and example decorators as the route requires, one parameter per path, header, query, and body input with the matching typed decorator, and a body that mentions each parameter and returns `typia.random` of the response type.
+ * @evidence contracts/common.md#clear-and-simple-design One entry function and private writers for the description, the decorators, and the parameters.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The output derives from the route; the body is a stub that returns random data because the document does not define the behavior.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 export declare namespace NestiaMigrateNestMethodProgrammer {
+    /**
+     * The input of one method: the configuration, the components, the importer,
+     * the controller, 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 {
+        /** Generation options, including the author tag used on the handler. */
         config: INestiaMigrateConfig;
+        /** Component schemas referenced by request and response types. */
         components: OpenApi.IComponents;
+        /** Controller-file import collector shared by all its methods. */
         importer: NestiaMigrateImportProgrammer;
+        /** Controller prefix removed from this operation's router path. */
         controller: INestiaMigrateController;
+        /** Analyzed operation supplying method, schemas and examples. */
         route: IHttpMigrateRoute;
     }
+    /**
+     * Returns the method declaration of a route.
+     *
+     * @evidence contracts/common.md#principled-implementation The decorators and the parameters follow the route's HTTP method, path relative to the controller, and inputs.
+     * @evidence contracts/common.md#clear-and-simple-design One function composing the private writers.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The method follows the route.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     const write: (ctx: IContext) => ts.MethodDeclaration;
 }

package/lib/programmers/NestiaMigrateNestMethodProgrammer.js

@@ -2,15 +2,34 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NestiaMigrateNestMethodProgrammer = void 0;
 const factory_1 = require("@ttsc/factory");
+const NestiaMigrateControllerAnalyzer_1 = require("../analyzers/NestiaMigrateControllerAnalyzer");
 const ExpressionFactory_1 = require("../factories/ExpressionFactory");
 const IdentifierFactory_1 = require("../factories/IdentifierFactory");
 const LiteralFactory_1 = require("../factories/LiteralFactory");
 const TypeFactory_1 = require("../factories/TypeFactory");
 const FilePrinter_1 = require("../utils/FilePrinter");
+const RequestBody_1 = require("../utils/RequestBody");
 const StringUtil_1 = require("../utils/StringUtil");
+const SuccessStatus_1 = require("../utils/SuccessStatus");
 const NestiaMigrateSchemaProgrammer_1 = require("./NestiaMigrateSchemaProgrammer");
+/**
+ * Generates the controller method of one route.
+ *
+ * @evidence contracts/common.md#principled-implementation The method carries `TypedRoute`, `TypedException`, `HumanRoute`, and example decorators as the route requires, one parameter per path, header, query, and body input with the matching typed decorator, and a body that mentions each parameter and returns `typia.random` of the response type.
+ * @evidence contracts/common.md#clear-and-simple-design One entry function and private writers for the description, the decorators, and the parameters.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The output derives from the route; the body is a stub that returns random data because the document does not define the behavior.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 var NestiaMigrateNestMethodProgrammer;
 (function (NestiaMigrateNestMethodProgrammer) {
+    /**
+     * Returns the method declaration of a route.
+     *
+     * @evidence contracts/common.md#principled-implementation The decorators and the parameters follow the route's HTTP method, path relative to the controller, and inputs.
+     * @evidence contracts/common.md#clear-and-simple-design One function composing the private writers.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The method follows the route.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     NestiaMigrateNestMethodProgrammer.write = (ctx) => {
         const output = ctx.route.success
             ? NestiaMigrateSchemaProgrammer_1.NestiaMigrateSchemaProgrammer.write({
@@ -58,7 +77,7 @@ var NestiaMigrateNestMethodProgrammer;
         if (ctx.route.operation()["x-samchon-human"] === true)
             decorators.push(factory_1.factory.createDecorator(factory_1.factory.createCallExpression(external("@nestia/core", "HumanRoute"), undefined, undefined)));
         // ROUTER
-        const localPath = ctx.route.emendedPath
+        const localPath = NestiaMigrateControllerAnalyzer_1.NestiaMigrateControllerAnalyzer.routePath(ctx.route)
             .slice(ctx.controller.path.length)
             .split("/")
             .filter((str) => !!str.length)
@@ -66,17 +85,27 @@ var NestiaMigrateNestMethodProgrammer;
         const router = (instance) => factory_1.factory.createDecorator(factory_1.factory.createCallExpression(IdentifierFactory_1.IdentifierFactory.access(external("@nestia/core", instance), StringUtil_1.StringUtil.capitalize(ctx.route.method)), [], localPath.length
             ? [factory_1.factory.createStringLiteral(localPath)]
             : undefined));
+        // a vanilla NestJS method decorator, relative to the controller like the
+        // nestia ones: the document's full path would be joined onto the
+        // controller's again
+        const nest = (method) => factory_1.factory.createDecorator(factory_1.factory.createCallExpression(external("@nestjs/common", method), [], localPath.length
+            ? [factory_1.factory.createStringLiteral(localPath)]
+            : undefined));
         if ((_a = ctx.route.success) === null || _a === void 0 ? void 0 : _a["x-nestia-encrypted"])
             decorators.push(router("EncryptedRoute"));
         else if (((_b = ctx.route.success) === null || _b === void 0 ? void 0 : _b.type) === "text/plain")
-            decorators.push(factory_1.factory.createDecorator(factory_1.factory.createCallExpression(external("@nestjs/common", StringUtil_1.StringUtil.capitalize(ctx.route.method)), [], [factory_1.factory.createStringLiteral(ctx.route.path)])));
+            decorators.push(nest(StringUtil_1.StringUtil.capitalize(ctx.route.method)));
         else if (((_c = ctx.route.success) === null || _c === void 0 ? void 0 : _c.type) === "application/x-www-form-urlencoded")
             decorators.push(router("TypedQuery"));
         else if (ctx.route.method === "head")
-            decorators.push(factory_1.factory.createDecorator(factory_1.factory.createCallExpression(external("@nestjs/common", "Head"), [], [factory_1.factory.createStringLiteral(ctx.route.path)])));
+            decorators.push(nest("Head"));
         else if (ctx.route.success === null ||
             ((_d = ctx.route.success) === null || _d === void 0 ? void 0 : _d.type) === "application/json")
             decorators.push(router("TypedRoute"));
+        // NestJS answers 201 for POST and 200 otherwise
+        const status = SuccessStatus_1.SuccessStatus.of(ctx.route);
+        if (status !== null && status !== SuccessStatus_1.SuccessStatus.nest(ctx.route))
+            decorators.push(factory_1.factory.createDecorator(factory_1.factory.createCallExpression(external("@nestjs/common", "HttpCode"), undefined, [ExpressionFactory_1.ExpressionFactory.number(status)])));
         for (const [key, value] of Object.entries((_f = ctx.route.exceptions) !== null && _f !== void 0 ? _f : {}))
             decorators.push(factory_1.factory.createDecorator(factory_1.factory.createCallExpression(external("@nestia/core", "TypedException"), [
                 NestiaMigrateSchemaProgrammer_1.NestiaMigrateSchemaProgrammer.write({
@@ -94,7 +123,7 @@ var NestiaMigrateNestMethodProgrammer;
             ])));
         return decorators;
     };
-    const writeParameters = (ctx) => { var _a; return [
+    const writeParameters = (ctx) => [
         ...ctx.route.parameters.map((p) => factory_1.factory.createParameterDeclaration([
             ...writeExampleDecorators("Parameter")(ctx.importer)(p.parameter()),
             factory_1.factory.createDecorator(factory_1.factory.createCallExpression(factory_1.factory.createIdentifier(ctx.importer.external({
@@ -161,15 +190,13 @@ var NestiaMigrateNestMethodProgrammer;
                         : [],
                 })(ctx.components)(ctx.importer)({
                     schema: ctx.route.body.schema,
-                    required: !((ctx.route.body.type === "application/json" ||
-                        ctx.route.body.type === "text/plain") &&
-                        ((_a = ctx.route.operation().requestBody) === null || _a === void 0 ? void 0 : _a.required) === false),
+                    required: RequestBody_1.RequestBody.optional(ctx.route) === false,
                     example: ctx.route.body.media().example,
                     examples: ctx.route.body.media().examples,
                 }),
             ]
             : []),
-    ]; };
+    ];
     const writeDtoParameter = (accessor) => (components) => (importer) => (props) => {
         const instance = factory_1.factory.createIdentifier(importer.external({
             type: "instance",
@@ -201,11 +228,56 @@ var NestiaMigrateNestMethodProgrammer;
                 })), kind), [], [LiteralFactory_1.LiteralFactory.write(media.example)])),
             ]
             : []),
-        ...Object.entries((_a = media.examples) !== null && _a !== void 0 ? _a : {}).map(([key, value]) => factory_1.factory.createDecorator(factory_1.factory.createCallExpression(IdentifierFactory_1.IdentifierFactory.access(factory_1.factory.createIdentifier(importer.external({
-            type: "instance",
-            library: "@nestia/core",
-            name: "SwaggerExample",
-        })), kind), [], [factory_1.factory.createStringLiteral(key), LiteralFactory_1.LiteralFactory.write(value)]))),
+        ...Object.entries((_a = media.examples) !== null && _a !== void 0 ? _a : {}).flatMap(([key, example]) => {
+            const value = exampleValue(example);
+            if (value === null)
+                return [];
+            return factory_1.factory.createDecorator(factory_1.factory.createCallExpression(IdentifierFactory_1.IdentifierFactory.access(factory_1.factory.createIdentifier(importer.external({
+                type: "instance",
+                library: "@nestia/core",
+                name: "SwaggerExample",
+            })), kind), [], [
+                factory_1.factory.createStringLiteral(key),
+                LiteralFactory_1.LiteralFactory.write(value.value),
+            ]));
+        }),
     ]; };
 })(NestiaMigrateNestMethodProgrammer || (exports.NestiaMigrateNestMethodProgrammer = NestiaMigrateNestMethodProgrammer = {}));
+/**
+ * The value a named example stands for, or `null` when it names none.
+ *
+ * OpenAPI names examples with Example Objects, whose `value` (or, since 3.2,
+ * `dataValue`) holds the value, and a `$ref` to one arrives resolved. Documents
+ * from earlier nestia versions held the values themselves, so an object is read
+ * as an Example Object only when it is one: it has one of the value fields, and
+ * every other key is an Example Object field or an extension. A raw value of
+ * exactly that shape is ambiguous and is read as an Example Object, as a
+ * conforming document means it. An Example Object that only points at its value
+ * (`externalValue`) or only serializes it (`serializedValue`) gives
+ * `SwaggerExample` nothing to hold.
+ */
+const exampleValue = (example) => {
+    if (isExampleObject(example) === false)
+        return { value: example };
+    const record = example;
+    if (Object.prototype.hasOwnProperty.call(record, "value"))
+        return { value: record.value };
+    if (Object.prototype.hasOwnProperty.call(record, "dataValue"))
+        return { value: record.dataValue };
+    return null;
+};
+const isExampleObject = (example) => typeof example === "object" &&
+    example !== null &&
+    Array.isArray(example) === false &&
+    VALUE_KEYS.some((key) => Object.prototype.hasOwnProperty.call(example, key)) &&
+    Object.keys(example).every((key) => VALUE_KEYS.includes(key) ||
+        key === "summary" ||
+        key === "description" ||
+        key.startsWith("x-"));
+const VALUE_KEYS = [
+    "value",
+    "dataValue",
+    "serializedValue",
+    "externalValue",
+];
 //# sourceMappingURL=NestiaMigrateNestMethodProgrammer.js.map

package/lib/programmers/NestiaMigrateNestMethodProgrammer.js.map

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

package/lib/programmers/NestiaMigrateNestMethodProgrammer.mjs

@@ -1,10 +1,13 @@
 import { FilePrinter } from "../utils/FilePrinter.mjs";
 import { TypeFactory } from "../factories/TypeFactory.mjs";
 import { IdentifierFactory } from "../factories/IdentifierFactory.mjs";
+import { RequestBody } from "../utils/RequestBody.mjs";
+import { SuccessStatus } from "../utils/SuccessStatus.mjs";
 import { StringUtil } from "../utils/StringUtil.mjs";
 import { NestiaMigrateSchemaProgrammer } from "./NestiaMigrateSchemaProgrammer.mjs";
 import { ExpressionFactory } from "../factories/ExpressionFactory.mjs";
 import { LiteralFactory } from "../factories/LiteralFactory.mjs";
+import { NestiaMigrateControllerAnalyzer } from "../analyzers/NestiaMigrateControllerAnalyzer.mjs";
 import { SyntaxKind, factory } from "@ttsc/factory";
 //#region src/programmers/NestiaMigrateNestMethodProgrammer.ts
 let NestiaMigrateNestMethodProgrammer;
@@ -41,13 +44,16 @@ let NestiaMigrateNestMethodProgrammer;
 		const decorators = [];
 		if (ctx.route.success) decorators.push(...writeExampleDecorators("Response")(ctx.importer)(ctx.route.success.media()));
 		if (ctx.route.operation()["x-samchon-human"] === true) decorators.push(factory.createDecorator(factory.createCallExpression(external("@nestia/core", "HumanRoute"), void 0, void 0)));
-		const localPath = ctx.route.emendedPath.slice(ctx.controller.path.length).split("/").filter((str) => !!str.length).join("/");
+		const localPath = NestiaMigrateControllerAnalyzer.routePath(ctx.route).slice(ctx.controller.path.length).split("/").filter((str) => !!str.length).join("/");
 		const router = (instance) => factory.createDecorator(factory.createCallExpression(IdentifierFactory.access(external("@nestia/core", instance), StringUtil.capitalize(ctx.route.method)), [], localPath.length ? [factory.createStringLiteral(localPath)] : void 0));
+		const nest = (method) => factory.createDecorator(factory.createCallExpression(external("@nestjs/common", method), [], localPath.length ? [factory.createStringLiteral(localPath)] : void 0));
 		if (ctx.route.success?.["x-nestia-encrypted"]) decorators.push(router("EncryptedRoute"));
-		else if (ctx.route.success?.type === "text/plain") decorators.push(factory.createDecorator(factory.createCallExpression(external("@nestjs/common", StringUtil.capitalize(ctx.route.method)), [], [factory.createStringLiteral(ctx.route.path)])));
+		else if (ctx.route.success?.type === "text/plain") decorators.push(nest(StringUtil.capitalize(ctx.route.method)));
 		else if (ctx.route.success?.type === "application/x-www-form-urlencoded") decorators.push(router("TypedQuery"));
-		else if (ctx.route.method === "head") decorators.push(factory.createDecorator(factory.createCallExpression(external("@nestjs/common", "Head"), [], [factory.createStringLiteral(ctx.route.path)])));
+		else if (ctx.route.method === "head") decorators.push(nest("Head"));
 		else if (ctx.route.success === null || ctx.route.success?.type === "application/json") decorators.push(router("TypedRoute"));
+		const status = SuccessStatus.of(ctx.route);
+		if (status !== null && status !== SuccessStatus.nest(ctx.route)) decorators.push(factory.createDecorator(factory.createCallExpression(external("@nestjs/common", "HttpCode"), void 0, [ExpressionFactory.number(status)])));
 		for (const [key, value] of Object.entries(ctx.route.exceptions ?? {})) decorators.push(factory.createDecorator(factory.createCallExpression(external("@nestia/core", "TypedException"), [NestiaMigrateSchemaProgrammer.write({
 			components: ctx.components,
 			importer: ctx.importer,
@@ -95,7 +101,7 @@ let NestiaMigrateNestMethodProgrammer;
 			})), void 0, void 0))] : []
 		})(ctx.components)(ctx.importer)({
 			schema: ctx.route.body.schema,
-			required: !((ctx.route.body.type === "application/json" || ctx.route.body.type === "text/plain") && ctx.route.operation().requestBody?.required === false),
+			required: RequestBody.optional(ctx.route) === false,
 			example: ctx.route.body.media().example,
 			examples: ctx.route.body.media().examples
 		})] : []
@@ -116,12 +122,43 @@ let NestiaMigrateNestMethodProgrammer;
 		type: "instance",
 		library: "@nestia/core",
 		name: "SwaggerExample"
-	})), kind), [], [LiteralFactory.write(media.example)]))] : [], ...Object.entries(media.examples ?? {}).map(([key, value]) => factory.createDecorator(factory.createCallExpression(IdentifierFactory.access(factory.createIdentifier(importer.external({
-		type: "instance",
-		library: "@nestia/core",
-		name: "SwaggerExample"
-	})), kind), [], [factory.createStringLiteral(key), LiteralFactory.write(value)])))];
+	})), kind), [], [LiteralFactory.write(media.example)]))] : [], ...Object.entries(media.examples ?? {}).flatMap(([key, example]) => {
+		const value = exampleValue(example);
+		if (value === null) return [];
+		return factory.createDecorator(factory.createCallExpression(IdentifierFactory.access(factory.createIdentifier(importer.external({
+			type: "instance",
+			library: "@nestia/core",
+			name: "SwaggerExample"
+		})), kind), [], [factory.createStringLiteral(key), LiteralFactory.write(value.value)]));
+	})];
 })(NestiaMigrateNestMethodProgrammer || (NestiaMigrateNestMethodProgrammer = {}));
+/**
+* The value a named example stands for, or `null` when it names none.
+*
+* OpenAPI names examples with Example Objects, whose `value` (or, since 3.2,
+* `dataValue`) holds the value, and a `$ref` to one arrives resolved. Documents
+* from earlier nestia versions held the values themselves, so an object is read
+* as an Example Object only when it is one: it has one of the value fields, and
+* every other key is an Example Object field or an extension. A raw value of
+* exactly that shape is ambiguous and is read as an Example Object, as a
+* conforming document means it. An Example Object that only points at its value
+* (`externalValue`) or only serializes it (`serializedValue`) gives
+* `SwaggerExample` nothing to hold.
+*/
+const exampleValue = (example) => {
+	if (isExampleObject(example) === false) return { value: example };
+	const record = example;
+	if (Object.prototype.hasOwnProperty.call(record, "value")) return { value: record.value };
+	if (Object.prototype.hasOwnProperty.call(record, "dataValue")) return { value: record.dataValue };
+	return null;
+};
+const isExampleObject = (example) => typeof example === "object" && example !== null && Array.isArray(example) === false && VALUE_KEYS.some((key) => Object.prototype.hasOwnProperty.call(example, key)) && Object.keys(example).every((key) => VALUE_KEYS.includes(key) || key === "summary" || key === "description" || key.startsWith("x-"));
+const VALUE_KEYS = [
+	"value",
+	"dataValue",
+	"serializedValue",
+	"externalValue"
+];
 //#endregion
 export { NestiaMigrateNestMethodProgrammer };
 

package/lib/programmers/NestiaMigrateNestModuleProgrammer.d.ts

@@ -1,5 +1,21 @@
 import ts from "../internal/ts";
 import { INestiaMigrateController } from "../structures/INestiaMigrateController";
+/**
+ * Generates the NestJS module that lists the controllers.
+ *
+ * @evidence contracts/common.md#principled-implementation The module imports every controller from its location and lists them in the `controllers` array of a decorated class.
+ * @evidence contracts/common.md#clear-and-simple-design One function and one private import builder.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The controllers follow the analysis.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 export declare namespace NestiaMigrateNestModuleProgrammer {
+    /**
+     * Returns the statements of the module file.
+     *
+     * @evidence contracts/common.md#principled-implementation The import paths turn the `src/` prefix of a controller location into `./`, so the module can import from its own directory.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The names follow the controllers.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     const write: (controllers: INestiaMigrateController[]) => ts.Statement[];
 }

package/lib/programmers/NestiaMigrateNestModuleProgrammer.js

@@ -3,8 +3,24 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NestiaMigrateNestModuleProgrammer = void 0;
 const factory_1 = require("@ttsc/factory");
 const FilePrinter_1 = require("../utils/FilePrinter");
+/**
+ * Generates the NestJS module that lists the controllers.
+ *
+ * @evidence contracts/common.md#principled-implementation The module imports every controller from its location and lists them in the `controllers` array of a decorated class.
+ * @evidence contracts/common.md#clear-and-simple-design One function and one private import builder.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The controllers follow the analysis.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 var NestiaMigrateNestModuleProgrammer;
 (function (NestiaMigrateNestModuleProgrammer) {
+    /**
+     * Returns the statements of the module file.
+     *
+     * @evidence contracts/common.md#principled-implementation The import paths turn the `src/` prefix of a controller location into `./`, so the module can import from its own directory.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The names follow the controllers.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     NestiaMigrateNestModuleProgrammer.write = (controllers) => [
         $import("@nestjs/common")("Module"),
         ...(controllers.length ? [FilePrinter_1.FilePrinter.newLine()] : []),

package/lib/programmers/NestiaMigrateNestModuleProgrammer.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaMigrateNestModuleProgrammer.js","sourceRoot":"","sources":["../../src/programmers/NestiaMigrateNestModuleProgrammer.ts"],"names":[],"mappings":";;;AAAA,2CAAoD;AAIpD,sDAAmD;AAEnD,IAAiB,iCAAiC,CAwCjD;AAxCD,WAAiB,iCAAiC;IACnC,uCAAK,GAAG,CACnB,WAAuC,EACvB,EAAE,CAAC;QACnB,OAAO,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC;QACnC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,yBAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACvB,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CACjE;QACD,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,yBAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,iBAAO,CAAC,sBAAsB,CAC5B;YACE,iBAAO,CAAC,eAAe,CACrB,iBAAO,CAAC,oBAAoB,CAC1B,iBAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAClC,SAAS,EACT;gBACE,iBAAO,CAAC,6BAA6B,CACnC;oBACE,iBAAO,CAAC,wBAAwB,CAC9B,iBAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,EACvC,iBAAO,CAAC,4BAA4B,CAClC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EACxD,IAAI,CACL,CACF;iBACF,EACD,IAAI,CACL;aACF,CACF,CACF;YACD,iBAAO,CAAC,WAAW,CAAC,oBAAU,CAAC,aAAa,CAAC;SAC9C,EACD,UAAU,EACV,SAAS,EACT,SAAS,EACT,EAAE,CACH;KACF,CAAC;AACJ,CAAC,EAxCgB,iCAAiC,aAAjC,iCAAiC,GAAjC,iCAAiC,QAwCjD;AAED,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,QAAgB,EAAE,EAAE,CACrD,iBAAO,CAAC,uBAAuB,CAC7B,SAAS,EACT,iBAAO,CAAC,kBAAkB,CACxB,SAAS,EACT,SAAS,EACT,iBAAO,CAAC,kBAAkB,CAAC;IACzB,iBAAO,CAAC,qBAAqB,CAC3B,KAAK,EACL,SAAS,EACT,iBAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CACnC;CACF,CAAC,CACH,EACD,iBAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAClC,CAAC"}
+{"version":3,"file":"NestiaMigrateNestModuleProgrammer.js","sourceRoot":"","sources":["../../src/programmers/NestiaMigrateNestModuleProgrammer.ts"],"names":[],"mappings":";;;AAAA,2CAAoD;AAIpD,sDAAmD;AAEnD;;;;;;;GAOG;AACH,IAAiB,iCAAiC,CAgDjD;AAhDD,WAAiB,iCAAiC;IAChD;;;;;;;OAOG;IACU,uCAAK,GAAG,CACnB,WAAuC,EACvB,EAAE,CAAC;QACnB,OAAO,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC;QACnC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,yBAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACvB,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CACjE;QACD,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,yBAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,iBAAO,CAAC,sBAAsB,CAC5B;YACE,iBAAO,CAAC,eAAe,CACrB,iBAAO,CAAC,oBAAoB,CAC1B,iBAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAClC,SAAS,EACT;gBACE,iBAAO,CAAC,6BAA6B,CACnC;oBACE,iBAAO,CAAC,wBAAwB,CAC9B,iBAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,EACvC,iBAAO,CAAC,4BAA4B,CAClC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EACxD,IAAI,CACL,CACF;iBACF,EACD,IAAI,CACL;aACF,CACF,CACF;YACD,iBAAO,CAAC,WAAW,CAAC,oBAAU,CAAC,aAAa,CAAC;SAC9C,EACD,UAAU,EACV,SAAS,EACT,SAAS,EACT,EAAE,CACH;KACF,CAAC;AACJ,CAAC,EAhDgB,iCAAiC,aAAjC,iCAAiC,GAAjC,iCAAiC,QAgDjD;AAED,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,QAAgB,EAAE,EAAE,CACrD,iBAAO,CAAC,uBAAuB,CAC7B,SAAS,EACT,iBAAO,CAAC,kBAAkB,CACxB,SAAS,EACT,SAAS,EACT,iBAAO,CAAC,kBAAkB,CAAC;IACzB,iBAAO,CAAC,qBAAqB,CAC3B,KAAK,EACL,SAAS,EACT,iBAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CACnC;CACF,CAAC,CACH,EACD,iBAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAClC,CAAC"}

package/lib/programmers/NestiaMigrateNestProgrammer.d.ts

@@ -1,4 +1,21 @@
 import { INestiaMigrateContext } from "../structures/INestiaMigrateContext";
+/**
+ * Generates the NestJS side of a monorepo project: the module, the controllers,
+ * and the DTO structures.
+ *
+ * @evidence contracts/common.md#principled-implementation The controllers come from the analyzer, each DTO tree becomes a structure file, and a barrel file re-exports every non-empty structure file so the template's module keeps working.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and private helpers for the DTO files and the barrel.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The layout follows the analysis.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what is generated.
+ */
 export declare namespace NestiaMigrateNestProgrammer {
+    /**
+     * Returns the map from file path to content of the NestJS files.
+     *
+     * @evidence contracts/common.md#principled-implementation The barrel is computed from the generated structure files, sorted by name, so its content is deterministic.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The names follow the document.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     */
     const write: (context: INestiaMigrateContext) => Record<string, string>;
 }