botrun-horse 2.30.0 → 2.34.0

package/botrun-c/admin/lib/__tests__/formatters.test.ts

@@ -1,264 +0,0 @@
-/**
- * 實質性保護傘測試：formatters.ts
- * 測試輸出格式化函數，確保現有功能完整
- */
-
-import * as formattersModule from '../formatters';
-
-describe('formatters.ts - 實質性保護傘測試', () => {
-  let consoleLogSpy: jest.SpyInstance;
-  let consoleErrorSpy: jest.SpyInstance;
-
-  beforeEach(() => {
-    consoleLogSpy = jest.spyOn(console, 'log').mockImplementation();
-    consoleErrorSpy = jest.spyOn(console, 'error').mockImplementation();
-  });
-
-  afterEach(() => {
-    consoleLogSpy.mockRestore();
-    consoleErrorSpy.mockRestore();
-  });
-
-  describe('formatProgressBar()', () => {
-    test('應該格式化進度條 - 0%', () => {
-      const bar = formattersModule.formatProgressBar(0, 100);
-      expect(bar).toContain('0%');
-      expect(bar).toContain('░');
-    });
-
-    test('應該格式化進度條 - 50%', () => {
-      const bar = formattersModule.formatProgressBar(50, 100);
-      expect(bar).toContain('50%');
-      expect(bar).toContain('█');
-      expect(bar).toContain('░');
-    });
-
-    test('應該格式化進度條 - 100%', () => {
-      const bar = formattersModule.formatProgressBar(100, 100);
-      expect(bar).toContain('100%');
-      expect(bar).toContain('█');
-    });
-
-    test('應該根據百分比顯示不同顏色', () => {
-      // 0-50% 應該是綠色 (\x1b[32m)
-      const bar0 = formattersModule.formatProgressBar(25, 100);
-      expect(bar0).toContain('\x1b[32m');
-
-      // 50-80% 應該是黃色 (\x1b[33m)
-      const bar50 = formattersModule.formatProgressBar(60, 100);
-      expect(bar50).toContain('\x1b[33m');
-
-      // 80-100% 應該是紅色 (\x1b[31m)
-      const bar80 = formattersModule.formatProgressBar(85, 100);
-      expect(bar80).toContain('\x1b[31m');
-    });
-
-    test('應該支持自訂長度', () => {
-      const bar = formattersModule.formatProgressBar(50, 100, 10);
-      // 50% 應該填滿約 5 個字符
-      expect(bar).toBeDefined();
-    });
-
-    test('應該正確處理小數百分比', () => {
-      const bar = formattersModule.formatProgressBar(33, 100);
-      expect(bar).toContain('33%');
-    });
-  });
-
-  describe('formatDate()', () => {
-    test('應該格式化日期為 YYYY-MM-DD', () => {
-      const date = new Date('2025-12-09');
-      const formatted = formattersModule.formatDate(date);
-      expect(formatted).toMatch(/^\d{4}-\d{2}-\d{2}$/);
-      expect(formatted).toContain('2025-12-09');
-    });
-
-    test('應該處理 undefined 日期', () => {
-      const formatted = formattersModule.formatDate(undefined);
-      expect(formatted).toBe('N/A');
-    });
-
-    test('應該處理 null 日期', () => {
-      const formatted = formattersModule.formatDate(null as any);
-      expect(formatted).toBe('N/A');
-    });
-
-    test('應該正確轉換時區', () => {
-      const date = new Date('2025-12-09T10:30:00Z');
-      const formatted = formattersModule.formatDate(date);
-      expect(formatted).toMatch(/^\d{4}-\d{2}-\d{2}$/);
-    });
-  });
-
-  describe('formatRelativeTime()', () => {
-    test('應該顯示「今天」當日期為今天', () => {
-      const today = new Date();
-      today.setHours(0, 0, 0, 0);
-      const formatted = formattersModule.formatRelativeTime(today);
-      expect(formatted).toBe('今天');
-    });
-
-    test('應該顯示「昨天」當日期為昨天', () => {
-      const yesterday = new Date();
-      yesterday.setDate(yesterday.getDate() - 1);
-      yesterday.setHours(0, 0, 0, 0);
-      const formatted = formattersModule.formatRelativeTime(yesterday);
-      expect(formatted).toBe('昨天');
-    });
-
-    test('應該顯示天數 (7 天內)', () => {
-      const threeAgo = new Date();
-      threeAgo.setDate(threeAgo.getDate() - 3);
-      const formatted = formattersModule.formatRelativeTime(threeAgo);
-      expect(formatted).toMatch(/\d+ 天前/);
-      expect(formatted).toContain('3 天前');
-    });
-
-    test('應該顯示週數 (7-30 天)', () => {
-      const twoWeeksAgo = new Date();
-      twoWeeksAgo.setDate(twoWeeksAgo.getDate() - 14);
-      const formatted = formattersModule.formatRelativeTime(twoWeeksAgo);
-      expect(formatted).toMatch(/\d+ 週前/);
-    });
-
-    test('應該顯示月數 (30+ 天)', () => {
-      const twoMonthsAgo = new Date();
-      twoMonthsAgo.setDate(twoMonthsAgo.getDate() - 60);
-      const formatted = formattersModule.formatRelativeTime(twoMonthsAgo);
-      expect(formatted).toMatch(/\d+ 個月前/);
-    });
-
-    test('應該處理 undefined 日期', () => {
-      const formatted = formattersModule.formatRelativeTime(undefined);
-      expect(formatted).toBe('N/A');
-    });
-
-    test('應該處理 null 日期', () => {
-      const formatted = formattersModule.formatRelativeTime(null as any);
-      expect(formatted).toBe('N/A');
-    });
-  });
-
-  describe('formatJSON()', () => {
-    test('應該格式化 JSON 輸出', () => {
-      const data = { email: 'test@example.com', uid: 'uid-123' };
-      formattersModule.formatJSON(data);
-
-      expect(consoleLogSpy).toHaveBeenCalledWith(expect.stringContaining('email'));
-      expect(consoleLogSpy).toHaveBeenCalledWith(expect.stringContaining('uid'));
-    });
-
-    test('應該使用縮進格式化', () => {
-      const data = { nested: { value: 123 } };
-      formattersModule.formatJSON(data);
-
-      const output = consoleLogSpy.mock.calls[0][0] as string;
-      expect(output).toContain('\n');
-    });
-
-    test('應該處理複雜的物件結構', () => {
-      const data = {
-        user: {
-          email: 'test@example.com',
-          metadata: {
-            created: '2025-01-01',
-          },
-        },
-      };
-      formattersModule.formatJSON(data);
-
-      const output = consoleLogSpy.mock.calls[0][0] as string;
-      expect(output).toContain('user');
-      expect(output).toContain('email');
-      expect(output).toContain('metadata');
-    });
-  });
-
-  describe('formatTable()', () => {
-    test('應該格式化表格輸出', () => {
-      const data = [
-        { name: 'Alice', email: 'alice@example.com', plan: 'Lite' },
-        { name: 'Bob', email: 'bob@example.com', plan: 'Max-1' },
-      ];
-      const columns = ['name', 'email', 'plan'];
-
-      formattersModule.formatTable(data, columns);
-
-      const calls = consoleLogSpy.mock.calls.map((c) => c[0]);
-      const output = calls.join('\n');
-
-      expect(output).toContain('Alice');
-      expect(output).toContain('Bob');
-      expect(output).toContain('email');
-      expect(output).toContain('2 筆資料');
-    });
-
-    test('空資料應該顯示「沒有資料」', () => {
-      const data: any[] = [];
-      const columns = ['name', 'email'];
-
-      formattersModule.formatTable(data, columns);
-
-      expect(consoleLogSpy).toHaveBeenCalledWith(expect.stringContaining('沒有資料'));
-    });
-
-    test('應該自動調整列寬', () => {
-      const data = [
-        { short: 'a', long: 'this is a very long value' },
-      ];
-      const columns = ['short', 'long'];
-
-      formattersModule.formatTable(data, columns);
-
-      const calls = consoleLogSpy.mock.calls.map((c) => c[0]);
-      const output = calls.join('\n');
-
-      // long 列應該有足夠的寬度
-      expect(output).toContain('this is a very long value');
-    });
-
-    test('應該顯示資料筆數統計', () => {
-      const data = [
-        { name: 'Alice' },
-        { name: 'Bob' },
-        { name: 'Charlie' },
-      ];
-
-      formattersModule.formatTable(data, ['name']);
-
-      expect(consoleLogSpy).toHaveBeenCalledWith(expect.stringContaining('3 筆資料'));
-    });
-
-    test('應該處理 undefined 和 null 值', () => {
-      const data = [
-        { name: 'Alice', email: null },
-        { name: 'Bob', email: undefined },
-      ];
-
-      formattersModule.formatTable(data, ['name', 'email']);
-
-      const calls = consoleLogSpy.mock.calls.map((c) => String(c[0]));
-      const output = calls.join('\n');
-
-      expect(output).toBeDefined();
-    });
-  });
-
-  describe('exportCSV()', () => {
-    test('應該拒絕空資料匯出', async () => {
-      await formattersModule.exportCSV([], 'test', false);
-
-      expect(consoleLogSpy).toHaveBeenCalledWith(expect.stringContaining('沒有資料可匯出'));
-    });
-
-    test('應該驗證數據結構有效性', async () => {
-      const data = [
-        { name: 'Alice', email: 'alice@example.com' },
-      ];
-
-      // 這個測試檢查函數是否能正確處理數據
-      // 完整測試需要 mock writeFileSync
-      expect(data).toBeDefined();
-    });
-  });
-});

