nestia 12.0.0-rc.3 → 12.0.0

package/bin/NestiaProjectTemplate.d.ts

@@ -0,0 +1,29 @@
+export declare namespace NestiaProjectTemplate {
+    /**
+     * Side effects performed while scaffolding a template project.
+     *
+     * Injected so that the scaffolding flow can be unit tested without touching
+     * the network, the file system, or a real package manager.
+     */
+    interface IContext {
+        /** Runs a command, inheriting stdio. Throws on non-zero exit. */
+        execute: (command: string) => void;
+        /** Silently checks whether a command succeeds. */
+        probe: (command: string) => boolean;
+        /** Changes the working directory. */
+        chdir: (directory: string) => void;
+        /** Checks whether a path exists. */
+        exists: (path: string) => boolean;
+        /** Removes a path recursively, ignoring missing entries. */
+        remove: (path: string) => void;
+    }
+    interface IProps {
+        /** Banner title printed before cloning. */
+        title: string;
+        /** Default repository URL, overridable through `--repository <url>`. */
+        repository: string;
+        /** Whether to run the test suite after building. */
+        test: boolean;
+    }
+    const clone: (props: IProps) => (halter: (msg?: string) => never, context?: IContext) => (argv: string[]) => Promise<void>;
+}

package/bin/NestiaProjectTemplate.js

@@ -0,0 +1,104 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NestiaProjectTemplate = void 0;
+const child_process_1 = __importDefault(require("child_process"));
+const fs_1 = __importDefault(require("fs"));
+var NestiaProjectTemplate;
+(function (NestiaProjectTemplate) {
+    NestiaProjectTemplate.clone = (props) => (halter, context = CONTEXT) => (argv) => __awaiter(this, void 0, void 0, function* () {
+        // VALIDATION
+        const { dest, repository } = parse(argv, halter);
+        if (dest === undefined)
+            halter();
+        else if (context.exists(dest) === true)
+            halter("The target directory already exists.");
+        console.log("-----------------------------------------");
+        console.log(` ${props.title}`);
+        console.log("-----------------------------------------");
+        // COPY PROJECTS
+        context.execute(`git clone "${repository !== null && repository !== void 0 ? repository : props.repository}" "${dest}"`);
+        console.log(`cd "${dest}"`);
+        context.chdir(dest);
+        // TEMPLATE REPOSITORIES ARE PNPM MONOREPOS.
+        //
+        // Their workspace manifests use the `catalog:` dependency protocol,
+        // which npm cannot resolve. Only pnpm (directly installed, or served
+        // through corepack) can set them up.
+        const pm = getPackageManager(halter, context);
+        // INSTALL DEPENDENCIES
+        context.execute(`${pm} install`);
+        // BUILD TYPESCRIPT
+        context.execute(`${pm} run build`);
+        // DO TEST
+        if (props.test === true)
+            context.execute(`${pm} run test`);
+        // REMOVE REPOSITORY ONLY FILES
+        context.remove(".git");
+        context.remove(".github/dependabot.yml");
+    });
+    function parse(argv, halter) {
+        const output = {};
+        for (let i = 0; i < argv.length; ++i) {
+            const value = argv[i];
+            if (value === "--repository") {
+                const url = argv[i + 1];
+                if (url === undefined)
+                    halter("The --repository option requires a URL value.");
+                output.repository = url;
+                ++i;
+            }
+            else if (value.startsWith("--") === false && output.dest === undefined)
+                output.dest = value;
+        }
+        return output;
+    }
+    function getPackageManager(halter, context) {
+        if (context.probe("pnpm --version") === true)
+            return "pnpm";
+        else if (context.probe("corepack --version") === true) {
+            process.env.COREPACK_ENABLE_DOWNLOAD_PROMPT = "0";
+            return "corepack pnpm";
+        }
+        return halter([
+            "The template project is a pnpm monorepo, but neither pnpm nor",
+            "corepack could be found. Install pnpm and try again:",
+            "",
+            "  npm install --global pnpm",
+            "",
+            "or activate it through corepack (bundled with Node.js):",
+            "",
+            "  corepack enable",
+        ].join("\n"));
+    }
+    const CONTEXT = {
+        execute: (command) => {
+            console.log(`\n$ ${command}`);
+            child_process_1.default.execSync(command, { stdio: "inherit" });
+        },
+        probe: (command) => {
+            try {
+                child_process_1.default.execSync(command, { stdio: "ignore" });
+                return true;
+            }
+            catch (_a) {
+                return false;
+            }
+        },
+        chdir: (directory) => process.chdir(directory),
+        exists: (path) => fs_1.default.existsSync(path),
+        remove: (path) => fs_1.default.rmSync(path, { recursive: true, force: true }),
+    };
+})(NestiaProjectTemplate || (exports.NestiaProjectTemplate = NestiaProjectTemplate = {}));
+//# sourceMappingURL=NestiaProjectTemplate.js.map

