botrun-horse 2.30.0 → 2.34.0

package/botrun-c/admin/lib/repositories/UserRepository.ts

@@ -1,104 +0,0 @@
-/**
- * 資料存取層：使用者倉儲
- * 負責所有使用者相關的 Firebase 操作
- */
-
-import { getAuth, getFirestore } from '../firebase.js';
-import type { IUser, IUserSubscription, IUserWithSubscription } from '../domain/User.js';
-import type { PlanType } from '../types.js';
-
-export interface IUserRepository {
-  getUserByEmail(email: string): Promise<IUser>;
-  getUserByUid(uid: string): Promise<IUser>;
-  getUserSubscription(uid: string): Promise<IUserSubscription | null>;
-  createUser(email: string, displayName?: string): Promise<IUser>;
-  createSubscription(userId: string, plan: PlanType, endDate?: Date): Promise<IUserSubscription>;
-  updateSubscription(userId: string, updates: Partial<IUserSubscription>): Promise<void>;
-  deleteSubscription(userId: string): Promise<void>;
-}
-
-export class UserRepository implements IUserRepository {
-  private auth = getAuth();
-  private db = getFirestore();
-
-  async getUserByEmail(email: string): Promise<IUser> {
-    const userRecord = await this.auth.getUserByEmail(email);
-    return this.mapAuthUserToUser(userRecord);
-  }
-
-  async getUserByUid(uid: string): Promise<IUser> {
-    const userRecord = await this.auth.getUser(uid);
-    return this.mapAuthUserToUser(userRecord);
-  }
-
-  async getUserSubscription(uid: string): Promise<IUserSubscription | null> {
-    const doc = await this.db.collection('user_subscriptions').doc(uid).get();
-    if (!doc.exists) {
-      return null;
-    }
-    return doc.data() as IUserSubscription;
-  }
-
-  async createUser(email: string, displayName?: string): Promise<IUser> {
-    const name = displayName || email.split('@')[0];
-    const userRecord = await this.auth.createUser({
-      email,
-      displayName: name,
-    });
-
-    const now = new Date();
-    await this.db.collection('users').doc(userRecord.uid).set({
-      email,
-      displayName: name,
-      plan: 'Lite',
-      createdAt: now,
-      updatedAt: now,
-    });
-
-    return this.mapAuthUserToUser(userRecord);
-  }
-
-  async createSubscription(userId: string, plan: PlanType, endDate?: Date): Promise<IUserSubscription> {
-    const now = new Date();
-    const subscription: IUserSubscription = {
-      userId,
-      plan,
-      status: 'active',
-      createdAt: now,
-      updatedAt: now,
-    };
-
-    if (endDate) {
-      subscription.subscriptionEndDate = endDate;
-      subscription.trialEndDate = endDate;
-    }
-
-    await this.db.collection('user_subscriptions').doc(userId).set(subscription);
-    return subscription;
-  }
-
-  async updateSubscription(userId: string, updates: Partial<IUserSubscription>): Promise<void> {
-    const updateData = {
-      ...updates,
-      updatedAt: new Date(),
-    };
-    await this.db.collection('user_subscriptions').doc(userId).update(updateData);
-  }
-
-  async deleteSubscription(userId: string): Promise<void> {
-    await this.db.collection('user_subscriptions').doc(userId).delete();
-  }
-
-  // 私有方法：轉換 Firebase Auth 使用者為領域模型
-  private mapAuthUserToUser(authUser: any): IUser {
-    return {
-      uid: authUser.uid,
-      email: authUser.email || null,
-      displayName: authUser.displayName,
-      createdAt: new Date(authUser.metadata.creationTime),
-      lastSignInTime: authUser.metadata.lastSignInTime
-        ? new Date(authUser.metadata.lastSignInTime)
-        : undefined,
-    };
-  }
-}

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