package/botrun-c/admin/lib/__tests__/mocks/firebase.mock.ts

@@ -1,112 +0,0 @@
-/**
- * Firebase Admin SDK 模擬工廠
- * 用於單元測試，模擬 Firebase 的關鍵功能
- */
-
-export const createMockUser = (overrides = {}) => ({
-  uid: 'test-uid-123',
-  email: 'test@example.com',
-  displayName: 'Test User',
-  metadata: {
-    creationTime: new Date('2025-01-01'),
-    lastSignInTime: new Date('2025-12-09'),
-  },
-  ...overrides,
-});
-
-export const createMockSubscription = (overrides = {}) => ({
-  userId: 'test-uid-123',
-  plan: 'Lite',
-  status: 'active',
-  trialStartDate: new Date('2025-11-25'),
-  trialEndDate: new Date('2026-01-08'),
-  createdAt: new Date('2025-11-25'),
-  updatedAt: new Date('2025-12-09'),
-  ...overrides,
-});
-
-export const createMockRateLimitStatus = (overrides = {}) => ({
-  uid: 'test-uid-123',
-  email: 'test@example.com',
-  plan: 'Lite',
-  hasCustomLimits: false,
-  planDefaults: {
-    rpm: 6,
-    tpm: 200000,
-    rpd: 32,
-  },
-  customLimits: null,
-  effective: {
-    rpm: 6,
-    tpm: 200000,
-    rpd: 32,
-  },
-  current: {
-    rpm: 2,
-    tpm: 45000,
-    rpd: 10,
-  },
-  utilization: {
-    rpm: '33%',
-    tpm: '22.5%',
-    rpd: '31%',
-  },
-  ...overrides,
-});
-
-export const createMockBillingRecord = (overrides = {}) => ({
-  uid: 'test-uid-123',
-  timestamp: new Date('2025-12-09T10:30:00Z'),
-  endpoint: 'chat',
-  model: 'claude-opus-4-5',
-  inputTokens: 1000,
-  outputTokens: 500,
-  totalTokens: 1500,
-  cost: 0.0315,
-  success: true,
-  ...overrides,
-});
-
-export const createMockDocumentSnapshot = (data: any, docId: string = 'test-doc') => ({
-  id: docId,
-  data: () => data,
-  exists: true,
-  ref: {
-    id: docId,
-    path: `test-collection/${docId}`,
-  },
-});
-
-export const createMockQuerySnapshot = (docs: any[] = []) => ({
-  empty: docs.length === 0,
-  size: docs.length,
-  docs: docs,
-  forEach: (callback: (doc: any) => void) => docs.forEach(callback),
-});
-
-export const createMockFirestoreReference = (data: Record<string, any> = {}): any => ({
-  collection: jest.fn(() => createMockFirestoreCollection(data)),
-  doc: jest.fn(() => createMockFirestoreDocument(data)),
-});
-
-export const createMockFirestoreCollection = (data: Record<string, any> = {}): any => ({
-  doc: jest.fn(() => createMockFirestoreDocument(data)),
-  get: jest.fn().mockResolvedValue(createMockQuerySnapshot()),
-  add: jest.fn().mockResolvedValue({ id: 'new-doc-id' }),
-});
-
-export const createMockFirestoreDocument = (data: Record<string, any> = {}): any => ({
-  get: jest.fn().mockResolvedValue(createMockDocumentSnapshot(data)),
-  set: jest.fn().mockResolvedValue(undefined),
-  update: jest.fn().mockResolvedValue(undefined),
-  delete: jest.fn().mockResolvedValue(undefined),
-  collection: jest.fn(() => createMockFirestoreCollection()),
-});
-
-export const createMockAuth = () => ({
-  listUsers: jest.fn().mockResolvedValue({
-    users: [createMockUser()],
-  }),
-  getUser: jest.fn().mockResolvedValue(createMockUser()),
-  getUserByEmail: jest.fn().mockResolvedValue(createMockUser()),
-});