package/bin/NestiaProjectTemplate.js.map

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

package/bin/NestiaStarter.d.ts

@@ -1,3 +1,4 @@
+import { NestiaProjectTemplate } from "./NestiaProjectTemplate.js";
 export declare namespace NestiaStarter {
-    const clone: (halter: (msg?: string) => never) => (argv: string[]) => Promise<void>;
+    const clone: (halter: (msg?: string) => never, context?: NestiaProjectTemplate.IContext) => (argv: string[]) => Promise<void>;
 }

package/bin/NestiaStarter.js

@@ -1,49 +1,13 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NestiaStarter = void 0;
-const child_process_1 = __importDefault(require("child_process"));
-const fs_1 = __importDefault(require("fs"));
+const NestiaProjectTemplate_js_1 = require("./NestiaProjectTemplate.js");
 var NestiaStarter;
 (function (NestiaStarter) {
-    NestiaStarter.clone = (halter) => (argv) => __awaiter(this, void 0, void 0, function* () {
-        // VALIDATION
-        const dest = argv[0];
-        if (dest === undefined)
-            halter();
-        else if (fs_1.default.existsSync(dest) === true)
-            halter("The target directory already exists.");
-        console.log("-----------------------------------------");
-        console.log(" Nestia Starter Kit");
-        console.log("-----------------------------------------");
-        // COPY PROJECTS
-        execute(`git clone https://github.com/samchon/nestia-template ${dest}`);
-        console.log(`cd "${dest}"`);
-        process.chdir(dest);
-        // INSTALL DEPENDENCIES
-        execute("npm install");
-        // BUILD TYPESCRIPT
-        execute("npm run build");
-        // DO TEST
-        execute("npm run test");
-        // REMOVE .GIT DIRECTORY
-        child_process_1.default.execSync("npx rimraf .git");
-        child_process_1.default.execSync("npx rimraf .github/dependabot.yml");
+    NestiaStarter.clone = NestiaProjectTemplate_js_1.NestiaProjectTemplate.clone({
+        title: "Nestia Starter Kit",
+        repository: "https://github.com/samchon/nestia-start",
+        test: true,
     });
-    function execute(command) {
-        console.log(`\n$ ${command}`);
-        child_process_1.default.execSync(command, { stdio: "inherit" });
-    }
 })(NestiaStarter || (exports.NestiaStarter = NestiaStarter = {}));
 //# sourceMappingURL=NestiaStarter.js.map

package/bin/NestiaStarter.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaStarter.js","sourceRoot":"","sources":["../src/NestiaStarter.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,kEAA+B;AAC/B,4CAAoB;AAEpB,IAAiB,aAAa,CAqC7B;AArCD,WAAiB,aAAa;IACf,mBAAK,GAChB,CAAC,MAA+B,EAAE,EAAE,CACpC,CAAO,IAAc,EAAiB,EAAE;QACtC,aAAa;QACb,MAAM,IAAI,GAAuB,IAAI,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,EAAE,CAAC;aAC5B,IAAI,YAAE,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI;YACnC,MAAM,CAAC,sCAAsC,CAAC,CAAC;QAEjD,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QAEzD,gBAAgB;QAChB,OAAO,CAAC,wDAAwD,IAAI,EAAE,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEpB,uBAAuB;QACvB,OAAO,CAAC,aAAa,CAAC,CAAC;QAEvB,mBAAmB;QACnB,OAAO,CAAC,eAAe,CAAC,CAAC;QAEzB,UAAU;QACV,OAAO,CAAC,cAAc,CAAC,CAAC;QAExB,wBAAwB;QACxB,uBAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;QAC/B,uBAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC,CAAC;IACnD,CAAC,CAAA,CAAC;IAEJ,SAAS,OAAO,CAAC,OAAe;QAC9B,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;QAC9B,uBAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC,EArCgB,aAAa,aAAb,aAAa,GAAb,aAAa,QAqC7B"}
+{"version":3,"file":"NestiaStarter.js","sourceRoot":"","sources":["../src/NestiaStarter.ts"],"names":[],"mappings":";;;AAAA,yEAAmE;AAEnE,IAAiB,aAAa,CAM7B;AAND,WAAiB,aAAa;IACf,mBAAK,GAAG,gDAAqB,CAAC,KAAK,CAAC;QAC/C,KAAK,EAAE,oBAAoB;QAC3B,UAAU,EAAE,yCAAyC;QACrD,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;AACL,CAAC,EANgB,aAAa,aAAb,aAAa,GAAb,aAAa,QAM7B"}

package/bin/NestiaTemplate.d.ts

@@ -1,3 +1,4 @@
+import { NestiaProjectTemplate } from "./NestiaProjectTemplate.js";
 export declare namespace NestiaTemplate {
-    const clone: (halter: (msg?: string) => never) => (argv: string[]) => Promise<void>;
+    const clone: (halter: (msg?: string) => never, context?: NestiaProjectTemplate.IContext) => (argv: string[]) => Promise<void>;
 }

package/bin/NestiaTemplate.js

@@ -1,46 +1,13 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NestiaTemplate = void 0;
-const child_process_1 = __importDefault(require("child_process"));
-const fs_1 = __importDefault(require("fs"));
+const NestiaProjectTemplate_js_1 = require("./NestiaProjectTemplate.js");
 var NestiaTemplate;
 (function (NestiaTemplate) {
-    NestiaTemplate.clone = (halter) => (argv) => __awaiter(this, void 0, void 0, function* () {
-        // VALIDATION
-        const dest = argv[0];
-        if (dest === undefined)
-            halter();
-        else if (fs_1.default.existsSync(dest) === true)
-            halter("The target directory already exists.");
-        console.log("-----------------------------------------");
-        console.log(" Nestia Template Kit");
-        console.log("-----------------------------------------");
-        // COPY PROJECTS
-        execute(`git clone https://github.com/samchon/backend ${dest}`);
-        console.log(`cd "${dest}"`);
-        process.chdir(dest);
-        // INSTALL DEPENDENCIES
-        execute("npm install");
-        // BUILD TYPESCRIPT
-        execute("npm run build");
-        // REMOVE .GIT DIRECTORY
-        child_process_1.default.execSync("npx rimraf .git");
+    NestiaTemplate.clone = NestiaProjectTemplate_js_1.NestiaProjectTemplate.clone({
+        title: "Nestia Template Kit",
+        repository: "https://github.com/samchon/backend",
+        test: false,
     });
-    function execute(command) {
-        console.log(`\n$ ${command}`);
-        child_process_1.default.execSync(command, { stdio: "inherit" });
-    }
 })(NestiaTemplate || (exports.NestiaTemplate = NestiaTemplate = {}));
 //# sourceMappingURL=NestiaTemplate.js.map

package/bin/NestiaTemplate.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaTemplate.js","sourceRoot":"","sources":["../src/NestiaTemplate.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,kEAA+B;AAC/B,4CAAoB;AAEpB,IAAiB,cAAc,CAiC9B;AAjCD,WAAiB,cAAc;IAChB,oBAAK,GAChB,CAAC,MAA+B,EAAE,EAAE,CACpC,CAAO,IAAc,EAAiB,EAAE;QACtC,aAAa;QACb,MAAM,IAAI,GAAuB,IAAI,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,EAAE,CAAC;aAC5B,IAAI,YAAE,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI;YACnC,MAAM,CAAC,sCAAsC,CAAC,CAAC;QAEjD,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QAEzD,gBAAgB;QAChB,OAAO,CAAC,gDAAgD,IAAI,EAAE,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEpB,uBAAuB;QACvB,OAAO,CAAC,aAAa,CAAC,CAAC;QAEvB,mBAAmB;QACnB,OAAO,CAAC,eAAe,CAAC,CAAC;QAEzB,wBAAwB;QACxB,uBAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACjC,CAAC,CAAA,CAAC;IAEJ,SAAS,OAAO,CAAC,OAAe;QAC9B,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;QAC9B,uBAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC,EAjCgB,cAAc,aAAd,cAAc,GAAd,cAAc,QAiC9B"}
+{"version":3,"file":"NestiaTemplate.js","sourceRoot":"","sources":["../src/NestiaTemplate.ts"],"names":[],"mappings":";;;AAAA,yEAAmE;AAEnE,IAAiB,cAAc,CAM9B;AAND,WAAiB,cAAc;IAChB,oBAAK,GAAG,gDAAqB,CAAC,KAAK,CAAC;QAC/C,KAAK,EAAE,qBAAqB;QAC5B,UAAU,EAAE,oCAAoC;QAChD,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;AACL,CAAC,EANgB,cAAc,aAAd,cAAc,GAAd,cAAc,QAM9B"}

package/bin/index.d.ts

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-declare const USAGE = "Wrong command has been detected. Use like below:\n\nnpx nestia [command] [options?]\n\n  1. npx nestia start <directory>\n  2. npx nestia template <directory>\n  3. npx nestia dependencies\n  4. npx nestia init\n  5. npx nestia sdk\n  6. npx nestia swagger [--watch]\n  7. npx nestia e2e\n  8. npx nestia all\n";
+declare const USAGE = "Wrong command has been detected. Use like below:\n\nnpx nestia [command] [options?]\n\n  1. npx nestia start <directory> [--repository <url>]\n  2. npx nestia template <directory> [--repository <url>]\n  3. npx nestia dependencies\n  4. npx nestia init\n  5. npx nestia sdk\n  6. npx nestia swagger [--watch]\n  7. npx nestia e2e\n  8. npx nestia all\n";
 declare function halt(desc: string): never;
 declare function main(): Promise<void>;

package/bin/index.js

@@ -46,8 +46,8 @@ const USAGE = `Wrong command has been detected. Use like below:
 
 npx nestia [command] [options?]
 
-  1. npx nestia start <directory>
-  2. npx nestia template <directory>
+  1. npx nestia start <directory> [--repository <url>]
+  2. npx nestia template <directory> [--repository <url>]
   3. npx nestia dependencies
   4. npx nestia init
   5. npx nestia sdk

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nestia",
-  "version": "12.0.0-rc.3",
+  "version": "12.0.0",
   "description": "Nestia CLI tool",
   "main": "bin/index.js",
   "bin": {
@@ -35,8 +35,8 @@
   "devDependencies": {
     "@types/node": "^25.3.3",
     "rimraf": "^6.1.3",
-    "@nestia/core": "^12.0.0-rc.3",
-    "@nestia/sdk": "^12.0.0-rc.3"
+    "@nestia/core": "^12.0.0",
+    "@nestia/sdk": "^12.0.0"
   },
   "files": [
     "bin",

package/src/NestiaProjectTemplate.ts

@@ -0,0 +1,137 @@
+import cp from "child_process";
+import fs from "fs";
+
+export namespace NestiaProjectTemplate {
+  /**
+   * Side effects performed while scaffolding a template project.
+   *
+   * Injected so that the scaffolding flow can be unit tested without touching
+   * the network, the file system, or a real package manager.
+   */
+  export interface IContext {
+    /** Runs a command, inheriting stdio. Throws on non-zero exit. */
+    execute: (command: string) => void;
+    /** Silently checks whether a command succeeds. */
+    probe: (command: string) => boolean;
+    /** Changes the working directory. */
+    chdir: (directory: string) => void;
+    /** Checks whether a path exists. */
+    exists: (path: string) => boolean;
+    /** Removes a path recursively, ignoring missing entries. */
+    remove: (path: string) => void;
+  }
+
+  export interface IProps {
+    /** Banner title printed before cloning. */
+    title: string;
+    /** Default repository URL, overridable through `--repository <url>`. */
+    repository: string;
+    /** Whether to run the test suite after building. */
+    test: boolean;
+  }
+
+  export const clone =
+    (props: IProps) =>
+    (halter: (msg?: string) => never, context: IContext = CONTEXT) =>
+    async (argv: string[]): Promise<void> => {
+      // VALIDATION
+      const { dest, repository } = parse(argv, halter);
+      if (dest === undefined) halter();
+      else if (context.exists(dest) === true)
+        halter("The target directory already exists.");
+
+      console.log("-----------------------------------------");
+      console.log(` ${props.title}`);
+      console.log("-----------------------------------------");
+
+      // COPY PROJECTS
+      context.execute(
+        `git clone "${repository ?? props.repository}" "${dest}"`,
+      );
+      console.log(`cd "${dest}"`);
+      context.chdir(dest);
+
+      // TEMPLATE REPOSITORIES ARE PNPM MONOREPOS.
+      //
+      // Their workspace manifests use the `catalog:` dependency protocol,
+      // which npm cannot resolve. Only pnpm (directly installed, or served
+      // through corepack) can set them up.
+      const pm: string = getPackageManager(halter, context);
+
+      // INSTALL DEPENDENCIES
+      context.execute(`${pm} install`);
+
+      // BUILD TYPESCRIPT
+      context.execute(`${pm} run build`);
+
+      // DO TEST
+      if (props.test === true) context.execute(`${pm} run test`);
+
+      // REMOVE REPOSITORY ONLY FILES
+      context.remove(".git");
+      context.remove(".github/dependabot.yml");
+    };
+
+  interface IArguments {
+    dest?: string;
+    repository?: string;
+  }
+
+  function parse(argv: string[], halter: (msg?: string) => never): IArguments {
+    const output: IArguments = {};
+    for (let i: number = 0; i < argv.length; ++i) {
+      const value: string = argv[i]!;
+      if (value === "--repository") {
+        const url: string | undefined = argv[i + 1];
+        if (url === undefined)
+          halter("The --repository option requires a URL value.");
+        output.repository = url;
+        ++i;
+      } else if (value.startsWith("--") === false && output.dest === undefined)
+        output.dest = value;
+    }
+    return output;
+  }
+
+  function getPackageManager(
+    halter: (msg?: string) => never,
+    context: IContext,
+  ): string {
+    if (context.probe("pnpm --version") === true) return "pnpm";
+    else if (context.probe("corepack --version") === true) {
+      process.env.COREPACK_ENABLE_DOWNLOAD_PROMPT = "0";
+      return "corepack pnpm";
+    }
+    return halter(
+      [
+        "The template project is a pnpm monorepo, but neither pnpm nor",
+        "corepack could be found. Install pnpm and try again:",
+        "",
+        "  npm install --global pnpm",
+        "",
+        "or activate it through corepack (bundled with Node.js):",
+        "",
+        "  corepack enable",
+      ].join("\n"),
+    );
+  }
+
+  const CONTEXT: IContext = {
+    execute: (command: string): void => {
+      console.log(`\n$ ${command}`);
+      cp.execSync(command, { stdio: "inherit" });
+    },
+    probe: (command: string): boolean => {
+      try {
+        cp.execSync(command, { stdio: "ignore" });
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    chdir: (directory: string): void => process.chdir(directory),
+    exists: (path: string): boolean => fs.existsSync(path),
+    remove: (path: string): void =>
+      fs.rmSync(path, { recursive: true, force: true }),
+  };
+}

package/src/NestiaStarter.ts

@@ -1,41 +1,9 @@
-import cp from "child_process";
-import fs from "fs";
+import { NestiaProjectTemplate } from "./NestiaProjectTemplate.js";
 
 export namespace NestiaStarter {
-  export const clone =
-    (halter: (msg?: string) => never) =>
-    async (argv: string[]): Promise<void> => {
-      // VALIDATION
-      const dest: string | undefined = argv[0];
-      if (dest === undefined) halter();
-      else if (fs.existsSync(dest) === true)
-        halter("The target directory already exists.");
-
-      console.log("-----------------------------------------");
-      console.log(" Nestia Starter Kit");
-      console.log("-----------------------------------------");
-
-      // COPY PROJECTS
-      execute(`git clone https://github.com/samchon/nestia-template ${dest}`);
-      console.log(`cd "${dest}"`);
-      process.chdir(dest);
-
-      // INSTALL DEPENDENCIES
-      execute("npm install");
-
-      // BUILD TYPESCRIPT
-      execute("npm run build");
-
-      // DO TEST
-      execute("npm run test");
-
-      // REMOVE .GIT DIRECTORY
-      cp.execSync("npx rimraf .git");
-      cp.execSync("npx rimraf .github/dependabot.yml");
-    };
-
-  function execute(command: string): void {
-    console.log(`\n$ ${command}`);
-    cp.execSync(command, { stdio: "inherit" });
-  }
+  export const clone = NestiaProjectTemplate.clone({
+    title: "Nestia Starter Kit",
+    repository: "https://github.com/samchon/nestia-start",
+    test: true,
+  });
 }

package/src/NestiaTemplate.ts

@@ -1,37 +1,9 @@
-import cp from "child_process";
-import fs from "fs";
+import { NestiaProjectTemplate } from "./NestiaProjectTemplate.js";
 
 export namespace NestiaTemplate {
-  export const clone =
-    (halter: (msg?: string) => never) =>
-    async (argv: string[]): Promise<void> => {
-      // VALIDATION
-      const dest: string | undefined = argv[0];
-      if (dest === undefined) halter();
-      else if (fs.existsSync(dest) === true)
-        halter("The target directory already exists.");
-
-      console.log("-----------------------------------------");
-      console.log(" Nestia Template Kit");
-      console.log("-----------------------------------------");
-
-      // COPY PROJECTS
-      execute(`git clone https://github.com/samchon/backend ${dest}`);
-      console.log(`cd "${dest}"`);
-      process.chdir(dest);
-
-      // INSTALL DEPENDENCIES
-      execute("npm install");
-
-      // BUILD TYPESCRIPT
-      execute("npm run build");
-
-      // REMOVE .GIT DIRECTORY
-      cp.execSync("npx rimraf .git");
-    };
-
-  function execute(command: string): void {
-    console.log(`\n$ ${command}`);
-    cp.execSync(command, { stdio: "inherit" });
-  }
+  export const clone = NestiaProjectTemplate.clone({
+    title: "Nestia Template Kit",
+    repository: "https://github.com/samchon/backend",
+    test: false,
+  });
 }

package/src/index.ts

@@ -3,8 +3,8 @@ const USAGE = `Wrong command has been detected. Use like below:
 
 npx nestia [command] [options?]
 
-  1. npx nestia start <directory>
-  2. npx nestia template <directory>
+  1. npx nestia start <directory> [--repository <url>]
+  2. npx nestia template <directory> [--repository <url>]
   3. npx nestia dependencies
   4. npx nestia init
   5. npx nestia sdk