//
//  ALPTBLinkPartnerSDK.h
//  ALPLinkPartnerSDK
//
//  Created by czp on 16/10/10.
//  Copyright © 2016年 czp. All rights reserved.
//

#import <Foundation/Foundation.h>
#import <UIKit/UIKit.h>
#import "ALPTBShopParam.h"
#import "ALPTBDetailParam.h"
#import "ALPTBURIParam.h"
#import "ALPJumpFailedStrategy.h"

#define ALPSDKVersion @"1.1.1.2"

typedef NS_ENUM(NSInteger, ALPOpenType) {
    ALPOpenTypeNative,          //跳转native打开
    ALPOpenTypeH5,              //H5打开
    ALPOpenTypeBrowser          //浏览器打开
};

typedef NS_ENUM(NSInteger, ALPConfigEnv) {
    ALPConfigEnvNone    = -1,//未定义环境
    ALPConfigEnvRelease = 0,//线上环境
    ALPConfigEnvDaily,       //测试环境
    ALPConfigEnvPreRelease,  //预发环境
};

typedef void(^ALPJumpBackBlock)(NSURL *_Nullable url, NSError *_Nullable error);

@interface ALPTBLinkPartnerSDK : NSObject

/**
 *  初始化SDK，必须初始化SDK不然后续跳转操作将报错
 *
 *  @param appKey 必传参数
 */
+ (void)initWithAppkey:(nonnull NSString *)appKey;

/**
 *  设置debug模式打开，会有log输出
 *
 *  @param on 是否打开
 */
+ (void)setDebugOn:(BOOL)on;

/**
 *  设置开发环境，默认线上环境
 *
 *  @param env 开发环境
 */
+ (void)setEnv:(ALPConfigEnv)env;

/**
 *  设置打开页面的类型
 *
 *  @param type 类型
 */
+ (void)setOpenType:(ALPOpenType)type;

/**
 *  是否支持deepLink，即打开xxx APP某个页面时，APP没有安装
 *  跳转AppStore下载APP，打开APP时，自动进入那个页面
 *  只在设置跳转失败去AppStore情况才支持，默认是支持DeepLink
 *
 *  @param isSupport 是否支持
 */
+ (void)setSupportDeepLink:(BOOL)isSupport;

/**
 *  设置业务追踪id，仅供二方使用，其他接入无需关心
 *
 *  @param ttid ttid
 */
+ (void)setTTID:(nonnull NSString *)ttid;

/**
 *  跳转到店铺页
 *
 *  @param param    店铺的配置参数
 *  @param strategy 跳转失败时处理策略，不传，返回错误信息
 *
 *  @return 错误信息
 */
+ (nullable ALPError *)jumpShop:(nonnull ALPTBShopParam *)param
                 failedStrategy:(nullable ALPJumpFailedStrategy *)strategy;

/**
 *  跳转到商品详情页
 *
 *  @param param    商品详情的配置参数
 *  @param strategy 跳转失败时处理策略，不传，返回错误信息
 *
 *  @return 错误信息
 */
+ (nullable ALPError *)jumpDetail:(nonnull ALPTBDetailParam *)param
                   failedStrategy:(nullable ALPJumpFailedStrategy *)strategy;

/**
 *  根据URI跳转到手淘，以webView的形式打开；
 *  跳转到接入AlibcFlowCustoms SDK的APP，相当于通用跳转（类似openURL：）
 *
 *  @param param    URI的配置参数
 *  @param strategy 跳转失败时处理策略，不传，返回错误信息
 *
 *  @return 错误信息
 */
+ (nullable ALPError *)jumpURI:(nonnull ALPTBURIParam *)param
                failedStrategy:(nullable ALPJumpFailedStrategy *)strategy;

/**
 *  通用跳转，param参数中的routeRule必传，匹配接入AlibcFlowCustoms SDK 中注册的插件执行，回跳时触发回调
 *
 *  @param param    URI的配置参数
 *  @param strategy 跳转失败时处理策略，不传，返回错误信息
 *  @param callback 触发插件执行，回跳时的回调。
 *  跳转去目标APP，切换回来，认为用户取消操作触发回调，返回错误信息
 *
 *  @return 错误信息
 */
+ (nullable ALPError *)jumpURI:(nonnull ALPTBURIParam *)param
                failedStrategy:(nullable ALPJumpFailedStrategy *)strategy
              jumpBackCallback:(nullable ALPJumpBackBlock)callback;

/**
 *  跳转失败，是否支持默认打开手淘
 *
 *  @param isSupport 是否支持
 */
+ (void)setSupportJumpFailedOpenTaobao:(BOOL)isSupport;

/**
 *  处理linkPartner返回结果，需要在AppDelegate的[application:(UIApplication)app handleOpenURL:(NSURL*)url]中添加
 *
 *  @param url               跳入打开APP的URL
 *  @param sourceApplication 来源APP sourceApplication
 *
 *  @return  是否处理该url
 */
+ (BOOL)handleOpenURL:(nonnull NSURL *)url sourceApplication:(nullable NSString *)sourceApplication;

/**
 *  检查是否能打开指定app，传入是linkKey，比如：@"taobao"，指手淘
 *
 *  @param linkkey linkkey
 *
 *  @return 是否能打开APP
 */
+ (BOOL)canOpenApp:(nonnull NSString *)linkkey;

@end