cf-yoyo 1.0.0

package/src/core/filesystem.ts

@@ -0,0 +1,408 @@
+/**
+ * 檔案系統操作模組
+ * 負責目錄創建、檔案寫入、衝突處理
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { FileSystemResult, ConflictResolution } from '../types';
+import { logger } from '../utils/logger';
+
+/**
+ * 檢查目錄是否存在
+ */
+export function directoryExists(dirPath: string): boolean {
+  try {
+    const stats = fs.statSync(dirPath);
+    return stats.isDirectory();
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 檢查檔案是否存在
+ */
+export function fileExists(filePath: string): boolean {
+  try {
+    const stats = fs.statSync(filePath);
+    return stats.isFile();
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 檢查路徑是否為空目錄
+ */
+export function isEmptyDir(dirPath: string): boolean {
+  if (!directoryExists(dirPath)) {
+    return true;
+  }
+
+  try {
+    const files = fs.readdirSync(dirPath);
+    return files.length === 0;
+  } catch {
+    return true;
+  }
+}
+
+/**
+ * 創建目錄（遞迴創建）
+ */
+export function createDirectory(dirPath: string, options?: { recursive?: boolean }): boolean {
+  const { recursive = true } = options || {};
+
+  try {
+    fs.mkdirSync(dirPath, { recursive });
+    logger.debug(`目錄已創建：${dirPath}`);
+    return true;
+  } catch (error: unknown) {
+    const message = error instanceof Error ? error.message : String(error);
+    logger.error(`創建目錄失敗：${message}`);
+    return false;
+  }
+}
+
+/**
+ * 寫入檔案內容
+ */
+export function writeFile(
+  filePath: string,
+  content: string,
+  options?: { encoding?: BufferEncoding; overwrite?: boolean }
+): boolean {
+  const { encoding = 'utf-8', overwrite = true } = options || {};
+
+  try {
+    // 如果檔案已存在且不允許覆蓋，則抛出錯誤
+    if (!overwrite && fileExists(filePath)) {
+      throw new Error(`檔案已存在：${filePath}`);
+    }
+
+    // 確保父目錄存在
+    const dirPath = path.dirname(filePath);
+    if (!directoryExists(dirPath)) {
+      createDirectory(dirPath, { recursive: true });
+    }
+
+    fs.writeFileSync(filePath, content, { encoding });
+    logger.debug(`檔案已寫入：${filePath}`);
+    return true;
+  } catch (error: unknown) {
+    const message = error instanceof Error ? error.message : String(error);
+    logger.error(`寫入檔案失敗：${message}`);
+    return false;
+  }
+}
+
+/**
+ * 讀取檔案內容
+ */
+export function readFile(filePath: string, options?: { encoding?: BufferEncoding }): string | null {
+  const { encoding = 'utf-8' } = options || {};
+
+  try {
+    const content = fs.readFileSync(filePath, { encoding });
+    logger.debug(`檔案已讀取：${filePath}`);
+    return content;
+  } catch (error: unknown) {
+    const message = error instanceof Error ? error.message : String(error);
+    logger.error(`讀取檔案失敗：${message}`);
+    return null;
+  }
+}
+
+/**
+ * 複製檔案
+ */
+export function copyFile(
+  srcPath: string,
+  destPath: string,
+  options?: { overwrite?: boolean }
+): boolean {
+  const { overwrite = false } = options || {};
+
+  try {
+    // 如果目標檔案已存在且不允許覆蓋，則抛出錯誤
+    if (!overwrite && fileExists(destPath)) {
+      throw new Error(`目標檔案已存在：${destPath}`);
+    }
+
+    // 確保目標目錄存在
+    const destDir = path.dirname(destPath);
+    if (!directoryExists(destDir)) {
+      createDirectory(destDir, { recursive: true });
+    }
+
+    fs.copyFileSync(srcPath, destPath);
+    logger.debug(`檔案已複製：${srcPath} -> ${destPath}`);
+    return true;
+  } catch (error: unknown) {
+    const message = error instanceof Error ? error.message : String(error);
+    logger.error(`複製檔案失敗：${message}`);
+    return false;
+  }
+}
+
+/**
+ * 複製目錄（遞迴）
+ */
+export function copyDirectory(
+  srcDir: string,
+  destDir: string,
+  options?: { overwrite?: boolean }
+): { success: boolean; files: string[] } {
+  const { overwrite = false } = options || {};
+  const files: string[] = [];
+
+  try {
+    if (!directoryExists(srcDir)) {
+      throw new Error(`來源目錄不存在：${srcDir}`);
+    }
+
+    // 創建目標目錄
+    if (!directoryExists(destDir)) {
+      createDirectory(destDir, { recursive: true });
+    }
+
+    // 讀取來源目錄
+    const entries = fs.readdirSync(srcDir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      const srcPath = path.join(srcDir, entry.name);
+      const destPath = path.join(destDir, entry.name);
+
+      if (entry.isDirectory()) {
+        // 遞迴複製子目錄
+        const result = copyDirectory(srcPath, destPath, { overwrite });
+        if (result.success) {
+          files.push(...result.files);
+        }
+      } else {
+        // 複製檔案
+        if (copyFile(srcPath, destPath, { overwrite })) {
+          files.push(destPath);
+        }
+      }
+    }
+
+    logger.debug(`目錄已複製：${srcDir} -> ${destDir} (${files.length} 個檔案)`);
+    return { success: true, files };
+  } catch (error: unknown) {
+    const message = error instanceof Error ? error.message : String(error);
+    logger.error(`複製目錄失敗：${message}`);
+    return { success: false, files: [] };
+  }
+}
+
+/**
+ * 刪除檔案
+ */
+export function deleteFile(filePath: string): boolean {
+  try {
+    if (fileExists(filePath)) {
+      fs.unlinkSync(filePath);
+      logger.debug(`檔案已刪除：${filePath}`);
+    }
+    return true;
+  } catch (error: unknown) {
+    const message = error instanceof Error ? error.message : String(error);
+    logger.error(`刪除檔案失敗：${message}`);
+    return false;
+  }
+}
+
+/**
+ * 刪除目錄（遞迴）
+ */
+export function deleteDirectory(dirPath: string): boolean {
+  try {
+    if (directoryExists(dirPath)) {
+      fs.rmSync(dirPath, { recursive: true, force: true });
+      logger.debug(`目錄已刪除：${dirPath}`);
+    }
+    return true;
+  } catch (error: unknown) {
+    const message = error instanceof Error ? error.message : String(error);
+    logger.error(`刪除目錄失敗：${message}`);
+    return false;
+  }
+}
+
+/**
+ * 檢查並處理目錄衝突
+ * 如果目錄已存在且不為空，則需要用戶確認
+ */
+export function checkDirectoryConflict(
+  dirPath: string,
+  onConflict: (resolution: ConflictResolution) => void
+): { hasConflict: boolean; resolution?: ConflictResolution } {
+  // 目錄不存在，沒有衝突
+  if (!directoryExists(dirPath)) {
+    return { hasConflict: false };
+  }
+
+  // 目錄存在但為空，沒有衝突
+  if (isEmptyDir(dirPath)) {
+    return { hasConflict: false };
+  }
+
+  // 目錄存在且不為空，需要處理衝突
+  const resolution: ConflictResolution = {
+    action: 'abort', // 預設行為
+  };
+
+  // 調用回調函數讓用戶決定
+  onConflict(resolution);
+
+  return { hasConflict: true, resolution };
+}
+
+/**
+ * 創建專案目錄結構
+ */
+export function createProjectStructure(targetDir: string, projectName: string): FileSystemResult {
+  const files: string[] = [];
+  const directories: string[] = [];
+
+  try {
+    // 創建主目錄
+    if (!createDirectory(targetDir)) {
+      return {
+        success: false,
+        error: '無法創建專案目錄',
+      };
+    }
+    directories.push(targetDir);
+
+    // 創建基礎目錄結構
+    const subDirs = ['src', 'public', 'tests'];
+    for (const dir of subDirs) {
+      const dirPath = path.join(targetDir, dir);
+      if (createDirectory(dirPath)) {
+        directories.push(dirPath);
+      }
+    }
+
+    // 創建 .gitignore
+    const gitignorePath = path.join(targetDir, '.gitignore');
+    const gitignoreContent = `# 依賴
+node_modules/
+dist/
+
+# 環境變數
+.env
+.env.local
+.env.*.local
+
+# 日誌
+*.log
+npm-debug.log*
+
+# 操作系統
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+`;
+    if (writeFile(gitignorePath, gitignoreContent)) {
+      files.push(gitignorePath);
+    }
+
+    // 創建 README.md
+    const readmePath = path.join(targetDir, 'README.md');
+    const readmeContent = `# ${projectName}
+
+## 專案說明
+
+這是一個 Cloudflare 專案，使用 create-cf-project 腳手架工具建立。
+
+## 快速開始
+
+\`\`\`bash
+# 安裝依賴
+npm install
+
+# 開發模式
+npm run dev
+
+# 建置專案
+npm run build
+\`\`\`
+
+## 功能特色
+
+- ☁️  基於 Cloudflare 平台
+- 📦 使用 TypeScript 開發
+- ⚡  快速部署
+
+## 授權
+
+MIT License
+`;
+    if (writeFile(readmePath, readmeContent)) {
+      files.push(readmePath);
+    }
+
+    // 創建 .gitignore 提示
+    logger.success('專案結構已建立');
+
+    return {
+      success: true,
+      files,
+      directories,
+    };
+  } catch (error: unknown) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      success: false,
+      error: message || '建立專案結構時發生錯誤',
+    };
+  }
+}
+
+/**
+ * 獲取目錄內容列表
+ */
+export function listDirectory(dirPath: string): string[] {
+  try {
+    if (!directoryExists(dirPath)) {
+      return [];
+    }
+    return fs.readdirSync(dirPath);
+  } catch (error: unknown) {
+    const message = error instanceof Error ? error.message : String(error);
+    logger.error(`讀取目錄列表失敗：${message}`);
+    return [];
+  }
+}
+
+/**
+ * 獲取檔案大小（位元組）
+ */
+export function getFileSize(filePath: string): number {
+  try {
+    const stats = fs.statSync(filePath);
+    return stats.size;
+  } catch {
+    return 0;
+  }
+}
+
+/**
+ * 獲取檔案修改時間
+ */
+export function getFileModifiedDate(filePath: string): Date | null {
+  try {
+    const stats = fs.statSync(filePath);
+    return stats.mtime;
+  } catch {
+    return null;
+  }
+}

package/src/core/git-token.ts

@@ -0,0 +1,248 @@
+/**
+ * Git Token 管理模組
+ * 負責管理私人倉庫推送所需的 Git Token
+ */
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { v4 as uuidv4 } from 'uuid';
+import { logger } from '../utils/logger';
+
+/**
+ * Git Token 資料結構
+ */
+export interface GitToken {
+  id: string;
+  name: string;
+  token: string;
+  createdAt: string;
+}
+
+/**
+ * Git Token 配置結構
+ */
+export interface GitTokenConfig {
+  tokens: GitToken[];
+}
+
+/**
+ * 獲取配置檔路徑
+ * 路徑：~/.config/cf-yoyo/git-token.json（跨平台）
+ * 使用 os.homedir() 確保在 Windows、macOS、Linux 上都能正確獲取用戶目錄
+ */
+export function getTokenConfigPath(): string {
+  const userHome = homedir();
+  if (!userHome) {
+    throw new Error('無法獲取用戶目錄路徑');
+  }
+  const configDir = join(userHome, '.config', 'cf-yoyo');
+  const configPath = join(configDir, 'git-token.json');
+  return configPath;
+}
+
+/**
+ * 確保配置目錄存在
+ */
+function ensureConfigDir(): void {
+  const configPath = getTokenConfigPath();
+  const configDir = join(configPath, '..');
+
+  if (!existsSync(configDir)) {
+    mkdirSync(configDir, { recursive: true });
+  }
+}
+
+/**
+ * 載入已存 Token
+ * @returns GitTokenConfig 配置對象
+ */
+export function loadTokens(): GitTokenConfig {
+  const configPath = getTokenConfigPath();
+
+  if (!existsSync(configPath)) {
+    return { tokens: [] };
+  }
+
+  try {
+    const content = readFileSync(configPath, 'utf-8');
+    const config = JSON.parse(content) as GitTokenConfig;
+    return config;
+  } catch (error) {
+    logger.warn('讀取 Token 配置失敗，返回空配置');
+    return { tokens: [] };
+  }
+}
+
+/**
+ * 保存 Token 配置
+ * @param tokens Token 配置對象
+ */
+export function saveTokens(tokens: GitTokenConfig): void {
+  ensureConfigDir();
+  const configPath = getTokenConfigPath();
+  writeFileSync(configPath, JSON.stringify(tokens, null, 2), 'utf-8');
+}
+
+/**
+ * 新增 Token
+ * @param name Token 名稱
+ * @param token Token 值
+ * @returns 新增的 GitToken 對象
+ */
+export function addToken(name: string, token: string): GitToken {
+  const config = loadTokens();
+
+  const newToken: GitToken = {
+    id: uuidv4(),
+    name,
+    token,
+    createdAt: new Date().toISOString(),
+  };
+
+  config.tokens.push(newToken);
+  saveTokens(config);
+
+  return newToken;
+}
+
+/**
+ * 刪除 Token
+ * @param id Token ID
+ * @returns 是否刪除成功
+ */
+export function deleteToken(id: string): boolean {
+  const config = loadTokens();
+  const initialLength = config.tokens.length;
+  config.tokens = config.tokens.filter((tokenItem) => tokenItem.id !== id);
+
+  if (config.tokens.length < initialLength) {
+    saveTokens(config);
+    return true;
+  }
+
+  return false;
+}
+
+/**
+ * 更新 Token
+ * @param id Token ID
+ * @param name Token 名稱
+ * @param token Token 值
+ * @returns 是否更新成功
+ */
+export function updateToken(id: string, name: string, token: string): boolean {
+  const config = loadTokens();
+  const tokenIndex = config.tokens.findIndex((tokenItem) => tokenItem.id === id);
+
+  if (tokenIndex === -1) {
+    return false;
+  }
+
+  const existingToken = config.tokens[tokenIndex];
+  if (!existingToken) {
+    return false;
+  }
+
+  config.tokens[tokenIndex] = {
+    ...existingToken,
+    name,
+    token,
+  };
+
+  saveTokens(config);
+  return true;
+}
+
+/**
+ * 更新 Token 名稱
+ * @param id Token ID
+ * @param name 新名稱
+ * @returns 是否更新成功
+ */
+export function updateTokenName(id: string, name: string): boolean {
+  const config = loadTokens();
+  const tokenIndex = config.tokens.findIndex((tokenItem) => tokenItem.id === id);
+
+  if (tokenIndex === -1) {
+    return false;
+  }
+
+  const existingToken = config.tokens[tokenIndex];
+  if (!existingToken) {
+    return false;
+  }
+
+  existingToken.name = name;
+  saveTokens(config);
+  return true;
+}
+
+/**
+ * 選擇 Token（互動式）
+ * 根據不同情況返回對應的 Token
+ * - 若無 Token：返回 null
+ * - 若有 1 個 Token：返回該 Token
+ * - 若有 2+ 個 Token：讓用戶選擇
+ * @returns 選擇的 GitToken 或 null
+ */
+export async function selectToken(): Promise<GitToken | null> {
+  const config = loadTokens();
+
+  // 若無 Token
+  if (config.tokens.length === 0) {
+    return null;
+  }
+
+  // 若只有 1 個 Token
+  if (config.tokens.length === 1) {
+    const firstToken = config.tokens[0];
+    if (!firstToken) {
+      return null;
+    }
+    return firstToken;
+  }
+
+  // 若有多個 Token，讓用戶選擇
+  const { selectedToken } = await import('inquirer').then((mod) =>
+    mod.default.prompt([
+      {
+        type: 'list',
+        name: 'selectedToken',
+        message: '選擇要使用的 Git Token：',
+        choices: [
+          ...config.tokens.map((tokenItem) => ({
+            name: tokenItem.name,
+            value: tokenItem.id,
+          })),
+          {
+            name: '❌ 退出',
+            value: 'exit',
+          },
+        ],
+      },
+    ])
+  );
+
+  if (selectedToken === 'exit') {
+    return null;
+  }
+
+  const selectedTokenItem = config.tokens.find((tokenItem) => tokenItem.id === selectedToken);
+  if (!selectedTokenItem) {
+    return null;
+  }
+  return selectedTokenItem;
+}
+
+/**
+ * 獲取所有 Token 名稱列表（用於顯示，不顯示 Token 值）
+ */
+export function getTokenList(): { id: string; name: string; createdAt: string }[] {
+  const config = loadTokens();
+  return config.tokens.map((tokenItem) => ({
+    id: tokenItem.id,
+    name: tokenItem.name,
+    createdAt: tokenItem.createdAt,
+  }));
+}