Group Management

let onGroupListUpdated = function(event) {
   console.log(event.data);// Array that stores Group instances
};
chat.on(TencentCloudChat.EVENT.GROUP_LIST_UPDATED, onGroupListUpdated);

chat.searchGroupByID(groupID);

let promise = chat.searchGroupByID('group1');
promise.then(function(imResponse) {
  const group = imResponse.data.group;
}).catch(function(imError) {
  console.warn('searchGroupByID error:', imError);
});

chat.createGroup(options);

// Create a work group
let promise = chat.createGroup({
  type: TencentCloudChat.TYPES.GRP_WORK,
  name: 'WebSDK',
  memberList: [{
    userID: 'user1',
    // Group member custom field.
    // By default, this parameter is not available and needs to be enabled.
    // For details, see Custom Fields.
    memberCustomField: [{key: 'group_member_test', value: 'test'}]
  }, {
    userID: 'user2'
  }] // If `memberList` is specified, `userID` must also be specified.
});
promise.then(function(imResponse) { // Created successfully
  console.log(imResponse.data.group); // Profile of the created group
  // A member list is specified during group creation
  // but a certain user has exceeded the limit on the number of groups a single user can join.
  // If you specify userX, who has joined N groups (maximum number of groups userX can join)
  // as a member of the group during group creation, userX cannot join the group properly.
  // The SDK places the information of userX in overLimitUserIDList for the access side to process.
  // List of users who have exceeded the limit on the number of groups a single user can join.
  console.log(imResponse.data.overLimitUserIDList); 
}).catch(function(imError){
  console.warn('createGroup error:', imError); // Failed to create the group
});

// Create a topic-enabled community
let promise = chat.createGroup({
  type: TencentCloudChat.TYPES.GRP_COMMUNITY,
  name: 'WebSDK',
  isSupportTopic: true,
});
promise.then(function(imResponse) { // Created successfully
  console.log(imResponse.data.group); // Profile of the created group
}).catch(function(imError){
  console.warn('createGroup error:', imError); // Failed to create the group
});

// Create a group with inviteOption
let promise = chat.createGroup({
  type: TencentCloudChat.TYPES.GRP_PUBLIC,
  name: 'WebSDK',
  inviteOption: TencentCloudChat.TYPES.INVITE_OPTIONS_NEED_PERMISSION,
});
promise.then(function(imResponse) {
  console.log(imResponse.data.group);
}).catch(function(imError) {
  console.warn('createGroup error:', imError);
});

chat.joinGroup(options);

let promise = chat.joinGroup({ groupID: 'group1' });
promise.then(function(imResponse) {
  switch (imResponse.data.status) {
    case TencentCloudChat.TYPES.JOIN_STATUS_WAIT_APPROVAL: // Waiting to be approved by the admin
      break;
    case TencentCloudChat.TYPES.JOIN_STATUS_SUCCESS: // Joined the group successfully
      console.log(imResponse.data.group); // Profile of the group
      break;
    case TencentCloudChat.TYPES.JOIN_STATUS_ALREADY_IN_GROUP: // The user is already in the group.
      break;
    default:
      break;
  }
}).catch(function(imError){
  console.warn('joinGroup error:', imError); // Failed to join the group
});

chat.getGroupList();

let promise = chat.getGroupList();
promise.then(function(imResponse) {
  console.log(imResponse.data.groupList); // Group list
}).catch(function(imError){
  console.warn('getGroupList error:', imError); // Failed to obtain the group list
});

chat.quitGroup(groupID);

let promise = chat.quitGroup('group1');
promise.then(function(imResponse) {
  console.log(imResponse.data.groupID); // ID of the group that the user leaves
}).catch(function(imError){
  console.warn('quitGroup error:', imError); // Failed to leave the group
});

chat.dismissGroup(groupID);

let promise = chat.dismissGroup('group1');
promise.then(function(imResponse) { // Disbanded successfully
  console.log(imResponse.data.groupID); // ID of the disbanded group
}).catch(function(imError){
  console.warn('dismissGroup error:', imError); // Failed to disband the group
});

chat.changeGroupOwner(options);

let promise = chat.changeGroupOwner({
  groupID: 'group1',
  newOwnerID: 'user2'
});
promise.then(function(imResponse) { // Transferred successfully
  console.log(imResponse.data.group); // Group profile
}).catch(function(imError) { // Failed to transfer the group
  console.warn('changeGroupOwner error:', imError); // Failed to transfer the group
});

chat.getGroupApplicationList();

let promise = chat.getGroupApplicationList();
promise.then(function(imResponse) {
  const { applicationList } = imResponse.data;
  applicationList.forEach((item) => {
    // item.applicant - Applicant userID
    // item.applicantNick - Applicant nickname
    // item.groupID - group ID
    // item.groupName - group Name
    // item.applicationType - Application type: 0 for group join application, 2 for invitation to join the group
    // item.userID - When applicationType = 2, it is the userID of the invited user.
    // item.note - reamake
    chat.handleGroupApplication({
      handleAction: 'Agree',
      application: {...item},
    });
  });
}).catch(function(imError) {
  console.warn('getGroupApplicationList error:', imError);
});

chat.handleGroupApplication(options);

let promise = chat.handleGroupApplication({
  handleAction: 'Agree',
  handleMessage: 'Welcome',
  // The message instance of the group system notification for an application to join a group.
  message: message
});
promise.then(function(imResponse) {
  console.log(imResponse.data.group); // Group profile
}).catch(function(imError){
  console.warn('handleGroupApplication error:', imError); // Error message
});

let promise = chat.getGroupApplicationList();
promise.then(function(imResponse) {
  const { applicationList } = imResponse.data;
  applicationList.forEach((item) => {
    if (item.applicationType === 0) {
      chat.handleGroupApplication({
        handleAction: 'Agree',
        application: {...item},
      });
    }
  });
}).catch(function(imError) {
  console.warn('getGroupApplicationList error:', imError);
});

let promise = chat.getGroupApplicationList();
promise.then(function(imResponse) {
  const { applicationList } = imResponse.data;
  applicationList.forEach((item) => {
    if (item.applicationType === 2) {
      chat.handleGroupApplication({
        handleAction: 'Agree',
        application: {...item},
      });
    }
  });
}).catch(function(imError) {
  console.warn('getGroupApplicationList error:', imError);
});