IEMCircleManager.h

//
//  IEMCircleManager.h
//  HyphenateChat
//
//  Created by 冯钊 on 2022/6/14.
//  Copyright © 2022 easemob.com. All rights reserved.
//
 
#import <Foundation/Foundation.h>
 
#import "EMError.h"
#import "EMCircleUser.h"
#import "EMCircleServer.h"
#import "EMCircleChannel.h"
#import "EMCircleManagerServerDelegate.h"
#import "EMCircleManagerChannelDelegate.h"
#import "EMCursorResult.h"
#import "EMCircleServerAttribute.h"
#import "EMCircleChannelAttribute.h"
#import "EMCircleCategory.h"
#import "EMCircleVoiceChannel.h"
#import "EMCircleManagerCategoryDelegate.h"
typedef NS_ENUM(NSUInteger, EMCircleServerSearchType) {
    EMCircleServerSearchTypeName,
    EMCircleServerSearchTypeTag,
};
 
NS_ASSUME_NONNULL_BEGIN
 
@protocol IEMCircleManager <NSObject>
 
@required
- (void)addServerDelegate:(id<EMCircleManagerServerDelegate>)delegate
     queue:(nullable dispatch_queue_t)queue NS_SWIFT_NAME(add(serverDelegate:queue:));
- (void)removeServerDelegate:(id<EMCircleManagerServerDelegate>)delegate NS_SWIFT_NAME(remove(serverDelegate:));
 
- (void)addChannelDelegate:(id<EMCircleManagerChannelDelegate>)delegate
     queue:(nullable dispatch_queue_t)queue NS_SWIFT_NAME(add(channelDelegate:queue:));
 
- (void)removeChannelDelegate:(id<EMCircleManagerChannelDelegate>)delegate NS_SWIFT_NAME(remove(channelDelegate:));
 
- (void)addCategoryDelegate:(id<EMCircleManagerCategoryDelegate>)delegate queue:(nullable dispatch_queue_t)queue  NS_SWIFT_NAME(add(categoryDelegate:queue:));
 
- (void)removeCategoryDelegate:(id<EMCircleManagerCategoryDelegate>)delegate NS_SWIFT_NAME(remove(categoryDelegate:));
#pragma mark - server
- (void)createServer:(EMCircleServerAttribute *)attribute completion:(void(^)(EMCircleServer * _Nullable server, EMError * _Nullable error))completion;
 
- (void)destroyServer:(NSString *)serverId completion:(void(^)(EMError * _Nullable error))completion;
 
- (void)updateServer:(NSString *)serverId attribute:(EMCircleServerAttribute *)attribute completion:(void(^)(EMCircleServer * _Nullable server, EMError * _Nullable error))completion;
 
- (void)joinServer:(NSString *)serverId completion:(void(^)(EMCircleServer * _Nullable server, EMError * _Nullable error))completion;
 
- (void)leaveServer:(NSString *)serverId completion:(void(^)(EMError * _Nullable error))completion;
 
- (void)removeUserFromServer:(NSString *)serverId userId:(NSString *)userId completion:(void(^)(EMError * _Nullable error))completion;
 
- (void)inviteUserToServer:(NSString *)serverId userId:(NSString *)userId welcome:(nullable NSString *)welcome completion:(void(^)(EMError * _Nullable error))completion NS_SWIFT_NAME(inviteUserToServer(serverId:userId:welcome:completion:));;
 
- (void)acceptServerInvitation:(NSString *)serverId inviter:(NSString *)invite completion:(void(^)(EMCircleServer * _Nullable server, EMError * _Nullable error))completion;
 
- (void)declineServerInvitation:(NSString *)serverId inviter:(NSString *)invite completion:(void(^)(EMError * _Nullable error))completion;
 
- (void)addTagsToServer:(NSString *)serverId tags:(NSArray<NSString *> *)tags completion:(void(^)(NSArray<EMCircleServerTag *> * _Nullable tags, EMError * _Nullable error))completion;
 
