//
|
// TWTRUserSessionVerifier.h
|
// TwitterKit
|
//
|
// Created by Kang Chen on 1/23/15.
|
// Copyright (c) 2015 Twitter. All rights reserved.
|
//
|
|
@class TWTRUserSessionVerifier;
|
|
@protocol TWTRUserSessionVerifierDelegate <NSObject>
|
|
- (void)userSessionVerifierNeedsSessionVerification:(TWTRUserSessionVerifier *)userSessionVerifier;
|
|
@end
|
|
FOUNDATION_EXPORT NSTimeInterval const TWTRUserSessionVerifierIntervalDaily;
|
FOUNDATION_EXPORT NSTimeInterval const TWTRUserSessionVerifierDefaultDelay;
|
|
/**
|
* Manages verifying stored user sessions on a daily basis. This class depends on the Kit lifecycle
|
* and `UIApplicationWillEnterForegroundNotification` event and checks whether the last verified
|
* time has exceeded a day based on UTC date boundaries. Note that this does not mean we will aggressively
|
* verify the second day of someone that started using the app at 11:59P and continues past 12:00A
|
* due to 1) avoiding load spike to backend and 2) there is no good reliable way to randomize the
|
* scheduling of the second verification due to constraints of iOS. Last verified time is only stored in memory
|
* to minimize overhead on the host application. Verification is done on a best effort basis and we
|
* will not retry if the network call fails for whatever reason.
|
*/
|
@interface TWTRUserSessionVerifier : NSObject
|
|
- (instancetype)init __unavailable;
|
|
/**
|
* Initializes a verifier for the current consumer application.
|
*
|
* @param delegate An object that will handle the verification of the session when necessary
|
* @param maxDesiredInterval maximum desireable interval for how frequently a verify call should be made while
|
* the host app is active. Calls might be made more frequently if the app is used
|
* during the previous and current interval boundaries or we cannot not tell when
|
* the last call was made. The latter will be de-dup on the backend.
|
*/
|
- (instancetype)initWithDelegate:(id<TWTRUserSessionVerifierDelegate>)delegate maxDesiredInterval:(NSTimeInterval)maxDesiredInterval __attribute__((nonnull(1)))NS_DESIGNATED_INITIALIZER;
|
|
/**
|
* Makes a verify call immediately (delayed slightly to minimize app startup impact) and then
|
* subscribes to `UIApplicationWillEnterForegroundNotification` to check for the next time we should
|
* be making a verify call.
|
*
|
* @param delay The minimum time before which the message is sent. Specifying a delay of 0 does not
|
* necessarily cause the selector to be performed immediately. The first verification is
|
* still queued on the thread’s run loop and performed as soon as possible.
|
*/
|
- (void)startVerificationAfterDelay:(NSTimeInterval)delay;
|
|
@end
|
