EMConversation.h

#import <Foundation/Foundation.h>

#import "EMMessageBody.h"
#import "EMCursorResult.h"

typedef NS_ENUM(NSInteger, EMConversationType) {
    EMConversationTypeChat = 0,    
    EMConversationTypeGroupChat,    
    EMConversationTypeChatRoom,      
};

typedef NS_ENUM(NSInteger, EMMarkType) {
    EMMarkType0 = 0,
    EMMarkType1 = 1,
    EMMarkType2 = 2,
    EMMarkType3 = 3,
    EMMarkType4 = 4,
    EMMarkType5 = 5,
    EMMarkType6 = 6,
    EMMarkType7 = 7,
    EMMarkType8 = 8,
    EMMarkType9 = 9,
    EMMarkType10 = 10,
    EMMarkType11 = 11,
    EMMarkType12 = 12,
    EMMarkType13 = 13,
    EMMarkType14 = 14,
    EMMarkType15 = 15,
    EMMarkType16 = 16,
    EMMarkType17 = 17,
    EMMarkType18 = 18,
    EMMarkType19 = 19,
};

typedef NS_ENUM(NSInteger, EMMessageSearchDirection) {
    EMMessageSearchDirectionUp  = 0,    
    EMMessageSearchDirectionDown        
};

typedef NS_ENUM(NSInteger, EMMessageSearchScope) {
    EMMessageSearchScopeContent  = 0,   
    EMMessageSearchScopeExt,           
    EMMessageSearchScopeAll           
};

@class EMChatMessage;
@class EMError;

@interface EMConversation : NSObject

@property (nonatomic, copy, readonly) NSString *conversationId;

@property (nonatomic, assign, readonly) EMConversationType type;

@property (nonatomic, assign, readonly) int unreadMessagesCount;

@property (nonatomic, assign, readonly) int messagesCount;

@property (nonatomic, copy)   NSDictionary *ext;

@property (nonatomic, assign) BOOL isChatThread;

@property (readonly) BOOL isPinned;

@property (readonly) int64_t pinnedTime;

@property (nonatomic, strong, readonly) EMChatMessage *latestMessage;

@property (nonatomic, readonly) NSArray<NSNumber*>* marks;

- (EMChatMessage * _Nullable)lastReceivedMessage;

- (void)insertMessage:(EMChatMessage *_Nonnull)aMessage
                error:(EMError ** _Nullable)pError;

- (void)appendMessage:(EMChatMessage *_Nonnull)aMessage
                error:(EMError **_Nullable)pError;

- (void)deleteMessageWithId:(NSString *_Nonnull)aMessageId
                      error:(EMError ** _Nullable)pError;

- (void)deleteAllMessages:(EMError ** _Nullable)pError;


- (void)removeMessagesFromServerMessageIds:(NSArray <__kindof NSString*>*_Nonnull)messageIds completion:(void (^ _Nullable)(EMError * _Nullable aError))aCompletionBlock;
- (void)removeMessagesFromServerWithTimeStamp:(NSTimeInterval)beforeTimeStamp completion:(void (^ _Nullable)(EMError * _Nullable aError))aCompletionBlock;

- (void)updateMessageChange:(EMChatMessage *_Nonnull)aMessage
                      error:(EMError ** _Nullable)pError;

- (void)markMessageAsReadWithId:(NSString *_Nonnull)aMessageId
                          error:(EMError ** _Nullable)pError;

- (void)markAllMessagesAsRead:(EMError ** _Nullable)pError;

- (NSArray<EMChatMessage*>* _Nullable)pinnedMessages;


#pragma mark - Load Messages Methods

- (EMChatMessage * _Nullable)loadMessageWithId:(NSString * _Nonnull)aMessageId
                           error:(EMError ** _Nullable)pError;

- (NSArray<EMChatMessage *> * _Nullable)loadMessagesStartFromId:(NSString * _Nullable)aMessageId
                          count:(int)aCount
                searchDirection:(EMMessageSearchDirection)aDirection;

- (void)loadMessagesStartFromId:(NSString * _Nullable)aMessageId
                          count:(int)aCount
                searchDirection:(EMMessageSearchDirection)aDirection
                     completion:(void (^ _Nullable)(NSArray<EMChatMessage *> * _Nullable aMessages, EMError * _Nullable aError))aCompletionBlock;

- (NSArray<EMChatMessage *> * _Nullable)loadMessagesWithType:(EMMessageBodyType)aType
                                                   timestamp:(long long)aTimestamp
                                                       count:(int)aCount
                                                    fromUser:(NSString* _Nullable)aUsername
                                             searchDirection:(EMMessageSearchDirection)aDirection;

- (void)loadMessagesWithType:(EMMessageBodyType)aType
                   timestamp:(long long)aTimestamp
                       count:(int)aCount
                    fromUser:(NSString* _Nullable)aUsername
             searchDirection:(EMMessageSearchDirection)aDirection
                  completion:(void (^ _Nullable)(NSArray<EMChatMessage *> * _Nullable aMessages, EMError * _Nullable aError))aCompletionBlock;

- (NSArray<EMChatMessage *> * _Nullable)loadMessagesWithKeyword:(NSString* _Nullable)aKeyword
                      timestamp:(long long)aTimestamp
                          count:(int)aCount
                       fromUser:(NSString* _Nullable)aSender
                searchDirection:(EMMessageSearchDirection)aDirection;

- (void)loadMessagesWithKeyword:(NSString* _Nullable)aKeyword
                      timestamp:(long long)aTimestamp
                          count:(int)aCount
                       fromUser:(NSString* _Nullable)aSender
                searchDirection:(EMMessageSearchDirection)aDirection
                     completion:(void (^ _Nullable)(NSArray<EMChatMessage *> * _Nullable aMessages, EMError * _Nullable aError))aCompletionBlock;

- (void)loadMessagesWithKeyword:(NSString* _Nullable)aKeyword
                      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;

- (NSArray<EMChatMessage *> * _Nullable)loadCustomMsgWithKeyword:(NSString*)aKeyword
                       timestamp:(long long)aTimestamp
                           count:(int)aCount
                        fromUser:(NSString* _Nullable)aSender
                 searchDirection:(EMMessageSearchDirection)aDirection;

- (void)loadCustomMsgWithKeyword:(NSString* _Nullable)aKeyword
                       timestamp:(long long)aTimestamp
                           count:(int)aCount
                        fromUser:(NSString* _Nullable)aSender
                 searchDirection:(EMMessageSearchDirection)aDirection
                      completion:(void (^ _Nullable)(NSArray<EMChatMessage *> * _Nullable aMessages, EMError * _Nullable aError))aCompletionBlock;

- (NSArray<EMChatMessage *> * _Nullable)loadMessagesFrom:(long long)aStartTimestamp
                      to:(long long)aEndTimestamp
                   count:(int)aCount;

- (void)loadMessagesFrom:(long long)aStartTimestamp
                      to:(long long)aEndTimestamp
                   count:(int)aCount
              completion:(void (^ _Nullable)(NSArray<EMChatMessage *> * _Nullable aMessages, EMError * _Nullable aError))aCompletionBlock;

- (EMError* _Nullable)removeMessagesStart:(NSInteger)aStartTimestamp
                                       to:(NSInteger)aEndTimestamp;
@end