botrun-horse 2.29.2 → 2.30.0

package/botrun-c/web/hooks/useUserPlan.ts

@@ -0,0 +1,153 @@
+"use client";
+
+import { useState, useEffect, useCallback, useRef } from 'react';
+import { getApiUrl } from '@/lib/api-url';
+
+interface UserPlanData {
+  plan: string;
+  status: string;
+  daysRemaining?: number;
+}
+
+/**
+ * Hook to fetch user's subscription plan
+ * - Fetches from /api/config/user-plan
+ * - Returns formatted plan name (e.g., "Free", "Lite", "Pro")
+ * - Handles loading and error states
+ * - Supports manual refetch with 3-minute cache
+ */
+export function useUserPlan(user?: any) {
+  const [planData, setPlanData] = useState<UserPlanData | null>(null);
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState<Error | null>(null);
+  const lastFetchTimeRef = useRef<number>(0);
+
+  // 🎯 核心 fetch 函數（提取出來供 useEffect 和 refetch 使用）
+  const fetchUserPlan = useCallback(async () => {
+    if (!user) {
+      setPlanData(null);
+      setIsLoading(false);
+      setError(null);
+      return;
+    }
+
+    // 🔧 SKIP_AUTH 模式（本地開發 + 物理隔離）：跳過 API 呼叫
+    // 前端無真實 Firebase user，直接使用預設方案
+    if (typeof window !== 'undefined' && window.location.port === '3000') {
+      console.log('[useUserPlan] 🔧 Local dev mode detected, using default plan (skip API)');
+      setPlanData({
+        plan: 'Lite',
+        status: 'active',
+      });
+      setIsLoading(false);
+      return;
+    }
+
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      // 取得 Firebase Auth Token
+      const token = await user.getIdToken();
+
+      // 呼叫 API
+      const apiUrl = getApiUrl();
+      const response = await fetch(`${apiUrl}/api/config/user-plan`, {
+        method: 'GET',
+        headers: {
+          'Authorization': `Bearer ${token}`,
+          'Content-Type': 'application/json',
+        },
+      });
+
+      if (!response.ok) {
+        throw new Error(`API error: ${response.status}`);
+      }
+
+      const data = await response.json();
+
+      if (data.success && data.plan) {
+        setPlanData({
+          plan: data.plan,
+          status: data.status || 'active',
+          daysRemaining: data.daysRemaining,
+        });
+        console.log('[useUserPlan] ✅ Plan fetched successfully:', data.plan);
+
+        // 🎯 更新最後查詢時間
+        lastFetchTimeRef.current = Date.now();
+      } else {
+        throw new Error('Invalid API response');
+      }
+    } catch (err) {
+      console.error('[useUserPlan] ❌ Failed to fetch plan:', err);
+      setError(err instanceof Error ? err : new Error('Unknown error'));
+      // ✅ 失敗時不清空 planData，保持原有顯示
+    } finally {
+      setIsLoading(false);
+    }
+  }, [user]);
+
+  // 初始載入
+  useEffect(() => {
+    if (!user) {
+      setPlanData(null);
+      setIsLoading(false);
+      setError(null);
+      return;
+    }
+
+    fetchUserPlan();
+  }, [user, fetchUserPlan]);
+
+  /**
+   * 🎯 手動重新查詢（帶 3 分鐘快取）
+   * - 用於點擊選單時重新查詢方案
+   * - 3 分鐘內重複呼叫會自動跳過
+   */
+  const refetch = useCallback(async () => {
+    const now = Date.now();
+    const CACHE_DURATION = 3 * 60 * 1000; // 3 分鐘
+
+    // 檢查快取是否仍然有效
+    if (now - lastFetchTimeRef.current < CACHE_DURATION) {
+      console.log('[useUserPlan] ⏭️ Skipped refetch (cached, valid for',
+        Math.floor((CACHE_DURATION - (now - lastFetchTimeRef.current)) / 1000),
+        'seconds)');
+      return;
+    }
+
+    console.log('[useUserPlan] 🔄 Refetching user plan...');
+    await fetchUserPlan();
+  }, [fetchUserPlan]);
+
+  /**
+   * 格式化 plan 名稱
+   * Lite -> Lite
+   * Max-1 -> Max-1
+   * Max-2 -> Max-2
+   */
+  const formatPlanName = (plan: string): string => {
+    // 移除 "plan-" 前綴
+    const planName = plan.replace(/^plan-/, '');
+
+    // 首字母大寫
+    return planName.charAt(0).toUpperCase() + planName.slice(1);
+  };
+
+  return {
+    // 原始資料
+    planData,
+    isLoading,
+    error,
+
+    // 格式化的方案名稱（用於顯示）
+    planName: planData ? formatPlanName(planData.plan) : null,
+
+    // 是否有方案資料
+    hasPlan: !!planData,
+
+    // 🎯 手動重新查詢（帶快取）
+    refetch,
+  };
+}

