@quantabit/level-sdk 1.0.0

package/dist/index.esm.js

@@ -0,0 +1,1340 @@
+import React, { useState, useEffect, useCallback, useContext, createContext } from 'react';
+import { BaseApiClient } from '@quantabit/sdk-config';
+
+/**
+ * Level SDK - API 客户端
+ * 等级系统后端接口封装
+ * 
+ * 使用 BaseApiClient 基类简化代码
+ */
+
+
+/**
+ * 等级 API 客户端
+ */
+class LevelApiClient extends BaseApiClient {
+  constructor(config = {}) {
+    super('/level', config);
+  }
+
+  // ============ 等级查询 ============
+
+  /**
+   * 获取我的等级信息
+   */
+  async getMyLevel() {
+    return this.get('/my');
+  }
+
+  /**
+   * 获取等级详情
+   * @param {number} level - 等级
+   */
+  async getLevelInfo(level) {
+    return this.get(`/${level}`);
+  }
+
+  /**
+   * 获取所有等级列表
+   */
+  async getAllLevels() {
+    return this.get('/list');
+  }
+
+  /**
+   * 获取升级进度
+   */
+  async getProgress() {
+    return this.get('/my/progress');
+  }
+
+  // ============ 等级权益 ============
+
+  /**
+   * 获取当前等级权益
+   */
+  async getMyBenefits() {
+    return this.get('/my/benefits');
+  }
+
+  /**
+   * 获取指定等级权益
+   * @param {number} level - 等级
+   */
+  async getLevelBenefits(level) {
+    return this.get(`/${level}/benefits`);
+  }
+
+  /**
+   * 领取等级奖励
+   * @param {number} level - 等级
+   */
+  async claimLevelReward(level) {
+    return this.post(`/${level}/claim`);
+  }
+
+  /**
+   * 获取待领取的等级奖励
+   */
+  async getPendingRewards() {
+    return this.get('/my/rewards/pending');
+  }
+
+  // ============ 经验值 ============
+
+  /**
+   * 获取经验值明细
+   * @param {Object} params - 查询参数
+   */
+  async getExpHistory(params = {}) {
+    return this.get('/my/exp/history', params);
+  }
+
+  /**
+   * 获取经验值来源
+   */
+  async getExpSources() {
+    return this.get('/exp/sources');
+  }
+
+  // ============ 等级排行 ============
+
+  /**
+   * 获取等级排行榜
+   * @param {Object} params - 查询参数
+   */
+  async getLeaderboard(params = {}) {
+    return this.get('/leaderboard', params);
+  }
+
+  /**
+   * 获取我的排名
+   */
+  async getMyRank() {
+    return this.get('/my/rank');
+  }
+
+  // ============ 特权对比 ============
+
+  /**
+   * 对比两个等级权益
+   * @param {number} level1 - 等级1
+   * @param {number} level2 - 等级2
+   */
+  async compareLevels(level1, level2) {
+    return this.get('/compare', {
+      level1,
+      level2
+    });
+  }
+
+  /**
+   * 获取升级建议
+   */
+  async getUpgradeSuggestions() {
+    return this.get('/my/upgrade-tips');
+  }
+}
+
+// 创建默认实例
+const levelApi = new LevelApiClient();
+
+/**
+ * Level SDK - 国际化 i18n
+ * 等级体系多语言支持
+ */
+
+const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];
+const messages = {
+  zh: {
+    // 通用
+    loading: '加载中...',
+    level: '等级',
+    experience: '经验值',
+    currentLevel: '当前等级',
+    nextLevel: '下一等级',
+    maxLevel: '满级',
+    // 等级信息
+    levelUp: '升级啦！',
+    levelUpDesc: '恭喜您升级到 Lv.{level}',
+    expProgress: '经验进度',
+    expNeeded: '还需要 {exp} 经验升级',
+    expToNext: '距离下一级还需',
+    // 权益
+    privileges: '等级权益',
+    unlockAt: '等级 {level} 解锁',
+    unlocked: '已解锁',
+    locked: '未解锁',
+    // 统计
+    totalExp: '累计经验',
+    todayExp: '今日获得',
+    weeklyExp: '本周获得',
+    monthlyExp: '本月获得',
+    // 经验来源
+    expSource: '经验来源',
+    expFromTask: '完成任务',
+    expFromLogin: '每日登录',
+    expFromContent: '发布内容',
+    expFromInteraction: '互动奖励',
+    expFromInvite: '邀请奖励',
+    expFromPurchase: '消费奖励',
+    // 排行榜
+    leaderboard: '等级排行',
+    rank: '排名',
+    myRank: '我的排名',
+    top100: 'TOP 100',
+    // 成就
+    achievements: '成就',
+    achievementUnlocked: '成就解锁',
+    achievementProgress: '成就进度',
+    // 勋章
+    badges: '勋章',
+    badgeEarned: '获得勋章',
+    // 历史
+    expHistory: '经验记录',
+    noHistory: '暂无记录',
+    // 错误
+    errorLoad: '加载失败',
+    errorRetry: '点击重试'
+  },
+  ja: {
+    // 通用
+    loading: '読み込み中...',
+    level: 'レベル',
+    experience: '経験値',
+    currentLevel: '現在のレベル',
+    nextLevel: '次のレベル',
+    maxLevel: '最大レベル',
+    // 等级信息
+    levelUp: 'レベルアップ！',
+    levelUpDesc: 'おめでとうございます！Lv.{level}にレベルアップしました',
+    expProgress: '経験値の進捗',
+    expNeeded: '次のレベルまであと {exp} EXP',
+    expToNext: '次のレベルまで',
+    // 权益
+    privileges: 'レベル特典',
+    unlockAt: 'Lv.{level}でアンロック',
+    unlocked: 'アンロック済み',
+    locked: '未アンロック',
+    // 统计
+    totalExp: '累計経験値',
+    todayExp: '本日獲得',
+    weeklyExp: '今週獲得',
+    monthlyExp: '今月獲得',
+    // 经验来源
+    expSource: '経験値の獲得元',
+    expFromTask: 'タスク完了',
+    expFromLogin: 'デイリーログイン',
+    expFromContent: 'コンテンツ公開',
+    expFromInteraction: 'インタラクションボーナス',
+    expFromInvite: '招待ボーナス',
+    expFromPurchase: '購入ボーナス',
+    // 排行榜
+    leaderboard: 'レベルランキング',
+    rank: '順位',
+    myRank: '私の順位',
+    top100: 'TOP 100',
+    // 成就
+    achievements: '実績',
+    achievementUnlocked: '実績アンロック',
+    achievementProgress: '実績の進捗',
+    // 勋章
+    badges: 'バッジ',
+    badgeEarned: 'バッジ獲得',
+    // 历史
+    expHistory: '経験値履歴',
+    noHistory: '履歴がありません',
+    // 错误
+    errorLoad: '読み込みに失敗しました',
+    errorRetry: 'クリックして再試行'
+  },
+  ko: {
+    // 通用
+    loading: '로딩 중...',
+    level: '레벨',
+    experience: '경험치',
+    currentLevel: '현재 레벨',
+    nextLevel: '다음 레벨',
+    maxLevel: '만렙',
+    // 等级信息
+    levelUp: '레벨 업!',
+    levelUpDesc: '축하합니다! Lv.{level}(으)로 레벨 업하셨습니다',
+    expProgress: '경험치 진행률',
+    expNeeded: '레벨업까지 {exp} 경험치 필요',
+    expToNext: '다음 레벨까지',
+    // 权益
+    privileges: '레벨 혜택',
+    unlockAt: '레벨 {level}에서 잠금 해제',
+    unlocked: '잠금 해제됨',
+    locked: '잠김',
+    // 统计
+    totalExp: '누적 경험치',
+    todayExp: '오늘 획득',
+    weeklyExp: '이번 주 획득',
+    monthlyExp: '이번 달 획득',
+    // 经验来源
+    expSource: '경험치 획득처',
+    expFromTask: '미션 완료',
+    expFromLogin: '출석 체크',
+    expFromContent: '콘텐츠 등록',
+    expFromInteraction: '상호작용 보너스',
+    expFromInvite: '초대 보너스',
+    expFromPurchase: '구매 보너스',
+    // 排行榜
+    leaderboard: '레벨 랭킹',
+    rank: '순위',
+    myRank: '내 순위',
+    top100: 'TOP 100',
+    // 成就
+    achievements: '업적',
+    achievementUnlocked: '업적 달성',
+    achievementProgress: '업적 진행률',
+    // 勋章
+    badges: '배지',
+    badgeEarned: '배지 획득',
+    // 历史
+    expHistory: '경험치 내역',
+    noHistory: '내역이 없습니다',
+    // 错误
+    errorLoad: '불러오기 실패',
+    errorRetry: '클릭하여 다시 시도'
+  },
+  en: {
+    // General
+    loading: 'Loading...',
+    level: 'Level',
+    experience: 'Experience',
+    currentLevel: 'Current Level',
+    nextLevel: 'Next Level',
+    maxLevel: 'Max Level',
+    // Level Info
+    levelUp: 'Level Up!',
+    levelUpDesc: 'Congratulations! You reached Lv.{level}',
+    expProgress: 'EXP Progress',
+    expNeeded: '{exp} EXP needed to level up',
+    expToNext: 'To next level',
+    // Privileges
+    privileges: 'Privileges',
+    unlockAt: 'Unlock at Level {level}',
+    unlocked: 'Unlocked',
+    locked: 'Locked',
+    // Statistics
+    totalExp: 'Total EXP',
+    todayExp: 'Today',
+    weeklyExp: 'This Week',
+    monthlyExp: 'This Month',
+    // EXP Sources
+    expSource: 'EXP Sources',
+    expFromTask: 'Task Completion',
+    expFromLogin: 'Daily Login',
+    expFromContent: 'Content Creation',
+    expFromInteraction: 'Interaction Bonus',
+    expFromInvite: 'Referral Bonus',
+    expFromPurchase: 'Purchase Bonus',
+    // Leaderboard
+    leaderboard: 'Level Leaderboard',
+    rank: 'Rank',
+    myRank: 'My Rank',
+    top100: 'TOP 100',
+    // Achievements
+    achievements: 'Achievements',
+    achievementUnlocked: 'Achievement Unlocked',
+    achievementProgress: 'Progress',
+    // Badges
+    badges: 'Badges',
+    badgeEarned: 'Badge Earned',
+    // History
+    expHistory: 'EXP History',
+    noHistory: 'No records yet',
+    // Errors
+    errorLoad: 'Failed to load',
+    errorRetry: 'Click to retry'
+  }
+};
+let currentLanguage = 'zh';
+function setLanguage(lang) {
+  if (SUPPORTED_LANGUAGES.includes(lang)) {
+    currentLanguage = lang;
+    if (typeof window !== 'undefined') {
+      localStorage.setItem('qbit_did_level_language', lang);
+    }
+  }
+}
+function getLanguage() {
+  if (typeof window !== 'undefined') {
+    const saved = localStorage.getItem('qbit_did_level_language');
+    if (saved && SUPPORTED_LANGUAGES.includes(saved)) {
+      currentLanguage = saved;
+    }
+  }
+  return currentLanguage;
+}
+function t(key, params) {
+  const msgs = messages[getLanguage()] || messages.zh;
+  let text = msgs[key] || key;
+  if (params) {
+    Object.keys(params).forEach(k => {
+      text = text.replace(new RegExp(`\\{${k}\\}`, 'g'), params[k]);
+    });
+  }
+  return text;
+}
+
+/**
+ * Level SDK - Context Provider
+ * 等级体系状态管理
+ */
+
+const LevelContext = /*#__PURE__*/createContext(null);
+
+/**
+ * Level Provider 组件
+ */
+function LevelProvider({
+  children,
+  apiUrl,
+  token,
+  language = 'zh',
+  onLevelUp,
+  onError
+}) {
+  const [userLevel, setUserLevel] = useState(null);
+  const [levelConfigs, setLevelConfigs] = useState([]);
+  const [privileges, setPrivileges] = useState([]);
+  const [achievements, setAchievements] = useState([]);
+  const [badges, setBadges] = useState([]);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+
+  // 初始化配置
+  useEffect(() => {
+    if (apiUrl) levelApi.setBaseUrl(apiUrl);
+    if (token) levelApi.setToken(token);
+    if (language) setLanguage(language);
+  }, [apiUrl, token, language]);
+  const handleError = useCallback(err => {
+    setError(err.message);
+    onError?.(err);
+  }, [onError]);
+
+  // ============ 加载数据 ============
+
+  /**
+   * 加载用户等级信息
+   */
+  const loadUserLevel = useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await levelApi.getMyLevel();
+      const prevLevel = userLevel?.level;
+      setUserLevel(result);
+      // 检查是否升级
+      if (prevLevel && result.level > prevLevel) {
+        onLevelUp?.(result);
+      }
+      return result;
+    } catch (err) {
+      handleError(err);
+      throw err;
+    } finally {
+      setLoading(false);
+    }
+  }, [userLevel, onLevelUp, handleError]);
+
+  /**
+   * 加载等级配置
+   */
+  const loadLevelConfigs = useCallback(async () => {
+    try {
+      const result = await levelApi.getLevelConfigs();
+      const configs = result.items || result.data || result || [];
+      setLevelConfigs(configs);
+      return configs;
+    } catch (err) {
+      handleError(err);
+      throw err;
+    }
+  }, [handleError]);
+
+  /**
+   * 加载权益列表
+   */
+  const loadPrivileges = useCallback(async () => {
+    try {
+      const result = await levelApi.getPrivileges();
+      const items = result.items || result.data || result || [];
+      setPrivileges(items);
+      return items;
+    } catch (err) {
+      handleError(err);
+      throw err;
+    }
+  }, [handleError]);
+
+  /**
+   * 加载成就列表
+   */
+  const loadAchievements = useCallback(async () => {
+    try {
+      const result = await levelApi.getAchievements();
+      const items = result.items || result.data || result || [];
+      setAchievements(items);
+      return items;
+    } catch (err) {
+      handleError(err);
+      throw err;
+    }
+  }, [handleError]);
+
+  /**
+   * 加载勋章列表
+   */
+  const loadBadges = useCallback(async () => {
+    try {
+      const result = await levelApi.getBadges();
+      const items = result.items || result.data || result || [];
+      setBadges(items);
+      return items;
+    } catch (err) {
+      handleError(err);
+      throw err;
+    }
+  }, [handleError]);
+
+  /**
+   * 初始化加载所有数据
+   */
+  const initialize = useCallback(async () => {
+    setLoading(true);
+    try {
+      await Promise.all([loadUserLevel(), loadLevelConfigs(), loadPrivileges()]);
+    } catch (err) {
+      // 错误已在各自的 load 函数中处理
+    } finally {
+      setLoading(false);
+    }
+  }, [loadUserLevel, loadLevelConfigs, loadPrivileges]);
+
+  // ============ 辅助方法 ============
+
+  /**
+   * 获取等级配置
+   */
+  const getLevelConfig = useCallback(level => {
+    return levelConfigs.find(c => c.level === level);
+  }, [levelConfigs]);
+
+  /**
+   * 检查权益是否已解锁
+   */
+  const isPrivilegeUnlocked = useCallback(privilegeId => {
+    if (!userLevel) return false;
+    const privilege = privileges.find(p => p.id === privilegeId);
+    return privilege && userLevel.level >= privilege.unlock_level;
+  }, [userLevel, privileges]);
+
+  /**
+   * 获取已解锁的权益
+   */
+  const getUnlockedPrivileges = useCallback(() => {
+    if (!userLevel) return [];
+    return privileges.filter(p => userLevel.level >= p.unlock_level);
+  }, [userLevel, privileges]);
+
+  /**
+   * 获取下一等级的权益
+   */
+  const getNextLevelPrivileges = useCallback(() => {
+    if (!userLevel) return [];
+    return privileges.filter(p => p.unlock_level === userLevel.level + 1);
+  }, [userLevel, privileges]);
+  const value = {
+    // 状态
+    userLevel,
+    levelConfigs,
+    privileges,
+    achievements,
+    badges,
+    loading,
+    error,
+    // 加载方法
+    loadUserLevel,
+    loadLevelConfigs,
+    loadPrivileges,
+    loadAchievements,
+    loadBadges,
+    initialize,
+    // 辅助方法
+    getLevelConfig,
+    isPrivilegeUnlocked,
+    getUnlockedPrivileges,
+    getNextLevelPrivileges,
+    // API 实例
+    api: levelApi
+  };
+  return /*#__PURE__*/React.createElement(LevelContext.Provider, {
+    value: value
+  }, children);
+}
+
+/**
+ * 使用 Level Context
+ */
+function useLevel() {
+  const context = useContext(LevelContext);
+  if (!context) {
+    throw new Error('useLevel must be used within a LevelProvider');
+  }
+  return context;
+}
+
+/**
+ * Level SDK - useExpHistory Hook
+ * 经验历史记录 Hook
+ */
+
+
+/**
+ * 经验历史 Hook
+ */
+function useExpHistory() {
+  const {
+    api
+  } = useLevel();
+  const [history, setHistory] = useState([]);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const [pagination, setPagination] = useState({
+    page: 1,
+    pageSize: 20,
+    total: 0,
+    totalPages: 0
+  });
+
+  /**
+   * 加载经验历史
+   */
+  const load = useCallback(async (params = {}) => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await api.getExpHistory({
+        page: pagination.page,
+        page_size: pagination.pageSize,
+        ...params
+      });
+      const items = result.items || result.data || [];
+      setHistory(items);
+      setPagination(prev => ({
+        ...prev,
+        total: result.total || items.length,
+        totalPages: result.total_pages || Math.ceil((result.total || items.length) / prev.pageSize)
+      }));
+      return result;
+    } catch (err) {
+      setError(err.message);
+      throw err;
+    } finally {
+      setLoading(false);
+    }
+  }, [api, pagination.page, pagination.pageSize]);
+
+  /**
+   * 按来源筛选
+   */
+  const filterBySource = useCallback(async source => {
+    return load({
+      source,
+      page: 1
+    });
+  }, [load]);
+
+  /**
+   * 按日期范围筛选
+   */
+  const filterByDateRange = useCallback(async (startDate, endDate) => {
+    return load({
+      start_date: startDate,
+      end_date: endDate,
+      page: 1
+    });
+  }, [load]);
+
+  /**
+   * 设置页码
+   */
+  const setPage = useCallback(page => {
+    setPagination(prev => ({
+      ...prev,
+      page
+    }));
+  }, []);
+
+  /**
+   * 刷新
+   */
+  const refresh = useCallback(() => {
+    return load();
+  }, [load]);
+  return {
+    history,
+    loading,
+    error,
+    pagination,
+    load,
+    filterBySource,
+    filterByDateRange,
+    setPage,
+    refresh
+  };
+}
+
+/**
+ * Level SDK - useLeaderboard Hook
+ * 等级排行榜 Hook
+ */
+
+
+/**
+ * 排行榜 Hook
+ */
+function useLeaderboard(autoLoad = true) {
+  const {
+    api
+  } = useLevel();
+  const [leaderboard, setLeaderboard] = useState([]);
+  const [myRank, setMyRank] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const [timeRange, setTimeRange] = useState('all'); // all, weekly, monthly
+
+  /**
+   * 加载排行榜
+   */
+  const load = useCallback(async (params = {}) => {
+    setLoading(true);
+    setError(null);
+    try {
+      const [boardResult, rankResult] = await Promise.all([api.getLeaderboard({
+        time_range: timeRange,
+        limit: 100,
+        ...params
+      }), api.getMyRank()]);
+      const items = boardResult.items || boardResult.data || boardResult || [];
+      setLeaderboard(items);
+      setMyRank(rankResult);
+      return {
+        leaderboard: items,
+        myRank: rankResult
+      };
+    } catch (err) {
+      setError(err.message);
+      throw err;
+    } finally {
+      setLoading(false);
+    }
+  }, [api, timeRange]);
+
+  /**
+   * 切换时间范围
+   */
+  const changeTimeRange = useCallback(range => {
+    setTimeRange(range);
+  }, []);
+
+  /**
+   * 刷新
+   */
+  const refresh = useCallback(() => {
+    return load();
+  }, [load]);
+
+  // 自动加载
+  useEffect(() => {
+    if (autoLoad) {
+      load();
+    }
+  }, [autoLoad, timeRange]);
+  return {
+    leaderboard,
+    myRank,
+    loading,
+    error,
+    timeRange,
+    load,
+    changeTimeRange,
+    refresh
+  };
+}
+
+/**
+ * Level SDK - LevelBadge 组件
+ * 等级徽章展示
+ */
+
+
+/**
+ * 等级徽章组件
+ */
+function LevelBadge({
+  level,
+  name,
+  icon,
+  color = '#6366f1',
+  size = 'medium',
+  // small, medium, large
+  showName = true,
+  animate = false,
+  className = ''
+}) {
+  const sizeClasses = {
+    small: 'level-badge-sm',
+    medium: 'level-badge-md',
+    large: 'level-badge-lg'
+  };
+  return /*#__PURE__*/React.createElement("div", {
+    className: `level-badge ${sizeClasses[size]} ${animate ? 'level-badge-animate' : ''} ${className}`,
+    style: {
+      '--level-color': color
+    }
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "level-badge-icon"
+  }, icon ? /*#__PURE__*/React.createElement("img", {
+    src: icon,
+    alt: `Level ${level}`
+  }) : /*#__PURE__*/React.createElement("span", {
+    className: "level-badge-number"
+  }, "Lv.", level)), showName && name && /*#__PURE__*/React.createElement("span", {
+    className: "level-badge-name"
+  }, name));
+}
+
+/**
+ * Level SDK - 类型定义
+ * 等级体系的核心类型
+ */
+
+// 经验来源类型
+const ExpSource = {
+  TASK: 'task',
+  // 完成任务
+  LOGIN: 'login',
+  // 每日登录
+  CONTENT: 'content',
+  // 发布内容
+  INTERACTION: 'interaction',
+  // 互动奖励
+  INVITE: 'invite',
+  // 邀请奖励
+  PURCHASE: 'purchase',
+  // 消费奖励
+  SYSTEM: 'system',
+  // 系统奖励
+  ADMIN: 'admin' // 管理员调整
+};
+
+// 权益类型
+const PrivilegeType = {
+  FEATURE: 'feature',
+  // 功能解锁
+  DISCOUNT: 'discount',
+  // 折扣优惠
+  BONUS: 'bonus',
+  // 额外奖励
+  BADGE: 'badge',
+  // 专属徽章
+  LIMIT_INCREASE: 'limit',
+  // 额度提升
+  PRIORITY: 'priority',
+  // 优先权
+  EXCLUSIVE: 'exclusive' // 专属特权
+};
+
+// 成就类型
+const AchievementType = {
+  LEVEL: 'level',
+  // 等级成就
+  EXP: 'exp',
+  // 经验成就
+  TASK: 'task',
+  // 任务成就
+  SOCIAL: 'social',
+  // 社交成就
+  CONTENT: 'content',
+  // 内容成就
+  TRADING: 'trading',
+  // 交易成就
+  SPECIAL: 'special' // 特殊成就
+};
+
+/**
+ * 创建默认等级配置
+ * @param {Object} overrides - 覆盖字段
+ * @returns {Object}
+ */
+function createDefaultLevelConfig(overrides = {}) {
+  return {
+    id: null,
+    level: 1,
+    name: '',
+    icon: null,
+    color: '#6366f1',
+    min_exp: 0,
+    max_exp: 100,
+    privileges: [],
+    badge_url: null,
+    description: '',
+    ...overrides
+  };
+}
+
+/**
+ * 创建默认用户等级信息
+ * @param {Object} overrides - 覆盖字段
+ * @returns {Object}
+ */
+function createDefaultUserLevel(overrides = {}) {
+  return {
+    user_did: null,
+    level: 1,
+    level_name: '',
+    current_exp: 0,
+    total_exp: 0,
+    exp_to_next: 100,
+    progress: 0,
+    privileges: [],
+    badges: [],
+    created_at: null,
+    updated_at: null,
+    ...overrides
+  };
+}
+
+/**
+ * 创建默认经验记录
+ * @param {Object} overrides - 覆盖字段
+ * @returns {Object}
+ */
+function createDefaultExpRecord(overrides = {}) {
+  return {
+    id: null,
+    user_did: null,
+    amount: 0,
+    source: ExpSource.SYSTEM,
+    source_id: null,
+    description: '',
+    balance_after: 0,
+    created_at: null,
+    ...overrides
+  };
+}
+
+/**
+ * 创建默认权益
+ * @param {Object} overrides - 覆盖字段
+ * @returns {Object}
+ */
+function createDefaultPrivilege(overrides = {}) {
+  return {
+    id: null,
+    name: '',
+    type: PrivilegeType.FEATURE,
+    description: '',
+    icon: null,
+    unlock_level: 1,
+    value: null,
+    is_active: true,
+    ...overrides
+  };
+}
+
+/**
+ * 创建默认成就
+ * @param {Object} overrides - 覆盖字段
+ * @returns {Object}
+ */
+function createDefaultAchievement(overrides = {}) {
+  return {
+    id: null,
+    name: '',
+    type: AchievementType.LEVEL,
+    description: '',
+    icon: null,
+    condition: {},
+    reward_exp: 0,
+    reward_badge: null,
+    is_hidden: false,
+    ...overrides
+  };
+}
+
+/**
+ * 计算升级所需经验
+ * @param {number} level - 目标等级
+ * @param {string} formula - 公式类型 (linear, quadratic, exponential)
+ * @param {Object} params - 公式参数
+ * @returns {number}
+ */
+function calculateExpForLevel(level, formula = 'quadratic', params = {}) {
+  const {
+    base = 100,
+    factor = 1.5
+  } = params;
+  switch (formula) {
+    case 'linear':
+      return base * level;
+    case 'quadratic':
+      return Math.floor(base * Math.pow(level, factor));
+    case 'exponential':
+      return Math.floor(base * Math.pow(factor, level - 1));
+    default:
+      return base * level;
+  }
+}
+
+/**
+ * 计算进度百分比
+ * @param {number} current - 当前经验
+ * @param {number} min - 当前等级最低经验
+ * @param {number} max - 下一等级所需经验
+ * @returns {number} 0-100 的百分比
+ */
+function calculateProgress(current, min, max) {
+  if (max <= min) return 100;
+  const progress = (current - min) / (max - min) * 100;
+  return Math.min(100, Math.max(0, progress));
+}
+
+/**
+ * Level SDK - LevelProgress 组件
+ * 等级进度条
+ */
+
+
+/**
+ * 等级进度组件
+ */
+function LevelProgress({
+  currentLevel,
+  currentExp,
+  expToNext,
+  totalExp,
+  levelName,
+  nextLevelName,
+  color = '#6366f1',
+  showStats = true,
+  showLabels = true,
+  size = 'medium',
+  // small, medium, large
+  animated = true,
+  className = ''
+}) {
+  const progress = calculateProgress(currentExp, 0, expToNext);
+  const sizeClasses = {
+    small: 'level-progress-sm',
+    medium: 'level-progress-md',
+    large: 'level-progress-lg'
+  };
+
+  // 格式化数字
+  const formatNumber = num => {
+    if (num >= 10000) return (num / 10000).toFixed(1) + 'w';
+    if (num >= 1000) return (num / 1000).toFixed(1) + 'k';
+    return num?.toString() || '0';
+  };
+  return /*#__PURE__*/React.createElement("div", {
+    className: `level-progress ${sizeClasses[size]} ${className}`,
+    style: {
+      '--level-color': color
+    }
+  }, showLabels && /*#__PURE__*/React.createElement("div", {
+    className: "level-progress-header"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "level-progress-current"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "level-number"
+  }, "Lv.", currentLevel), levelName && /*#__PURE__*/React.createElement("span", {
+    className: "level-name"
+  }, levelName)), /*#__PURE__*/React.createElement("div", {
+    className: "level-progress-next"
+  }, nextLevelName ? /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("span", {
+    className: "level-name"
+  }, nextLevelName), /*#__PURE__*/React.createElement("span", {
+    className: "level-number"
+  }, "Lv.", currentLevel + 1)) : /*#__PURE__*/React.createElement("span", {
+    className: "level-max"
+  }, t('maxLevel')))), /*#__PURE__*/React.createElement("div", {
+    className: "level-progress-bar"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: `level-progress-fill ${animated ? 'animated' : ''}`,
+    style: {
+      width: `${progress}%`
+    }
+  }), /*#__PURE__*/React.createElement("span", {
+    className: "level-progress-text"
+  }, progress.toFixed(1), "%")), showStats && /*#__PURE__*/React.createElement("div", {
+    className: "level-progress-stats"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "level-stat"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "level-stat-label"
+  }, t('currentLevel')), /*#__PURE__*/React.createElement("span", {
+    className: "level-stat-value"
+  }, formatNumber(currentExp))), /*#__PURE__*/React.createElement("div", {
+    className: "level-stat"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "level-stat-label"
+  }, t('expToNext')), /*#__PURE__*/React.createElement("span", {
+    className: "level-stat-value"
+  }, formatNumber(expToNext - currentExp))), /*#__PURE__*/React.createElement("div", {
+    className: "level-stat"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "level-stat-label"
+  }, t('totalExp')), /*#__PURE__*/React.createElement("span", {
+    className: "level-stat-value"
+  }, formatNumber(totalExp)))));
+}
+
+/**
+ * Level SDK - LevelCard 组件
+ * 等级信息卡片
+ */
+
+
+/**
+ * 等级卡片组件
+ */
+function LevelCard({
+  userLevel,
+  levelConfig,
+  nextLevelConfig,
+  showPrivileges = true,
+  showProgress = true,
+  onViewPrivileges,
+  onViewHistory,
+  className = ''
+}) {
+  if (!userLevel) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: `level-card level-card-empty ${className}`
+    }, /*#__PURE__*/React.createElement("div", {
+      className: "level-card-loading"
+    }, /*#__PURE__*/React.createElement("div", {
+      className: "level-loading-spinner"
+    }), /*#__PURE__*/React.createElement("span", null, t('loading'))));
+  }
+  return /*#__PURE__*/React.createElement("div", {
+    className: `level-card ${className}`
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "level-card-header"
+  }, /*#__PURE__*/React.createElement(LevelBadge, {
+    level: userLevel.level,
+    name: userLevel.level_name || levelConfig?.name,
+    icon: levelConfig?.icon,
+    color: levelConfig?.color,
+    size: "large"
+  }), /*#__PURE__*/React.createElement("div", {
+    className: "level-card-title"
+  }, /*#__PURE__*/React.createElement("h3", null, userLevel.level_name || `${t('level')} ${userLevel.level}`), /*#__PURE__*/React.createElement("p", null, levelConfig?.description))), showProgress && /*#__PURE__*/React.createElement("div", {
+    className: "level-card-progress"
+  }, /*#__PURE__*/React.createElement(LevelProgress, {
+    currentLevel: userLevel.level,
+    currentExp: userLevel.current_exp,
+    expToNext: userLevel.exp_to_next,
+    totalExp: userLevel.total_exp,
+    levelName: userLevel.level_name,
+    nextLevelName: nextLevelConfig?.name,
+    color: levelConfig?.color,
+    size: "large"
+  })), showPrivileges && userLevel.privileges?.length > 0 && /*#__PURE__*/React.createElement("div", {
+    className: "level-card-privileges"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "level-privileges-header"
+  }, /*#__PURE__*/React.createElement("h4", null, t('privileges')), onViewPrivileges && /*#__PURE__*/React.createElement("button", {
+    className: "level-link-btn",
+    onClick: onViewPrivileges
+  }, t('more'), " \u2192")), /*#__PURE__*/React.createElement("div", {
+    className: "level-privileges-list"
+  }, userLevel.privileges.slice(0, 4).map((privilege, index) => /*#__PURE__*/React.createElement("div", {
+    key: privilege.id || index,
+    className: "level-privilege-item"
+  }, privilege.icon && /*#__PURE__*/React.createElement("span", {
+    className: "level-privilege-icon"
+  }, privilege.icon), /*#__PURE__*/React.createElement("span", {
+    className: "level-privilege-name"
+  }, privilege.name))))), /*#__PURE__*/React.createElement("div", {
+    className: "level-card-actions"
+  }, onViewHistory && /*#__PURE__*/React.createElement("button", {
+    className: "level-btn level-btn-outline",
+    onClick: onViewHistory
+  }, t('expHistory')), onViewPrivileges && /*#__PURE__*/React.createElement("button", {
+    className: "level-btn level-btn-primary",
+    onClick: onViewPrivileges
+  }, t('privileges'))));
+}
+
+/**
+ * Level SDK - Leaderboard 组件
+ * 等级排行榜
+ */
+
+
+/**
+ * 排行榜组件
+ */
+function Leaderboard({
+  items = [],
+  myRank = null,
+  timeRange = 'all',
+  onTimeRangeChange,
+  loading = false,
+  showTop = 100,
+  className = ''
+}) {
+  const [activeRange, setActiveRange] = useState(timeRange);
+  const handleRangeChange = range => {
+    setActiveRange(range);
+    onTimeRangeChange?.(range);
+  };
+
+  // 格式化排名
+  const formatRank = rank => {
+    if (rank === 1) return '🥇';
+    if (rank === 2) return '🥈';
+    if (rank === 3) return '🥉';
+    return `#${rank}`;
+  };
+
+  // 格式化数字
+  const formatNumber = num => {
+    if (num >= 10000) return (num / 10000).toFixed(1) + 'w';
+    if (num >= 1000) return (num / 1000).toFixed(1) + 'k';
+    return num?.toString() || '0';
+  };
+  return /*#__PURE__*/React.createElement("div", {
+    className: `level-leaderboard ${className}`
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "level-leaderboard-header"
+  }, /*#__PURE__*/React.createElement("h3", null, t('leaderboard')), /*#__PURE__*/React.createElement("div", {
+    className: "level-time-tabs"
+  }, /*#__PURE__*/React.createElement("button", {
+    className: activeRange === 'all' ? 'active' : '',
+    onClick: () => handleRangeChange('all')
+  }, "\u5168\u90E8"), /*#__PURE__*/React.createElement("button", {
+    className: activeRange === 'monthly' ? 'active' : '',
+    onClick: () => handleRangeChange('monthly')
+  }, "\u672C\u6708"), /*#__PURE__*/React.createElement("button", {
+    className: activeRange === 'weekly' ? 'active' : '',
+    onClick: () => handleRangeChange('weekly')
+  }, "\u672C\u5468"))), myRank && /*#__PURE__*/React.createElement("div", {
+    className: "level-my-rank"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "level-my-rank-label"
+  }, t('myRank')), /*#__PURE__*/React.createElement("span", {
+    className: "level-my-rank-value"
+  }, formatRank(myRank.rank)), /*#__PURE__*/React.createElement("span", {
+    className: "level-my-rank-info"
+  }, "Lv.", myRank.level, " \xB7 ", formatNumber(myRank.total_exp), " EXP")), loading ? /*#__PURE__*/React.createElement("div", {
+    className: "level-leaderboard-loading"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "level-loading-spinner"
+  }), /*#__PURE__*/React.createElement("span", null, t('loading'))) : items.length === 0 ? /*#__PURE__*/React.createElement("div", {
+    className: "level-leaderboard-empty"
+  }, /*#__PURE__*/React.createElement("span", null, "\u6682\u65E0\u6570\u636E")) : /*#__PURE__*/React.createElement("div", {
+    className: "level-leaderboard-list"
+  }, items.slice(0, showTop).map((item, index) => /*#__PURE__*/React.createElement("div", {
+    key: item.user_did || index,
+    className: `level-leaderboard-item ${index < 3 ? 'top-three' : ''}`
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "level-rank"
+  }, formatRank(index + 1)), /*#__PURE__*/React.createElement("div", {
+    className: "level-user-info"
+  }, item.avatar ? /*#__PURE__*/React.createElement("img", {
+    src: item.avatar,
+    alt: "",
+    className: "level-user-avatar"
+  }) : /*#__PURE__*/React.createElement("div", {
+    className: "level-user-avatar-placeholder"
+  }, item.name?.charAt(0) || '?'), /*#__PURE__*/React.createElement("span", {
+    className: "level-user-name"
+  }, item.name || 'Anonymous')), /*#__PURE__*/React.createElement(LevelBadge, {
+    level: item.level,
+    color: item.level_color,
+    size: "small",
+    showName: false
+  }), /*#__PURE__*/React.createElement("span", {
+    className: "level-exp"
+  }, formatNumber(item.total_exp), " EXP")))));
+}
+
+/**
+ * Level SDK - PrivilegeList 组件
+ * 权益列表展示
+ */
+
+
+/**
+ * 权益列表组件
+ */
+function PrivilegeList({
+  privileges = [],
+  userLevel = 0,
+  showLocked = true,
+  showUnlockLevel = true,
+  onPrivilegeClick,
+  className = ''
+}) {
+  // 分离已解锁和未解锁的权益
+  const unlockedPrivileges = privileges.filter(p => userLevel >= p.unlock_level);
+  const lockedPrivileges = privileges.filter(p => userLevel < p.unlock_level);
+  const renderPrivilege = (privilege, isUnlocked) => /*#__PURE__*/React.createElement("div", {
+    key: privilege.id,
+    className: `level-privilege ${isUnlocked ? 'unlocked' : 'locked'}`,
+    onClick: () => onPrivilegeClick?.(privilege)
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "level-privilege-icon-wrapper"
+  }, privilege.icon ? /*#__PURE__*/React.createElement("span", {
+    className: "level-privilege-icon"
+  }, privilege.icon) : /*#__PURE__*/React.createElement("span", {
+    className: "level-privilege-icon-default"
+  }, "\u2728"), !isUnlocked && /*#__PURE__*/React.createElement("span", {
+    className: "level-privilege-lock"
+  }, "\uD83D\uDD12")), /*#__PURE__*/React.createElement("div", {
+    className: "level-privilege-content"
+  }, /*#__PURE__*/React.createElement("h4", {
+    className: "level-privilege-name"
+  }, privilege.name), privilege.description && /*#__PURE__*/React.createElement("p", {
+    className: "level-privilege-desc"
+  }, privilege.description), showUnlockLevel && !isUnlocked && /*#__PURE__*/React.createElement("span", {
+    className: "level-privilege-unlock"
+  }, t('unlockAt', {
+    level: privilege.unlock_level
+  }))), /*#__PURE__*/React.createElement("div", {
+    className: "level-privilege-status"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: `level-status-tag ${isUnlocked ? 'tag-unlocked' : 'tag-locked'}`
+  }, isUnlocked ? t('unlocked') : t('locked'))));
+  return /*#__PURE__*/React.createElement("div", {
+    className: `level-privilege-list ${className}`
+  }, unlockedPrivileges.length > 0 && /*#__PURE__*/React.createElement("div", {
+    className: "level-privilege-section"
+  }, /*#__PURE__*/React.createElement("h3", {
+    className: "level-privilege-section-title"
+  }, t('unlocked'), " (", unlockedPrivileges.length, ")"), /*#__PURE__*/React.createElement("div", {
+    className: "level-privilege-grid"
+  }, unlockedPrivileges.map(p => renderPrivilege(p, true)))), showLocked && lockedPrivileges.length > 0 && /*#__PURE__*/React.createElement("div", {
+    className: "level-privilege-section"
+  }, /*#__PURE__*/React.createElement("h3", {
+    className: "level-privilege-section-title"
+  }, t('locked'), " (", lockedPrivileges.length, ")"), /*#__PURE__*/React.createElement("div", {
+    className: "level-privilege-grid"
+  }, lockedPrivileges.map(p => renderPrivilege(p, false)))), privileges.length === 0 && /*#__PURE__*/React.createElement("div", {
+    className: "level-privilege-empty"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "level-empty-icon"
+  }, "\uD83C\uDF81"), /*#__PURE__*/React.createElement("span", null, "\u6682\u65E0\u6743\u76CA")));
+}
+
+export { AchievementType, ExpSource, Leaderboard, LevelApiClient, LevelBadge, LevelCard, LevelProgress, LevelProvider, PrivilegeList, PrivilegeType, SUPPORTED_LANGUAGES, calculateExpForLevel, calculateProgress, createDefaultAchievement, createDefaultExpRecord, createDefaultLevelConfig, createDefaultPrivilege, createDefaultUserLevel, getLanguage, levelApi, messages, setLanguage, t, useExpHistory, useLeaderboard, useLevel };
+//# sourceMappingURL=index.esm.js.map