cf-yoyo 1.0.0

package/src/cli/commands/create.ts

@@ -0,0 +1,326 @@
+/**
+ * create 命令實現
+ * 負責執行專案創建流程
+ */
+
+import { Command } from 'commander';
+import ora from 'ora';
+import { runPrompts } from '../../core/prompt';
+import { parseConfig, parseFromOptions } from '../../core/config';
+import { directoryExists, isEmptyDir, deleteDirectory } from '../../core/filesystem';
+import { loadTemplate, validateTemplate } from '../../core/template-manager';
+import {
+  generateDefaultContext,
+  renderTemplateToFiles,
+  validateContext,
+} from '../../core/template-engine';
+import { gitInit, createGitignore } from '../../core/git';
+import { logger } from '../../utils/logger';
+import { ProjectConfig, Language } from '../../types';
+import { execa } from 'execa';
+import { existsSync } from 'fs';
+import { join } from 'path';
+
+/**
+ * 創建命令的選項接口
+ */
+interface CreateOptions {
+  template?: string;
+  git?: boolean;
+  install?: boolean;
+  type?: string;
+  language?: string;
+  verbose?: boolean;
+}
+
+/**
+ * 處理目錄已存在的情況
+ * 包含二次確認機制，確保用戶不會誤刪重要資料
+ */
+async function handleExistingDirectory(targetDir: string): Promise<boolean> {
+  const isEmpty = isEmptyDir(targetDir);
+
+  if (isEmpty) {
+    // 空目錄也需要確認（安全措施）
+    logger.warn(`目錄 "${targetDir}" 已存在但為空`);
+    const { confirmEmpty } = await import('inquirer').then((mod) =>
+      mod.default.prompt([
+        {
+          type: 'confirm',
+          name: 'confirmEmpty',
+          message: '是否移除現有的空目錄？',
+          default: true,
+        },
+      ])
+    );
+
+    if (confirmEmpty) {
+      deleteDirectory(targetDir);
+      return true;
+    }
+    return false;
+  }
+
+  // 目錄不為空，需要二次確認
+  logger.warn(`目錄 "${targetDir}" 已存在且包含檔案`);
+  logger.warn('⚠️  警告：此操作將永久刪除目錄中的所有檔案！');
+
+  // 第一次確認
+  const { confirm1 } = await import('inquirer').then((mod) =>
+    mod.default.prompt([
+      {
+        type: 'confirm',
+        name: 'confirm1',
+        message: '確定要覆蓋現有目錄嗎？（第一步確認）',
+        default: false,
+      },
+    ])
+  );
+
+  if (!confirm1) {
+    logger.info('已取消操作');
+    return false;
+  }
+
+  // 第二次確認（輸入目錄名稱確認）
+  const dirName = targetDir.split(/[/\\]/).pop() || targetDir;
+  const { confirm2 } = await import('inquirer').then((mod) =>
+    mod.default.prompt([
+      {
+        type: 'input',
+        name: 'confirm2',
+        message: `請輸入目錄名稱 "${dirName}" 以確認刪除：`,
+        validate: (input: string) => {
+          if (input === dirName) {
+            return true;
+          }
+          return `輸入不正確，請輸入 "${dirName}" 以確認`;
+        },
+      },
+    ])
+  );
+
+  // 確認輸入正確（validate 已確保）
+  logger.info('正在刪除現有目錄...');
+  deleteDirectory(targetDir);
+  return true;
+}
+
+/**
+ * 執行專案創建流程
+ */
+export async function createProject(
+  initialName?: string,
+  options: CreateOptions = {}
+): Promise<void> {
+  const spinner = ora();
+  let config: ProjectConfig;
+
+  try {
+    logger.empty();
+    logger.icon('🚀', '開始建立 Cloudflare 專案');
+    logger.empty();
+
+    // 1. 執行互動式問答（如果沒有提供足夠的命令行選項）
+    const hasAllOptions = !!(initialName && options.type && options.template);
+
+    const userInput = hasAllOptions
+      ? parseFromOptions(initialName as string, {
+          template: options.template as string,
+          ...(options.git !== undefined && { git: options.git }),
+          ...(options.install !== undefined && { install: options.install }),
+          type: options.type as string,
+          ...(options.language !== undefined && { language: options.language }),
+        })
+      : await runPrompts(initialName);
+
+    // 2. 解析配置
+    config = parseConfig(userInput);
+
+    logger.empty();
+    logger.icon('📋', '專案配置');
+    logger.divider();
+    logger.icon('📁', `專案名稱：${config.projectName}`);
+    logger.icon(
+      '🔷',
+      `程式語言：${config.language === Language.TYPESCRIPT ? 'TypeScript' : 'JavaScript'}`
+    );
+    logger.icon('🏷️', `專案類型：${config.projectType}`);
+    logger.icon('📝', `使用模板：${config.template}`);
+    logger.icon('🔧', `初始化 Git: ${config.initGit ? '是' : '否'}`);
+    logger.icon('📦', `安裝依賴：${config.installDeps ? '是' : '否'}`);
+    logger.divider();
+    logger.empty();
+
+    // 3. 檢查目標目錄
+    const targetExists = directoryExists(config.targetDir);
+
+    if (targetExists) {
+      const shouldContinue = await handleExistingDirectory(config.targetDir);
+
+      if (!shouldContinue) {
+        logger.info('已取消操作');
+        return;
+      }
+    }
+
+    // 4. 載入並驗證模板
+    spinner.start('正在載入模板...');
+    const templateConfig = loadTemplate(config.projectType, config.template, config.language);
+
+    if (!templateConfig) {
+      spinner.fail('模板載入失敗');
+      throw new Error(`無法載入模板：${config.projectType}/${config.template}`);
+    }
+
+    const validation = validateTemplate(config.projectType, config.template, config.language);
+
+    if (!validation.valid) {
+      spinner.fail('模板驗證失敗');
+      throw new Error(validation.error);
+    }
+
+    spinner.succeed(`模板「${templateConfig.name}」已載入`);
+
+    // 5. 生成渲染上下文
+    spinner.start('正在準備渲染上下文...');
+    const context = generateDefaultContext({
+      projectName: config.projectName,
+      projectType: config.projectType,
+      template: config.template,
+      language: config.language,
+    });
+
+    // 驗證必需變數
+    const contextValidation = validateContext(
+      context,
+      templateConfig.requiredVars || ['projectName', 'projectType', 'template']
+    );
+
+    if (!contextValidation.valid) {
+      spinner.fail('上下文驗證失敗');
+      throw new Error(`缺少必需的模板變數：${contextValidation.missing.join(', ')}`);
+    }
+
+    spinner.succeed('渲染上下文已準備');
+
+    // 6. 渲染模板
+    spinner.start('正在渲染模板檔案...');
+    const renderResult = await renderTemplateToFiles(templateConfig, config.targetDir, context);
+
+    if (!renderResult.success) {
+      spinner.fail('模板渲染失敗');
+      for (const error of renderResult.errors) {
+        logger.error(` - ${error.file}: ${error.error}`);
+      }
+      throw new Error('模板渲染過程中發生錯誤');
+    }
+
+    spinner.succeed(`已生成 ${renderResult.files.length} 個檔案`);
+
+    // 7. Git 初始化
+    if (config.initGit) {
+      spinner.start('正在初始化 Git 倉庫...');
+      try {
+        const gitResult = await gitInit(config.targetDir);
+        if (gitResult.success) {
+          // 建立 .gitignore
+          createGitignore(config.targetDir);
+          spinner.succeed('Git 倉庫已初始化');
+        } else {
+          spinner.warn(gitResult.message);
+        }
+      } catch (error: unknown) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        spinner.warn(`Git 初始化失敗：${errorMessage}`);
+        logger.info(' 您可以稍後手動執行 "git init"');
+      }
+    }
+
+    // 8. 依賴安裝
+    if (config.installDeps) {
+      spinner.start('正在安裝依賴...');
+      try {
+        // 檢查是否存在 package.json
+        const packageJsonPath = join(config.targetDir, 'package.json');
+        if (!existsSync(packageJsonPath)) {
+          spinner.warn('未找到 package.json，跳過依賴安裝');
+        } else {
+          await execa('npm', ['install'], {
+            cwd: config.targetDir,
+            timeout: 300000, // 5 分鐘超時
+          });
+          spinner.succeed('依賴已安裝');
+        }
+      } catch (error: unknown) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        spinner.warn(`依賴安裝失敗：${errorMessage}`);
+        logger.info(' 您可以稍後手動執行 "npm install"');
+      }
+    }
+
+    // 9. 顯示完成信息與下一步指引
+    logger.empty();
+    logger.success('✅ 專案建立完成！');
+    logger.empty();
+    logger.divider();
+    logger.empty();
+    logger.icon('📂', `專案位置：${config.targetDir}`);
+    logger.empty();
+    logger.icon('📝', '已生成檔案：');
+    for (const file of renderResult.files) {
+      const relativePath = file.replace(config.targetDir + '\\', '');
+      logger.info(` ✓ ${relativePath}`);
+    }
+    logger.empty();
+    logger.icon('💡', '下一步操作：');
+    logger.info(` 1. cd ${config.projectName}`);
+    if (!config.installDeps) {
+      logger.info(' 2. npm install');
+      logger.info(' 3. npm run dev');
+    } else {
+      logger.info(' 2. npm run dev');
+    }
+    logger.empty();
+  } catch (error: unknown) {
+    if (spinner.isSpinning) {
+      spinner.fail('發生意外錯誤');
+    }
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    logger.error(`錯誤：${errorMessage}`);
+    if (options.verbose && error instanceof Error && error.stack) {
+      logger.error(error.stack);
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * 建立 create 命令
+ */
+export function createCommand(program: Command): void {
+  program
+    .command('create')
+    .description('建立新的 Cloudflare 專案')
+    .argument('[project-name]', '專案名稱')
+    .option('-t, --template <template>', '使用指定模板', 'basic')
+    .option('--type <type>', '專案類型 (worker, pages, d1, kv, r2)')
+    .option('-l, --language <language>', '程式語言 (typescript, javascript)', 'typescript')
+    .option('--git', '是否初始化 Git 倉庫')
+    .option('--no-git', '不初始化 Git 倉庫')
+    .option('--install', '是否安裝依賴')
+    .option('--no-install', '不安裝依賴')
+    .option('-v, --verbose', '顯示詳細日誌')
+    .action(async (projectName: string | undefined, options: CreateOptions) => {
+      try {
+        await createProject(projectName, options);
+      } catch (error: unknown) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`建立專案時發生錯誤：${errorMessage}`);
+        if (options.verbose && error instanceof Error && error.stack) {
+          logger.error(error.stack);
+        }
+        process.exit(1);
+      }
+    });
+}