tylersong 1.0.8 → 1.0.10

package/dist/index.js

@@ -3,15 +3,37 @@ import inquirer from "inquirer";
 import chalk from "chalk";
 import { program } from "commander";
 import { exec } from "child_process";
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+// package.json에서 버전 동적으로 읽기
+const getPackageVersion = () => {
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        const packagePath = join(__dirname, "..", "package.json");
+        const packageJson = JSON.parse(readFileSync(packagePath, "utf-8"));
+        return packageJson.version;
+    }
+    catch (error) {
+        console.error(chalk.red("⚠️  버전 정보를 읽을 수 없습니다."));
+        return "1.0.0";
+    }
+};
 const openUrl = (url) => {
     const command = process.platform === "win32"
         ? "start"
         : process.platform === "darwin"
             ? "open"
             : "xdg-open";
-    exec(`${command} ${url}`);
+    exec(`${command} ${url}`, (error) => {
+        if (error) {
+            console.error(chalk.red("❌ 브라우저를 열 수 없습니다."));
+            console.error(chalk.yellow(`수동으로 방문해주세요: ${url}`));
+        }
+    });
 };
-program.version("1.0.8");
+program.version(getPackageVersion());
 program.option("-g, --github", "GitHub 프로필 열기");
 program.parse(process.argv);
 const options = program.opts();
