cf-yoyo 1.0.0

package/src/core/git.ts

@@ -0,0 +1,384 @@
+/**
+ * Git 操作核心功能模組
+ * 負責執行 Git 相關操作（init、push、clone 等）
+ */
+
+import { execa } from 'execa';
+import { existsSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { GitResult } from '../types';
+import { loadTokens, GitToken } from './git-token';
+
+/**
+ * Execa 錯誤介面
+ * 定義 execa 執行失敗時拋出的錯誤物件結構
+ */
+interface ExecaError extends Error {
+  stderr?: string;
+  stdout?: string;
+  exitCode?: number;
+  command?: string;
+}
+
+/**
+ * 檢查錯誤是否為 ExecaError
+ */
+function isExecaError(error: unknown): error is ExecaError {
+  return error instanceof Error && 'stderr' in error;
+}
+
+/**
+ * 將 HTTPS URL 轉換為包含 Token 的格式
+ * 例如：https://github.com/user/repo.git -> https://<token>@github.com/user/repo.git
+ * @param url Git 倉庫 URL
+ * @param token Git Token
+ * @returns 包含 Token 的 URL
+ */
+function injectTokenToUrl(url: string, token: string): string {
+  // 只處理 HTTPS URL
+  if (!url.startsWith('https://')) {
+    return url;
+  }
+
+  // 移除 https:// 前綴
+  const urlWithoutProtocol = url.slice(8);
+
+  // 插入 token@
+  return `https://${token}@${urlWithoutProtocol}`;
+}
+
+/**
+ * 獲取要使用的 Git Token（若有）
+ * @returns GitToken 或 null
+ */
+function getGitToken(): GitToken | null {
+  const config = loadTokens();
+  if (config.tokens.length === 0) {
+    return null;
+  }
+  // 返回第一個 token（預設使用最新或第一個）
+  return config.tokens[0] || null;
+}
+
+/**
+ * 執行 Git 命令
+ * @param args Git 命令參數
+ * @param options 執行選項
+ */
+async function executeGitCommand(
+  args: string[],
+  options: { cwd?: string; timeout?: number } = {}
+): Promise<GitResult> {
+  try {
+    const execOptions: { cwd: string; timeout: number } = {
+      cwd: options.cwd ?? process.cwd(),
+      timeout: options.timeout ?? 60000, // 預設 60 秒超時
+    };
+
+    const { stdout, stderr } = await execa('git', args, execOptions);
+
+    return {
+      success: true,
+      message: '命令執行成功',
+      output: stdout || stderr,
+    };
+  } catch (error: unknown) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    const stderr = isExecaError(error) ? error.stderr : undefined;
+
+    const result: GitResult = {
+      success: false,
+      message: `Git 命令執行失敗：${errorMessage}`,
+    };
+
+    // 只有在有 stderr 時才添加 output 屬性
+    if (stderr !== undefined) {
+      result.output = stderr;
+    }
+
+    return result;
+  }
+}
+
+/**
+ * 檢查是否為 Git 倉庫
+ * @param cwd 工作目錄
+ */
+export async function isGitRepository(cwd?: string): Promise<boolean> {
+  const result = await executeGitCommand(['rev-parse', '--git-dir'], { cwd: cwd ?? process.cwd() });
+  return result.success;
+}
+
+/**
+ * 初始化 Git 倉庫
+ * @param cwd 工作目錄
+ */
+export async function gitInit(cwd?: string): Promise<GitResult> {
+  const targetDir = cwd || process.cwd();
+
+  // 檢查是否已為 Git 倉庫
+  const alreadyGit = await isGitRepository(targetDir);
+  if (alreadyGit) {
+    return {
+      success: false,
+      message: '此目錄已經是 Git 倉庫',
+    };
+  }
+
+  return await executeGitCommand(['init'], { cwd: targetDir });
+}
+
+/**
+ * 建立 .gitignore 檔案（若不存在）
+ * @param cwd 工作目錄
+ */
+export function createGitignore(cwd?: string): boolean {
+  const targetDir = cwd || process.cwd();
+  const gitignorePath = join(targetDir, '.gitignore');
+
+  if (existsSync(gitignorePath)) {
+    return false; // 已存在
+  }
+
+  const defaultGitignore = `# 依賴
+node_modules/
+.pnpm-store/
+
+# 構建輸出
+dist/
+build/
+.next/
+out/
+
+# 環境變量
+.env
+.env.local
+.env.*.local
+
+# 日誌
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# 編輯器
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# 操作系統
+.DS_Store
+Thumbs.db
+
+# Cloudflare
+.wrangler/
+.dev.vars
+`;
+
+  writeFileSync(gitignorePath, defaultGitignore, 'utf-8');
+  return true;
+}
+
+/**
+ * Git 提交
+ * @param message 提交信息
+ * @param cwd 工作目錄
+ */
+export async function gitCommit(message: string, cwd?: string): Promise<GitResult> {
+  const targetCwd = cwd ?? process.cwd();
+  const result = await executeGitCommand(['add', '-A'], { cwd: targetCwd });
+  if (!result.success) {
+    return result;
+  }
+
+  return await executeGitCommand(['commit', '-m', message], { cwd: targetCwd });
+}
+
+/**
+ * 添加 Git remote
+ * @param remoteName remote 名稱
+ * @param url remote URL
+ * @param cwd 工作目錄
+ */
+export async function gitAddRemote(
+  remoteName: string,
+  url: string,
+  cwd?: string
+): Promise<GitResult> {
+  return await executeGitCommand(['remote', 'add', remoteName, url], { cwd: cwd ?? process.cwd() });
+}
+
+/**
+ * Git push
+ * @param remote remote 名稱
+ * @param branch 分支名稱
+ * @param cwd 工作目錄
+ * @param token Git Token（可選，若提供則使用 Token 認證）
+ */
+export async function gitPush(
+  remote: string,
+  branch: string,
+  cwd?: string,
+  token?: string
+): Promise<GitResult> {
+  const targetCwd = cwd ?? process.cwd();
+
+  // 若有提供 token，先修改 remote URL 以包含 token
+  if (token) {
+    try {
+      // 獲取 remote URL
+      const { stdout: remoteUrl } = await execa('git', ['remote', 'get-url', remote], {
+        cwd: targetCwd,
+      });
+
+      if (!remoteUrl) {
+        return {
+          success: false,
+          message: '無法獲取 remote URL',
+        };
+      }
+
+      if (remoteUrl.startsWith('https://')) {
+        // 將 token 注入 URL
+        const tokenUrl = injectTokenToUrl(remoteUrl, token);
+
+        // 設置臨時 remote URL
+        await execa('git', ['remote', 'set-url', remote, tokenUrl], {
+          cwd: targetCwd,
+        });
+
+        try {
+          // 執行 push
+          const result = await executeGitCommand(['push', '-u', remote, branch], {
+            cwd: targetCwd,
+          });
+
+          // 還原 remote URL（移除 token）
+          await execa('git', ['remote', 'set-url', remote, remoteUrl], {
+            cwd: targetCwd,
+          });
+
+          return result;
+        } catch (error) {
+          // 如果失敗，還是要嘗試還原 URL
+          try {
+            await execa('git', ['remote', 'set-url', remote, remoteUrl], {
+              cwd: targetCwd,
+            });
+          } catch {
+            // 忽略還原失敗
+          }
+          throw error;
+        }
+      } else {
+        // 非 HTTPS URL（例如 SSH），無法使用 Token
+        return {
+          success: false,
+          message: `Token 認證僅支援 HTTPS URL，目前為：${remoteUrl}，請改用 HTTPS 格式的 remote URL`,
+        };
+      }
+    } catch (error: unknown) {
+      // 如果 token 認證失敗，返回錯誤
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      return {
+        success: false,
+        message: `Token 認證推送失敗：${errorMessage}`,
+      };
+    }
+  }
+
+  return await executeGitCommand(['push', '-u', remote, branch], { cwd: targetCwd });
+}
+
+/**
+ * Git clone
+ * @param url 倉庫 URL
+ * @param directory 目標目錄
+ * @param token Git Token（可選，若提供則使用 Token 認證）
+ */
+export async function gitClone(
+  url: string,
+  directory?: string,
+  token?: string
+): Promise<GitResult> {
+  // 若有 token 且為 HTTPS URL，注入 token
+  const cloneUrl = token && url.startsWith('https://') ? injectTokenToUrl(url, token) : url;
+
+  const args = ['clone', cloneUrl];
+  if (directory) {
+    args.push(directory);
+  }
+
+  return await executeGitCommand(args);
+}
+
+/**
+ * 獲取當前分支名稱
+ * @param cwd 工作目錄
+ */
+export async function getCurrentBranch(cwd?: string): Promise<string | null> {
+  const result = await executeGitCommand(['branch', '--show-current'], {
+    cwd: cwd ?? process.cwd(),
+  });
+  if (result.success && result.output) {
+    return result.output.trim();
+  }
+  return null;
+}
+
+/**
+ * 獲取 remote 列表
+ * @param cwd 工作目錄
+ */
+export async function getRemotes(cwd?: string): Promise<string[]> {
+  const result = await executeGitCommand(['remote'], { cwd: cwd ?? process.cwd() });
+  if (result.success && result.output) {
+    return result.output
+      .trim()
+      .split('\n')
+      .filter((remoteName) => remoteName.trim() !== '');
+  }
+  return [];
+}
+
+/**
+ * 設置 default branch
+ * @param branch 分支名稱
+ * @param cwd 工作目錄
+ */
+export async function gitBranchM1(branch: string, cwd?: string): Promise<GitResult> {
+  return await executeGitCommand(['branch', '-M', branch], { cwd: cwd ?? process.cwd() });
+}
+
+/**
+ * 取消 Git 倉庫（刪除 .git 目錄）
+ * @param cwd 工作目錄
+ */
+export async function removeGitRepo(cwd?: string): Promise<GitResult> {
+  const gitDir = join(cwd ?? process.cwd(), '.git');
+
+  if (!existsSync(gitDir)) {
+    return {
+      success: false,
+      message: '此目錄不是 Git 倉庫',
+    };
+  }
+
+  try {
+    const { rmSync } = await import('fs');
+    rmSync(gitDir, { recursive: true, force: true });
+
+    return {
+      success: true,
+      message: '已成功取消 Git 倉庫',
+    };
+  } catch (error: unknown) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return {
+      success: false,
+      message: `取消 Git 倉庫失敗：${errorMessage}`,
+    };
+  }
+}

