iOS

source 'https://github.com/volcengine/volcengine-specs.git'
source 'https://github.com/aliyun/aliyun-specs.git'

pod 'LBWhaleAppSDK', :path => './LBWhaleAppSDK'

pod install

Foundation
UIKit
Security
SystemConfiguration
CoreGraphics
QuartzCore
CoreText
ImageIO
WebKit
AVFoundation
AudioToolbox
CoreMedia
VideoToolbox
Photos
AssetsLibrary
CoreLocation
AddressBook
AddressBookUI
Contacts
ContactsUI
MessageUI
SafariServices
StoreKit
UserNotifications

// Create the multilingual App name
LBWhaleAppConfigMultilingual *appName = [[LBWhaleAppConfigMultilingual alloc] initWithEn:@"My Trading App"
    zhCN:@"我的交易应用"
    zhHK:@"我的交易應用"];
// Create the configuration object
LBWhaleAppConfig *config = [[LBWhaleAppConfig alloc] initAppKey:@"LB_app_key"
    appSecret:@"LB_app_secret"
    appId:@"LB_app_id"
    appName:appName
    defaultAccountChannel:@"your_account_channel"
    webDomainPrefix:@"your_domain_prefix"
    token:@"user_access_token"
    refreshToken:@"user_refresh_token"
    delegate:self
    extraCustomConfig:nil];
// Set the theme, language, and other UI options (optional)
config.theme = LBWhaleAppConfigThemeAuto;
config.language = LBWhaleAppConfigLanguageEn;
config.priceColorType = LBWhaleAppConfigPriceColorFollowUserSetting;
config.env = LBWhaleAppConfigEnvProd;
// Set the SDK page enter / exit delegate (optional)
config.sdkUIDelegate = self;
// Start the SDK
[LBWhaleApp startWithConfig:config];

#pragma mark - LBWhaleAppDelegate

/// 1. SDK started successfully
///
/// When: fired once the SDK's internal initialization completes after [LBWhaleApp startWithConfig:] is called. Fires only once.
/// Handling:
///   - Log the successful startup for troubleshooting
///   - Run business logic that depends on the SDK being ready (for example, opening the market page or showing the trading entry point)
- (void)lbWhaleAppDidFinishLaunching {
    NSLog(@"SDK started successfully");
    // Example: show the trading entry point once the SDK is ready
    [self showTradeEntryIfNeeded];
}

/// 2. SDK startup failed
///
/// When: fired after [LBWhaleApp startWithConfig:] is called and the SDK hits an unrecoverable error during initialization.
///          Two sources:
///          a) Local validation failure — a required config parameter is missing, or the SDK was initialized twice (error.code == 400)
///          b) Network request failure — token renewal or an API request during startup returned an authentication error (error.code == 401 / 403)
///             In this case the SDK runs logoutAndDestroy automatically after the callback; Broker App does not need to destroy it manually
/// Parameters:
///   - error.domain              : always @"LBWhaleApp"
///   - error.code                : error code; see the "Error code reference" above
///   - error.localizedDescription : human-readable error description, for example "appKey is missing, please supply it."
/// Handling:
///   - code == 400 : an integration problem; check every required LBWhaleAppConfig field, correct it, and start again
///   - code == 401 / 403 : an authentication problem; the SDK already destroyed itself, so Broker App only needs to guide the Client back to sign-in
///   - In every case, log the error and report it to monitoring
- (void)lbWhaleAppStartFailedWithError:(NSError *)error {
    NSLog(@"SDK startup failed, code: %ld, msg: %@", (long)error.code, error.localizedDescription);
    [MyErrorTracker trackError:error];

    if (error.code == 400) {
        // Configuration error: tell the developer to check the parameters
        NSLog(@"Please check the LBWhaleAppConfig configuration");
    } else {
        // Authentication error: the SDK already destroyed itself; guide the Client back to sign-in
        [self redirectToLoginPage];
    }
}

/// 3. Automatic token renewal notification
///
/// When: the SDK detects internally that the token is about to expire or has expired and runs the renewal flow automatically.
///          After a successful renewal it notifies Broker App through this callback; token validity and subsequent renewal stay managed by WhaleAppSDK.
/// Parameters:
///   - token : the new token string after renewal (non-empty), provided only so the project can observe the state when it genuinely needs to.
/// Handling:
///   - Broker App does not need to call check token or implement refresh-token renewal itself
///   - Do not maintain a second token-refresh state alongside WhaleAppSDK
- (void)lbWhaleAppTokenDidChange:(NSString *)token {
    NSLog(@"token renewed");
    // WhaleAppSDK already completed the renewal internally; Broker App normally does not need to handle the new token
}