@@ -21,9 +43,10 @@ if (Object.keys(options).length > 0) {
     process.exit(0);
 }
 const main = async () => {
-    // 도움말 옵션 체크
-    if (process.argv.includes("--help")) {
-        console.log(chalk.yellow(`
+    try {
+        // 도움말 옵션 체크
+        if (process.argv.includes("--help")) {
+            console.log(chalk.yellow(`
       ╭───────────────────────────────╮
       │         사용 방법             │
       ├───────────────────────────────┤
@@ -35,36 +58,51 @@ const main = async () => {
       │   -h, --help     도움말       │
       ╰───────────────────────────────╯
     `));
-        process.exit(0);
-    }
-    // 사용자 질문
-    const answer = await inquirer.prompt([
-        {
-            type: "confirm",
-            name: "showInfo",
-            message: chalk.cyan("✨ 저에 대해 궁금하신가요?"),
-            default: true,
-        },
-    ]);
-    if (answer.showInfo) {
-        console.log(chalk.bold.cyan(`
+            process.exit(0);
+        }
+        // 사용자 질문
+        const answer = await inquirer.prompt([
+            {
+                type: "confirm",
+                name: "showInfo",
+                message: chalk.cyan("✨ 저에 대해 궁금하신가요?"),
+                default: true,
+            },
+        ]);
+        if (answer.showInfo) {
+            console.log(chalk.bold.cyan(`
       ╭───────────────────────────────────────────╮
       │    🚀 Developer Profile 🚀      │
       ╰───────────────────────────────────────────╯
       
       `) +
-            chalk.green(`👋 안녕하세요!
+                chalk.green(`👋 안녕하세요!
       💻 개발자 ${chalk.bold.yellow("송민성")}입니다.
 
       `) +
-            chalk.hex("#fef6e1")(`📌 Github: ${chalk.underline.whiteBright(`https://github.com/alstjd0051`)}
+                chalk.hex("#fef6e1")(`📌 Github: ${chalk.underline.whiteBright(`https://github.com/alstjd0051`)}
       `) +
-            chalk.blue(`✉️  E-mail: ${chalk.underline.whiteBright(`wsc7202@gmail.com`)}
+                chalk.blue(`✉️  E-mail: ${chalk.underline.whiteBright(`wsc7202@gmail.com`)}
       `) +
-            chalk.magenta(`
+                chalk.magenta(`
       💡 더 많은 정보는 ${chalk.bold("--help")}를 통해 확인해주세요.
       `));
+        }
+    }
+    catch (error) {
+        console.error(chalk.red("\n❌ 오류가 발생했습니다:"));
+        if (error instanceof Error) {
+            console.error(chalk.yellow(error.message));
+        }
+        else {
+            console.error(chalk.yellow("알 수 없는 오류가 발생했습니다."));
+        }
+        process.exit(1);
     }
 };
-main().catch(console.error);
+main().catch((error) => {
+    console.error(chalk.red("\n❌ 치명적인 오류가 발생했습니다:"));
+    console.error(error);
+    process.exit(1);
+});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAUrC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAQ,EAAE;IACpC,MAAM,OAAO,GACX,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC1B,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,QAAQ;YAC/B,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,UAAU,CAAC;IACjB,IAAI,CAAC,GAAG,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAEzB,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;AAEhD,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,MAAM,OAAO,GAAmB,OAAO,CAAC,IAAI,EAAE,CAAC;AAE/C,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IACpC,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;IACrC,YAAY;IACZ,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CAAC;;;;;;;;;;;KAWd,CAAC,CACD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,SAAS;IACT,MAAM,MAAM,GAAe,MAAM,QAAQ,CAAC,MAAM,CAAC;QAC/C;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC;YACtC,OAAO,EAAE,IAAI;SACd;KACF,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;OAKf,CAAC;YACA,KAAK,CAAC,KAAK,CAAC;eACL,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;;OAEhC,CAAC;YACA,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,cAAc,KAAK,CAAC,SAAS,CAAC,WAAW,CAC5D,+BAA+B,CAChC;OACF,CAAC;YACA,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,SAAS,CAAC,WAAW,CACnD,mBAAmB,CACpB;OACF,CAAC;YACA,KAAK,CAAC,OAAO,CAAC;oBACF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;OACjC,CAAC,CACH,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/docs/development.md

@@ -0,0 +1,394 @@
+# 개발 가이드
+
+## 개발 환경 요구사항
+
+### 필수 요구사항
+
+- **Node.js**: 18.x 이상
+- **Bun**: 최신 버전 (권장)
+- **Git**: 버전 관리
+- **에디터**: VS Code 또는 기타 TypeScript 지원 에디터
+
+### Bun 설치
+
+```bash
+# macOS/Linux
+curl -fsSL https://bun.sh/install | bash
+
+# Windows (PowerShell)
+powershell -c "irm bun.sh/install.ps1 | iex"
+
+# 또는 npm을 통해
+npm install -g bun
+```
+
+## 프로젝트 설정
+
+### 1. 저장소 클론
+
+```bash
+git clone https://github.com/alstjd0051/npm_readMe.git
+cd npm_readMe
+```
+
+### 2. 의존성 설치
+
+```bash
+# Bun 사용 (권장)
+bun install
+
+# 또는 npm 사용
+npm install
+```
+
+### 3. 개발 서버 실행
+
+```bash
+# Bun으로 직접 실행
+bun run dev:bun
+
+# 또는 tsx 사용
+bun run dev
+```
+
+## 프로젝트 구조
+
+```
+npm_readMe/
+├── .github/
+│   └── workflows/          # GitHub Actions 워크플로우
+│       ├── ci.yml          # 지속적 통합
+│       └── publish.yml     # NPM 배포
+├── docs/                   # 문서
+│   ├── testing.md          # 테스트 가이드
+│   ├── pipeline.md         # CI/CD 파이프라인
+│   ├── development.md      # 개발 가이드 (이 파일)
+│   └── ...
+├── src/
+│   └── index.ts            # 메인 소스 코드
+├── test/
+│   └── index.test.ts       # 테스트 파일
+├── dist/                   # 빌드 출력 (gitignore)
+├── .eslintrc.json          # ESLint 설정
+├── .prettierrc             # Prettier 설정
+├── .editorconfig           # 에디터 설정
+├── .gitignore              # Git ignore 규칙
+├── vitest.config.ts        # Vitest 설정
+├── tsconfig.json           # TypeScript 설정
+├── bunfig.toml             # Bun 설정
+├── package.json            # 패키지 정보
+└── README.md               # 프로젝트 README
+```
+
+## 개발 워크플로우
+
+### 1. 기능 개발
+
+```bash
+# 1. 새 브랜치 생성
+git checkout -b feature/new-feature
+
+# 2. 코드 작성
+# src/index.ts 수정
+
+# 3. 타입 체크
+bun run typecheck
+
+# 4. 린트
+bun run lint:fix
+
+# 5. 테스트 작성 및 실행
+# test/index.test.ts 작성
+bun run test
+
+# 6. 로컬 테스트
+bun run dev:bun
+
+# 7. 커밋
+git add .
+git commit -m "feat: 새 기능 추가"
+
+# 8. 푸시 및 PR 생성
+git push origin feature/new-feature
+```
+
+### 2. 버그 수정
+
+```bash
+# 1. 버그 재현 테스트 작성
+# test/index.test.ts에 실패하는 테스트 추가
+
+# 2. 코드 수정
+# src/index.ts 수정
+
+# 3. 테스트 통과 확인
+bun run test
+
+# 4. 커밋
+git commit -m "fix: 버그 수정"
+```
+
+## 코드 스타일 가이드
+
+### TypeScript 규칙
+
+1. **타입 명시**
+   ```typescript
+   // ✅ 좋은 예
+   const openUrl = (url: string): void => {
+     // ...
+   };
+
+   // ❌ 나쁜 예
+   const openUrl = (url) => {
+     // ...
+   };
+   ```
+
+2. **인터페이스 정의**
+   ```typescript
+   // ✅ 좋은 예
+   interface UserAnswer {
+     showInfo: boolean;
+   }
+
+   // ❌ 나쁜 예
+   type UserAnswer = {
+     showInfo: boolean;
+   };  // 객체 타입에는 interface 선호
+   ```
+
+3. **에러 핸들링**
+   ```typescript
+   // ✅ 좋은 예
+   try {
+     // 위험한 작업
+   } catch (error) {
+     if (error instanceof Error) {
+       console.error(error.message);
+     }
+   }
+
+   // ❌ 나쁜 예
+   try {
+     // 위험한 작업
+   } catch (error) {
+     console.error(error);  // 타입 체크 없음
+   }
+   ```
+
+### 네이밍 컨벤션
+
+- **변수/함수**: camelCase (`openUrl`, `getUserInfo`)
+- **타입/인터페이스**: PascalCase (`UserAnswer`, `ProgramOptions`)
+- **상수**: UPPER_SNAKE_CASE (`MAX_RETRIES`, `DEFAULT_TIMEOUT`)
+- **파일명**: kebab-case (`index.ts`, `user-utils.ts`)
+
+### 코드 포맷팅
+
+Prettier가 자동으로 처리하지만, 기본 규칙:
+
+- **들여쓰기**: 2 스페이스
+- **세미콜론**: 사용
+- **따옴표**: 쌍따옴표 (")
+- **줄 길이**: 80자
+- **후행 쉼표**: ES5 호환
+
+## 테스트 작성
+
+### 단위 테스트
+
+```typescript
+import { describe, it, expect } from 'vitest';
+
+describe('함수명', () => {
+  it('특정 조건에서 기대되는 동작을 해야 함', () => {
+    // Arrange
+    const input = 'test';
+    
+    // Act
+    const result = someFunction(input);
+    
+    // Assert
+    expect(result).toBe('expected');
+  });
+});
+```
+
+### 통합 테스트
+
+```typescript
+describe('CLI 통합 테스트', () => {
+  it('전체 플로우가 정상 작동해야 함', async () => {
+    // CLI 실행 시뮬레이션
+    // 여러 컴포넌트 통합 테스트
+  });
+});
+```
+
+## 디버깅
+
+### VS Code 디버깅 설정
+
+`.vscode/launch.json` 생성:
+
+```json
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Debug TypeScript",
+      "runtimeExecutable": "bun",
+      "runtimeArgs": ["run", "src/index.ts"],
+      "skipFiles": ["<node_internals>/**"]
+    }
+  ]
+}
+```
+
+### 콘솔 디버깅
+
+```typescript
+// 개발 중에만 사용
+console.log(chalk.gray('[DEBUG]'), variableName);
+```
+
+## 빌드 및 배포
+
+### 로컬 빌드
+
+```bash
+# TypeScript 컴파일러 사용
+bun run build
+
+# Bun 번들러 사용 (더 빠름)
+bun run build:bun
+
+# 빌드 결과 확인
+ls -la dist/
+```
+
+### 로컬에서 패키지 테스트
+
+```bash
+# 1. 전역 링크 생성
+npm link
+
+# 2. CLI 실행 테스트
+tylersong
+
+# 3. 테스트 완료 후 링크 제거
+npm unlink -g tylersong
+```
+
+### 버전 배포
+
+```bash
+# 1. 변경사항 커밋
+git add .
+git commit -m "feat: 새 기능"
+
+# 2. 버전 업데이트
+npm version patch  # 1.0.9 → 1.0.10
+
+# 3. 푸시 (태그 포함)
+git push origin main --tags
+
+# 4. GitHub Actions가 자동으로 NPM에 배포
+```
+
+## 품질 체크리스트
+
+배포 전 확인사항:
+
+- [ ] 모든 테스트 통과 (`bun run test`)
+- [ ] 린트 오류 없음 (`bun run lint`)
+- [ ] 타입 체크 통과 (`bun run typecheck`)
+- [ ] 빌드 성공 (`bun run build`)
+- [ ] 로컬에서 CLI 정상 작동 (`bun run dev:bun`)
+- [ ] 문서 업데이트 (필요시)
+- [ ] CHANGELOG 업데이트 (필요시)
+
+## 문제 해결
+
+### Bun 관련 문제
+
+```bash
+# Bun 재설치
+curl -fsSL https://bun.sh/install | bash
+
+# 캐시 삭제
+rm -rf ~/.bun/install/cache
+bun install
+```
+
+### 의존성 문제
+
+```bash
+# lockfile 삭제 후 재설치
+rm -f bun.lock package-lock.json
+bun install
+```
+
+### TypeScript 오류
+
+```bash
+# node_modules 재설치
+rm -rf node_modules
+bun install
+
+# tsconfig.json 확인
+bun run typecheck
+```
+
+## 기여 가이드
+
+1. **이슈 생성**: 버그 리포트 또는 기능 제안
+2. **브랜치 생성**: `feature/`, `fix/`, `docs/` 접두사 사용
+3. **커밋 메시지**: [Conventional Commits](https://www.conventionalcommits.org/) 형식
+   - `feat:` - 새 기능
+   - `fix:` - 버그 수정
+   - `docs:` - 문서 변경
+   - `test:` - 테스트 추가/수정
+   - `refactor:` - 리팩토링
+   - `style:` - 코드 스타일 변경
+   - `chore:` - 기타 변경사항
+4. **Pull Request**: 명확한 설명과 함께 제출
+5. **코드 리뷰**: 피드백 반영
+
+## 유용한 명령어 모음
+
+```bash
+# 개발
+bun run dev:bun              # 개발 모드 실행
+
+# 테스트
+bun run test                 # 테스트 실행
+bun run test:watch           # 테스트 감시
+bun run test:coverage        # 커버리지 포함
+
+# 코드 품질
+bun run lint                 # 린트 검사
+bun run lint:fix             # 린트 자동 수정
+bun run format               # 코드 포맷팅
+bun run typecheck            # 타입 체크
+
+# 빌드
+bun run build                # TypeScript 빌드
+bun run build:bun            # Bun 빌드
+
+# 실행
+bun run start                # 빌드된 파일 실행
+bun run start:bun            # Bun으로 실행
+```
+
+## 추가 리소스
+
+- [Bun 공식 문서](https://bun.sh/docs)
+- [TypeScript 핸드북](https://www.typescriptlang.org/docs/)
+- [Vitest 가이드](https://vitest.dev/guide/)
+- [ESLint 규칙](https://eslint.org/docs/rules/)
+- [Prettier 옵션](https://prettier.io/docs/en/options.html)
+