react-native-background-geolocation 4.3.0

package/ios/RNBackgroundGeolocation/TSLocationManager.xcframework/ios-arm64_armv7/TSLocationManager.framework/Headers/TSGeofence.h

@@ -0,0 +1,50 @@
+//
+//  TSGeofence.h
+//  TSLocationManager
+//
+//  Created by Christopher Scott on 2016-12-21.
+//  Copyright © 2016 Transistor Software. All rights reserved.
+//
+#import <Foundation/Foundation.h>
+
+@interface TSGeofence : NSObject
+{
+    
+}
+@property (nonatomic) NSString* identifier;
+@property (nonatomic) CLLocationDistance radius;
+
+@property (nonatomic) CLLocationDegrees latitude;
+@property (nonatomic) CLLocationDegrees longitude;
+@property (nonatomic) BOOL notifyOnEntry;
+@property (nonatomic) BOOL notifyOnExit;
+@property (nonatomic) BOOL notifyOnDwell;
+@property (nonatomic) double loiteringDelay;
+/**
+ * Arbitrary extra data attached to the geofence
+ */
+@property (nonatomic) NSDictionary *extras;
+
+-(instancetype) initWithIdentifier:(NSString*)identifier
+                            radius:(CLLocationDistance)radius
+                          latitude:(CLLocationDegrees)latitude
+                         longitude:(CLLocationDegrees)lontitude
+                     notifyOnEntry:(BOOL)notifyOnEntry
+                      notifyOnExit:(BOOL)notifyOnExit
+                     notifyOnDwell:(BOOL)notifyOnDwell
+                    loiteringDelay:(double)loiteringDelay;
+
+-(instancetype) initWithIdentifier:(NSString*)identifier
+                            radius:(CLLocationDistance)radius
+                          latitude:(CLLocationDegrees)latitude
+                         longitude:(CLLocationDegrees)longitude
+                     notifyOnEntry:(BOOL)notifyOnEntry
+                      notifyOnExit:(BOOL)notifyOnExit
+                     notifyOnDwell:(BOOL)notifyOnDwell
+                    loiteringDelay:(double)loiteringDelay
+                            extras:(NSDictionary*)extras;
+
+- (NSDictionary*) toDictionary;
+    
+@end
+

package/ios/RNBackgroundGeolocation/TSLocationManager.xcframework/ios-arm64_armv7/TSLocationManager.framework/Headers/TSGeofenceEvent.h

@@ -0,0 +1,60 @@
+//
+//  TSGeofenceEvent.h
+//  TSLocationManager
+//
+//  Created by Christopher Scott on 2017-03-27.
+//  Copyright © 2017 Transistor Software. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "TSLocation.h"
+#import "TSGeofence.h"
+
+/**
+ The event object provided to `-[TSLocationManager onGeofence:]`
+ 
+ ```obj-c
+ TSLocationManager *bgGeo = [TSLocationManager sharedInstance];
+ [bgGeo onGeofence:^(TSGeofenceEvent *event) {
+     NSLog(@"[onGeofence]: %@", event);
+ }];
+ ```
+    
+ */
+@interface TSGeofenceEvent : NSObject
+{
+    
+}
+
+/// The location associated with this geofence event.
+@property (nonatomic, readonly) TSLocation* location;
+/// The triggered geofence
+@property (nonatomic, readonly) TSGeofence* geofence;
+/// The region instance.
+@property (nonatomic, readonly) CLCircularRegion* region;
+/// The geofence transition (eg: "ENTER", "EXIT", "DWELL"
+@property (nonatomic, readonly) NSString* action;
+/// :nodoc:
+@property (nonatomic, readonly) BOOL isLoitering;
+
+/// :nodoc:
+@property (nonatomic, readonly) BOOL isFinishedLoitering;
+
+/// :nodoc:
+-(instancetype)initWithGeofence:(TSGeofence*)geofence region:(CLCircularRegion*)circularRegion action:(NSString*)actionName;
+
+/// :nodoc:
+-(void) startLoiteringAt:(CLLocation*)location callback:(void (^)(void))callback;
+/// :nodoc:
+-(BOOL) isLoiteringAt:(CLLocation*)location;
+/// :nodoc:
+-(void) setTriggerLocation:(CLLocation*)location;
+/// :nodoc:
+-(void) cancel;
+
+/// Returns an `NSDictionary` representaton.
+-(NSDictionary*)toDictionary;
+
+
+@end
+

