@taskon/widget-react 0.0.1-beta.5 → 0.0.1-beta.7

package/dist/community-task.d.ts

@@ -1,253 +1,5 @@
-import { ChainType } from '@taskon/core';
-import { CommunityTaskInfo } from '@taskon/core';
 import { default as default_2 } from 'react';
-import { RecurrenceType } from '@taskon/core';
 import { RewardDisplayMode } from '@taskon/core';
-import { SnsType } from '@taskon/core';
-import { TaskReviewResult } from '@taskon/core';
-
-/**
- * BaseTask 组件
- * @description 基础任务卡片，职责：
- * - 卡片布局（flex 容器）
- * - 周期标签显示
- * - 任务标题显示
- * - 有效时间显示
- * - 按钮区域管理
- * - 完成状态样式
- *
- * @example
- * ```tsx
- * <BaseTask
- *   title="Follow @TaskOn_xyz"
- *   isWon={false}
- *   isCompleted={false}
- *   isPeriodic={true}
- *   recurrenceLabel="Daily"
- *   taskId={123}
- *   actionLabel="Follow"
- *   actionLink="https://twitter.com/TaskOn_xyz"
- *   reward={{ type: 'points', amount: 100, name: 'Points', icon: '/icon.png' }}
- *   onClick={() => console.log('卡片被点击')}
- *   onClaim={() => console.log('Claim 按钮被点击')}
- * >
- *   <div>额外的任务描述内容</div>
- * </BaseTask>
- * ```
- */
-declare function BaseTask(props: BaseTaskProps): default_2.ReactElement;
-export { BaseTask }
-export { BaseTask as CommunityTask }
-
-/**
- * 任务卡片基础 Props（最小知识原则）
- * BaseTask 只需要知道这些信息
- */
-declare interface BaseTaskProps {
-    /** 任务名称/标题（字符串或自定义渲染节点） */
-    title: string | React.ReactNode;
-    /** 是否已中奖/完成 */
-    isWon: boolean;
-    /** 是否已提交（可能未中奖） */
-    isCompleted: boolean;
-    /** 是否是周期任务 */
-    isPeriodic: boolean;
-    /** 操作按钮文案（如 "Follow"、"Join"） */
-    actionLabel?: string;
-    /** 操作按钮链接（默认在新标签页打开） */
-    actionLink?: string;
-    /** 点击操作按钮后是否自动验证 */
-    actionAutoVerify?: boolean;
-    /**
-     * 点击 Action 按钮时自动打开弹窗
-     * 用于 PowTask、InviteFriends 等需要在弹窗中填写内容的任务
-     */
-    actionAutoDialog?: boolean;
-    /** 是否总是显示操作按钮（即使已完成） */
-    alwaysShowAction?: boolean;
-    /**
-     * 标题跳转链接
-     * 如果提供，标题将变成可点击的链接，在新标签页打开
-     */
-    targetLink?: string;
-    /** 是否隐藏 Claim 按钮 */
-    noClaim?: boolean;
-    /**
-     * 是否需要验证后才能 Claim
-     * - true: 显示 "Verify & Claim"
-     * - false: 显示 "Claim"
-     */
-    verifyClaim?: boolean;
-    /**
-     * 点击 Claim 仅打开弹窗（不提交）
-     * 用于 QuizTask、SurveyTask 等需要在弹窗中选择答案的任务
-     */
-    claimDialog?: boolean;
-    /**
-     * 社交账号类型（用于 OAuth 绑定）
-     * 决定 Claim 时需要绑定哪种社交账号
-     */
-    snsType?: SnsType;
-    /**
-     * 链类型（用于钱包绑定）
-     * 决定 Claim 时需要绑定哪种链的钱包
-     */
-    chainType?: ChainType;
-    /** 周期标签文本（如 "Daily"、"Weekly"） */
-    recurrenceLabel?: string;
-    /** 任务重复类型（用于 Claim 按钮文案逻辑） */
-    recurrence?: RecurrenceType;
-    /** 是否隐藏周期标签 */
-    noRecurrence?: boolean;
-    /**
-     * Unlimited 任务是否显示大的 Claim 按钮
-     * - true: 显示正常大小的 Claim 按钮
-     * - false: 显示小的 Update 按钮（已有积分）
-     * @default true
-     */
-    showUnlimitedClaim?: boolean;
-    /** 任务 ID */
-    taskId: number;
-    /** 有效时间相关 */
-    validTime?: {
-        /** 开始时间（格式化字符串） */
-        startTime?: string;
-        /** 结束时间（格式化字符串） */
-        endTime?: string;
-        /** 是否已过期 */
-        isExpired?: boolean;
-    };
-    /**
-     * 验证时间范围（OnChain 任务专用）
-     * 显示 "This task only verify action during {start} - {end}(UTC)"
-     */
-    validationTimeFrame?: {
-        /** 开始时间（毫秒或秒时间戳） */
-        start_time: number;
-        /** 结束时间（毫秒或秒时间戳） */
-        end_time: number;
-    };
-    /** 奖励信息 */
-    reward?: {
-        /** 奖励类型 */
-        type: "points" | "token" | "none";
-        /** 积分数量（points 类型，单次奖励） */
-        amount?: number;
-        /** 积分名称（points 类型） */
-        name?: string;
-        /** 积分图标（points 类型） */
-        icon?: string;
-        /** 累计积分（周期任务完成时显示） */
-        totalAmount?: number;
-        /** Token 信息（token 类型） */
-        token?: {
-            /** Token 名称 */
-            name: string;
-            /** 每次奖励数量 */
-            amount: string;
-            /** Token 图标 */
-            icon?: string;
-            /** 链名称 */
-            chain?: string;
-            /** 链图标 */
-            chainIcon?: string;
-            /** 总奖励单位数 */
-            totalUnit?: number;
-            /** 可用单位数 */
-            availableUnit?: number;
-        };
-    };
-    /** 卡片内容（由具体任务组件提供，用于展示任务特定内容） */
-    children?: React.ReactNode;
-    /**
-     * 自定义 Action 按钮区域
-     * 如果提供，将替换默认的 Action 按钮
-     * @example
-     * ```tsx
-     * <BaseTask
-     *   actionSlot={<CustomActionButton onClick={handleAction} />}
-     * />
-     * ```
-     */
-    actionSlot?: React.ReactNode;
-    /**
-     * 自定义奖励展示（已完成状态）
-     * 如果提供，将替换默认的 Won 奖励显示
-     * @example
-     * ```tsx
-     * <BaseTask
-     *   rewardSlot={<CustomRewardDisplay amount={100} />}
-     * />
-     * ```
-     */
-    rewardSlot?: React.ReactNode;
-    /**
-     * 是否已登录
-     * - true: 正常显示卡片
-     * - false/undefined: 显示登录遮层，点击触发 onLogin
-     * @default true
-     */
-    isLoggedIn?: boolean;
-    /** 点击卡片回调（用于打开弹窗） */
-    onClick?: () => void;
-    /**
-     * 点击 Claim 按钮回调
-     * @param token - 可选的 OAuth token（reAuth 成功后传入）
-     * @returns 可选返回 Promise，包含结果信息用于 reAuth 判断和 coolDown 更新
-     */
-    onClaim?: (token?: string) => void | Promise<{
-        successful: boolean;
-        errorCode?: string;
-        cool_down?: number;
-    }>;
-    /**
-     * 点击登录遮层回调
-     * 未登录时（isLoggedIn=false）点击卡片会触发此回调
-     */
-    onLogin?: () => void;
-    /** 是否正在提交 */
-    isSubmitting?: boolean;
-    /** 冷却时间（毫秒） */
-    coolDown?: number;
-    /** 冷却结束回调（用于重置 coolDown 状态） */
-    onCoolDownComplete?: () => void;
-    /**
-     * 周期任务倒计时结束回调
-     * 用于在 next_time 到期后刷新单个任务卡片状态
-     */
-    onDoneCountdownComplete?: (taskId: number) => void | Promise<void>;
-    /** 是否禁用交互 */
-    disabled?: boolean;
-    /**
-     * 审核结果状态
-     * - Passed: 审核通过
-     * - Failed: 审核失败（显示 "Oops! Failed"）
-     * - UnReviewed: 审核中（显示 "Under Review"）
-     */
-    reviewResult?: TaskReviewResult;
-    /**
-     * CheckProgressTip 需要的社区信息
-     * 用于显示 "Contact {name} to check your progress"
-     */
-    communityInfo?: {
-        /** 社区名称 */
-        name?: string;
-        /** 社区联系链接（Discord/Telegram/Twitter） */
-        contactLink?: string;
-    };
-    /**
-     * 周期任务：当前周期是否已完成
-     * 配合 nextTime 用于显示 DoneCountdown
-     */
-    currentCompleted?: boolean;
-    /**
-     * 周期任务：下次可完成的时间戳（毫秒）
-     * 用于显示 DoneCountdown 倒计时
-     */
-    nextTime?: number;
-}
-export { BaseTaskProps }
-export { BaseTaskProps as CommunityTaskProps }
 
 /**
  * CommunityTaskList outer wrapper
@@ -337,146 +89,4 @@ export declare interface CommunityTaskListProps {
     rewardRedirectUrl?: string;
 }
 
-/** 奖励信息（统一格式） */
-declare interface RewardInfo {
-    /** 奖励类型 */
-    type: "points" | "token" | "none";
-    /** 积分数量（仅 points 类型） */
-    amount?: number;
-    /** 积分名称（仅 points 类型） */
-    name?: string;
-    /** 积分图标（仅 points 类型） */
-    icon?: string;
-    /** 积分 ID（仅 points 类型） */
-    pointsId?: number;
-    /** 代币信息（仅 token 类型） */
-    token?: {
-        name: string;
-        amount: string;
-        address: string;
-        chain: string;
-        icon?: string;
-        /** 链图标 URL */
-        chainIcon?: string;
-        /** 总奖励单位数 */
-        totalUnit?: number;
-        /** 可用单位数 */
-        availableUnit?: number;
-    };
-}
-
-/**
- * useSubmitTask Hook
- * @description 处理任务提交逻辑
- * @module widgets/CommunityTask/hooks/useSubmitTask
- */
-/** 任务提交返回值 */
-declare interface SubmitTaskResult {
-    /** 是否成功 */
-    successful: boolean;
-    /** 冷却时间（毫秒） */
-    cool_down?: number;
-    /** 错误信息 */
-    error?: string;
-    /** 错误码（用于判断是否是 UNAUTHORIZED 等特殊错误） */
-    errorCode?: string;
-}
-
-/** 时间信息返回值 */
-declare interface TimeInfo {
-    /** 开始时间（格式化后的字符串） */
-    startTime: string;
-    /** 结束时间（格式化后的字符串） */
-    endTime: string;
-    /** 开始时间戳 */
-    startTimestamp: number | null;
-    /** 结束时间戳 */
-    endTimestamp: number | null;
-    /** 是否即将开始（未到开始时间） */
-    isUpcoming: boolean;
-    /** 是否已过期（超过结束时间） */
-    isExpired: boolean;
-}
-
-/**
- * useSubmitTask Hook
- * @description 提供任务提交功能，处理提交状态和错误
- *
- * @param taskId 任务 ID
- * @param onSuccess 提交成功回调（用于刷新任务状态）
- * @param platform 任务平台类型（用于显示平台相关的错误提示）
- * @param options 配置选项
- * @returns 提交函数和提交状态
- *
- * @example
- * ```tsx
- * const { submitTask, isSubmitting, error } = useSubmitTask(task.id, () => {
- *   console.log('任务提交成功，刷新状态');
- *   onUpdate();
- * }, 'Twitter');
- *
- * // 提交任务
- * const result = await submitTask();
- * if (result.successful) {
- *   // 成功处理
- * }
- * ```
- */
-export declare function useSubmitTask(taskId: number, onSuccess?: () => void, platform?: string, options?: UseSubmitTaskOptions): {
-    /** 提交任务函数 */
-    submitTask: (taskValue?: string) => Promise<SubmitTaskResult>;
-    /** 是否正在提交 */
-    isSubmitting: boolean;
-    /** 错误信息 */
-    error: string | null;
-};
-
-/**
- * useSubmitTask Hook 配置选项
- */
-declare interface UseSubmitTaskOptions {
-    /**
-     * 验证失败时是否也刷新数据
-     * 用于 SwapDex 等任务：用户完成了链上操作（times 增加），但还没达到要求次数
-     * 此时验证返回 false，但需要刷新以显示更新后的 times
-     */
-    refreshOnFail?: boolean;
-}
-
-/**
- * useTaskReward Hook
- * @description 根据任务信息计算奖励信息
- *
- * @param task 任务完整信息（可选，为 undefined 时返回无奖励）
- * @returns 奖励信息对象
- *
- * @example
- * ```tsx
- * const reward = useTaskReward(task);
- * if (reward.type === 'points') {
- *   console.log(reward.amount); // 100
- *   console.log(reward.name); // "TaskOn Points"
- * }
- * ```
- */
-export declare function useTaskReward(task: CommunityTaskInfo | undefined): RewardInfo;
-
-/**
- * useTaskTime Hook
- * @description 根据任务信息计算时间相关状态
- *
- * @param task 任务完整信息
- * @returns 时间信息对象
- *
- * @example
- * ```tsx
- * const timeInfo = useTaskTime(task);
- * if (timeInfo.isExpired) {
- *   console.log('任务已过期');
- * }
- * console.log(timeInfo.endTime); // "03/05/2026 02:18:52 UTC"
- * ```
- */
-export declare function useTaskTime(task: CommunityTaskInfo): TimeInfo;
-
 export { }

