IEMChatManager.h

 
#import <Foundation/Foundation.h>
 
#import "EMCommonDefs.h"
#import "EMChatManagerDelegate.h"
#import "EMConversationDelegate.h"
#import "EMConversation.h"
 
#import "EMChatMessage.h"
#import "EMTextMessageBody.h"
#import "EMLocationMessageBody.h"
#import "EMCmdMessageBody.h"
#import "EMFileMessageBody.h"
#import "EMImageMessageBody.h"
#import "EMVoiceMessageBody.h"
#import "EMVideoMessageBody.h"
#import "EMCustomMessageBody.h"
#import "EMCombineMessageBody.h"
#import "EMCursorResult.h"
#import "EMPageResult.h"
 
#import "EMGroupReadReceipt.h"
#import "EMTranslateLanguage.h"
#import "EMVoiceParam.h"
#import "EMFetchServerMessagesOption.h"
#import "EMMessageSearchOption.h"
#import "EMSearchServerMessageResult.h"
#import "EMConversationFilter.h"
 
typedef NS_ENUM(NSUInteger, EMMessageFetchHistoryDirection) {
    EMMessageFetchHistoryDirectionUp  = 0,    
    EMMessageFetchHistoryDirectionDown        
};
 
 
@class EMError;
@class EMMessageReadReceipt;
 
@protocol IEMChatManager <NSObject>
 
@required
 
#pragma mark - Delegate
 
- (void)addDelegate:(id<EMChatManagerDelegate> _Nullable)aDelegate
      delegateQueue:(dispatch_queue_t _Nullable)aQueue;
 
- (void)removeDelegate:(id<EMChatManagerDelegate> _Nonnull)aDelegate;
 
- (void)addConversationDelegate:(id<EMConversationDelegate> _Nullable)aDelegate
                  delegateQueue:(dispatch_queue_t _Nullable)aQueue  NS_SWIFT_NAME(addConversation(delegate:queue:));
 
- (void)removeConversationDelegate:(id<EMConversationDelegate> _Nonnull)aDelegate NS_SWIFT_NAME(removeConversation(delegate:));
 
#pragma mark - Conversation
 
- (NSArray<EMConversation *> * _Nullable)getAllConversations;
 
- (NSArray<EMConversation *> * _Nullable)filterConversationsFromDB:(BOOL)cleanMemoryCache filter:(BOOL(^_Nullable)(EMConversation * _Nonnull conversation))filter NS_SWIFT_NAME(filterConversationsFromDB(cleanMemoryCache:filter:));
 
 
- (void)cleanConversationsMemoryCache;
 
- (NSArray<EMConversation *> * _Nullable)getAllConversations:(BOOL)isSort;
 
- (NSInteger)getUnreadMessageCount;
 
- (void)pinConversation:(nonnull NSString *)conversationId isPinned:(BOOL)isPinned completionBlock:(nullable void(^)(EMError * _Nullable error))completionBlock;
 
- (EMConversation *_Nullable)getConversationWithConvId:(NSString * _Nullable)aConversationId;
 
- (EMConversation *_Nullable)getConversation:(NSString *_Nonnull)aConversationId
                               type:(EMConversationType)aType
                   createIfNotExist:(BOOL)aIfCreate;
 
- (EMConversation *_Nullable)getConversation:(NSString *_Nonnull)aConversationId
                               type:(EMConversationType)aType
                   createIfNotExist:(BOOL)aIfCreate isThread:(BOOL)isThread;
 
- (void)deleteConversation:(NSString * _Nonnull)aConversationId
          isDeleteMessages:(BOOL)aIsDeleteMessages
                completion:(void (^_Nullable)(NSString * _Nullable aConversationId, EMError *_Nullable aError))aCompletionBlock;
 
 - (void)deleteServerConversation:(NSString * _Nonnull)aConversationId
                 conversationType:(EMConversationType)aConversationType
           isDeleteServerMessages:(BOOL)aIsDeleteServerMessages
                       completion:(void (^_Nullable)(NSString * _Nullable aConversationId, EMError * _Nullable aError))aCompletionBlock;
 
- (void)deleteConversations:(NSArray<EMConversation *> * _Nullable)aConversations
           isDeleteMessages:(BOOL)aIsDeleteMessages
                 completion:(void (^_Nullable)(EMError * _Nullable aError))aCompletionBlock;
 
#pragma mark - Message
 
- (EMChatMessage * _Nullable)getMessageWithMessageId:(NSString * _Nonnull)aMessageId;
 
- (NSString * _Nullable)getMessageAttachmentPath:(NSString * _Nonnull)aConversationId;
 
- (void)importMessages:(NSArray<EMChatMessage *> * _Nonnull)aMessages
            completion:(void (^_Nullable)(EMError *_Nullable aError))aCompletionBlock;
 
- (void)updateMessage:(EMChatMessage *_Nonnull)aMessage
           completion:(void (^_Nullable)(EMChatMessage * _Nullable aMessage, EMError * _Nullable aError))aCompletionBlock;
 