package/ios/RNBackgroundGeolocation/TSLocationManager.xcframework/ios-arm64_armv7/TSLocationManager.framework/Headers/TSGeofenceManager.h

@@ -0,0 +1,50 @@
+//
+//  GeofenceManager.h
+//  TSLocationManager
+//
+//  Created by Christopher Scott on 2016-10-04.
+//  Copyright © 2016 Transistor Software. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import <CoreLocation/CoreLocation.h>
+#import "TSGeofenceEvent.h"
+#import "TSGeofencesChangeEvent.h"
+
+extern NSString *const STATIONARY_REGION_IDENTIFIER;
+
+@interface TSGeofenceManager : NSObject<CLLocationManagerDelegate>
+{
+    
+}
+
+@property (copy) void (^onGeofence) (TSGeofenceEvent* event);
+
+@property (nonatomic) BOOL isMoving;
+@property (nonatomic) BOOL enabled;
+@property (nonatomic) BOOL evaluated;
+@property (nonatomic) BOOL isRequestingLocation;
+@property (nonatomic) BOOL isMonitoringSignificantChanges;
+@property (nonatomic) BOOL willEvaluateProximity;
+@property (nonatomic) CLLocation *lastLocation;
+
+@property (nonatomic, readonly) NSMutableArray *geofencesChangeListeners;
+@property (nonatomic, readonly) NSMutableArray *geofenceListeners;
+
+
+// Event listeners
+-(void) onGeofencesChange:(void (^)(TSGeofencesChangeEvent*))success;
+-(void) onGeofence:(void (^)(TSGeofenceEvent*))success;
+-(void) un:(NSString*)event callback:(void(^)(id))callback;
+-(void) removeListeners;
+-(void) start;
+-(void) stop;
+-(void) ready;
+-(void) setLocation:(CLLocation*)location isMoving:(BOOL)isMoving;
+-(void) setProximityRadius:(CLLocationDistance)radius;
+-(BOOL) isMonitoringRegion:(CLCircularRegion*)region;
+-(void) didBecomeStationary:(CLLocation*)locaiton;
+-(NSString*) identifierFor:(CLCircularRegion*)region;
+-(void) create:(NSArray*)geofences success:(void (^)(void))success failure:(void (^)(NSString*))failure;
+-(void) destroy:(NSArray*)identifiers success:(void (^)(void))success failure:(void (^)(NSString*))failure;
+@end

package/ios/RNBackgroundGeolocation/TSLocationManager.xcframework/ios-arm64_armv7/TSLocationManager.framework/Headers/TSGeofencesChangeEvent.h

@@ -0,0 +1,17 @@
+//
+//  TSGeofencesChangeEvent.h
+//  TSLocationManager
+//
+//  Created by Christopher Scott on 2017-07-29.
+//  Copyright © 2017 Transistor Software. All rights reserved.
+//
+#import "TSSchedule.h"
+
+@interface TSGeofencesChangeEvent : NSObject
+
+@property (nonatomic, readonly) NSArray* on;
+@property (nonatomic, readonly) NSArray* off;
+
+-(id) initWithOn:(NSArray*)on off:(NSArray*)off;
+-(NSDictionary*) toDictionary;
+@end

package/ios/RNBackgroundGeolocation/TSLocationManager.xcframework/ios-arm64_armv7/TSLocationManager.framework/Headers/TSHeartbeatEvent.h

