/*
|
* Copyright (C) 2017 Twitter, Inc.
|
*
|
* 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.
|
*
|
*/
|
|
@class TWTRAuthConfig;
|
@protocol TWTRAPIServiceConfig;
|
@protocol TWTRBaseSession;
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
/**
|
* Completion block to call when done refreshing the session or it fails.
|
*
|
* @param refreshedSession The refreshed session
|
* @param error Non nil error if the refresh fails.
|
*/
|
typedef void (^TWTRSessionRefreshCompletion)(id _Nullable refreshedSession, NSError *_Nullable error);
|
|
/**
|
* Protocol for session refresh strategies.
|
*/
|
@protocol TWTRSessionRefreshStrategy <NSObject>
|
|
/**
|
* Determines whether the strategy supports the given session class.
|
*
|
* @param sessionClass The class of session to check.
|
*
|
* @return YES if this strategy can be used to refresh the given session class.
|
*/
|
+ (BOOL)canSupportSessionClass:(Class)sessionClass;
|
|
/**
|
* Determines whether the session has expired based on the API response of a previous API request made with the session.
|
*
|
* @param response HTTP response of a previous API request
|
*
|
* @return YES if the HTTP response is contains information to indicate the session is invalid or has expired.
|
*/
|
+ (BOOL)isSessionExpiredBasedOnRequestResponse:(NSHTTPURLResponse *)response;
|
|
/**
|
* Determines whether the session has expired based on the API response error of a previous API request made with the session.
|
*
|
* @param response error a previous API request
|
*
|
* @return YES if the error contains information to indicate the session is invalid or has expired.
|
*/
|
+ (BOOL)isSessionExpiredBasedOnRequestError:(NSError *)responseError;
|
|
/**
|
* Request to fetch a new session.
|
*
|
* @param session Expired session to request new one for
|
* @param URLSession URL session to make the authentication request with
|
* @param completion Completion block to call when done refreshing the session or it fails.
|
*/
|
- (void)refreshSession:(id<TWTRBaseSession>)session URLSession:(NSURLSession *)URLSession completion:(TWTRSessionRefreshCompletion)completion;
|
|
@end
|
|
/**
|
Concrete implementation of a strategy for handling expiration and refresh of guest sessions.
|
*/
|
@interface TWTRGuestSessionRefreshStrategy : NSObject <TWTRSessionRefreshStrategy>
|
|
/**
|
* Initializes a new guest refresh strategy.
|
*
|
* @param authConfig The `authConfig` associated with the app to refresh guest sessions for
|
* @param APIServiceConfig The API service config to configure endpoints
|
*
|
* @return Initialized strategy that can refresh guest sessions of the given application
|
*/
|
- (instancetype)initWithAuthConfig:(TWTRAuthConfig *)authConfig APIServiceConfig:(id<TWTRAPIServiceConfig>)APIServiceConfig;
|
- (instancetype)init __unavailable;
|
|
@end
|
|
NS_ASSUME_NONNULL_END
|