- (void)modifyMessage:(NSString *_Nonnull)messageId
                 body:(EMMessageBody *_Nullable)body
                  ext:(NSDictionary* _Nullable)ext
           completion:(void (^_Nonnull)(EMError * _Nullable error,EMChatMessage *_Nullable message))completionBlock;
 
- (void)sendMessageReadReceipts:(NSArray<EMChatMessage *> * _Nonnull)aMessages
                     completion:(void (^_Nullable)(EMError *_Nullable aError))aCompletionBlock;
 
- (void)clearConversationUnreadMessageCount:(NSString * _Nonnull)aConversationId
                                 completion:(void (^_Nullable)(EMError *_Nullable aError))aCompletionBlock;
 
- (void)clearAllConversationUnreadMessageCount:(void (^_Nullable)(EMError *_Nullable aError))aCompletionBlock;
 
- (void)getGroupMessageReadReceipts:(NSArray<EMChatMessage *> * _Nonnull)aMessages
                    completion:(void (^_Nullable)(NSArray<EMMessageReadReceipt *> *_Nullable aReceipts, EMError *_Nullable aError))aCompletionBlock;
 
- (void)recallMessageWithMessageId:(NSString *_Nonnull)aMessageId
                        completion:(void (^_Nullable)(EMError *_Nullable aError))aCompletionBlock;
 
- (void)recallMessageWithMessageId:(NSString *_Nonnull)aMessageId ext:(NSString * _Nullable)ext completion:(void (^_Nonnull)(EMError * _Nullable))aCompletionBlock;
- (void)sendMessage:(EMChatMessage *_Nonnull)aMessage
           progress:(void (^_Nullable)(int progress))aProgressBlock
         completion:(void (^_Nullable)(EMChatMessage *_Nullable message, EMError *_Nullable error))aCompletionBlock;
 
- (void)downloadMessageThumbnail:(EMChatMessage *_Nonnull)aMessage
                        progress:(void (^_Nullable)(int progress))aProgressBlock
                      completion:(void (^_Nullable)(EMChatMessage *_Nullable message, EMError *_Nullable error))aCompletionBlock;
 
- (void)downloadMessageAttachment:(EMChatMessage *_Nonnull)aMessage
                         progress:(void (^_Nullable)(int progress))aProgressBlock
                       completion:(void (^_Nullable)(EMChatMessage *_Nullable message, EMError *_Nullable error))aCompletionBlock;
- (void)downloadBigImageAttachment:(EMChatMessage *_Nonnull)aMessage
                         progress:(void (^_Nullable)(int progress))aProgressBlock
                       completion:(void (^_Nullable)(EMChatMessage *_Nullable message, EMError *_Nullable error))aCompletionBlock;
 
- (void)downloadAndParseCombineMessage:(EMChatMessage* _Nonnull)aMessage
                            completion:(void (^_Nullable)(NSArray<EMChatMessage *>*_Nullable messages, EMError *_Nullable error))aCompletionBlock;
- (void)asyncFetchGroupMessageReadUsersFromServer:(NSString *_Nonnull)aMessageId
                                          groupId:(NSString *_Nonnull)aGroupId
                                    readReceiptId:(NSString *_Nonnull)aReadReceiptId
                                         pageSize:(int)aPageSize
                                       completion:(void (^_Nullable)(EMCursorResult<EMGroupReadReceipt *> *_Nullable aResult, EMError *_Nullable error, int totalCount))aCompletionBlock;
 
- (void)deleteMessagesBefore:(NSUInteger)aTimestamp
                  completion:(void(^_Nullable)(EMError*_Nullable error))aCompletion;
 
 
 
- (void)removeMessagesFromServerWithConversation:(EMConversation *_Nonnull)conversation messageIds:(NSArray <__kindof NSString*>*_Nonnull)messageIds completion:(void (^ _Nullable)(EMError * _Nullable aError))aCompletionBlock;
- (void)removeMessagesFromServerWithConversation:(EMConversation *_Nonnull)conversation timeStamp:(NSTimeInterval)beforeTimeStamp completion:(void (^ _Nullable)(EMError * _Nullable aError))aCompletionBlock;
 
 
- (void)translateMessage:(EMChatMessage * _Nonnull)aMessage
         targetLanguages:(NSArray<NSString*>* _Nonnull)aLanguages
              completion:(void (^_Nullable)(EMChatMessage * _Nullable message, EMError * _Nullable error))aCompletionBlock;
 
- (void)voiceMessageToText:(EMChatMessage * _Nonnull)aMessage
                completion:(void (^_Nullable)(NSString * _Nullable text, EMError * _Nullable error))aCompletionBlock;
 
- (void)voiceFileToText:(NSString * _Nonnull)aFilePath
             voiceParam:(EMVoiceParam * _Nullable)aVoiceParam
             completion:(void (^_Nullable)(NSString * _Nullable text, EMError * _Nullable error))aCompletionBlock;
 
- (void)fetchSupportedLanguages:(void(^_Nullable)(NSArray<EMTranslateLanguage*>* _Nullable languages,EMError* _Nullable error))aCompletionBlock;
 
