//
//  CrashSight.h
//
//  Version: 4.3.8(1095)
//
//  Copyright (c) 2017年 
//

#import <Foundation/Foundation.h>

#import "CrashSightConfig.h"
#import "CrashSightLog.h"

#define GCLOUD_VERSION_CRASHSIGHT  "GCLOUD_VERSION_CRASHSIGHT_4.3.8.1095.sgprod"



typedef NS_OPTIONS(uint32_t, CSExceptionReprotOption) {
    CSExceptionReprotOptionNone            = 0,
    CSExceptionReprotOptionSystemLog = 1 << 0,
    CSExceptionReprotOptionCustomLog = 1 << 1,
    CSExceptionReprotOptionKV = 1 << 2,
    CSExceptionReprotOptionCallback = 1 << 3,
    CSExceptionReprotOptionDumpStack = 1 << 4,
};

@interface CrashSight : NSObject

/**
 *  初始化CrashSight,使用默认CrashSightConfigs
 *
 *  @param appId 注册CrashSight分配的应用唯一标识
 */
+ (void)startWithAppId:(NSString * CS_NULLABLE)appId;

/**
 *  使用指定配置初始化CrashSight
 *
 *  @param appId 注册CrashSight分配的应用唯一标识
 *  @param config 传入配置的 CrashSightConfig
 */
+ (void)startWithAppId:(NSString * CS_NULLABLE)appId
                config:(CrashSightConfig * CS_NULLABLE)config;

/**
 *  使用指定配置初始化CrashSight
 *
 *  @param appId 注册CrashSight分配的应用唯一标识
 *  @param development 是否开发设备
 *  @param config 传入配置的 CrashSightConfig
 */
+ (void)startWithAppId:(NSString * CS_NULLABLE)appId
     developmentDevice:(BOOL)development
                config:(CrashSightConfig * CS_NULLABLE)config;

/**
 *  设置用户标识
 *
 *  @param userId 用户标识
 */
+ (void)setUserIdentifier:(NSString *)userId;

/**
 *  更新版本信息
 *
 *  @param version 应用版本信息
 */
+ (void)updateAppVersion:(NSString *)version;

/**
 *  设置关键数据，随崩溃信息上报
 *
 *  @param value KEY
 *  @param key VALUE
 */
+ (void)setUserValue:(NSString *)value
              forKey:(NSString *)key;

/**
 *  获取USER ID
 *
 *  @return USER ID
 */
+ (NSString *)crashSightUserIdentifier;

/**
 *  获取关键数据
 *
 *  @return 关键数据
 */
+ (NSDictionary * CS_NULLABLE)allUserValues;


+ (void)setUserSceneTag:(NSString *)userSceneTag isUpload:(bool)upload;


+ (NSString *)currentUserSceneTag;

/**
 *  获取设备ID
 *
 *  @return 设备ID
 */
+ (NSString *)crashSightDeviceId;

/**
 *  上报自定义Objective-C异常
 *
 *  @param exception 异常信息
 */
+ (void)reportException:(NSException *)exception;

/**
 *  上报错误
 *
 *  @param error 错误信息
 */
+ (void)reportError:(NSError *)error;

/**
 *    @brief 上报自定义错误
 *
 *    @param category    类型(Cocoa=3,CSharp=4,JS=5,Lua=6)
 *    @param aName       名称
 *    @param aReason     错误原因
 *    @param aStackArray 堆栈
 *    @param info        附加数据
 *    @param terminate   上报后是否退出应用进程
 */
+ (void)reportExceptionWithCategory:(NSUInteger)category
                               name:(NSString *)aName
                             reason:(NSString *)aReason
                          callStack:(NSArray *)aStackArray
                          extraInfo:(NSDictionary *)info
                       terminateApp:(BOOL)terminate
                       dumpDataType:(int) dumpDataType
                errorAttachmentPath:(NSString *)errorAttachmentPath;


/**
 *    @brief 上报自定义错误
 *
 *    @param category    类型(Cocoa=3,CSharp=4,JS=5,Lua=6)
 *    @param aName       名称
 *    @param aReason     错误原因
 *    @param aStackArray 堆栈
 *    @param info        附加数据
 *    @param terminate   上报后是否退出应用进程
 */
+ (void)reportExceptionWithCategory:(NSUInteger)category
                               name:(NSString *)aName
                             reason:(NSString *)aReason
                          callStack:(NSArray *)aStackArray
                          extraInfoJSONString:(NSString *)info
                       terminateApp:(BOOL)terminate
                       dumpDataType:(int) dumpDataType
                errorAttachmentPath:(NSString *)errorAttachmentPath;