@@ -1,108 +0,0 @@
-/**
- * 業務邏輯層：使用者服務
- * 協調使用者相關的業務流程
- */
-
-import { UserRepository } from '../repositories/UserRepository.js';
-import type { IUser, IBatchProvisionResult } from '../domain/User.js';
-import type { PlanType } from '../types.js';
-
-export interface IUserService {
-  resolveUser(input: string): Promise<IUser>;
-  resolveOrCreateUser(email: string, plan?: PlanType, endDate?: Date): Promise<{ user: IUser; created: boolean }>;
-  batchProvisionUsers(emails: string[], plan: PlanType, endDate: Date): Promise<IBatchProvisionResult[]>;
-}
-
-export class UserService implements IUserService {
-  private repository = new UserRepository();
-
-  async resolveUser(input: string): Promise<IUser> {
-    if (input.includes('@')) {
-      return this.repository.getUserByEmail(input);
-    } else {
-      return this.repository.getUserByUid(input);
-    }
-  }
-
-  async resolveOrCreateUser(
-    email: string,
-    plan: PlanType = 'Lite',
-    endDate?: Date
-  ): Promise<{ user: IUser; created: boolean }> {
-    if (!email.includes('@')) {
-      throw new Error(`必須提供 Email 格式: ${email}`);
-    }
-
-    try {
-      const user = await this.repository.getUserByEmail(email);
-      return { user, created: false };
-    } catch (error: any) {
-      if (error.code !== 'auth/user-not-found') {
-        throw error;
-      }
-
-      console.log(`  📝 建立新使用者: ${email}`);
-
-      const user = await this.repository.createUser(email);
-      await this.repository.createSubscription(user.uid, plan, endDate);
-
-      return { user, created: true };
-    }
-  }
-
-  async batchProvisionUsers(
-    emails: string[],
-    plan: PlanType,
-    endDate: Date
-  ): Promise<IBatchProvisionResult[]> {
-    const results: IBatchProvisionResult[] = [];
-
-    for (const email of emails) {
-      const trimmedEmail = email.trim();
-      if (!trimmedEmail || !trimmedEmail.includes('@')) {
-        results.push({
-          email: trimmedEmail || '(empty)',
-          success: false,
-          created: false,
-          error: '無效的 Email 格式',
-        });
-        continue;
-      }
-
-      try {
-        const { user, created } = await this.resolveOrCreateUser(trimmedEmail, plan, endDate);
-
-        if (!created) {
-          // 更新既有使用者的訂閱
-          const existingSub = await this.repository.getUserSubscription(user.uid);
-          if (existingSub) {
-            await this.repository.updateSubscription(user.uid, {
-              plan,
-              status: 'active',
-              subscriptionEndDate: endDate,
-              trialEndDate: endDate,
-            });
-          } else {
-            await this.repository.createSubscription(user.uid, plan, endDate);
-          }
-        }
-
-        results.push({
-          email: trimmedEmail,
-          success: true,
-          created,
-          uid: user.uid,
-        });
-      } catch (error: any) {
-        results.push({
-          email: trimmedEmail,
-          success: false,
-          created: false,
-          error: error.message,
-        });
-      }
-    }
-
-    return results;
-  }
-}

package/botrun-c/admin/lib/types.ts

@@ -1,56 +0,0 @@
-/**
- * 共用型別定義
- */
-
-export type PlanType = 'Lite' | 'Max-1' | 'Max-2';
-export type SubscriptionStatus = 'trial' | 'active' | 'expired' | 'cancelled';
-export type CounterType = 'rpm' | 'tpm' | 'rpd';
-
-export interface UserInfo {
-  uid: string;
-  email: string | null;
-  displayName?: string;
-  createdAt?: Date;
-  lastSignInTime?: Date;
-}
-
-export interface FirestoreUser {
-  id: string;
-  email?: string;
-  displayName?: string;
-  plan?: PlanType;
-  createdAt?: Date;
-}
-
-export interface RateLimitStatus {
-  userId: string;
-  plan: PlanType;
-  rpm: {
-    current: number;
-    limit: number;
-    percentage: number;
-  };
-  tpm: {
-    current: number;
-    limit: number;
-    percentage: number;
-  };
-  rpd: {
-    current: number;
-    limit: number;
-    percentage: number;
-  };
-  isBlocked: boolean;
-}
-
-export interface SubscriptionInfo {
-  userId: string;
-  email?: string;
-  plan: PlanType;
-  status: SubscriptionStatus;
-  trialStartDate?: Date;
-  trialEndDate?: Date;
-  daysRemaining: number;
-  isExpired: boolean;
-  createdAt?: Date;
-}