@@ -0,0 +1,18 @@
+//
+//  TSHeartbeat.h
+//  TSLocationManager
+//
+//  Created by Christopher Scott on 2017-07-28.
+//  Copyright © 2017 Transistor Software. All rights reserved.
+//
+
+#import "TSLocation.h"
+
+@interface TSHeartbeatEvent : NSObject
+
+@property (nonatomic, readonly) TSLocation* location;
+
+-(id) initWithLocation:(CLLocation*)location;
+-(NSDictionary*) toDictionary;
+@end
+

package/ios/RNBackgroundGeolocation/TSLocationManager.xcframework/ios-arm64_armv7/TSLocationManager.framework/Headers/TSHttpEvent.h

@@ -0,0 +1,19 @@
+//
+//  TSHttpResponse.h
+//  TSLocationManager
+//
+//  Created by Christopher Scott on 2017-07-28.
+//  Copyright © 2017 Transistor Software. All rights reserved.
+//
+
+@interface TSHttpEvent : NSObject
+
+@property (nonatomic, readonly) BOOL isSuccess;
+@property (nonatomic, readonly) NSInteger statusCode;
+@property (nonatomic, readonly) NSDictionary *requestData;
+@property (nonatomic, readonly) NSString *responseText;
+@property (nonatomic, readonly) NSError *error;
+
+-(id) initWithStatusCode:(NSInteger)statusCode requestData:(NSDictionary*)requestData responseData:(NSData*)responseData error:(NSError*)error;
+-(NSDictionary*) toDictionary;
+@end

package/ios/RNBackgroundGeolocation/TSLocationManager.xcframework/ios-arm64_armv7/TSLocationManager.framework/Headers/TSHttpService.h

@@ -0,0 +1,58 @@
+//
+//  TSScheduler.h
+//  TSLocationManager
+//
+//  Created by Christopher Scott on 2016-04-26.
+//  Copyright © 2016 Transistor Software. All rights reserved.
+//
+//
+// TSScheduler
+// TODO This should be decoupled into some sort of plugin
+//
+#import <Foundation/Foundation.h>
+#import <UIKit/UIKit.h>
+#import "TSConnectivityChangeEvent.h"
+#import "TSAuthorizationEvent.h"
+#import "AtomicBoolean.h"
+#import "HttpRequest.h"
+#import "TSReachability.h"
+#import "TSCallback.h"
+
+@class TSHttpService;
+
+@interface TSHttpService : NSObject
+
+#pragma mark - Singleton
++ (TSHttpService *)sharedInstance;
+
+#pragma mark - Properties
+
+@property (copy) void (^httpResponseBlock) (HttpRequest *request, HttpResponse *response);
+
+@property (nonatomic) AtomicBoolean *isBusy;
+@property (nonatomic) BOOL hasNetworkConnection;
+
+@property (nonatomic, readonly) NSMutableArray *syncedRecords;
+@property (nonatomic, readonly) TSReachability *reachability;
+@property (nonatomic, readonly) UIBackgroundTaskIdentifier bgTask;
+
+@property (nonatomic, readonly) NSMutableSet *connectivityChangeListeners;
+@property (nonatomic, readonly) NSMutableSet *authorizationListeners;
+
+@property (nonatomic) TSCallback *callback;
+@property (nonatomic) long autoSyncThreshold;
+
+#pragma mark - Methods
+-(void)flush;
+-(void)flush:(BOOL)overrideSyncThreshold;
+-(void)flush:(void(^)(NSArray*))success failure:(void(^)(NSError*))failure;
+-(void)startMonitoring;
+-(void)stopMonitoring;
+
+-(void)onConnectivityChange:(void (^)(TSConnectivityChangeEvent*))success;
+-(void)onAuthorization:(void(^)(TSAuthorizationEvent*))callback;
+-(void)un:(NSString*)event callback:(void(^)(id))callback;
+-(void)removeListeners;
+-(void)removeListeners:(NSString*)event;
+
+@end

