EMConversation.h

#import <Foundation/Foundation.h>

#import "EMMessageBody.h"

/*
 *  \~chinese
 *  会话类型
 *
 *  \~english
 *  Conversation type
 */
typedef enum {
    EMConversationTypeChat  = 0,    
    EMConversationTypeGroupChat,    
    EMConversationTypeChatRoom      
} EMConversationType;

/*
 *  \~chinese
 *  消息搜索方向
 *
 *  \~english
 *  Message search direction
 */
typedef enum {
    EMMessageSearchDirectionUp  = 0,    
    EMMessageSearchDirectionDown        
} EMMessageSearchDirection;

@class EMMessage;
@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, copy) NSDictionary *ext;

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

- (EMMessage *)lastReceivedMessage;

- (void)insertMessage:(EMMessage *)aMessage
                error:(EMError **)pError;

- (void)appendMessage:(EMMessage *)aMessage
                error:(EMError **)pError;

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

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

- (void)updateMessageChange:(EMMessage *)aMessage
                      error:(EMError **)pError;

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

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


#pragma mark - Load Messages Methods

- (EMMessage *)loadMessageWithId:(NSString *)aMessageId
                           error:(EMError **)pError;

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

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

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

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


#pragma mark - Deprecated methods

- (BOOL)insertMessage:(EMMessage *)aMessage __deprecated_msg("Use -insertMessage:error:");

- (BOOL)appendMessage:(EMMessage *)aMessage __deprecated_msg("Use -appendMessage:error:");

- (BOOL)deleteMessageWithId:(NSString *)aMessageId __deprecated_msg("Use -deleteMessageWithId:error:");

- (BOOL)deleteAllMessages __deprecated_msg("Use -deleteAllMessages:");

- (BOOL)updateMessage:(EMMessage *)aMessage __deprecated_msg("Use -updateMessageChange:error:");

- (BOOL)markMessageAsReadWithId:(NSString *)aMessageId __deprecated_msg("Use -markMessageAsReadWithId:error:");

- (BOOL)markAllMessagesAsRead __deprecated_msg("Use -markAllMessagesAsRead:");

- (BOOL)updateConversationExtToDB __deprecated_msg("setExt: will update extend properties to DB");

- (EMMessage *)loadMessageWithId:(NSString *)aMessageId __deprecated_msg("Use -loadMessageWithId:error:");

- (NSArray *)loadMoreMessagesFromId:(NSString *)aMessageId
                              limit:(int)aLimit
                          direction:(EMMessageSearchDirection)aDirection __deprecated_msg("Use -loadMessagesStartFromId:count:searchDirection:completion:");

- (NSArray *)loadMoreMessagesWithType:(EMMessageBodyType)aType
                               before:(long long)aTimestamp
                                limit:(int)aLimit
                                 from:(NSString*)aSender
                            direction:(EMMessageSearchDirection)aDirection __deprecated_msg("Use -loadMessagesWithType:timestamp:count:fromUser:searchDirection:completion:");

- (NSArray *)loadMoreMessagesContain:(NSString*)aKeywords
                              before:(long long)aTimestamp
                               limit:(int)aLimit
                                from:(NSString*)aSender
                           direction:(EMMessageSearchDirection)aDirection __deprecated_msg("Use -loadMessagesContainKeywords:timestamp:count:fromUser:searchDirection:completion:");

- (NSArray *)loadMoreMessagesFrom:(long long)aStartTimestamp
                               to:(long long)aEndTimestamp
                         maxCount:(int)aMaxCount __deprecated_msg("Use -loadMessagesFrom:to:count:completion:");

- (EMMessage *)latestMessageFromOthers __deprecated_msg("Use -lastReceivedMessage");

@end