添加聊天

TUIKit/components/TUIContact/utils/index.ts

@@ -0,0 +1,359 @@
+import TUIChatEngine, {
+  TUIFriendService,
+  TUIConversationService,
+  TUIGroupService,
+  TUIUserService,
+  TUITranslateService,
+  AddFriendParams,
+  JoinGroupParams,
+} from '@tencentcloud/chat-uikit-engine-lite';
+import { TUIGlobal } from '@tencentcloud/universal-api';
+import { Toast, TOAST_TYPE } from '../../common/Toast/index';
+
+export const generateAvatar = (item: any): string => {
+  return (
+    item?.avatar
+    || item?.profile?.avatar
+    || (item?.groupID && 'https://web.sdk.qcloud.com/im/assets/images/Public.svg')
+    || 'https://web.sdk.qcloud.com/component/TUIKit/assets/avatar_21.png'
+  );
+};
+
+export const generateName = (item: any): string => {
+  return (
+    item?.remark
+    || item?.name
+    || item?.profile?.nick
+    || item?.nick
+    || item?.groupID
+    || item?.userID
+    || ''
+  );
+};
+
+export const generateContactInfoName = (item: any): string => {
+  return (
+    item?.name
+    || item?.profile?.nick
+    || item?.nick
+    || item?.groupID
+    || item?.userID
+    || ''
+  );
+};
+
+// Parse the basic information display content of the contactInfo module
+// Group information display: group ID group type
+// User information display: user ID personal signature
+export const generateContactInfoBasic = (
+  contactInfo: any,
+): any[] => {
+  const res = [
+    {
+      label: contactInfo?.groupID ? '群ID' : 'ID',
+      data: contactInfo?.groupID || contactInfo?.userID || '',
+    },
+  ];
+  if (!isApplicationType(contactInfo)) {
+    res.push({
+      label: contactInfo?.groupID ? '群类型' : '个性签名',
+      data: contactInfo?.type || contactInfo?.profile?.selfSignature || '',
+    });
+  }
+  return res;
+};
+
+export const isApplicationType = (info: any) => {
+  return (
+    info?.type === TUIChatEngine?.TYPES?.SNS_APPLICATION_SENT_TO_ME
+    || info?.type === TUIChatEngine?.TYPES?.SNS_APPLICATION_SENT_BY_ME
+  );
+};
+
+export const isFriend = (info: any): Promise<boolean> => {
+  return new Promise((resolve, reject) => {
+    if (info?.groupID || !info?.userID) {
+      resolve(false);
+      return;
+    }
+    if (info?.addTime) {
+      resolve(true);
+      return;
+    }
+    TUIFriendService.checkFriend({
+      userIDList: [info?.userID],
+      type: TUIChatEngine.TYPES.SNS_CHECK_TYPE_BOTH,
+    })
+      .then((res: any) => {
+        switch (res?.data?.successUserIDList[0]?.relation) {
+          // No friend relationship: A does not have B in his friend list, and B does not have A in his friend list
+          case TUIChatEngine.TYPES.SNS_TYPE_NO_RELATION:
+            resolve(false);
+            break;
+          // Single-item friend: A has B in his friend list, but B does not have A in his friend list
+          case TUIChatEngine.TYPES.SNS_TYPE_A_WITH_B:
+            resolve(false);
+            break;
+          // Single-item friend: A does not have B in his friend list, but B has A in his friend list
+          case TUIChatEngine.TYPES.SNS_TYPE_B_WITH_A:
+            resolve(false);
+            break;
+          // Two-way friendship
+          case TUIChatEngine.TYPES.SNS_TYPE_BOTH_WAY:
+            resolve(true);
+            break;
+          default:
+            resolve(false);
+            break;
+        }
+      })
+      .catch((error: any) => {
+        console.warn('checkFriend error', error);
+        reject(error);
+      });
+  });
+};
+
+// Change friend‘s remark
+export const updateFriendRemark = (userID: string, remark: string) => {
+  // eslint-disable-next-line no-control-regex
+  if (remark?.replace(/[^\u0000-\u00ff]/g, 'aa')?.length > 96) {
+    Toast({
+      message: TUITranslateService.t('TUIContact.修改备注失败: 备注长度不得超过 96 字节'),
+      type: TOAST_TYPE.ERROR,
+    });
+    return;
+  }
+  TUIFriendService.updateFriend({
+    userID,
+    remark,
+  })
+    .then(() => {
+      Toast({
+        message: TUITranslateService.t('TUIContact.修改备注成功'),
+        type: TOAST_TYPE.SUCCESS,
+      });
+    })
+    .catch((error: any) => {
+      console.warn('update friend remark failed:', error);
+      Toast({
+        message: TUITranslateService.t('TUIContact.修改备注失败'),
+        type: TOAST_TYPE.ERROR,
+      });
+    });
+};
+
+// Delete one friend
+export const deleteFriend = (userID: string) => {
+  TUIFriendService.deleteFriend({
+    userIDList: [userID],
+    type: TUIChatEngine.TYPES.SNS_DELETE_TYPE_BOTH,
+  })
+    .then((res: any) => {
+      const { successUserIDList } = res.data;
+      if (successUserIDList[0].userID === userID) {
+        Toast({
+          message: TUITranslateService.t('TUIContact.删除好友成功'),
+          type: TOAST_TYPE.SUCCESS,
+        });
+      } else {
+        Toast({
+          message: TUITranslateService.t('TUIContact.删除好友失败'),
+          type: TOAST_TYPE.ERROR,
+        });
+      }
+    })
+    .catch((error: any) => {
+      console.warn('delete friend failed:', error);
+      Toast({
+        message: TUITranslateService.t('TUIContact.删除好友失败'),
+        type: TOAST_TYPE.ERROR,
+      });
+    });
+};
+
+// Add friend
+export const addFriend = (params: AddFriendParams) => {
+  TUIFriendService.addFriend(params)
+    .then(() => {
+      Toast({
+        message: TUITranslateService.t('TUIContact.申请已发送'),
+        type: TOAST_TYPE.SUCCESS,
+      });
+    })
+    .catch((error: any) => {
+      console.warn('delete friend failed:', error);
+      Toast({
+        message: TUITranslateService.t('TUIContact.申请发送失败'),
+        type: TOAST_TYPE.ERROR,
+      });
+    });
+};
+
+// Enter conversation
+export const enterConversation = (item: any) => {
+  const conversationID = item?.groupID
+    ? `GROUP${item?.groupID}`
+    : `C2C${item?.userID}`;
+  TUIConversationService.switchConversation(conversationID).catch(
+    (error: any) => {
+      console.warn('switch conversation failed:', error);
+      Toast({
+        message: TUITranslateService.t('TUIContact.进入会话失败'),
+        type: TOAST_TYPE.ERROR,
+      });
+    },
+  );
+};
+
+// Accept friend application
+export const acceptFriendApplication = (userID: string) => {
+  TUIFriendService.acceptFriendApplication({
+    userID,
+    type: TUIChatEngine.TYPES.SNS_APPLICATION_AGREE_AND_ADD,
+  })
+    .then(() => {
+      Toast({
+        message: TUITranslateService.t('TUIContact.添加好友成功'),
+        type: TOAST_TYPE.SUCCESS,
+      });
+    })
+    .catch((error: any) => {
+      console.warn('accept friend application failed:', error);
+      Toast({
+        message: TUITranslateService.t('TUIContact.同意好友申请失败'),
+        type: TOAST_TYPE.ERROR,
+      });
+    });
+};
+
+// Refuse friend application
+export const refuseFriendApplication = (userID: string) => {
+  TUIFriendService.refuseFriendApplication(userID)
+    .then(() => {
+      Toast({
+        message: TUITranslateService.t('TUIContact.拒绝成功'),
+        type: TOAST_TYPE.SUCCESS,
+      });
+    })
+    .catch((error: any) => {
+      console.warn('accept friend application failed:', error);
+      Toast({
+        message: TUITranslateService.t('TUIContact.拒绝好友申请失败'),
+        type: TOAST_TYPE.ERROR,
+      });
+    });
+};
+
+// Dismiss group
+export const dismissGroup = (groupID: string) => {
+  TUIGroupService.dismissGroup(groupID)
+    .then(() => {
+      Toast({
+        message: TUITranslateService.t('TUIContact.解散群聊成功'),
+        type: TOAST_TYPE.SUCCESS,
+      });
+      TUIGlobal?.updateContactSearch && TUIGlobal?.updateContactSearch();
+    })
+    .catch((error: any) => {
+      console.warn('dismiss group failed:', error);
+      Toast({
+        message: TUITranslateService.t('TUIContact.解散群聊失败'),
+        type: TOAST_TYPE.ERROR,
+      });
+    });
+};
+
+// Quit group
+export const quitGroup = (groupID: string) => {
+  TUIGroupService.quitGroup(groupID)
+    .then(() => {
+      Toast({
+        message: TUITranslateService.t('TUIContact.退出群组成功'),
+        type: TOAST_TYPE.SUCCESS,
+      });
+    })
+    .catch((error: any) => {
+      console.warn('quit group failed:', error);
+      Toast({
+        message: TUITranslateService.t('TUIContact.退出群组失败'),
+        type: TOAST_TYPE.ERROR,
+      });
+    });
+};
+
+// Join group
+export const joinGroup = (groupID: string, applyMessage?: string) => {
+  TUIGroupService.joinGroup({
+    groupID,
+    applyMessage,
+  } as JoinGroupParams)
+    .then((imResponse: { data: { status?: string } }) => {
+      switch (imResponse?.data?.status) {
+        case TUIChatEngine.TYPES.JOIN_STATUS_WAIT_APPROVAL: // Wait for administrator approval
+          Toast({
+            message: TUITranslateService.t('TUIContact.等待管理员同意'),
+            type: TOAST_TYPE.SUCCESS,
+          });
+          break;
+        case TUIChatEngine.TYPES.JOIN_STATUS_SUCCESS: // Join group successfully
+          Toast({
+            message: TUITranslateService.t('TUIContact.加群成功'),
+            type: TOAST_TYPE.SUCCESS,
+          });
+          break;
+        case TUIChatEngine.TYPES.JOIN_STATUS_ALREADY_IN_GROUP: // Already in the group
+          Toast({
+            message: TUITranslateService.t('TUIContact.您已是群成员'),
+            type: TOAST_TYPE.SUCCESS,
+          });
+          break;
+        default:
+          break;
+      }
+    })
+    .catch((error: any) => {
+      console.warn('join group failed:', error);
+      Toast({
+        message: '申请入群失败',
+        type: TOAST_TYPE.ERROR,
+      });
+    });
+};
+
+// Add to blacklist
+export const addToBlacklist = (userID: string, successCallBack?: () => void) => {
+  TUIUserService.addToBlacklist({
+    userIDList: [userID],
+  })
+    .then(() => {
+      successCallBack && successCallBack();
+    })
+    .catch((error: any) => {
+      console.warn('add to blacklist failed:', error);
+      Toast({
+        message: TUITranslateService.t('TUIContact.加入黑名单失败'),
+        type: TOAST_TYPE.ERROR,
+      });
+    });
+};
+
+// Remove from Blacklist
+export const removeFromBlacklist = (
+  userID: string,
+  successCallBack?: () => void,
+) => {
+  TUIUserService.removeFromBlacklist({
+    userIDList: [userID],
+  })
+    .then(() => {
+      successCallBack && successCallBack();
+    })
+    .catch((error: any) => {
+      console.warn('remove from blacklist failed:', error);
+      Toast({
+        message: TUITranslateService.t('TUIContact.移除黑名单失败'),
+        type: TOAST_TYPE.ERROR,
+      });
+    });
+};