/// 4. SDK runtime error
///
/// When: fired when the SDK hits an exception during operation after startup has completed (status is LBWhaleAppStatusStarted).
///          Startup-phase errors do not go through this callback; they go through lbWhaleAppStartFailedWithError:.
///          Typical sources:
///          a) A network request returned an authentication error, which the SDK maps uniformly to error.code == 401
///          b) Automatic token renewal failed and the server returned one of the authentication error codes above
/// Parameters:
///   - error.domain              : always @"LBWhaleApp"
///   - error.code                : error code. Currently every runtime callback error code is 401 (authentication invalidated)
///   - error.localizedDescription : the error description returned by the server
/// Handling:
///   - code == 401 : the Client was signed out by a sign-in from another location. [LBWhaleApp logoutAndDestroy] must be called
///                   to destroy the SDK, and the Client must be guided back to sign-in
- (void)lbWhaleAppDidRunInError:(NSError *)error {
    if (error.code == 401) {
        // Authentication invalidated: destroy the SDK and navigate to the sign-in page
        [LBWhaleApp logoutAndDestroy];
        [self redirectToLoginPage];
    }
}

/// 5. The SDK asks Broker App to open a URL
///
/// When: fired when the SDK needs to open a URL it cannot handle itself. Two scenarios:
///          a) Broker App opened an SDK page through an SDK API, and that page contains a link the SDK cannot resolve
///          b) The SDK displayed server-driven content (a banner or announcement, for example), and the target URL after the tap is not in the SDK route table
/// Parameters:
///   - openUrl : the complete URL string to open. It may be an HTTP link, a deeplink, or a custom scheme
/// Handling:
///   - Open the URL with Broker App's own router
///   - For an HTTP link, choose either an in-app browser or the external browser
///   - For an unrecognized URL, log it to help with troubleshooting
/// Note: if lbWhaleAppSDKCanOpenURL: is implemented, this method is only called after it returns YES
- (void)lbWhaleAppSDKDidRequestOpenURL:(NSString *)openUrl {
    NSLog(@"The SDK requests opening URL: %@", openUrl);
    // Example: hand it to the Broker App router
    [MyAppRouter openURL:openUrl];
}

/// 6. The SDK asks Broker App whether it can open a URL
///
/// When: when the SDK encounters a URL it cannot resolve, it first asks Broker App through this method whether it can handle it.
///          This method is called before lbWhaleAppSDKDidRequestOpenURL: as a pre-check.
/// Parameters:
///   - url : the URL string to check
/// Returns:
///   - YES : Broker App can handle this URL; the SDK will then call lbWhaleAppSDKDidRequestOpenURL: to request opening it
///   - NO  : Broker App cannot handle it either; the SDK decides what to do next (ignore it or notify the Client, for example)
/// Note:
///   - If this method is not implemented, the SDK assumes Broker App does not support opening the URL
///   - This method may be called several times in quick succession, so avoid expensive work in the implementation
- (BOOL)lbWhaleAppSDKCanOpenURL:(NSString *)url {
    // Example: check whether the Broker App route table registered this URL
    return [MyAppRouter canOpenURL:url];
}

/// 7. The SDK is about to be destroyed
///
/// When: fired when the SDK begins its teardown flow after [LBWhaleApp logoutAndDestroy] is called or a 401 error occurs
///          internally (SDK resources have not been fully released at this point).
/// Note:
///   - Finish any required data or state persistence before the SDK is destroyed. After teardown, pages close immediately and the instance is released right away
- (void)lbWhaleAppWillDestroy {
    NSLog(@"The SDK is about to be destroyed");
    // Persist data and reset state
    [self storeAndReset];
}