- (void)searchMessagesWithTypes:(NSArray <NSNumber*>* _Nonnull)aTypes
                   timestamp:(long long)aTimestamp
                       count:(int)aCount
                    fromUser:(NSString* _Nullable)aUsername
             searchDirection:(EMMessageSearchDirection)aDirection
                   completion:(void (^_Nonnull)(NSArray<EMChatMessage *> * _Nullable aMessages, EMError * _Nullable aError))aCompletionBlock;
 
- (void)loadMessagesWithKeyword:(NSString* _Nonnull)aKeywords
                      timestamp:(long long)aTimestamp
                          count:(int)aCount
                       fromUser:(NSString *_Nullable)aSender
                searchDirection:(EMMessageSearchDirection)aDirection
                          scope:(EMMessageSearchScope)aScope
                     completion:(void (^_Nullable)(NSArray<EMChatMessage *> *_Nullable aMessages, EMError *_Nullable aError))aCompletionBlock;
 
- (void)loadConversationMessagesWithKeyword:(NSString*_Nullable )aKeywords
                                  timestamp:(long long)aTimestamp
                                   fromUser:(NSString*_Nullable )aSender
                            searchDirection:(EMMessageSearchDirection)aDirection
                                      scope:(EMMessageSearchScope)aScope
                                 completion:(void (^ _Nonnull)(NSDictionary<NSString*,NSArray<NSString*> *> * _Nullable aConversationMessages, EMError * _Nullable aError))aCompletionBlock;
 
NS_ASSUME_NONNULL_BEGIN
- (void)addReaction:(NSString *)reaction toMessage:(NSString *)messageId completion:(nullable void(^)(EMError * _Nullable))completion;
 
- (void)removeReaction:(NSString *)reaction fromMessage:(NSString *)messageId completion:(nullable void(^)(EMError * _Nullable))completion;
 
- (void)getReactionList:(NSArray <NSString *>*)messageIds
                groupId:(nullable NSString *)groupId
               chatType:(EMChatType)chatType
             completion:(void (^)(NSDictionary <NSString *, NSArray<EMMessageReaction *> *> *, EMError * _Nullable))completion;
 
- (void)getReactionDetail:(NSString *)messageId
                 reaction:(NSString *)reaction
                    cursor:(nullable NSString *)cursor
                 pageSize:(uint64_t)pageSize
               completion:(void (^)(EMMessageReaction *, NSString * _Nullable cursor, EMError * _Nullable))completion;
 
- (void)fetchMessagesFromServerBy:(NSString* )conversationId
                 conversationType:(EMConversationType)type
                           cursor:(NSString* _Nullable)cursor
                         pageSize:(NSUInteger)pageSize
                           option:(EMFetchServerMessagesOption* _Nullable)option
                       completion:(void (^_Nullable)(EMCursorResult<EMChatMessage*>* _Nullable result, EMError* _Nullable aError))aCompletionBlock;
 
- (void)searchMessagesFromServerWithOption:(EMMessageSearchOption *)option
                                  pageSize:(NSInteger)pageSize
                                   pageNum:(NSInteger)pageNum
                                completion:(void (^_Nullable)(EMPageResult<EMSearchServerMessageResult*>* _Nullable result, EMError* _Nullable aError))completion;
 
- (void)addConversationMark:(NSArray<NSString*>* _Nonnull)conversationIds mark:(EMMarkType)mark completion:(void (^_Nullable)(EMError* _Nullable aError))completion;
 
- (void)removeConversationMark:(NSArray<NSString*>* _Nonnull)conversationIds mark:(EMMarkType)mark completion:(void (^_Nullable)(EMError* _Nullable aError))completion;
 
 
- (void)deleteAllMessagesAndConversations:(BOOL)clearServerData completion:(void (^_Nullable)(EMError * _Nullable aError))aCompletionBlock;
 
- (void)pinMessage:(NSString* _Nonnull)messageId completion:(void (^_Nullable)(EMChatMessage* _Nullable message,EMError * _Nullable aError))aCompletionBlock;
- (void)unpinMessage:(NSString* _Nonnull)messageId completion:(void (^_Nullable)(EMChatMessage* _Nullable message,EMError * _Nullable aError))aCompletionBlock;
 
- (void)getPinnedMessagesFromServer:(NSString* _Nonnull)conversationId completion:(void (^_Nullable)(NSArray<EMChatMessage*>* _Nullable messages,EMError * _Nullable aError))aCompletionBlock;
 
- (void)getMessageCountWithCompletion:(void (^)(NSInteger count, EMError * _Nullable aError))completion;
 
- (void)getMessages:(NSArray<NSString *> * _Nonnull)aMessageIds
  withConversationId:(NSString * _Nonnull)aConversationId
          completion:(void (^ _Nonnull)(NSArray<EMChatMessage *> * _Nullable aMessages, EMError * _Nullable aError))aCompletionBlock;
    
NS_ASSUME_NONNULL_END
 
@end