package/botrun-c/admin/lib/__tests__/services/UserService.test.ts

@@ -1,83 +0,0 @@
-/**
- * 測試：UserService（重構後的業務邏輯層）
- * 確保重構後的邏輯與原有功能一致
- */
-
-import { UserService } from '../../services/UserService.js';
-
-// Mock repositories
-jest.mock('../../repositories/UserRepository.js', () => {
-  return {
-    UserRepository: jest.fn().mockImplementation(() => ({
-      getUserByEmail: jest.fn(),
-      getUserByUid: jest.fn(),
-      getUserSubscription: jest.fn(),
-      createUser: jest.fn(),
-      createSubscription: jest.fn(),
-      updateSubscription: jest.fn(),
-      deleteSubscription: jest.fn(),
-    })),
-  };
-});
-
-describe('UserService - 重構業務邏輯層測試', () => {
-  let userService: UserService;
-  let mockRepository: any;
-
-  beforeEach(() => {
-    userService = new UserService();
-    const UserRepository = require('../../repositories/UserRepository.js').UserRepository;
-    mockRepository = new UserRepository();
-  });
-
-  describe('resolveUser()', () => {
-    test('Email 輸入應該呼叫 getUserByEmail', async () => {
-      mockRepository.getUserByEmail = jest.fn().mockResolvedValue({
-        uid: 'uid-123',
-        email: 'test@example.com',
-      });
-
-      userService = new UserService();
-      // 由於 service 內部創建了 repository，我們需要測試整個流程
-      // 這個測試確保邏輯流程正確
-      expect(userService).toBeDefined();
-    });
-
-    test('UID 輸入應該呼叫 getUserByUid', async () => {
-      expect(userService).toBeDefined();
-    });
-  });
-
-  describe('resolveOrCreateUser()', () => {
-    test('現有使用者應該返回 created=false', async () => {
-      expect(userService).toBeDefined();
-    });
-
-    test('不存在的使用者應該建立新使用者', async () => {
-      expect(userService).toBeDefined();
-    });
-
-    test('必須是 Email 格式', async () => {
-      await expect(
-        userService.resolveOrCreateUser('uid-without-at')
-      ).rejects.toThrow('必須提供 Email 格式');
-    });
-  });
-
-  describe('batchProvisionUsers()', () => {
-    test('應該處理多個使用者', async () => {
-      expect(userService).toBeDefined();
-    });
-
-    test('無效的 Email 應該返回錯誤', async () => {
-      const results = await userService.batchProvisionUsers(
-        ['invalid-email'],
-        'Lite',
-        new Date('2026-01-01')
-      );
-
-      expect(results[0].success).toBe(false);
-      expect(results[0].error).toContain('無效的 Email 格式');
-    });
-  });
-});