// Copyright 2015-present 650 Industries. All rights reserved.
//
//  Keeps track of experience error state, including between reloads, so that we can
//  pass error recovery info to an experience which just reloaded.
//

#import "EXKernelService.h"

@protocol EXErrorRecoveryScopedModuleDelegate

- (void)setDeveloperInfo:(NSDictionary *)developerInfo forScopedModule:(id)scopedModule;

@end

@class EXKernelAppRecord;

@interface EXErrorRecoveryManager : NSObject
  <EXKernelService, EXErrorRecoveryScopedModuleDelegate>

/**
 *  Associate arbitrary developer info with this experience id. If the experience recovers from an
 *  error, we can pass this info to the new instance of the experience.
 */
- (void)setDeveloperInfo:(NSDictionary *)developerInfo forScopeKey:(NSString *)scopeKey;
- (NSDictionary *)developerInfoForScopeKey: (NSString *)scopeKey;

/**
 *  Associate an error with an experience id. This will never be cleared until the next
 *  call to `experienceFinishedLoadingWithId:`.
 */
- (void)setError: (NSError *)error forScopeKey:(NSString *)scopeKey;

/**
 *  Indicate that a JS bundle has successfully loaded for this experience.
 */
- (void)experienceFinishedLoadingWithScopeKey:(NSString *)scopeKey;

/**
 *  True if any bridge for this experience had an error, and has not successfully loaded
 *  since the error was reported.
 */
- (BOOL)scopeKeyIsRecoveringFromError:(NSString *)scopeKey;

/**
 *  True if this error object (by `isEqual:`) has been registered for any experience.
 */
- (BOOL)errorBelongsToExperience:(NSError *)error;

/**
 *  Returns any existing app record for this error. Since error state persists between reloads until cleared,
 *  it's possible that there is no app record for this error.
 */
- (EXKernelAppRecord *)appRecordForError: (NSError *)error;

/**
 *  Whether we want to auto-reload this experience if it encounters a fatal error.
 */
- (BOOL)experienceShouldReloadOnError:(NSString *)scopeKey;

/**
 *  Back off to a less aggressive autoreload buffer time.
 *  The longer the time, the longer a experience must wait before a fatal JS error triggers auto reload
 *  via `experienceShouldReloadOnError:`.
 */
- (void)increaseAutoReloadBuffer;

@end