// Copyright 2004-present Facebook. All Rights Reserved.

#import <Foundation/Foundation.h>

@class RCTBridge;

/**
 * The type of a block that is capable of sending a response to a bridged
 * operation. Use this for returning callback methods to JS.
 */
typedef void (^RCTResponseSenderBlock)(NSArray *response);

/**
 * Provides minimal interface needed to register a bridge module
 */
@protocol RCTBridgeModule <NSObject>
@optional

/**
 * Optional initializer for modules that require access
 * to bridge features, such as sending events or making JS calls
 */
- (instancetype)initWithBridge:(RCTBridge *)bridge;

/**
 * The module name exposed to JS. If omitted, this will be inferred
 * automatically by using the native module's class name.
 */
+ (NSString *)moduleName;

/**
 * Place this macro inside the method body of any method you want to expose
 * to JS. The optional js_name argument will be used as the JS method name
 * (the method will be namespaced to the module name, as specified above).
 * If omitted, the JS method name will match the first part of the Objective-C
 * method selector name (up to the first colon).
 */
#define RCT_EXPORT(js_name) __attribute__((used, section("__DATA,RCTExport" \
))) static const char *__rct_export_entry__[] = { __func__, #js_name }

/**
 * Injects constants into JS. These constants are made accessible via
 * NativeModules.moduleName.X. Note that this method is not inherited when you
 * subclass a module, and you should not call [super constantsToExport] when
 * implementing it.
 */
+ (NSDictionary *)constantsToExport;

/**
 * An array of JavaScript methods that the module will call via the
 * -[RCTBridge enqueueJSCall:args:] method. Each method should be specified
 * as a string of the form "JSModuleName.jsMethodName". Attempting to call a
 * method that has not been registered will result in an error. If a method
 * has already been regsistered by another module, it is not necessary to
 * register it again, but it is good pratice. Registering the same method
 * more than once is silently ignored and will not result in an error.
 */
+ (NSArray *)JSMethods;

/**
 * Notifies the module that a batch of JS method invocations has just completed.
 */
- (void)batchDidComplete;

@end