package/ios/RNBackgroundGeolocation/TSLocationManager.xcframework/ios-arm64_armv7/TSLocationManager.framework/Headers/TSLocation.h

@@ -0,0 +1,101 @@
+//
+//  TSLocation.h
+//  TSLocationManager
+//
+//  Created by Christopher Scott on 2017-02-11.
+//  Copyright © 2017 Transistor Software. All rights reserved.
+//
+
+@interface TSLocation : NSObject
+
+// Location types
+typedef enum tsLocationType : NSInteger {
+    TS_LOCATION_TYPE_MOTIONCHANGE   = 0,
+    TS_LOCATION_TYPE_TRACKING       = 1,
+    TS_LOCATION_TYPE_CURRENT        = 2,
+    TS_LOCATION_TYPE_SAMPLE         = 3,
+    TS_LOCATION_TYPE_WATCH          = 4,
+    TS_LOCATION_TYPE_GEOFENCE       = 5,
+    TS_LOCATION_TYPE_HEARTBEAT      = 6
+} tsLocationtype;
+
+/**
+ * The native CLLocation instance
+ */
+@property (nonatomic, readonly) CLLocation* location;
+/**
+ * Universally unique identifier.  The uuid is used to locate the record in the database.  It is also posted by default in HTTP requests so your server can determine if a duplicate location has been posted.  It's also helpful to match a location received at your server to entries in the plugin logs.
+ */
+@property (nonatomic, readonly) NSString *uuid;
+/**
+ * The rendered timestamp in ISO-8851 UTC format (YYYY-MM-dd HH:mm:sssZ)
+ */
+@property (nonatomic, readonly) NSString *timestamp;
+/**
+ * The type of location: MOTIONCHANGE|TRACKING|CURRENT|SAMPLE|WATCH|GEOFENCE|HEARTBEAT
+ */
+@property (nonatomic, readonly) enum tsLocationType type;
+/**
+ * YES when location was recorded while device is in motion; NO otherwise.
+ */
+@property (nonatomic, readonly) BOOL isMoving;
+/**
+ * Arbitrary extras data attached to the location.
+ */
+@property (nonatomic, readonly) NSDictionary* extras;
+/**
+ * For internal use only.  Geofence data rendered to NSDictionary for posting to server.
+ */
+@property (nonatomic, readonly) NSDictionary* geofence;
+// Battery
+/**
+ * YES when device is plugged into power and charging
+ */
+@property (nonatomic, readonly) BOOL batteryIsCharging;
+/**
+ * The battery level between 0 (empty) and 1 (full)
+ */
+@property (nonatomic, readonly) NSNumber *batteryLevel;
+// Activity
+/**
+ * Activity type rendered as string: still|on_foot|in_vehicle|running|on_bicycle
+ */
+@property (nonatomic, readonly) NSString *activityType;
+/**
+ * Confidence of activity-type estimation as % 0-100
+ */
+@property (nonatomic, readonly) NSNumber *activityConfidence;
+// State
+/**
+ * YES when recorded location is a sample.  The plugin records multiple locations for particular events, such as "motionchange" in order to determine
+ * highest accuracy location before persisting that location to the database and POSTing to your configured #url.  Location "samples" are not persisted
+ * to the plugin's database, nor are they posted to your configured #url
+ */
+@property (nonatomic, readonly) BOOL isSample;
+/**
+ * YES when this location was provided to a heartbeat event
+ */
+@property (nonatomic, readonly) BOOL isHeartbeat;
+/**
+ * The current value of the odometer in meters
+ */
+@property (nonatomic, readonly) NSNumber *odometer;
+/**
+ * The event associated with this location: location|motionchange|heartbeat|providerchange
+ */
+@property (nonatomic, readonly) NSString *event;
+
+-(instancetype) initWithLocation:(CLLocation*)location;
+-(instancetype) initWithLocation:(CLLocation*)location type:(enum tsLocationType)type extras:(NSDictionary*)extras;
+-(instancetype) initWithLocation:(CLLocation*)location geofence:(NSDictionary*)geofenceData;
+
+/**
+ * Render location-data as JSON string
+ */
+- (NSData*)toJson:(NSError**)error;
+/**
+ * Render location-data as NSDictionary
+ */
+- (NSDictionary*)toDictionary;
+
+@end