TUIKit/components/TUIContact/utils/sortByFirstChar.ts

@@ -0,0 +1,153 @@
+import { getChinesePinyinFirstLetter } from './getChinesePinyinFirstLetter';
+
+/**
+ * 通用关系链排序工具类
+ * 实现微信风格的排序规则：字母 > 汉字按拼音首字母 > 数字 > 特殊字符
+ * 数字和特殊字符归到 # 组中
+ * 支持多种数据类型的排序
+ */
+
+// 获取字符串的首字母或首字符，用于排序
+function getFirstChar(str: string): string {
+  if (!str) return '';
+
+  const firstChar = str.charAt(0);
+
+  // 数字
+  if (/\d/.test(firstChar)) {
+    return '0'; // 数字统一用 '0' 表示
+  }
+
+  // 英文字母
+  if (/[a-zA-Z]/.test(firstChar)) {
+    return firstChar.toUpperCase();
+  }
+
+  // 中文字符
+  if (/[\u4e00-\u9fa5]/.test(firstChar)) {
+    return getChinesePinyinFirstLetter(firstChar);
+  }
+
+  // 其他特殊字符
+  return 'ZZ'; // 特殊字符标识
+}
+
+// 排序优先级：字母 > 汉字按拼音首字母 > 数字 > 特殊字符
+function getSortPriority(char: string): number {
+  if (/[A-Z]/.test(char)) return 1; // 字母（包括汉字的拼音首字母）
+  if (char === '0') return 2; // 数字
+  return 3; // 其他特殊字符
+}
+
+// 获取分组键，用于显示
+function getGroupKey(firstChar: string): string {
+  if (/[A-Z]/.test(firstChar)) return firstChar; // 字母组（包括汉字按拼音首字母分组）
+  return '#'; // 数字和特殊字符都归到 # 组
+}
+
+// 判断字符串是否以英文字母开头
+function startsWithEnglishLetter(str: string): boolean {
+  return /^[a-zA-Z]/.test(str);
+}
+
+// 排序
+function sortItems<T extends Record<string, any>>(
+  itemList: T[],
+  getDisplayName: (item: T) => string,
+): T[] {
+  return [...itemList].sort((a, b) => {
+    const nameA = getDisplayName(a);
+    const nameB = getDisplayName(b);
+
+    const firstCharA = getFirstChar(nameA);
+    const firstCharB = getFirstChar(nameB);
+
+    const priorityA = getSortPriority(firstCharA);
+    const priorityB = getSortPriority(firstCharB);
+
+    if (priorityA !== priorityB) {
+      return priorityA - priorityB;
+    }
+
+    // 同优先级内按字符排序
+    if (firstCharA !== firstCharB) {
+      return firstCharA.localeCompare(firstCharB);
+    }
+
+    // 首字符相同时，在同一个字母分组内，先英文字母后汉字
+    const isEnglishA = startsWithEnglishLetter(nameA);
+    const isEnglishB = startsWithEnglishLetter(nameB);
+
+    if (isEnglishA !== isEnglishB) {
+      return isEnglishA ? -1 : 1; // 英文字母排在前面
+    }
+
+    // 同类型（都是英文或都是汉字）时，按完整名称排序
+    return nameA.localeCompare(nameB);
+  });
+}
+
+// 分组排序
+function groupItems<T extends Record<string, any>>(
+  sortedList: T[],
+  getDisplayName: (item: T) => string,
+): { [key: string]: T[] } {
+  const groupedList: { [key: string]: T[] } = {};
+
+  sortedList.forEach((item) => {
+    const name = getDisplayName(item);
+    const firstChar = getFirstChar(name);
+    const groupKey = getGroupKey(firstChar);
+
+    if (!groupedList[groupKey]) {
+      groupedList[groupKey] = [];
+    }
+    groupedList[groupKey].push(item);
+  });
+
+  // 对每个分组内部再次排序，确保英文字母在前，汉字在后
+  Object.keys(groupedList).forEach((groupKey) => {
+    groupedList[groupKey].sort((a, b) => {
+      const nameA = getDisplayName(a);
+      const nameB = getDisplayName(b);
+
+      const isEnglishA = startsWithEnglishLetter(nameA);
+      const isEnglishB = startsWithEnglishLetter(nameB);
+
+      if (isEnglishA !== isEnglishB) {
+        return isEnglishA ? -1 : 1;
+      }
+
+      // 同类型时按名称排序
+      return nameA.localeCompare(nameB);
+    });
+  });
+
+  return groupedList;
+}
+
+/**
+ * 首字母排序
+ * @param list 要排序的数据列表
+ * @param getDisplayName 获取显示名称的函数
+ * @param enableGroup 是否启用分组
+ * @returns 排序后的结果
+ */
+export function sortByFirstChar<T extends Record<string, any>>(
+  list: T[],
+  getDisplayName: (item: T) => string,
+  enableGroup: boolean = true,
+): {
+    sortedList: T[];
+    groupedList: { [key: string]: T[] };
+  } {
+  const sortedList = sortItems(list, getDisplayName);
+  let groupedList: { [key: string]: T[] } = {};
+  if (enableGroup !== false) {
+    groupedList = groupItems(sortedList, getDisplayName);
+  }
+  return {
+    sortedList,
+    groupedList,
+  };
+}