@quantabit/group-sdk 1.0.0

package/dist/index.esm.js

@@ -0,0 +1,795 @@
+import React, { useState, useEffect, useCallback, useContext, createContext } from 'react';
+import { BaseApiClient } from '@quantabit/sdk-config';
+
+/**
+ * Group SDK - API 客户端
+ * 群组系统后端接口封装
+ * 
+ * 使用 BaseApiClient 基类简化代码
+ */
+
+
+/**
+ * 群组 API 客户端
+ */
+class GroupApiClient extends BaseApiClient {
+  constructor(config = {}) {
+    super('/group', config);
+  }
+
+  // ============ 群组查询 ============
+
+  /**
+   * 获取我的群组
+   * @param {Object} params - 查询参数
+   */
+  async getMyGroups(params = {}) {
+    return this.get('/my', params);
+  }
+
+  /**
+   * 获取群组详情
+   * @param {string} groupId - 群组 ID
+   */
+  async getGroup(groupId) {
+    return this.get(`/${groupId}`);
+  }
+
+  /**
+   * 搜索群组
+   * @param {string} keyword - 关键词
+   * @param {Object} params - 查询参数
+   */
+  async searchGroups(keyword, params = {}) {
+    return this.get('/search', {
+      keyword,
+      ...params
+    });
+  }
+
+  /**
+   * 获取推荐群组
+   * @param {number} limit - 返回数量
+   */
+  async getRecommendedGroups(limit = 10) {
+    return this.get('/recommended', {
+      limit
+    });
+  }
+
+  // ============ 群组创建/管理 ============
+
+  /**
+   * 创建群组
+   * @param {Object} data - 群组数据
+   */
+  async createGroup(data) {
+    return this.post('/', data);
+  }
+
+  /**
+   * 更新群组信息
+   * @param {string} groupId - 群组 ID
+   * @param {Object} updates - 更新数据
+   */
+  async updateGroup(groupId, updates) {
+    return this.put(`/${groupId}`, updates);
+  }
+
+  /**
+   * 解散群组
+   * @param {string} groupId - 群组 ID
+   */
+  async dissolveGroup(groupId) {
+    return this.delete(`/${groupId}`);
+  }
+
+  /**
+   * 转让群主
+   * @param {string} groupId - 群组 ID
+   * @param {string} newOwnerId - 新群主 ID
+   */
+  async transferOwnership(groupId, newOwnerId) {
+    return this.post(`/${groupId}/transfer`, {
+      new_owner_id: newOwnerId
+    });
+  }
+
+  // ============ 成员管理 ============
+
+  /**
+   * 获取群成员
+   * @param {string} groupId - 群组 ID
+   * @param {Object} params - 查询参数
+   */
+  async getMembers(groupId, params = {}) {
+    return this.get(`/${groupId}/members`, params);
+  }
+
+  /**
+   * 邀请成员
+   * @param {string} groupId - 群组 ID
+   * @param {string[]} userIds - 用户 ID 列表
+   */
+  async inviteMembers(groupId, userIds) {
+    return this.post(`/${groupId}/invite`, {
+      user_ids: userIds
+    });
+  }
+
+  /**
+   * 移除成员
+   * @param {string} groupId - 群组 ID
+   * @param {string} memberId - 成员 ID
+   */
+  async removeMember(groupId, memberId) {
+    return this.delete(`/${groupId}/members/${memberId}`);
+  }
+
+  /**
+   * 设置管理员
+   * @param {string} groupId - 群组 ID
+   * @param {string} memberId - 成员 ID
+   * @param {boolean} isAdmin - 是否设为管理员
+   */
+  async setAdmin(groupId, memberId, isAdmin) {
+    return this.put(`/${groupId}/members/${memberId}/admin`, {
+      is_admin: isAdmin
+    });
+  }
+
+  /**
+   * 禁言成员
+   * @param {string} groupId - 群组 ID
+   * @param {string} memberId - 成员 ID
+   * @param {number} duration - 禁言时长（秒）
+   */
+  async muteMember(groupId, memberId, duration) {
+    return this.post(`/${groupId}/members/${memberId}/mute`, {
+      duration
+    });
+  }
+
+  // ============ 加入/退出 ============
+
+  /**
+   * 申请加入群组
+   * @param {string} groupId - 群组 ID
+   * @param {string} message - 申请消息
+   */
+  async applyToJoin(groupId, message = '') {
+    return this.post(`/${groupId}/apply`, {
+      message
+    });
+  }
+
+  /**
+   * 获取入群申请（管理员）
+   * @param {string} groupId - 群组 ID
+   */
+  async getApplications(groupId) {
+    return this.get(`/${groupId}/applications`);
+  }
+
+  /**
+   * 处理入群申请（管理员）
+   * @param {string} groupId - 群组 ID
+   * @param {string} applicationId - 申请 ID
+   * @param {boolean} approved - 是否批准
+   */
+  async handleApplication(groupId, applicationId, approved) {
+    return this.post(`/${groupId}/applications/${applicationId}`, {
+      approved
+    });
+  }
+
+  /**
+   * 退出群组
+   * @param {string} groupId - 群组 ID
+   */
+  async leaveGroup(groupId) {
+    return this.post(`/${groupId}/leave`);
+  }
+
+  // ============ 群组设置 ============
+
+  /**
+   * 获取群组设置
+   * @param {string} groupId - 群组 ID
+   */
+  async getSettings(groupId) {
+    return this.get(`/${groupId}/settings`);
+  }
+
+  /**
+   * 更新群组设置（管理员）
+   * @param {string} groupId - 群组 ID
+   * @param {Object} settings - 设置数据
+   */
+  async updateSettings(groupId, settings) {
+    return this.put(`/${groupId}/settings`, settings);
+  }
+
+  /**
+   * 获取个人群设置
+   * @param {string} groupId - 群组 ID
+   */
+  async getMySettings(groupId) {
+    return this.get(`/${groupId}/my/settings`);
+  }
+
+  /**
+   * 更新个人群设置
+   * @param {string} groupId - 群组 ID
+   * @param {Object} settings - 设置数据
+   */
+  async updateMySettings(groupId, settings) {
+    return this.put(`/${groupId}/my/settings`, settings);
+  }
+
+  // ============ 群公告 ============
+
+  /**
+   * 获取群公告
+   * @param {string} groupId - 群组 ID
+   */
+  async getAnnouncements(groupId) {
+    return this.get(`/${groupId}/announcements`);
+  }
+
+  /**
+   * 发布群公告（管理员）
+   * @param {string} groupId - 群组 ID
+   * @param {Object} announcement - 公告数据
+   */
+  async postAnnouncement(groupId, announcement) {
+    return this.post(`/${groupId}/announcements`, announcement);
+  }
+}
+
+// 创建默认实例
+const groupApi = new GroupApiClient();
+
+/**
+ * Group SDK - 国际化 i18n
+ */
+
+const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];
+const messages = {
+  zh: {
+    loading: '加载中...',
+    group: '群组',
+    groups: '群组列表',
+    community: '社区',
+    guild: '公会',
+    myGroups: '我的群组',
+    createGroup: '创建群组',
+    joinGroup: '加入群组',
+    leaveGroup: '退出群组',
+    // 群组信息
+    groupName: '群组名称',
+    groupDesc: '群组简介',
+    groupAvatar: '群组头像',
+    groupCover: '群组封面',
+    memberCount: '成员数量',
+    postCount: '帖子数量',
+    // 类型
+    typePublic: '公开群组',
+    typePrivate: '私密群组',
+    typeSecret: '隐藏群组',
+    // 角色
+    roleOwner: '群主',
+    roleAdmin: '管理员',
+    roleModerator: '版主',
+    roleMember: '成员',
+    // 成员管理
+    members: '成员',
+    memberList: '成员列表',
+    inviteMember: '邀请成员',
+    removeMember: '移除成员',
+    setAdmin: '设为管理员',
+    removeAdmin: '取消管理员',
+    transferOwner: '转让群主',
+    // 公告
+    announcement: '公告',
+    announcements: '群公告',
+    postAnnouncement: '发布公告',
+    // 帖子
+    posts: '帖子',
+    createPost: '发帖',
+    pinPost: '置顶',
+    unpinPost: '取消置顶',
+    // 操作
+    edit: '编辑',
+    delete: '删除',
+    disband: '解散群组',
+    report: '举报',
+    settings: '设置',
+    // 状态
+    joined: '已加入',
+    pending: '待审核',
+    rejected: '已拒绝',
+    // 提示
+    noGroups: '暂无群组',
+    joinSuccess: '加入成功',
+    leaveSuccess: '退出成功',
+    createSuccess: '创建成功',
+    confirmLeave: '确定退出该群组？',
+    confirmDisband: '确定解散该群组？此操作不可恢复。',
+    needApproval: '需要管理员审核'
+  },
+  en: {
+    loading: 'Loading...',
+    group: 'Group',
+    groups: 'Groups',
+    community: 'Community',
+    guild: 'Guild',
+    myGroups: 'My Groups',
+    createGroup: 'Create Group',
+    joinGroup: 'Join',
+    leaveGroup: 'Leave',
+    groupName: 'Group Name',
+    groupDesc: 'Description',
+    groupAvatar: 'Avatar',
+    groupCover: 'Cover',
+    memberCount: 'Members',
+    postCount: 'Posts',
+    typePublic: 'Public',
+    typePrivate: 'Private',
+    typeSecret: 'Secret',
+    roleOwner: 'Owner',
+    roleAdmin: 'Admin',
+    roleModerator: 'Moderator',
+    roleMember: 'Member',
+    members: 'Members',
+    memberList: 'Member List',
+    inviteMember: 'Invite',
+    removeMember: 'Remove',
+    setAdmin: 'Set Admin',
+    removeAdmin: 'Remove Admin',
+    transferOwner: 'Transfer Ownership',
+    announcement: 'Announcement',
+    announcements: 'Announcements',
+    postAnnouncement: 'Post Announcement',
+    posts: 'Posts',
+    createPost: 'Create Post',
+    pinPost: 'Pin',
+    unpinPost: 'Unpin',
+    edit: 'Edit',
+    delete: 'Delete',
+    disband: 'Disband',
+    report: 'Report',
+    settings: 'Settings',
+    joined: 'Joined',
+    pending: 'Pending',
+    rejected: 'Rejected',
+    noGroups: 'No groups',
+    joinSuccess: 'Joined successfully',
+    leaveSuccess: 'Left successfully',
+    createSuccess: 'Created successfully',
+    confirmLeave: 'Are you sure to leave this group?',
+    confirmDisband: 'Are you sure to disband? This cannot be undone.',
+    needApproval: 'Requires approval'
+  },
+  ja: {
+    loading: '読み込み中...',
+    group: 'グループ',
+    groups: 'グループ一覧',
+    community: 'コミュニティ',
+    guild: 'ギルド',
+    myGroups: 'マイグループ',
+    createGroup: 'グループを作成',
+    joinGroup: '参加する',
+    leaveGroup: '退出する',
+    groupName: 'グループ名',
+    groupDesc: '概要',
+    groupAvatar: 'アバター',
+    groupCover: 'カバー',
+    memberCount: 'メンバー数',
+    postCount: '投稿数',
+    typePublic: '公開グループ',
+    typePrivate: '非公開グループ',
+    typeSecret: '秘密のグループ',
+    roleOwner: 'オーナー',
+    roleAdmin: '管理者',
+    roleModerator: 'モデレーター',
+    roleMember: 'メンバー',
+    members: 'メンバー',
+    memberList: 'メンバー一覧',
+    inviteMember: '招待する',
+    removeMember: '削除する',
+    setAdmin: '管理者に設定',
+    removeAdmin: '管理者を解除',
+    transferOwner: 'オーナー権限を譲渡',
+    announcement: 'お知らせ',
+    announcements: 'グループのお知らせ',
+    postAnnouncement: 'お知らせを投稿',
+    posts: '投稿',
+    createPost: '投稿を作成',
+    pinPost: 'ピン留め',
+    unpinPost: 'ピン留め解除',
+    edit: '編集',
+    delete: '削除',
+    disband: '解散する',
+    report: '通報',
+    settings: '設定',
+    joined: '参加済み',
+    pending: '承認待ち',
+    rejected: '拒否されました',
+    noGroups: 'グループはありません',
+    joinSuccess: '参加しました',
+    leaveSuccess: '退出しました',
+    createSuccess: '作成に成功しました',
+    confirmLeave: 'このグループから退出してもよろしいですか？',
+    confirmDisband: 'グループを解散してもよろしいですか？この操作は元に戻せません。',
+    needApproval: '管理者の承認が必要です'
+  },
+  ko: {
+    loading: '로딩 중...',
+    group: '그룹',
+    groups: '그룹 목록',
+    community: '커뮤니티',
+    guild: '길드',
+    myGroups: '내 그룹',
+    createGroup: '그룹 만들기',
+    joinGroup: '가입하기',
+    leaveGroup: '탈퇴하기',
+    groupName: '그룹 이름',
+    groupDesc: '그룹 소개',
+    groupAvatar: '아바타',
+    groupCover: '커버',
+    memberCount: '회원 수',
+    postCount: '게시물 수',
+    typePublic: '공개 그룹',
+    typePrivate: '비공개 그룹',
+    typeSecret: '비밀 그룹',
+    roleOwner: '소유자',
+    roleAdmin: '관리자',
+    roleModerator: '모더레이터',
+    roleMember: '멤버',
+    members: '멤버',
+    memberList: '멤버 목록',
+    inviteMember: '초대하기',
+    removeMember: '제거하기',
+    setAdmin: '관리자로 설정',
+    removeAdmin: '관리자 해제',
+    transferOwner: '소유권 양도',
+    announcement: '공지사항',
+    announcements: '그룹 공지사항',
+    postAnnouncement: '공지사항 작성',
+    posts: '게시물',
+    createPost: '게시물 작성',
+    pinPost: '고정하기',
+    unpinPost: '고정 해제',
+    edit: '편집',
+    delete: '삭제',
+    disband: '해산하기',
+    report: '신고',
+    settings: '설정',
+    joined: '가입됨',
+    pending: '승인 대기 중',
+    rejected: '거절됨',
+    noGroups: '그룹이 없습니다',
+    joinSuccess: '가입 성공',
+    leaveSuccess: '탈퇴 성공',
+    createSuccess: '생성 성공',
+    confirmLeave: '이 그룹에서 탈퇴하시겠습니까?',
+    confirmDisband: '이 그룹을 해산하시겠습니까? 이 작업은 취소할 수 없습니다.',
+    needApproval: '관리자 승인이 필요합니다'
+  }
+};
+let currentLanguage = 'zh';
+function setLanguage(lang) {
+  if (SUPPORTED_LANGUAGES.includes(lang)) {
+    currentLanguage = lang;
+    if (typeof window !== 'undefined') {
+      localStorage.setItem('qbit_did_group_language', lang);
+    }
+  }
+}
+function getLanguage() {
+  if (typeof window !== 'undefined') {
+    const saved = localStorage.getItem('qbit_did_group_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;
+}
+
+/**
+ * Group SDK - Context Provider
+ */
+
+const GroupContext = /*#__PURE__*/createContext(null);
+function GroupProvider({
+  children,
+  apiUrl,
+  token,
+  language = 'zh',
+  onJoin,
+  onLeave,
+  onError
+}) {
+  const [groups, setGroups] = useState([]);
+  const [myGroups, setMyGroups] = useState([]);
+  const [currentGroup, setCurrentGroup] = useState(null);
+  const [members, setMembers] = useState([]);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    setLanguage(language);
+  }, [language]);
+  const handleError = useCallback(err => {
+    setError(err);
+    onError?.(err);
+  }, [onError]);
+  const loadGroups = useCallback(async (params = {}) => {
+    try {
+      const result = await groupApi.getGroups(params);
+      const items = result.items || result.data || result || [];
+      setGroups(items);
+      return items;
+    } catch (err) {
+      handleError(err);
+      throw err;
+    }
+  }, [handleError]);
+  const loadMyGroups = useCallback(async () => {
+    try {
+      const result = await groupApi.getMyGroups();
+      const items = result.items || result.data || result || [];
+      setMyGroups(items);
+      return items;
+    } catch (err) {
+      handleError(err);
+      throw err;
+    }
+  }, [handleError]);
+  const loadGroup = useCallback(async groupId => {
+    setLoading(true);
+    try {
+      const result = await groupApi.getGroup(groupId);
+      setCurrentGroup(result);
+      return result;
+    } catch (err) {
+      handleError(err);
+      throw err;
+    } finally {
+      setLoading(false);
+    }
+  }, [handleError]);
+  const loadMembers = useCallback(async (groupId, params = {}) => {
+    try {
+      const result = await groupApi.getMembers(groupId, params);
+      const items = result.items || result.data || result || [];
+      setMembers(items);
+      return items;
+    } catch (err) {
+      handleError(err);
+      throw err;
+    }
+  }, [handleError]);
+
+  // ============ 群组操作 ============
+
+  const createGroup = useCallback(async data => {
+    setLoading(true);
+    try {
+      const result = await groupApi.createGroup(data);
+      await loadMyGroups();
+      return result;
+    } catch (err) {
+      handleError(err);
+      throw err;
+    } finally {
+      setLoading(false);
+    }
+  }, [loadMyGroups, handleError]);
+  const joinGroup = useCallback(async (groupId, message) => {
+    setLoading(true);
+    try {
+      const result = await groupApi.joinGroup(groupId, message);
+      await loadMyGroups();
+      onJoin?.(result);
+      return result;
+    } catch (err) {
+      handleError(err);
+      throw err;
+    } finally {
+      setLoading(false);
+    }
+  }, [loadMyGroups, onJoin, handleError]);
+  const leaveGroup = useCallback(async groupId => {
+    setLoading(true);
+    try {
+      await groupApi.leaveGroup(groupId);
+      await loadMyGroups();
+      onLeave?.(groupId);
+    } catch (err) {
+      handleError(err);
+      throw err;
+    } finally {
+      setLoading(false);
+    }
+  }, [loadMyGroups, onLeave, handleError]);
+  const value = {
+    groups,
+    myGroups,
+    currentGroup,
+    members,
+    loading,
+    error,
+    loadGroups,
+    loadMyGroups,
+    loadGroup,
+    loadMembers,
+    createGroup,
+    joinGroup,
+    leaveGroup,
+    api: groupApi
+  };
+  return /*#__PURE__*/React.createElement(GroupContext.Provider, {
+    value: value
+  }, children);
+}
+function useGroup() {
+  const context = useContext(GroupContext);
+  if (!context) {
+    throw new Error('useGroup must be used within a GroupProvider');
+  }
+  return context;
+}
+
+function GroupCard() {
+  return null;
+}
+
+function MemberList() {
+  return null;
+}
+
+/**
+ * Group SDK - 类型定义
+ */
+
+// 群组类型
+const GroupType = {
+  PUBLIC: 'public',
+  // 公开群组
+  PRIVATE: 'private',
+  // 私密群组（需审核）
+  SECRET: 'secret' // 隐藏群组（仅邀请）
+};
+
+// 成员角色
+const MemberRole = {
+  OWNER: 'owner',
+  // 群主
+  ADMIN: 'admin',
+  // 管理员
+  MODERATOR: 'moderator',
+  // 版主
+  MEMBER: 'member' // 普通成员
+};
+
+// 成员状态
+const MemberStatus = {
+  ACTIVE: 'active',
+  // 正常
+  PENDING: 'pending',
+  // 待审核
+  MUTED: 'muted',
+  // 禁言
+  BANNED: 'banned' // 封禁
+};
+
+/**
+ * 创建默认群组
+ */
+function createDefaultGroup(overrides = {}) {
+  return {
+    id: null,
+    name: '',
+    description: '',
+    avatar_url: null,
+    cover_url: null,
+    type: GroupType.PUBLIC,
+    owner_did: null,
+    member_count: 0,
+    post_count: 0,
+    max_members: null,
+    tags: [],
+    is_verified: false,
+    settings: {},
+    created_at: null,
+    ...overrides
+  };
+}
+
+/**
+ * 创建默认成员
+ */
+function createDefaultMember(overrides = {}) {
+  return {
+    id: null,
+    group_id: null,
+    user_did: null,
+    nickname: null,
+    avatar_url: null,
+    role: MemberRole.MEMBER,
+    status: MemberStatus.ACTIVE,
+    joined_at: null,
+    ...overrides
+  };
+}
+
+/**
+ * 创建默认公告
+ */
+function createDefaultAnnouncement(overrides = {}) {
+  return {
+    id: null,
+    group_id: null,
+    title: '',
+    content: '',
+    author_did: null,
+    is_pinned: false,
+    created_at: null,
+    ...overrides
+  };
+}
+
+/**
+ * 检查是否有管理权限
+ */
+function hasAdminPermission(role) {
+  return [MemberRole.OWNER, MemberRole.ADMIN].includes(role);
+}
+
+/**
+ * 检查是否可以管理成员
+ */
+function canManageMember(operatorRole, targetRole) {
+  const roleLevel = {
+    [MemberRole.OWNER]: 4,
+    [MemberRole.ADMIN]: 3,
+    [MemberRole.MODERATOR]: 2,
+    [MemberRole.MEMBER]: 1
+  };
+  return roleLevel[operatorRole] > roleLevel[targetRole];
+}
+
+/**
+ * 获取角色显示名称
+ */
+function getRoleName(role, language = 'zh') {
+  const names = {
+    zh: {
+      [MemberRole.OWNER]: '群主',
+      [MemberRole.ADMIN]: '管理员',
+      [MemberRole.MODERATOR]: '版主',
+      [MemberRole.MEMBER]: '成员'
+    },
+    en: {
+      [MemberRole.OWNER]: 'Owner',
+      [MemberRole.ADMIN]: 'Admin',
+      [MemberRole.MODERATOR]: 'Mod',
+      [MemberRole.MEMBER]: 'Member'
+    }
+  };
+  return names[language]?.[role] || role;
+}
+
+export { GroupApiClient, GroupCard, GroupProvider, GroupType, MemberList, MemberRole, MemberStatus, SUPPORTED_LANGUAGES, canManageMember, createDefaultAnnouncement, createDefaultGroup, createDefaultMember, getLanguage, getRoleName, groupApi, hasAdminPermission, messages, setLanguage, t, useGroup };
+//# sourceMappingURL=index.esm.js.map