botrun-horse 2.29.2 → 2.30.0

package/botrun-c/web/hooks/use-toast.ts

@@ -0,0 +1,187 @@
+import * as React from "react"
+
+import type { ToastActionElement, ToastProps } from "@/components/ui/toast"
+
+const TOAST_LIMIT = 1
+const TOAST_REMOVE_DELAY = 1000000
+
+type ToasterToast = ToastProps & {
+  id: string
+  title?: React.ReactNode
+  description?: React.ReactNode
+  action?: ToastActionElement
+  duration?: number
+}
+
+const actionTypes = {
+  ADD_TOAST: "ADD_TOAST",
+  UPDATE_TOAST: "UPDATE_TOAST",
+  DISMISS_TOAST: "DISMISS_TOAST",
+  REMOVE_TOAST: "REMOVE_TOAST",
+} as const
+
+let count = 0
+
+function genId() {
+  count = (count + 1) % Number.MAX_SAFE_INTEGER
+  return count.toString()
+}
+
+type ActionType = typeof actionTypes
+
+type Action =
+  | {
+      type: ActionType["ADD_TOAST"]
+      toast: ToasterToast
+    }
+  | {
+      type: ActionType["UPDATE_TOAST"]
+      toast: Partial<ToasterToast>
+    }
+  | {
+      type: ActionType["DISMISS_TOAST"]
+      toastId?: ToasterToast["id"]
+    }
+  | {
+      type: ActionType["REMOVE_TOAST"]
+      toastId?: ToasterToast["id"]
+    }
+
+interface State {
+  toasts: ToasterToast[]
+}
+
+const toastTimeouts = new Map<string, ReturnType<typeof setTimeout>>()
+
+const addToRemoveQueue = (toastId: string) => {
+  if (toastTimeouts.has(toastId)) {
+    return
+  }
+
+  const timeout = setTimeout(() => {
+    toastTimeouts.delete(toastId)
+    dispatch({
+      type: "REMOVE_TOAST",
+      toastId: toastId,
+    })
+  }, TOAST_REMOVE_DELAY)
+
+  toastTimeouts.set(toastId, timeout)
+}
+
+export const reducer = (state: State, action: Action): State => {
+  switch (action.type) {
+    case "ADD_TOAST":
+      return {
+        ...state,
+        toasts: [action.toast, ...state.toasts].slice(0, TOAST_LIMIT),
+      }
+
+    case "UPDATE_TOAST":
+      return {
+        ...state,
+        toasts: state.toasts.map((t) =>
+          t.id === action.toast.id ? { ...t, ...action.toast } : t
+        ),
+      }
+
+    case "DISMISS_TOAST": {
+      const { toastId } = action
+
+      if (toastId) {
+        addToRemoveQueue(toastId)
+      } else {
+        state.toasts.forEach((toast) => {
+          addToRemoveQueue(toast.id)
+        })
+      }
+
+      return {
+        ...state,
+        toasts: state.toasts.map((t) =>
+          t.id === toastId || toastId === undefined
+            ? {
+                ...t,
+                open: false,
+              }
+            : t
+        ),
+      }
+    }
+    case "REMOVE_TOAST":
+      if (action.toastId === undefined) {
+        return {
+          ...state,
+          toasts: [],
+        }
+      }
+      return {
+        ...state,
+        toasts: state.toasts.filter((t) => t.id !== action.toastId),
+      }
+  }
+}
+
+const listeners: Array<(state: State) => void> = []
+
+let memoryState: State = { toasts: [] }
+
+function dispatch(action: Action) {
+  memoryState = reducer(memoryState, action)
+  listeners.forEach((listener) => {
+    listener(memoryState)
+  })
+}
+
+type Toast = Omit<ToasterToast, "id">
+
+function toast({ ...props }: Toast) {
+  const id = genId()
+
+  const update = (props: ToasterToast) =>
+    dispatch({
+      type: "UPDATE_TOAST",
+      toast: { ...props, id },
+    })
+  const dismiss = () => dispatch({ type: "DISMISS_TOAST", toastId: id })
+
+  dispatch({
+    type: "ADD_TOAST",
+    toast: {
+      ...props,
+      id,
+      open: true,
+      onOpenChange: (open) => {
+        if (!open) dismiss()
+      },
+    },
+  })
+
+  return {
+    id: id,
+    dismiss,
+    update,
+  }
+}
+
+function useToast() {
+  const [state, setState] = React.useState<State>(memoryState)
+
+  React.useEffect(() => {
+    listeners.push(setState)
+    return () => {
+      const index = listeners.indexOf(setState)
+      if (index > -1) {
+        listeners.splice(index, 1)
+      }
+    }
+  }, [state])
+
+  return {
+    ...state,
+    toast,
+    dismiss: (toastId?: string) => dispatch({ type: "DISMISS_TOAST", toastId }),
+  }
+}
+
+export { useToast, toast }

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