/// 8. Fallback for failed automatic renewal
///
/// Under normal operation the SDK completes token validation and renewal automatically. This fires only when neither token nor refresh_token can be renewed.
/// The default behavior should return nil to end retrying, after which lbWhaleAppDidRunInError: destroys the SDK and returns Broker App to the logged-out state.
/// Only return new credentials when the project has explicitly agreed on a separate way for Broker to obtain a completely new Client credential pair.
- (void)lbWhaleAppRefreshTokenExpiredWithResolver:(void(^)(NSString *token, NSString *refreshToken))resolveCompleted {
    resolveCompleted(nil, nil);
}

config.sdkUIDelegate = self;

- (void)lbWhaleAppEnterSdkPage {
    // The number of SDK pages went from 0 to 1
}

- (void)lbWhaleAppExitSdkPage {
    // The number of SDK pages went from 1 to 0
}

// Simple page navigation
[LBWhaleApp pushURL:@"lb://page/main"]; // Home
[LBWhaleApp presentURL:@"lb://page/discovery/search-stocks"]; // Search

// Page navigation with parameters
NSDictionary *params = @{
    @"id": @"ST/US/AAPL"
};

[LBWhaleApp pushURL:@"lb://page/stock/detail"
         parameters:params
          completed:^(BOOL isSuccessed, NSError * _Nullable error) {
    if (isSuccessed) {
        NSLog(@"Page navigation succeeded");
    } else {
        NSLog(@"Page navigation failed: %@", error.localizedDescription);
    }
}];

[LBWhaleApp presentURL:@"lb://page/account/settings" parameters:nil completed:^(BOOL isSuccessed, NSError * _Nullable error) {
    if (!isSuccessed) {
        NSLog(@"Page navigation failed: %@", error.localizedDescription);
    }
}];

LBWhaleApp.config.theme = LBWhaleAppConfigThemeDark;

LBWhaleApp.config.language = LBWhaleAppConfigLanguageZhCN;

LBWhaleApp.config.priceColorType = LBWhaleAppConfigPriceColorRedUpGreenDown;

[LBWhaleApp logoutAndDestroy];

// The UIInterfaceOrientationMask the SDK requires. A return value of 0 means the current page is not an SDK page, and Broker App decides the supported orientation
+ (NSUInteger)requiredAppInterfaceOrientationMask;

- (UIInterfaceOrientationMask)application:(UIApplication *)application supportedInterfaceOrientationsForWindow:(UIWindow *)window {
    NSUInteger mask = [LBWhaleApp requiredAppInterfaceOrientationMask];
    if (mask > 0) {
        return mask;
    }
    return UIInterfaceOrientationMaskPortrait;
}

// Start the push service (it does not depend on the SDK and can be started independently; doing so at App launch is recommended)
- (void)setupAPNs {
    // Start push notifications
    [LBWhaleApp.pushService startWithKey:@"push key" andSecret:@"push secret" andCompleted:^(NSError * _Nullable error) {
        if (error) {
            NSLog(@"push service failed to start: %@", error.localizedDescription);
        }
    }];
//    Run other logic, such as requesting notification permission...
//    UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
//    center.delegate = self;
//    [center requestAuthorizationWithOptions:(UNAuthorizationOptionAlert | UNAuthorizationOptionSound | UNAuthorizationOptionBadge)
//                          completionHandler:^(BOOL granted, NSError * _Nullable error) {
//        dispatch_async(dispatch_get_main_queue(), ^{
//            if (granted) {
//                [[UIApplication sharedApplication] registerForRemoteNotifications];
//            }
//            NSLog(@"push permission status: %@", granted ? @"granted" : @"denied");
//        });
//    }];
}

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [LBWhaleApp.pushService updateDeviceToken:deviceToken disableMultiDevices:YES callback:^(NSError * _Nullable error) {
        if (error) {
            NSLog(@"update DeviceToken failed: %@", error.localizedDescription);
        }
    }];
}

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Initializing the push service first thing after launch is recommended
    [self setupAPNs];
    NSError *error = [LBWhaleApp.pushService handleLaunchOptions:launchOptions];
    if (error.code == NotificationErrorNotStarted) {
        // The SDK has not started
        // Start the SDK, then let it process this notification. An interstitial page or loading animation can cover the wait.
    } else if (error.code == NotificationErrorNonSDK) {
        // Not an SDK notification; Broker App handles it
    }
    return YES;
}