package/src/core/prompt.ts

@@ -0,0 +1,345 @@
+/**
+ * 互動式問答模組
+ * 使用 Inquirer.js 實現用戶輸入收集與驗證
+ */
+
+import inquirer, { DistinctQuestion } from 'inquirer';
+import { ProjectType, TemplateType, UserInput, Language } from '../types';
+
+/**
+ * 問題定義接口
+ */
+interface PromptQuestions {
+  projectName: string;
+  language: Language;
+  projectType: ProjectType;
+  template: TemplateType;
+  initGit: boolean;
+  installDeps: boolean;
+}
+
+/**
+ * 語言選擇問題類型
+ */
+interface LanguageQuestion {
+  type: 'select';
+  name: 'language';
+  message: string;
+  choices: Array<{ name: string; value: Language }>;
+  default: number;
+}
+
+/**
+ * 專案名稱問題類型
+ */
+interface ProjectNameQuestion {
+  type: 'input';
+  name: 'projectName';
+  message: string;
+  validate: (input: string) => boolean | string;
+  filter: (input: string) => string;
+}
+
+/**
+ * 專案類型問題類型
+ */
+interface ProjectTypeQuestion {
+  type: 'select';
+  name: 'projectType';
+  message: string;
+  choices: Array<{ name: string; value: ProjectType }>;
+  default: number;
+}
+
+/**
+ * 模板問題類型
+ */
+interface TemplateQuestion {
+  type: 'select';
+  name: 'template';
+  message: string;
+  choices: Array<{ name: string; value: TemplateType }>;
+  default: number;
+}
+
+/**
+ * Git 初始化問題類型
+ */
+interface GitInitQuestion {
+  type: 'confirm';
+  name: 'initGit';
+  message: string;
+  default: boolean;
+}
+
+/**
+ * 依賴安裝問題類型
+ */
+interface InstallDepsQuestion {
+  type: 'confirm';
+  name: 'installDeps';
+  message: string;
+  default: boolean;
+}
+
+/**
+ * 驗證專案名稱
+ * 規則：
+ * - 只能包含小寫字母、數字、連字號、底線
+ * - 不能以大寫字母或數字開頭
+ * - 長度 1-214 個字元
+ */
+function validateProjectName(name: string): boolean | string {
+  if (!name || name.trim() === '') {
+    return '專案名稱不能為空';
+  }
+
+  const trimmedName = name.trim();
+
+  // 檢查長度
+  if (trimmedName.length > 214) {
+    return '專案名稱不能超過 214 個字元';
+  }
+
+  // 檢查字元
+  const validCharsRegex = /^[a-z0-9_.-]+$/;
+  if (!validCharsRegex.test(trimmedName)) {
+    return '專案名稱只能包含小寫字母、數字、連字號（-）、點（.）和底線（_）';
+  }
+
+  // 檢查開頭
+  if (/^[0-9A-Z]/.test(trimmedName)) {
+    return '專案名稱不能以大寫字母或數字開頭';
+  }
+
+  // 檢查是否為保留名稱
+  const reservedNames = ['node_modules', '__proto__', 'node', 'npm', 'pnpm', 'yarn'];
+  if (reservedNames.includes(trimmedName.toLowerCase())) {
+    return `「${trimmedName}」是保留名稱，請改用其他名稱`;
+  }
+
+  return true;
+}
+
+/**
+ * 獲取語言選擇問題
+ */
+function getLanguageQuestion(): LanguageQuestion {
+  return {
+    type: 'select' as const,
+    name: 'language',
+    message: '請選擇程式語言：',
+    choices: [
+      { name: '🔷 TypeScript - 帶有型別安全的開發體驗', value: Language.TYPESCRIPT },
+      { name: '🟨 JavaScript - 純 JavaScript 開發', value: Language.JAVASCRIPT },
+    ],
+    default: 0,
+  };
+}
+
+/**
+ * 獲取專案類型選擇問題
+ */
+function getProjectTypeQuestion(): ProjectTypeQuestion {
+  return {
+    type: 'select' as const,
+    name: 'projectType',
+    message: '請選擇專案類型：',
+    choices: [
+      {
+        name: '☁️ Worker - Cloudflare Worker 基礎模板',
+        value: ProjectType.WORKER,
+      },
+      {
+        name: '📄 Pages - Cloudflare Pages 靜態網站',
+        value: ProjectType.PAGES,
+      },
+      {
+        name: '🗄️ D1 - 包含 D1 資料庫的 Worker',
+        value: ProjectType.D1,
+      },
+      {
+        name: '📦 KV - 包含 KV 存儲的 Worker',
+        value: ProjectType.KV,
+      },
+      {
+        name: '🪣 R2 - 包含 R2 存儲的 Worker',
+        value: ProjectType.R2,
+      },
+    ],
+    default: 0,
+  };
+}
+
+/**
+ * 獲取模板選擇問題
+ * 根據專案類型和語言動態調整可選模板
+ */
+function getTemplateQuestion(projectType: ProjectType, language: Language): TemplateQuestion {
+  // 根據專案類型和語言獲取可用模板
+  const getTemplateChoices = (): Array<{ name: string; value: TemplateType }> => {
+    // JavaScript 語言支援的模板
+    if (language === Language.JAVASCRIPT) {
+      switch (projectType) {
+        case ProjectType.WORKER:
+          return [
+            { name: '🔹 Basic - 基礎 Worker 模板', value: TemplateType.BASIC },
+            { name: '🔸 Hono - Hono 框架模板', value: TemplateType.HONO },
+          ];
+        case ProjectType.PAGES:
+          return [{ name: '📄 Static - 靜態網站模板', value: TemplateType.STATIC }];
+        case ProjectType.D1:
+        case ProjectType.KV:
+        case ProjectType.R2:
+          return [{ name: '🔹 Basic - 基礎模板', value: TemplateType.BASIC }];
+        default:
+          return [{ name: '🔹 Basic - 基礎模板', value: TemplateType.BASIC }];
+      }
+    }
+
+    // TypeScript 語言支援的模板（原始完整支援）
+    switch (projectType) {
+      case ProjectType.WORKER:
+        return [
+          { name: '🔹 Basic - 基礎 Worker 模板', value: TemplateType.BASIC },
+          { name: '🔸 Hono - Hono 框架模板', value: TemplateType.HONO },
+          { name: '🔹 Itty Router - itty-router 模板', value: TemplateType.ITTY_ROUTER },
+        ];
+      case ProjectType.PAGES:
+        return [
+          { name: '📄 Static - 靜態網站模板', value: TemplateType.STATIC },
+          { name: '⚛️ React - React 模板', value: TemplateType.REACT },
+          { name: '🔷 Vue - Vue 模板', value: TemplateType.VUE },
+          { name: '⬡ Next.js - Next.js 模板', value: TemplateType.NEXTJS },
+        ];
+      case ProjectType.D1:
+      case ProjectType.KV:
+      case ProjectType.R2:
+        return [{ name: '🔹 Basic - 基礎模板', value: TemplateType.BASIC }];
+      default:
+        return [{ name: '🔹 Basic - 基礎模板', value: TemplateType.BASIC }];
+    }
+  };
+
+  return {
+    type: 'select' as const,
+    name: 'template',
+    message: '請選擇模板：',
+    choices: getTemplateChoices(),
+    default: 0,
+  };
+}
+
+/**
+ * 獲取 Git 初始化問題
+ */
+function getGitInitQuestion(): GitInitQuestion {
+  return {
+    type: 'confirm',
+    name: 'initGit',
+    message: '是否初始化 Git 倉庫？',
+    default: true,
+  };
+}
+
+/**
+ * 獲取依賴安裝問題
+ */
+function getInstallDepsQuestion(): InstallDepsQuestion {
+  return {
+    type: 'confirm',
+    name: 'installDeps',
+    message: '是否立即安裝依賴？',
+    default: true,
+  };
+}
+
+/**
+ * 執行互動式問答流程
+ * 收集所有必要的用戶輸入
+ */
+export async function runPrompts(initialName?: string): Promise<UserInput> {
+  const result: UserInput = {};
+
+  // 專案名稱（如果有提供則跳過）
+  if (!initialName) {
+    const { projectName } = await inquirer.prompt<Pick<PromptQuestions, 'projectName'>>([
+      {
+        type: 'input',
+        name: 'projectName',
+        message: '請輸入專案名稱：',
+        validate: validateProjectName,
+        filter: (input: string) => input.trim(),
+      } as ProjectNameQuestion,
+    ]);
+    result.projectName = projectName;
+  } else {
+    // 驗證提供的專案名稱
+    const validation = validateProjectName(initialName);
+    if (validation !== true) {
+      console.error(`❌ 無效的專案名稱：${validation}`);
+      process.exit(1);
+    }
+    result.projectName = initialName;
+  }
+
+  // 語言選擇
+  const { language } = await inquirer.prompt<Pick<PromptQuestions, 'language'>>([
+    getLanguageQuestion(),
+  ]);
+  result.language = language;
+
+  // 專案類型選擇
+  const { projectType } = await inquirer.prompt<Pick<PromptQuestions, 'projectType'>>([
+    getProjectTypeQuestion(),
+  ]);
+  result.projectType = projectType;
+
+  // 模板選擇（根據語言和專案類型過濾）
+  const { template } = await inquirer.prompt<Pick<PromptQuestions, 'template'>>([
+    getTemplateQuestion(projectType, language),
+  ]);
+  result.template = template;
+
+  // Git 初始化
+  const { initGit } = await inquirer.prompt<Pick<PromptQuestions, 'initGit'>>([
+    getGitInitQuestion(),
+  ]);
+  result.initGit = initGit;
+
+  // 依賴安裝
+  const { installDeps } = await inquirer.prompt<Pick<PromptQuestions, 'installDeps'>>([
+    getInstallDepsQuestion(),
+  ]);
+  result.installDeps = installDeps;
+
+  return result;
+}
+
+/**
+ * 僅收集專案名稱
+ */
+export async function promptForProjectName(): Promise<string> {
+  const { projectName } = await inquirer.prompt<Pick<PromptQuestions, 'projectName'>>([
+    {
+      type: 'input',
+      name: 'projectName',
+      message: '請輸入專案名稱：',
+      validate: validateProjectName,
+      filter: (input: string) => input.trim(),
+    } as ProjectNameQuestion,
+  ]);
+  return projectName;
+}
+
+/**
+ * 僅選擇專案類型
+ */
+export async function promptForProjectType(): Promise<ProjectType> {
+  const { projectType } = await inquirer.prompt<Pick<PromptQuestions, 'projectType'>>([
+    getProjectTypeQuestion(),
+  ]);
+  return projectType;
+}
+
+export { validateProjectName };