/*
 * Copyright (c) Meta Platforms, Inc. and affiliates.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 */

#import <Foundation/Foundation.h>

#import <FBControlCore/FBFuture.h>

NS_ASSUME_NONNULL_BEGIN

@class FBCrashLogInfo;
@class FBCrashLogStore;

/**
 An interface for being notified of crash logs for a given process identifier.
 */
@interface FBCrashLogNotifier : NSObject

#pragma mark Properties

/**
 The Shared Notifier.
 */
@property (nonatomic, strong, readonly, class) FBCrashLogNotifier *sharedInstance;

/**
 The store of crash logs.
 */
@property (nonatomic, strong, readonly) FBCrashLogStore *store;

#pragma mark Notifications

/**
 Starts listening for crash logs.

 @param onlyNew YES if you only want to ingest crash logs from now, NO to ingest from the beginning of time.
 @return success.
 */
- (BOOL)startListening:(BOOL)onlyNew;

/**
 Obtains the next crash log, for a given predicate.

 @param predicate the predicate to wait for.
 @return a Future that resolves with the next crash log matching the predicate.
 */
- (FBFuture<FBCrashLogInfo *> *)nextCrashLogForPredicate:(NSPredicate *)predicate;

@end

NS_ASSUME_NONNULL_END