// Delegate method used while the App is in the foreground
- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler {
    // Give the notification to the SDK first; it returns an error when it cannot handle it
    NSError *error = [LBWhaleApp.pushService handleSystemDelegateUserNotificationCenter:center willPresentNotification:notification];
    if (!error) {
        // The SDK handled it; Broker App should not also show the system notification
        completionHandler(UNNotificationPresentationOptionNone);
        return;
    }
    if (error.code == NotificationErrorNotStarted) {
        // The SDK has not started
        // Consider starting the SDK and letting it process this notification afterwards
    } else if (error.code == NotificationErrorNonSDK) {
        // Not an SDK notification; Broker App handles it
    }
}

// Delegate method used while the App is in the background
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)(void))completionHandler {
    NSError *error = [LBWhaleApp.pushService handleSystemDelegateUserNotificationCenter:center didReceiveNotificationResponse:response];
    if (!error) {
        // The SDK handled it
        completionHandler();
        return;
    }
    if (error.code == NotificationErrorNotStarted) {
        // The SDK has not started
        // Consider starting the SDK and letting it process this notification afterwards
    } else if (error.code == NotificationErrorNonSDK) {
        // Not an SDK notification; Broker App handles it
    }
}

NSDictionary *userInfo = @{
    @"title": @"message title",
    @"body": @"message summary",
    // Pass through the user_info field content from the Whale message
    @"user_info": @{
        @"t": @"xx",
        @"tn": @"xx",
        @"id": @"xx",
        // Whale push identifier; the SDK uses this field to decide whether it handles the message itself
        @"lb_push_from": @"xx",
        @"link": @"navigation link",
        @"json": @"business JSON string"
    }
};

if ([LBWhaleAppPushService checkIsLBNotificationWithUserInfo:userInfo]) {
    // Hand it to the SDK (see steps 2 and 3 below)
} else {
    // Not a Whale message; Broker App handles it
}

NSDictionary *customNotification = @{
    @"title": @"message title",
    @"body": @"message summary",
    @"user_info": @{
        @"t": @"xx",
        @"tn": @"xx",
        @"id": @"xx",
        // Whale push identifier
        @"lb_push_from": @"xx",
        // The SDK uses this link to trigger page navigation in specific business scenarios.
        // When the link cannot be resolved, it is forwarded to Broker App through -lbWhaleAppSDKDidRequestOpenURL:.
        // When Broker App implements routerHandler, every navigation goes through routerHandler and the SDK no longer resolves routes itself.
        @"link": @"navigation link",
        @"json": @"business JSON string"
    }
};

NSError *error = [LBWhaleApp.pushService sdkShowTipWithNotificationInfo:customNotification routerHandler:^(NSString * _Nonnull routerUrl) {
    // 1. Run any custom Broker App work needed before navigating
    // 2. Trigger the route navigation manually
    [LBWhaleApp pushURL:routerUrl];
}];
if (!error) {
    // The SDK handled the notification
} else {
    // Handle the error or let Broker App handle the notification
}

// Handle the push tap with a custom-assembled parameter dictionary
NSDictionary *customResponse = @{
    // ...pass through the server message dictionary
};

NSError *error = [LBWhaleApp.pushService handleNotificationClickWithInfo:customResponse routerHandler:^(NSString * _Nonnull routerUrl) {
    // ... custom App work
    // Open the route
    [LBWhaleApp pushURL:routerUrl];
}];
if (!error) {
    // The SDK handled the notification response
} else {
    // Handle the error or let Broker App handle the notification
}

/// SDK runtime status
typedef enum : NSUInteger {
    LBWhaleAppStatusNotStarted,    ///< Not started
    LBWhaleAppStatusStarting,      ///< Starting
    LBWhaleAppStatusStarted,       ///< Started
    LBWhaleAppStatusIsDestroying,  ///< Being destroyed
} LBWhaleAppStatus;

@interface LBWhaleApp : NSObject

/// SDK version
@property (class, nonatomic, copy, readonly) NSString *sdkVersion;
/// Push service instance, used to manage notification registration and handling
@property (class, nonatomic, strong, readonly) LBWhaleAppPushService *pushService;
/// The configuration the SDK was started with
@property (nonatomic, strong, readonly, class) LBWhaleAppConfig *config;
/// The SDK's current runtime status
@property (nonatomic, assign, readonly, class) LBWhaleAppStatus sdkStatus;