package/botrun-c/web/lib/api-config.ts

@@ -0,0 +1,162 @@
+/**
+ * API Configuration - 新架構
+ *
+ * 簡化的重定向架構：
+ * 1. 用戶訪問統一前端 (botrun-j)
+ * 2. 登入後，AuthContext 檢查 Custom Claims
+ * 3. 直接重定向到用戶的專屬後端 (botrun-j-{hash})
+ * 4. 用戶已在統一前端完成認證，Firebase 登入狀態自動帶過去
+ * 5. 每個後端獨立運作，無需複雜的 API 路由
+ *
+ * 此文件現在主要用於備用方案（如果重定向失敗）
+ */
+
+// Global API base URL (會在重定向失敗時使用)
+let apiBaseUrl = '';
+
+/**
+ * Set API base URL (備用方案)
+ * 在新架構中，通常不會呼叫此函式，因為用戶直接被重定向到後端
+ * @param serviceUrl - Optional: The full service URL
+ */
+export function setApiBaseUrl(serviceUrl?: string): void {
+  if (!serviceUrl) {
+    // 備用方案：使用當前主機作為 API 基址
+    console.log('🔧 [API Config] Using current host as API base (fallback)');
+    apiBaseUrl = '';
+    return;
+  }
+
+  console.log('🔧 [API Config] Setting API base URL (backup):', serviceUrl);
+  apiBaseUrl = serviceUrl;
+
+  if (typeof window !== 'undefined') {
+    localStorage.setItem('api_base_url', serviceUrl);
+  }
+}
+
+/**
+ * Get current API base URL
+ * Returns empty string if not set (before login)
+ */
+export function getApiBaseUrl(): string {
+  // Try to restore from localStorage if not set
+  if (!apiBaseUrl && typeof window !== 'undefined') {
+    const stored = localStorage.getItem('api_base_url');
+    if (stored) {
+      console.log('📦 [API Config] Restoring API base URL from localStorage:', stored);
+      apiBaseUrl = stored;
+    }
+  }
+
+  return apiBaseUrl;
+}
+
+/**
+ * Clear API base URL (on logout)
+ */
+export function clearApiBaseUrl(): void {
+  console.log('🗑️ [API Config] Clearing API base URL');
+  apiBaseUrl = '';
+
+  if (typeof window !== 'undefined') {
+    localStorage.removeItem('api_base_url');
+    localStorage.removeItem('api_allowed_service');
+  }
+}
+
+/**
+ * Get full API URL by appending path to base URL
+ * @param path - API path (e.g., "/api/data/patients/xxx")
+ */
+export function getApiUrl(path: string): string {
+  const base = getApiBaseUrl();
+
+  if (!base) {
+    // If base URL not set (before login), use relative path (fallback)
+    console.warn('⚠️ [API Config] API base URL not set, using relative path');
+    return path;
+  }
+
+  // Ensure path starts with /
+  const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+  const fullUrl = `${base}${normalizedPath}`;
+
+  console.log('🔗 [API Config] Full API URL:', fullUrl);
+
+  return fullUrl;
+}
+
+/**
+ * Health check for API connectivity
+ * Returns {healthy: true} if API is reachable
+ */
+export async function checkApiHealth(): Promise<{
+  healthy: boolean;
+  url?: string;
+  responseTime?: number;
+  error?: string;
+}> {
+  const base = getApiBaseUrl();
+
+  if (!base) {
+    console.warn('⚠️ [API Health] API base URL not set');
+    return { healthy: false, error: 'API base URL not configured' };
+  }
+
+  const healthUrl = `${base}/api/health`;
+  const startTime = performance.now();
+
+  try {
+    console.log('🏥 [API Health] Checking API health:', healthUrl);
+
+    // Note: Standard fetch doesn't support timeout, so we implement it with AbortController
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 5000);
+
+    const response = await fetch(healthUrl, {
+      method: 'GET',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      signal: controller.signal,
+    });
+    clearTimeout(timeoutId);
+
+    const responseTime = performance.now() - startTime;
+
+    if (response.ok) {
+      console.log(`✅ [API Health] API is healthy (${responseTime.toFixed(0)}ms)`, {
+        status: response.status,
+        url: healthUrl,
+      });
+      return { healthy: true, url: healthUrl, responseTime };
+    } else {
+      console.error(`❌ [API Health] API returned error status:`, {
+        status: response.status,
+        statusText: response.statusText,
+        url: healthUrl,
+        responseTime,
+      });
+      return {
+        healthy: false,
+        url: healthUrl,
+        responseTime,
+        error: `HTTP ${response.status}: ${response.statusText}`
+      };
+    }
+  } catch (error: any) {
+    const responseTime = performance.now() - startTime;
+    console.error(`❌ [API Health] Failed to reach API:`, {
+      url: healthUrl,
+      error: error?.message || String(error),
+      responseTime,
+    });
+    return {
+      healthy: false,
+      url: healthUrl,
+      responseTime,
+      error: error?.message || 'Network error'
+    };
+  }
+}