package/botrun-c/admin/lib/user-resolver.ts

@@ -1,275 +0,0 @@
-/**
- * 使用者解析模組
- * 將 Email 或 UID 轉換為完整的使用者資訊
- */
-
-import { getAuth, getFirestore } from './firebase.js';
-import type { UserInfo, PlanType } from './types.js';
-
-export interface CreateUserOptions {
-  /** 是否在使用者不存在時自動建立 */
-  createIfNotExists?: boolean;
-  /** 預設方案 */
-  defaultPlan?: PlanType;
-  /** 訂閱結束日期 */
-  subscriptionEndDate?: Date;
-  /** 顯示名稱（從 email 前綴自動產生） */
-  displayName?: string;
-}
-
-/**
- * 從 Email 或 UID 解析使用者
- * @param input - Email 或 UID
- * @returns 使用者資訊（UID, Email, DisplayName 等）
- */
-export async function resolveUser(input: string): Promise<UserInfo> {
-  const auth = getAuth();
-
-  try {
-    // 判斷輸入是 Email 還是 UID
-    if (input.includes('@')) {
-      // Email
-      const userRecord = await auth.getUserByEmail(input);
-      return {
-        uid: userRecord.uid,
-        email: userRecord.email || null,
-        displayName: userRecord.displayName,
-        createdAt: new Date(userRecord.metadata.creationTime),
-        lastSignInTime: userRecord.metadata.lastSignInTime
-          ? new Date(userRecord.metadata.lastSignInTime)
-          : undefined,
-      };
-    } else {
-      // UID
-      const userRecord = await auth.getUser(input);
-      return {
-        uid: userRecord.uid,
-        email: userRecord.email || null,
-        displayName: userRecord.displayName,
-        createdAt: new Date(userRecord.metadata.creationTime),
-        lastSignInTime: userRecord.metadata.lastSignInTime
-          ? new Date(userRecord.metadata.lastSignInTime)
-          : undefined,
-      };
-    }
-  } catch (error: any) {
-    if (error.code === 'auth/user-not-found') {
-      throw new Error(`找不到使用者: ${input}`);
-    }
-    throw error;
-  }
-}
-
-/**
- * 批次解析多個使用者
- */
-export async function resolveUsers(inputs: string[]): Promise<UserInfo[]> {
-  const results: UserInfo[] = [];
-
-  for (const input of inputs) {
-    try {
-      const user = await resolveUser(input);
-      results.push(user);
-    } catch (error) {
-      console.error(`解析失敗: ${input}`, error);
-    }
-  }
-
-  return results;
-}
-
-/**
- * 解析或建立使用者
- * 如果使用者不存在且 createIfNotExists 為 true，會自動建立使用者
- *
- * @param email - 使用者 Email（必須是 email 格式）
- * @param options - 建立選項
- * @returns 使用者資訊 + 是否為新建立的使用者
- */
-export async function resolveOrCreateUser(
-  email: string,
-  options: CreateUserOptions = {}
-): Promise<{ user: UserInfo; created: boolean }> {
-  const auth = getAuth();
-  const db = getFirestore();
-
-  // 驗證必須是 Email 格式
-  if (!email.includes('@')) {
-    throw new Error(`必須提供 Email 格式: ${email}`);
-  }
-
-  try {
-    // 嘗試查找現有使用者
-    const userRecord = await auth.getUserByEmail(email);
-    return {
-      user: {
-        uid: userRecord.uid,
-        email: userRecord.email || null,
-        displayName: userRecord.displayName,
-        createdAt: new Date(userRecord.metadata.creationTime),
-        lastSignInTime: userRecord.metadata.lastSignInTime
-          ? new Date(userRecord.metadata.lastSignInTime)
-          : undefined,
-      },
-      created: false,
-    };
-  } catch (error: any) {
-    if (error.code !== 'auth/user-not-found') {
-      throw error;
-    }
-
-    // 使用者不存在
-    if (!options.createIfNotExists) {
-      throw new Error(`找不到使用者: ${email}`);
-    }
-
-    // 自動建立使用者
-    console.log(`  📝 建立新使用者: ${email}`);
-
-    // 從 email 前綴產生 displayName
-    const displayName = options.displayName || email.split('@')[0];
-
-    // 建立 Firebase Auth 使用者
-    const newUserRecord = await auth.createUser({
-      email,
-      displayName,
-      // 不設定密碼，使用者需透過 Google 登入或重設密碼
-    });
-
-    const now = new Date();
-
-    // 建立 Firestore users 文件
-    await db.collection('users').doc(newUserRecord.uid).set({
-      email,
-      displayName,
-      plan: options.defaultPlan || 'Lite',
-      createdAt: now,
-      updatedAt: now,
-    });
-
-    // 如果有指定方案和結束日期，建立訂閱記錄
-    if (options.defaultPlan || options.subscriptionEndDate) {
-      const subscriptionData: any = {
-        userId: newUserRecord.uid,
-        plan: options.defaultPlan || 'Lite',
-        status: 'active',
-        createdAt: now,
-        updatedAt: now,
-      };
-
-      if (options.subscriptionEndDate) {
-        subscriptionData.subscriptionEndDate = options.subscriptionEndDate;
-        subscriptionData.trialEndDate = options.subscriptionEndDate;
-      }
-
-      await db.collection('user_subscriptions').doc(newUserRecord.uid).set(subscriptionData);
-    }
-
-    return {
-      user: {
-        uid: newUserRecord.uid,
-        email: newUserRecord.email || null,
-        displayName: newUserRecord.displayName,
-        createdAt: now,
-      },
-      created: true,
-    };
-  }
-}
-
-export interface BatchProvisionResult {
-  email: string;
-  success: boolean;
-  created: boolean;
-  uid?: string;
-  error?: string;
-}
-
-/**
- * 批次建立並設定使用者方案
- *
- * @param emails - Email 清單
- * @param plan - 要設定的方案
- * @param subscriptionEndDate - 訂閱結束日期
- * @returns 處理結果清單
- */
-export async function batchProvisionUsers(
-  emails: string[],
-  plan: PlanType,
-  subscriptionEndDate: Date
-): Promise<BatchProvisionResult[]> {
-  const db = getFirestore();
-  const results: BatchProvisionResult[] = [];
-
-  for (const email of emails) {
-    const trimmedEmail = email.trim();
-    if (!trimmedEmail || !trimmedEmail.includes('@')) {
-      results.push({
-        email: trimmedEmail || '(empty)',
-        success: false,
-        created: false,
-        error: '無效的 Email 格式',
-      });
-      continue;
-    }
-
-    try {
-      const { user, created } = await resolveOrCreateUser(trimmedEmail, {
-        createIfNotExists: true,
-        defaultPlan: plan,
-        subscriptionEndDate,
-      });
-
-      // 如果是既有使用者，更新方案和訂閱
-      if (!created) {
-        // 更新 user_subscriptions
-        const subRef = db.collection('user_subscriptions').doc(user.uid);
-        const subDoc = await subRef.get();
-        const now = new Date();
-
-        if (subDoc.exists) {
-          await subRef.update({
-            plan,
-            status: 'active',
-            subscriptionEndDate,
-            trialEndDate: subscriptionEndDate,
-            updatedAt: now,
-          });
-        } else {
-          await subRef.set({
-            userId: user.uid,
-            plan,
-            status: 'active',
-            subscriptionEndDate,
-            trialEndDate: subscriptionEndDate,
-            createdAt: now,
-            updatedAt: now,
-          });
-        }
-
-        // 更新 users collection（如果存在）
-        const userRef = db.collection('users').doc(user.uid);
-        const userDoc = await userRef.get();
-        if (userDoc.exists) {
-          await userRef.update({ plan });
-        }
-      }
-
-      results.push({
-        email: trimmedEmail,
-        success: true,
-        created,
-        uid: user.uid,
-      });
-    } catch (error: any) {
-      results.push({
-        email: trimmedEmail,
-        success: false,
-        created: false,
-        error: error.message,
-      });
-    }
-  }
-
-  return results;
-}