/// Pass in the configuration and start the SDK
+ (void)startWithConfig:(LBWhaleAppConfig *)config;
/// Sign the Client out and release the SDK
+ (void)logoutAndDestroy;

/// Open the specified screen
+ (void)pushURL:(NSString *)url;
/// Open the specified screen modally
+ (void)presentURL:(NSString *)url;

/// Open the specified screen and control the transition animation
+ (void)pushURL:(NSString *)url animated:(BOOL)animated;
/// Open the specified screen modally and control the transition animation
+ (void)presentURL:(NSString *)url animated:(BOOL)animated;

/// Open the specified screen (with parameters and a result callback)
/// completed: the navigation result callback; when isSuccessed is NO, error carries the reason
+ (void)pushURL:(NSString *)url
     parameters:(NSDictionary * _Nullable)parameters
      completed:(void (^ _Nullable)(BOOL isSuccessed, NSError *_Nullable error))completed;
/// Open the specified screen modally (with parameters and a result callback)
+ (void)presentURL:(NSString *)url
        parameters:(NSDictionary * _Nullable)parameters
         completed:(void (^ _Nullable)(BOOL isSuccessed, NSError *_Nullable error))completed;

/// Open the specified screen (with parameters, animation setting, and a result callback)
+ (void)pushURL:(NSString *)url
     parameters:(NSDictionary * _Nullable)parameters
       animated:(BOOL)animated
      completed:(void (^ _Nullable)(BOOL isSuccessed, NSError *_Nullable error))completed;
/// Open the specified screen modally (with parameters, animation setting, and a result callback)
+ (void)presentURL:(NSString *)url
        parameters:(NSDictionary * _Nullable)parameters
          animated:(BOOL)animated
         completed:(void (^ _Nullable)(BOOL isSuccessed, NSError *_Nullable error))completed;

/// The UIInterfaceOrientationMask the SDK requires
+ (NSUInteger)requiredAppInterfaceOrientationMask;

@end

@interface LBWhaleAppConfig : NSObject

/// Initialize the SDK configuration
/// - appKey / appSecret / appId / defaultAccountChannel / webDomainPrefix — supplied by Whale
/// - token / refreshToken — Client identity credentials generated by Whale's server; after the SDK renews them automatically at runtime, the new token arrives through the delegate
/// - delegate — the SDK event-callback delegate; may be nil
/// - extraCustomConfig — optional advanced configuration; see the "Custom parameters" section
- (instancetype)initAppKey:(NSString *)appKey
                  appSecret:(NSString *)appSecret
                      appId:(NSString *)appId
                    appName:(LBWhaleAppConfigMultilingual *)appName
      defaultAccountChannel:(NSString *)defaultAccountChannel
            webDomainPrefix:(NSString *)webDomainPrefix
                      token:(NSString *)token
               refreshToken:(NSString *)refreshToken
                   delegate:(nullable id<LBWhaleAppDelegate>)delegate
          extraCustomConfig:(nullable NSDictionary *)extraCustomConfig;

/// app key, supplied by Whale
@property (nonatomic, copy, readonly) NSString *appKey;
/// app secret, supplied by Whale
@property (nonatomic, copy, readonly) NSString *appSecret;
/// app id, supplied by Whale
@property (nonatomic, copy, readonly) NSString *appId;
/// Multilingual App name
@property (nonatomic, strong, readonly) LBWhaleAppConfigMultilingual *appName;
/// Default account channel, supplied by Whale
@property (nonatomic, copy, readonly) NSString *defaultAccountChannel;
/// Web domain prefix, supplied by Whale
@property (nonatomic, copy, readonly) NSString *webDomainPrefix;
/// Client identity token, generated dynamically and supplied by Whale's server
@property (nonatomic, copy, readonly) NSString *token;
/// Client identity refresh token, generated dynamically and supplied by Whale's server
@property (nonatomic, copy, readonly) NSString *refreshToken;
/// SDK event-callback delegate
@property (nonatomic, weak, readonly, nullable) id<LBWhaleAppDelegate> delegate;
/// SDK page enter and exit callback delegate
@property (nonatomic, weak, nullable) id<LBWhaleAppUIDelegate> sdkUIDelegate;
/// Additional custom configuration; see "Custom parameters" for the available keys
@property (nonatomic, copy, readonly, nullable) NSDictionary *extraCustomConfig;

