/*
 * Copyright 2015 Kakao Corp.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#import "KOBaseContext.h"

DEPRECATED_MSG_ATTRIBUTE("Use 'KOChatFilters' enum.")
/// 챗방 타입
/// (**Deprecated:** KOChatFilters를 사용하세요.)
/// @discussion **제휴를 통해 권한이 부여된 특정 앱에서만 사용 가능합니다.*
typedef NS_ENUM(NSInteger, KOChatType) {
    /// 그룹 채팅
    KOChatTypeGroup = 0
};

extern NSString* convertChatTypeString(KOChatType type) DEPRECATED_ATTRIBUTE;

/// 챗목록 필터링 옵션들
/// @discussion **제휴를 통해 권한이 부여된 특정 앱에서만 사용 가능합니다.*
typedef NS_ENUM(NSInteger, KOChatFilters) {
    /// 필터링 하지 않는다. (서버에서 내려주는 목록을 그대로 결과로 받는다)
    KOChatFilterNone = 0,
    /// 1:1 채팅방만 필터링하여 결과에 포함시킨다.
    KOChatFilterDirect  = 1,
    /// 그룹 채팅방만 필터링하여 결과에 포함시킨다.
    KOChatFilterMulti   = 1 << 1,
    /// 일반 채팅방만 필터링하여 결과에 포함시킨다.
    KOChatFilterRegular = 1 << 2,
    /// 오픈 채팅방만 필터링하여 결과에 포함시킨다.
    KOChatFilterOpen    = 1 << 3
};

NSString* convertChatFilterString(KOChatFilters filters); 

/// 채팅방 목록 페이징의 정보를 처리하기 위한 Context
/// @discussion **제휴를 통해 권한이 부여된 특정 앱에서만 사용 가능합니다.*
@interface KOChatContext : KOBaseContext

/// @abstract 챗리스트 필터링 옵션
@property (nonatomic, readonly) KOChatFilters chatFilters;

/// @abstract 채팅방 페이징 Context 를 생성한다.
/// @param chatFilters 챗리스트 필터링 옵션
/// @param limit 요청 시 제한하는 채팅방의 수 (채팅방은 30개 까지만 가져올 수 있습니다.)
/// @param ordering 정렬 방법
- (instancetype)initWithChatFilters:(KOChatFilters)chatFilters
                              limit:(NSInteger)limit
                           ordering:(KOOrdering)ordering;

/// @abstract 채팅방 페이징 Context 를 생성한다.
/// @param chatFilters 챗리스트 필터링 옵션
/// @param secureResource 프로필 이미지, 썸네일 등의 리소스 url을 https로 반환할지 여부
/// @param limit 요청 시 제한하는 채팅방의 수 (채팅방은 30개 까지만 가져올 수 있습니다.)
/// @param ordering 정렬 방법
- (instancetype)initWithChatFilters:(KOChatFilters)chatFilters
                     secureResource:(BOOL)secureResource
                              limit:(NSInteger)limit
                           ordering:(KOOrdering)ordering;

/// @abstract 채팅방 페이징 Context 를 생성한다.
/// @param chatFilters 챗리스트 필터링 옵션
+ (instancetype)contextWithChatFilters:(KOChatFilters)chatFilters;

/// @abstract 채팅방 페이징 Context 를 생성한다.
/// @param chatFilters 챗리스트 필터링 옵션
/// @param limit 요청 시 제한하는 채팅방의 수 (채팅방은 30개 까지만 가져올 수 있습니다.)
/// @param ordering 정렬 방법
+ (instancetype)contextWithChatFilters:(KOChatFilters)chatFilters
                                 limit:(NSInteger)limit
                              ordering:(KOOrdering)ordering;

/// @abstract 채팅방 페이징 Context 를 생성한다.
/// @param chatFilters 챗리스트 필터링 옵션
/// @param secureResource 프로필 이미지, 썸네일 등의 리소스 url을 https로 반환할지 여부
/// @param limit 요청 시 제한하는 채팅방의 수 (채팅방은 30개 까지만 가져올 수 있습니다.)
/// @param ordering 정렬 방법
+ (instancetype)contextWithChatFilters:(KOChatFilters)chatFilters
                        secureResource:(BOOL)secureResource
                                 limit:(NSInteger)limit
                              ordering:(KOOrdering)ordering;



@property (nonatomic, readonly) KOChatType chatType DEPRECATED_MSG_ATTRIBUTE("Use 'chatFilters' property.");

- (instancetype)initWithChatType:(KOChatType)chatType
                           limit:(NSInteger)limit
                        ordering:(KOOrdering)ordering DEPRECATED_MSG_ATTRIBUTE("Use 'initWithChatFilters:secureResource:limit:ordering:' method.");
+ (instancetype)contextWithChatType:(KOChatType)chatType DEPRECATED_MSG_ATTRIBUTE("Use 'contextWithChatFilters:' method.");
+ (instancetype)contextWithChatType:(KOChatType)chatType
                              limit:(NSInteger)limit
                           ordering:(KOOrdering)ordering DEPRECATED_MSG_ATTRIBUTE("Use 'contextWithChatFilters:limit:ordering:' method.");

@end