- (void)removeTagsFromServer:(NSString *)serverId tagIds:(NSArray <NSString *>*)tagIds completion:(void(^)(EMError * _Nullable error))completion;
 
- (void)addModeratorToServer:(NSString *)serverId userId:(NSString *)userId completion:(void(^)(EMError * _Nullable error))completion;
 
- (void)removeModeratorFromServer:(NSString *)serverId userId:(NSString *)userId completion:(void(^)(EMError * _Nullable error))completion;
 
- (void)fetchSelfServerRole:(NSString *)serverId completion:(void(^)(EMCircleUserRole role, EMError * _Nullable error))completion;
 
- (void)fetchJoinedServers:(NSUInteger)limit cursor:(nullable NSString *)cursor completion:(void(^)(EMCursorResult<EMCircleServer *> * _Nullable result, EMError * _Nullable error))completion;
 
- (void)fetchServerDetail:(NSString *)serverId completion:(void(^)(EMCircleServer * _Nullable server, EMError * _Nullable error))completion;
 
- (void)fetchServersWithKeyword:(NSString *)keyword completion:(void (^)(NSArray<EMCircleServer *> * _Nullable result, EMError * _Nullable error))completion;
 
- (void)fetchServersWithType:(EMCircleServerSearchType)type keyword:(NSString *)keyword limit:(NSUInteger)limit cursor:(nullable NSString *)cursor completion:(void (^)(EMCursorResult<EMCircleServer *> * _Nullable result, EMError * _Nullable error))completion;
 
- (void)fetchServerMembers:(NSString *)serverId limit:(NSUInteger)limit cursor:(nullable NSString *)cursor completion:(void(^)(EMCursorResult<EMCircleUser *> * _Nullable result, EMError * _Nullable error))completion;
 
- (void)checkSelfIsInServer:(NSString *)serverId completion:(void(^)(BOOL isJoined, EMError * _Nullable error))completion;
 
- (void)fetchServerTags:(NSString *)serverId completion:(void(^)(NSArray<EMCircleServerTag *> * _Nullable result, EMError * _Nullable error))completion;
 
#pragma mark - channel
- (void)createChannel:(NSString *)serverId categoryId:(nullable NSString *)categoryId attribute:(EMCircleChannelAttribute *)attribute mode:(EMCircleChannelMode)mode completion:(void(^)(EMCircleChannel * _Nullable channel, EMError * _Nullable error))completion;
 
- (void)destroyChannel:(NSString *)serverId channelId:(NSString *)channelId completion:(void(^)(EMError * _Nullable error))completion;
 
- (void)updateChannel:(NSString *)serverId channelId:(NSString *)channelId attribute:(EMCircleChannelAttribute *)attribute completion:(void(^)(EMCircleChannel * _Nullable channel, EMError * _Nullable error))completion;
 
- (void)joinChannel:(NSString *)serverId channelId:(NSString *)channelId completion:(void(^)(EMCircleChannel * _Nullable channel, EMError * _Nullable error))completion;
 
- (void)leaveChannel:(NSString *)serverId channelId:(NSString *)channelId completion:(void(^)(EMError * _Nullable error))completion;
 
- (void)removeUserFromChannel:(NSString *)serverId channelId:(NSString *)channelId userId:(NSString *)userId completion:(void(^)(EMError * _Nullable error))completion;
 
- (void)inviteUserToChannel:(NSString *)serverId channelId:(NSString *)channelId userId:(NSString *)userId welcome:(nullable NSString *)welcome completion:(void(^)(EMError * _Nullable error))completion NS_SWIFT_NAME(inviteUserToChannel(serverId:channelId:userId:welcome:completion:));
 
- (void)acceptChannelInvitation:(NSString *)serverId channelId:(NSString *)channelId inviter:(NSString *)inviter completion:(void(^)(EMCircleChannel * _Nullable channel, EMError * _Nullable error))completion;
 
- (void)declineChannelInvitation:(NSString *)serverId channelId:(NSString *)channelId inviter:(NSString *)inviter completion:(void(^)(EMError * _Nullable error))completion;
 