/// Theme; defaults to LBWhaleAppConfigThemeAuto
@property (nonatomic, assign) LBWhaleAppConfigTheme theme;
/// Display language; defaults to LBWhaleAppConfigLanguageEn
@property (nonatomic, assign) LBWhaleAppConfigLanguage language;
/// Price up/down color configuration (managed internally by the SDK by default)
@property (nonatomic, assign) LBWhaleAppConfigPriceColor priceColorType;
/// Runtime environment; defaults to production and normally does not need changing
@property (nonatomic, assign) LBWhaleAppConfigEnv env;

@end

@{
    // Disable IDFA access and the ATT prompt (not disabled by default)
    LBAPPSDKConfigKeyDisableIDFA: @YES,
    // Disable the system debug-information egg (not disabled by default)
    LBAPPSDKConfigDebugEggDisable: @YES,
    // Custom colors
    LBAPPSDKConfigKeyColor: @{
        // SDK notification tip color configuration
        LBAPPSDKConfigKeyPushTipView: @{
            // Order filled
            LBAPPSDKConfigKeyPTVOrderCompleted: @{
                LBAPPSDKConfigKeyColorLight: @"#777C7D",
                LBAPPSDKConfigKeyColorDark: @"#2A3233"
            },
            // Order failed
            LBAPPSDKConfigKeyPTVOrderFailed: @{
                LBAPPSDKConfigKeyColorLight: @"#777C7D",
                LBAPPSDKConfigKeyColorDark: @"#2A3233"
            },
            // Trading restricted
            LBAPPSDKConfigKeyPTVOrderLimit: @{
                LBAPPSDKConfigKeyColorLight: @"#777C7D",
                LBAPPSDKConfigKeyColorDark: @"#2A3233"
            },
            // Other
            LBAPPSDKConfigKeyPTVOther: @{
                LBAPPSDKConfigKeyColorLight: @"#777C7D",
                LBAPPSDKConfigKeyColorDark: @"#2A3233"
            },
            // Default background color (used when a state-specific color is not configured)
            LBAPPSDKConfigKeyPTVDefaultBackground: @{
                LBAPPSDKConfigKeyColorLight: @"#FFFFFF"
            },
            // Default title text color
            LBAPPSDKConfigKeyPTVDefaultTitle: @{
                LBAPPSDKConfigKeyColorLight: @"#333333"
            },
            // Default body text color
            LBAPPSDKConfigKeyPTVDefaultContent: @{
                LBAPPSDKConfigKeyColorLight: @"#333333"
            },
            // Default icon color
            LBAPPSDKConfigKeyPTVDefaultIcon: @{
                LBAPPSDKConfigKeyColorLight: @"#333333"
            },
            // Title, body, and icon colors for the trading-restricted tip
            LBAPPSDKConfigKeyPTVLimitTitleColor: @{
                LBAPPSDKConfigKeyColorLight: @"#333333"
            },
            LBAPPSDKConfigKeyPTVLimitContentColor: @{
                LBAPPSDKConfigKeyColorLight: @"#333333"
            },
            LBAPPSDKConfigKeyPTVLimitIconColor: @{
                LBAPPSDKConfigKeyColorLight: @"#333333"
            },

        }
    },
    // Custom device ID string
    LBAPPSDKConfigKeyDeviceId: @"CUSTOM DEVICEID STRING",
    // Custom cache directory; defaults to {NSLibraryDirectory}/LBWhaleApp when not specified
    LBAPPSDKConfigKeyFileDirectory: @"CUSTOM FILE DIRECTORY",
    // Timeout of the token-refresh fallback callback, in seconds; defaults to 30
    LBAPPSDKConfigKeyRefreshTokenResolverTimeout: @30,
    // Custom font configuration
    LBAPPSDKConfigKeyFontCrypto: [[UIFontDescriptor alloc] fontDescriptorWithName:@"YourCustomFont-Crypto" size:0],
    LBAPPSDKConfigKeyFontMonospaced: [[UIFontDescriptor alloc] fontDescriptorWithName:@"YourCustomFont-Monospaced" size:0],
    LBAPPSDKConfigKeyFontMonospacedBold: [[UIFontDescriptor alloc] fontDescriptorWithName:@"YourMonospaceFont-MonospacedBold" size:0]
}

