@nestia/migrate 14.0.1 → 14.0.3

package/lib/analyzers/NestiaMigrateControllerAnalyzer.js

@@ -4,8 +4,45 @@ exports.NestiaMigrateControllerAnalyzer = void 0;
 const MapUtil_1 = require("../utils/MapUtil");
 const PathTemplate_1 = require("../utils/PathTemplate");
 const StringUtil_1 = require("../utils/StringUtil");
+/**
+ * Groups the routes of an application into NestJS controllers.
+ *
+ * Generated controller locations use portable slash spelling and directoryName
+ * applies Windows filename constraints on every host: invalid/control
+ * characters and trailing dots/spaces become underscores, and device names,
+ * including extension and superscript-digit forms, receive a prefix. Router
+ * paths retain their original URL meaning. Directory normalization is
+ * intentionally many-to-one; distinct controllers retain their own filenames.
+ * Host filesystem case policy is not inferred.
+ *
+ * @evidence contracts/common.md#principled-implementation Routes are grouped by the controller name from the operation, or by the capitalized accessor prefix, and each controller path is the longest path prefix shared by all of its routes, so one controller covers one resource path.
+ * @evidence contracts/common.md#clear-and-simple-design One namespace with the grouping and the path formatting, and small private helpers for the shared-prefix computation.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Names and paths derive from the document, with no route or controller name special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ */
 var NestiaMigrateControllerAnalyzer;
 (function (NestiaMigrateControllerAnalyzer) {
+    /**
+     * Returns the controllers of the routes, each with its name, its path, its
+     * source location, and its routes.
+     *
+     * The name is the `x-samchon-controller` extension of the operation when
+     * present, and otherwise the capitalized accessor prefix followed by
+     * `Controller`.
+     *
+     * Generated controller locations use portable slash spelling and
+     * directoryName applies Windows filename constraints on every host:
+     * invalid/control characters and trailing dots/spaces become underscores, and
+     * device names, including extension and superscript-digit forms, receive a
+     * prefix. Router paths retain their original URL meaning. Directory
+     * normalization is intentionally many-to-one; distinct controllers retain
+     * their own filenames. Host filesystem case policy is not inferred.
+     *
+     * @evidence contracts/common.md#principled-implementation Grouping uses a map keyed by controller name, and the common path prefix and the directory prefix are found by removing every segment after the first difference across the routes, so a controller path is a prefix of every route it owns.
+     * @evidence contracts/common.md#clear-and-simple-design One function with two phases: grouping, then prefix computation.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The extension name is part of the generated document contract; no other name is assumed.
+     * @evidence contracts/common.md#meaningful-documentation The comment states how the name and the path are chosen.
+     */
     NestiaMigrateControllerAnalyzer.analyze = (routes) => {
         var _a;
         const collection = new Map();
@@ -49,6 +86,14 @@ var NestiaMigrateControllerAnalyzer;
      * A literal character the router reserves is escaped, so an AIP custom
      * method's `/items:batchGet` stays a literal rather than a parameter
      * `batchGet`, and `(` or `*` no syntax error.
+     *
+     * This operation emits router protocol spelling and does not select native
+     * filenames or filesystem identities.
+     *
+     * @evidence contracts/common.md#principled-implementation The path template is split into literal and parameter segments, and every character that path-to-regexp treats specially in a literal is escaped with a backslash, so a literal never changes the route's meaning.
+     * @evidence contracts/common.md#clear-and-simple-design One expression over the shared path segmenter.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The reserved set is the router's syntax and is applied to every literal.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the escaping and the parameter form.
      */
     NestiaMigrateControllerAnalyzer.routePath = (route) => PathTemplate_1.PathTemplate.segments(route)
         .map((segment) => segment.type === "literal"
@@ -62,10 +107,21 @@ var NestiaMigrateControllerAnalyzer;
  */
 const ROUTER_RESERVED = /[\\:*?+!(){}[\]]/g;
 /**
- * A route segment as a directory name: unescaped, and each character a file
- * name cannot hold on Windows (`:` of an AIP custom method, `*`, `?`) as `_`.
+ * Maps a route segment to a portable directory component. Router escapes are
+ * removed, Windows-invalid characters and trailing dots/spaces become
+ * underscores, and reserved device names receive an underscore prefix. Distinct
+ * route segments may share a directory; controller files retain their
+ * independently assigned controller names.
  */
-const directoryName = (segment) => segment.replace(/\\(.)/g, "$1").replace(/[<>:"|?*\\]/g, "_");
+const directoryName = (segment) => {
+    const name = segment
+        .replace(/\\(.)/g, "$1")
+        .replace(/[<>:"|?*\\\u0000-\u001f]/g, "_")
+        .replace(/[. ]+$/, (suffix) => "_".repeat(suffix.length));
+    return /^(?:CON|PRN|AUX|NUL|COM[1-9¹²³]|LPT[1-9¹²³])(?:\.|$)/i.test(name)
+        ? `_${name}`
+        : name || "_";
+};
 const getSplitIndex = (x, y) => {
     const n = Math.min(x.length, y.length);
     for (let i = 0; i < n; ++i)

package/lib/analyzers/NestiaMigrateControllerAnalyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaMigrateControllerAnalyzer.js","sourceRoot":"","sources":["../../src/analyzers/NestiaMigrateControllerAnalyzer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NestiaMigrateControllerAnalyzer.js","sourceRoot":"","sources":["../../src/analyzers/NestiaMigrateControllerAnalyzer.ts"],"names":[],"mappings":";;;AAGA,8CAA2C;AAC3C,wDAAqD;AACrD,oDAAiD;AAEjD;;;;;;;;;;;;;;;GAeG;AACH,IAAiB,+BAA+B,CA0F/C;AA1FD,WAAiB,+BAA+B;IAC9C;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,uCAAO,GAAG,CACrB,MAA2B,EACC,EAAE;;QAC9B,MAAM,UAAU,GAA0C,IAAI,GAAG,EAAE,CAAC;QACpE,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,SACR,CAAC,CAAC,SAAS,EAAE,CAAC,sBAAsB,CAAC,mCACrC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC;gBACrB,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,uBAAU,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC9D,YAAY,CAAC;YACjB,iBAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;gBACpC,IAAI;gBACJ,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,OAAO;gBACjB,MAAM,EAAE,EAAE;aACX,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;QAED,MAAM,WAAW,GAA+B,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACzE,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,CAAC,CAAoB,EAAY,EAAE,CACnD,yCAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1B,MAAM,aAAa,GAAG,CAAC,CAAoB,EAAY,EAAE,CACvD,SAAS,CAAC,CAAC,CAAC;iBACT,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;iBAC7C,GAAG,CAAC,aAAa,CAAC,CAAC;YAExB,MAAM,OAAO,GAAa,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;YACpD,MAAM,WAAW,GAAa,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;YAC5D,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrD,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnE,CAAC;YACD,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7B,GAAG,CAAC,QAAQ,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;IAEF;;;;;;;;;;;;;;;;;;;OAmBG;IACU,yCAAS,GAAG,CAAC,KAAwB,EAAU,EAAE,CAC5D,2BAAY,CAAC,QAAQ,CAAC,KAAK,CAAC;SACzB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACf,OAAO,CAAC,IAAI,KAAK,SAAS;QACxB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC;QAChD,CAAC,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,CAChC;SACA,IAAI,CAAC,EAAE,CAAC,CAAC;AAChB,CAAC,EA1FgB,+BAA+B,aAA/B,+BAA+B,GAA/B,+BAA+B,QA0F/C;AAED;;;GAGG;AACH,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,CAAC,OAAe,EAAU,EAAE;IAChD,MAAM,IAAI,GAAW,OAAO;SACzB,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;SACvB,OAAO,CAAC,2BAA2B,EAAE,GAAG,CAAC;SACzC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,OAAO,uDAAuD,CAAC,IAAI,CAAC,IAAI,CAAC;QACvE,CAAC,CAAC,IAAI,IAAI,EAAE;QACZ,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,CAAW,EAAE,CAAW,EAAE,EAAE;IACjD,MAAM,CAAC,GAAW,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAC/C,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAChE,OAAO,CAAC,CAAC;AACX,CAAC,CAAC"}

package/lib/analyzers/NestiaMigrateControllerAnalyzer.mjs

@@ -42,10 +42,16 @@ let NestiaMigrateControllerAnalyzer;
 */
 const ROUTER_RESERVED = /[\\:*?+!(){}[\]]/g;
 /**
-* A route segment as a directory name: unescaped, and each character a file
-* name cannot hold on Windows (`:` of an AIP custom method, `*`, `?`) as `_`.
+* Maps a route segment to a portable directory component. Router escapes are
+* removed, Windows-invalid characters and trailing dots/spaces become
+* underscores, and reserved device names receive an underscore prefix. Distinct
+* route segments may share a directory; controller files retain their
+* independently assigned controller names.
 */
-const directoryName = (segment) => segment.replace(/\\(.)/g, "$1").replace(/[<>:"|?*\\]/g, "_");
+const directoryName = (segment) => {
+	const name = segment.replace(/\\(.)/g, "$1").replace(/[<>:"|?*\\\u0000-\u001f]/g, "_").replace(/[. ]+$/, (suffix) => "_".repeat(suffix.length));
+	return /^(?:CON|PRN|AUX|NUL|COM[1-9¹²³]|LPT[1-9¹²³])(?:\.|$)/i.test(name) ? `_${name}` : name || "_";
+};
 const getSplitIndex = (x, y) => {
 	const n = Math.min(x.length, y.length);
 	for (let i = 0; i < n; ++i) if (x[i] !== y[i]) return i;

package/lib/archivers/NestiaMigrateFileArchiver.d.ts

@@ -1,4 +1,38 @@
+/**
+ * Writes a file map into a directory through injected file-system functions.
+ *
+ * Each path is the root, a `/` and the key's `/`-separated segments, a spelling
+ * the filesystem calls of every supported platform accept, and creation and
+ * writing are delegated to injected functions, so the caller's filesystem
+ * decides existence, case policy and permissions. Directories are created one
+ * segment at a time because the injected creator is not recursive. Remaining
+ * assumptions: keys are trusted generated names, since a `..` or absolute
+ * segment would leave the root, and on a case-insensitive volume two keys that
+ * differ only in case write to the same file.
+ *
+ * @evidence contracts/common.md#principled-implementation Directories are created one path prefix at a time, each once, through a memoized creator, and the files are then written in the order of the map; injecting the functions keeps the archiver independent of Node and of the browser.
+ * @evidence contracts/common.md#clear-and-simple-design One function with one memoized directory creator.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It writes exactly the given files, and injection is the supported boundary for the platform.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ */
 export declare namespace NestiaMigrateFileArchiver {
+    /**
+     * Writes every file of `files` below `root`, creating the directories on the
+     * way.
+     *
+     * A directory that cannot be created is not reported, because the creator is
+     * also called for a directory that already exists; the failure surfaces when
+     * the file is written.
+     *
+     * The memo of created directories is keyed by the spelled path, so on a
+     * case-insensitive volume a second spelling attempts the creation again and
+     * receives the already-exists error, which is the swallowed outcome.
+     *
+     * @evidence contracts/common.md#principled-implementation The root and each prefix of each file's directory are created once, in order, before the file is written, and a creation failure is deferred to the write that needs the directory, since the injected creator is not recursive and reports an existing directory as an error.
+     * @evidence contracts/common.md#clear-and-simple-design One function; the memoized creator makes a repeated directory a no-op.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The dropped creation error is a stated consequence of the non-recursive creator, and the write still fails loudly when the directory is missing.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the order of creation and the deferred error.
+     */
     const archive: (props: {
         mkdir: (path: string) => Promise<void>;
         writeFile: (path: string, content: string) => Promise<void>;

package/lib/archivers/NestiaMigrateFileArchiver.js

@@ -11,8 +11,42 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NestiaMigrateFileArchiver = void 0;
 const tstl_1 = require("tstl");
+/**
+ * Writes a file map into a directory through injected file-system functions.
+ *
+ * Each path is the root, a `/` and the key's `/`-separated segments, a spelling
+ * the filesystem calls of every supported platform accept, and creation and
+ * writing are delegated to injected functions, so the caller's filesystem
+ * decides existence, case policy and permissions. Directories are created one
+ * segment at a time because the injected creator is not recursive. Remaining
+ * assumptions: keys are trusted generated names, since a `..` or absolute
+ * segment would leave the root, and on a case-insensitive volume two keys that
+ * differ only in case write to the same file.
+ *
+ * @evidence contracts/common.md#principled-implementation Directories are created one path prefix at a time, each once, through a memoized creator, and the files are then written in the order of the map; injecting the functions keeps the archiver independent of Node and of the browser.
+ * @evidence contracts/common.md#clear-and-simple-design One function with one memoized directory creator.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It writes exactly the given files, and injection is the supported boundary for the platform.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ */
 var NestiaMigrateFileArchiver;
 (function (NestiaMigrateFileArchiver) {
+    /**
+     * Writes every file of `files` below `root`, creating the directories on the
+     * way.
+     *
+     * A directory that cannot be created is not reported, because the creator is
+     * also called for a directory that already exists; the failure surfaces when
+     * the file is written.
+     *
+     * The memo of created directories is keyed by the spelled path, so on a
+     * case-insensitive volume a second spelling attempts the creation again and
+     * receives the already-exists error, which is the swallowed outcome.
+     *
+     * @evidence contracts/common.md#principled-implementation The root and each prefix of each file's directory are created once, in order, before the file is written, and a creation failure is deferred to the write that needs the directory, since the injected creator is not recursive and reports an existing directory as an error.
+     * @evidence contracts/common.md#clear-and-simple-design One function; the memoized creator makes a repeated directory a no-op.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The dropped creation error is a stated consequence of the non-recursive creator, and the write still fails loudly when the directory is missing.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the order of creation and the deferred error.
+     */
     NestiaMigrateFileArchiver.archive = (props) => __awaiter(this, void 0, void 0, function* () {
         const mkdir = new tstl_1.VariadicSingleton((location) => __awaiter(this, void 0, void 0, function* () {
             try {

package/lib/archivers/NestiaMigrateFileArchiver.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaMigrateFileArchiver.js","sourceRoot":"","sources":["../../src/archivers/NestiaMigrateFileArchiver.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+BAAyC;AAEzC,IAAiB,yBAAyB,CA6BzC;AA7BD,WAAiB,yBAAyB;IAC3B,iCAAO,GAAG,CAAO,KAK7B,EAAiB,EAAE;QAClB,MAAM,KAAK,GAAG,IAAI,wBAAiB,CACjC,CAAO,QAAgB,EAAiB,EAAE;YACxC,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC,CAAC;YACjD,CAAC;uBAAO,CAAC,CAAA,CAAC;QACZ,CAAC,CAAA,CACF,CAAC;QACF,MAAM,OAAO,GAAG,CAAO,QAAgB,EAAiB,EAAE;YACxD,MAAM,QAAQ,GAAa,QAAQ;iBAChC,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9D,KAAK,MAAM,CAAC,IAAI,QAAQ;gBAAE,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC,CAAA,CAAC;QACF,oEAAoE;QACpE,wEAAwE;QACxE,sDAAsD;QACtD,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACvD,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACrD,MAAM,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CAAA,CAAC;AACJ,CAAC,EA7BgB,yBAAyB,aAAzB,yBAAyB,GAAzB,yBAAyB,QA6BzC"}
+{"version":3,"file":"NestiaMigrateFileArchiver.js","sourceRoot":"","sources":["../../src/archivers/NestiaMigrateFileArchiver.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+BAAyC;AAEzC;;;;;;;;;;;;;;;;GAgBG;AACH,IAAiB,yBAAyB,CA8CzC;AA9CD,WAAiB,yBAAyB;IACxC;;;;;;;;;;;;;;;;OAgBG;IACU,iCAAO,GAAG,CAAO,KAK7B,EAAiB,EAAE;QAClB,MAAM,KAAK,GAAG,IAAI,wBAAiB,CACjC,CAAO,QAAgB,EAAiB,EAAE;YACxC,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC,CAAC;YACjD,CAAC;uBAAO,CAAC,CAAA,CAAC;QACZ,CAAC,CAAA,CACF,CAAC;QACF,MAAM,OAAO,GAAG,CAAO,QAAgB,EAAiB,EAAE;YACxD,MAAM,QAAQ,GAAa,QAAQ;iBAChC,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9D,KAAK,MAAM,CAAC,IAAI,QAAQ;gBAAE,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC,CAAA,CAAC;QACF,oEAAoE;QACpE,wEAAwE;QACxE,sDAAsD;QACtD,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACvD,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACrD,MAAM,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CAAA,CAAC;AACJ,CAAC,EA9CgB,yBAAyB,aAAzB,yBAAyB,GAAzB,yBAAyB,QA8CzC"}

package/lib/bundles/NEST_TEMPLATE.js

@@ -52,7 +52,7 @@ exports.NEST_TEMPLATE = {
     "packages/backend/test/webpack.ts": "import { DynamicExecutor } from \"@nestia/e2e\";\nimport cp from \"node:child_process\";\nimport { sleep_for } from \"tstl\";\n\nimport { MyConfiguration } from \"../src/MyConfiguration\";\nimport { MyGlobal } from \"../src/MyGlobal\";\nimport { TestAutomation } from \"./helpers/TestAutomation\";\nimport { TestAutomationStdio } from \"./helpers/TestAutomationStdio\";\n\nconst wait = async (): Promise<void> => {\n  while (true)\n    try {\n      await fetch(`http://localhost:${MyConfiguration.API_PORT()}/dsafdsafsd`);\n      return;\n    } catch (exp) {\n      await sleep_for(100);\n    }\n};\n\nconst main = async (): Promise<void> => {\n  MyGlobal.testing = true;\n\n  const report: DynamicExecutor.IReport = await TestAutomation.execute({\n    open: async () => {\n      const backend: cp.ChildProcess = cp.fork(\n        `${MyConfiguration.ROOT}/dist/server.js`,\n        {\n          cwd: `${MyConfiguration.ROOT}/dist`,\n        },\n      );\n      await wait();\n      return backend;\n    },\n    close: async (backend) => {\n      backend.kill();\n    },\n    options: await TestAutomationStdio.getOptions(),\n    onComplete: TestAutomationStdio.onComplete,\n  });\n  TestAutomationStdio.report(report);\n};\nmain().catch((exp: unknown) => {\n  console.log(exp);\n  process.exit(-1);\n});\n",
     "packages/backend/tsconfig.json": "{\n  \"extends\": \"../../config/tsconfig.json\",\n  \"compilerOptions\": {\n    \"outDir\": \"lib\",\n    \"rootDir\": \"src\",\n    \"experimentalDecorators\": true,\n    \"emitDecoratorMetadata\": true\n  },\n  \"include\": [\"src\"]\n}\n",
     "packages/backend/webpack.config.js": "const path = require(\"path\");\n\nconst CopyWebpackPlugin = require(\"copy-webpack-plugin\");\nconst WriteFilePlugin = require(\"write-file-webpack-plugin\");\nconst { IgnorePlugin } = require(\"webpack\");\n\nconst lazyImports = [\n  \"@modelcontextprotocol/sdk\",\n  \"@fastify/static\",\n  \"@fastify/view\",\n  \"@nestjs/microservices\",\n  \"@nestjs/websockets\",\n  \"class-transformer\",\n  \"class-validator\",\n];\n\n// @reference https://tech-blog.s-yoshiki.com/entry/297\nmodule.exports = {\n  // CUSTOMIZE HERE\n  entry: {\n    server: \"./lib/executable/server.js\",\n  },\n  output: {\n    path: path.join(__dirname, \"dist\"),\n    filename: \"[name].js\",\n  },\n  optimization: {\n    minimize: true,\n  },\n\n  // JUST KEEP THEM\n  mode: \"production\",\n  target: \"node\",\n  plugins: [\n    new CopyWebpackPlugin({\n      patterns: [\n        {\n          from: \".env\",\n          to: \"[name][ext]\",\n        },\n      ],\n    }),\n    new WriteFilePlugin(),\n    new IgnorePlugin({\n      checkResource: (resource) => {\n        if (lazyImports.some((modulo) => resource.startsWith(modulo))) {\n          try {\n            require.resolve(resource);\n          } catch (err) {\n            return true;\n          }\n        }\n        return false;\n      },\n    }),\n  ],\n};\n",
-    "pnpm-workspace.yaml": "packages:\n  - \"config\"\n  - \"packages/*\"\ncatalogs:\n  samchon:\n    \"@nestia/benchmark\": ^14.0.1\n    \"@nestia/core\": ^14.0.1\n    \"@nestia/e2e\": ^14.0.1\n    \"@nestia/fetcher\": ^14.0.1\n    \"@nestia/sdk\": ^14.0.1\n    nestia: ^14.0.1\n    tgrid: ^1.2.1\n    tstl: ^3.0.0\n    typia: 15.0.0\n  rolldown:\n    rolldown: ^1.1.5\n  utils:\n    rimraf: ^6.1.3\n    uuid: ^13.0.0\n  typescript:\n    \"@ttsc/lint\": ^0.18.2\n    \"@ttsc/paths\": ^0.18.2\n    \"@ttsc/unplugin\": ^0.28.1\n    ttsc: ^0.28.1\n    typescript: ^7.0.2\n",
+    "pnpm-workspace.yaml": "packages:\n  - \"config\"\n  - \"packages/*\"\ncatalogs:\n  samchon:\n    \"@nestia/benchmark\": ^14.0.3\n    \"@nestia/core\": ^14.0.3\n    \"@nestia/e2e\": ^14.0.3\n    \"@nestia/fetcher\": ^14.0.3\n    \"@nestia/sdk\": ^14.0.3\n    nestia: ^14.0.3\n    tgrid: ^1.2.1\n    tstl: ^3.0.0\n    typia: 15.0.0\n  rolldown:\n    rolldown: ^1.1.5\n  utils:\n    rimraf: ^6.1.3\n    uuid: ^13.0.0\n  typescript:\n    \"@ttsc/lint\": ^0.18.2\n    \"@ttsc/paths\": ^0.18.2\n    \"@ttsc/unplugin\": ^0.28.1\n    ttsc: ^0.28.1\n    typescript: ^7.0.2\n",
     "typos.toml": "[default]\nlocale = 'en-us'\nextend-ignore-re = [\n  \"(?Rm)^.*(<!--|#|//)\\\\s*spellchecker:disable-line(-->|\\n)?$\",\n  \"(?s)(<!--|#|//)\\\\s*spellchecker:off\\\\s*(-->|\\n).*?(<!--|#|//)\\\\s*spellchecker:on\",\n]\n\n[default.extend-words]\nJeongho = \"Jeongho\"\nNam = \"Nam\"\ntypia = \"typia\"\n\n[files]\nextend-exclude = [\"*.json\"]"
 };
 //# sourceMappingURL=NEST_TEMPLATE.js.map

package/lib/bundles/NEST_TEMPLATE.mjs

@@ -50,7 +50,7 @@ const NEST_TEMPLATE = {
 	"packages/backend/test/webpack.ts": "import { DynamicExecutor } from \"@nestia/e2e\";\nimport cp from \"node:child_process\";\nimport { sleep_for } from \"tstl\";\n\nimport { MyConfiguration } from \"../src/MyConfiguration\";\nimport { MyGlobal } from \"../src/MyGlobal\";\nimport { TestAutomation } from \"./helpers/TestAutomation\";\nimport { TestAutomationStdio } from \"./helpers/TestAutomationStdio\";\n\nconst wait = async (): Promise<void> => {\n  while (true)\n    try {\n      await fetch(`http://localhost:${MyConfiguration.API_PORT()}/dsafdsafsd`);\n      return;\n    } catch (exp) {\n      await sleep_for(100);\n    }\n};\n\nconst main = async (): Promise<void> => {\n  MyGlobal.testing = true;\n\n  const report: DynamicExecutor.IReport = await TestAutomation.execute({\n    open: async () => {\n      const backend: cp.ChildProcess = cp.fork(\n        `${MyConfiguration.ROOT}/dist/server.js`,\n        {\n          cwd: `${MyConfiguration.ROOT}/dist`,\n        },\n      );\n      await wait();\n      return backend;\n    },\n    close: async (backend) => {\n      backend.kill();\n    },\n    options: await TestAutomationStdio.getOptions(),\n    onComplete: TestAutomationStdio.onComplete,\n  });\n  TestAutomationStdio.report(report);\n};\nmain().catch((exp: unknown) => {\n  console.log(exp);\n  process.exit(-1);\n});\n",
 	"packages/backend/tsconfig.json": "{\n  \"extends\": \"../../config/tsconfig.json\",\n  \"compilerOptions\": {\n    \"outDir\": \"lib\",\n    \"rootDir\": \"src\",\n    \"experimentalDecorators\": true,\n    \"emitDecoratorMetadata\": true\n  },\n  \"include\": [\"src\"]\n}\n",
 	"packages/backend/webpack.config.js": "const path = require(\"path\");\n\nconst CopyWebpackPlugin = require(\"copy-webpack-plugin\");\nconst WriteFilePlugin = require(\"write-file-webpack-plugin\");\nconst { IgnorePlugin } = require(\"webpack\");\n\nconst lazyImports = [\n  \"@modelcontextprotocol/sdk\",\n  \"@fastify/static\",\n  \"@fastify/view\",\n  \"@nestjs/microservices\",\n  \"@nestjs/websockets\",\n  \"class-transformer\",\n  \"class-validator\",\n];\n\n// @reference https://tech-blog.s-yoshiki.com/entry/297\nmodule.exports = {\n  // CUSTOMIZE HERE\n  entry: {\n    server: \"./lib/executable/server.js\",\n  },\n  output: {\n    path: path.join(__dirname, \"dist\"),\n    filename: \"[name].js\",\n  },\n  optimization: {\n    minimize: true,\n  },\n\n  // JUST KEEP THEM\n  mode: \"production\",\n  target: \"node\",\n  plugins: [\n    new CopyWebpackPlugin({\n      patterns: [\n        {\n          from: \".env\",\n          to: \"[name][ext]\",\n        },\n      ],\n    }),\n    new WriteFilePlugin(),\n    new IgnorePlugin({\n      checkResource: (resource) => {\n        if (lazyImports.some((modulo) => resource.startsWith(modulo))) {\n          try {\n            require.resolve(resource);\n          } catch (err) {\n            return true;\n          }\n        }\n        return false;\n      },\n    }),\n  ],\n};\n",
-	"pnpm-workspace.yaml": "packages:\n  - \"config\"\n  - \"packages/*\"\ncatalogs:\n  samchon:\n    \"@nestia/benchmark\": ^14.0.1\n    \"@nestia/core\": ^14.0.1\n    \"@nestia/e2e\": ^14.0.1\n    \"@nestia/fetcher\": ^14.0.1\n    \"@nestia/sdk\": ^14.0.1\n    nestia: ^14.0.1\n    tgrid: ^1.2.1\n    tstl: ^3.0.0\n    typia: 15.0.0\n  rolldown:\n    rolldown: ^1.1.5\n  utils:\n    rimraf: ^6.1.3\n    uuid: ^13.0.0\n  typescript:\n    \"@ttsc/lint\": ^0.18.2\n    \"@ttsc/paths\": ^0.18.2\n    \"@ttsc/unplugin\": ^0.28.1\n    ttsc: ^0.28.1\n    typescript: ^7.0.2\n",
+	"pnpm-workspace.yaml": "packages:\n  - \"config\"\n  - \"packages/*\"\ncatalogs:\n  samchon:\n    \"@nestia/benchmark\": ^14.0.3\n    \"@nestia/core\": ^14.0.3\n    \"@nestia/e2e\": ^14.0.3\n    \"@nestia/fetcher\": ^14.0.3\n    \"@nestia/sdk\": ^14.0.3\n    nestia: ^14.0.3\n    tgrid: ^1.2.1\n    tstl: ^3.0.0\n    typia: 15.0.0\n  rolldown:\n    rolldown: ^1.1.5\n  utils:\n    rimraf: ^6.1.3\n    uuid: ^13.0.0\n  typescript:\n    \"@ttsc/lint\": ^0.18.2\n    \"@ttsc/paths\": ^0.18.2\n    \"@ttsc/unplugin\": ^0.28.1\n    ttsc: ^0.28.1\n    typescript: ^7.0.2\n",
 	"typos.toml": "[default]\nlocale = 'en-us'\nextend-ignore-re = [\n  \"(?Rm)^.*(<!--|#|//)\\\\s*spellchecker:disable-line(-->|\\n)?$\",\n  \"(?s)(<!--|#|//)\\\\s*spellchecker:off\\\\s*(-->|\\n).*?(<!--|#|//)\\\\s*spellchecker:on\",\n]\n\n[default.extend-words]\nJeongho = \"Jeongho\"\nNam = \"Nam\"\ntypia = \"typia\"\n\n[files]\nextend-exclude = [\"*.json\"]"
 };
 //#endregion

package/lib/bundles/SDK_TEMPLATE.js

@@ -8,7 +8,7 @@ exports.SDK_TEMPLATE = {
     "LICENSE": "MIT License\n\nCopyright (c) 2024 Jeongho Nam\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n",
     "README.md": "# Software Development Kit\nThis is a SDK library generated by [`@nestia/migrate`](https://nestia.io/docs/migrate) or [`@nestia/editor`](https://nestia.io/docs/editor).\n\nWith this SDK library, you can easily and safely interact with backend server.\n\nJust import and call some API functions like gif image below:\n\n![nestia-sdk-demo](https://user-images.githubusercontent.com/13158709/215004990-368c589d-7101-404e-b81b-fbc936382f05.gif)\n\n> Left is server code, and right is client code utilizing the SDK\n\n\n\n\n## How to Test\n```bash\npnpm install\npnpm run start # run only \"test/start.ts\" file\npnpm run test # everything under the \"test/features\" directory\npnpm run test:simulate # \"test/features\" with mockup simulation mode\n```\n\nIf you run `pnpm run start` command, only [test/start.ts](test/start.ts) file would be executed.\n\nOtherwise you run `pnpm run test` command instead, run everything in the [test/features](test/features) directory.\n\nFor reference, the [test/features](test/features) directory and E2E test functions (for each API endpoints) would be automatically composed only when you've configured the \"E2E test function generation mode\" of the `@nestia/migrate` (or `@nestia/editor`).\n\n```bash\npnpm dlx @nestia/migrate\n? Migration mode (Use arrow keys):\n    NestJS\n  > SDK\n? Swagger file location: assets/input/clickhouse.json\n? Output directory path: assets/output/clickhouse-sdk-manual\n? Mokup Simulator: true\n? E2E Test Functions: true\n```\n\n\n\n\n## Deploy\n```bash\npnpm install\npnpm run deploy\n```\n\nJust run `pnpm run deploy` command, then your SDK library would be published.\n\nBy the way, the initial package name of this template repository is `@ORGANIZATION/PROJECT-api`. I think it would better to change the word to your own organization and project name. If you're utilizing `VsCode`, you can do it through `Edit > Replace in Files` (*Ctrl + Shift + H*) feature.\n\n-----------\n\n> ## What [`Nestia`](https://nestia.io) is:\n> ![Nestia Logo](https://nestia.io/logo.png)\n> \n> [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/nestia/blob/master/LICENSE)\n> [![npm version](https://img.shields.io/npm/v/@nestia/core.svg)](https://www.npmjs.com/package/@nestia/core)\n> [![Downloads](https://img.shields.io/npm/dm/@nestia/core.svg)](https://www.npmjs.com/package/@nestia/core)\n> [![Build Status](https://github.com/samchon/nestia/workflows/build/badge.svg)](https://github.com/samchon/nestia/actions?query=workflow%3Abuild)\n> [![Guide Documents](https://img.shields.io/badge/guide-documents-forestgreen)](https://nestia.io/docs/)\n> \n> Nestia is a set of helper libraries for NestJS, supporting below features:\n> \n>   - `@nestia/core`: Super-fast decorators\n>   - `@nestia/sdk`:\n>     - Swagger generator evolved than ever\n>     - SDK library generator for clients\n>     - Mockup Simulator for client applications\n>     - Automatic E2E test functions generator\n>   - `@nestia/migrate`: Migration from Swagger to NestJS\n>   - `@nestia/editor`: Online TypeScript Swagger Editor\n>   - `nestia`: Just CLI (command line interface) tool\n> \n>> **Note**\n>> \n>> - **Only one line** required, with pure TypeScript type\n>> - Enhance performance **30x** up\n>>   - Runtime validator is **20,000x faster** than `class-validator`\n>>   - JSON serialization is **200x faster** than `class-transformer`\n>> - Software Development Kit\n>>   - SDK is a collection of `fetch` functions with type definitions like [tRPC](https://> trpc.io/)\n>>   - Mockup simulator means embedded backend simulator in SDK\n>>     - similar with [msw](https://mswjs.io/), but fully automated\n",
     "hello.js": "function print(command, description) {\n  return console.log(`\\x1b[1m${command}\\x1b[2m: ${description}\\x1b[0m`);\n}\n\nconsole.log(\"-----------------------------------------\");\nconsole.log(\"\\x1b[7mGenerated by \\x1b[2m@nestia/editor\\x1b[0m\");\nconsole.log(\"\");\nconsole.log(\" - \\x1b[36mhttps://nestia.io/docs/editor\\x1b[0m\");\nconsole.log(\" - \\x1b[36mhttps://github.com/samchon/nestia\\x1b[0m\");\nconsole.log(\"-----------------------------------------\");\n\nprint(\"pnpm run start\", \"Run only test/start.ts\");\nprint(\"pnpm run test\", \"Run every test/features/**/*.ts files\");\nprint(\"pnpm run test:simulate\", \"Test with mockup simulator\");\n",
-    "package.json": "{\n  \"name\": \"@ORGANIZATION/PROJECT-api\",\n  \"version\": \"0.1.0\",\n  \"description\": \"SDK library generated by Nestia\",\n  \"main\": \"src/index.ts\",\n  \"exports\": {\n    \".\": \"./src/index.ts\",\n    \"./lib/*\": \"./src/*.ts\",\n    \"./package.json\": \"./package.json\"\n  },\n  \"publishConfig\": {\n    \"main\": \"lib/index.mjs\",\n    \"module\": \"lib/index.mjs\",\n    \"types\": \"lib/index.d.ts\",\n    \"exports\": {\n      \".\": {\n        \"types\": \"./lib/index.d.ts\",\n        \"import\": \"./lib/index.mjs\",\n        \"default\": \"./lib/index.js\"\n      },\n      \"./lib/*\": {\n        \"types\": \"./lib/*.d.ts\",\n        \"import\": \"./lib/*.mjs\",\n        \"default\": \"./lib/*.js\"\n      },\n      \"./package.json\": \"./package.json\"\n    }\n  },\n  \"scripts\": {\n    \"build\": \"rimraf lib && ttsc && rolldown -c\",\n    \"build:test\": \"rimraf bin && ttsc --project test/tsconfig.json\",\n    \"deploy\": \"pnpm run build && pnpm publish\",\n    \"dev\": \"pnpm run build:test --watch\",\n    \"hello\": \"node hello\",\n    \"start\": \"ttsx test/start.ts\",\n    \"swagger\": \"ttsx test/swagger.ts\",\n    \"test\": \"ttsx test/index.ts\",\n    \"test:simulate\": \"ttsx test/index.ts --simulate true\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/samchon/nestia\"\n  },\n  \"author\": \"Jeongho Nam\",\n  \"license\": \"MIT\",\n  \"bugs\": {\n    \"url\": \"https://github.com/samchon/nestia/issues\"\n  },\n  \"homepage\": \"https://nestia.io\",\n  \"files\": [\n    \"lib\",\n    \"swagger.json\",\n    \"package.json\",\n    \"README.md\"\n  ],\n  \"dependencies\": {\n    \"@nestia/fetcher\": \"^14.0.1\",\n    \"tgrid\": \"^1.2.1\",\n    \"typia\": \"15.0.0\"\n  },\n  \"devDependencies\": {\n    \"@nestia/e2e\": \"^14.0.1\",\n    \"@ttsc/unplugin\": \"^0.28.1\",\n    \"@types/express\": \"^4.17.21\",\n    \"@types/swagger-ui-express\": \"^4.1.6\",\n    \"chalk\": \"4.1.2\",\n    \"express\": \"^4.19.2\",\n    \"rimraf\": \"^5.0.5\",\n    \"rolldown\": \"^1.1.5\",\n    \"swagger-ui-express\": \"^5.0.0\",\n    \"tinyglobby\": \"^0.2.17\",\n    \"ttsc\": \"^0.28.1\",\n    \"typescript\": \"^7.0.2\",\n    \"@nestia/core\": \"^14.0.1\"\n  },\n  \"packageManager\": \"pnpm@10.19.0\"\n}",
+    "package.json": "{\n  \"name\": \"@ORGANIZATION/PROJECT-api\",\n  \"version\": \"0.1.0\",\n  \"description\": \"SDK library generated by Nestia\",\n  \"main\": \"src/index.ts\",\n  \"exports\": {\n    \".\": \"./src/index.ts\",\n    \"./lib/*\": \"./src/*.ts\",\n    \"./package.json\": \"./package.json\"\n  },\n  \"publishConfig\": {\n    \"main\": \"lib/index.mjs\",\n    \"module\": \"lib/index.mjs\",\n    \"types\": \"lib/index.d.ts\",\n    \"exports\": {\n      \".\": {\n        \"types\": \"./lib/index.d.ts\",\n        \"import\": \"./lib/index.mjs\",\n        \"default\": \"./lib/index.js\"\n      },\n      \"./lib/*\": {\n        \"types\": \"./lib/*.d.ts\",\n        \"import\": \"./lib/*.mjs\",\n        \"default\": \"./lib/*.js\"\n      },\n      \"./package.json\": \"./package.json\"\n    }\n  },\n  \"scripts\": {\n    \"build\": \"rimraf lib && ttsc && rolldown -c\",\n    \"build:test\": \"rimraf bin && ttsc --project test/tsconfig.json\",\n    \"deploy\": \"pnpm run build && pnpm publish\",\n    \"dev\": \"pnpm run build:test --watch\",\n    \"hello\": \"node hello\",\n    \"start\": \"ttsx test/start.ts\",\n    \"swagger\": \"ttsx test/swagger.ts\",\n    \"test\": \"ttsx test/index.ts\",\n    \"test:simulate\": \"ttsx test/index.ts --simulate true\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/samchon/nestia\"\n  },\n  \"author\": \"Jeongho Nam\",\n  \"license\": \"MIT\",\n  \"bugs\": {\n    \"url\": \"https://github.com/samchon/nestia/issues\"\n  },\n  \"homepage\": \"https://nestia.io\",\n  \"files\": [\n    \"lib\",\n    \"swagger.json\",\n    \"package.json\",\n    \"README.md\"\n  ],\n  \"dependencies\": {\n    \"@nestia/fetcher\": \"^14.0.3\",\n    \"tgrid\": \"^1.2.1\",\n    \"typia\": \"15.0.0\"\n  },\n  \"devDependencies\": {\n    \"@nestia/e2e\": \"^14.0.3\",\n    \"@ttsc/unplugin\": \"^0.28.1\",\n    \"@types/express\": \"^4.17.21\",\n    \"@types/swagger-ui-express\": \"^4.1.6\",\n    \"chalk\": \"4.1.2\",\n    \"express\": \"^4.19.2\",\n    \"rimraf\": \"^5.0.5\",\n    \"rolldown\": \"^1.1.5\",\n    \"swagger-ui-express\": \"^5.0.0\",\n    \"tinyglobby\": \"^0.2.17\",\n    \"ttsc\": \"^0.28.1\",\n    \"typescript\": \"^7.0.2\",\n    \"@nestia/core\": \"^14.0.3\"\n  },\n  \"packageManager\": \"pnpm@10.19.0\"\n}",
     "rolldown.config.mjs": "import ttsc from \"@ttsc/unplugin/rolldown\";\nimport path from \"node:path\";\nimport { globSync } from \"tinyglobby\";\n\nexport default {\n  input: globSync(\"./src/**/*.ts\"),\n  external: (id) => !id.startsWith(\".\") && !path.isAbsolute(id),\n  output: {\n    dir: \"./lib\",\n    format: \"esm\",\n    sourcemap: true,\n    entryFileNames: \"[name].mjs\",\n    preserveModules: true,\n    preserveModulesRoot: \"src\",\n  },\n  plugins: [ttsc()],\n};\n",
     "src/HttpError.ts": "export { HttpError } from \"@nestia/fetcher\";\n",
     "src/IConnection.ts": "export type { IConnection } from \"@nestia/fetcher\";\n",

package/lib/bundles/SDK_TEMPLATE.mjs

@@ -6,7 +6,7 @@ const SDK_TEMPLATE = {
 	"LICENSE": "MIT License\n\nCopyright (c) 2024 Jeongho Nam\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n",
 	"README.md": "# Software Development Kit\nThis is a SDK library generated by [`@nestia/migrate`](https://nestia.io/docs/migrate) or [`@nestia/editor`](https://nestia.io/docs/editor).\n\nWith this SDK library, you can easily and safely interact with backend server.\n\nJust import and call some API functions like gif image below:\n\n![nestia-sdk-demo](https://user-images.githubusercontent.com/13158709/215004990-368c589d-7101-404e-b81b-fbc936382f05.gif)\n\n> Left is server code, and right is client code utilizing the SDK\n\n\n\n\n## How to Test\n```bash\npnpm install\npnpm run start # run only \"test/start.ts\" file\npnpm run test # everything under the \"test/features\" directory\npnpm run test:simulate # \"test/features\" with mockup simulation mode\n```\n\nIf you run `pnpm run start` command, only [test/start.ts](test/start.ts) file would be executed.\n\nOtherwise you run `pnpm run test` command instead, run everything in the [test/features](test/features) directory.\n\nFor reference, the [test/features](test/features) directory and E2E test functions (for each API endpoints) would be automatically composed only when you've configured the \"E2E test function generation mode\" of the `@nestia/migrate` (or `@nestia/editor`).\n\n```bash\npnpm dlx @nestia/migrate\n? Migration mode (Use arrow keys):\n    NestJS\n  > SDK\n? Swagger file location: assets/input/clickhouse.json\n? Output directory path: assets/output/clickhouse-sdk-manual\n? Mokup Simulator: true\n? E2E Test Functions: true\n```\n\n\n\n\n## Deploy\n```bash\npnpm install\npnpm run deploy\n```\n\nJust run `pnpm run deploy` command, then your SDK library would be published.\n\nBy the way, the initial package name of this template repository is `@ORGANIZATION/PROJECT-api`. I think it would better to change the word to your own organization and project name. If you're utilizing `VsCode`, you can do it through `Edit > Replace in Files` (*Ctrl + Shift + H*) feature.\n\n-----------\n\n> ## What [`Nestia`](https://nestia.io) is:\n> ![Nestia Logo](https://nestia.io/logo.png)\n> \n> [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/nestia/blob/master/LICENSE)\n> [![npm version](https://img.shields.io/npm/v/@nestia/core.svg)](https://www.npmjs.com/package/@nestia/core)\n> [![Downloads](https://img.shields.io/npm/dm/@nestia/core.svg)](https://www.npmjs.com/package/@nestia/core)\n> [![Build Status](https://github.com/samchon/nestia/workflows/build/badge.svg)](https://github.com/samchon/nestia/actions?query=workflow%3Abuild)\n> [![Guide Documents](https://img.shields.io/badge/guide-documents-forestgreen)](https://nestia.io/docs/)\n> \n> Nestia is a set of helper libraries for NestJS, supporting below features:\n> \n>   - `@nestia/core`: Super-fast decorators\n>   - `@nestia/sdk`:\n>     - Swagger generator evolved than ever\n>     - SDK library generator for clients\n>     - Mockup Simulator for client applications\n>     - Automatic E2E test functions generator\n>   - `@nestia/migrate`: Migration from Swagger to NestJS\n>   - `@nestia/editor`: Online TypeScript Swagger Editor\n>   - `nestia`: Just CLI (command line interface) tool\n> \n>> **Note**\n>> \n>> - **Only one line** required, with pure TypeScript type\n>> - Enhance performance **30x** up\n>>   - Runtime validator is **20,000x faster** than `class-validator`\n>>   - JSON serialization is **200x faster** than `class-transformer`\n>> - Software Development Kit\n>>   - SDK is a collection of `fetch` functions with type definitions like [tRPC](https://> trpc.io/)\n>>   - Mockup simulator means embedded backend simulator in SDK\n>>     - similar with [msw](https://mswjs.io/), but fully automated\n",
 	"hello.js": "function print(command, description) {\n  return console.log(`\\x1b[1m${command}\\x1b[2m: ${description}\\x1b[0m`);\n}\n\nconsole.log(\"-----------------------------------------\");\nconsole.log(\"\\x1b[7mGenerated by \\x1b[2m@nestia/editor\\x1b[0m\");\nconsole.log(\"\");\nconsole.log(\" - \\x1b[36mhttps://nestia.io/docs/editor\\x1b[0m\");\nconsole.log(\" - \\x1b[36mhttps://github.com/samchon/nestia\\x1b[0m\");\nconsole.log(\"-----------------------------------------\");\n\nprint(\"pnpm run start\", \"Run only test/start.ts\");\nprint(\"pnpm run test\", \"Run every test/features/**/*.ts files\");\nprint(\"pnpm run test:simulate\", \"Test with mockup simulator\");\n",
-	"package.json": "{\n  \"name\": \"@ORGANIZATION/PROJECT-api\",\n  \"version\": \"0.1.0\",\n  \"description\": \"SDK library generated by Nestia\",\n  \"main\": \"src/index.ts\",\n  \"exports\": {\n    \".\": \"./src/index.ts\",\n    \"./lib/*\": \"./src/*.ts\",\n    \"./package.json\": \"./package.json\"\n  },\n  \"publishConfig\": {\n    \"main\": \"lib/index.mjs\",\n    \"module\": \"lib/index.mjs\",\n    \"types\": \"lib/index.d.ts\",\n    \"exports\": {\n      \".\": {\n        \"types\": \"./lib/index.d.ts\",\n        \"import\": \"./lib/index.mjs\",\n        \"default\": \"./lib/index.js\"\n      },\n      \"./lib/*\": {\n        \"types\": \"./lib/*.d.ts\",\n        \"import\": \"./lib/*.mjs\",\n        \"default\": \"./lib/*.js\"\n      },\n      \"./package.json\": \"./package.json\"\n    }\n  },\n  \"scripts\": {\n    \"build\": \"rimraf lib && ttsc && rolldown -c\",\n    \"build:test\": \"rimraf bin && ttsc --project test/tsconfig.json\",\n    \"deploy\": \"pnpm run build && pnpm publish\",\n    \"dev\": \"pnpm run build:test --watch\",\n    \"hello\": \"node hello\",\n    \"start\": \"ttsx test/start.ts\",\n    \"swagger\": \"ttsx test/swagger.ts\",\n    \"test\": \"ttsx test/index.ts\",\n    \"test:simulate\": \"ttsx test/index.ts --simulate true\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/samchon/nestia\"\n  },\n  \"author\": \"Jeongho Nam\",\n  \"license\": \"MIT\",\n  \"bugs\": {\n    \"url\": \"https://github.com/samchon/nestia/issues\"\n  },\n  \"homepage\": \"https://nestia.io\",\n  \"files\": [\n    \"lib\",\n    \"swagger.json\",\n    \"package.json\",\n    \"README.md\"\n  ],\n  \"dependencies\": {\n    \"@nestia/fetcher\": \"^14.0.1\",\n    \"tgrid\": \"^1.2.1\",\n    \"typia\": \"15.0.0\"\n  },\n  \"devDependencies\": {\n    \"@nestia/e2e\": \"^14.0.1\",\n    \"@ttsc/unplugin\": \"^0.28.1\",\n    \"@types/express\": \"^4.17.21\",\n    \"@types/swagger-ui-express\": \"^4.1.6\",\n    \"chalk\": \"4.1.2\",\n    \"express\": \"^4.19.2\",\n    \"rimraf\": \"^5.0.5\",\n    \"rolldown\": \"^1.1.5\",\n    \"swagger-ui-express\": \"^5.0.0\",\n    \"tinyglobby\": \"^0.2.17\",\n    \"ttsc\": \"^0.28.1\",\n    \"typescript\": \"^7.0.2\",\n    \"@nestia/core\": \"^14.0.1\"\n  },\n  \"packageManager\": \"pnpm@10.19.0\"\n}",
+	"package.json": "{\n  \"name\": \"@ORGANIZATION/PROJECT-api\",\n  \"version\": \"0.1.0\",\n  \"description\": \"SDK library generated by Nestia\",\n  \"main\": \"src/index.ts\",\n  \"exports\": {\n    \".\": \"./src/index.ts\",\n    \"./lib/*\": \"./src/*.ts\",\n    \"./package.json\": \"./package.json\"\n  },\n  \"publishConfig\": {\n    \"main\": \"lib/index.mjs\",\n    \"module\": \"lib/index.mjs\",\n    \"types\": \"lib/index.d.ts\",\n    \"exports\": {\n      \".\": {\n        \"types\": \"./lib/index.d.ts\",\n        \"import\": \"./lib/index.mjs\",\n        \"default\": \"./lib/index.js\"\n      },\n      \"./lib/*\": {\n        \"types\": \"./lib/*.d.ts\",\n        \"import\": \"./lib/*.mjs\",\n        \"default\": \"./lib/*.js\"\n      },\n      \"./package.json\": \"./package.json\"\n    }\n  },\n  \"scripts\": {\n    \"build\": \"rimraf lib && ttsc && rolldown -c\",\n    \"build:test\": \"rimraf bin && ttsc --project test/tsconfig.json\",\n    \"deploy\": \"pnpm run build && pnpm publish\",\n    \"dev\": \"pnpm run build:test --watch\",\n    \"hello\": \"node hello\",\n    \"start\": \"ttsx test/start.ts\",\n    \"swagger\": \"ttsx test/swagger.ts\",\n    \"test\": \"ttsx test/index.ts\",\n    \"test:simulate\": \"ttsx test/index.ts --simulate true\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/samchon/nestia\"\n  },\n  \"author\": \"Jeongho Nam\",\n  \"license\": \"MIT\",\n  \"bugs\": {\n    \"url\": \"https://github.com/samchon/nestia/issues\"\n  },\n  \"homepage\": \"https://nestia.io\",\n  \"files\": [\n    \"lib\",\n    \"swagger.json\",\n    \"package.json\",\n    \"README.md\"\n  ],\n  \"dependencies\": {\n    \"@nestia/fetcher\": \"^14.0.3\",\n    \"tgrid\": \"^1.2.1\",\n    \"typia\": \"15.0.0\"\n  },\n  \"devDependencies\": {\n    \"@nestia/e2e\": \"^14.0.3\",\n    \"@ttsc/unplugin\": \"^0.28.1\",\n    \"@types/express\": \"^4.17.21\",\n    \"@types/swagger-ui-express\": \"^4.1.6\",\n    \"chalk\": \"4.1.2\",\n    \"express\": \"^4.19.2\",\n    \"rimraf\": \"^5.0.5\",\n    \"rolldown\": \"^1.1.5\",\n    \"swagger-ui-express\": \"^5.0.0\",\n    \"tinyglobby\": \"^0.2.17\",\n    \"ttsc\": \"^0.28.1\",\n    \"typescript\": \"^7.0.2\",\n    \"@nestia/core\": \"^14.0.3\"\n  },\n  \"packageManager\": \"pnpm@10.19.0\"\n}",
 	"rolldown.config.mjs": "import ttsc from \"@ttsc/unplugin/rolldown\";\nimport path from \"node:path\";\nimport { globSync } from \"tinyglobby\";\n\nexport default {\n  input: globSync(\"./src/**/*.ts\"),\n  external: (id) => !id.startsWith(\".\") && !path.isAbsolute(id),\n  output: {\n    dir: \"./lib\",\n    format: \"esm\",\n    sourcemap: true,\n    entryFileNames: \"[name].mjs\",\n    preserveModules: true,\n    preserveModulesRoot: \"src\",\n  },\n  plugins: [ttsc()],\n};\n",
 	"src/HttpError.ts": "export { HttpError } from \"@nestia/fetcher\";\n",
 	"src/IConnection.ts": "export type { IConnection } from \"@nestia/fetcher\";\n",

package/lib/executable/NestiaMigrateCommander.d.ts

@@ -1,3 +1,41 @@
+/**
+ * The command-line entry of `@nestia/migrate`.
+ *
+ * The output path is resolved with `path.resolve` and its parent tested with
+ * `existsSync` and `statSync`, with backslashes converted to `/`, which Windows
+ * accepts. The input is fetched when it parses as an http or https URL, so a
+ * Windows path whose drive letter parses as a scheme is read from disk, and it
+ * is read as UTF-8 otherwise. Only files with a `.ts`, `.cts`, `.mts` or `.tsx`
+ * extension, tested case-sensitively, are formatted, and text is written
+ * without a byte order mark and with the line endings the generator and
+ * Prettier produce, which are not the platform's. A failure ends the process
+ * through `process.exit(-1)`, whose status the platform truncates to a non-zero
+ * value.
+ *
+ * @evidence contracts/common.md#principled-implementation The command reads the options, validates the output directory, reads the document from a file or an http(s) URL, converts it, reports the operations that could not be migrated, and writes the files, formatting only TypeScript files.
+ * @evidence contracts/common.md#clear-and-simple-design One entry function, with formatting, halting, and URL detection as private helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Every failure ends with a message and a non-zero exit, and unformattable content is written unformatted.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ */
 export declare namespace NestiaMigrateCommander {
-    const main: () => Promise<void>;
+    /**
+     * Runs the command: reads the options and the document, generates the
+     * project, and writes it to the output directory.
+     *
+     * It stops with an error when the output directory exists, when its parent
+     * does not exist or is not a directory, when the input cannot be read or
+     * fetched, or when the document is invalid. Explicit arguments follow Node's
+     * executable/script/flags layout; omitting them reads the current process
+     * arguments.
+     *
+     * Creation and writing use `fs.promises` through the injected archiver, so
+     * the volume decides case policy and permissions, and the checks that precede
+     * any write are the filesystem's own answers.
+     *
+     * @evidence contracts/common.md#principled-implementation The checks run before any file is written, the document is fetched only for an http or https URL, a failed HTTP status stops the command, and only files with a TypeScript extension are formatted, because Prettier's TypeScript parser would rewrite a dotfile line into code.
+     * @evidence contracts/common.md#clear-and-simple-design One asynchronous function whose phases are marked in comments, with the option parsing in `NestiaMigrateInquirer`.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The checks apply to every input, and a formatting failure keeps the original text.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the conditions under which it stops.
+     */
+    const main: (argv?: string[]) => Promise<void>;
 }

package/lib/executable/NestiaMigrateCommander.js

@@ -54,11 +54,49 @@ const prettierPluginJsDoc = __importStar(require("prettier-plugin-jsdoc"));
 const NestiaMigrateApplication_1 = require("../NestiaMigrateApplication");
 const NestiaMigrateFileArchiver_1 = require("../archivers/NestiaMigrateFileArchiver");
 const NestiaMigrateInquirer_1 = require("./NestiaMigrateInquirer");
+/**
+ * The command-line entry of `@nestia/migrate`.
+ *
+ * The output path is resolved with `path.resolve` and its parent tested with
+ * `existsSync` and `statSync`, with backslashes converted to `/`, which Windows
+ * accepts. The input is fetched when it parses as an http or https URL, so a
+ * Windows path whose drive letter parses as a scheme is read from disk, and it
+ * is read as UTF-8 otherwise. Only files with a `.ts`, `.cts`, `.mts` or `.tsx`
+ * extension, tested case-sensitively, are formatted, and text is written
+ * without a byte order mark and with the line endings the generator and
+ * Prettier produce, which are not the platform's. A failure ends the process
+ * through `process.exit(-1)`, whose status the platform truncates to a non-zero
+ * value.
+ *
+ * @evidence contracts/common.md#principled-implementation The command reads the options, validates the output directory, reads the document from a file or an http(s) URL, converts it, reports the operations that could not be migrated, and writes the files, formatting only TypeScript files.
+ * @evidence contracts/common.md#clear-and-simple-design One entry function, with formatting, halting, and URL detection as private helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Every failure ends with a message and a non-zero exit, and unformattable content is written unformatted.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ */
 var NestiaMigrateCommander;
 (function (NestiaMigrateCommander) {
-    NestiaMigrateCommander.main = () => __awaiter(this, void 0, void 0, function* () {
+    /**
+     * Runs the command: reads the options and the document, generates the
+     * project, and writes it to the output directory.
+     *
+     * It stops with an error when the output directory exists, when its parent
+     * does not exist or is not a directory, when the input cannot be read or
+     * fetched, or when the document is invalid. Explicit arguments follow Node's
+     * executable/script/flags layout; omitting them reads the current process
+     * arguments.
+     *
+     * Creation and writing use `fs.promises` through the injected archiver, so
+     * the volume decides case policy and permissions, and the checks that precede
+     * any write are the filesystem's own answers.
+     *
+     * @evidence contracts/common.md#principled-implementation The checks run before any file is written, the document is fetched only for an http or https URL, a failed HTTP status stops the command, and only files with a TypeScript extension are formatted, because Prettier's TypeScript parser would rewrite a dotfile line into code.
+     * @evidence contracts/common.md#clear-and-simple-design One asynchronous function whose phases are marked in comments, with the option parsing in `NestiaMigrateInquirer`.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The checks apply to every input, and a formatting failure keeps the original text.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the conditions under which it stops.
+     */
+    NestiaMigrateCommander.main = (argv) => __awaiter(this, void 0, void 0, function* () {
         const resolve = (str) => str ? path_1.default.resolve(str).split("\\").join("/") : undefined;
-        const options = yield NestiaMigrateInquirer_1.NestiaMigrateInquirer.parse();
+        const options = yield NestiaMigrateInquirer_1.NestiaMigrateInquirer.parse(argv);
         // VALIDATE OUTPUT DIRECTORY
         const parent = resolve(options.output + "/..");
         if (fs_1.default.existsSync(options.output))
@@ -71,6 +109,8 @@ var NestiaMigrateCommander;
         const document = yield (() => __awaiter(this, void 0, void 0, function* () {
             if (isUri(options.input)) {
                 const response = yield fetch(options.input);
+                if (response.ok === false)
+                    halt(`Unable to fetch the input swagger.json: ${response.status} ${response.statusText}`);
                 const content = yield response.text();
                 return JSON.parse(content);
             }

package/lib/executable/NestiaMigrateCommander.js.map

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

package/lib/executable/NestiaMigrateCommander.mjs

@@ -9,16 +9,18 @@ import * as prettierPluginJsDoc from "prettier-plugin-jsdoc";
 //#region src/executable/NestiaMigrateCommander.ts
 let NestiaMigrateCommander;
 (function(_NestiaMigrateCommander) {
-	_NestiaMigrateCommander.main = async () => {
+	_NestiaMigrateCommander.main = async (argv) => {
 		const resolve = (str) => str ? path.resolve(str).split("\\").join("/") : void 0;
-		const options = await NestiaMigrateInquirer.parse();
+		const options = await NestiaMigrateInquirer.parse(argv);
 		const parent = resolve(options.output + "/..");
 		if (fs.existsSync(options.output)) halt("Response directory already exists.");
 		else if (fs.existsSync(parent) === false) halt("Response directory's parent directory does not exist.");
 		else if (fs.statSync(parent).isDirectory() === false) halt("Response directory's parent is not a directory.");
 		const document = await (async () => {
 			if (isUri(options.input)) {
-				const content = await (await fetch(options.input)).text();
+				const response = await fetch(options.input);
+				if (response.ok === false) halt(`Unable to fetch the input swagger.json: ${response.status} ${response.statusText}`);
+				const content = await response.text();
 				return JSON.parse(content);
 			}
 			if (fs.existsSync(options.input) === false) halt("Unable to find the input swagger.json file.");

package/lib/executable/NestiaMigrateInquirer.d.ts

@@ -1,4 +1,22 @@
+/**
+ * Reads the options of the command from flags, asking interactively for what is
+ * missing.
+ *
+ * @evidence contracts/common.md#principled-implementation Each option is taken from its flag when given, and asked with a prompt otherwise, so the same command runs non-interactively when every flag is present.
+ * @evidence contracts/common.md#clear-and-simple-design One function and the output type; the prompt helpers are local.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The prompts are the standard `inquirer` ones, and a flag always wins over a prompt.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ */
 export declare namespace NestiaMigrateInquirer {
+    /**
+     * The options of the command: the mode, the input and output locations, the
+     * flags, and the package name.
+     *
+     * @evidence contracts/common.md#principled-implementation The record holds the answers needed to run the migration, each as a value and not as an optional.
+     * @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 options.
+     */
     interface IOutput {
         mode: "nest" | "sdk";
         input: string;
@@ -8,5 +26,18 @@ export declare namespace NestiaMigrateInquirer {
         e2e: boolean;
         package: string;
     }
-    const parse: () => Promise<IOutput>;
+    /**
+     * Parses the flags and asks for the missing options.
+     *
+     * A boolean flag given without a value is `true`, and one given a value is
+     * true only for the text `true`. Each invocation owns its parser; explicit
+     * arguments use Node's executable/script/flags layout and default to the
+     * current process arguments.
+     *
+     * @evidence contracts/common.md#principled-implementation A fresh Commander parser interprets the supplied Node-style arguments, the action asks a prompt for each undefined option, and boolean flags are normalized by one rule, so the result has every field set without retaining another invocation's options.
+     * @evidence contracts/common.md#clear-and-simple-design One invocation owns the parser and prompt action; the optional argument vector defaults to the ordinary process input.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It asks only for what is missing.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the boolean flag rule.
+     */
+    const parse: (argv?: string[]) => Promise<IOutput>;
 }

package/lib/executable/NestiaMigrateInquirer.js

@@ -12,21 +12,44 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NestiaMigrateInquirer = void 0;
 const commander_1 = require("commander");
 const inquirer_1 = require("inquirer");
+/**
+ * Reads the options of the command from flags, asking interactively for what is
+ * missing.
+ *
+ * @evidence contracts/common.md#principled-implementation Each option is taken from its flag when given, and asked with a prompt otherwise, so the same command runs non-interactively when every flag is present.
+ * @evidence contracts/common.md#clear-and-simple-design One function and the output type; the prompt helpers are local.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The prompts are the standard `inquirer` ones, and a flag always wins over a prompt.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ */
 var NestiaMigrateInquirer;
 (function (NestiaMigrateInquirer) {
-    NestiaMigrateInquirer.parse = () => __awaiter(this, void 0, void 0, function* () {
+    /**
+     * Parses the flags and asks for the missing options.
+     *
+     * A boolean flag given without a value is `true`, and one given a value is
+     * true only for the text `true`. Each invocation owns its parser; explicit
+     * arguments use Node's executable/script/flags layout and default to the
+     * current process arguments.
+     *
+     * @evidence contracts/common.md#principled-implementation A fresh Commander parser interprets the supplied Node-style arguments, the action asks a prompt for each undefined option, and boolean flags are normalized by one rule, so the result has every field set without retaining another invocation's options.
+     * @evidence contracts/common.md#clear-and-simple-design One invocation owns the parser and prompt action; the optional argument vector defaults to the ordinary process input.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It asks only for what is missing.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the boolean flag rule.
+     */
+    NestiaMigrateInquirer.parse = (argv) => __awaiter(this, void 0, void 0, function* () {
+        const program = new commander_1.Command();
         // PREPARE ASSETS
-        commander_1.program.option("--mode [nest/sdk]", "migration mode");
-        commander_1.program.option("--input [swagger.json]", "location of target swagger.json file");
-        commander_1.program.option("--output [directory]", "output directory path");
-        commander_1.program.option("--keyword [boolean]", "Keyword parameter mode");
-        commander_1.program.option("--simulate [boolean]", "Mockup simulator");
-        commander_1.program.option("--e2e [boolean]", "Generate E2E tests");
-        commander_1.program.option("--package [name]", "Package name");
+        program.option("--mode [nest/sdk]", "migration mode");
+        program.option("--input [swagger.json]", "location of target swagger.json file");
+        program.option("--output [directory]", "output directory path");
+        program.option("--keyword [boolean]", "Keyword parameter mode");
+        program.option("--simulate [boolean]", "Mockup simulator");
+        program.option("--e2e [boolean]", "Generate E2E tests");
+        program.option("--package [name]", "Package name");
         // INTERNAL PROCEDURES
         const questioned = { value: false };
         const action = (closure) => new Promise((resolve, reject) => {
-            commander_1.program.action((options) => __awaiter(this, void 0, void 0, function* () {
+            program.action((options) => __awaiter(this, void 0, void 0, function* () {
                 try {
                     resolve(yield closure(options));
                 }
@@ -34,7 +57,7 @@ var NestiaMigrateInquirer;
                     reject(exp);
                 }
             }));
-            commander_1.program.parseAsync().catch(reject);
+            program.parseAsync(argv).catch(reject);
         });
         const select = (name) => (message) => (choices, filter) => __awaiter(this, void 0, void 0, function* () {
             questioned.value = true;