package/botrun-c/web/lib/api-url.ts

@@ -0,0 +1,62 @@
+/**
+ * API URL 解析邏輯
+ *
+ * 兼容兩種開發模式：
+ * 1. sh/debug.sh: 前端 (port 3000) + API (port 8080) 分離
+ * 2. sh/deploy.sh: 前端靜態檔案由 API server 提供 (same origin)
+ */
+
+/**
+ * 取得 API Base URL
+ *
+ * @returns API base URL (例如: 'http://localhost:8080' 或 '')
+ */
+export function getApiUrl(): string {
+  // Server-side rendering: 不執行
+  if (typeof window === 'undefined') {
+    return '';
+  }
+
+  // 1. 檢查環境變數（優先級最高）
+  if (process.env.NEXT_PUBLIC_API_URL) {
+    console.log('[API URL] Using NEXT_PUBLIC_API_URL:', process.env.NEXT_PUBLIC_API_URL);
+    return process.env.NEXT_PUBLIC_API_URL;
+  }
+
+  // 2. 檢查是否為本地開發環境 (port 3000 = Next.js dev server)
+  const currentPort = window.location.port;
+  const isNextDevServer = currentPort === '3000';
+
+  if (isNextDevServer) {
+    // 本地開發：前端在 3000，API 在 8080
+    const apiUrl = 'http://localhost:8080';
+    console.log('[API URL] Detected Next.js dev server (port 3000), using:', apiUrl);
+    return apiUrl;
+  }
+
+  // 3. 生產環境或 same-origin：使用相對路徑（空字串）
+  console.log('[API URL] Using same-origin (relative path)');
+  return '';
+}
+
+/**
+ * 建立完整的 API endpoint URL
+ *
+ * @param path API 路徑（例如: '/api/chat'）
+ * @returns 完整的 URL
+ */
+export function getApiEndpoint(path: string): string {
+  const baseUrl = getApiUrl();
+  const fullUrl = `${baseUrl}${path}`;
+  return fullUrl;
+}
+
+// 導出單例實例（在客戶端初始化時計算一次）
+let cachedApiUrl: string | null = null;
+
+export function getCachedApiUrl(): string {
+  if (cachedApiUrl === null && typeof window !== 'undefined') {
+    cachedApiUrl = getApiUrl();
+  }
+  return cachedApiUrl || '';
+}

package/botrun-c/web/lib/api.ts