// Create the font descriptors
UIFontDescriptor *customMonospacedFont = [UIFontDescriptor fontDescriptorWithName:@"YourCustomFont-Monospaced" size:0];
UIFontDescriptor *customMonospacedBoldFont = [UIFontDescriptor fontDescriptorWithName:@"YourMonospaceFont-MonospacedBold" size:0];
UIFontDescriptor *customCrypto = [UIFontDescriptor fontDescriptorWithName:@"YourCryptoFont" size:0];
NSDictionary *extraConfig = @{
    // Replace the LBSDK monospaced fonts
    LBAPPSDKConfigKeyFontMonospaced: customMonospacedFont,
    LBAPPSDKConfigKeyFontMonospacedBold: customMonospacedBoldFont,
    // Replace the pixel font
    LBAPPSDKConfigKeyFontCrypto: customCrypto
};

LBWhaleAppConfig *config = [[LBWhaleAppConfig alloc] initAppKey:@"YOUR_APP_KEY"
    appSecret:@"YOUR_APP_SECRET"
    appId:@"YOUR_APP_ID"
    appName:appName
    defaultAccountChannel:@"your_channel"
    webDomainPrefix:@"your_prefix"
    token:@"token"
    refreshToken:@"refresh_token"
    delegate:self
    extraCustomConfig:extraConfig];

@interface LBWhaleAppConfigMultilingual : NSObject

@property (nonatomic, copy, readonly) NSString *en;
@property (nonatomic, copy, readonly, nullable) NSString *zhCN;
@property (nonatomic, copy, readonly, nullable) NSString *zhHK;
/// Returns the text matching the current language
@property (nonatomic, readonly) NSString *currentLanguageText;

- (instancetype)initWithEn:(NSString *)en
                      zhCN:(nullable NSString *)zhCN
                      zhHK:(nullable NSString *)zhHK;

@end

/// Price up/down color display mode
typedef NS_ENUM(NSInteger, LBWhaleAppConfigPriceColor) {
    LBWhaleAppConfigPriceColorFollowUserSetting,  ///< Follow the Client's manual setting inside the SDK (default)
    LBWhaleAppConfigPriceColorRedUpGreenDown,     ///< Force red-up, green-down mode
    LBWhaleAppConfigPriceColorGreenUpRedDown      ///< Force green-up, red-down mode
};

/// Theme
typedef NS_ENUM(NSInteger, LBWhaleAppConfigTheme) {
    LBWhaleAppConfigThemeAuto,   ///< Follow the system automatically
    LBWhaleAppConfigThemeLight,  ///< Light
    LBWhaleAppConfigThemeDark,   ///< Dark
};

/// Language
typedef NS_ENUM(NSInteger, LBWhaleAppConfigLanguage) {
    LBWhaleAppConfigLanguageEn,    ///< English
    LBWhaleAppConfigLanguageZhCN,  ///< Simplified Chinese
    LBWhaleAppConfigLanguageZhHK,  ///< Traditional Chinese
};

typedef NS_ENUM(NSInteger, LBWhaleAppConfigEnv) {
    LBWhaleAppConfigEnvProd = 0,  ///< Production environment (default)
    LBWhaleAppConfigEnvSit,       ///< SIT environment
    LBWhaleAppConfigEnvTest,      ///< Test environment
};

@protocol LBWhaleAppDelegate <NSObject>

@optional

/// Notification callback after the SDK renews the token automatically; renewal and validity stay managed internally by WhaleAppSDK
/// - Parameter token: the new token after renewal; Broker App normally does not need to store it or keep refreshing
- (void)lbWhaleAppTokenDidChange:(nonnull NSString *)token;

/// The SDK raised an error at runtime
/// - Parameter error: the error information
- (void)lbWhaleAppDidRunInError:(nonnull NSError *)error;

/// The SDK failed to start
/// - Parameter error: the error callback
- (void)lbWhaleAppStartFailedWithError:(nonnull NSError *)error;

/// The SDK started successfully
- (void)lbWhaleAppDidFinishLaunching;

/// The SDK asks Broker App to open a URL it cannot handle itself (covers both Broker App using the SDK to open an SDK page and the SDK opening a server-configured URL internally)
/// - Parameter openUrl: the URL link
- (void)lbWhaleAppSDKDidRequestOpenURL:(NSString *)openUrl;

