@nestia/migrate 14.0.2 → 14.0.3

package/lib/executable/bundle.mjs

@@ -0,0 +1,324 @@
+import { __require } from "../_virtual/_rolldown/runtime.mjs";
+import { run } from "./TemplateBundleCache.mjs";
+import { require_package } from "../package.mjs";
+import fs from "node:fs";
+import cp from "node:child_process";
+//#region src/executable/bundle.ts
+const { version } = require_package();
+const ROOT = `${__dirname}/../..`;
+const ASSETS = `${ROOT}/assets`;
+const CATALOGS = __require("js-yaml").load(fs.readFileSync(`${__dirname}/../../../../pnpm-lock.yaml`, "utf8")).catalogs;
+const TYPIA = CATALOGS.samchon;
+const TYPESCRIPT = CATALOGS.typescript ?? {};
+const update = (content, options = {}) => {
+	const parsed = JSON.parse(content);
+	for (const record of [parsed.dependencies ?? {}, parsed.devDependencies ?? {}]) for (const key of Object.keys(record)) {
+		const current = record[key];
+		if (typeof current === "string" && (current.startsWith("catalog:") || current.startsWith("workspace:"))) continue;
+		if (key.startsWith("@nestia/") || key === "nestia") record[key] = `^${version}`;
+		else {
+			const catalog = TYPIA[key] ?? TYPESCRIPT[key];
+			if (catalog) record[key] = catalog.specifier;
+		}
+	}
+	migratePackageJson(parsed);
+	if (options.sdkAggregate) {
+		parsed.devDependencies ??= {};
+		parsed.devDependencies["@nestia/core"] = `^${version}`;
+	}
+	return JSON.stringify(parsed, null, 2);
+};
+const migratePackageJson = (parsed) => {
+	if (parsed.scripts) {
+		for (const [key, value] of Object.entries(parsed.scripts)) if (typeof value === "string") parsed.scripts[key] = normalizeScript(value);
+	}
+	const devDependencies = parsed.devDependencies;
+	if (devDependencies) {
+		const usesTypeScript = typeof devDependencies.typescript === "string" && devDependencies.typescript.startsWith("catalog:") === false;
+		delete devDependencies["typescript-transform-paths"];
+		if (usesTypeScript && TYPESCRIPT.ttsc) devDependencies.ttsc ??= TYPESCRIPT.ttsc.specifier;
+	}
+};
+const updateWorkspaceCatalog = (content) => {
+	const replace = (line) => {
+		const match = line.match(/^(\s+(?:"([^"]+)"|'([^']+)'|([^:\s]+)): (?:&[A-Za-z0-9_-]+ )?)\S[^\r\n]*(\r?)$/);
+		if (match === null) return line;
+		const name = match[2] ?? match[3] ?? match[4];
+		const specifier = name === "nestia" || name.startsWith("@nestia/") ? `^${version}` : TYPIA[name]?.specifier ?? TYPESCRIPT[name]?.specifier;
+		if (typeof specifier !== "string") return line;
+		return `${match[1]}${specifier}${match[5]}`;
+	};
+	return content.split("\n").map(replace).join("\n");
+};
+const trimTemplateDependencies = (parsed) => {
+	if (parsed.dependencies) {
+		delete parsed.dependencies.commander;
+		delete parsed.dependencies.inquirer;
+	}
+	if (parsed.devDependencies) {
+		delete parsed.devDependencies["@types/inquirer"];
+		delete parsed.devDependencies.commander;
+		delete parsed.devDependencies.inquirer;
+	}
+};
+const normalizeScript = (script) => script.replace(/(^|[^A-Za-z0-9_-])tsc(?=$|[^A-Za-z0-9_-])/g, "$1ttsc");
+const ARGUMENT_PARSER = `import { createInterface } from "node:readline/promises";
+
+export namespace ArgumentParser {
+  export interface Command {
+    option: (flags: string, description?: string) => Command;
+  }
+
+  export interface Prompt {
+    select: (
+      name: string,
+    ) => (
+      message: string,
+    ) => <Choice extends string>(choices: Choice[]) => Promise<Choice>;
+    boolean: (name: string) => (message: string) => Promise<boolean>;
+    number: (name: string) => (message: string) => Promise<number>;
+  }
+
+  export const parse = async <T>(
+    inquiry: (
+      command: Command,
+      prompt: Prompt,
+      action: (closure: (options: Partial<T>) => Promise<T>) => Promise<T>,
+    ) => Promise<T>,
+  ): Promise<T> => {
+    const command: Command = {
+      option: (_flags: string, _description?: string): Command => command,
+    };
+    const action = (closure: (options: Partial<T>) => Promise<T>) =>
+      closure(parseArguments() as Partial<T>);
+    return inquiry(
+      command,
+      { select, boolean, number },
+      action,
+    );
+  };
+
+  const select =
+    (_name: string) =>
+    (message: string) =>
+    async <Choice extends string>(choices: Choice[]): Promise<Choice> => {
+      const answer: string = await ask(\`\${message} (\${choices.join("/")})\`);
+      return (choices.find((choice) => choice === answer) ?? choices[0])!;
+    };
+
+  const boolean = (_name: string) => async (message: string) =>
+    /^(true|t|yes|y|1)$/i.test(await ask(\`\${message} [y/N]\`));
+
+  const number = (_name: string) => async (message: string) =>
+    Number(await ask(message));
+
+  const ask = async (message: string): Promise<string> => {
+    const reader = createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+    try {
+      return (await reader.question(\`\${message}: \`)).trim();
+    } finally {
+      reader.close();
+    }
+  };
+
+  const parseArguments = (): Record<string, string | string[] | boolean> => {
+    const output: Record<string, string | string[] | boolean> = {};
+    const args: string[] = process.argv.slice(2);
+    for (let i = 0; i < args.length; ++i) {
+      const raw: string = args[i]!;
+      if (raw.startsWith("--") === false) continue;
+
+      const equal: number = raw.indexOf("=");
+      const name: string = toCamelCase(
+        raw.slice(2, equal === -1 ? undefined : equal),
+      );
+      if (equal !== -1) {
+        assign(output, name, raw.slice(equal + 1));
+        continue;
+      }
+
+      const values: string[] = [];
+      while (i + 1 < args.length && args[i + 1]!.startsWith("--") === false)
+        values.push(args[++i]!);
+      assign(
+        output,
+        name,
+        values.length === 0 ? true : values.length === 1 ? values[0]! : values,
+      );
+    }
+    return output;
+  };
+
+  const assign = (
+    output: Record<string, string | string[] | boolean>,
+    name: string,
+    value: string | string[] | boolean,
+  ): void => {
+    const current: string | string[] | boolean | undefined = output[name];
+    if (current === undefined) output[name] = value;
+    else
+      output[name] = [
+        ...(Array.isArray(current) ? current : [String(current)]),
+        ...(Array.isArray(value) ? value : [String(value)]),
+      ];
+  };
+
+  const toCamelCase = (str: string): string =>
+    str.replace(/-([a-z])/g, (_matched, letter: string) =>
+      letter.toUpperCase(),
+    );
+}
+`;
+const updateTsConfig = (content) => {
+	content = content.replace(/^\s*\{\s*"transform":\s*"typescript-transform-paths"\s*\},\r?\n/gm, "");
+	content = content.replace(/^\s*\{\s*"transform":\s*"typia\/lib\/transform"(?:,\s*"enabled":\s*false)?\s*\},?\r?\n/gm, "");
+	content = content.replace(/^\s*\{\s*"transform":\s*"@nestia\/core\/lib\/transform"\s*\},?\r?\n/gm, "");
+	content = content.replace(/^\s*\{\s*"transform":\s*"@nestia\/core\/native\/transform\.cjs"\s*\},?\r?\n/gm, "");
+	content = content.replace(/^\s*\{\s*"transform":\s*"@nestia\/sdk\/lib\/transform"\s*\},\r?\n/gm, "");
+	return content;
+};
+const bundle = async ({ mode, repository, revision, exceptions, transform }) => {
+	const template = `${`${`${__dirname}/../..`}/assets`}/${mode}`;
+	const clone = async () => {
+		if (fs.existsSync(template)) await fs.promises.rm(template, { recursive: true });
+		else try {
+			await fs.promises.mkdir(ASSETS);
+		} catch {}
+		await fs.promises.mkdir(template, { recursive: true });
+		cp.execFileSync("git", ["init", "--quiet"], { cwd: template });
+		cp.execFileSync("git", [
+			"fetch",
+			"--quiet",
+			"--depth=1",
+			"--no-auto-maintenance",
+			`https://github.com/samchon/${repository}`,
+			revision
+		], { cwd: template });
+		cp.execFileSync("git", [
+			"-c",
+			"core.autocrlf=false",
+			"checkout",
+			"--quiet",
+			"--detach",
+			revision
+		], {
+			cwd: template,
+			stdio: "pipe"
+		});
+		for (const location of exceptions ?? []) await fs.promises.rm(`${template}/${location}`, { recursive: true });
+	};
+	const iterate = (collection) => async (location) => {
+		const directory = await fs.promises.readdir(location);
+		for (const file of directory) {
+			const absolute = location + "/" + file;
+			if ((await fs.promises.stat(absolute)).isDirectory()) await iterate(collection)(absolute);
+			else {
+				const content = await fs.promises.readFile(absolute, "utf-8");
+				collection[(() => {
+					const str = absolute.replace(template, "");
+					return str[0] === "/" ? str.substring(1) : str;
+				})()] = content;
+			}
+		}
+	};
+	const archive = async (collection) => {
+		const name = `${mode.toUpperCase()}_TEMPLATE`;
+		const content = `export const ${name}: Record<string, string> = ${JSON.stringify(collection, null, 2)}`;
+		try {
+			await fs.promises.mkdir(`${ROOT}/src/bundles`);
+		} catch {}
+		await fs.promises.writeFile(`${ROOT}/src/bundles/${name}.ts`, content, "utf8");
+	};
+	const collection = {};
+	await clone();
+	await iterate(collection)(template);
+	if (transform) for (const [key, value] of Object.entries(collection)) collection[key] = await writeTransformedAsset(template, key, transform(key, value));
+	await archive(collection);
+};
+const writeTransformedAsset = async (template, key, value) => {
+	await fs.promises.writeFile(`${template}/${key}`, value, "utf8");
+	return value;
+};
+/**
+* Generates both pinned templates using the current release and catalog stamps.
+*
+* The complete script is a cache input because it contains the revisions,
+* exclusions and every transformation rule. A hit still verifies output bytes.
+*/
+const generate = async () => {
+	await bundle({
+		mode: "nest",
+		repository: "nestia-start",
+		revision: "8188661cb1c1b0fb30e6184b06422764d64a5f68",
+		exceptions: [
+			".git",
+			".github/dependabot.yml",
+			".github/workflows/dependabot-automerge.yml",
+			"pnpm-lock.yaml",
+			"packages/api/src/functional",
+			"packages/api/src/structures",
+			"packages/backend/src/MyModule.ts",
+			"packages/backend/src/controllers",
+			"packages/backend/src/providers",
+			"packages/backend/test/features"
+		],
+		transform: (key, value) => {
+			if (key.endsWith("package.json")) {
+				const parsed = JSON.parse(update(value));
+				trimTemplateDependencies(parsed);
+				return JSON.stringify(parsed, null, 2);
+			}
+			if (key === "pnpm-workspace.yaml") return updateWorkspaceCatalog(value);
+			if (key === "packages/backend/test/helpers/ArgumentParser.ts") return ARGUMENT_PARSER;
+			if (key.endsWith("tsconfig.json")) return updateTsConfig(value);
+			return value;
+		}
+	});
+	await bundle({
+		mode: "sdk",
+		repository: "nestia-sdk-template",
+		revision: "37a019e2b8dea3d02237137aaec2f242f53dcd2d",
+		exceptions: [
+			".git",
+			".github/dependabot.yml",
+			".github/workflows/build.yml",
+			".github/workflows/dependabot-automerge.yml",
+			"pnpm-lock.yaml",
+			"src/functional",
+			"src/structures",
+			"test/features"
+		],
+		transform: (key, value) => {
+			if (key.endsWith("package.json")) {
+				const parsed = JSON.parse(update(value, { sdkAggregate: key === "package.json" }));
+				trimTemplateDependencies(parsed);
+				return JSON.stringify(parsed, null, 2);
+			}
+			if (key === "test/utils/ArgumentParser.ts") return ARGUMENT_PARSER;
+			if (key.endsWith("tsconfig.json")) return updateTsConfig(value);
+			return value;
+		}
+	});
+};
+const main = async () => {
+	if (await run({
+		inputs: [
+			version,
+			CATALOGS,
+			fs.readFileSync(__filename, "utf8")
+		],
+		outputs: ["NEST_TEMPLATE", "SDK_TEMPLATE"].map((name) => `${ROOT}/src/bundles/${name}.ts`),
+		stampFile: `${ASSETS}/.bundle-cache.json`,
+		generate
+	})) console.log("Reuse verified migration template bundles.");
+};
+main().catch((exp) => {
+	console.error(exp);
+	process.exit(-1);
+});
+//#endregion
+
+//# sourceMappingURL=bundle.mjs.map

package/lib/executable/bundle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.mjs","names":[],"sources":[],"mappings":""}

package/lib/package.mjs

@@ -0,0 +1,55 @@
+import { __commonJSMin } from "./_virtual/_rolldown/runtime.mjs";
+//#region ../../package.json
+var require_package = /* @__PURE__ */ __commonJSMin(((exports, module) => {
+	module.exports = {
+		"private": true,
+		"name": "@nestia/station",
+		"version": "14.0.3",
+		"description": "Nestia station",
+		"scripts": {
+			"build": "pnpm --filter=./packages/* -r build",
+			"evidence": "pnpm --filter=./config --filter=./packages/* --filter=./tests/* -r --no-bail --workspace-concurrency=1 run evidence",
+			"evidence:tests": "pnpm --filter=./tests/* --fail-if-no-match -r --no-bail --workspace-concurrency=1 run evidence",
+			"format": "prettier --write \"packages/**/*.ts\" \"tests/**/*.ts\"",
+			"format:check": "prettier --check \"packages/**/*.ts\" \"tests/**/*.ts\"",
+			"test": "pnpm build && pnpm evidence && pnpm test:go && pnpm test:unit && pnpm test:e2e",
+			"package:prepare": "pnpm build && node deploy/copy-readme.cjs",
+			"package:latest": "pnpm package:prepare && pnpm --filter=./packages/* -r publish --tag latest",
+			"package:next": "pnpm package:prepare && pnpm --filter=./packages/* -r publish --tag next",
+			"package:rc": "pnpm package:prepare && pnpm --filter=./packages/* -r publish --tag rc",
+			"package:tgz": "pnpm package:prepare && node deploy/tarballs",
+			"release": "rimraf packages/migrate/assets && bumpp -r",
+			"test:unit": "pnpm --filter=./packages/* --filter=./tests/* -r --no-bail --if-present run test:unit",
+			"test:go": "ttsx --no-plugins --tsconfig config/tsconfig.json config/testing/CompilerEnvironment.ts",
+			"test:e2e": "pnpm --filter=@nestia/test-sdk --fail-if-no-match integration"
+		},
+		"repository": {
+			"type": "git",
+			"url": "https://github.com/samchon/nestia"
+		},
+		"author": "Jeongho Nam",
+		"license": "MIT",
+		"bugs": { "url": "https://github.com/samchon/nestia/issues" },
+		"homepage": "https://nestia.io",
+		"devDependencies": {
+			"@trivago/prettier-plugin-sort-imports": "catalog:typescript",
+			"@wrtnlabs/evidence": "catalog:samchon",
+			"@types/ts-expose-internals": "npm:ts-expose-internals@5.4.5",
+			"bumpp": "^10.4.1",
+			"cross-env": "catalog:utils",
+			"prettier": "catalog:typescript",
+			"prettier-plugin-jsdoc": "catalog:typescript",
+			"rimraf": "catalog:utils",
+			"sloc": "^0.3.0",
+			"ttsc": "catalog:typescript",
+			"typescript": "catalog:typescript",
+			"yaml": "catalog:utils"
+		},
+		"packageManager": "pnpm@10.6.4"
+	};
+}));
+//#endregion
+export default require_package();
+export { require_package };
+
+//# sourceMappingURL=package.mjs.map

package/lib/package.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.mjs","names":[],"sources":["../../../package.json"],"sourcesContent":[""],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/migrate",
-  "version": "14.0.2",
+  "version": "14.0.3",
   "description": "Migration program from swagger to NestJS",
   "main": "lib/index.js",
   "bin": {
@@ -67,8 +67,8 @@
     "access": "public"
   },
   "scripts": {
-    "build": "pnpm run bundle && rimraf lib && ttsc && tsc --emitDeclarationOnly && rolldown -c",
-    "bundle": "node src/executable/bundle.js",
+    "build": "pnpm run bundle && rimraf lib && ttsc && rolldown -c",
+    "bundle": "cross-env NODE_OPTIONS=\"--no-experimental-strip-types --no-experimental-detect-module\" ttsx --no-plugins --tsconfig tsconfig.bundle.json src/executable/bundle.ts",
     "dev": "rimraf lib && ttsc --watch",
     "test": "node lib/test",
     "evidence": "evidence"

package/src/bundles/NEST_TEMPLATE.ts

@@ -49,6 +49,6 @@ export const NEST_TEMPLATE: Record<string, string> = {
   "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.2\n    \"@nestia/core\": ^14.0.2\n    \"@nestia/e2e\": ^14.0.2\n    \"@nestia/fetcher\": ^14.0.2\n    \"@nestia/sdk\": ^14.0.2\n    nestia: ^14.0.2\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\"]"
 }

package/src/bundles/SDK_TEMPLATE.ts

@@ -5,7 +5,7 @@ export const SDK_TEMPLATE: Record<string, string> = {
   "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.2\",\n    \"tgrid\": \"^1.2.1\",\n    \"typia\": \"15.0.0\"\n  },\n  \"devDependencies\": {\n    \"@nestia/e2e\": \"^14.0.2\",\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.2\"\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/src/executable/NestiaMigrateCommander.ts

@@ -41,7 +41,9 @@ export namespace NestiaMigrateCommander {
    *
    * 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.
+   * 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
@@ -52,11 +54,11 @@ export namespace NestiaMigrateCommander {
    * @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.
    */
-  export const main = async (): Promise<void> => {
+  export const main = async (argv?: string[]): Promise<void> => {
     const resolve = (str: string | undefined) =>
       str ? path.resolve(str).split("\\").join("/") : undefined;
     const options: NestiaMigrateInquirer.IOutput =
-      await NestiaMigrateInquirer.parse();
+      await NestiaMigrateInquirer.parse(argv);
 
     // VALIDATE OUTPUT DIRECTORY
     const parent: string = resolve(options.output + "/..")!;

package/src/executable/NestiaMigrateInquirer.ts

@@ -1,4 +1,4 @@
-import { program } from "commander";
+import { Command } from "commander";
 import { createPromptModule } from "inquirer";
 
 /**
@@ -34,14 +34,17 @@ export namespace NestiaMigrateInquirer {
    * 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`.
+   * 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 Commander parses the flags, the action asks a prompt for each undefined option, and boolean flags are normalized by one rule, so the result has every field set.
-   * @evidence contracts/common.md#clear-and-simple-design One function that wires the parser and the prompts around one action.
+   * @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.
    */
-  export const parse = async (): Promise<IOutput> => {
+  export const parse = async (argv?: string[]): Promise<IOutput> => {
+    const program = new Command();
     // PREPARE ASSETS
     program.option("--mode [nest/sdk]", "migration mode");
     program.option(
@@ -65,7 +68,7 @@ export namespace NestiaMigrateInquirer {
             reject(exp);
           }
         });
-        program.parseAsync().catch(reject);
+        program.parseAsync(argv).catch(reject);
       });
     const select =
       (name: string) =>

package/src/executable/TemplateBundleCache.ts

@@ -0,0 +1,65 @@
+import crypto from "node:crypto";
+import fs from "node:fs";
+
+/**
+ * Reuses a complete template generation only while its inputs and outputs
+ * match.
+ *
+ * The caller owns the generated paths and cold generation. This module owns the
+ * validity manifest; failed generation never publishes a new manifest.
+ * Concurrent generation of the same output paths is not supported.
+ *
+ * @evidence contracts/common.md#principled-implementation Input identity includes the cache implementation and caller-supplied generator inputs. Reuse requires every expected output's current SHA-256 to match the manifest; a missing, changed or partial generation cannot authorize reuse.
+ * @evidence contracts/common.md#clear-and-simple-design One operation checks a manifest, delegates cold generation and publishes its successful output digests. The caller retains template-specific fetching and stamping rules.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Generated contents are never replaced by expected answers. Invalid metadata is treated as a cache miss and failed generation remains a rejection.
+ * @evidence contracts/common.md#meaningful-documentation Documents manifest ownership, failed publication and the existing single-writer premise.
+ * @evidence contracts/performance.md#efficient-algorithms A hit hashes each output once, with time proportional to input/output bytes and one manifest rather than scanning template trees or fetching Git history.
+ * @evidence contracts/performance.md#reuse-equivalent-work The cache implementation, caller inputs and current output digests jointly establish reuse validity; changed inputs, edited outputs and missing files invalidate it.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources Each output set owns one replaceable manifest, not per-run history. Synchronous reads and awaited writes close their file handles. The caller must serialize writers to the same paths.
+ * @evidence contracts/portability.md#os-neutral-implementation Node fs consumes caller-owned native paths; identity hashes bytes and never assumes timestamp resolution, case folding or path separators.
+ */
+export const run = async ({
+  inputs,
+  outputs,
+  stampFile,
+  generate,
+}: {
+  inputs: readonly unknown[];
+  outputs: readonly string[];
+  stampFile: string;
+  generate: () => Promise<void>;
+}): Promise<boolean> => {
+  const digest = (content: string | Buffer): string =>
+    crypto.createHash("sha256").update(content).digest("hex");
+  const input = digest(
+    JSON.stringify([fs.readFileSync(__filename, "utf8"), inputs]),
+  );
+  let stamp: { input?: string; outputs?: string[] } | undefined;
+  if (fs.existsSync(stampFile)) {
+    try {
+      stamp = JSON.parse(fs.readFileSync(stampFile, "utf8"));
+    } catch {
+      // Invalid or interrupted metadata cannot authorize reuse.
+    }
+  }
+  if (
+    outputs.length !== 0 &&
+    stamp?.input === input &&
+    outputs.every(
+      (file, index) =>
+        fs.existsSync(file) &&
+        stamp.outputs?.[index] === digest(fs.readFileSync(file)),
+    )
+  )
+    return true;
+  await generate();
+  await fs.promises.writeFile(
+    stampFile,
+    JSON.stringify({
+      input,
+      outputs: outputs.map((file) => digest(fs.readFileSync(file))),
+    }),
+    "utf8",
+  );
+  return false;
+};