package/dist/community-task.js

@@ -1,9 +1,4 @@
-import { B, B as B2, a, c, u, b } from "./chunks/CommunityTaskList-CrMvOB8w.js";
+import { C } from "./chunks/CommunityTaskList-D0uVD8wD.js";
 export {
-  B as BaseTask,
-  B2 as CommunityTask,
-  a as CommunityTaskList,
-  c as useSubmitTask,
-  u as useTaskReward,
-  b as useTaskTime
+  C as CommunityTaskList
 };

package/dist/core.d.ts

@@ -293,9 +293,21 @@ export declare interface TaskOnContextValue {
      */
     client: TaskOnClient | null;
     /**
-     * Whether the provider is initializing
+     * Whether the provider is in full initialization flow.
+     *
+     * Notes:
+     * - Includes session restore and token validation.
+     * - When a stored token exists, this stays true until user info validation completes.
      */
     isInitializing: boolean;
+    /**
+     * Whether session prerequisites are ready for data requests.
+     * True means client is created and auth token has been loaded
+     * (or no token exists, anonymous mode).
+     *
+     * This can become true earlier than `isInitializing === false`.
+     */
+    isSessionReady: boolean;
     /**
      * Resolved locale
      */
@@ -340,7 +352,7 @@ export declare interface TaskOnContextValue {
      */
     chains: ChainInfo[];
     /**
-     * Community info (auto-loaded on init based on apiKey)
+     * Community info (auto-loaded on init based on clientId)
      * Used for displaying community logo and name in reward cards
      */
     communityInfo: CommunityInfo | null;
@@ -353,7 +365,7 @@ export declare interface TaskOnContextValue {
  * - TaskOn client management (based on @taskon/core)
  * - User authentication (login/logout)
  * - Locale configuration
- * - Wallet management (uses window.ethereum adapter)
+ * - Wallet management (host adapter or built-in wallet picker)
  * - Widget locale preloading (optional)
  * - Toast notifications (internal, user-transparent)
  */
@@ -364,10 +376,10 @@ export declare function TaskOnProvider({ config, children, preloadLocales, }: Ta
  */
 export declare interface TaskOnProviderConfig {
     /**
-     * API Key for authentication (X-API-Key header)
-     * Note: apiKey already contains community info, no need to configure communityId/communityKey separately
+     * Client ID for authentication (X-API-Key header)
+     * Note: clientId already contains community info, no need to configure communityId/communityKey separately
      */
-    apiKey: string;
+    clientId: string;
     /**
      * API base URL (optional)
      * @default https://white-label-api.taskon.xyz
@@ -381,8 +393,8 @@ export declare interface TaskOnProviderConfig {
     /**
      * Wallet configuration for blockchain interactions
      *
-     * When not provided, TaskOn will use built-in window.ethereum adapter
-     * for EVM wallet connections (MetaMask, etc.)
+     * When not provided, TaskOn will use SDK built-in wallet picker adapter
+     * for EVM wallet connections.
      */
     walletConfig?: WalletConfig;
     /**
@@ -395,7 +407,7 @@ export declare interface TaskOnProviderConfig {
      * ```tsx
      * <TaskOnProvider
      *   config={{
-     *     apiKey: 'your-api-key',
+     *     clientId: 'your-client-id',
      *     onRequestLogin: () => {
      *       setShowLoginModal(true);
      *     },
@@ -418,10 +430,13 @@ export declare interface TaskOnProviderConfig {
     /**
      * WalletConnect Project ID
      *
-     * Required for WalletConnect functionality.
-     * Get your project ID at https://cloud.walletconnect.com
+     * Only needed when you design Web3 wallet login or wallet-based reward flows.
+     * (e.g. wallet binding, on-chain verification, NFT/token claiming)
      *
-     * If not provided, WalletConnect option will be disabled in the wallet dialog.
+     * Optional. If not provided, SDK built-in default project ID will be used.
+     * For production, it is strongly recommended to set your own project ID.
+     *
+     * Get your project ID at https://cloud.walletconnect.com
      */
     walletConnectProjectId?: string;
 }
@@ -555,7 +570,15 @@ export { UserInfo }
  *
  * @example
  * ```tsx
- * const { login, logout, userId, isLoggedIn, requestLogin } = useTaskOnAuth();
+ * const {
+ *   login,
+ *   logout,
+ *   userId,
+ *   isLoggedIn,
+ *   isInitializing,
+ *   isSessionReady,
+ *   requestLogin,
+ * } = useTaskOnAuth();
  *
  * // EVM wallet login
  * await login({ method: 'evm_wallet', value: '0x...', sign, timestamp });
@@ -574,6 +597,7 @@ export declare function useTaskOnAuth(): {
     userId: number | null;
     isLoggedIn: boolean;
     isInitializing: boolean;
+    isSessionReady: boolean;
     login: (params: LoginParams) => Promise<void>;
     logout: () => void;
     requestLogin: () => void;
@@ -813,15 +837,9 @@ export declare interface WalletAdapter {
 export declare interface WalletConfig {
     /**
      * Custom EVM wallet adapter
-     * If not provided, uses built-in window.ethereum adapter
+     * If not provided, uses SDK built-in wallet picker adapter
      */
     evmAdapter?: WalletAdapter;
-    /**
-     * Disable auto-detection of wallet providers
-     * When true, only uses adapter explicitly provided above
-     * @default false
-     */
-    disableAutoDetect?: boolean;
 }
 
 /**

package/dist/core.js

@@ -1,22 +1,21 @@
-import { T, c, i, u, a, b } from "./chunks/ThemeProvider-Bt4UZ33y.js";
+import { T, d, e, f, i, g, u, a, c, b } from "./chunks/ThemeProvider-CulHkqqY.js";
 import { RewardType } from "@taskon/core";
-import { T as T2, u as u2 } from "./chunks/TaskOnProvider-xUeP2Nro.js";
-import { a as a2, u as u3 } from "./chunks/useToast-CaRkylKe.js";
-import { c as c2, a as a3, i as i2, u as u4 } from "./chunks/createLocaleLoader-BameiEhU.js";
+import { T as T2, u as u2 } from "./chunks/TaskOnProvider-CxtFIs3n.js";
+import { a as a2, u as u3 } from "./chunks/useToast-BGJhd3BX.js";
 export {
   RewardType,
   T2 as TaskOnProvider,
   T as ThemeProvider,
-  c as clearLocaleCache,
-  c2 as createLocaleLoader,
-  a3 as createT,
-  i2 as interpolate,
-  i as isSupportedLocale,
+  d as clearLocaleCache,
+  e as createLocaleLoader,
+  f as createT,
+  i as interpolate,
+  g as isSupportedLocale,
   u2 as useCommonLocale,
   a2 as useEvmWallet,
   u as useTaskOnAuth,
   a as useTaskOnTheme,
-  u4 as useTranslation,
+  c as useTranslation,
   u3 as useWallet,
   b as useWidgetLocale
 };