/// The SDK asks Broker App whether it supports opening a URL
/// Fired when the SDK cannot resolve the URL; Broker App can return YES here to take over the subsequent open action
/// - Parameter url: the URL to check
/// - Returns: whether Broker App supports opening this URL
- (BOOL)lbWhaleAppSDKCanOpenURL:(NSString *)url;

/// The SDK is about to be destroyed
- (void)lbWhaleAppWillDestroy;

/// Fallback callback after the SDK's built-in token refresh fails; resolveCompleted must be called before the timeout
- (void)lbWhaleAppRefreshTokenExpiredWithResolver:(void(^)(NSString *token, NSString *refreshToken))resolveCompleted;

@end

@protocol LBWhaleAppUIDelegate <NSObject>

/// Fired when the first SDK page opens
- (void)lbWhaleAppEnterSdkPage;

/// Fired when the last SDK page closes
- (void)lbWhaleAppExitSdkPage;

@end

///
/// - NotificationErrorNotStarted: error code raised when the SDK has not started
/// - NotificationErrorNonSDK: error code raised when the SDK cannot handle the notification type
/// - NotificationErrorPushStartFailed: error code raised when the SDK's notification push fails to start
///
typedef enum : NSInteger {
    NotificationErrorNotStarted    = 99990,  ///< The SDK has not started
    NotificationErrorNonSDK,                 ///< A notification type the SDK cannot handle
    NotificationErrorPushStartFailed,        ///< The push service failed to start (returned only by startWithKey:andSecret:andCompleted:)
} LBWhaleNotificationHandlingErrorCode;

@interface LBWhaleAppPushService : NSObject

/// Notification push key
@property (nonatomic, copy, readonly, nullable) NSString *pushAppKey;
/// Notification push secret
@property (nonatomic, copy, readonly, nullable) NSString *pushAppSecret;
/// APNs device token
@property (nonatomic, strong, readonly, nullable) NSData *deviceToken;
/// Push device ID
@property (nonatomic, copy, readonly, nullable) NSString *pushDeviceId;
/// Whether the push service registered successfully
@property (nonatomic, assign, readonly) BOOL isStarted;
/// Disable multi-device binding (single-device binding)
@property (nonatomic, assign, readonly) BOOL disableMultiDevices;

/// Whether the SDK can handle this notification push
+ (BOOL)checkIsLBNotificationWithUserInfo:(NSDictionary *)userInfo;

/// Start the push service
- (void)startWithKey:(NSString *)appPushKey
           andSecret:(NSString *)appPushSecret
        andCompleted:(void(^ _Nullable)(NSError *_Nullable error))completed;

/// Report the bound device's deviceToken
- (void)updateDeviceToken:(NSData *)deviceToken
      disableMultiDevices:(BOOL)disableMultiDevices
                 callback:(void(^ _Nullable)(NSError *_Nullable error))callback;

/// System push forwarding (using the system UNNotification objects)
- (NSError *_Nullable)handleLaunchOptions:(NSDictionary *)launchOptions;
- (NSError *_Nullable)handleSystemDelegateUserNotificationCenter:(UNUserNotificationCenter *)center
                                         willPresentNotification:(UNNotification *)notification;
- (NSError *_Nullable)handleSystemDelegateUserNotificationCenter:(UNUserNotificationCenter *)center
                                 didReceiveNotificationResponse:(UNNotificationResponse *)response;

/// Custom push handling (using the server message dictionary)
- (NSError *_Nullable)sdkShowTipWithNotificationInfo:(NSDictionary *)notification
                                       routerHandler:(void (^_Nullable)(NSString *routerUrl))routerHandler;
- (NSError *_Nullable)handleNotificationClickWithInfo:(NSDictionary *)response
                                        routerHandler:(void (^_Nullable)(NSString *routerUrl))routerHandler;

@end

spec.dependency 'RangersAPM/Crash', '>= 5.1.6'
spec.dependency 'RangersAPM/APMLog', '>= 5.1.6'
spec.dependency 'RangersAPM/CN', '>= 5.1.6'
spec.dependency 'RangersAPM/WatchDog', '>= 5.1.6'
spec.dependency 'RangersAPM/CloudCommand', '>= 5.1.6'
spec.dependency 'AlicloudPush', '>= 3.2.2'
spec.dependency 'IQKeyboardManager', '>= 6.5.9'