@@ -0,0 +1,356 @@
+"use client";
+
+import { useState, useEffect } from "react";
+import { App, AppPlugin } from "@capacitor/app";
+import { AppUpdate, AppUpdateAvailability } from "@capawesome/capacitor-app-update";
+import { useCapacitorPlatform } from "./useCapacitorPlatform";
+import { PluginListenerHandle } from "@capacitor/core";
+
+export interface AppUpdateInfo {
+  updateAvailable: boolean;
+  currentVersion: string;
+  latestVersion: string;
+  isChecking: boolean;
+  storeUrl: string;
+  hasSeenUpdateNotification: boolean;
+  markUpdateAsSeen: () => void;
+}
+
+/**
+ * Hook to check for app updates
+ * - iOS: 使用 @capawesome/capacitor-app-update（底層也是呼叫 iTunes Lookup API）
+ * - Android: 使用 @capawesome/capacitor-app-update
+ *
+ * ⚠️ TestFlight 限制：
+ * - iTunes Lookup API 只返回 App Store 正式版本，無法偵測 TestFlight 更新
+ * - Internal test 的人無法透過程式碼檢查新的 TestFlight build
+ * - TestFlight 更新依賴 Apple 發送的通知（email + 推播）或使用者手動開啟 TestFlight app
+ *
+ * @returns {AppUpdateInfo} Update information with seen status
+ */
+export function useAppStoreUpdate(): AppUpdateInfo {
+  const { isCapacitor, isIOS, isAndroid } = useCapacitorPlatform();
+
+  const [updateInfo, setUpdateInfo] = useState({
+    updateAvailable: false,
+    currentVersion: '',
+    latestVersion: '',
+    isChecking: false,
+    storeUrl: '',
+    hasSeenUpdateNotification: false,
+  });
+
+  // 🎯 檢查更新（在 app resume 時觸發）
+  const checkForUpdate = async () => {
+    // 只在 Native App 中檢查
+    if (!isCapacitor) {
+      console.log('🔍 [useAppStoreUpdate] Not in Capacitor environment, skipping update check');
+      return;
+    }
+
+    setUpdateInfo(prev => ({ ...prev, isChecking: true }));
+
+    try {
+      // 取得當前版本
+      const appInfo = await App.getInfo();
+      const currentVersion = appInfo.version;
+
+      console.log('🔍 [useAppStoreUpdate] Checking for updates...', {
+        currentVersion,
+        platform: isIOS ? 'iOS' : isAndroid ? 'Android' : 'Unknown'
+      });
+
+      let hasUpdate = false;
+      let latestVersion = currentVersion;
+      let storeUrl = '';
+
+      if (isIOS) {
+        // 🍎 iOS: 使用 @capawesome/capacitor-app-update 套件
+        console.log('🍎 [useAppStoreUpdate] Using AppUpdate plugin for iOS...');
+
+        // 🔄 舊實作：手動呼叫 iTunes Lookup API（保留以便日後切換）
+        if (false) {
+          console.log('🍎 [useAppStoreUpdate] Using iTunes Lookup API for iOS...');
+          const iosResult = await checkIOSUpdateViaAPI(currentVersion);
+          hasUpdate = iosResult.hasUpdate;
+          latestVersion = iosResult.latestVersion;
+          storeUrl = iosResult.storeUrl;
+
+          console.log('✅ [useAppStoreUpdate] iOS check result:', {
+            hasUpdate,
+            currentVersion,
+            latestVersion,
+          });
+        }
+
+        // ✅ 新實作：使用 AppUpdate 套件（底層也是呼叫 iTunes Lookup API）
+        try {
+          const result = await AppUpdate.getAppUpdateInfo({ country: 'tw' });
+
+          console.log('📱 [useAppStoreUpdate] AppUpdate result (iOS):', result);
+
+          // 使用 AppUpdateAvailability 枚舉來判斷
+          hasUpdate = result.updateAvailability === AppUpdateAvailability.UPDATE_AVAILABLE;
+
+          // iOS 可以取得版本號
+          if (result.availableVersionName) {
+            latestVersion = result.availableVersionName;
+          } else {
+            latestVersion = currentVersion;
+          }
+
+          const appleId = '6755088108';
+          storeUrl = `https://apps.apple.com/tw/app/id${appleId}`;
+
+          console.log('✅ [useAppStoreUpdate] iOS check result:', {
+            hasUpdate,
+            currentVersion,
+            latestVersion,
+            updateAvailability: result.updateAvailability,
+          });
+
+        } catch (error: any) {
+          console.error('❌ [useAppStoreUpdate] AppUpdate failed for iOS:', error.message);
+          const appleId = '6755088108';
+          storeUrl = `https://apps.apple.com/tw/app/id${appleId}`;
+        }
+
+      } else if (isAndroid) {
+        // 🤖 Android: 使用 AppUpdate 套件
+        console.log('🤖 [useAppStoreUpdate] Using AppUpdate for Android...');
+        try {
+          const result = await AppUpdate.getAppUpdateInfo();
+
+          console.log('📱 [useAppStoreUpdate] AppUpdate result:', result);
+
+          // 使用 AppUpdateAvailability 枚舉來判斷
+          hasUpdate = result.updateAvailability === AppUpdateAvailability.UPDATE_AVAILABLE;
+
+          // Android 的 latestVersion 設為空字串（因為 API 無法取得版本號）
+          latestVersion = '';
+
+          // if (result.availableVersionName) {
+          //   latestVersion = result.availableVersionName;
+          // } else if (result.availableVersionCode) {
+          //   latestVersion = result.availableVersionCode.toString();
+          // } else {
+          //   latestVersion = currentVersion;
+          // }
+
+          const packageName = 'ai.botrun.botrunapp';
+          storeUrl = `https://play.google.com/store/apps/details?id=${packageName}`;
+
+          console.log('✅ [useAppStoreUpdate] Android check result:', {
+            hasUpdate,
+            latestVersion,
+            updateAvailability: result.updateAvailability,
+          });
+
+        } catch (error: any) {
+          console.error('❌ [useAppStoreUpdate] AppUpdate failed for Android:', error.message);
+          const packageName = 'ai.botrun.botrunapp';
+          storeUrl = `https://play.google.com/store/apps/details?id=${packageName}`;
+        }
+      }
+
+      console.log('📱 [useAppStoreUpdate] Final update check result:', {
+        currentVersion,
+        latestVersion,
+        hasUpdate,
+        storeUrl,
+      });
+
+      setUpdateInfo(prev => ({
+        updateAvailable: hasUpdate,
+        currentVersion,
+        latestVersion,
+        isChecking: false,
+        storeUrl,
+        // 🔴 紅點顯示策略：只在「重新開啟 App」時才顯示，App Resume 時不重新顯示
+        // 因為 React state 在 component mount 時會重置為初始值 (false)
+        // - App 重新開啟 → Component mount → hasSeenUpdateNotification = false → 顯示紅點
+        // - App resume → Component 不重新 mount → hasSeenUpdateNotification 保持之前的值 → 已讀過就不顯示
+        hasSeenUpdateNotification: prev.hasSeenUpdateNotification,
+
+        // ⚠️ 舊寫法（已停用）：每次 App Resume 偵測到有更新時，都會重新顯示紅點
+        // hasSeenUpdateNotification: hasUpdate ? false : prev.hasSeenUpdateNotification,
+      }));
+
+    } catch (error) {
+      console.error('❌ [useAppStoreUpdate] Failed to check for updates:', error);
+      setUpdateInfo(prev => ({ ...prev, isChecking: false }));
+    }
+  };
+
+  // 🎯 標記使用者已看過更新通知（開啟選單時呼叫）
+  const markUpdateAsSeen = () => {
+    console.log('👁️ [useAppStoreUpdate] User has seen the update notification');
+    setUpdateInfo(prev => ({ ...prev, hasSeenUpdateNotification: true }));
+  };
+
+  // 🎯 App Resume 時檢查更新
+  useEffect(() => {
+    if (!isCapacitor) return;
+
+    // 立即檢查一次
+    checkForUpdate();
+
+    // 監聽 app resume 事件
+    let listener: PluginListenerHandle | null = null;
+
+    App.addListener('appStateChange', (state) => {
+      if (state.isActive) {
+        console.log('🔄 [useAppStoreUpdate] App resumed, checking for updates...');
+        checkForUpdate();
+      }
+    }).then(handle => {
+      listener = handle;
+    });
+
+    return () => {
+      if (listener) {
+        listener.remove();
+      }
+    };
+  }, [isCapacitor, isIOS, isAndroid]);
+
+  return {
+    ...updateInfo,
+    markUpdateAsSeen,
+  };
+}
+
+/**
+ * iOS: 使用 iTunes Lookup API 檢查更新
+ */
+async function checkIOSUpdateViaAPI(currentVersion: string): Promise<{ hasUpdate: boolean; latestVersion: string; storeUrl: string }> {
+  const bundleId = 'ai.botrun.botrunapp';
+  const appleId = '6755088108';
+
+  try {
+    // 🔄 加上 timestamp 避免快取問題（精確到分鐘）
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = String(now.getMonth() + 1).padStart(2, '0');
+    const day = String(now.getDate()).padStart(2, '0');
+    const hours = String(now.getHours()).padStart(2, '0');
+    const minutes = String(now.getMinutes()).padStart(2, '0');
+    const timestamp = `${year}-${month}${day}-${hours}${minutes}`;
+
+    const apiUrl = `https://itunes.apple.com/lookup?bundleId=${bundleId}&country=tw&v=${timestamp}`;
+
+    console.log('🍎 [useAppStoreUpdate] Fetching from iTunes API:', apiUrl);
+
+    const response = await fetch(apiUrl);
+    const data = await response.json();
+
+    if (data.resultCount === 0) {
+      console.warn('⚠️ [useAppStoreUpdate] App not found in App Store');
+      return {
+        hasUpdate: false,
+        latestVersion: currentVersion,
+        storeUrl: `https://apps.apple.com/tw/app/id${appleId}`,
+      };
+    }
+
+    const appData = data.results[0];
+    const latestVersion = appData.version;
+    const storeUrl = appData.trackViewUrl || `https://apps.apple.com/tw/app/id${appleId}`;
+
+    // 比較版本號：只要版本不一樣就顯示可以更新
+    const hasUpdate = latestVersion !== currentVersion;
+
+    console.log('🍎 [useAppStoreUpdate] iTunes API result:', {
+      currentVersion,
+      latestVersion,
+      hasUpdate,
+      versionMatch: latestVersion === currentVersion,
+    });
+
+    return { hasUpdate, latestVersion, storeUrl };
+
+  } catch (error) {
+    console.error('❌ [useAppStoreUpdate] iTunes API failed:', error);
+    return {
+      hasUpdate: false,
+      latestVersion: currentVersion,
+      storeUrl: `https://apps.apple.com/tw/app/id${appleId}`,
+    };
+  }
+}
+
+/**
+ * ⚠️ 已停用：版本比較邏輯已改為直接字串比較 (latestVersion !== currentVersion)
+ *
+ * 比較版本號（保留供未來參考）
+ * @returns 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+ *
+ * 舊邏輯範例：
+ * - compareVersions("1.2.0", "1.1.1") > 0  // true (線上 1.2.0 > App 1.1.1，需要更新)
+ * - compareVersions("1.2.0", "1.2.1") > 0  // false (線上 1.2.0 < App 1.2.1，不需要更新)
+ *
+ * 新邏輯：
+ * - latestVersion !== currentVersion  // 只要不一樣就顯示可以更新
+ */
+function compareVersions(v1: string, v2: string): number {
+  const parts1 = v1.split('.').map(Number);
+  const parts2 = v2.split('.').map(Number);
+
+  const maxLength = Math.max(parts1.length, parts2.length);
+
+  for (let i = 0; i < maxLength; i++) {
+    const num1 = parts1[i] || 0;
+    const num2 = parts2[i] || 0;
+
+    if (num1 > num2) return 1;
+    if (num1 < num2) return -1;
+  }
+
+  return 0;
+}
+
+/**
+ * 開啟 App Store 或 Play Store
+ * - iOS: 直接使用 window.location.href 開啟 itms-apps:// URL（最簡單可靠）
+ * - Android: 使用 AppUpdate 套件
+ */
+export async function openAppStore() {
+  try {
+    const capacitor = (window as any).Capacitor;
+    if (!capacitor || !capacitor.isNativePlatform?.()) {
+      console.warn('⚠️ [useAppStoreUpdate] Not in native environment');
+      return;
+    }
+
+    const platform = capacitor.getPlatform?.();
+
+    if (platform === 'ios') {
+      // 🍎 iOS: 最簡單直接的方式 - 直接用 window.location.href
+      const appleId = '6755088108';
+      const url = `itms-apps://itunes.apple.com/app/id${appleId}`;
+
+      console.log('🍎 [useAppStoreUpdate] Opening App Store with URL:', url);
+      console.log('🍎 [useAppStoreUpdate] Method: window.location.href');
+
+      // 最直接的方式：直接跳轉
+      window.location.href = url;
+
+    } else if (platform === 'android') {
+      // 🤖 Android: 使用 AppUpdate 套件
+      try {
+        console.log('🤖 [useAppStoreUpdate] Opening Play Store via AppUpdate...');
+        await AppUpdate.openAppStore();
+      } catch (error: any) {
+        console.warn('⚠️ [useAppStoreUpdate] AppUpdate.openAppStore() failed, using fallback...', error.message);
+        // Fallback: 直接用 window.location.href
+        const packageName = 'ai.botrun.botrunapp';
+        const url = `market://details?id=${packageName}`;
+        console.log('🤖 [useAppStoreUpdate] Opening Play Store with URL:', url);
+        window.location.href = url;
+      }
+    }
+
+  } catch (error) {
+    console.error('❌ [useAppStoreUpdate] Failed to open app store:', error);
+  }
+}

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