@@ -0,0 +1,105 @@
+/**
+ * API Helper functions with Firebase Authentication
+ * Uses dynamic API base URL from api-config (set based on Custom Claims)
+ */
+
+import { getClientAuth } from './firebase';
+import { getApiUrl } from './api-config';
+
+/**
+ * Get Firebase ID Token for authenticated requests
+ */
+export async function getAuthToken(): Promise<string | null> {
+  if (typeof window === 'undefined') {
+    return null;
+  }
+
+  try {
+    const auth = getClientAuth();
+
+    if (!auth) {
+      console.warn('⚠️ Firebase Auth not initialized');
+      return null;
+    }
+
+    const user = auth.currentUser;
+
+    if (!user) {
+      console.warn('⚠️ No authenticated user');
+      return null;
+    }
+
+    const token = await user.getIdToken();
+    console.log('🔑 Got Firebase ID token for:', user.email);
+    return token;
+  } catch (error) {
+    console.error('❌ Failed to get ID token:', error);
+    return null;
+  }
+}
+
+/**
+ * Download file from /api/data/** with authentication
+ * @param filePath - Path relative to data directory (e.g., "patients/xxx/form-1.html")
+ * @param customFilename - Optional custom filename for download
+ */
+export async function downloadDataFile(filePath: string, customFilename?: string): Promise<void> {
+  try {
+    const token = await getAuthToken();
+
+    if (!token) {
+      throw new Error('Not authenticated. Please sign in first.');
+    }
+
+    // Build URL (using dynamic API base URL from Custom Claims)
+    const relativePath = customFilename
+      ? `/api/data/${filePath}?filename=${encodeURIComponent(customFilename)}`
+      : `/api/data/${filePath}`;
+
+    const url = getApiUrl(relativePath);
+    console.log('📥 Downloading file:', url);
+
+    // Fetch with authentication
+    const response = await fetch(url, {
+      headers: {
+        'Authorization': `Bearer ${token}`,
+      },
+    });
+
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({ error: 'Unknown error' }));
+      throw new Error(errorData.error || `HTTP ${response.status}`);
+    }
+
+    // Get filename from Content-Disposition header or use custom/original
+    const contentDisposition = response.headers.get('Content-Disposition');
+    let filename = customFilename || filePath.split('/').pop() || 'download';
+
+    if (contentDisposition) {
+      const match = contentDisposition.match(/filename[^;=\n]*=((['"]).*?\2|[^;\n]*)/);
+      if (match && match[1]) {
+        filename = decodeURIComponent(match[1].replace(/['"]/g, ''));
+      }
+    }
+
+    // Download blob
+    const blob = await response.blob();
+    const blobUrl = window.URL.createObjectURL(blob);
+
+    // Create download link
+    const a = document.createElement('a');
+    a.href = blobUrl;
+    a.download = filename;
+    document.body.appendChild(a);
+    a.click();
+
+    // Cleanup
+    window.URL.revokeObjectURL(blobUrl);
+    document.body.removeChild(a);
+
+    console.log('✅ File downloaded:', filename);
+  } catch (error) {
+    console.error('❌ Download failed:', error);
+    throw error;
+  }
+}

package/botrun-c/web/lib/attachment-utils.ts

@@ -0,0 +1,168 @@
+/**
+ * 附件系統工具函數
+ */
+
+import type { AttachmentType } from '@/types/attachment';
+
+/**
+ * 根據 MIME 類型判斷附件類型
+ */
+export function getAttachmentType(mimeType: string): AttachmentType {
+  if (!mimeType) return 'file';
+
+  if (mimeType.startsWith('image/')) return 'image';
+  if (mimeType.startsWith('video/')) return 'video';
+  if (mimeType.startsWith('audio/')) return 'audio';
+  if (mimeType === 'application/pdf') return 'pdf';
+
+  return 'file';
+}
+
+/**
+ * 判斷附件類型是否可以預覽（顯示縮圖）
+ */
+export function canPreview(type: AttachmentType): boolean {
+  return type === 'image' || type === 'video';
+}
+
+/**
+ * 根據附件類型取得對應的圖示
+ */
+export function getFileIcon(type: AttachmentType): string {
+  switch (type) {
+    case 'image':
+      return '🖼️';
+    case 'video':
+      return '🎬';
+    case 'audio':
+      return '🎵';
+    case 'pdf':
+      return '📄';
+    default:
+      return '📎';
+  }
+}
+
+/**
+ * 根據副檔名取得附件類型（備用方案）
+ */
+export function getAttachmentTypeByExtension(filename: string): AttachmentType {
+  const ext = filename.split('.').pop()?.toLowerCase();
+
+  if (!ext) return 'file';
+
+  // 圖片
+  if (['jpg', 'jpeg', 'png', 'gif', 'webp', 'svg', 'bmp', 'ico'].includes(ext)) {
+    return 'image';
+  }
+
+  // 影片
+  if (['mp4', 'webm', 'mov', 'avi', 'mkv', 'm4v'].includes(ext)) {
+    return 'video';
+  }
+
+  // 音訊
+  if (['mp3', 'wav', 'ogg', 'm4a', 'aac', 'flac', 'webm'].includes(ext)) {
+    return 'audio';
+  }
+
+  // PDF
+  if (ext === 'pdf') {
+    return 'pdf';
+  }
+
+  return 'file';
+}
+
+/**
+ * 格式化檔案大小
+ */
+export function formatAttachmentSize(bytes: number): string {
+  if (bytes === 0) return '0 B';
+
+  const units = ['B', 'KB', 'MB', 'GB'];
+  const k = 1024;
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+
+  return `${(bytes / Math.pow(k, i)).toFixed(i > 1 ? 1 : 0)} ${units[i]}`;
+}
+
+/**
+ * 驗證檔案是否可接受
+ */
+export function validateFile(
+  file: File,
+  options: {
+    maxSize?: number;
+    allowedTypes?: string[];
+  } = {}
+): { valid: boolean; error?: string } {
+  const { maxSize, allowedTypes } = options;
+
+  // 檢查檔案大小
+  if (maxSize && file.size > maxSize) {
+    return {
+      valid: false,
+      error: `檔案 "${file.name}" 超過 ${formatAttachmentSize(maxSize)} 限制`,
+    };
+  }
+
+  // 檢查檔案類型（如果有限制）
+  if (allowedTypes && allowedTypes.length > 0) {
+    const isAllowed = allowedTypes.some(type => {
+      if (type.endsWith('/*')) {
+        // 例如 'image/*'
+        const prefix = type.slice(0, -1);
+        return file.type.startsWith(prefix);
+      }
+      return file.type === type;
+    });
+
+    if (!isAllowed) {
+      return {
+        valid: false,
+        error: `不支援的檔案類型: ${file.type || '未知'}`,
+      };
+    }
+  }
+
+  return { valid: true };
+}
+
+/**
+ * 從剪貼簿事件中提取檔案
+ */
+export function getFilesFromClipboard(event: ClipboardEvent): File[] {
+  const items = event.clipboardData?.items;
+  if (!items) return [];
+
+  const files: File[] = [];
+
+  for (const item of items) {
+    if (item.kind === 'file') {
+      const file = item.getAsFile();
+      if (file) {
+        files.push(file);
+      }
+    }
+  }
+
+  return files;
+}
+
+/**
+ * 從拖放事件中提取檔案
+ */
+export function getFilesFromDrop(event: DragEvent): File[] {
+  const dataTransfer = event.dataTransfer;
+  if (!dataTransfer) return [];
+
+  return Array.from(dataTransfer.files);
+}
+
+/**
+ * 產生唯一 ID
+ */
+export function generateAttachmentId(): string {
+  return crypto.randomUUID();
+}

package/botrun-c/web/lib/build-version.ts

@@ -0,0 +1,11 @@
+/**
+ * Capawesome Live Update Build Version
+ *
+ * 此檔案由 /deploy-capawesome 自動更新
+ * 每次部署到 Capawesome Cloud 時，版本號會自動更新
+ *
+ * 格式：西元年最後一個號碼.月日.時分
+ * 範例：5.1125.1547 (2025年11月25日 15:47)
+ */
+
+export const BUILD_VERSION = '5.1125.1614';