create-express-esm 1.1.4 → 1.1.8

package/README.md

@@ -1,171 +1,171 @@
-# 🚀 Create Express ESM (CLI)
-
-> **Modern Express Generator**
->
-> "1초 만에 완성하는 Modern Express(ESM) 환경"
->
-> CommonJS(require)가 아닌, 최신 ES Modules(import/export) 문법을 기반으로 하는 Express 프로젝트 구조를 자동으로 생성해주는 CLI 도구입니다.
-
-[![npm version](https://img.shields.io/npm/v/create-express-esm.svg)](https://www.npmjs.com/package/create-express-esm)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-## ✨ Demo
-
-![Image](https://github.com/user-attachments/assets/10a7c289-ba5b-42a0-bfb8-6319610fef78)
-
-## ✨ Key Features (핵심 기능)
-
-기존 `express-generator`의 한계를 분석하고 개선하여 개발했습니다.
-
-- **⚡️ 100% ES Modules**: 구식 CommonJS(`require`)를 버리고 최신 `import/export` 문법을 기본으로 채택했습니다.
-- **🏗 Layered Architecture**: 실무 표준인 `Controller` - `Service` - `Model` 구조를 자동으로 잡아줍니다.
-- **📦 Auto Installation**: 프로젝트 생성 후 귀찮은 `npm install` 과정을 자동으로 수행합니다.
-- **🛠 Ready-to-Use**: `dotenv`, `cors`, `morgan`, `nodemon` 등 필수 개발 환경이 세팅되어 있습니다.
-
-## 🚀 Quick Start (사용법)
-
-별도의 설치 없이 `npx` 명령어로 즉시 실행할 수 있습니다.
-
-```bash
-npx create-express-esm
-npm create express-esm
-```
-
-또는 전역으로 설치하여 사용할 수도 있습니다
-
-```
-npm install -g create-express-esm
-create-express-esm
-```
-
-## 📂 Project Structure (폴더 구조)
-
-이 도구는 **Layered Architecture (계층형 아키텍처)**를 기반으로 프로젝트를 생성합니다.
-**관심사 분리(Separation of Concerns)** 원칙을 적용하여, 로직이 섞이지 않고 유지보수가 쉬운 구조를 제공합니다.
-
-```text
-my-app/
-├── src/
-│   ├── config/          # ⚙️ 환경변수 및 DB 연결 설정
-│   ├── controllers/     # 🕹️ 요청과 응답 처리 (Controller Layer)
-│   ├── models/          # 🗄️ 데이터베이스 스키마 (Data Access Layer)
-│   ├── routes/          # 🚦 API 라우팅 정의 (Route Definitions)
-│   ├── services/        # 🧠 비즈니스 로직 (Service Layer) - 핵심 로직!
-│   ├── app.js           # 🏗️ Express App 설정 (Middleware, CORS 등)
-│   └── server.js        # 🚀 서버 실행 진입점 (Entry Point)
-├── .env                 # 🔐 환경 변수 (Port, DB Key 등)
-├── .gitignore           # 🙈 Git 무시 설정
-└── package.json         # 📦 프로젝트 의존성 및 스크립트
-```
-
-## 🛠 Tech Stack (기술 스택)
-
-- **Runtime**: Node.js
-- **Framework**: Express.js
-- **Architecture**: Layered Pattern (Controller-Service-Model)
-- **Language**: JavaScript (ES6+ Modules)
-- **Tools**:
-  - `dotenv` (환경변수 관리)
-  - `cors` (Cross-Origin 리소스 공유 설정)
-  - `morgan` (HTTP 요청 로그 기록)
-  - `nodemon` (개발 생산성 향상/자동 재시작)
-
-## 🛠️ Engineering Deep Dive
-
-단순한 도구 개발을 넘어, Node.js의 런타임 환경과 모듈 시스템의 차이를 깊이 있게 이해하기 위해 진행한 프로젝트입니다.
-
-### - Project Motivation (Why)
-
-대부분의 Express 예제나 스캐폴딩 도구들이 여전히 CommonJS(require) 방식을 사용하고 있습니다. 하지만 최신 Node.js 생태계는 ES Modules(import)로 전환되고 있습니다.
-**"최신 문법을 지원하는 환경을 매번 수동으로 설정하는 비효율을 해결하자"**는 목표로 시작했으며, 프레임워크 없이 순수 Node.js의 `fs`, `path` 모듈을 다루며 CLI 도구의 동작 원리를 체득하고자 했습니다.
-
-### - Architecture
-
-1.  **비동기 파일 시스템 제어**: 대량의 템플릿 파일을 생성할 때 I/O 블로킹을 막기 위해 `fs.promises`와 `async/await`를 사용하여 안정적인 파일 쓰기 작업을 구현했습니다.
-2.  **동적 템플릿 생성**: 사용자가 입력한 프로젝트 이름을 `package.json` 등에 동적으로 주입하여, 생성 즉시 실행 가능한 상태를 보장합니다.
-
-## 🔥 Challenges & Troubleshooting
-
-개발 과정에서 마주친 기술적 난관과 해결 과정입니다.
-
-### 1. ESM 환경에서의 경로 시스템 구축 (Transition to ESM)
-
-> **🔴 Problem:** `ReferenceError: __dirname is not defined`
-
-프로젝트를 `type: "module"`(ESM)로 설정한 후, 템플릿 폴더 경로를 참조하기 위해 관습적으로 `__dirname`을 사용했으나 에러가 발생하며 앱이 종료되었습니다.
-
-**🔍 Root Cause & Solution**
-
-Node.js의 CommonJS 환경에서는 `__dirname`이 기본적으로 주입되지만, ESM 표준 스펙에는 이 변수가 존재하지 않습니다. 이를 해결하기 위해 `url`과 `path` 모듈을 조합하여 Polyfill(직접 구현) 했습니다.
-
-```javascript
-import path from "path";
-import { fileURLToPath } from "url";
-
-// 1. 현재 파일의 URL(file://...)을 시스템 경로로 변환
-const __filename = fileURLToPath(import.meta.url);
-
-// 2. 파일 경로에서 디렉토리 경로만 추출하여 __dirname 구현
-const __dirname = path.dirname(__filename);
-```
-
-### 2. CLI의 실행 위치와 파일 위치의 혼동 (Execution Context)
-
-> **🔴 Problem:** `ENOENT: no such file or directory`
-
-로컬 테스트(`node bin/cli.js`) 시에는 정상 작동했으나, `npm link` 후 다른 경로(바탕화면 등)에서 실행했을 때 템플릿 폴더를 찾지 못하는 문제가 발생했습니다.
-
-**🔍 Root Cause**
-
-CLI 도구 개발 시 **'코드의 위치(Source)'**와 **'명령어 실행 위치(Target)'**가 다를 수 있음을 간과했습니다. 템플릿을 찾을 때 `process.cwd()`(사용자 위치)를 기준으로 탐색했기 때문에 발생한 문제였습니다.
-
-**✅ Solution**
-
-리소스의 성격에 따라 기준 경로를 명확히 분리하여 해결했습니다.
-
-- **Source (Template)**: 코드가 설치된 곳에 항상 함께 존재하므로 `__dirname` 기준.
-- **Target (Project)**: 사용자가 명령어를 실행한 위치에 생성되어야 하므로 `process.cwd()` 기준.
-
-```javascript
-// [Source] 템플릿 경로: 내 코드가 설치된 곳 기준
-const templateDir = path.join(__dirname, "../template");
-
-// [Target] 생성 경로: 사용자가 명령어를 실행한 곳 기준
-const targetDir = path.join(process.cwd(), projectName);
-
-// Copy: Source -> Target
-await copyDir(templateDir, targetDir);
-```
-
-### 3. 배포 파이프라인 최적화 (Appropriate Technology)
-
-> **🔴 Problem**
-
-잦은 업데이트 과정에서 `버전 수정` -> `태그 생성` -> `깃 푸시` -> `npm 배포`라는 4단계 프로세스를 수동으로 반복하다 보니, 순서를 누락하거나 버전을 잘못 기입하는 휴먼 에러가 발생했습니다.
-
-**🔍 Approach & Solution**
-
-GitHub Actions와 같은 CI/CD 도구 도입을 고려했으나, 1인 개발 프로젝트 규모에 비해 설정 비용이 크고 오버엔지니어링이라는 판단이 들었습니다. 대신 Node.js의 내장 기능인 **NPM Scripts**를 활용하는 것이 가장 효율적인 **'적정 기술(Appropriate Technology)'**이라 판단했습니다.
-
-```json
-// package.json
-"scripts": {
-  // patch 버전 업 -> 깃 태그 푸시 -> npm 배포를 명령어 한 줄로 원자적(Atomic) 실행
-  "deploy": "npm version patch && git push origin main --tags && npm publish"
-}
-```
-
-## 📝 Retrospective
-
-- **Legacy to Modern**: Node.js 생태계가 CJS에서 ESM으로 전환되는 과도기에서 발생하는 호환성 문제를 직접 겪고 해결하며, 모던 자바스크립트 환경에 대한 이해도를 높였습니다.
-- **Consumer to Producer**: 항상 라이브러리를 사용하기만 하던 입장에서, 직접 도구를 만들어 배포하는 생산자가 되어봄으로써 오픈소스 생태계의 순환 구조를 체감했습니다.
-- **JavaScript to TypeScript (Next Step)**: 순수 ESM 환경을 구축하며 모듈 시스템은 표준화했으나, 컴파일 단계에서 오류를 잡을 수 없는 동적 타입 언어의 한계를 체감했습니다. 프로젝트의 안정성과 유지보수성을 높이기 위해 **TypeScript** 도입과 엄격한 타입 시스템의 필요성을 깨달았으며, 차기 버전에서는 이를 지원할 계획입니다.
-
-## 🗺️ Roadmap (Future Plans)
-
-- [ ] **TypeScript Support**: `tsconfig.json` 자동 설정 및 `.ts` 템플릿 지원
-- [ ] **Test Environment**: Jest/Supertest 설정 자동화
-
-## 📝 License
-
-This project is MIT licensed.
+# 🚀 Create Express ESM (CLI)
+
+> **Modern Express Generator**
+>
+> "1초 만에 완성하는 Modern Express(ESM) 환경"
+>
+> CommonJS(require)가 아닌, 최신 ES Modules(import/export) 문법을 기반으로 하는 Express 프로젝트 구조를 자동으로 생성해주는 CLI 도구입니다.
+
+[![npm version](https://img.shields.io/npm/v/create-express-esm.svg)](https://www.npmjs.com/package/create-express-esm)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## ✨ Demo
+
+![Image](https://github.com/user-attachments/assets/10a7c289-ba5b-42a0-bfb8-6319610fef78)
+
+## ✨ Key Features (핵심 기능)
+
+기존 `express-generator`의 한계를 분석하고 개선하여 개발했습니다.
+
+- **⚡️ 100% ES Modules**: 구식 CommonJS(`require`)를 버리고 최신 `import/export` 문법을 기본으로 채택했습니다.
+- **🏗 Layered Architecture**: 실무 표준인 `Controller` - `Service` - `Model` 구조를 자동으로 잡아줍니다.
+- **📦 Auto Installation**: 프로젝트 생성 후 귀찮은 `npm install` 과정을 자동으로 수행합니다.
+- **🛠 Ready-to-Use**: `dotenv`, `cors`, `morgan`, `nodemon` 등 필수 개발 환경이 세팅되어 있습니다.
+
+## 🚀 Quick Start (사용법)
+
+별도의 설치 없이 `npx` 명령어로 즉시 실행할 수 있습니다.
+
+```bash
+npx create-express-esm
+npm create express-esm
+```
+
+또는 전역으로 설치하여 사용할 수도 있습니다
+
+```
+npm install -g create-express-esm
+create-express-esm
+```
+
+## 📂 Project Structure (폴더 구조)
+
+이 도구는 **Layered Architecture (계층형 아키텍처)**를 기반으로 프로젝트를 생성합니다.
+**관심사 분리(Separation of Concerns)** 원칙을 적용하여, 로직이 섞이지 않고 유지보수가 쉬운 구조를 제공합니다.
+
+```text
+my-app/
+├── src/
+│   ├── config/          # ⚙️ 환경변수 및 DB 연결 설정
+│   ├── controllers/     # 🕹️ 요청과 응답 처리 (Controller Layer)
+│   ├── models/          # 🗄️ 데이터베이스 스키마 (Data Access Layer)
+│   ├── routes/          # 🚦 API 라우팅 정의 (Route Definitions)
+│   ├── services/        # 🧠 비즈니스 로직 (Service Layer) - 핵심 로직!
+│   ├── app.js           # 🏗️ Express App 설정 (Middleware, CORS 등)
+│   └── server.js        # 🚀 서버 실행 진입점 (Entry Point)
+├── .env                 # 🔐 환경 변수 (Port, DB Key 등)
+├── .gitignore           # 🙈 Git 무시 설정
+└── package.json         # 📦 프로젝트 의존성 및 스크립트
+```
+
+## 🛠 Tech Stack (기술 스택)
+
+- **Runtime**: Node.js
+- **Framework**: Express.js
+- **Architecture**: Layered Pattern (Controller-Service-Model)
+- **Language**: JavaScript (ES6+ Modules)
+- **Tools**:
+  - `dotenv` (환경변수 관리)
+  - `cors` (Cross-Origin 리소스 공유 설정)
+  - `morgan` (HTTP 요청 로그 기록)
+  - `nodemon` (개발 생산성 향상/자동 재시작)
+
+## 🛠️ Engineering Deep Dive
+
+단순한 도구 개발을 넘어, Node.js의 런타임 환경과 모듈 시스템의 차이를 깊이 있게 이해하기 위해 진행한 프로젝트입니다.
+
+### - Project Motivation (Why)
+
+대부분의 Express 예제나 스캐폴딩 도구들이 여전히 CommonJS(require) 방식을 사용하고 있습니다. 하지만 최신 Node.js 생태계는 ES Modules(import)로 전환되고 있습니다.
+**"최신 문법을 지원하는 환경을 매번 수동으로 설정하는 비효율을 해결하자"**는 목표로 시작했으며, 프레임워크 없이 순수 Node.js의 `fs`, `path` 모듈을 다루며 CLI 도구의 동작 원리를 체득하고자 했습니다.
+
+### - Architecture
+
+1.  **비동기 파일 시스템 제어**: 대량의 템플릿 파일을 생성할 때 I/O 블로킹을 막기 위해 `fs.promises`와 `async/await`를 사용하여 안정적인 파일 쓰기 작업을 구현했습니다.
+2.  **동적 템플릿 생성**: 사용자가 입력한 프로젝트 이름을 `package.json` 등에 동적으로 주입하여, 생성 즉시 실행 가능한 상태를 보장합니다.
+
+## 🔥 Challenges & Troubleshooting
+
+개발 과정에서 마주친 기술적 난관과 해결 과정입니다.
+
+### 1. ESM 환경에서의 경로 시스템 구축 (Transition to ESM)
+
+> **🔴 Problem:** `ReferenceError: __dirname is not defined`
+
+프로젝트를 `type: "module"`(ESM)로 설정한 후, 템플릿 폴더 경로를 참조하기 위해 관습적으로 `__dirname`을 사용했으나 에러가 발생하며 앱이 종료되었습니다.
+
+**🔍 Root Cause & Solution**
+
+Node.js의 CommonJS 환경에서는 `__dirname`이 기본적으로 주입되지만, ESM 표준 스펙에는 이 변수가 존재하지 않습니다. 이를 해결하기 위해 `url`과 `path` 모듈을 조합하여 Polyfill(직접 구현) 했습니다.
+
+```javascript
+import path from "path";
+import { fileURLToPath } from "url";
+
+// 1. 현재 파일의 URL(file://...)을 시스템 경로로 변환
+const __filename = fileURLToPath(import.meta.url);
+
+// 2. 파일 경로에서 디렉토리 경로만 추출하여 __dirname 구현
+const __dirname = path.dirname(__filename);
+```
+
+### 2. CLI의 실행 위치와 파일 위치의 혼동 (Execution Context)
+
+> **🔴 Problem:** `ENOENT: no such file or directory`
+
+로컬 테스트(`node bin/cli.js`) 시에는 정상 작동했으나, `npm link` 후 다른 경로(바탕화면 등)에서 실행했을 때 템플릿 폴더를 찾지 못하는 문제가 발생했습니다.
+
+**🔍 Root Cause**
+
+CLI 도구 개발 시 **'코드의 위치(Source)'**와 **'명령어 실행 위치(Target)'**가 다를 수 있음을 간과했습니다. 템플릿을 찾을 때 `process.cwd()`(사용자 위치)를 기준으로 탐색했기 때문에 발생한 문제였습니다.
+
+**✅ Solution**
+
+리소스의 성격에 따라 기준 경로를 명확히 분리하여 해결했습니다.
+
+- **Source (Template)**: 코드가 설치된 곳에 항상 함께 존재하므로 `__dirname` 기준.
+- **Target (Project)**: 사용자가 명령어를 실행한 위치에 생성되어야 하므로 `process.cwd()` 기준.
+
+```javascript
+// [Source] 템플릿 경로: 내 코드가 설치된 곳 기준
+const templateDir = path.join(__dirname, "../template");
+
+// [Target] 생성 경로: 사용자가 명령어를 실행한 곳 기준
+const targetDir = path.join(process.cwd(), projectName);
+
+// Copy: Source -> Target
+await copyDir(templateDir, targetDir);
+```
+
+### 3. 배포 파이프라인 최적화 (Appropriate Technology)
+
+> **🔴 Problem**
+
+잦은 업데이트 과정에서 `버전 수정` -> `태그 생성` -> `깃 푸시` -> `npm 배포`라는 4단계 프로세스를 수동으로 반복하다 보니, 순서를 누락하거나 버전을 잘못 기입하는 휴먼 에러가 발생했습니다.
+
+**🔍 Approach & Solution**
+
+GitHub Actions와 같은 CI/CD 도구 도입을 고려했으나, 1인 개발 프로젝트 규모에 비해 설정 비용이 크고 오버엔지니어링이라는 판단이 들었습니다. 대신 Node.js의 내장 기능인 **NPM Scripts**를 활용하는 것이 가장 효율적인 **'적정 기술(Appropriate Technology)'**이라 판단했습니다.
+
+```json
+// package.json
+"scripts": {
+  // patch 버전 업 -> 깃 태그 푸시 -> npm 배포를 명령어 한 줄로 원자적(Atomic) 실행
+  "deploy": "npm version patch && git push origin main --tags && npm publish"
+}
+```
+
+## 📝 Retrospective
+
+- **Legacy to Modern**: Node.js 생태계가 CJS에서 ESM으로 전환되는 과도기에서 발생하는 호환성 문제를 직접 겪고 해결하며, 모던 자바스크립트 환경에 대한 이해도를 높였습니다.
+- **Consumer to Producer**: 항상 라이브러리를 사용하기만 하던 입장에서, 직접 도구를 만들어 배포하는 생산자가 되어봄으로써 오픈소스 생태계의 순환 구조를 체감했습니다.
+- **JavaScript to TypeScript (Next Step)**: 순수 ESM 환경을 구축하며 모듈 시스템은 표준화했으나, 컴파일 단계에서 오류를 잡을 수 없는 동적 타입 언어의 한계를 체감했습니다. 프로젝트의 안정성과 유지보수성을 높이기 위해 **TypeScript** 도입과 엄격한 타입 시스템의 필요성을 깨달았으며, 차기 버전에서는 이를 지원할 계획입니다.
+
+## 🗺️ Roadmap (Future Plans)
+
+- [ ] **TypeScript Support**: `tsconfig.json` 자동 설정 및 `.ts` 템플릿 지원
+- [ ] **Test Environment**: Jest/Supertest 설정 자동화
+
+## 📝 License
+
+This project is MIT licensed.

package/bin/cli.js

@@ -1,110 +1,164 @@
 #!/usr/bin/env node
-
-import { input, select } from '@inquirer/prompts'; // 현대적인 방식으로 교체
-import fs from 'fs-extra';
-import path from 'path';
-import chalk from 'chalk';
-import { execSync } from 'child_process';
-import { fileURLToPath } from 'url';
-
-// ESM에서 __dirname 사용하기 위한 설정
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// 1.2.0 버전 정보 및 메인 로직
-async function run() {
-  console.log(chalk.blue.bold('\n🚀 Create Express ESM 시작!\n'));
-
-  try {
-    // 1. 사용자 질문 (비동기 함수 방식으로 변경)
-    const projectName = await input({
-      message: '생성할 프로젝트 이름을 입력하세요:',
-      default: 'my-app',
-    });
-
-    const language = await select({
-      message: '사용할 언어를 선택하세요:',
-      choices: [
-        { name: 'JavaScript (ESM)', value: 'js' },
-        { name: 'TypeScript', value: 'ts' },
-      ],
-    });
-
-    const targetPath = path.join(process.cwd(), projectName);
-    const templatePath = path.join(__dirname, '../template', language);
-
-    // 2. 폴더 존재 여부 확인
-    if (fs.existsSync(targetPath)) {
-      console.error(chalk.red(`\n❌ 오류: '${projectName}' 폴더가 이미 존재합니다.`));
-      process.exit(1);
-    }
-
-    // 3. 템플릿 복사
-    console.log(chalk.cyan(`\n📂 [${language.toUpperCase()}] 템플릿을 복사하는 중...`));
-    
-    if (!fs.existsSync(templatePath)) {
-      console.error(chalk.red(`\n❌ 오류: ${language} 템플릿 폴더를 찾을 수 없습니다.`));
-      console.log(chalk.gray(`경로 확인: ${templatePath}`));
-      process.exit(1);
-    }
-
-    await fs.copy(templatePath, targetPath);
-
-    // 4. 도트 파일 변환 및 환경 설정
-    const renameMap = {
-      'gitignore': '.gitignore',
-      '_gitignore': '.gitignore',
-      '_env': '.env'
-    };
-
-    for (const [oldName, newName] of Object.entries(renameMap)) {
-      const oldFilePath = path.join(targetPath, oldName);
-      const newFilePath = path.join(targetPath, newName);
-
-      if (await fs.pathExists(oldFilePath)) {
-        await fs.move(oldFilePath, newFilePath, { overwrite: true });
-        if (newName === '.env') {
-          const exampleEnvPath = path.join(targetPath, '.env.example');
-          await fs.copy(newFilePath, exampleEnvPath);
-        }
-      }
-    }
-    
-    // 5. package.json 프로젝트 이름 수정
-    const pkgPath = path.join(targetPath, 'package.json');
-    if (await fs.pathExists(pkgPath)) {
-      const pkg = await fs.readJson(pkgPath);
-      pkg.name = projectName;
-      await fs.writeJson(pkgPath, pkg, { spaces: 2 });
-    }
-    
-    console.log(chalk.green(`✅ 템플릿 구성 완료!`));
-
-    // 6. 패키지 자동 설치
-    console.log(chalk.yellow(`\n📦 패키지 자동 설치를 진행합니다... (npm install)`));
-    
-    execSync('npm install', { 
-      cwd: targetPath, 
-      stdio: 'inherit' 
-    });
-
-    console.log(chalk.green(`\n✨ 모든 설치가 완료되었습니다!`));
-    console.log(chalk.white(`\n다음 명령어로 시작하세요:\n`));
-    console.log(chalk.cyan(`   cd ${projectName}`));
-    if (language === 'ts') {
-      console.log(chalk.cyan(`   npm run dev (또는 npm run build)`));
-    } else {
-      console.log(chalk.cyan(`   npm run dev`));
-    }
-    console.log('\n');
-
-  } catch (error) {
-    if (error.name === 'ExitPromptError') {
-      console.log(chalk.yellow('\n\n👋 설치를 중단했습니다.'));
-    } else {
-      console.error(chalk.red('\n❌ 오류 발생:'), error);
-    }
-  }
-}
-
+
+import { input, select, confirm } from '@inquirer/prompts';
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+async function run() {
+  console.log(chalk.blue.bold('\n🚀 Create Express ESM 시작!\n'));
+
+  try {
+    // 1. 사용자 질문
+    const projectName = await input({
+      message: '생성할 프로젝트 이름을 입력하세요:',
+      default: 'my-app',
+    });
+
+    const language = await select({
+      message: '사용할 언어를 선택하세요:',
+      choices: [
+        { name: 'JavaScript (ESM)', value: 'js' },
+        { name: 'TypeScript', value: 'ts' },
+      ],
+    });
+
+    const useTest = await confirm({
+      message: 'Vitest 테스트 환경을 추가하시겠습니까?',
+      default: true,
+    });
+
+    const targetPath = path.join(process.cwd(), projectName);
+    const templatePath = path.join(__dirname, '../template', language);
+
+    // 2. 폴더 존재 여부 확인
+    if (fs.existsSync(targetPath)) {
+      console.error(chalk.red(`\n❌ 오류: '${projectName}' 폴더가 이미 존재합니다.`));
+      process.exit(1);
+    }
+
+    // 3. 기본 템플릿 복사
+    console.log(chalk.cyan(`\n📂 [${language.toUpperCase()}] 템플릿 구성을 시작합니다...`));
+    await fs.copy(templatePath, targetPath);
+
+    // 4. 도트 파일 변환 (_env -> .env 등)
+    const renameMap = {
+      'gitignore': '.gitignore',
+      '_gitignore': '.gitignore',
+      '_env': '.env'
+    };
+
+    for (const [oldName, newName] of Object.entries(renameMap)) {
+      const oldFilePath = path.join(targetPath, oldName);
+      const newFilePath = path.join(targetPath, newName);
+      if (await fs.pathExists(oldFilePath)) {
+        await fs.move(oldFilePath, newFilePath, { overwrite: true });
+        if (newName === '.env') {
+          await fs.copy(newFilePath, path.join(targetPath, '.env.example'));
+        }
+      }
+    }
+    
+    // 5. package.json 동적 수정
+    const pkgPath = path.join(targetPath, 'package.json');
+    const pkg = await fs.readJson(pkgPath);
+    pkg.name = projectName;
+
+    // [추가된 부분] TypeScript 환경에서 ESM 에러를 방지하기 위한 tsx 설정
+    if (language === 'ts') {
+      console.log(chalk.yellow(`⚙️  TypeScript ESM 실행 환경(tsx)을 최적화하는 중...`));
+      
+      // ts-node 대신 tsx를 사용하여 .js 확장자 임포트 문제 해결
+      pkg.scripts.dev = "nodemon --exec tsx src/server.ts";
+      
+      // 의존성 교체
+      pkg.devDependencies = {
+        ...pkg.devDependencies,
+        "tsx": "^4.7.0"
+      };
+      
+      // 기존에 ts-node가 있다면 제거 (중복 방지)
+      delete pkg.devDependencies['ts-node'];
+    }
+
+    // Vitest 설정 (이슈 #3 구현 부분)
+    if (useTest) {
+      console.log(chalk.yellow(`🧪 Vitest 설정 및 샘플 테스트를 생성하는 중...`));
+      
+      pkg.scripts = {
+        ...pkg.scripts,
+        "test": "vitest",
+        "test:ui": "vitest --ui",
+        "test:run": "vitest run"
+      };
+
+      const testDeps = {
+        "vitest": "^1.0.0",
+        "supertest": "^6.3.3"
+      };
+
+      if (language === 'ts') {
+        testDeps["@types/supertest"] = "^2.0.12";
+      }
+
+      pkg.devDependencies = {
+        ...pkg.devDependencies,
+        ...testDeps
+      };
+
+      // Vitest 설정 파일 생성
+      const configExt = language === 'ts' ? 'ts' : 'js';
+      const configContent = `import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+  },
+});`;
+      await fs.writeFile(path.join(targetPath, `vitest.config.${configExt}`), configContent);
+
+      // 샘플 테스트 파일 생성
+      const testFileExt = language === 'ts' ? 'ts' : 'js';
+      const testContent = `import { describe, it, expect } from 'vitest';
+import request from 'supertest';
+import app from './app.js';
+
+describe('API Health Check Test', () => {
+  it('GET / 요청이 성공해야 한다', async () => {
+    const res = await request(app).get('/');
+    expect(res.status).toBe(200);
+    expect(res.text).toContain('Server is Running');
+  });
+});`;
+      await fs.writeFile(path.join(targetPath, `src/app.test.${testFileExt}`), testContent);
+    }
+
+    await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+    console.log(chalk.green(`✅ 모든 구성 완료!`));
+
+    // 6. 패키지 자동 설치
+    console.log(chalk.yellow(`\n📦 의존성 패키지를 설치합니다... (npm install)`));
+    execSync('npm install', { cwd: targetPath, stdio: 'inherit' });
+
+    console.log(chalk.green(`\n✨ 프로젝트 생성 성공!`));
+    console.log(chalk.white(`\n다음 명령어를 입력해 보세요:\n`));
+    console.log(chalk.cyan(`   cd ${projectName}`));
+    if (useTest) console.log(chalk.cyan(`   npm test`));
+    console.log(chalk.cyan(`   npm run dev\n`));
+
+  } catch (error) {
+    if (error.name === 'ExitPromptError') { // 오타 수정: ExitPnromptError -> ExitPromptError
+      console.log(chalk.yellow('\n\n👋 설치를 중단했습니다.'));
+    } else {
+      console.error(chalk.red('\n❌ 오류 발생:'), error);
+    }
+  }
+}
+
 run();

package/package.json

@@ -1,40 +1,44 @@
-{
-  "name": "create-express-esm",
-  "version": "1.1.4",
-  "description": "A modern CLI tool to bootstrap Express.js applications with ES Modules and Layered Architecture.",
-  "main": "index.js",
-  "type": "module",
-  "bin": {
-    "create-express-esm": "bin/cli.js"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/munjuin/create-express-esm.git"
-  },
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "deploy": "npm version patch && git push origin main --tags && npm publish"
-  },
-  "keywords": [
-    "express",
-    "esm",
-    "cli",
-    "boilerplate"
-  ],
-  "author": "munjuin",
-  "license": "MIT",
-  "dependencies": {
-    "chalk": "^5.6.2",
-    "commander": "^14.0.2",
-    "fs-extra": "^11.3.2",
-    "inquirer": "^13.0.1"
-  },
-  "files": [
-    "bin",
-    "template"
-  ],
-  "bugs": {
-    "url": "https://github.com/munjuin/create-express-esm/issues"
-  },
-  "homepage": "https://github.com/munjuin/create-express-esm#readme"
-}
+{
+  "name": "create-express-esm",
+  "version": "1.1.8",
+  "description": "A modern CLI tool to bootstrap Express.js applications with ES Modules and Layered Architecture.",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "create-express-esm": "bin/cli.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/munjuin/create-express-esm.git"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "release": "npm version patch && git push origin main --tags"
+  },
+  "keywords": [
+    "express",
+    "esm",
+    "cli",
+    "boilerplate"
+  ],
+  "author": "munjuin",
+  "license": "MIT",
+  "dependencies": {
+    "@inquirer/prompts": "^8.1.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.2",
+    "fs-extra": "^11.3.2",
+    "inquirer": "^13.0.1"
+  },
+  "files": [
+    "bin",
+    "template"
+  ],
+  "bugs": {
+    "url": "https://github.com/munjuin/create-express-esm/issues"
+  },
+  "homepage": "https://github.com/munjuin/create-express-esm#readme",
+  "devDependencies": {
+    "tsx": "^4.21.0"
+  }
+}

package/template/js/_env

@@ -1,2 +1,2 @@
-PORT=8080PORT=3000
+PORT=8080PORT=3000
 NODE_ENV=development

package/template/js/_gitignore

@@ -1,18 +1,18 @@
-# Dependency directories
-node_modules/
-
-# Build output
-dist/
-
-# Environment variables
-.env
-.env.example
-
-# Debug logs
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# OS files
-.DS_Store
+# Dependency directories
+node_modules/
+
+# Build output
+dist/
+
+# Environment variables
+.env
+.env.example
+
+# Debug logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# OS files
+.DS_Store
 Thumbs.db

package/template/js/package.json

@@ -1,19 +1,19 @@
-{
-  "name": "my-express-app",
-  "version": "1.0.0",
-  "type": "module",
-  "scripts": {
-    "start": "node src/server.js",
-    "dev": "nodemon src/server.js"
-  },
-  "dependencies": {
-    "express": "^4.18.2",
-    "cors": "^2.8.5",
-    "dotenv": "^16.3.1",
-    "morgan": "^1.10.0",
-    "helmet": "^7.1.0"
-  },
-  "devDependencies": {
-    "nodemon": "^3.0.2"
-  }
+{
+  "name": "my-express-app",
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "start": "node src/server.js",
+    "dev": "nodemon src/server.js"
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "cors": "^2.8.5",
+    "dotenv": "^16.3.1",
+    "morgan": "^1.10.0",
+    "helmet": "^7.1.0"
+  },
+  "devDependencies": {
+    "nodemon": "^3.0.2"
+  }
 }

package/template/js/src/app.js

@@ -1,19 +1,19 @@
-import express from 'express';
-import cors from 'cors';
-import morgan from 'morgan';
-import dotenv from 'dotenv';
-
-import userRoutes from './routes/userRoutes.js';
-
-const app = express();
-
-app.use(cors());
-app.use(morgan('dev'));
-app.use(express.json());
-
-// 라우터 연결 (Layered Arch 시작점)
-app.use('/api/users', userRoutes);
-
-app.get('/', (req, res) => res.send('Welcome to Modern Express!'));
-
+import express from 'express';
+import cors from 'cors';
+import morgan from 'morgan';
+import dotenv from 'dotenv';
+
+import userRoutes from './routes/userRoutes.js';
+
+const app = express();
+
+app.use(cors());
+app.use(morgan('dev'));
+app.use(express.json());
+
+// 라우터 연결 (Layered Arch 시작점)
+app.use('/api/users', userRoutes);
+
+app.get('/', (req, res) => res.send('Welcome to Modern Express!'));
+
 export default app;

package/template/js/src/controllers/userController.js

@@ -1,10 +1,10 @@
-import * as userService from '../services/userService.js';
-
-export const getUsers = async (req, res) => {
-  try {
-    const users = await userService.findAllUsers(); // 서비스 호출
-    res.json(users);
-  } catch (error) {
-    res.status(500).json({ message: error.message });
-  }
+import * as userService from '../services/userService.js';
+
+export const getUsers = async (req, res) => {
+  try {
+    const users = await userService.findAllUsers(); // 서비스 호출
+    res.json(users);
+  } catch (error) {
+    res.status(500).json({ message: error.message });
+  }
 };

package/template/js/src/routes/userRoutes.js

@@ -1,8 +1,8 @@
-import express from 'express';
-import * as userController from '../controllers/userController.js';
-
-const router = express.Router();
-
-router.get('/', userController.getUsers);
-
+import express from 'express';
+import * as userController from '../controllers/userController.js';
+
+const router = express.Router();
+
+router.get('/', userController.getUsers);
+
 export default router;

package/template/js/src/server.js

@@ -1,9 +1,9 @@
-import app from './app.js';
-import dotenv from 'dotenv';
-
-dotenv.config();
-const PORT = process.env.PORT || 3000;
-
-app.listen(PORT, () => {
-  console.log(`🚀 Server running on http://localhost:${PORT}`);
+import app from './app.js';
+import dotenv from 'dotenv';
+
+dotenv.config();
+const PORT = process.env.PORT || 3000;
+
+app.listen(PORT, () => {
+  console.log(`🚀 Server running on http://localhost:${PORT}`);
 });

package/template/js/src/services/userService.js

@@ -1,8 +1,8 @@
-// 나중에는 여기서 Model(DB)을 호출합니다.
-export const findAllUsers = async () => {
-  // 비즈니스 로직 처리...
-  return [
-    { id: 1, name: "Developer Lee", role: "Fullstack" },
-    { id: 2, name: "Genius AI", role: "Assistant" }
-  ];
+// 나중에는 여기서 Model(DB)을 호출합니다.
+export const findAllUsers = async () => {
+  // 비즈니스 로직 처리...
+  return [
+    { id: 1, name: "Developer Lee", role: "Fullstack" },
+    { id: 2, name: "Genius AI", role: "Assistant" }
+  ];
 };

package/template/ts/package.json

@@ -1,23 +1,23 @@
-{
-  "name": "temp-name",
-  "version": "1.0.0",
-  "type": "module",
-  "scripts": {
-    "start": "node dist/server.js",
-    "dev": "nodemon --exec ts-node src/server.ts",
-    "build": "tsc"
-  },
-  "dependencies": {
-    "express": "^4.18.2",
-    "dotenv": "^16.3.1",
-    "cors": "^2.8.5"
-  },
-  "devDependencies": {
-    "typescript": "^5.0.0",
-    "@types/express": "^4.17.17",
-    "@types/node": "^20.0.0",
-    "@types/cors": "^2.8.13",
-    "ts-node": "^10.9.1",
-    "nodemon": "^3.0.1"
-  }
+{
+  "name": "temp-name",
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "nodemon --exec tsx src/server.ts",
+    "build": "tsc",
+    "start": "node dist/server.js"
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "dotenv": "^16.3.1",
+    "cors": "^2.8.5"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/express": "^4.17.17",
+    "@types/node": "^20.0.0",
+    "@types/cors": "^2.8.13",
+    "ts-node": "^10.9.1",
+    "nodemon": "^3.0.1"
+  }
 }

package/template/ts/src/app.ts

@@ -1,20 +1,20 @@
-import express, { Application, Request, Response } from 'express';
-import cors from 'cors';
-import userRoutes from './routes/userRoutes.js';
-
-const app: Application = express();
-
-// Middleware
-app.use(cors());
-app.use(express.json());
-app.use(express.urlencoded({ extended: true }));
-
-// Routes
-app.use('/api/users', userRoutes);
-
-// Health Check
-app.get('/', (req: Request, res: Response) => {
-  res.send('Create Express ESM (TypeScript) Server is Running!');
-});
-
+import express, { Application, Request, Response } from 'express';
+import cors from 'cors';
+import userRoutes from './routes/userRoutes.js';
+
+const app: Application = express();
+
+// Middleware
+app.use(cors());
+app.use(express.json());
+app.use(express.urlencoded({ extended: true }));
+
+// Routes
+app.use('/api/users', userRoutes);
+
+// Health Check
+app.get('/', (req: Request, res: Response) => {
+  res.send('Create Express ESM (TypeScript) Server is Running!');
+});
+
 export default app;

package/template/ts/src/controllers/userController.ts

@@ -1,17 +1,17 @@
-import { Request, Response } from 'express';
-import * as userService from '../services/userService.js';
-
-export const getUsers = async (req: Request, res: Response): Promise<void> => {
-  try {
-    const users = await userService.fetchAllUsers();
-    res.status(200).json({
-      success: true,
-      data: users,
-    });
-  } catch (error) {
-    res.status(500).json({
-      success: false,
-      message: 'Internal Server Error',
-    });
-  }
+import { Request, Response } from 'express';
+import * as userService from '../services/userService.js';
+
+export const getUsers = async (req: Request, res: Response): Promise<void> => {
+  try {
+    const users = await userService.fetchAllUsers();
+    res.status(200).json({
+      success: true,
+      data: users,
+    });
+  } catch (error) {
+    res.status(500).json({
+      success: false,
+      message: 'Internal Server Error',
+    });
+  }
 };

package/template/ts/src/routes/userRoutes.ts

@@ -1,8 +1,8 @@
-import { Router } from 'express';
-import * as userController from '../controllers/userController.js';
-
-const router = Router();
-
-router.get('/', userController.getUsers);
-
+import { Router } from 'express';
+import * as userController from '../controllers/userController.js';
+
+const router = Router();
+
+router.get('/', userController.getUsers);
+
 export default router;

package/template/ts/src/server.ts

@@ -1,8 +1,8 @@
-import 'dotenv/config';
-import app from './app.js';
-
-const PORT = process.env.PORT || 3000;
-
-app.listen(PORT, () => {
-  console.log(`🚀 Server is running on http://localhost:${PORT}`);
+import 'dotenv/config';
+import app from './app.js';
+
+const PORT = process.env.PORT || 3000;
+
+app.listen(PORT, () => {
+  console.log(`🚀 Server is running on http://localhost:${PORT}`);
 });

package/template/ts/src/services/userService.ts

@@ -1,14 +1,14 @@
-// 유저 데이터 타입 정의
-interface User {
-  id: number;
-  name: string;
-  email: string;
-}
-
-export const fetchAllUsers = async (): Promise<User[]> => {
-  // 실제 DB 연동 대신 샘플 데이터를 반환합니다.
-  return [
-    { id: 1, name: 'Owner', email: 'owner@example.com' },
-    { id: 2, name: 'Gemini', email: 'gemini@ai.com' },
-  ];
+// 유저 데이터 타입 정의
+interface User {
+  id: number;
+  name: string;
+  email: string;
+}
+
+export const fetchAllUsers = async (): Promise<User[]> => {
+  // 실제 DB 연동 대신 샘플 데이터를 반환합니다.
+  return [
+    { id: 1, name: 'Owner', email: 'owner@example.com' },
+    { id: 2, name: 'Gemini', email: 'gemini@ai.com' },
+  ];
 };

package/template/ts/tsconfig.json

@@ -1,15 +1,15 @@
-{
-  "compilerOptions": {
-    "target": "ESNext",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules"]
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules"]
 }