@@ -0,0 +1,113 @@
+"use client";
+
+import { useState, useEffect } from "react";
+import { App } from "@capacitor/app";
+
+export interface AppVersionInfo {
+  version: string;      // versionName (例如 "1.1.0-internal-testing-3")
+  build: string;        // versionCode (例如 "9")
+  isLoading: boolean;
+  source: 'native' | 'web' | 'fallback';
+}
+
+/**
+ * Hook to get app version from native (Capacitor) or web
+ *
+ * @returns {AppVersionInfo} Version information
+ *
+ * @example
+ * const { version, build, source } = useAppVersion();
+ *
+ * // Display version
+ * <p>v.{version} ({build})</p>
+ * // Web: v.5.1112.0744 (web)
+ * // Android: v.1.1.0-internal-testing-3 (9)
+ */
+export function useAppVersion(): AppVersionInfo {
+  const [versionInfo, setVersionInfo] = useState<AppVersionInfo>({
+    version: process.env.NEXT_PUBLIC_APP_VERSION || '1.0.0',
+    build: '',
+    isLoading: true,
+    source: 'fallback'
+  });
+
+  useEffect(() => {
+    const getVersion = async () => {
+      try {
+        // 🎯 加強平台判斷 - 使用 isNativePlatform() 確保是真正的 Native App
+        const capacitor = (window as any).Capacitor;
+
+        if (typeof window !== 'undefined' && capacitor) {
+          // 🔍 優先使用 isNativePlatform() 判斷
+          const isNative = capacitor.isNativePlatform?.() || false;
+          const platform = capacitor.getPlatform?.();
+
+          console.log('🔍 [useAppVersion] Platform detection:', {
+            isNative,
+            platform,
+            hasCapacitor: !!capacitor,
+          });
+
+          if (isNative && (platform === 'android' || platform === 'ios')) {
+            // 從原生獲取版本資訊
+            const info = await App.getInfo();
+
+            console.log('📱 [useAppVersion] Native app info:', {
+              version: info.version,
+              build: info.build,
+              platform,
+              fullInfo: info, // 🔍 顯示完整的 info 物件
+            });
+
+            // 🔍 額外驗證：確認資料不是空的
+            if (!info.version || info.version === '' || info.version === 'dev') {
+              console.warn('⚠️ [useAppVersion] Version is empty or "dev", falling back to env variable');
+              console.warn('⚠️ [useAppVersion] This might indicate Info.plist is not properly configured');
+
+              // 使用環境變數作為 fallback
+              setVersionInfo({
+                version: process.env.NEXT_PUBLIC_APP_VERSION || '1.0.0',
+                build: info.build || '',
+                isLoading: false,
+                source: 'fallback'
+              });
+              return;
+            }
+
+            setVersionInfo({
+              version: info.version,      // iOS: CFBundleShortVersionString, Android: versionName
+              build: info.build,          // iOS: CFBundleVersion, Android: versionCode
+              isLoading: false,
+              source: 'native'
+            });
+            return;
+          }
+        }
+
+        // Web 環境：使用 NEXT_PUBLIC_APP_VERSION
+        console.log('🌐 [useAppVersion] Web environment, using NEXT_PUBLIC_APP_VERSION');
+        setVersionInfo({
+          version: process.env.NEXT_PUBLIC_APP_VERSION || '1.0.0',
+          build: '',
+          isLoading: false,
+          source: 'web'
+        });
+
+      } catch (error) {
+        console.error('❌ [useAppVersion] Failed to get version:', error);
+
+        // Fallback
+        setVersionInfo({
+          version: process.env.NEXT_PUBLIC_APP_VERSION || '1.0.0',
+          build: '',
+          isLoading: false,
+          source: 'fallback'
+        });
+      }
+    };
+
+    getVersion();
+  }, []);
+
+  return versionInfo;
+}