package/ios/RNBackgroundGeolocation/TSLocationManager.xcframework/ios-arm64_armv7/TSLocationManager.framework/Headers/TSLocationManager.h

@@ -0,0 +1,312 @@
+#import <Foundation/Foundation.h>
+#import <UIKit/UIKit.h>
+#import <CoreData/CoreData.h>
+#import <CoreLocation/CoreLocation.h>
+#import <AudioToolbox/AudioToolbox.h>
+#import "TSSchedule.h"
+#import "TSLocation.h"
+#import "TSActivityChangeEvent.h"
+#import "TSProviderChangeEvent.h"
+#import "TSHttpEvent.h"
+#import "TSHeartbeatEvent.h"
+#import "TSScheduleEvent.h"
+#import "TSGeofenceManager.h"
+#import "TSGeofencesChangeEvent.h"
+#import "TSPowerSaveChangeEvent.h"
+#import "TSConnectivityChangeEvent.h"
+#import "TSEnabledChangeEvent.h"
+#import "TSGeofenceEvent.h"
+#import "TSAuthorizationEvent.h"
+#import "TSGeofence.h"
+#import "LocationManager.h"
+#import "TSConfig.h"
+#import "TSCurrentPositionRequest.h"
+#import "TSWatchPositionRequest.h"
+#import "LogQuery.h"
+#import "TSDeviceInfo.h"
+#import "TSAuthorization.h"
+#import "TSHttpService.h"
+#import "SOMotionDetector.h"
+
+FOUNDATION_EXPORT double TSLocationManagerVersionNumber;
+FOUNDATION_EXPORT const unsigned char TSLocationManagerVersionString[];
+FOUNDATION_EXPORT NSString* TSLocationManagerVersion;
+
+/**
+ The main API interface.
+ */
+@interface TSLocationManager : NSObject <CLLocationManagerDelegate>
+
+#pragma mark - Properties
+
+// Flags
+@property (nonatomic, readonly) BOOL enabled;
+/// :nodoc:
+@property (nonatomic, readonly) BOOL isConfigured;
+/// :nodoc:
+@property (nonatomic, readonly) BOOL isDebuggingMotionDetection;
+/// :nodoc:
+@property (nonatomic, readonly) BOOL isUpdatingLocation;
+/// :nodoc:
+@property (nonatomic, readonly) BOOL isRequestingLocation;
+/// :nodoc:
+@property (nonatomic, readonly) BOOL isMonitoringSignificantLocationChanges;
+/// :nodoc:
+@property (nonatomic, readonly) NSDate *suspendedAt;
+/// `YES` when the the app was launched in the background.
+@property (nonatomic, readonly) BOOL isLaunchedInBackground;
+
+// LocationManagers
+
+/// The SDK's `CLLocationManager` instance.
+@property (nonatomic, strong, readonly) CLLocationManager *locationManager;
+/// :nodoc:
+@property (nonatomic, strong, readonly) LocationManager *currentPositionManager;
+/// :nodoc:
+@property (nonatomic, strong, readonly) LocationManager *watchPositionManager;
+/// :nodoc:
+@property (nonatomic, strong, readonly) LocationManager *stateManager;
+
+// Location Resources
+
+/// The location used to monitor the SDK's stationary geofence.
+@property (nonatomic, strong, readonly) CLLocation *stationaryLocation;
+/// The last known location.
+@property (nonatomic, strong, readonly) CLLocation *lastLocation;
+/// :nodoc:
+@property (nonatomic, strong, readonly) CLLocation *lastGoodLocation;
+/// :nodoc:
+@property (nonatomic, strong, readonly) CLLocation *lastOdometerLocation;
+
+// GeofeneManager
+
+/// :nodoc:
+@property (nonatomic, strong, readonly) TSGeofenceManager *geofenceManager;
+
+/// The application's `ViewController` instance.  Used for presenting dialogs.
+@property (nonatomic) UIViewController* viewController;
+/// :nodoc:
+@property (nonatomic) NSDate *stoppedAt;
+/// :nodoc:
+@property (nonatomic) UIBackgroundTaskIdentifier preventSuspendTask;
+/// :nodoc:
+@property (nonatomic, readonly) BOOL clientReady;
+/// :nodoc:
+@property (nonatomic, readonly) BOOL isAcquiringState;
+/// :nodoc:
+@property (nonatomic, readonly) BOOL wasAcquiringState;
+/// :nodoc:
+@property (nonatomic, readonly) BOOL isAcquiringBackgroundTime;
+/// :nodoc:
+@property (nonatomic, readonly) BOOL isAcquiringStationaryLocation;
+/// :nodoc:
+@property (nonatomic, readonly) BOOL isAcquiringSpeed;
+/// :nodoc:
+@property (nonatomic, readonly) BOOL isHeartbeatEnabled;
+
+// Events listeners
+/// :nodoc:
+@property (nonatomic, readonly) NSMutableSet *currentPositionRequests;
+/// :nodoc:
+@property (nonatomic, readonly) NSMutableArray *watchPositionRequests;
+/// :nodoc:
+@property (nonatomic, readonly) NSMutableSet *locationListeners;
+/// :nodoc:
+@property (nonatomic, readonly) NSMutableSet *motionChangeListeners;
+/// :nodoc:
+@property (nonatomic, readonly) NSMutableSet *activityChangeListeners;
+/// :nodoc:
+@property (nonatomic, readonly) NSMutableSet *providerChangeListeners;
+/// :nodoc:
+@property (nonatomic, readonly) NSMutableSet *httpListeners;
+/// :nodoc:
+@property (nonatomic, readonly) NSMutableSet *scheduleListeners;
+/// :nodoc:
+@property (nonatomic, readonly) NSMutableSet *heartbeatListeners;
+/// :nodoc:
+@property (nonatomic, readonly) NSMutableSet *powerSaveChangeListeners;
+/// :nodoc:
+@property (nonatomic, readonly) NSMutableSet *enabledChangeListeners;
+
+/// [Optional] User-supplied block to render location-data for SQLite database / Firebase adapter INSERT.
+@property (copy) NSDictionary* (^beforeInsertBlock) (TSLocation *location);
+
+/// Callback for requestPermission.
+/// :nodoc:
+@property (nonatomic) TSCallback *requestPermissionCallback;
+
+/// Event Queue
+/// :nodoc:
+@property (nonatomic, readonly)  NSMutableSet *eventQueue;
+/// :nodoc:
+@property (nonatomic) SOMotionType currentMotionType;
+
+/// Returns the API's singleton instance.
++ (TSLocationManager *)sharedInstance;
+
+#pragma mark - Event Listener Methods
+
+/*
+ Adds a location event-listener.
+ */
+- (void) onLocation:(void(^)(TSLocation* location))success failure:(void(^)(NSError*))failure;
+- (void) onHttp:(void(^)(TSHttpEvent* event))success;
+- (void) onGeofence:(void(^)(TSGeofenceEvent* event))success;
+- (void) onHeartbeat:(void(^)(TSHeartbeatEvent* event))success;
+- (void) onMotionChange:(void(^)(TSLocation* event))success;
+- (void) onActivityChange:(void(^)(TSActivityChangeEvent* event))success;
+- (void) onProviderChange:(void(^)(TSProviderChangeEvent* event))success;
+- (void) onGeofencesChange:(void(^)(TSGeofencesChangeEvent* event))success;
+- (void) onSchedule:(void(^)(TSScheduleEvent* event))success;
+- (void) onPowerSaveChange:(void(^)(TSPowerSaveChangeEvent* event))success;
+- (void) onConnectivityChange:(void(^)(TSConnectivityChangeEvent* event))succes;
+- (void) onEnabledChange:(void(^)(TSEnabledChangeEvent* event))success;
+- (void) onAuthorization:(void(^)(TSAuthorizationEvent*))callback;
+
+- (void) removeListener:(NSString*)event callback:(void(^)(id))callback;
+- (void) un:(NSString*)event callback:(void(^)(id))callback;
+- (void) removeListeners:(NSString*)event;
+- (void) removeListenersForEvent:(NSString*)event;
+- (void) removeListeners;
+
+#pragma mark - Core API Methods
+
+- (void) configure:(NSDictionary*)params;
+
+/**
+ Signal to the plugin that your app is launched and ready, proving the default [Config].
+
+ The supplied [Config] will be applied **only at first install** of your app — for every launch thereafter,
+ the plugin will automatically load its last-known configuration from persistent storage.
+ The plugin always remembers the configuration you apply to it.
+
+
+ ```dart
+ BackgroundGeolocation.ready(Config(
+  desiredAccuracy: Config.DESIRED_ACCURACY_HIGH,
+  distanceFilter: 10,
+  stopOnTerminate: false,
+  startOnBoot: true,
+  url: 'http://your.server.com',
+  headers: {
+    'my-auth-token': 'secret-token'
+  }
+ )).then((State state) {
+  print('[ready] success: ${state}');
+ });
+ ```
+
+ **WARNING:** The **`#ready`** method only applies the supplied [Config] for the **first launch of the app** &mdash;
+ Forever after, the plugin is going to remember **every configuration change** you apply at runtime (eg: [setConfig]) and reload that *same config* every time your app boots.
+
+ ### The `-[TSConfig reset]` method.
+
+ If you wish, you can use the `-[TSConfig reset]` method to reset all `TSConfig` options to documented default-values (with optional overrides):
+
+ ```dart
+
+ BackgroundGeolocation.reset();
+ // Reset to documented default-values with overrides
+ BackgroundGeolocation.reset(Config(
+  distanceFilter:  10
+ ));
+ ```
+
+ ## [Config.reset]: true
+
+ Optionally, you can set [Config.reset] to `true`  This is helpful during development.  This will essentially *force* the supplied [Config] to be applied with *each launch* of your application.
+
+ ## Example
+
+ ```dart
+ BackgroundGeolocation.ready(Config(
+  distanceFilter: 50
+ )).then((State state) {
+  print('[ready] - ${state}')
+ });
+ ```
+ */
+- (void) ready;
+- (void) start;
+- (void) stop;
+- (void) startSchedule;
+- (void) stopSchedule;
+- (void) startGeofences;
+- (NSMutableDictionary*) getState;
+
+#pragma mark - Geolocation Methods
+
+- (void) changePace:(BOOL)value;
+- (void) getCurrentPosition:(TSCurrentPositionRequest*)request;
+- (void) setOdometer:(CLLocationDistance)odometer request:(TSCurrentPositionRequest*)request;
+- (CLLocationDistance)getOdometer;
+- (void) watchPosition:(TSWatchPositionRequest*)request;
+- (void) stopWatchPosition;
+- (NSDictionary*) getStationaryLocation;
+- (TSProviderChangeEvent*) getProviderState;
+- (void) requestPermission:(void(^)(NSNumber *status))success failure:(void(^)(NSNumber *status))failure;
+- (void) requestTemporaryFullAccuracy:(NSString*)purpose success:(void(^)(NSInteger))success failure:(void(^)(NSError*))failure;
+
+#pragma mark - HTTP & Persistence Methods
+
+- (void) sync:(void(^)(NSArray* locations))success failure:(void(^)(NSError* error))failure;
+- (void) getLocations:(void(^)(NSArray* locations))success failure:(void(^)(NSString* error))failure;
+- (BOOL) clearDatabase;
+- (BOOL) destroyLocations;
+- (void) destroyLocations:(void(^)(void))success failure:(void(^)(NSString* error))failure;
+- (void) destroyLocation:(NSString*)uuid;
+- (void) destroyLocation:(NSString*)uuid success:(void(^)(void))success failure:(void(^)(NSString* error))failure;
+- (void) insertLocation:(NSDictionary*)params success:(void(^)(NSString* uuid))success failure:(void(^)(NSString* error))failure;
+- (int) getCount;
+
+#pragma mark - Application Methods
+
+- (UIBackgroundTaskIdentifier) createBackgroundTask;
+- (void) stopBackgroundTask:(UIBackgroundTaskIdentifier)taskId;
+- (BOOL) isPowerSaveMode;
+
+#pragma mark - Logging & Debug Methods
+
+- (void) getLog:(void(^)(NSString* log))success failure:(void(^)(NSString* error))failure;
+- (void) getLog:(LogQuery*)query success:(void(^)(NSString* log))success failure:(void(^)(NSString* error))failure;
+- (void) emailLog:(NSString*)email success:(void(^)(void))success failure:(void(^)(NSString* error))failure;
+- (void) emailLog:(NSString*)email query:(LogQuery*)query success:(void(^)(void))success failure:(void(^)(NSString* error))failure;
+- (void) uploadLog:(NSString*)url query:(LogQuery*)query success:(void(^)(void))success failure:(void(^)(NSString* error))failure;
+
+- (BOOL) destroyLog;
+- (void) setLogLevel:(TSLogLevel)level;
+- (void) playSound:(SystemSoundID)soundId;
+- (void) error:(UIBackgroundTaskIdentifier)taskId message:(NSString*)message;
+- (void) log:(NSString*)level message:(NSString*)message;
+#pragma mark - Geofencing Methods
+
+- (void) addGeofence:(TSGeofence*)geofence success:(void (^)(void))success failure:(void (^)(NSString* error))failure;
+- (void) addGeofences:(NSArray*)geofences success:(void (^)(void))success failure:(void (^)(NSString* error))failure;
+- (void) removeGeofence:(NSString*)identifier success:(void (^)(void))success failure:(void (^)(NSString* error))failure;
+- (void) removeGeofences:(NSArray*)identifiers success:(void (^)(void))success failure:(void (^)(NSString* error))failure;;
+- (void) removeGeofences;
+
+- (NSArray*) getGeofences;
+- (void) getGeofences:(void (^)(NSArray*))success failure:(void (^)(NSString*))failure;
+- (void) getGeofence:(NSString*)identifier success:(void (^)(TSGeofence*))success failure:(void (^)(NSString*))failure;
+- (void) geofenceExists:(NSString*)identifier callback:(void (^)(BOOL))callback;
+
+#pragma mark - Sensor Methods
+
+-(BOOL) isMotionHardwareAvailable;
+-(BOOL) isDeviceMotionAvailable;
+-(BOOL) isAccelerometerAvailable;
+-(BOOL) isGyroAvailable;
+-(BOOL) isMagnetometerAvailable;
+
+#pragma mark - Application life-cycle callbacks
+
+- (void) onSuspend:(NSNotification *)notification;
+- (void) onResume:(NSNotification *)notification;
+- (void) onAppTerminate;
+
+# pragma mark - Private Methods
+/// :nodoc:
+- (void) fireMotionActivityChangeEvent:(TSActivityChangeEvent*)event;
+@end
+