- (void)muteUserInChannel:(NSString *)userId serverId:(NSString *)serverId channelId:(NSString *)channelId duration:(NSUInteger)duration completion:(void(^)(EMError * _Nullable error))completion NS_SWIFT_NAME(muteUserInChannel(userId:serverId:channelId:duration:completion:));
 
- (void)unmuteUserInChannel:(NSString *)userId serverId:(NSString *)serverId channelId:(NSString *)channelId completion:(void(^)(EMError * _Nullable error))completion NS_SWIFT_NAME(unmuteUserInChannel(userId:serverId:channelId:completion:));
 
- (void)fetchChannelDetail:(NSString *)serverId channelId:(NSString *)channelId completion:(void(^)(EMCircleChannel * _Nullable channel, EMError * _Nullable error))completion;
 
- (void)fetchPublicChannelsInServer:(NSString *)serverId limit:(NSUInteger)limit cursor:(nullable NSString *)cursor completion:(void(^)(EMCursorResult<EMCircleChannel *> * _Nullable result, EMError * _Nullable error))completion;
 
- (void)fetchPrivateChannelsInServer:(NSString *)serverId limit:(NSUInteger)limit cursor:(nullable NSString *)cursor completion:(void(^)(EMCursorResult<EMCircleChannel *> * _Nullable result, EMError * _Nullable error))completion;
 
- (void)fetchPublicChannelsInCategory:(NSString *)serverId categoryId:(NSString *)categoryId limit:(NSUInteger)limit cursor:(nullable NSString *)cursor completion:(void (^)(EMCursorResult<EMCircleChannel *> * _Nullable, EMError * _Nullable))completion;
 
- (void)fetchPrivateChannelsInCategory:(NSString *)serverId categoryId:(NSString *)categoryId limit:(NSUInteger)limit cursor:(nullable NSString *)cursor completion:(void (^)(EMCursorResult<EMCircleChannel *> * _Nullable, EMError * _Nullable))completion;
 
- (void)fetchChannelMembers:(NSString *)serverId channelId:(NSString *)channelId limit:(NSUInteger)limit cursor:(nullable NSString *)cursor completion:(void(^)(EMCursorResult<EMCircleUser *> * _Nullable result, EMError * _Nullable error))completion;
 
- (void)fetchJoinedChannelIdsInServer:(NSString *)serverId limit:(NSUInteger)limit cursor:(nullable NSString *)cursor completion:(void(^)(EMCursorResult<NSString *> * _Nullable result, EMError * _Nullable error))completion;
 
- (void)checkSelfIsInChannel:(NSString *)serverId channelId:(NSString *)channelId completion:(void(^)(BOOL isJoined, EMError * _Nullable error))completion NS_SWIFT_NAME(checkSelfIsInChannel(serverId:channelId:completion:));
 
- (void)fetchChannelMuteUsers:(NSString *)serverId channelId:(NSString *)channelId completion:(void(^)(NSDictionary<NSString *, NSNumber *> * _Nullable muteInfo, EMError * _Nullable error))completion;
 
#pragma mark - category
- (void)createCategory:(NSString *)serverId name:(NSString *)name completion:(void(^)(EMCircleCategory * _Nullable category, EMError * _Nullable error))completion;
 
- (void)destroyCategory:(NSString *)serverId categoryId:(NSString *)categoryId completion:(void(^)(EMError * _Nullable error))completion;
 
- (void)updateCategory:(NSString *)serverId categoryId:(NSString *)categoryId name:(NSString *)name completion:(void(^)(EMCircleCategory * _Nullable category, EMError * _Nullable error))completion;
 
- (void)transferChannel:(NSString *)serverId channelId:(NSString *)channelId newCategoryId:(nullable NSString *)newCategoryId completion:(void(^)(EMError * _Nullable error))completion;
 
- (void)fetchCategoriesInServer:(NSString *)serverId limit:(NSUInteger)limit cursor:(nullable NSString *)cursor completion:(void(^)(EMCursorResult<EMCircleCategory *> * _Nullable result, EMError * _Nullable error))completion;
 
@end
 
NS_ASSUME_NONNULL_END