+ (void) reportLogInfo:(NSString *)messageType message:(NSString *)message;


+ (void)reportJankWithName:(NSString *)name message:(NSString *)message stack:(NSArray *)stack extraInfo:(NSDictionary *)extraInfo  option:(CSExceptionReprotOption)option attachmentPath:(nullable NSString *)attachmentPath;

/**
 *  SDK 版本信息
 *
 *  @return SDK版本号
 */
+ (NSString *)sdkVersion;

/**
 *  APP 版本信息
 *
 *  @return SDK版本号
 */
+ (NSString *)appVersion;

/**
 *  App 是否发生了连续闪退
 *  如果 启动SDK 且 5秒内 闪退，且次数达到 3次 则判定为连续闪退
 *
 *  @return 是否连续闪退
 */
+ (BOOL)isAppCrashedOnStartUpExceedTheLimit;

/**
 *  关闭crashSight监控
 */
+ (void)closeCrashReport;

/**
 *  再次注册CrashSight对Crash监听
 */
+ (void)reregisterCrashHandler;

/**
 *  设置上报URL，可在初始化CrashSight后动态设置
 */
+ (void)setServerUrl:(NSString *)url;

/**
 *  设置上报附件的绝对路径
 */
+ (void)setAttachmentPath:(NSString *)path;

+ (int)getCrashThreadId;


+ (NSString *)crashSightSessionId;

+ (BOOL)isLastSessionCrash;

+ (NSString *)getLastSessionUserId;

+ (NSDictionary *)ccConifg;

+ (int)getExceptionType:(NSString *)name;

+ (void)setServerEnv:(NSString *)serverEnv;

+ (void)setEngineInfo:(NSString *)version buildConfig:(NSString *)buildConfig language:(NSString *)language locale:(NSString *)locale;

+ (void)enableDetailedPageTracing:(bool)enable;

+ (void)useSavedUserId:(bool)enable;

+ (void)reportStuckWithThreadIndex:(int)threadIndex
                         maxChecks:(int)maxChecks
                     checkInterval:(NSTimeInterval)checkInterval
                              name:(NSString *)name
                           message:(NSString *)message
                         extraInfo:(NSString *)extraInfo
                    dumpNativeType:(int)dumpNativeType
                        attachPath:(NSString *)attachPath;




/**
 *  内存接近上限回调类型。
 *
 *  @param footprint   触发时的进程 footprint（字节）
 *  @param memoryLimit 触发时使用的内存上限（字节）；采集模式下 = footprint + os_proc_available_memory()
 */
typedef void(^CSMemoryNearLimitCallback)(uint64_t footprint, uint64_t memoryLimit);

/**
 *  注册「内存接近上限」回调。
 *
 *  依赖 SDK 内部的 1s 内存采集 timer（云控 B28 OOM 检测开启 或 alloclogger 开启时启动）；
 *  回调在 timer 线程触发，避免在其中做耗时操作。
 *  memoryLimitBytes：-1 表示用采集上限（footprint + os_proc_available_memory()，仅 iOS 13+）；>= 0 表示直接使用该值作为上限。
 *  触发条件：(memoryLimit - 当前 footprint) < memoryThresholdBytes。
 *  限频：timeIntervalSeconds > 0 表示两次回调最小间隔秒数；为 0（或负数）时表示整个进程生命周期内只触发一次。
 *  传入 callback 为 nil 时停止后续回调；任意次调用都会重置内部计时与「只触发一次」状态。
 */
+ (void)setMemoryNearLimitCallback:(CSMemoryNearLimitCallback CS_NULLABLE)callback
              memoryThresholdBytes:(uint64_t)memoryThresholdBytes
                  memoryLimitBytes:(int64_t)memoryLimitBytes
               timeIntervalSeconds:(NSTimeInterval)timeIntervalSeconds;


// 必须在lua线程调用， 否则捕获lua堆栈时会崩溃
+ (void)setLuaState:(nonnull void*)lua;

+ (void)setLuaFuncGetglobal:(nonnull void *)getglobal getfield:(nonnull void *)getfield pushstring:(nonnull void *)pushstring pushinteger:(nonnull void *)pushinteger pcallk:(nonnull void *)pcallk tolstring:(nonnull void *)tolstring settop:(nonnull void *)settop;

@end
